diff --git a/admin/directory/v1/admin-api.json b/admin/directory/v1/admin-api.json index fcd5e05dbce..7274f7b78bb 100644 --- a/admin/directory/v1/admin-api.json +++ b/admin/directory/v1/admin-api.json @@ -1659,7 +1659,7 @@ "type": "string" }, "query": { - "description": "Query string search. Should be of the form \"\". Complete documentation is at https: //developers.google.com/admin-sdk/directory/v1/guides/search-groups", + "description": "Query string search. Should be of the form \"\". Complete documentation is at https://developers.google.com/workspace/admin/directory/v1/guides/search-groups", "location": "query", "type": "string" }, @@ -4298,7 +4298,7 @@ "type": "string" }, "query": { - "description": "Query string search. Should be of the form \"\". Complete documentation is at https: //developers.google.com/admin-sdk/directory/v1/guides/search-users", + "description": "Query string search. Should be of the form \"\". Complete documentation is at https://developers.google.com/workspace/admin/directory/v1/guides/search-users", "location": "query", "type": "string" }, @@ -4671,7 +4671,7 @@ } } }, - "revision": "20250804", + "revision": "20250916", "rootUrl": "https://admin.googleapis.com/", "schemas": { "Alias": { @@ -5841,7 +5841,7 @@ "type": "string" }, "osVersionCompliance": { - "description": "Output only. Compliance status of the OS version.", + "description": "Output only. Device policy compliance status of the OS version.", "enum": [ "complianceUnspecified", "compliant", diff --git a/admin/directory/v1/admin-gen.go b/admin/directory/v1/admin-gen.go index f089c196787..869fdd1e5b7 100644 --- a/admin/directory/v1/admin-gen.go +++ b/admin/directory/v1/admin-gen.go @@ -1719,7 +1719,8 @@ type ChromeOsDevice struct { OsUpdateStatus *OsUpdateStatus `json:"osUpdateStatus,omitempty"` // OsVersion: The Chrome device's operating system version. OsVersion string `json:"osVersion,omitempty"` - // OsVersionCompliance: Output only. Compliance status of the OS version. + // OsVersionCompliance: Output only. Device policy compliance status of the OS + // version. // // Possible values: // "complianceUnspecified" - Compliance status unspecified. @@ -10237,8 +10238,8 @@ func (c *GroupsListCall) PageToken(pageToken string) *GroupsListCall { } // Query sets the optional parameter "query": Query string search. Should be of -// the form "". Complete documentation is at https: -// //developers.google.com/admin-sdk/directory/v1/guides/search-groups +// the form "". Complete documentation is at +// https://developers.google.com/workspace/admin/directory/v1/guides/search-groups func (c *GroupsListCall) Query(query string) *GroupsListCall { c.urlParams_.Set("query", query) return c @@ -18456,8 +18457,8 @@ func (c *UsersWatchCall) Projection(projection string) *UsersWatchCall { } // Query sets the optional parameter "query": Query string search. Should be of -// the form "". Complete documentation is at https: -// //developers.google.com/admin-sdk/directory/v1/guides/search-users +// the form "". Complete documentation is at +// https://developers.google.com/workspace/admin/directory/v1/guides/search-users func (c *UsersWatchCall) Query(query string) *UsersWatchCall { c.urlParams_.Set("query", query) return c diff --git a/aiplatform/v1/aiplatform-api.json b/aiplatform/v1/aiplatform-api.json index c16cacd8198..d93a906f0ae 100644 --- a/aiplatform/v1/aiplatform-api.json +++ b/aiplatform/v1/aiplatform-api.json @@ -228,6 +228,16 @@ "description": "Locational Endpoint", "endpointUrl": "https://us-east5-aiplatform.googleapis.com/", "location": "us-east5" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://aiplatform.us.rep.googleapis.com/", + "location": "us" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://aiplatform.eu.rep.googleapis.com/", + "location": "eu" } ], "fullyEncodeReservedExpansion": true, @@ -1382,7 +1392,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -4969,6 +4979,133 @@ } } }, + "deployedModels": { + "resources": { + "invoke": { + "methods": { + "invoke": { + "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/deployedModels/{deployedModelId}/invoke/{invokeId}", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.endpoints.deployedModels.invoke.invoke", + "parameterOrder": [ + "endpoint", + "deployedModelId", + "invokeId" + ], + "parameters": { + "deployedModelId": { + "description": "ID of the DeployedModel that serves the invoke request.", + "location": "path", + "required": true, + "type": "string" + }, + "endpoint": { + "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", + "required": true, + "type": "string" + }, + "invokeId": { + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "v1/{+endpoint}/deployedModels/{deployedModelId}/invoke/{+invokeId}", + "request": { + "$ref": "GoogleCloudAiplatformV1InvokeRequest" + }, + "response": { + "$ref": "GoogleApiHttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + } + } + }, + "invoke": { + "methods": { + "invoke": { + "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/invoke/{invokeId}", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.endpoints.invoke.invoke", + "parameterOrder": [ + "endpoint", + "invokeId" + ], + "parameters": { + "endpoint": { + "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", + "required": true, + "type": "string" + }, + "invokeId": { + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "v1/{+endpoint}/invoke/{+invokeId}", + "request": { + "$ref": "GoogleCloudAiplatformV1InvokeRequest" + }, + "response": { + "$ref": "GoogleApiHttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + }, + "openapi": { + "methods": { + "embeddings": { + "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpoints/openapi/embeddings", + "httpMethod": "POST", + "id": "aiplatform.projects.locations.endpoints.openapi.embeddings", + "parameterOrder": [ + "endpoint" + ], + "parameters": { + "deployedModelId": { + "description": "ID of the DeployedModel that serves the invoke request.", + "location": "query", + "type": "string" + }, + "endpoint": { + "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/openapi$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+endpoint}/embeddings", + "request": { + "$ref": "GoogleApiHttpBody" + }, + "response": { + "$ref": "GoogleApiHttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + }, "operations": { "methods": { "cancel": { @@ -20793,7 +20930,7 @@ } } }, - "revision": "20250902", + "revision": "20250920", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -21830,6 +21967,10 @@ "description": "Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias.", "type": "boolean" }, + "generationConfig": { + "$ref": "GoogleCloudAiplatformV1GenerationConfig", + "description": "Optional. Configuration options for model generation and outputs." + }, "samplingCount": { "description": "Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32.", "format": "int32", @@ -22527,7 +22668,7 @@ "type": "string" }, "rubricsColumn": { - "description": "Optional. The name of the column that contains the rubrics. This will be in evaluation_rubric.RubricGroup format (cl/762595858).", + "description": "Optional. The name of the column that contains the rubrics. This is in evaluation_rubric.RubricGroup format.", "type": "string" }, "samplingConfig": { @@ -25092,7 +25233,7 @@ "id": "GoogleCloudAiplatformV1DeployRequestEndpointConfig", "properties": { "dedicatedEndpointDisabled": { - "description": "Optional. By default, if dedicated endpoint is enabled, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. If this field is set to true, the dedicated endpoint will be disabled and the deployed model will be exposed through the shared DNS {region}-aiplatform.googleapis.com.", + "description": "Optional. By default, if dedicated endpoint is enabled and private service connect config is not set, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. If private service connect config is set, the endpoint will be exposed through private service connect. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. If this field is set to true, the dedicated endpoint will be disabled and the deployed model will be exposed through the shared DNS {region}-aiplatform.googleapis.com.", "type": "boolean" }, "dedicatedEndpointEnabled": { @@ -25107,6 +25248,10 @@ "endpointUserId": { "description": "Optional. Immutable. The ID to use for endpoint, which will become the final component of the endpoint resource name. If not provided, Vertex AI will generate a value for this ID. If the first character is a letter, this value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The last character must be a letter or number. If the first character is a number, this value may be up to 9 characters, and valid characters are `[0-9]` with no leading zeros. When using HTTP/JSON, this field is populated based on a query string argument, such as `?endpoint_id=12345`. This is the fallback for fields that are not included in either the URI or the body.", "type": "string" + }, + "privateServiceConnectConfig": { + "$ref": "GoogleCloudAiplatformV1PrivateServiceConnectConfig", + "description": "Optional. Configuration for private service connect. If set, the endpoint will be exposed through private service connect." } }, "type": "object" @@ -26453,7 +26598,7 @@ "readOnly": true }, "gcsUri": { - "description": "The GCS object where the request or response is stored.", + "description": "The Cloud Storage object where the request or response is stored.", "type": "string" }, "labels": { @@ -26814,10 +26959,6 @@ "description": "The metric used for evaluation runs.", "id": "GoogleCloudAiplatformV1EvaluationRunMetric", "properties": { - "computationBasedMetricSpec": { - "$ref": "GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec", - "description": "Spec for a computation based metric." - }, "llmBasedMetricSpec": { "$ref": "GoogleCloudAiplatformV1EvaluationRunMetricLLMBasedMetricSpec", "description": "Spec for an LLM based metric." @@ -26837,37 +26978,6 @@ }, "type": "object" }, - "GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec": { - "description": "Specification for a computation based metric.", - "id": "GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec", - "properties": { - "parameters": { - "additionalProperties": { - "description": "Properties of the object.", - "type": "any" - }, - "description": "Optional. A map of parameters for the metric, e.g. {\"rouge_type\": \"rougeL\"}.", - "type": "object" - }, - "type": { - "description": "Required. The type of the computation based metric.", - "enum": [ - "COMPUTATION_BASED_METRIC_TYPE_UNSPECIFIED", - "EXACT_MATCH", - "BLEU", - "ROUGE" - ], - "enumDescriptions": [ - "Unspecified computation based metric type.", - "Exact match metric.", - "BLEU metric.", - "ROUGE metric." - ], - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudAiplatformV1EvaluationRunMetricLLMBasedMetricSpec": { "description": "Specification for an LLM based metric.", "id": "GoogleCloudAiplatformV1EvaluationRunMetricLLMBasedMetricSpec", @@ -29824,7 +29934,7 @@ "type": "object" }, "name": { - "description": "Required. The name of the function to call. Matches [FunctionDeclaration.name].", + "description": "Optional. The name of the function to call. Matches [FunctionDeclaration.name].", "type": "string" } }, @@ -30064,11 +30174,11 @@ "type": "object" }, "GoogleCloudAiplatformV1GenerateContentResponsePromptFeedback": { - "description": "Content filter results for a prompt sent in the request.", + "description": "Content filter results for a prompt sent in the request. Note: This is sent only in the first stream chunk and only if no candidates were generated due to content violations.", "id": "GoogleCloudAiplatformV1GenerateContentResponsePromptFeedback", "properties": { "blockReason": { - "description": "Output only. Blocked reason.", + "description": "Output only. The reason why the prompt was blocked.", "enum": [ "BLOCKED_REASON_UNSPECIFIED", "SAFETY", @@ -30079,24 +30189,24 @@ "IMAGE_SAFETY" ], "enumDescriptions": [ - "Unspecified blocked reason.", - "Candidates blocked due to safety.", - "Candidates blocked due to other reason.", - "Candidates blocked due to the terms which are included from the terminology blocklist.", - "Candidates blocked due to prohibited content.", - "The user prompt was blocked by Model Armor.", - "Candidates blocked due to unsafe image generation content." + "The blocked reason is unspecified.", + "The prompt was blocked for safety reasons.", + "The prompt was blocked for other reasons. For example, it may be due to the prompt's language, or because it contains other harmful content.", + "The prompt was blocked because it contains a term from the terminology blocklist.", + "The prompt was blocked because it contains prohibited content.", + "The prompt was blocked by Model Armor.", + "The prompt was blocked because it contains content that is unsafe for image generation." ], "readOnly": true, "type": "string" }, "blockReasonMessage": { - "description": "Output only. A readable block reason message.", + "description": "Output only. A readable message that explains the reason why the prompt was blocked.", "readOnly": true, "type": "string" }, "safetyRatings": { - "description": "Output only. Safety ratings.", + "description": "Output only. A list of safety ratings for the prompt. There is one rating per category.", "items": { "$ref": "GoogleCloudAiplatformV1SafetyRating" }, @@ -30107,11 +30217,11 @@ "type": "object" }, "GoogleCloudAiplatformV1GenerateContentResponseUsageMetadata": { - "description": "Usage metadata about response(s).", + "description": "Usage metadata about the content generation request and response. This message provides a detailed breakdown of token usage and other relevant metrics.", "id": "GoogleCloudAiplatformV1GenerateContentResponseUsageMetadata", "properties": { "cacheTokensDetails": { - "description": "Output only. List of modalities of the cached content in the request input.", + "description": "Output only. A detailed breakdown of the token count for each modality in the cached content.", "items": { "$ref": "GoogleCloudAiplatformV1ModalityTokenCount" }, @@ -30119,18 +30229,18 @@ "type": "array" }, "cachedContentTokenCount": { - "description": "Output only. Number of tokens in the cached part in the input (the cached content).", + "description": "Output only. The number of tokens in the cached content that was used for this request.", "format": "int32", "readOnly": true, "type": "integer" }, "candidatesTokenCount": { - "description": "Number of tokens in the response(s).", + "description": "The total number of tokens in the generated candidates.", "format": "int32", "type": "integer" }, "candidatesTokensDetails": { - "description": "Output only. List of modalities that were returned in the response.", + "description": "Output only. A detailed breakdown of the token count for each modality in the generated candidates.", "items": { "$ref": "GoogleCloudAiplatformV1ModalityTokenCount" }, @@ -30138,12 +30248,12 @@ "type": "array" }, "promptTokenCount": { - "description": "Number of tokens in the request. When `cached_content` is set, this is still the total effective prompt size meaning this includes the number of tokens in the cached content.", + "description": "The total number of tokens in the prompt. This includes any text, images, or other media provided in the request. When `cached_content` is set, this also includes the number of tokens in the cached content.", "format": "int32", "type": "integer" }, "promptTokensDetails": { - "description": "Output only. List of modalities that were processed in the request input.", + "description": "Output only. A detailed breakdown of the token count for each modality in the prompt.", "items": { "$ref": "GoogleCloudAiplatformV1ModalityTokenCount" }, @@ -30151,19 +30261,19 @@ "type": "array" }, "thoughtsTokenCount": { - "description": "Output only. Number of tokens present in thoughts output.", + "description": "Output only. The number of tokens that were part of the model's generated \"thoughts\" output, if applicable.", "format": "int32", "readOnly": true, "type": "integer" }, "toolUsePromptTokenCount": { - "description": "Output only. Number of tokens present in tool-use prompt(s).", + "description": "Output only. The number of tokens in the results from tool executions, which are provided back to the model as input, if applicable.", "format": "int32", "readOnly": true, "type": "integer" }, "toolUsePromptTokensDetails": { - "description": "Output only. List of modalities that were processed for tool-use request inputs.", + "description": "Output only. A detailed breakdown by modality of the token counts from the results of tool executions, which are provided back to the model as input.", "items": { "$ref": "GoogleCloudAiplatformV1ModalityTokenCount" }, @@ -30171,12 +30281,12 @@ "type": "array" }, "totalTokenCount": { - "description": "Total token count for prompt, response candidates, and tool-use prompts (if present).", + "description": "The total number of tokens for the entire request. This is the sum of `prompt_token_count`, `candidates_token_count`, `tool_use_prompt_token_count`, and `thoughts_token_count`.", "format": "int32", "type": "integer" }, "trafficType": { - "description": "Output only. Traffic type. This shows whether a request consumes Pay-As-You-Go or Provisioned Throughput quota.", + "description": "Output only. The traffic type for this request.", "enum": [ "TRAFFIC_TYPE_UNSPECIFIED", "ON_DEMAND", @@ -30184,7 +30294,7 @@ ], "enumDescriptions": [ "Unspecified request traffic type.", - "Type for Pay-As-You-Go traffic.", + "The request was processed using Pay-As-You-Go quota.", "Type for Provisioned Throughput traffic." ], "readOnly": true, @@ -30602,7 +30712,12 @@ "GoogleCloudAiplatformV1GoogleMaps": { "description": "Tool to retrieve public maps data for grounding, powered by Google.", "id": "GoogleCloudAiplatformV1GoogleMaps", - "properties": {}, + "properties": { + "enableWidget": { + "description": "Optional. If true, include the widget context token in the response.", + "type": "boolean" + } + }, "type": "object" }, "GoogleCloudAiplatformV1GoogleSearchRetrieval": { @@ -30714,15 +30829,15 @@ "type": "string" }, "text": { - "description": "Text of the chunk.", + "description": "Text of the place answer.", "type": "string" }, "title": { - "description": "Title of the chunk.", + "description": "Title of the place.", "type": "string" }, "uri": { - "description": "URI reference of the chunk.", + "description": "URI reference of the place.", "type": "string" } }, @@ -30732,10 +30847,6 @@ "description": "Sources used to generate the place answer.", "id": "GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSources", "properties": { - "flagContentUri": { - "description": "A link where users can flag a problem with the generated answer.", - "type": "string" - }, "reviewSnippets": { "description": "Snippets of reviews that are used to generate the answer.", "items": { @@ -30746,47 +30857,20 @@ }, "type": "object" }, - "GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution": { - "description": "Author attribution for a photo or review.", - "id": "GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution", - "properties": { - "displayName": { - "description": "Name of the author of the Photo or Review.", - "type": "string" - }, - "photoUri": { - "description": "Profile photo URI of the author of the Photo or Review.", - "type": "string" - }, - "uri": { - "description": "URI of the author of the Photo or Review.", - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet": { "description": "Encapsulates a review snippet.", "id": "GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet", "properties": { - "authorAttribution": { - "$ref": "GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution", - "description": "This review's author." - }, - "flagContentUri": { - "description": "A link where users can flag a problem with the review.", - "type": "string" - }, "googleMapsUri": { "description": "A link to show the review on Google Maps.", "type": "string" }, - "relativePublishTimeDescription": { - "description": "A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country.", + "reviewId": { + "description": "Id of the review referencing the place.", "type": "string" }, - "review": { - "description": "A reference representing this place review which may be used to look up this place review again.", + "title": { + "description": "Title of the review.", "type": "string" } }, @@ -30871,6 +30955,14 @@ "$ref": "GoogleCloudAiplatformV1SearchEntryPoint", "description": "Optional. Google search entry for the following-up web searches." }, + "sourceFlaggingUris": { + "description": "Optional. Output only. List of source flagging uris. This is currently populated only for Google Maps grounding.", + "items": { + "$ref": "GoogleCloudAiplatformV1GroundingMetadataSourceFlaggingUri" + }, + "readOnly": true, + "type": "array" + }, "webSearchQueries": { "description": "Optional. Web search queries for the following-up web search.", "items": { @@ -30881,6 +30973,21 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1GroundingMetadataSourceFlaggingUri": { + "description": "Source content flagging uri for a place or review. This is currently populated only for Google Maps grounding.", + "id": "GoogleCloudAiplatformV1GroundingMetadataSourceFlaggingUri", + "properties": { + "flagContentUri": { + "description": "A link where users can flag a problem with the source (place or review).", + "type": "string" + }, + "sourceId": { + "description": "Id of the place or review.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1GroundingSupport": { "description": "Grounding support.", "id": "GoogleCloudAiplatformV1GroundingSupport", @@ -31808,6 +31915,21 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1InvokeRequest": { + "description": "Request message for PredictionService.Invoke.", + "id": "GoogleCloudAiplatformV1InvokeRequest", + "properties": { + "deployedModelId": { + "description": "ID of the DeployedModel that serves the invoke request.", + "type": "string" + }, + "httpBody": { + "$ref": "GoogleApiHttpBody", + "description": "The invoke method input. Supports HTTP headers and arbitrary data payload." + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1JiraSource": { "description": "The Jira source for the ImportRagFilesRequest.", "id": "GoogleCloudAiplatformV1JiraSource", @@ -31855,6 +31977,45 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1LLMBasedMetricSpec": { + "description": "Specification for an LLM based metric.", + "id": "GoogleCloudAiplatformV1LLMBasedMetricSpec", + "properties": { + "additionalConfig": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Optional additional configuration for the metric.", + "type": "object" + }, + "judgeAutoraterConfig": { + "$ref": "GoogleCloudAiplatformV1AutoraterConfig", + "description": "Optional. Optional configuration for the judge LLM (Autorater)." + }, + "metricPromptTemplate": { + "description": "Required. Template for the prompt sent to the judge model.", + "type": "string" + }, + "predefinedRubricGenerationSpec": { + "$ref": "GoogleCloudAiplatformV1PredefinedMetricSpec", + "description": "Dynamically generate rubrics using a predefined spec." + }, + "rubricGenerationSpec": { + "$ref": "GoogleCloudAiplatformV1RubricGenerationSpec", + "description": "Dynamically generate rubrics using this specification." + }, + "rubricGroupKey": { + "description": "Use a pre-defined group of rubrics associated with the input. Refers to a key in the rubric_groups map of EvaluationInstance.", + "type": "string" + }, + "systemInstruction": { + "description": "Optional. System instructions for the judge model.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1LargeModelReference": { "description": "Contains information about the Large Model.", "id": "GoogleCloudAiplatformV1LargeModelReference", @@ -32970,6 +33131,29 @@ }, "type": "object" }, + "GoogleCloudAiplatformV1LustreMount": { + "description": "Represents a mount configuration for Lustre file system.", + "id": "GoogleCloudAiplatformV1LustreMount", + "properties": { + "filesystem": { + "description": "Required. The name of the Lustre filesystem.", + "type": "string" + }, + "instanceIp": { + "description": "Required. IP address of the Lustre instance.", + "type": "string" + }, + "mountPoint": { + "description": "Required. Destination mount path. The Lustre file system will be mounted for the user under /mnt/lustre/", + "type": "string" + }, + "volumeHandle": { + "description": "Required. The unique identifier of the Lustre volume.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudAiplatformV1MachineSpec": { "description": "Specification of a single machine.", "id": "GoogleCloudAiplatformV1MachineSpec", @@ -32996,6 +33180,7 @@ "NVIDIA_H200_141GB", "NVIDIA_B200", "NVIDIA_GB200", + "NVIDIA_RTX_PRO_6000", "TPU_V2", "TPU_V3", "TPU_V4_POD", @@ -33019,6 +33204,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -33036,6 +33222,7 @@ "Nvidia H200 141Gb GPU.", "Nvidia B200 GPU.", "Nvidia GB200 GPU.", + "Nvidia RTX Pro 6000 GPU.", "TPU v2.", "TPU v3.", "TPU v4.", @@ -33284,6 +33471,10 @@ "$ref": "GoogleCloudAiplatformV1ExactMatchSpec", "description": "Spec for exact match metric." }, + "llmBasedMetricSpec": { + "$ref": "GoogleCloudAiplatformV1LLMBasedMetricSpec", + "description": "Spec for an LLM based metric." + }, "pairwiseMetricSpec": { "$ref": "GoogleCloudAiplatformV1PairwiseMetricSpec", "description": "Spec for pairwise metric." @@ -47636,7 +47827,8 @@ }, "googleSearchRetrieval": { "$ref": "GoogleCloudAiplatformV1GoogleSearchRetrieval", - "description": "Optional. GoogleSearchRetrieval tool type. Specialized retrieval tool that is powered by Google search." + "deprecated": true, + "description": "Optional. Specialized retrieval tool that is powered by Google Search." }, "retrieval": { "$ref": "GoogleCloudAiplatformV1Retrieval", @@ -49470,6 +49662,13 @@ "$ref": "GoogleCloudAiplatformV1DiskSpec", "description": "Disk spec." }, + "lustreMounts": { + "description": "Optional. List of Lustre mounts.", + "items": { + "$ref": "GoogleCloudAiplatformV1LustreMount" + }, + "type": "array" + }, "machineSpec": { "$ref": "GoogleCloudAiplatformV1MachineSpec", "description": "Optional. Immutable. The specification of a single machine." diff --git a/aiplatform/v1/aiplatform-gen.go b/aiplatform/v1/aiplatform-gen.go index ee11a099348..d2cf5e4a398 100644 --- a/aiplatform/v1/aiplatform-gen.go +++ b/aiplatform/v1/aiplatform-gen.go @@ -587,6 +587,9 @@ type ProjectsLocationsDeploymentResourcePoolsOperationsService struct { func NewProjectsLocationsEndpointsService(s *Service) *ProjectsLocationsEndpointsService { rs := &ProjectsLocationsEndpointsService{s: s} rs.Chat = NewProjectsLocationsEndpointsChatService(s) + rs.DeployedModels = NewProjectsLocationsEndpointsDeployedModelsService(s) + rs.Invoke = NewProjectsLocationsEndpointsInvokeService(s) + rs.Openapi = NewProjectsLocationsEndpointsOpenapiService(s) rs.Operations = NewProjectsLocationsEndpointsOperationsService(s) return rs } @@ -596,6 +599,12 @@ type ProjectsLocationsEndpointsService struct { Chat *ProjectsLocationsEndpointsChatService + DeployedModels *ProjectsLocationsEndpointsDeployedModelsService + + Invoke *ProjectsLocationsEndpointsInvokeService + + Openapi *ProjectsLocationsEndpointsOpenapiService + Operations *ProjectsLocationsEndpointsOperationsService } @@ -608,6 +617,45 @@ type ProjectsLocationsEndpointsChatService struct { s *Service } +func NewProjectsLocationsEndpointsDeployedModelsService(s *Service) *ProjectsLocationsEndpointsDeployedModelsService { + rs := &ProjectsLocationsEndpointsDeployedModelsService{s: s} + rs.Invoke = NewProjectsLocationsEndpointsDeployedModelsInvokeService(s) + return rs +} + +type ProjectsLocationsEndpointsDeployedModelsService struct { + s *Service + + Invoke *ProjectsLocationsEndpointsDeployedModelsInvokeService +} + +func NewProjectsLocationsEndpointsDeployedModelsInvokeService(s *Service) *ProjectsLocationsEndpointsDeployedModelsInvokeService { + rs := &ProjectsLocationsEndpointsDeployedModelsInvokeService{s: s} + return rs +} + +type ProjectsLocationsEndpointsDeployedModelsInvokeService struct { + s *Service +} + +func NewProjectsLocationsEndpointsInvokeService(s *Service) *ProjectsLocationsEndpointsInvokeService { + rs := &ProjectsLocationsEndpointsInvokeService{s: s} + return rs +} + +type ProjectsLocationsEndpointsInvokeService struct { + s *Service +} + +func NewProjectsLocationsEndpointsOpenapiService(s *Service) *ProjectsLocationsEndpointsOpenapiService { + rs := &ProjectsLocationsEndpointsOpenapiService{s: s} + return rs +} + +type ProjectsLocationsEndpointsOpenapiService struct { + s *Service +} + func NewProjectsLocationsEndpointsOperationsService(s *Service) *ProjectsLocationsEndpointsOperationsService { rs := &ProjectsLocationsEndpointsOperationsService{s: s} return rs @@ -2988,6 +3036,9 @@ type GoogleCloudAiplatformV1AutoraterConfig struct { // PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields // will be flipped for half of the samples to reduce bias. FlipEnabled bool `json:"flipEnabled,omitempty"` + // GenerationConfig: Optional. Configuration options for model generation and + // outputs. + GenerationConfig *GoogleCloudAiplatformV1GenerationConfig `json:"generationConfig,omitempty"` // SamplingCount: Optional. Number of samples for each instance in the dataset. // If not specified, the default is 4. Minimum value is 1, maximum value is 32. SamplingCount int64 `json:"samplingCount,omitempty"` @@ -4089,7 +4140,7 @@ type GoogleCloudAiplatformV1BigQueryRequestSet struct { // evaluate. This will be in evaluation_item.EvalPrompt format. PromptColumn string `json:"promptColumn,omitempty"` // RubricsColumn: Optional. The name of the column that contains the rubrics. - // This will be in evaluation_rubric.RubricGroup format (cl/762595858). + // This is in evaluation_rubric.RubricGroup format. RubricsColumn string `json:"rubricsColumn,omitempty"` // SamplingConfig: Optional. The sampling config for the bigquery resource. SamplingConfig *GoogleCloudAiplatformV1BigQueryRequestSetSamplingConfig `json:"samplingConfig,omitempty"` @@ -7723,14 +7774,16 @@ func (s GoogleCloudAiplatformV1DeployRequestDeployConfig) MarshalJSON() ([]byte, // use for the deployment. type GoogleCloudAiplatformV1DeployRequestEndpointConfig struct { // DedicatedEndpointDisabled: Optional. By default, if dedicated endpoint is - // enabled, the endpoint will be exposed through a dedicated DNS - // [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be - // isolated from other users' traffic and will have better performance and - // reliability. Note: Once you enabled dedicated endpoint, you won't be able to - // send request to the shared DNS {region}-aiplatform.googleapis.com. The - // limitations will be removed soon. If this field is set to true, the - // dedicated endpoint will be disabled and the deployed model will be exposed - // through the shared DNS {region}-aiplatform.googleapis.com. + // enabled and private service connect config is not set, the endpoint will be + // exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. If + // private service connect config is set, the endpoint will be exposed through + // private service connect. Your request to the dedicated DNS will be isolated + // from other users' traffic and will have better performance and reliability. + // Note: Once you enabled dedicated endpoint, you won't be able to send request + // to the shared DNS {region}-aiplatform.googleapis.com. The limitations will + // be removed soon. If this field is set to true, the dedicated endpoint will + // be disabled and the deployed model will be exposed through the shared DNS + // {region}-aiplatform.googleapis.com. DedicatedEndpointDisabled bool `json:"dedicatedEndpointDisabled,omitempty"` // DedicatedEndpointEnabled: Optional. Deprecated. Use // dedicated_endpoint_disabled instead. If true, the endpoint will be exposed @@ -7754,6 +7807,10 @@ type GoogleCloudAiplatformV1DeployRequestEndpointConfig struct { // `?endpoint_id=12345`. This is the fallback for fields that are not included // in either the URI or the body. EndpointUserId string `json:"endpointUserId,omitempty"` + // PrivateServiceConnectConfig: Optional. Configuration for private service + // connect. If set, the endpoint will be exposed through private service + // connect. + PrivateServiceConnectConfig *GoogleCloudAiplatformV1PrivateServiceConnectConfig `json:"privateServiceConnectConfig,omitempty"` // ForceSendFields is a list of field names (e.g. "DedicatedEndpointDisabled") // to unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -9424,7 +9481,7 @@ type GoogleCloudAiplatformV1EvaluationItem struct { EvaluationRequest *GoogleCloudAiplatformV1EvaluationRequest `json:"evaluationRequest,omitempty"` // EvaluationResponse: Output only. The response from evaluation. EvaluationResponse *GoogleCloudAiplatformV1EvaluationResult `json:"evaluationResponse,omitempty"` - // GcsUri: The GCS object where the request or response is stored. + // GcsUri: The Cloud Storage object where the request or response is stored. GcsUri string `json:"gcsUri,omitempty"` // Labels: Optional. Labels for the EvaluationItem. Labels map[string]string `json:"labels,omitempty"` @@ -9879,8 +9936,6 @@ func (s GoogleCloudAiplatformV1EvaluationRunInferenceConfig) MarshalJSON() ([]by // GoogleCloudAiplatformV1EvaluationRunMetric: The metric used for evaluation // runs. type GoogleCloudAiplatformV1EvaluationRunMetric struct { - // ComputationBasedMetricSpec: Spec for a computation based metric. - ComputationBasedMetricSpec *GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec `json:"computationBasedMetricSpec,omitempty"` // LlmBasedMetricSpec: Spec for an LLM based metric. LlmBasedMetricSpec *GoogleCloudAiplatformV1EvaluationRunMetricLLMBasedMetricSpec `json:"llmBasedMetricSpec,omitempty"` // Metric: Required. The name of the metric. @@ -9889,15 +9944,15 @@ type GoogleCloudAiplatformV1EvaluationRunMetric struct { PredefinedMetricSpec *GoogleCloudAiplatformV1EvaluationRunMetricPredefinedMetricSpec `json:"predefinedMetricSpec,omitempty"` // RubricBasedMetricSpec: Spec for rubric based metric. RubricBasedMetricSpec *GoogleCloudAiplatformV1EvaluationRunMetricRubricBasedMetricSpec `json:"rubricBasedMetricSpec,omitempty"` - // ForceSendFields is a list of field names (e.g. "ComputationBasedMetricSpec") - // to unconditionally include in API requests. By default, fields with empty or + // ForceSendFields is a list of field names (e.g. "LlmBasedMetricSpec") 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. "ComputationBasedMetricSpec") 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. "LlmBasedMetricSpec") 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:"-"` } @@ -9907,39 +9962,6 @@ func (s GoogleCloudAiplatformV1EvaluationRunMetric) MarshalJSON() ([]byte, error return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec: -// Specification for a computation based metric. -type GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec struct { - // Parameters: Optional. A map of parameters for the metric, e.g. - // {"rouge_type": "rougeL"}. - Parameters googleapi.RawMessage `json:"parameters,omitempty"` - // Type: Required. The type of the computation based metric. - // - // Possible values: - // "COMPUTATION_BASED_METRIC_TYPE_UNSPECIFIED" - Unspecified computation - // based metric type. - // "EXACT_MATCH" - Exact match metric. - // "BLEU" - BLEU metric. - // "ROUGE" - ROUGE metric. - Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Parameters") 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. "Parameters") 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 GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudAiplatformV1EvaluationRunMetricLLMBasedMetricSpec: Specification // for an LLM based metric. type GoogleCloudAiplatformV1EvaluationRunMetricLLMBasedMetricSpec struct { @@ -14316,7 +14338,7 @@ type GoogleCloudAiplatformV1FunctionCall struct { // Args: Optional. The function parameters and values in JSON object format. // See [FunctionDeclaration.parameters] for parameter details. Args googleapi.RawMessage `json:"args,omitempty"` - // Name: Required. The name of the function to call. Matches + // Name: Optional. The name of the function to call. Matches // [FunctionDeclaration.name]. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Args") to unconditionally @@ -14687,24 +14709,30 @@ func (s GoogleCloudAiplatformV1GenerateContentResponse) MarshalJSON() ([]byte, e } // GoogleCloudAiplatformV1GenerateContentResponsePromptFeedback: Content filter -// results for a prompt sent in the request. +// results for a prompt sent in the request. Note: This is sent only in the +// first stream chunk and only if no candidates were generated due to content +// violations. type GoogleCloudAiplatformV1GenerateContentResponsePromptFeedback struct { - // BlockReason: Output only. Blocked reason. + // BlockReason: Output only. The reason why the prompt was blocked. // // Possible values: - // "BLOCKED_REASON_UNSPECIFIED" - Unspecified blocked reason. - // "SAFETY" - Candidates blocked due to safety. - // "OTHER" - Candidates blocked due to other reason. - // "BLOCKLIST" - Candidates blocked due to the terms which are included from - // the terminology blocklist. - // "PROHIBITED_CONTENT" - Candidates blocked due to prohibited content. - // "MODEL_ARMOR" - The user prompt was blocked by Model Armor. - // "IMAGE_SAFETY" - Candidates blocked due to unsafe image generation - // content. + // "BLOCKED_REASON_UNSPECIFIED" - The blocked reason is unspecified. + // "SAFETY" - The prompt was blocked for safety reasons. + // "OTHER" - The prompt was blocked for other reasons. For example, it may be + // due to the prompt's language, or because it contains other harmful content. + // "BLOCKLIST" - The prompt was blocked because it contains a term from the + // terminology blocklist. + // "PROHIBITED_CONTENT" - The prompt was blocked because it contains + // prohibited content. + // "MODEL_ARMOR" - The prompt was blocked by Model Armor. + // "IMAGE_SAFETY" - The prompt was blocked because it contains content that + // is unsafe for image generation. BlockReason string `json:"blockReason,omitempty"` - // BlockReasonMessage: Output only. A readable block reason message. + // BlockReasonMessage: Output only. A readable message that explains the reason + // why the prompt was blocked. BlockReasonMessage string `json:"blockReasonMessage,omitempty"` - // SafetyRatings: Output only. Safety ratings. + // SafetyRatings: Output only. A list of safety ratings for the prompt. There + // is one rating per category. SafetyRatings []*GoogleCloudAiplatformV1SafetyRating `json:"safetyRatings,omitempty"` // ForceSendFields is a list of field names (e.g. "BlockReason") to // unconditionally include in API requests. By default, fields with empty or @@ -14725,44 +14753,49 @@ func (s GoogleCloudAiplatformV1GenerateContentResponsePromptFeedback) MarshalJSO } // GoogleCloudAiplatformV1GenerateContentResponseUsageMetadata: Usage metadata -// about response(s). +// about the content generation request and response. This message provides a +// detailed breakdown of token usage and other relevant metrics. type GoogleCloudAiplatformV1GenerateContentResponseUsageMetadata struct { - // CacheTokensDetails: Output only. List of modalities of the cached content in - // the request input. + // CacheTokensDetails: Output only. A detailed breakdown of the token count for + // each modality in the cached content. CacheTokensDetails []*GoogleCloudAiplatformV1ModalityTokenCount `json:"cacheTokensDetails,omitempty"` - // CachedContentTokenCount: Output only. Number of tokens in the cached part in - // the input (the cached content). + // CachedContentTokenCount: Output only. The number of tokens in the cached + // content that was used for this request. CachedContentTokenCount int64 `json:"cachedContentTokenCount,omitempty"` - // CandidatesTokenCount: Number of tokens in the response(s). + // CandidatesTokenCount: The total number of tokens in the generated + // candidates. CandidatesTokenCount int64 `json:"candidatesTokenCount,omitempty"` - // CandidatesTokensDetails: Output only. List of modalities that were returned - // in the response. + // CandidatesTokensDetails: Output only. A detailed breakdown of the token + // count for each modality in the generated candidates. CandidatesTokensDetails []*GoogleCloudAiplatformV1ModalityTokenCount `json:"candidatesTokensDetails,omitempty"` - // PromptTokenCount: Number of tokens in the request. When `cached_content` is - // set, this is still the total effective prompt size meaning this includes the - // number of tokens in the cached content. + // PromptTokenCount: The total number of tokens in the prompt. This includes + // any text, images, or other media provided in the request. When + // `cached_content` is set, this also includes the number of tokens in the + // cached content. PromptTokenCount int64 `json:"promptTokenCount,omitempty"` - // PromptTokensDetails: Output only. List of modalities that were processed in - // the request input. + // PromptTokensDetails: Output only. A detailed breakdown of the token count + // for each modality in the prompt. PromptTokensDetails []*GoogleCloudAiplatformV1ModalityTokenCount `json:"promptTokensDetails,omitempty"` - // ThoughtsTokenCount: Output only. Number of tokens present in thoughts - // output. + // ThoughtsTokenCount: Output only. The number of tokens that were part of the + // model's generated "thoughts" output, if applicable. ThoughtsTokenCount int64 `json:"thoughtsTokenCount,omitempty"` - // ToolUsePromptTokenCount: Output only. Number of tokens present in tool-use - // prompt(s). + // ToolUsePromptTokenCount: Output only. The number of tokens in the results + // from tool executions, which are provided back to the model as input, if + // applicable. ToolUsePromptTokenCount int64 `json:"toolUsePromptTokenCount,omitempty"` - // ToolUsePromptTokensDetails: Output only. List of modalities that were - // processed for tool-use request inputs. + // ToolUsePromptTokensDetails: Output only. A detailed breakdown by modality of + // the token counts from the results of tool executions, which are provided + // back to the model as input. ToolUsePromptTokensDetails []*GoogleCloudAiplatformV1ModalityTokenCount `json:"toolUsePromptTokensDetails,omitempty"` - // TotalTokenCount: Total token count for prompt, response candidates, and - // tool-use prompts (if present). + // TotalTokenCount: The total number of tokens for the entire request. This is + // the sum of `prompt_token_count`, `candidates_token_count`, + // `tool_use_prompt_token_count`, and `thoughts_token_count`. TotalTokenCount int64 `json:"totalTokenCount,omitempty"` - // TrafficType: Output only. Traffic type. This shows whether a request - // consumes Pay-As-You-Go or Provisioned Throughput quota. + // TrafficType: Output only. The traffic type for this request. // // Possible values: // "TRAFFIC_TYPE_UNSPECIFIED" - Unspecified request traffic type. - // "ON_DEMAND" - Type for Pay-As-You-Go traffic. + // "ON_DEMAND" - The request was processed using Pay-As-You-Go quota. // "PROVISIONED_THROUGHPUT" - Type for Provisioned Throughput traffic. TrafficType string `json:"trafficType,omitempty"` // ForceSendFields is a list of field names (e.g. "CacheTokensDetails") to @@ -15298,6 +15331,25 @@ func (s GoogleCloudAiplatformV1GoogleDriveSourceResourceId) MarshalJSON() ([]byt // GoogleCloudAiplatformV1GoogleMaps: Tool to retrieve public maps data for // grounding, powered by Google. type GoogleCloudAiplatformV1GoogleMaps struct { + // EnableWidget: Optional. If true, include the widget context token in the + // response. + EnableWidget bool `json:"enableWidget,omitempty"` + // ForceSendFields is a list of field names (e.g. "EnableWidget") 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. "EnableWidget") 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 GoogleCloudAiplatformV1GoogleMaps) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1GoogleMaps + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } // GoogleCloudAiplatformV1GoogleSearchRetrieval: Tool to retrieve public web @@ -15473,11 +15525,11 @@ type GoogleCloudAiplatformV1GroundingChunkMaps struct { // PlaceId: This Place's resource name, in `places/{place_id}` format. Can be // used to look up the Place. PlaceId string `json:"placeId,omitempty"` - // Text: Text of the chunk. + // Text: Text of the place answer. Text string `json:"text,omitempty"` - // Title: Title of the chunk. + // Title: Title of the place. Title string `json:"title,omitempty"` - // Uri: URI reference of the chunk. + // Uri: URI reference of the place. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "PlaceAnswerSources") to // unconditionally include in API requests. By default, fields with empty or @@ -15500,18 +15552,15 @@ func (s GoogleCloudAiplatformV1GroundingChunkMaps) MarshalJSON() ([]byte, error) // GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSources: Sources used to // generate the place answer. type GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSources struct { - // FlagContentUri: A link where users can flag a problem with the generated - // answer. - FlagContentUri string `json:"flagContentUri,omitempty"` // ReviewSnippets: Snippets of reviews that are used to generate the answer. ReviewSnippets []*GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet `json:"reviewSnippets,omitempty"` - // ForceSendFields is a list of field names (e.g. "FlagContentUri") to + // ForceSendFields is a list of field names (e.g. "ReviewSnippets") 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. "FlagContentUri") to include in + // NullFields is a list of field names (e.g. "ReviewSnippets") 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. @@ -15523,59 +15572,24 @@ func (s GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSources) MarshalJSON return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution: -// -// Author attribution for a photo or review. -type GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution struct { - // DisplayName: Name of the author of the Photo or Review. - DisplayName string `json:"displayName,omitempty"` - // PhotoUri: Profile photo URI of the author of the Photo or Review. - PhotoUri string `json:"photoUri,omitempty"` - // Uri: URI of the author of the Photo or Review. - Uri string `json:"uri,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 GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet: // Encapsulates a review snippet. type GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet struct { - // AuthorAttribution: This review's author. - AuthorAttribution *GoogleCloudAiplatformV1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution `json:"authorAttribution,omitempty"` - // FlagContentUri: A link where users can flag a problem with the review. - FlagContentUri string `json:"flagContentUri,omitempty"` // GoogleMapsUri: A link to show the review on Google Maps. GoogleMapsUri string `json:"googleMapsUri,omitempty"` - // RelativePublishTimeDescription: A string of formatted recent time, - // expressing the review time relative to the current time in a form - // appropriate for the language and country. - RelativePublishTimeDescription string `json:"relativePublishTimeDescription,omitempty"` - // Review: A reference representing this place review which may be used to look - // up this place review again. - Review string `json:"review,omitempty"` - // ForceSendFields is a list of field names (e.g. "AuthorAttribution") to + // ReviewId: Id of the review referencing the place. + ReviewId string `json:"reviewId,omitempty"` + // Title: Title of the review. + Title string `json:"title,omitempty"` + // ForceSendFields is a list of field names (e.g. "GoogleMapsUri") 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. "AuthorAttribution") 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. "GoogleMapsUri") 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:"-"` } @@ -15662,6 +15676,9 @@ type GoogleCloudAiplatformV1GroundingMetadata struct { // SearchEntryPoint: Optional. Google search entry for the following-up web // searches. SearchEntryPoint *GoogleCloudAiplatformV1SearchEntryPoint `json:"searchEntryPoint,omitempty"` + // SourceFlaggingUris: Optional. Output only. List of source flagging uris. + // This is currently populated only for Google Maps grounding. + SourceFlaggingUris []*GoogleCloudAiplatformV1GroundingMetadataSourceFlaggingUri `json:"sourceFlaggingUris,omitempty"` // WebSearchQueries: Optional. Web search queries for the following-up web // search. WebSearchQueries []string `json:"webSearchQueries,omitempty"` @@ -15683,6 +15700,33 @@ func (s GoogleCloudAiplatformV1GroundingMetadata) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1GroundingMetadataSourceFlaggingUri: Source content +// flagging uri for a place or review. This is currently populated only for +// Google Maps grounding. +type GoogleCloudAiplatformV1GroundingMetadataSourceFlaggingUri struct { + // FlagContentUri: A link where users can flag a problem with the source (place + // or review). + FlagContentUri string `json:"flagContentUri,omitempty"` + // SourceId: Id of the place or review. + SourceId string `json:"sourceId,omitempty"` + // ForceSendFields is a list of field names (e.g. "FlagContentUri") 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. "FlagContentUri") 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 GoogleCloudAiplatformV1GroundingMetadataSourceFlaggingUri) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1GroundingMetadataSourceFlaggingUri + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1GroundingSupport: Grounding support. type GoogleCloudAiplatformV1GroundingSupport struct { // ConfidenceScores: Confidence score of the support references. Ranges from 0 @@ -16834,6 +16878,32 @@ func (s GoogleCloudAiplatformV1IntegratedGradientsAttribution) MarshalJSON() ([] return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1InvokeRequest: Request message for +// PredictionService.Invoke. +type GoogleCloudAiplatformV1InvokeRequest struct { + // DeployedModelId: ID of the DeployedModel that serves the invoke request. + DeployedModelId string `json:"deployedModelId,omitempty"` + // HttpBody: The invoke method input. Supports HTTP headers and arbitrary data + // payload. + HttpBody *GoogleApiHttpBody `json:"httpBody,omitempty"` + // ForceSendFields is a list of field names (e.g. "DeployedModelId") 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. "DeployedModelId") 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 GoogleCloudAiplatformV1InvokeRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1InvokeRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1JiraSource: The Jira source for the // ImportRagFilesRequest. type GoogleCloudAiplatformV1JiraSource struct { @@ -16893,6 +16963,46 @@ func (s GoogleCloudAiplatformV1JiraSourceJiraQueries) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1LLMBasedMetricSpec: Specification for an LLM based +// metric. +type GoogleCloudAiplatformV1LLMBasedMetricSpec struct { + // AdditionalConfig: Optional. Optional additional configuration for the + // metric. + AdditionalConfig googleapi.RawMessage `json:"additionalConfig,omitempty"` + // JudgeAutoraterConfig: Optional. Optional configuration for the judge LLM + // (Autorater). + JudgeAutoraterConfig *GoogleCloudAiplatformV1AutoraterConfig `json:"judgeAutoraterConfig,omitempty"` + // MetricPromptTemplate: Required. Template for the prompt sent to the judge + // model. + MetricPromptTemplate string `json:"metricPromptTemplate,omitempty"` + // PredefinedRubricGenerationSpec: Dynamically generate rubrics using a + // predefined spec. + PredefinedRubricGenerationSpec *GoogleCloudAiplatformV1PredefinedMetricSpec `json:"predefinedRubricGenerationSpec,omitempty"` + // RubricGenerationSpec: Dynamically generate rubrics using this specification. + RubricGenerationSpec *GoogleCloudAiplatformV1RubricGenerationSpec `json:"rubricGenerationSpec,omitempty"` + // RubricGroupKey: Use a pre-defined group of rubrics associated with the + // input. Refers to a key in the rubric_groups map of EvaluationInstance. + RubricGroupKey string `json:"rubricGroupKey,omitempty"` + // SystemInstruction: Optional. System instructions for the judge model. + SystemInstruction string `json:"systemInstruction,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalConfig") 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. "AdditionalConfig") 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 GoogleCloudAiplatformV1LLMBasedMetricSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1LLMBasedMetricSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1LargeModelReference: Contains information about the // Large Model. type GoogleCloudAiplatformV1LargeModelReference struct { @@ -18707,6 +18817,36 @@ func (s GoogleCloudAiplatformV1LookupStudyRequest) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudAiplatformV1LustreMount: Represents a mount configuration for +// Lustre file system. +type GoogleCloudAiplatformV1LustreMount struct { + // Filesystem: Required. The name of the Lustre filesystem. + Filesystem string `json:"filesystem,omitempty"` + // InstanceIp: Required. IP address of the Lustre instance. + InstanceIp string `json:"instanceIp,omitempty"` + // MountPoint: Required. Destination mount path. The Lustre file system will be + // mounted for the user under /mnt/lustre/ + MountPoint string `json:"mountPoint,omitempty"` + // VolumeHandle: Required. The unique identifier of the Lustre volume. + VolumeHandle string `json:"volumeHandle,omitempty"` + // ForceSendFields is a list of field names (e.g. "Filesystem") 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. "Filesystem") 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 GoogleCloudAiplatformV1LustreMount) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudAiplatformV1LustreMount + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudAiplatformV1MachineSpec: Specification of a single machine. type GoogleCloudAiplatformV1MachineSpec struct { // AcceleratorCount: The number of accelerators to attach to the machine. @@ -18731,6 +18871,7 @@ type GoogleCloudAiplatformV1MachineSpec struct { // "NVIDIA_H200_141GB" - Nvidia H200 141Gb GPU. // "NVIDIA_B200" - Nvidia B200 GPU. // "NVIDIA_GB200" - Nvidia GB200 GPU. + // "NVIDIA_RTX_PRO_6000" - Nvidia RTX Pro 6000 GPU. // "TPU_V2" - TPU v2. // "TPU_V3" - TPU v3. // "TPU_V4_POD" - TPU v4. @@ -19064,6 +19205,8 @@ type GoogleCloudAiplatformV1Metric struct { BleuSpec *GoogleCloudAiplatformV1BleuSpec `json:"bleuSpec,omitempty"` // ExactMatchSpec: Spec for exact match metric. ExactMatchSpec *GoogleCloudAiplatformV1ExactMatchSpec `json:"exactMatchSpec,omitempty"` + // LlmBasedMetricSpec: Spec for an LLM based metric. + LlmBasedMetricSpec *GoogleCloudAiplatformV1LLMBasedMetricSpec `json:"llmBasedMetricSpec,omitempty"` // PairwiseMetricSpec: Spec for pairwise metric. PairwiseMetricSpec *GoogleCloudAiplatformV1PairwiseMetricSpec `json:"pairwiseMetricSpec,omitempty"` // PointwiseMetricSpec: Spec for pointwise metric. @@ -39696,8 +39839,8 @@ type GoogleCloudAiplatformV1Tool struct { // GoogleSearch: Optional. GoogleSearch tool type. Tool to support Google // Search in Model. Powered by Google. GoogleSearch *GoogleCloudAiplatformV1ToolGoogleSearch `json:"googleSearch,omitempty"` - // GoogleSearchRetrieval: Optional. GoogleSearchRetrieval tool type. - // Specialized retrieval tool that is powered by Google search. + // GoogleSearchRetrieval: Optional. Specialized retrieval tool that is powered + // by Google Search. GoogleSearchRetrieval *GoogleCloudAiplatformV1GoogleSearchRetrieval `json:"googleSearchRetrieval,omitempty"` // Retrieval: Optional. Retrieval tool type. System will always execute the // provided retrieval tool(s) to get external knowledge to answer the prompt. @@ -42634,6 +42777,8 @@ type GoogleCloudAiplatformV1WorkerPoolSpec struct { ContainerSpec *GoogleCloudAiplatformV1ContainerSpec `json:"containerSpec,omitempty"` // DiskSpec: Disk spec. DiskSpec *GoogleCloudAiplatformV1DiskSpec `json:"diskSpec,omitempty"` + // LustreMounts: Optional. List of Lustre mounts. + LustreMounts []*GoogleCloudAiplatformV1LustreMount `json:"lustreMounts,omitempty"` // MachineSpec: Optional. Immutable. The specification of a single machine. MachineSpec *GoogleCloudAiplatformV1MachineSpec `json:"machineSpec,omitempty"` // NfsMounts: Optional. List of NFS mount spec. @@ -47492,9 +47637,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c @@ -60698,6 +60843,346 @@ func (c *ProjectsLocationsEndpointsChatCompletionsCall) Do(opts ...googleapi.Cal return ret, nil } +type ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall struct { + s *Service + endpoint string + deployedModelId string + invokeId string + googlecloudaiplatformv1invokerequest *GoogleCloudAiplatformV1InvokeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Invoke: Forwards arbitrary HTTP requests for both streaming and +// non-streaming cases. To use this method, invoke_route_prefix must be set to +// allow the paths that will be specified in the request. +// +// - deployedModelId: ID of the DeployedModel that serves the invoke request. +// - endpoint: The name of the Endpoint requested to serve the prediction. +// Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`. +// - invokeId: . +func (r *ProjectsLocationsEndpointsDeployedModelsInvokeService) Invoke(endpoint string, deployedModelId string, invokeId string, googlecloudaiplatformv1invokerequest *GoogleCloudAiplatformV1InvokeRequest) *ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall { + c := &ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.endpoint = endpoint + c.deployedModelId = deployedModelId + c.invokeId = invokeId + c.googlecloudaiplatformv1invokerequest = googlecloudaiplatformv1invokerequest + 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 *ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall) Context(ctx context.Context) *ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall { + 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 *ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudaiplatformv1invokerequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+endpoint}/deployedModels/{deployedModelId}/invoke/{+invokeId}") + 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{ + "endpoint": c.endpoint, + "deployedModelId": c.deployedModelId, + "invokeId": c.invokeId, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.endpoints.deployedModels.invoke.invoke", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "aiplatform.projects.locations.endpoints.deployedModels.invoke.invoke" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleApiHttpBody.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 *ProjectsLocationsEndpointsDeployedModelsInvokeInvokeCall) Do(opts ...googleapi.CallOption) (*GoogleApiHttpBody, 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 := &GoogleApiHttpBody{ + 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.endpoints.deployedModels.invoke.invoke", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsEndpointsInvokeInvokeCall struct { + s *Service + endpoint string + invokeId string + googlecloudaiplatformv1invokerequest *GoogleCloudAiplatformV1InvokeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Invoke: Forwards arbitrary HTTP requests for both streaming and +// non-streaming cases. To use this method, invoke_route_prefix must be set to +// allow the paths that will be specified in the request. +// +// - endpoint: The name of the Endpoint requested to serve the prediction. +// Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`. +// - invokeId: . +func (r *ProjectsLocationsEndpointsInvokeService) Invoke(endpoint string, invokeId string, googlecloudaiplatformv1invokerequest *GoogleCloudAiplatformV1InvokeRequest) *ProjectsLocationsEndpointsInvokeInvokeCall { + c := &ProjectsLocationsEndpointsInvokeInvokeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.endpoint = endpoint + c.invokeId = invokeId + c.googlecloudaiplatformv1invokerequest = googlecloudaiplatformv1invokerequest + 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 *ProjectsLocationsEndpointsInvokeInvokeCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointsInvokeInvokeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsEndpointsInvokeInvokeCall) Context(ctx context.Context) *ProjectsLocationsEndpointsInvokeInvokeCall { + 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 *ProjectsLocationsEndpointsInvokeInvokeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsEndpointsInvokeInvokeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googlecloudaiplatformv1invokerequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+endpoint}/invoke/{+invokeId}") + 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{ + "endpoint": c.endpoint, + "invokeId": c.invokeId, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.endpoints.invoke.invoke", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "aiplatform.projects.locations.endpoints.invoke.invoke" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleApiHttpBody.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 *ProjectsLocationsEndpointsInvokeInvokeCall) Do(opts ...googleapi.CallOption) (*GoogleApiHttpBody, 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 := &GoogleApiHttpBody{ + 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.endpoints.invoke.invoke", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsEndpointsOpenapiEmbeddingsCall struct { + s *Service + endpoint string + googleapihttpbody *GoogleApiHttpBody + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Embeddings: Forwards arbitrary HTTP requests for both streaming and +// non-streaming cases. To use this method, invoke_route_prefix must be set to +// allow the paths that will be specified in the request. +// +// - endpoint: The name of the Endpoint requested to serve the prediction. +// Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`. +func (r *ProjectsLocationsEndpointsOpenapiService) Embeddings(endpoint string, googleapihttpbody *GoogleApiHttpBody) *ProjectsLocationsEndpointsOpenapiEmbeddingsCall { + c := &ProjectsLocationsEndpointsOpenapiEmbeddingsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.endpoint = endpoint + c.googleapihttpbody = googleapihttpbody + return c +} + +// DeployedModelId sets the optional parameter "deployedModelId": ID of the +// DeployedModel that serves the invoke request. +func (c *ProjectsLocationsEndpointsOpenapiEmbeddingsCall) DeployedModelId(deployedModelId string) *ProjectsLocationsEndpointsOpenapiEmbeddingsCall { + c.urlParams_.Set("deployedModelId", deployedModelId) + 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 *ProjectsLocationsEndpointsOpenapiEmbeddingsCall) Fields(s ...googleapi.Field) *ProjectsLocationsEndpointsOpenapiEmbeddingsCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsEndpointsOpenapiEmbeddingsCall) Context(ctx context.Context) *ProjectsLocationsEndpointsOpenapiEmbeddingsCall { + 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 *ProjectsLocationsEndpointsOpenapiEmbeddingsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsEndpointsOpenapiEmbeddingsCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleapihttpbody) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+endpoint}/embeddings") + 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{ + "endpoint": c.endpoint, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "aiplatform.projects.locations.endpoints.openapi.embeddings", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "aiplatform.projects.locations.endpoints.openapi.embeddings" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleApiHttpBody.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 *ProjectsLocationsEndpointsOpenapiEmbeddingsCall) Do(opts ...googleapi.CallOption) (*GoogleApiHttpBody, 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 := &GoogleApiHttpBody{ + 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.endpoints.openapi.embeddings", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsEndpointsOperationsCancelCall struct { s *Service name string diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index 03b9ce26af2..adcec9f4462 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -1260,7 +1260,7 @@ } } }, - "revision": "20250909", + "revision": "20250916", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdbShellCommandEvent": { @@ -2147,7 +2147,8 @@ }, "extensionConfig": { "$ref": "ExtensionConfig", - "description": "Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.The signing key certificate fingerprint of the app on the device must match one of the entries in ApplicationPolicy.signingKeyCerts or ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) or the signing key certificate fingerprints obtained from Play Store for the app to be able to communicate with Android Device Policy. If the app is not on Play Store and if ApplicationPolicy.signingKeyCerts and ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) are not set, a NonComplianceDetail with INVALID_VALUE is reported." + "deprecated": true, + "description": "Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app. If there is any app with COMPANION_APP role, this field cannot be set.The signing key certificate fingerprint of the app on the device must match one of the entries in ApplicationPolicy.signingKeyCerts or ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) or the signing key certificate fingerprints obtained from Play Store for the app to be able to communicate with Android Device Policy. If the app is not on Play Store and if ApplicationPolicy.signingKeyCerts and ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) are not set, a NonComplianceDetail with INVALID_VALUE is reported." }, "installConstraint": { "description": "Optional. The constraints for installing the app. You can specify a maximum of one InstallConstraint. Multiple constraints are rejected.", @@ -2173,6 +2174,16 @@ "KIOSK", "CUSTOM" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false + ], "enumDescriptions": [ "Unspecified. Defaults to AVAILABLE.", "The app is automatically installed and can be removed by the user.", @@ -2180,7 +2191,7 @@ "The app is blocked and can't be installed. If the app was installed under a previous policy, it will be uninstalled. This also blocks its instant app functionality.", "The app is available to install.", "The app is automatically installed and can't be removed by the user and will prevent setup from completion until installation is complete.", - "The app is automatically installed in kiosk mode: it's set as the preferred home intent and whitelisted for lock task mode. Device setup won't complete until the app is installed. After installation, users won't be able to remove the app. You can only set this installType for one app per policy. When this is present in the policy, status bar will be automatically disabled.", + "The app is automatically installed in kiosk mode: it's set as the preferred home intent and whitelisted for lock task mode. Device setup won't complete until the app is installed. After installation, users won't be able to remove the app. You can only set this installType for one app per policy. When this is present in the policy, status bar will be automatically disabled.If there is any app with KIOSK role, then this install type cannot be set for any app.", "The app can only be installed and updated via AMAPI SDK command (https://developers.google.com/android/management/extensibility-sdk-integration).Note: This only affects fully managed devices. Play related fields minimumVersionCode, accessibleTrackIds, autoUpdateMode, installConstraint and installPriority cannot be set for the app. The app isn't available in the Play Store. The app installed on the device has applicationSource set to CUSTOM. The signing key certificate fingerprint of the app on the device must match one of the entries in ApplicationPolicy.signingKeyCerts . Otherwise, a NonComplianceDetail with APP_SIGNING_CERT_MISMATCH is reported. Changing the installType to and from CUSTOM uninstalls the existing app if its signing key certificate fingerprint doesn't match the one from the new app source. Removing the app from applications doesn't uninstall the existing app if it conforms to playStoreMode. See also customAppConfig. This is different from the Google Play Custom App Publishing (https://developers.google.com/android/work/play/custom-app-api/get-started) feature." ], "type": "string" @@ -2240,8 +2251,15 @@ ], "type": "string" }, + "roles": { + "description": "Optional. Roles the app has.Apps having certain roles can be exempted from power and background execution restrictions, suspension and hibernation on Android 14 and above. The user control can also be disallowed for apps with certain roles on Android 11 and above. Refer to the documentation of each RoleType for more details.The app is notified about the roles that are set for it if the app has a notification receiver service with . The app is notified whenever its roles are updated or after the app is installed when it has nonempty list of roles. The app can use this notification to bootstrap itself after the installation. See Integrate with the AMAPI SDK (https://developers.google.com/android/management/sdk-integration) and Manage app roles (https://developers.google.com/android/management/app-roles) guides for more details on the requirements for the service.For the exemptions to be applied and the app to be notified about the roles, the signing key certificate fingerprint of the app on the device must match one of the signing key certificate fingerprints obtained from Play Store or one of the entries in ApplicationPolicy.signingKeyCerts. Otherwise, a NonComplianceDetail with APP_SIGNING_CERT_MISMATCH is reported.There must not be duplicate roles with the same roleType. Multiple apps cannot hold a role with the same roleType. A role with type ROLE_TYPE_UNSPECIFIED is not allowed.", + "items": { + "$ref": "Role" + }, + "type": "array" + }, "signingKeyCerts": { - "description": "Optional. Signing key certificates of the app.This field is required in the following cases: The app has installType set to CUSTOM (i.e. a custom app). The app has extensionConfig set (i.e. an extension app) but ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) is not set and the app does not exist on the Play Store.If this field is not set for a custom app, the policy is rejected. If it is not set when required for a non-custom app, a NonComplianceDetail with INVALID_VALUE is reported.For other cases, this field is optional and the signing key certificates obtained from Play Store are used.See following policy settings to see how this field is used: choosePrivateKeyRules ApplicationPolicy.InstallType.CUSTOM ApplicationPolicy.extensionConfig", + "description": "Optional. Signing key certificates of the app.This field is required in the following cases: The app has installType set to CUSTOM (i.e. a custom app). The app has roles set to a nonempty list and the app does not exist on the Play Store. The app has extensionConfig set (i.e. an extension app) but ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) is not set and the app does not exist on the Play Store.If this field is not set for a custom app, the policy is rejected. If it is not set when required for a non-custom app, a NonComplianceDetail with INVALID_VALUE is reported.For other cases, this field is optional and the signing key certificates obtained from Play Store are used.See following policy settings to see how this field is used: choosePrivateKeyRules ApplicationPolicy.InstallType.CUSTOM ApplicationPolicy.extensionConfig ApplicationPolicy.roles", "items": { "$ref": "ApplicationSigningKeyCert" }, @@ -2255,8 +2273,8 @@ "USER_CONTROL_DISALLOWED" ], "enumDescriptions": [ - "Uses the default behaviour of the app to determine if user control is allowed or disallowed. User control is allowed by default for most apps but disallowed for following types of apps: extension apps (see extensionConfig for more details) kiosk apps (see KIOSK install type for more details) other critical system apps", - "User control is allowed for the app. Kiosk apps can use this to allow user control. For extension apps (see extensionConfig for more details), user control is disallowed even if this value is set. For kiosk apps (see KIOSK install type for more details), this value can be used to allow user control.", + "Uses the default behaviour of the app to determine if user control is allowed or disallowed. User control is allowed by default for most apps but disallowed for following types of apps: extension apps (see extensionConfig for more details) kiosk apps (see KIOSK install type for more details) apps with roles set to a nonempty list other critical system apps", + "User control is allowed for the app. Kiosk apps can use this to allow user control. For extension apps (see extensionConfig for more details), user control is disallowed even if this value is set.For apps with roles set to a nonempty list (except roles containing only KIOSK role), this value cannot be set.For kiosk apps (see KIOSK install type and KIOSK role type for more details), this value can be used to allow user control.", "User control is disallowed for the app. This is supported on Android 11 and above. A NonComplianceDetail with API_LEVEL is reported if the Android version is less than 11." ], "type": "string" @@ -3958,6 +3976,7 @@ "id": "ExtensionConfig", "properties": { "notificationReceiver": { + "deprecated": true, "description": "Fully qualified class name of the receiver service class for Android Device Policy to notify the extension app of any local command status updates. The service must be exported in the extension app's AndroidManifest.xml and extend NotificationReceiverService (https://developers.google.com/android/management/reference/amapi/com/google/android/managementapi/notification/NotificationReceiverService) (see Integrate with the AMAPI SDK (https://developers.google.com/android/management/sdk-integration) guide for more details).", "type": "string" }, @@ -6848,6 +6867,31 @@ }, "type": "object" }, + "Role": { + "description": "Role an app can have.", + "id": "Role", + "properties": { + "roleType": { + "description": "Required. The type of the role an app can have.", + "enum": [ + "ROLE_TYPE_UNSPECIFIED", + "COMPANION_APP", + "KIOSK", + "MOBILE_THREAT_DEFENSE_ENDPOINT_DETECTION_RESPONSE", + "SYSTEM_HEALTH_MONITORING" + ], + "enumDescriptions": [ + "The role type is unspecified. This value must not be used.", + "The role type for companion apps. This role enables the app as a companion app with the capability of interacting with Android Device Policy offline. This is the recommended way to configure an app as a companion app. For legacy way, see extensionConfig.On Android 14 and above, the app with this role is exempted from power and background execution restrictions, suspension and hibernation. On Android 11 and above, the user control is disallowed for the app with this role. userControlSettings cannot be set to USER_CONTROL_ALLOWED for the app with this role.Android Device Policy notifies the companion app of any local command status updates if the app has a service with . See Integrate with the AMAPI SDK (https://developers.google.com/android/management/sdk-integration) guide for more details on the requirements for the service.", + "The role type for kiosk apps. An app can have this role only if it has installType set to REQUIRED_FOR_SETUP or CUSTOM. Before adding this role to an app with CUSTOM install type, the app must already be installed on the device.The app having this role type is set as the preferred home intent and allowlisted for lock task mode. When there is an app with this role type, status bar will be automatically disabled.This is preferable to setting installType to KIOSK.On Android 11 and above, the user control is disallowed but userControlSettings can be set to USER_CONTROL_ALLOWED to allow user control for the app with this role.", + "The role type for Mobile Threat Defense (MTD) / Endpoint Detection \u0026 Response (EDR) apps.On Android 14 and above, the app with this role is exempted from power and background execution restrictions, suspension and hibernation. On Android 11 and above, the user control is disallowed and userControlSettings cannot be set to USER_CONTROL_ALLOWED for the app with this role.", + "The role type for system health monitoring apps.On Android 14 and above, the app with this role is exempted from power and background execution restrictions, suspension and hibernation. On Android 11 and above, the user control is disallowed and userControlSettings cannot be set to USER_CONTROL_ALLOWED for the app with this role." + ], + "type": "string" + } + }, + "type": "object" + }, "ScreenBrightnessSettings": { "description": "Controls for the screen brightness settings.", "id": "ScreenBrightnessSettings", diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index 76be7a552fe..e7569934b2e 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -1246,8 +1246,9 @@ type ApplicationPolicy struct { Disabled bool `json:"disabled,omitempty"` // ExtensionConfig: Configuration to enable this app as an extension app, with // the capability of interacting with Android Device Policy offline.This field - // can be set for at most one app.The signing key certificate fingerprint of - // the app on the device must match one of the entries in + // can be set for at most one app. If there is any app with COMPANION_APP role, + // this field cannot be set.The signing key certificate fingerprint of the app + // on the device must match one of the entries in // ApplicationPolicy.signingKeyCerts or // ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) or the signing key // certificate fingerprints obtained from Play Store for the app to be able to @@ -1286,7 +1287,8 @@ type ApplicationPolicy struct { // won't complete until the app is installed. After installation, users won't // be able to remove the app. You can only set this installType for one app per // policy. When this is present in the policy, status bar will be automatically - // disabled. + // disabled.If there is any app with KIOSK role, then this install type cannot + // be set for any app. // "CUSTOM" - The app can only be installed and updated via AMAPI SDK command // (https://developers.google.com/android/management/extensibility-sdk-integration).Note: // This only affects fully managed devices. Play related fields @@ -1355,17 +1357,40 @@ type ApplicationPolicy struct { // "PREFERENTIAL_NETWORK_ID_FOUR" - Preferential network identifier 4. // "PREFERENTIAL_NETWORK_ID_FIVE" - Preferential network identifier 5. PreferentialNetworkId string `json:"preferentialNetworkId,omitempty"` + // Roles: Optional. Roles the app has.Apps having certain roles can be exempted + // from power and background execution restrictions, suspension and hibernation + // on Android 14 and above. The user control can also be disallowed for apps + // with certain roles on Android 11 and above. Refer to the documentation of + // each RoleType for more details.The app is notified about the roles that are + // set for it if the app has a notification receiver service with . The app is + // notified whenever its roles are updated or after the app is installed when + // it has nonempty list of roles. The app can use this notification to + // bootstrap itself after the installation. See Integrate with the AMAPI SDK + // (https://developers.google.com/android/management/sdk-integration) and + // Manage app roles + // (https://developers.google.com/android/management/app-roles) guides for more + // details on the requirements for the service.For the exemptions to be applied + // and the app to be notified about the roles, the signing key certificate + // fingerprint of the app on the device must match one of the signing key + // certificate fingerprints obtained from Play Store or one of the entries in + // ApplicationPolicy.signingKeyCerts. Otherwise, a NonComplianceDetail with + // APP_SIGNING_CERT_MISMATCH is reported.There must not be duplicate roles with + // the same roleType. Multiple apps cannot hold a role with the same roleType. + // A role with type ROLE_TYPE_UNSPECIFIED is not allowed. + Roles []*Role `json:"roles,omitempty"` // SigningKeyCerts: Optional. Signing key certificates of the app.This field is // required in the following cases: The app has installType set to CUSTOM (i.e. - // a custom app). The app has extensionConfig set (i.e. an extension app) but - // ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) is not set and the - // app does not exist on the Play Store.If this field is not set for a custom - // app, the policy is rejected. If it is not set when required for a non-custom - // app, a NonComplianceDetail with INVALID_VALUE is reported.For other cases, - // this field is optional and the signing key certificates obtained from Play - // Store are used.See following policy settings to see how this field is used: - // choosePrivateKeyRules ApplicationPolicy.InstallType.CUSTOM - // ApplicationPolicy.extensionConfig + // a custom app). The app has roles set to a nonempty list and the app does not + // exist on the Play Store. The app has extensionConfig set (i.e. an extension + // app) but ExtensionConfig.signingKeyFingerprintsSha256 (deprecated) is not + // set and the app does not exist on the Play Store.If this field is not set + // for a custom app, the policy is rejected. If it is not set when required for + // a non-custom app, a NonComplianceDetail with INVALID_VALUE is reported.For + // other cases, this field is optional and the signing key certificates + // obtained from Play Store are used.See following policy settings to see how + // this field is used: choosePrivateKeyRules + // ApplicationPolicy.InstallType.CUSTOM ApplicationPolicy.extensionConfig + // ApplicationPolicy.roles SigningKeyCerts []*ApplicationSigningKeyCert `json:"signingKeyCerts,omitempty"` // UserControlSettings: Optional. Specifies whether user control is permitted // for the app. User control includes user actions like force-stopping and @@ -1377,12 +1402,15 @@ type ApplicationPolicy struct { // app to determine if user control is allowed or disallowed. User control is // allowed by default for most apps but disallowed for following types of apps: // extension apps (see extensionConfig for more details) kiosk apps (see KIOSK - // install type for more details) other critical system apps + // install type for more details) apps with roles set to a nonempty list other + // critical system apps // "USER_CONTROL_ALLOWED" - User control is allowed for the app. Kiosk apps // can use this to allow user control. For extension apps (see extensionConfig - // for more details), user control is disallowed even if this value is set. For - // kiosk apps (see KIOSK install type for more details), this value can be used - // to allow user control. + // for more details), user control is disallowed even if this value is set.For + // apps with roles set to a nonempty list (except roles containing only KIOSK + // role), this value cannot be set.For kiosk apps (see KIOSK install type and + // KIOSK role type for more details), this value can be used to allow user + // control. // "USER_CONTROL_DISALLOWED" - User control is disallowed for the app. This // is supported on Android 11 and above. A NonComplianceDetail with API_LEVEL // is reported if the Android version is less than 11. @@ -6953,6 +6981,64 @@ func (s RequestDeviceInfoStatus) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Role: Role an app can have. +type Role struct { + // RoleType: Required. The type of the role an app can have. + // + // Possible values: + // "ROLE_TYPE_UNSPECIFIED" - The role type is unspecified. This value must + // not be used. + // "COMPANION_APP" - The role type for companion apps. This role enables the + // app as a companion app with the capability of interacting with Android + // Device Policy offline. This is the recommended way to configure an app as a + // companion app. For legacy way, see extensionConfig.On Android 14 and above, + // the app with this role is exempted from power and background execution + // restrictions, suspension and hibernation. On Android 11 and above, the user + // control is disallowed for the app with this role. userControlSettings cannot + // be set to USER_CONTROL_ALLOWED for the app with this role.Android Device + // Policy notifies the companion app of any local command status updates if the + // app has a service with . See Integrate with the AMAPI SDK + // (https://developers.google.com/android/management/sdk-integration) guide for + // more details on the requirements for the service. + // "KIOSK" - The role type for kiosk apps. An app can have this role only if + // it has installType set to REQUIRED_FOR_SETUP or CUSTOM. Before adding this + // role to an app with CUSTOM install type, the app must already be installed + // on the device.The app having this role type is set as the preferred home + // intent and allowlisted for lock task mode. When there is an app with this + // role type, status bar will be automatically disabled.This is preferable to + // setting installType to KIOSK.On Android 11 and above, the user control is + // disallowed but userControlSettings can be set to USER_CONTROL_ALLOWED to + // allow user control for the app with this role. + // "MOBILE_THREAT_DEFENSE_ENDPOINT_DETECTION_RESPONSE" - The role type for + // Mobile Threat Defense (MTD) / Endpoint Detection & Response (EDR) apps.On + // Android 14 and above, the app with this role is exempted from power and + // background execution restrictions, suspension and hibernation. On Android 11 + // and above, the user control is disallowed and userControlSettings cannot be + // set to USER_CONTROL_ALLOWED for the app with this role. + // "SYSTEM_HEALTH_MONITORING" - The role type for system health monitoring + // apps.On Android 14 and above, the app with this role is exempted from power + // and background execution restrictions, suspension and hibernation. On + // Android 11 and above, the user control is disallowed and userControlSettings + // cannot be set to USER_CONTROL_ALLOWED for the app with this role. + RoleType string `json:"roleType,omitempty"` + // ForceSendFields is a list of field names (e.g. "RoleType") 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. "RoleType") 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 Role) MarshalJSON() ([]byte, error) { + type NoMethod Role + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ScreenBrightnessSettings: Controls for the screen brightness settings. type ScreenBrightnessSettings struct { // ScreenBrightness: Optional. The screen brightness between 1 and 255 where 1 diff --git a/apigateway/v1/apigateway-api.json b/apigateway/v1/apigateway-api.json index 81e4f478ed3..618434b4874 100644 --- a/apigateway/v1/apigateway-api.json +++ b/apigateway/v1/apigateway-api.json @@ -143,7 +143,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1089,7 +1089,7 @@ } } }, - "revision": "20250813", + "revision": "20250910", "rootUrl": "https://apigateway.googleapis.com/", "schemas": { "ApigatewayApi": { diff --git a/apigateway/v1/apigateway-gen.go b/apigateway/v1/apigateway-gen.go index b8ebdde1d6f..09eae5db77a 100644 --- a/apigateway/v1/apigateway-gen.go +++ b/apigateway/v1/apigateway-gen.go @@ -1355,9 +1355,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/apigateway/v1beta/apigateway-api.json b/apigateway/v1beta/apigateway-api.json index 11fa6021c6f..0eae153f985 100644 --- a/apigateway/v1beta/apigateway-api.json +++ b/apigateway/v1beta/apigateway-api.json @@ -143,7 +143,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1089,7 +1089,7 @@ } } }, - "revision": "20250813", + "revision": "20250910", "rootUrl": "https://apigateway.googleapis.com/", "schemas": { "ApigatewayApi": { diff --git a/apigateway/v1beta/apigateway-gen.go b/apigateway/v1beta/apigateway-gen.go index 1e7bec436b7..d7d7283b491 100644 --- a/apigateway/v1beta/apigateway-gen.go +++ b/apigateway/v1beta/apigateway-gen.go @@ -1412,9 +1412,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/apim/v1alpha/apim-api.json b/apim/v1alpha/apim-api.json index 985cc4b0205..8fd2283266f 100644 --- a/apim/v1alpha/apim-api.json +++ b/apim/v1alpha/apim-api.json @@ -169,7 +169,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -846,7 +846,7 @@ } } }, - "revision": "20250813", + "revision": "20250910", "rootUrl": "https://apim.googleapis.com/", "schemas": { "ApiObservation": { diff --git a/apim/v1alpha/apim-gen.go b/apim/v1alpha/apim-gen.go index 5d8d174795d..3daa44283c3 100644 --- a/apim/v1alpha/apim-gen.go +++ b/apim/v1alpha/apim-gen.go @@ -1411,9 +1411,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/backupdr/v1/backupdr-api.json b/backupdr/v1/backupdr-api.json index 2ffa6e5efa7..673b2e7212b 100644 --- a/backupdr/v1/backupdr-api.json +++ b/backupdr/v1/backupdr-api.json @@ -169,7 +169,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -2117,7 +2117,7 @@ } } }, - "revision": "20250902", + "revision": "20250910", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { diff --git a/backupdr/v1/backupdr-gen.go b/backupdr/v1/backupdr-gen.go index 0b5ebdd4c4e..3b086b394e9 100644 --- a/backupdr/v1/backupdr-gen.go +++ b/backupdr/v1/backupdr-gen.go @@ -5271,9 +5271,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/beyondcorp/v1/beyondcorp-api.json b/beyondcorp/v1/beyondcorp-api.json index 9f6587d1d60..3dcc81549ea 100644 --- a/beyondcorp/v1/beyondcorp-api.json +++ b/beyondcorp/v1/beyondcorp-api.json @@ -275,7 +275,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1899,7 +1899,7 @@ } } }, - "revision": "20250818", + "revision": "20250910", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { diff --git a/beyondcorp/v1/beyondcorp-gen.go b/beyondcorp/v1/beyondcorp-gen.go index 3604683f51c..266d26b1089 100644 --- a/beyondcorp/v1/beyondcorp-gen.go +++ b/beyondcorp/v1/beyondcorp-gen.go @@ -3224,9 +3224,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/beyondcorp/v1alpha/beyondcorp-api.json b/beyondcorp/v1alpha/beyondcorp-api.json index cd428930e8e..82ef5b9b147 100644 --- a/beyondcorp/v1alpha/beyondcorp-api.json +++ b/beyondcorp/v1alpha/beyondcorp-api.json @@ -787,7 +787,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -3432,7 +3432,7 @@ } } }, - "revision": "20250818", + "revision": "20250910", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { diff --git a/beyondcorp/v1alpha/beyondcorp-gen.go b/beyondcorp/v1alpha/beyondcorp-gen.go index 171ebd26cf6..a98a5b6eeb2 100644 --- a/beyondcorp/v1alpha/beyondcorp-gen.go +++ b/beyondcorp/v1alpha/beyondcorp-gen.go @@ -6221,9 +6221,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index cd7a0ab60e6..ec0db594e09 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -2375,7 +2375,7 @@ } } }, - "revision": "20250816", + "revision": "20250912", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -4692,7 +4692,7 @@ "id": "ExternalServiceCost", "properties": { "billingMethod": { - "description": "The billing method used for the external job. This field is only used when billed on the services sku, set to \"SERVICES_SKU\". Otherwise, it is unspecified for backward compatibility.", + "description": "The billing method used for the external job. This field, set to `SERVICES_SKU`, is only used when billing under the services SKU. Otherwise, it is unspecified for backward compatibility.", "type": "string" }, "bytesBilled": { @@ -5140,6 +5140,56 @@ }, "type": "object" }, + "IncrementalResultStats": { + "description": "Statistics related to Incremental Query Results. Populated as part of JobStatistics2. This feature is not yet available.", + "id": "IncrementalResultStats", + "properties": { + "disabledReason": { + "description": "Reason why incremental query results are/were not written by the query.", + "enum": [ + "DISABLED_REASON_UNSPECIFIED", + "OTHER" + ], + "enumDescriptions": [ + "Disabled reason not specified.", + "Some other reason." + ], + "type": "string" + }, + "resultSetLastModifyTime": { + "description": "The time at which the result table's contents were modified. May be absent if no results have been written or the query has completed.", + "format": "google-datetime", + "type": "string" + }, + "resultSetLastReplaceTime": { + "description": "The time at which the result table's contents were completely replaced. May be absent if no results have been written or the query has completed.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "IndexPruningStats": { + "description": "Statistics for index pruning.", + "id": "IndexPruningStats", + "properties": { + "baseTable": { + "$ref": "TableReference", + "description": "The base table reference." + }, + "postIndexPruningParallelInputCount": { + "description": "The number of parallel inputs after index pruning.", + "format": "int64", + "type": "string" + }, + "preIndexPruningParallelInputCount": { + "description": "The number of parallel inputs before index pruning.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "IndexUnusedReason": { "description": "Reason about why no search index was used in the search query (or sub-query).", "id": "IndexUnusedReason", @@ -5442,7 +5492,7 @@ "description": "[Pick one] Configures an extract job." }, "jobTimeoutMs": { - "description": "Optional. Job timeout in milliseconds. If this time limit is exceeded, BigQuery will attempt to stop a longer job, but may not always succeed in canceling it before the job completes. For example, a job that takes more than 60 seconds to complete has a better chance of being stopped than a job that takes 10 seconds to complete.", + "description": "Optional. Job timeout in milliseconds relative to the job creation time. If this time limit is exceeded, BigQuery attempts to stop the job, but might not always succeed in canceling it before the job completes. For example, a job that takes more than 60 seconds to complete has a better chance of being stopped than a job that takes 10 seconds to complete.", "format": "int64", "type": "string" }, @@ -5720,7 +5770,7 @@ "type": "string" }, "schemaUpdateOptions": { - "description": "Allows the schema of the destination table to be updated as a side effect of the load job if a schema is autodetected or supplied in the job configuration. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: * ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. * ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.", + "description": "Allows the schema of the destination table to be updated as a side effect of the load job if a schema is autodetected or supplied in the job configuration. Schema update options are supported in three cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE_DATA; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: * ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. * ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.", "items": { "type": "string" }, @@ -5871,7 +5921,7 @@ "description": "Range partitioning specification for the destination table. Only one of timePartitioning and rangePartitioning should be specified." }, "schemaUpdateOptions": { - "description": "Allows the schema of the destination table to be updated as a side effect of the query job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: * ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. * ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.", + "description": "Allows the schema of the destination table to be updated as a side effect of the query job. Schema update options are supported in three cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE_DATA; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: * ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. * ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.", "items": { "type": "string" }, @@ -6356,6 +6406,11 @@ "readOnly": true, "type": "array" }, + "incrementalResultStats": { + "$ref": "IncrementalResultStats", + "description": "Output only. Statistics related to incremental query results, if enabled for the query. This feature is not yet available.", + "readOnly": true + }, "loadQueryStatistics": { "$ref": "LoadQueryStatistics", "description": "Output only. Statistics for a LOAD query.", @@ -6503,7 +6558,7 @@ "type": "string" }, "totalServicesSkuSlotMs": { - "description": "Output only. Total slot-milliseconds for the job that run on external services and billed on the service SKU. This field is only populated for jobs that have external service costs, and is the total of the usage for costs whose billing method is \"SERVICES_SKU\".", + "description": "Output only. Total slot milliseconds for the job that ran on external services and billed on the services SKU. This field is only populated for jobs that have external service costs, and is the total of the usage for costs whose billing method is `\"SERVICES_SKU\"`.", "format": "int64", "readOnly": true, "type": "string" @@ -7595,6 +7650,28 @@ }, "type": "object" }, + "PruningStats": { + "description": "The column metadata index pruning statistics.", + "id": "PruningStats", + "properties": { + "postCmetaPruningParallelInputCount": { + "description": "The number of parallel inputs matched.", + "format": "int64", + "type": "string" + }, + "postCmetaPruningPartitionCount": { + "description": "The number of partitions matched.", + "format": "int64", + "type": "string" + }, + "preCmetaPruningParallelInputCount": { + "description": "The number of parallel inputs scanned.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "PythonOptions": { "description": "Options for a user-defined Python function.", "id": "PythonOptions", @@ -8589,6 +8666,13 @@ "description": "Statistics for a search query. Populated as part of JobStatistics2.", "id": "SearchStatistics", "properties": { + "indexPruningStats": { + "description": "Search index pruning statistics, one for each base table that has a search index. If a base table does not have a search index or the index does not help with pruning on the base table, then there is no pruning statistics for that table.", + "items": { + "$ref": "IndexPruningStats" + }, + "type": "array" + }, "indexUnusedReasons": { "description": "When `indexUsageMode` is `UNUSED` or `PARTIALLY_USED`, this field explains why indexes were not used in all or part of the search query. If `indexUsageMode` is `FULLY_USED`, this field is not populated.", "items": { @@ -9825,6 +9909,10 @@ "description": "Free form human-readable reason metadata caching was unused for the job.", "type": "string" }, + "pruningStats": { + "$ref": "PruningStats", + "description": "The column metadata index pruning statistics." + }, "staleness": { "description": "Duration since last refresh as of this job for managed tables (indicates metadata cache staleness as seen by this job).", "format": "google-duration", @@ -10233,6 +10321,11 @@ "description": "If true, enable global explanation during training.", "type": "boolean" }, + "endpointIdleTtl": { + "description": "The idle TTL of the endpoint before the resources get destroyed. The default value is 6.5 hours.", + "format": "google-duration", + "type": "string" + }, "feedbackType": { "description": "Feedback type that specifies which algorithm to run for matrix factorization.", "enum": [ @@ -10614,6 +10707,10 @@ }, "type": "array" }, + "huggingFaceModelId": { + "description": "The id of a Hugging Face model. For example, `google/gemma-2-2b-it`.", + "type": "string" + }, "includeDrift": { "description": "Include drift when fitting an ARIMA model.", "type": "boolean" @@ -10723,6 +10820,10 @@ ], "type": "string" }, + "machineType": { + "description": "The type of the machine used to deploy and serve the model.", + "type": "string" + }, "maxIterations": { "description": "The maximum number of iterations in training. Used only for iterative training algorithms.", "format": "int64", @@ -10733,6 +10834,11 @@ "format": "int64", "type": "string" }, + "maxReplicaCount": { + "description": "The maximum number of machine replicas that will be deployed on an endpoint. The default value is equal to min_replica_count.", + "format": "int64", + "type": "string" + }, "maxTimeSeriesLength": { "description": "The maximum number of time points in a time series that can be used in modeling the trend component of the time series. Don't use this option with the `timeSeriesLengthFraction` or `minTimeSeriesLength` options.", "format": "int64", @@ -10753,6 +10859,11 @@ "format": "double", "type": "number" }, + "minReplicaCount": { + "description": "The minimum number of machine replicas that will be always deployed on an endpoint. This value must be greater than or equal to 1. The default value is 1.", + "format": "int64", + "type": "string" + }, "minSplitLoss": { "description": "Minimum split loss for boosted tree models.", "format": "double", @@ -10768,6 +10879,10 @@ "format": "int64", "type": "string" }, + "modelGardenModelName": { + "description": "The name of a Vertex model garden publisher model. Format is `publishers/{publisher}/models/{model}@{optional_version_id}`.", + "type": "string" + }, "modelRegistry": { "description": "The model registry.", "enum": [ @@ -10852,6 +10967,33 @@ ], "type": "string" }, + "reservationAffinityKey": { + "description": "Corresponds to the label key of a reservation resource used by Vertex AI. To target a SPECIFIC_RESERVATION by name, use `compute.googleapis.com/reservation-name` as the key and specify the name of your reservation as its value.", + "type": "string" + }, + "reservationAffinityType": { + "description": "Specifies the reservation affinity type used to configure a Vertex AI resource. The default value is `NO_RESERVATION`.", + "enum": [ + "RESERVATION_AFFINITY_TYPE_UNSPECIFIED", + "NO_RESERVATION", + "ANY_RESERVATION", + "SPECIFIC_RESERVATION" + ], + "enumDescriptions": [ + "Default value.", + "No reservation.", + "Any reservation.", + "Specific reservation." + ], + "type": "string" + }, + "reservationAffinityValues": { + "description": "Corresponds to the label values of a reservation resource used by Vertex AI. This must be the full resource name of the reservation or reservation block.", + "items": { + "type": "string" + }, + "type": "array" + }, "sampledShapleyNumPaths": { "description": "Number of paths for the sampled Shapley explain method.", "format": "int64", diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 73e4f8840fb..97be7104e08 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -3476,9 +3476,9 @@ func (s *ExternalRuntimeOptions) UnmarshalJSON(data []byte) error { // dollars. Services may not directly correlate to these metrics, but these are // the equivalents for billing purposes. Output only. type ExternalServiceCost struct { - // BillingMethod: The billing method used for the external job. This field is - // only used when billed on the services sku, set to "SERVICES_SKU". Otherwise, - // it is unspecified for backward compatibility. + // BillingMethod: The billing method used for the external job. This field, set + // to `SERVICES_SKU`, is only used when billing under the services SKU. + // Otherwise, it is unspecified for backward compatibility. BillingMethod string `json:"billingMethod,omitempty"` // BytesBilled: External service cost in terms of bigquery bytes billed. BytesBilled int64 `json:"bytesBilled,omitempty,string"` @@ -4048,6 +4048,70 @@ func (s *HparamTuningTrial) UnmarshalJSON(data []byte) error { return nil } +// IncrementalResultStats: Statistics related to Incremental Query Results. +// Populated as part of JobStatistics2. This feature is not yet available. +type IncrementalResultStats struct { + // DisabledReason: Reason why incremental query results are/were not written by + // the query. + // + // Possible values: + // "DISABLED_REASON_UNSPECIFIED" - Disabled reason not specified. + // "OTHER" - Some other reason. + DisabledReason string `json:"disabledReason,omitempty"` + // ResultSetLastModifyTime: The time at which the result table's contents were + // modified. May be absent if no results have been written or the query has + // completed. + ResultSetLastModifyTime string `json:"resultSetLastModifyTime,omitempty"` + // ResultSetLastReplaceTime: The time at which the result table's contents were + // completely replaced. May be absent if no results have been written or the + // query has completed. + ResultSetLastReplaceTime string `json:"resultSetLastReplaceTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisabledReason") 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. "DisabledReason") 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 IncrementalResultStats) MarshalJSON() ([]byte, error) { + type NoMethod IncrementalResultStats + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// IndexPruningStats: Statistics for index pruning. +type IndexPruningStats struct { + // BaseTable: The base table reference. + BaseTable *TableReference `json:"baseTable,omitempty"` + // PostIndexPruningParallelInputCount: The number of parallel inputs after + // index pruning. + PostIndexPruningParallelInputCount int64 `json:"postIndexPruningParallelInputCount,omitempty,string"` + // PreIndexPruningParallelInputCount: The number of parallel inputs before + // index pruning. + PreIndexPruningParallelInputCount int64 `json:"preIndexPruningParallelInputCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "BaseTable") 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. "BaseTable") 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 IndexPruningStats) MarshalJSON() ([]byte, error) { + type NoMethod IndexPruningStats + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // IndexUnusedReason: Reason about why no search index was used in the search // query (or sub-query). type IndexUnusedReason struct { @@ -4425,11 +4489,11 @@ type JobConfiguration struct { DryRun bool `json:"dryRun,omitempty"` // Extract: [Pick one] Configures an extract job. Extract *JobConfigurationExtract `json:"extract,omitempty"` - // JobTimeoutMs: Optional. Job timeout in milliseconds. If this time limit is - // exceeded, BigQuery will attempt to stop a longer job, but may not always - // succeed in canceling it before the job completes. For example, a job that - // takes more than 60 seconds to complete has a better chance of being stopped - // than a job that takes 10 seconds to complete. + // JobTimeoutMs: Optional. Job timeout in milliseconds relative to the job + // creation time. If this time limit is exceeded, BigQuery attempts to stop the + // job, but might not always succeed in canceling it before the job completes. + // For example, a job that takes more than 60 seconds to complete has a better + // chance of being stopped than a job that takes 10 seconds to complete. JobTimeoutMs int64 `json:"jobTimeoutMs,omitempty,string"` // JobType: Output only. The type of the job. Can be QUERY, LOAD, EXTRACT, COPY // or UNKNOWN. @@ -4764,13 +4828,14 @@ type JobConfigurationLoad struct { // SchemaUpdateOptions: Allows the schema of the destination table to be // updated as a side effect of the load job if a schema is autodetected or // supplied in the job configuration. Schema update options are supported in - // two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is - // WRITE_TRUNCATE and the destination table is a partition of a table, - // specified by partition decorators. For normal tables, WRITE_TRUNCATE will - // always overwrite the schema. One or more of the following values are - // specified: * ALLOW_FIELD_ADDITION: allow adding a nullable field to the - // schema. * ALLOW_FIELD_RELAXATION: allow relaxing a required field in the - // original schema to nullable. + // three cases: when writeDisposition is WRITE_APPEND; when writeDisposition is + // WRITE_TRUNCATE_DATA; when writeDisposition is WRITE_TRUNCATE and the + // destination table is a partition of a table, specified by partition + // decorators. For normal tables, WRITE_TRUNCATE will always overwrite the + // schema. One or more of the following values are specified: * + // ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. * + // ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original + // schema to nullable. SchemaUpdateOptions []string `json:"schemaUpdateOptions,omitempty"` // SkipLeadingRows: Optional. The number of rows at the top of a CSV file that // BigQuery will skip when loading the data. The default value is 0. This @@ -4954,13 +5019,14 @@ type JobConfigurationQuery struct { RangePartitioning *RangePartitioning `json:"rangePartitioning,omitempty"` // SchemaUpdateOptions: Allows the schema of the destination table to be // updated as a side effect of the query job. Schema update options are - // supported in two cases: when writeDisposition is WRITE_APPEND; when - // writeDisposition is WRITE_TRUNCATE and the destination table is a partition - // of a table, specified by partition decorators. For normal tables, - // WRITE_TRUNCATE will always overwrite the schema. One or more of the - // following values are specified: * ALLOW_FIELD_ADDITION: allow adding a - // nullable field to the schema. * ALLOW_FIELD_RELAXATION: allow relaxing a - // required field in the original schema to nullable. + // supported in three cases: when writeDisposition is WRITE_APPEND; when + // writeDisposition is WRITE_TRUNCATE_DATA; when writeDisposition is + // WRITE_TRUNCATE and the destination table is a partition of a table, + // specified by partition decorators. For normal tables, WRITE_TRUNCATE will + // always overwrite the schema. One or more of the following values are + // specified: * ALLOW_FIELD_ADDITION: allow adding a nullable field to the + // schema. * ALLOW_FIELD_RELAXATION: allow relaxing a required field in the + // original schema to nullable. SchemaUpdateOptions []string `json:"schemaUpdateOptions,omitempty"` // ScriptOptions: Options controlling the execution of scripts. ScriptOptions *ScriptOptions `json:"scriptOptions,omitempty"` @@ -5436,6 +5502,9 @@ type JobStatistics2 struct { // ExternalServiceCosts: Output only. Job cost breakdown as bigquery internal // cost and external service costs. ExternalServiceCosts []*ExternalServiceCost `json:"externalServiceCosts,omitempty"` + // IncrementalResultStats: Output only. Statistics related to incremental query + // results, if enabled for the query. This feature is not yet available. + IncrementalResultStats *IncrementalResultStats `json:"incrementalResultStats,omitempty"` // LoadQueryStatistics: Output only. Statistics for a LOAD query. LoadQueryStatistics *LoadQueryStatistics `json:"loadQueryStatistics,omitempty"` // MaterializedViewStatistics: Output only. Statistics of materialized views of @@ -5581,8 +5650,8 @@ type JobStatistics2 struct { // TotalPartitionsProcessed: Output only. Total number of partitions processed // from all partitioned tables referenced in the job. TotalPartitionsProcessed int64 `json:"totalPartitionsProcessed,omitempty,string"` - // TotalServicesSkuSlotMs: Output only. Total slot-milliseconds for the job - // that run on external services and billed on the service SKU. This field is + // TotalServicesSkuSlotMs: Output only. Total slot milliseconds for the job + // that ran on external services and billed on the services SKU. This field is // only populated for jobs that have external service costs, and is the total // of the usage for costs whose billing method is "SERVICES_SKU". TotalServicesSkuSlotMs int64 `json:"totalServicesSkuSlotMs,omitempty,string"` @@ -6954,6 +7023,34 @@ func (s ProjectReference) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PruningStats: The column metadata index pruning statistics. +type PruningStats struct { + // PostCmetaPruningParallelInputCount: The number of parallel inputs matched. + PostCmetaPruningParallelInputCount int64 `json:"postCmetaPruningParallelInputCount,omitempty,string"` + // PostCmetaPruningPartitionCount: The number of partitions matched. + PostCmetaPruningPartitionCount int64 `json:"postCmetaPruningPartitionCount,omitempty,string"` + // PreCmetaPruningParallelInputCount: The number of parallel inputs scanned. + PreCmetaPruningParallelInputCount int64 `json:"preCmetaPruningParallelInputCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. + // "PostCmetaPruningParallelInputCount") 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. + // "PostCmetaPruningParallelInputCount") 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 PruningStats) MarshalJSON() ([]byte, error) { + type NoMethod PruningStats + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // PythonOptions: Options for a user-defined Python function. type PythonOptions struct { // EntryPoint: Required. The name of the function defined in Python code as the @@ -8183,6 +8280,11 @@ func (s ScriptStatistics) MarshalJSON() ([]byte, error) { // SearchStatistics: Statistics for a search query. Populated as part of // JobStatistics2. type SearchStatistics struct { + // IndexPruningStats: Search index pruning statistics, one for each base table + // that has a search index. If a base table does not have a search index or the + // index does not help with pruning on the base table, then there is no pruning + // statistics for that table. + IndexPruningStats []*IndexPruningStats `json:"indexPruningStats,omitempty"` // IndexUnusedReasons: When `indexUsageMode` is `UNUSED` or `PARTIALLY_USED`, // this field explains why indexes were not used in all or part of the search // query. If `indexUsageMode` is `FULLY_USED`, this field is not populated. @@ -8201,15 +8303,15 @@ type SearchStatistics struct { // of the query did not use search indexes. // "FULLY_USED" - The entire search query used search indexes. IndexUsageMode string `json:"indexUsageMode,omitempty"` - // ForceSendFields is a list of field names (e.g. "IndexUnusedReasons") to + // ForceSendFields is a list of field names (e.g. "IndexPruningStats") 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. "IndexUnusedReasons") 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. "IndexPruningStats") 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:"-"` } @@ -9682,6 +9784,8 @@ type TableMetadataCacheUsage struct { // Explanation: Free form human-readable reason metadata caching was unused for // the job. Explanation string `json:"explanation,omitempty"` + // PruningStats: The column metadata index pruning statistics. + PruningStats *PruningStats `json:"pruningStats,omitempty"` // Staleness: Duration since last refresh as of this job for managed tables // (indicates metadata cache staleness as seen by this job). Staleness string `json:"staleness,omitempty"` @@ -10068,6 +10172,9 @@ type TrainingOptions struct { EarlyStop bool `json:"earlyStop,omitempty"` // EnableGlobalExplain: If true, enable global explanation during training. EnableGlobalExplain bool `json:"enableGlobalExplain,omitempty"` + // EndpointIdleTtl: The idle TTL of the endpoint before the resources get + // destroyed. The default value is 6.5 hours. + EndpointIdleTtl string `json:"endpointIdleTtl,omitempty"` // FeedbackType: Feedback type that specifies which algorithm to run for matrix // factorization. // @@ -10277,6 +10384,9 @@ type TrainingOptions struct { // Gain. // "AVERAGE_RANK" - Average Rank. HparamTuningObjectives []string `json:"hparamTuningObjectives,omitempty"` + // HuggingFaceModelId: The id of a Hugging Face model. For example, + // `google/gemma-2-2b-it`. + HuggingFaceModelId string `json:"huggingFaceModelId,omitempty"` // IncludeDrift: Include drift when fitting an ARIMA model. IncludeDrift bool `json:"includeDrift,omitempty"` // InitialLearnRate: Specifies the initial learning rate for the line search @@ -10336,11 +10446,16 @@ type TrainingOptions struct { // "MEAN_SQUARED_LOSS" - Mean squared loss, used for linear regression. // "MEAN_LOG_LOSS" - Mean log loss, used for logistic regression. LossType string `json:"lossType,omitempty"` + // MachineType: The type of the machine used to deploy and serve the model. + MachineType string `json:"machineType,omitempty"` // MaxIterations: The maximum number of iterations in training. Used only for // iterative training algorithms. MaxIterations int64 `json:"maxIterations,omitempty,string"` // MaxParallelTrials: Maximum number of trials to run in parallel. MaxParallelTrials int64 `json:"maxParallelTrials,omitempty,string"` + // MaxReplicaCount: The maximum number of machine replicas that will be + // deployed on an endpoint. The default value is equal to min_replica_count. + MaxReplicaCount int64 `json:"maxReplicaCount,omitempty,string"` // MaxTimeSeriesLength: The maximum number of time points in a time series that // can be used in modeling the trend component of the time series. Don't use // this option with the `timeSeriesLengthFraction` or `minTimeSeriesLength` @@ -10355,6 +10470,10 @@ type TrainingOptions struct { // improvement is less than 'min_relative_progress'. Used only for iterative // training algorithms. MinRelativeProgress float64 `json:"minRelativeProgress,omitempty"` + // MinReplicaCount: The minimum number of machine replicas that will be always + // deployed on an endpoint. This value must be greater than or equal to 1. The + // default value is 1. + MinReplicaCount int64 `json:"minReplicaCount,omitempty,string"` // MinSplitLoss: Minimum split loss for boosted tree models. MinSplitLoss float64 `json:"minSplitLoss,omitempty"` // MinTimeSeriesLength: The minimum number of time points in a time series that @@ -10369,6 +10488,9 @@ type TrainingOptions struct { // MinTreeChildWeight: Minimum sum of instance weight needed in a child for // boosted tree models. MinTreeChildWeight int64 `json:"minTreeChildWeight,omitempty,string"` + // ModelGardenModelName: The name of a Vertex model garden publisher model. + // Format is `publishers/{publisher}/models/{model}@{optional_version_id}`. + ModelGardenModelName string `json:"modelGardenModelName,omitempty"` // ModelRegistry: The model registry. // // Possible values: @@ -10417,6 +10539,24 @@ type TrainingOptions struct { // "RANDOMIZED" - Randomized SVD. // "AUTO" - Auto. PcaSolver string `json:"pcaSolver,omitempty"` + // ReservationAffinityKey: Corresponds to the label key of a reservation + // resource used by Vertex AI. To target a SPECIFIC_RESERVATION by name, use + // `compute.googleapis.com/reservation-name` as the key and specify the name of + // your reservation as its value. + ReservationAffinityKey string `json:"reservationAffinityKey,omitempty"` + // ReservationAffinityType: Specifies the reservation affinity type used to + // configure a Vertex AI resource. The default value is `NO_RESERVATION`. + // + // Possible values: + // "RESERVATION_AFFINITY_TYPE_UNSPECIFIED" - Default value. + // "NO_RESERVATION" - No reservation. + // "ANY_RESERVATION" - Any reservation. + // "SPECIFIC_RESERVATION" - Specific reservation. + ReservationAffinityType string `json:"reservationAffinityType,omitempty"` + // ReservationAffinityValues: Corresponds to the label values of a reservation + // resource used by Vertex AI. This must be the full resource name of the + // reservation or reservation block. + ReservationAffinityValues []string `json:"reservationAffinityValues,omitempty"` // SampledShapleyNumPaths: Number of paths for the sampled Shapley explain // method. SampledShapleyNumPaths int64 `json:"sampledShapleyNumPaths,omitempty,string"` diff --git a/bigtableadmin/v2/bigtableadmin-api.json b/bigtableadmin/v2/bigtableadmin-api.json index d19bc86f6d5..37369dfb575 100644 --- a/bigtableadmin/v2/bigtableadmin-api.json +++ b/bigtableadmin/v2/bigtableadmin-api.json @@ -362,6 +362,7 @@ ], "parameters": { "pageToken": { + "deprecated": true, "description": "DEPRECATED: This field is unused and ignored.", "location": "query", "type": "string" @@ -837,6 +838,7 @@ ], "parameters": { "pageToken": { + "deprecated": true, "description": "DEPRECATED: This field is unused and ignored.", "location": "query", "type": "string" @@ -3029,7 +3031,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -3077,7 +3079,7 @@ } } }, - "revision": "20250828", + "revision": "20250912", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -3697,7 +3699,13 @@ "id": "CreateBackupMetadata", "properties": { "endTime": { - "description": "If set, the time at which this operation finished or was cancelled.", + "deprecated": true, + "description": "If set, the time at which this operation finished or was cancelled. DEPRECATED: Use finish_time instead.", + "format": "google-datetime", + "type": "string" + }, + "finishTime": { + "description": "The time at which the operation failed or was completed successfully.", "format": "google-datetime", "type": "string" }, @@ -3705,12 +3713,18 @@ "description": "The name of the backup being created.", "type": "string" }, + "requestTime": { + "description": "The time at which the original request was received.", + "format": "google-datetime", + "type": "string" + }, "sourceTable": { "description": "The name of the table the backup is created from.", "type": "string" }, "startTime": { - "description": "The time at which this operation started.", + "deprecated": true, + "description": "The time at which this operation started. DEPRECATED: Use request_time instead.", "format": "google-datetime", "type": "string" } @@ -3816,7 +3830,13 @@ "id": "CreateLogicalViewMetadata", "properties": { "endTime": { - "description": "If set, the time at which this operation finished or was canceled.", + "deprecated": true, + "description": "DEPRECATED: Use finish_time instead.", + "format": "google-datetime", + "type": "string" + }, + "finishTime": { + "description": "The time at which the operation failed or was completed successfully.", "format": "google-datetime", "type": "string" }, @@ -3824,8 +3844,14 @@ "$ref": "CreateLogicalViewRequest", "description": "The request that prompted the initiation of this CreateLogicalView operation." }, + "requestTime": { + "description": "The time at which the original request was received.", + "format": "google-datetime", + "type": "string" + }, "startTime": { - "description": "The time at which this operation started.", + "deprecated": true, + "description": "DEPRECATED: Use request_time instead.", "format": "google-datetime", "type": "string" } @@ -3856,7 +3882,13 @@ "id": "CreateMaterializedViewMetadata", "properties": { "endTime": { - "description": "If set, the time at which this operation finished or was canceled.", + "deprecated": true, + "description": "If set, the time at which this operation finished or was canceled. DEPRECATED: Use finish_time instead.", + "format": "google-datetime", + "type": "string" + }, + "finishTime": { + "description": "The time at which the operation failed or was completed successfully.", "format": "google-datetime", "type": "string" }, @@ -3864,8 +3896,14 @@ "$ref": "CreateMaterializedViewRequest", "description": "The request that prompted the initiation of this CreateMaterializedView operation." }, + "requestTime": { + "description": "The time at which the original request was received.", + "format": "google-datetime", + "type": "string" + }, "startTime": { - "description": "The time at which this operation started.", + "deprecated": true, + "description": "The time at which this operation started. DEPRECATED: Use request_time instead.", "format": "google-datetime", "type": "string" } @@ -3895,8 +3933,8 @@ "description": "The metadata for the Operation returned by CreateSchemaBundle.", "id": "CreateSchemaBundleMetadata", "properties": { - "endTime": { - "description": "If set, the time at which this operation finished or was canceled.", + "finishTime": { + "description": "The time at which the operation failed or was completed successfully.", "format": "google-datetime", "type": "string" }, @@ -3904,8 +3942,8 @@ "description": "The unique name identifying this schema bundle. Values are of the form `projects/{project}/instances/{instance}/tables/{table}/schemaBundles/{schema_bundle}`", "type": "string" }, - "startTime": { - "description": "The time at which this operation started.", + "requestTime": { + "description": "The time at which the original request was received.", "format": "google-datetime", "type": "string" } @@ -4257,7 +4295,7 @@ "id": "GoogleBigtableAdminV2TypeBytesEncodingRaw", "properties": { "escapeNulls": { - "description": "If set, allows NULL values to be encoded as the empty string \"\". The actual empty string, or any value which only contains the null byte 0x00, has one more null byte appended.", + "description": "If set, allows NULL values to be encoded as the empty string \"\". The actual empty string, or any value which only contains the null byte `0x00`, has one more null byte appended.", "type": "boolean" } }, @@ -4402,7 +4440,7 @@ "id": "GoogleBigtableAdminV2TypeStringEncodingUtf8Bytes", "properties": { "nullEscapeChar": { - "description": "Single-character escape sequence used to support NULL values. If set, allows NULL values to be encoded as the empty string \"\". The actual empty string, or any value where every character equals `null_escape_char`, has one more `null_escape_char` appended. If `null_escape_char` is set and does not equal the ASCII null character 0x00, then the encoding will not support sorted mode. .", + "description": "Single-character escape sequence used to support NULL values. If set, allows NULL values to be encoded as the empty string \"\". The actual empty string, or any value where every character equals `null_escape_char`, has one more `null_escape_char` appended. If `null_escape_char` is set and does not equal the ASCII null character `0x00`, then the encoding will not support sorted mode. .", "type": "string" } }, @@ -4453,7 +4491,7 @@ "type": "object" }, "GoogleBigtableAdminV2TypeStructEncodingDelimitedBytes": { - "description": "Fields are encoded independently and concatenated with a configurable `delimiter` in between. A struct with no fields defined is encoded as a single `delimiter`. Sorted mode: - Fields are encoded in sorted mode. - Encoded field values must not contain any bytes \u003c= `delimiter[0]` - Element-wise order is preserved: `A \u003c B` if `A[0] \u003c B[0]`, or if `A[0] == B[0] \u0026\u0026 A[1] \u003c B[1]`, etc. Strict prefixes sort first. Distinct mode: - Fields are encoded in distinct mode. - Encoded field values must not contain `delimiter[0]`.", + "description": "Fields are encoded independently and concatenated with a configurable `delimiter` in between. A struct with no fields defined is encoded as a single `delimiter`. Sorted mode: - Fields are encoded in sorted mode. - Encoded field values must not contain any bytes \u003c= `delimiter[0]` - Element-wise order is preserved: `A \u003c B` if `A[0] \u003c B[0]`, or if `A[0] == B[0] \u0026\u0026 A[1] \u003c B[1]`, etc. Strict prefixes sort first. - This encoding does not support `DESC` field ordering. Distinct mode: - Fields are encoded in distinct mode. - Encoded field values must not contain `delimiter[0]`.", "id": "GoogleBigtableAdminV2TypeStructEncodingDelimitedBytes", "properties": { "delimiter": { @@ -4465,13 +4503,13 @@ "type": "object" }, "GoogleBigtableAdminV2TypeStructEncodingOrderedCodeBytes": { - "description": "Fields are encoded independently and concatenated with the fixed byte pair {0x00, 0x01} in between. Any null (0x00) byte in an encoded field is replaced by the fixed byte pair {0x00, 0xFF}. Fields that encode to the empty string \"\" have special handling: - If *every* field encodes to \"\", or if the STRUCT has no fields defined, then the STRUCT is encoded as the fixed byte pair {0x00, 0x00}. - Otherwise, the STRUCT only encodes until the last non-empty field, omitting any trailing empty fields. Any empty fields that aren't omitted are replaced with the fixed byte pair {0x00, 0x00}. Examples: - STRUCT() -\u003e \"\\00\\00\" - STRUCT(\"\") -\u003e \"\\00\\00\" - STRUCT(\"\", \"\") -\u003e \"\\00\\00\" - STRUCT(\"\", \"B\") -\u003e \"\\00\\00\" + \"\\00\\01\" + \"B\" - STRUCT(\"A\", \"\") -\u003e \"A\" - STRUCT(\"\", \"B\", \"\") -\u003e \"\\00\\00\" + \"\\00\\01\" + \"B\" - STRUCT(\"A\", \"\", \"C\") -\u003e \"A\" + \"\\00\\01\" + \"\\00\\00\" + \"\\00\\01\" + \"C\" Since null bytes are always escaped, this encoding can cause size blowup for encodings like `Int64.BigEndianBytes` that are likely to produce many such bytes. Sorted mode: - Fields are encoded in sorted mode. - All values supported by the field encodings are allowed - Element-wise order is preserved: `A \u003c B` if `A[0] \u003c B[0]`, or if `A[0] == B[0] \u0026\u0026 A[1] \u003c B[1]`, etc. Strict prefixes sort first. Distinct mode: - Fields are encoded in distinct mode. - All values supported by the field encodings are allowed.", + "description": "Fields are encoded independently, then escaped and delimited by appling the following rules in order: - While the last remaining field is `ASC` or `UNSPECIFIED`, and encodes to the empty string \"\", remove it. - In each remaining field, replace all null bytes `0x00` with the fixed byte pair `{0x00, 0xFF}`. - If any remaining field encodes to the empty string \"\", replace it with the fixed byte pair `{0x00, 0x00}`. - Append the fixed byte pair `{0x00, 0x01}` to each remaining field, except for the last remaining field if it is `ASC`. - Bitwise negate all `DESC` fields. - Concatenate the results, or emit the fixed byte pair `{0x00, 0x00}` if there are no remaining fields to concatenate. Examples: ``` - STRUCT() -\u003e \"\\00\\00\" - STRUCT(\"\") -\u003e \"\\00\\00\" - STRUCT(\"\", \"\") -\u003e \"\\00\\00\" - STRUCT(\"\", \"B\") -\u003e \"\\00\\00\" + \"\\00\\01\" + \"B\" - STRUCT(\"A\", \"\") -\u003e \"A\" - STRUCT(\"\", \"B\", \"\") -\u003e \"\\00\\00\" + \"\\00\\01\" + \"B\" - STRUCT(\"A\", \"\", \"C\") -\u003e \"A\" + \"\\00\\01\" + \"\\00\\00\" + \"\\00\\01\" + \"C\" ``` Examples for struct with `DESC` fields: ``` - STRUCT(\"\" DESC) -\u003e \"\\xFF\\xFF\" + \"\\xFF\\xFE\" - STRUCT(\"\" DESC, \"\") -\u003e \"\\xFF\\xFF\" + \"\\xFF\\xFE\" - STRUCT(\"\" DESC, \"\", \"\") -\u003e \"\\xFF\\xFF\" + \"\\xFF\\xFE\" - STRUCT(\"\" DESC, \"A\") -\u003e \"\\xFF\\xFF\" + \"\\xFF\\xFE\" + \"A\" - STRUCT(\"A\", \"\" DESC, \"\") -\u003e \"A\" + \"\\00\\01\" + \"\\xFF\\xFF\" + \"\\xFF\\xFE\" - STRUCT(\"\", \"A\" DESC) -\u003e \"\\x00\\x00\" + \"\\x00\\x01\" + \"\\xBE\" + \"\\xFF\\xFE\" ``` Since null bytes are always escaped, this encoding can cause size blowup for encodings like `Int64.BigEndianBytes` that are likely to produce many such bytes. Sorted mode: - Fields are encoded in sorted mode. - All values supported by the field encodings are allowed. - Fields with unset or `UNSPECIFIED` order are treated as `ASC`. - Element-wise order is preserved: `A \u003c B` if `A[0] \u003c B[0]`, or if `A[0] == B[0] \u0026\u0026 A[1] \u003c B[1]`, etc. Strict prefixes sort first. Distinct mode: - Fields are encoded in distinct mode. - All values supported by the field encodings are allowed.", "id": "GoogleBigtableAdminV2TypeStructEncodingOrderedCodeBytes", "properties": {}, "type": "object" }, "GoogleBigtableAdminV2TypeStructEncodingSingleton": { - "description": "Uses the encoding of `fields[0].type` as-is. Only valid if `fields.size == 1`.", + "description": "Uses the encoding of `fields[0].type` as-is. Only valid if `fields.size == 1`. This encoding does not support `DESC` field ordering.", "id": "GoogleBigtableAdminV2TypeStructEncodingSingleton", "properties": {}, "type": "object" @@ -4722,6 +4760,7 @@ "type": "array" }, "nextPageToken": { + "deprecated": true, "description": "DEPRECATED: This field is unused and ignored.", "type": "string" } @@ -4765,6 +4804,7 @@ "type": "array" }, "nextPageToken": { + "deprecated": true, "description": "DEPRECATED: This field is unused and ignored.", "type": "string" } @@ -5568,7 +5608,7 @@ "type": "object" }, "Type": { - "description": "`Type` represents the type of data that is written to, read from, or stored in Bigtable. It is heavily based on the GoogleSQL standard to help maintain familiarity and consistency across products and features. For compatibility with Bigtable's existing untyped APIs, each `Type` includes an `Encoding` which describes how to convert to or from the underlying data. Each encoding can operate in one of two modes: - Sorted: In this mode, Bigtable guarantees that `Encode(X) \u003c= Encode(Y)` if and only if `X \u003c= Y`. This is useful anywhere sort order is important, for example when encoding keys. - Distinct: In this mode, Bigtable guarantees that if `X != Y` then `Encode(X) != Encode(Y)`. However, the converse is not guaranteed. For example, both \"{'foo': '1', 'bar': '2'}\" and \"{'bar': '2', 'foo': '1'}\" are valid encodings of the same JSON value. The API clearly documents which mode is used wherever an encoding can be configured. Each encoding also documents which values are supported in which modes. For example, when encoding INT64 as a numeric STRING, negative numbers cannot be encoded in sorted mode. This is because `INT64(1) \u003e INT64(-1)`, but `STRING(\"-00001\") \u003e STRING(\"00001\")`.", + "description": "`Type` represents the type of data that is written to, read from, or stored in Bigtable. It is heavily based on the GoogleSQL standard to help maintain familiarity and consistency across products and features. For compatibility with Bigtable's existing untyped APIs, each `Type` includes an `Encoding` which describes how to convert to or from the underlying data. Each encoding can operate in one of two modes: - Sorted: In this mode, Bigtable guarantees that `Encode(X) \u003c= Encode(Y)` if and only if `X \u003c= Y`. This is useful anywhere sort order is important, for example when encoding keys. - Distinct: In this mode, Bigtable guarantees that if `X != Y` then `Encode(X) != Encode(Y)`. However, the converse is not guaranteed. For example, both `{'foo': '1', 'bar': '2'}` and `{'bar': '2', 'foo': '1'}` are valid encodings of the same JSON value. The API clearly documents which mode is used wherever an encoding can be configured. Each encoding also documents which values are supported in which modes. For example, when encoding INT64 as a numeric STRING, negative numbers cannot be encoded in sorted mode. This is because `INT64(1) \u003e INT64(-1)`, but `STRING(\"-00001\") \u003e STRING(\"00001\")`.", "id": "Type", "properties": { "aggregateType": { @@ -5635,7 +5675,13 @@ "id": "UndeleteTableMetadata", "properties": { "endTime": { - "description": "If set, the time at which this operation finished or was cancelled.", + "deprecated": true, + "description": "If set, the time at which this operation finished or was cancelled. DEPRECATED: Use finish_time instead.", + "format": "google-datetime", + "type": "string" + }, + "finishTime": { + "description": "The time at which the operation failed or was completed successfully.", "format": "google-datetime", "type": "string" }, @@ -5643,8 +5689,14 @@ "description": "The name of the table being restored.", "type": "string" }, + "requestTime": { + "description": "The time at which the original request was received.", + "format": "google-datetime", + "type": "string" + }, "startTime": { - "description": "The time at which this operation started.", + "deprecated": true, + "description": "The time at which this operation started. DEPRECATED: Use request_time instead.", "format": "google-datetime", "type": "string" } @@ -5765,7 +5817,13 @@ "id": "UpdateLogicalViewMetadata", "properties": { "endTime": { - "description": "If set, the time at which this operation finished or was canceled.", + "deprecated": true, + "description": "DEPRECATED: Use finish_time instead.", + "format": "google-datetime", + "type": "string" + }, + "finishTime": { + "description": "The time at which the operation failed or was completed successfully.", "format": "google-datetime", "type": "string" }, @@ -5773,8 +5831,14 @@ "$ref": "UpdateLogicalViewRequest", "description": "The request that prompted the initiation of this UpdateLogicalView operation." }, + "requestTime": { + "description": "The time at which the original request was received.", + "format": "google-datetime", + "type": "string" + }, "startTime": { - "description": "The time at which this operation was started.", + "deprecated": true, + "description": "DEPRECATED: Use request_time instead.", "format": "google-datetime", "type": "string" } @@ -5801,8 +5865,8 @@ "description": "The metadata for the Operation returned by UpdateSchemaBundle.", "id": "UpdateSchemaBundleMetadata", "properties": { - "endTime": { - "description": "If set, the time at which this operation finished or was canceled.", + "finishTime": { + "description": "The time at which the operation failed or was completed successfully.", "format": "google-datetime", "type": "string" }, @@ -5810,8 +5874,8 @@ "description": "The unique name identifying this schema bundle. Values are of the form `projects/{project}/instances/{instance}/tables/{table}/schemaBundles/{schema_bundle}`", "type": "string" }, - "startTime": { - "description": "The time at which this operation started.", + "requestTime": { + "description": "The time at which the original request was received.", "format": "google-datetime", "type": "string" } @@ -5823,7 +5887,13 @@ "id": "UpdateTableMetadata", "properties": { "endTime": { - "description": "If set, the time at which this operation finished or was canceled.", + "deprecated": true, + "description": "If set, the time at which this operation finished or was canceled. DEPRECATED: Use finish_time instead.", + "format": "google-datetime", + "type": "string" + }, + "finishTime": { + "description": "The time at which the operation failed or was completed successfully.", "format": "google-datetime", "type": "string" }, @@ -5831,8 +5901,14 @@ "description": "The name of the table being updated.", "type": "string" }, + "requestTime": { + "description": "The time at which the original request was received.", + "format": "google-datetime", + "type": "string" + }, "startTime": { - "description": "The time at which this operation started.", + "deprecated": true, + "description": "The time at which this operation started. DEPRECATED: Use request_time instead.", "format": "google-datetime", "type": "string" } diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index 7d4b5dce338..8179f44acbf 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -1326,12 +1326,19 @@ func (s CreateAuthorizedViewRequest) MarshalJSON() ([]byte, error) { // CreateBackup. type CreateBackupMetadata struct { // EndTime: If set, the time at which this operation finished or was cancelled. + // DEPRECATED: Use finish_time instead. EndTime string `json:"endTime,omitempty"` + // FinishTime: The time at which the operation failed or was completed + // successfully. + FinishTime string `json:"finishTime,omitempty"` // Name: The name of the backup being created. Name string `json:"name,omitempty"` + // RequestTime: The time at which the original request was received. + RequestTime string `json:"requestTime,omitempty"` // SourceTable: The name of the table the backup is created from. SourceTable string `json:"sourceTable,omitempty"` - // StartTime: The time at which this operation started. + // StartTime: The time at which this operation started. DEPRECATED: Use + // request_time instead. 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 @@ -1485,12 +1492,17 @@ func (s CreateInstanceRequest) MarshalJSON() ([]byte, error) { // 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: DEPRECATED: Use finish_time instead. EndTime string `json:"endTime,omitempty"` + // FinishTime: The time at which the operation failed or was completed + // successfully. + FinishTime string `json:"finishTime,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. + // RequestTime: The time at which the original request was received. + RequestTime string `json:"requestTime,omitempty"` + // StartTime: DEPRECATED: Use request_time instead. 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 @@ -1543,11 +1555,18 @@ func (s CreateLogicalViewRequest) MarshalJSON() ([]byte, error) { // CreateMaterializedView. type CreateMaterializedViewMetadata struct { // EndTime: If set, the time at which this operation finished or was canceled. + // DEPRECATED: Use finish_time instead. EndTime string `json:"endTime,omitempty"` + // FinishTime: The time at which the operation failed or was completed + // successfully. + FinishTime string `json:"finishTime,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. + // RequestTime: The time at which the original request was received. + RequestTime string `json:"requestTime,omitempty"` + // StartTime: The time at which this operation started. DEPRECATED: Use + // request_time instead. 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 @@ -1599,21 +1618,22 @@ func (s CreateMaterializedViewRequest) MarshalJSON() ([]byte, error) { // CreateSchemaBundleMetadata: The metadata for the Operation returned by // CreateSchemaBundle. type CreateSchemaBundleMetadata struct { - // EndTime: If set, the time at which this operation finished or was canceled. - EndTime string `json:"endTime,omitempty"` + // FinishTime: The time at which the operation failed or was completed + // successfully. + FinishTime string `json:"finishTime,omitempty"` // Name: The unique name identifying this schema bundle. Values are of the form // `projects/{project}/instances/{instance}/tables/{table}/schemaBundles/{schema // _bundle}` Name string `json:"name,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 + // RequestTime: The time at which the original request was received. + RequestTime string `json:"requestTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "FinishTime") 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 + // NullFields is a list of field names (e.g. "FinishTime") 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. @@ -2174,7 +2194,7 @@ func (s GoogleBigtableAdminV2TypeBytesEncoding) MarshalJSON() ([]byte, error) { type GoogleBigtableAdminV2TypeBytesEncodingRaw struct { // EscapeNulls: If set, allows NULL values to be encoded as the empty string // "". The actual empty string, or any value which only contains the null byte - // 0x00, has one more null byte appended. + // `0x00`, has one more null byte appended. EscapeNulls bool `json:"escapeNulls,omitempty"` // ForceSendFields is a list of field names (e.g. "EscapeNulls") to // unconditionally include in API requests. By default, fields with empty or @@ -2429,8 +2449,8 @@ type GoogleBigtableAdminV2TypeStringEncodingUtf8Bytes struct { // values. If set, allows NULL values to be encoded as the empty string "". The // actual empty string, or any value where every character equals // `null_escape_char`, has one more `null_escape_char` appended. If - // `null_escape_char` is set and does not equal the ASCII null character 0x00, - // then the encoding will not support sorted mode. . + // `null_escape_char` is set and does not equal the ASCII null character + // `0x00`, then the encoding will not support sorted mode. . NullEscapeChar string `json:"nullEscapeChar,omitempty"` // ForceSendFields is a list of field names (e.g. "NullEscapeChar") to // unconditionally include in API requests. By default, fields with empty or @@ -2515,8 +2535,9 @@ func (s GoogleBigtableAdminV2TypeStructEncoding) MarshalJSON() ([]byte, error) { // mode: - Fields are encoded in sorted mode. - Encoded field values must not // contain any bytes <= `delimiter[0]` - Element-wise order is preserved: `A < // B` if `A[0] < B[0]`, or if `A[0] == B[0] && A[1] < B[1]`, etc. Strict -// prefixes sort first. Distinct mode: - Fields are encoded in distinct mode. - -// Encoded field values must not contain `delimiter[0]`. +// prefixes sort first. - This encoding does not support `DESC` field ordering. +// Distinct mode: - Fields are encoded in distinct mode. - Encoded field values +// must not contain `delimiter[0]`. type GoogleBigtableAdminV2TypeStructEncodingDelimitedBytes struct { // Delimiter: Byte sequence used to delimit concatenated fields. The delimiter // must contain at least 1 character and at most 50 characters. @@ -2540,21 +2561,29 @@ func (s GoogleBigtableAdminV2TypeStructEncodingDelimitedBytes) MarshalJSON() ([] } // GoogleBigtableAdminV2TypeStructEncodingOrderedCodeBytes: Fields are encoded -// independently and concatenated with the fixed byte pair {0x00, 0x01} in -// between. Any null (0x00) byte in an encoded field is replaced by the fixed -// byte pair {0x00, 0xFF}. Fields that encode to the empty string "" have -// special handling: - If *every* field encodes to "", or if the STRUCT has no -// fields defined, then the STRUCT is encoded as the fixed byte pair {0x00, -// 0x00}. - Otherwise, the STRUCT only encodes until the last non-empty field, -// omitting any trailing empty fields. Any empty fields that aren't omitted are -// replaced with the fixed byte pair {0x00, 0x00}. Examples: - STRUCT() -> -// "\00\00" - STRUCT("") -> "\00\00" - STRUCT("", "") -> "\00\00" - STRUCT("", -// "B") -> "\00\00" + "\00\01" + "B" - STRUCT("A", "") -> "A" - STRUCT("", "B", -// "") -> "\00\00" + "\00\01" + "B" - STRUCT("A", "", "C") -> "A" + "\00\01" + -// "\00\00" + "\00\01" + "C" Since null bytes are always escaped, this encoding +// independently, then escaped and delimited by appling the following rules in +// order: - While the last remaining field is `ASC` or `UNSPECIFIED`, and +// encodes to the empty string "", remove it. - In each remaining field, +// replace all null bytes `0x00` with the fixed byte pair `{0x00, 0xFF}`. - If +// any remaining field encodes to the empty string "", replace it with the +// fixed byte pair `{0x00, 0x00}`. - Append the fixed byte pair `{0x00, 0x01}` +// to each remaining field, except for the last remaining field if it is `ASC`. +// - Bitwise negate all `DESC` fields. - Concatenate the results, or emit the +// fixed byte pair `{0x00, 0x00}` if there are no remaining fields to +// concatenate. Examples: ``` - STRUCT() -> "\00\00" - STRUCT("") -> "\00\00" - +// STRUCT("", "") -> "\00\00" - STRUCT("", "B") -> "\00\00" + "\00\01" + "B" - +// STRUCT("A", "") -> "A" - STRUCT("", "B", "") -> "\00\00" + "\00\01" + "B" - +// STRUCT("A", "", "C") -> "A" + "\00\01" + "\00\00" + "\00\01" + "C" ``` +// Examples for struct with `DESC` fields: ``` - STRUCT("" DESC) -> "\xFF\xFF" +// + "\xFF\xFE" - STRUCT("" DESC, "") -> "\xFF\xFF" + "\xFF\xFE" - STRUCT("" +// DESC, "", "") -> "\xFF\xFF" + "\xFF\xFE" - STRUCT("" DESC, "A") -> +// "\xFF\xFF" + "\xFF\xFE" + "A" - STRUCT("A", "" DESC, "") -> "A" + "\00\01" + +// "\xFF\xFF" + "\xFF\xFE" - STRUCT("", "A" DESC) -> "\x00\x00" + "\x00\x01" + +// "\xBE" + "\xFF\xFE" ``` Since null bytes are always escaped, this encoding // can cause size blowup for encodings like `Int64.BigEndianBytes` that are // likely to produce many such bytes. Sorted mode: - Fields are encoded in -// sorted mode. - All values supported by the field encodings are allowed - +// sorted mode. - All values supported by the field encodings are allowed. - +// Fields with unset or `UNSPECIFIED` order are treated as `ASC`. - // Element-wise order is preserved: `A < B` if `A[0] < B[0]`, or if `A[0] == // B[0] && A[1] < B[1]`, etc. Strict prefixes sort first. Distinct mode: - // Fields are encoded in distinct mode. - All values supported by the field @@ -2563,7 +2592,8 @@ type GoogleBigtableAdminV2TypeStructEncodingOrderedCodeBytes struct { } // GoogleBigtableAdminV2TypeStructEncodingSingleton: Uses the encoding of -// `fields[0].type` as-is. Only valid if `fields.size == 1`. +// `fields[0].type` as-is. Only valid if `fields.size == 1`. This encoding does +// not support `DESC` field ordering. type GoogleBigtableAdminV2TypeStructEncodingSingleton struct { } @@ -4286,7 +4316,7 @@ func (s TieredStorageRule) MarshalJSON() ([]byte, error) { // This is useful anywhere sort order is important, for example when encoding // keys. - Distinct: In this mode, Bigtable guarantees that if `X != Y` then // `Encode(X) != Encode(Y)`. However, the converse is not guaranteed. For -// example, both "{'foo': '1', 'bar': '2'}" and "{'bar': '2', 'foo': '1'}" are +// example, both `{'foo': '1', 'bar': '2'}` and `{'bar': '2', 'foo': '1'}` are // valid encodings of the same JSON value. The API clearly documents which mode // is used wherever an encoding can be configured. Each encoding also documents // which values are supported in which modes. For example, when encoding INT64 @@ -4343,10 +4373,17 @@ func (s Type) MarshalJSON() ([]byte, error) { // google.bigtable.admin.v2.BigtableTableAdmin.UndeleteTable. type UndeleteTableMetadata struct { // EndTime: If set, the time at which this operation finished or was cancelled. + // DEPRECATED: Use finish_time instead. EndTime string `json:"endTime,omitempty"` + // FinishTime: The time at which the operation failed or was completed + // successfully. + FinishTime string `json:"finishTime,omitempty"` // Name: The name of the table being restored. Name string `json:"name,omitempty"` - // StartTime: The time at which this operation started. + // RequestTime: The time at which the original request was received. + RequestTime string `json:"requestTime,omitempty"` + // StartTime: The time at which this operation started. DEPRECATED: Use + // request_time instead. 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 @@ -4524,12 +4561,17 @@ func (s UpdateInstanceMetadata) MarshalJSON() ([]byte, error) { // 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: DEPRECATED: Use finish_time instead. EndTime string `json:"endTime,omitempty"` + // FinishTime: The time at which the operation failed or was completed + // successfully. + FinishTime string `json:"finishTime,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. + // RequestTime: The time at which the original request was received. + RequestTime string `json:"requestTime,omitempty"` + // StartTime: DEPRECATED: Use request_time instead. 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 @@ -4579,21 +4621,22 @@ func (s UpdateLogicalViewRequest) MarshalJSON() ([]byte, error) { // UpdateSchemaBundleMetadata: The metadata for the Operation returned by // UpdateSchemaBundle. type UpdateSchemaBundleMetadata struct { - // EndTime: If set, the time at which this operation finished or was canceled. - EndTime string `json:"endTime,omitempty"` + // FinishTime: The time at which the operation failed or was completed + // successfully. + FinishTime string `json:"finishTime,omitempty"` // Name: The unique name identifying this schema bundle. Values are of the form // `projects/{project}/instances/{instance}/tables/{table}/schemaBundles/{schema // _bundle}` Name string `json:"name,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 + // RequestTime: The time at which the original request was received. + RequestTime string `json:"requestTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "FinishTime") 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 + // NullFields is a list of field names (e.g. "FinishTime") 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. @@ -4609,10 +4652,17 @@ func (s UpdateSchemaBundleMetadata) MarshalJSON() ([]byte, error) { // UpdateTable. type UpdateTableMetadata struct { // EndTime: If set, the time at which this operation finished or was canceled. + // DEPRECATED: Use finish_time instead. EndTime string `json:"endTime,omitempty"` + // FinishTime: The time at which the operation failed or was completed + // successfully. + FinishTime string `json:"finishTime,omitempty"` // Name: The name of the table being updated. Name string `json:"name,omitempty"` - // StartTime: The time at which this operation started. + // RequestTime: The time at which the original request was received. + RequestTime string `json:"requestTime,omitempty"` + // StartTime: The time at which this operation started. DEPRECATED: Use + // request_time instead. 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 @@ -13824,9 +13874,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/certificatemanager/v1/certificatemanager-api.json b/certificatemanager/v1/certificatemanager-api.json index 697ba3e056b..d9c1edd5c50 100644 --- a/certificatemanager/v1/certificatemanager-api.json +++ b/certificatemanager/v1/certificatemanager-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1320,7 +1320,7 @@ } } }, - "revision": "20250813", + "revision": "20250908", "rootUrl": "https://certificatemanager.googleapis.com/", "schemas": { "AllowlistedCertificate": { diff --git a/certificatemanager/v1/certificatemanager-gen.go b/certificatemanager/v1/certificatemanager-gen.go index 9bc76b82e2f..860e67b6627 100644 --- a/certificatemanager/v1/certificatemanager-gen.go +++ b/certificatemanager/v1/certificatemanager-gen.go @@ -1570,9 +1570,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index a1889b97632..451d7049c90 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -1528,7 +1528,7 @@ } } }, - "revision": "20250911", + "revision": "20250916", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessSettings": { @@ -3049,10 +3049,18 @@ "description": "The text that appears below `text`. Always wraps.", "type": "string" }, + "bottomLabelText": { + "$ref": "GoogleAppsCardV1TextParagraph", + "description": "`TextParagraph` equivalent of `bottom_label`. Always wraps. Allows for more complex formatting than `bottom_label`. [Google Chat apps](https://developers.google.com/workspace/chat):" + }, "button": { "$ref": "GoogleAppsCardV1Button", "description": "A button that a user can click to trigger an action." }, + "contentText": { + "$ref": "GoogleAppsCardV1TextParagraph", + "description": "`TextParagraph` equivalent of `text`. Allows for more complex formatting than `text`. [Google Chat apps](https://developers.google.com/workspace/chat):" + }, "endIcon": { "$ref": "GoogleAppsCardV1Icon", "description": "An icon displayed after the text. Supports [built-in](https://developers.google.com/workspace/chat/format-messages#builtinicons) and [custom](https://developers.google.com/workspace/chat/format-messages#customicons) icons." @@ -3070,6 +3078,22 @@ "$ref": "GoogleAppsCardV1Icon", "description": "The icon displayed in front of the text." }, + "startIconVerticalAlignment": { + "description": "Optional. Vertical alignment of the start icon. If not set, the icon will be vertically centered. [Google Chat apps](https://developers.google.com/workspace/chat):", + "enum": [ + "VERTICAL_ALIGNMENT_UNSPECIFIED", + "TOP", + "MIDDLE", + "BOTTOM" + ], + "enumDescriptions": [ + "Unspecified type. Do not use.", + "Alignment to the top position.", + "Alignment to the middle position.", + "Alignment to the bottom position." + ], + "type": "string" + }, "switchControl": { "$ref": "GoogleAppsCardV1SwitchControl", "description": "A switch widget that a user can click to change its state and trigger an action." @@ -3082,6 +3106,10 @@ "description": "The text that appears above `text`. Always truncates.", "type": "string" }, + "topLabelText": { + "$ref": "GoogleAppsCardV1TextParagraph", + "description": "`TextParagraph` equivalent of `top_label`. Always truncates. Allows for more complex formatting than `top_label`. [Google Chat apps](https://developers.google.com/workspace/chat):" + }, "wrapText": { "description": "The wrap text setting. If `true`, the text wraps and displays on multiple lines. Otherwise, the text is truncated. Only applies to `text`, not `topLabel` and `bottomLabel`.", "type": "boolean" @@ -3775,6 +3803,20 @@ "text": { "description": "The text that's shown in the widget.", "type": "string" + }, + "textSyntax": { + "description": "The syntax of the text. If not set, the text is rendered as HTML. [Google Chat apps](https://developers.google.com/workspace/chat):", + "enum": [ + "TEXT_SYNTAX_UNSPECIFIED", + "HTML", + "MARKDOWN" + ], + "enumDescriptions": [ + "The text is rendered as HTML if unspecified.", + "The text is rendered as HTML. This is the default value.", + "The text is rendered as Markdown." + ], + "type": "string" } }, "type": "object" diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 99295db5f87..335436c696e 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -2834,8 +2834,16 @@ func (s GoogleAppsCardV1DateTimePicker) MarshalJSON() ([]byte, error) { type GoogleAppsCardV1DecoratedText struct { // BottomLabel: The text that appears below `text`. Always wraps. BottomLabel string `json:"bottomLabel,omitempty"` + // BottomLabelText: `TextParagraph` equivalent of `bottom_label`. Always wraps. + // Allows for more complex formatting than `bottom_label`. Google Chat apps + // (https://developers.google.com/workspace/chat): + BottomLabelText *GoogleAppsCardV1TextParagraph `json:"bottomLabelText,omitempty"` // Button: A button that a user can click to trigger an action. Button *GoogleAppsCardV1Button `json:"button,omitempty"` + // ContentText: `TextParagraph` equivalent of `text`. Allows for more complex + // formatting than `text`. Google Chat apps + // (https://developers.google.com/workspace/chat): + ContentText *GoogleAppsCardV1TextParagraph `json:"contentText,omitempty"` // EndIcon: An icon displayed after the text. Supports built-in // (https://developers.google.com/workspace/chat/format-messages#builtinicons) // and custom @@ -2849,6 +2857,16 @@ type GoogleAppsCardV1DecoratedText struct { OnClick *GoogleAppsCardV1OnClick `json:"onClick,omitempty"` // StartIcon: The icon displayed in front of the text. StartIcon *GoogleAppsCardV1Icon `json:"startIcon,omitempty"` + // StartIconVerticalAlignment: Optional. Vertical alignment of the start icon. + // If not set, the icon will be vertically centered. Google Chat apps + // (https://developers.google.com/workspace/chat): + // + // Possible values: + // "VERTICAL_ALIGNMENT_UNSPECIFIED" - Unspecified type. Do not use. + // "TOP" - Alignment to the top position. + // "MIDDLE" - Alignment to the middle position. + // "BOTTOM" - Alignment to the bottom position. + StartIconVerticalAlignment string `json:"startIconVerticalAlignment,omitempty"` // SwitchControl: A switch widget that a user can click to change its state and // trigger an action. SwitchControl *GoogleAppsCardV1SwitchControl `json:"switchControl,omitempty"` @@ -2860,6 +2878,10 @@ type GoogleAppsCardV1DecoratedText struct { Text string `json:"text,omitempty"` // TopLabel: The text that appears above `text`. Always truncates. TopLabel string `json:"topLabel,omitempty"` + // TopLabelText: `TextParagraph` equivalent of `top_label`. Always truncates. + // Allows for more complex formatting than `top_label`. Google Chat apps + // (https://developers.google.com/workspace/chat): + TopLabelText *GoogleAppsCardV1TextParagraph `json:"topLabelText,omitempty"` // WrapText: The wrap text setting. If `true`, the text wraps and displays on // multiple lines. Otherwise, the text is truncated. Only applies to `text`, // not `topLabel` and `bottomLabel`. @@ -3921,6 +3943,14 @@ type GoogleAppsCardV1TextParagraph struct { MaxLines int64 `json:"maxLines,omitempty"` // Text: The text that's shown in the widget. Text string `json:"text,omitempty"` + // TextSyntax: The syntax of the text. If not set, the text is rendered as + // HTML. Google Chat apps (https://developers.google.com/workspace/chat): + // + // Possible values: + // "TEXT_SYNTAX_UNSPECIFIED" - The text is rendered as HTML if unspecified. + // "HTML" - The text is rendered as HTML. This is the default value. + // "MARKDOWN" - The text is rendered as Markdown. + TextSyntax string `json:"textSyntax,omitempty"` // ForceSendFields is a list of field names (e.g. "MaxLines") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/cloudcommerceprocurement/v1/cloudcommerceprocurement-api.json b/cloudcommerceprocurement/v1/cloudcommerceprocurement-api.json index ad3dd197db3..114dfe24b74 100644 --- a/cloudcommerceprocurement/v1/cloudcommerceprocurement-api.json +++ b/cloudcommerceprocurement/v1/cloudcommerceprocurement-api.json @@ -152,6 +152,21 @@ "pattern": "^providers/[^/]+/accounts/[^/]+$", "required": true, "type": "string" + }, + "view": { + "description": "Optional. What information to include in the response.", + "enum": [ + "ACCOUNT_VIEW_UNSPECIFIED", + "ACCOUNT_VIEW_BASIC", + "ACCOUNT_VIEW_FULL" + ], + "enumDescriptions": [ + "The default / unset value. For `GetAccount`, it defaults to the FULL view. For `ListAccounts`, it only supports BASIC view.", + "Include base account information. This is the default view. All fields from Account are included except for the reseller_parent_billing_account field.", + "Includes all available account information, inclusive of the accounts reseller_parent_billing_account, if it's a resold account." + ], + "location": "query", + "type": "string" } }, "path": "v1/{+name}", @@ -503,7 +518,7 @@ } } }, - "revision": "20250907", + "revision": "20250923", "rootUrl": "https://cloudcommerceprocurement.googleapis.com/", "schemas": { "Account": { @@ -539,6 +554,10 @@ "description": "Output only. The identifier of the service provider that this account was created against. Each service provider is assigned a unique provider value when they onboard with Cloud Commerce platform.", "type": "string" }, + "resellerParentBillingAccount": { + "description": "Output only. The reseller parent billing account of the account's corresponding billing account, applicable only when the corresponding billing account is a subaccount of a reseller. Included in responses only for view: ACCOUNT_VIEW_FULL. Format: billingAccounts/{billing_account_id}", + "type": "string" + }, "state": { "description": "Output only. The state of the account. This is used to decide whether the customer is in good standing with the provider and is able to make purchases. An account might not be able to make a purchase if the billing account is suspended, for example.", "enum": [ @@ -717,24 +736,24 @@ "type": "string" }, "newOfferEndTime": { - "description": "Output only. The end time of the new offer. If the offer was has a term duration instead of a specified end date, this field is empty. This field is populated even if the entitlement isn't active yet. If there's no upcoming offer, the field is empty. * If the entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED, ENTITLEMENT_ACTIVE, or ENTITLEMENT_PENDING_CANCELLATION state, then this field will be empty. * If the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE state, then this field will be populated with the expected end time of the upcoming offer (in the future) if the upcoming offer has a specified end date. Otherwise, this field will be empty. * If the entitlement is in ENTITLEMENT_CANCELLED state, then this field will be empty.", + "description": "Output only. The end time of the new offer, determined from the offer's specified end date. If the offer des not have a specified end date then this field is not set. This field is populated even if the entitlement isn't active yet. If there's no upcoming offer, the field is empty. * If the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, ENTITLEMENT_ACTIVE, or ENTITLEMENT_PENDING_CANCELLATION, then this field is empty. * If the entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE, and the upcoming offer has a specified end date, then this field is populated with the expected end time of the upcoming offer, in the future. Otherwise, this field is empty. * If the entitlement is in the state ENTITLEMENT_CANCELLED, then this field is empty.", "format": "google-datetime", "readOnly": true, "type": "string" }, "newOfferStartTime": { - "description": "Output only. The timestamp when the new offer becomes effective. This field is populated even if the entitlement isn't active yet. If there's no upcoming offer, the field is empty. * If the entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED state, this field will not be populated when the entitlement is not yet approved. But after the entitlement is approved, then this field will be populated with effective time of the upcoming offer. * If the entitlement is in ENTITLEMENT_ACTIVE or ENTITLEMENT_PENDING_CANCELLATION state, this field will not be populated. * If the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL state, this field will not be populated since the entitlement change is waiting on approval. * If the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE state, this field will be populated with the expected effective time of the upcoming offer (in the future). * If the entitlement is in ENTITLEMENT_CANCELLED state, then this field will be empty.", + "description": "Output only. The timestamp when the new offer becomes effective. This field is populated even if the entitlement isn't active yet. If there's no upcoming offer, the field is empty. * If the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, this field isn't populated when the entitlement isn't yet approved. After the entitlement is approved, this field is populated with the effective time of the upcoming offer. * If the entitlement is in the state ENTITLEMENT_ACTIVE or ENTITLEMENT_PENDING_CANCELLATION, this field isn't populated. * If the entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL, this field isn't populated, because the entitlement change is waiting on approval. * If the entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE, this field is populated with the expected effective time of the upcoming offer, which is in the future. * If the entitlement is in the state ENTITLEMENT_CANCELLED, then this field is empty.", "format": "google-datetime", "readOnly": true, "type": "string" }, "newPendingOffer": { - "description": "Output only. The name of the offer the entitlement is switching to upon a pending plan change. Only exists if the pending plan change is moving to an offer. This field isn't populated for entitlements which aren't active yet. Format: 'projects/{project}/services/{service}/privateOffers/{offer}' OR 'projects/{project}/services/{service}/standardOffers/{offer}', depending on whether the offer is private or public. The {service} in the name is the listing service of the offer. It could be either the product service that the offer is referencing, or a generic private offer parent service. We recommend that you don't build your integration to rely on the meaning of this {service} part. * If the entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED, ENTITLEMENT_ACTIVE or ENTITLEMENT_PENDING_CANCELLATION state, then this field will be empty. * If the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE state, then this field will be populated with the upcoming offer. * If the entitlement is in ENTITLEMENT_CANCELLED state, then this will be empty.", + "description": "Output only. Upon a pending plan change, the name of the offer that the entitlement is switching to. Only exists if the pending plan change is moving to an offer. This field isn't populated for entitlements which aren't active yet. Format: 'projects/{project}/services/{service}/privateOffers/{offer}' OR 'projects/{project}/services/{service}/standardOffers/{offer}', depending on whether the offer is private or public. The {service} in the name is the listing service of the offer. It could be either the product service that the offer is referencing, or a generic private offer parent service. We recommend that you don't build your integration to rely on the meaning of this {service} part. * If the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, ENTITLEMENT_ACTIVE or ENTITLEMENT_PENDING_CANCELLATION, then this field is empty. * If the entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE, then this field is populated with the upcoming offer. * If the entitlement is in the state ENTITLEMENT_CANCELLED, then this is empty.", "readOnly": true, "type": "string" }, "newPendingOfferDuration": { - "description": "Output only. The duration of the new offer, in ISO 8601 duration format. This field isn't populated for entitlements which aren't active yet, only for pending offer changes. If the offer was has a specified end date instead of a duration, this field is empty. * If the entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED, ENTITLEENTITLEMENT_ACTIVE, or ENTITLEMENT_PENDING_CANCELLATION state, then this field is empty. * If the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE state, then this field will be populated with the duration of the upcoming offer, if the upcoming offer is does not have a specified end date. Otherwise, this field will be empty. * If the entitlement is in ENTITLEMENT_CANCELLED state, then this field will be empty.", + "description": "Output only. The duration of the new offer, in ISO 8601 duration format. This field is populated for pending offer changes. It isn't populated for entitlements which aren't active yet. If the offer has a specified end date instead of a duration, this field is empty. * If the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, ENTITLEMENT_ACTIVE, or ENTITLEMENT_PENDING_CANCELLATION, this field is empty. * If the entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE, and the upcoming offer doesn't have a specified end date, then this field is populated with the duration of the upcoming offer. Otherwise, this field is empty. * If the entitlement is in the state ENTITLEMENT_CANCELLED, then this field is empty.", "readOnly": true, "type": "string" }, @@ -743,17 +762,17 @@ "type": "string" }, "offer": { - "description": "Output only. The name of the offer that was procured. Field is empty if order was not made using an offer. Format: 'projects/{project}/services/{service}/privateOffers/{offer}' OR 'projects/{project}/services/{service}/standardOffers/{offer}', depending on whether the offer is private or public. The {service} in the name is the listing service of the offer. It could be either the product service that the offer is referencing, or a generic private offer parent service. We recommend that you don't build your integration to rely on the meaning of this {service} part. * If the entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED state, this field will be populated with the upcoming offer. * If the entitlement is in ENTITLEMENT_ACTIVE, ENTITLEMENT_PENDING_CANCELLATION, ENTITLEMENT_PENDING_PLAN_CHANGE, or ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL state, this field will be populated with the current offer. * If the entitlement is in ENTITLEMENT_CANCELLED state, then this field will be populated with the latest offer the order was associated with.", + "description": "Output only. The name of the offer that was procured. Field is empty if order wasn't made using an offer. Format: 'projects/{project}/services/{service}/privateOffers/{offer}' OR 'projects/{project}/services/{service}/standardOffers/{offer}', depending on whether the offer is private or public. The {service} in the name is the listing service of the offer. It could be either the product service that the offer is referencing, or a generic private offer parent service. We recommend that you don't build your integration to rely on the meaning of this {service} part. * If the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, this field is populated with the upcoming offer. * If the entitlement is in the state ENTITLEMENT_ACTIVE, ENTITLEMENT_PENDING_CANCELLATION, ENTITLEMENT_PENDING_PLAN_CHANGE, or ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL, this field is populated with the current offer. * If the entitlement is in the state ENTITLEMENT_CANCELLED, then this field is populated with the latest offer that the order was associated with.", "readOnly": true, "type": "string" }, "offerDuration": { - "description": "Output only. The offer duration of the current offer in ISO 8601 duration format. Field is empty if entitlement was not made using an offer. If the offer has a specified end date instead of a duration, this field is empty. * If the entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED state, then this field will be populated with the duration of the upcoming offer, if the upcoming offer does not have a specified end date. Otherwise, this field will be empty. * If the entitlement is in ENTITLEMENT_ACTIVE, ENTITLEMENT_PENDING_CANCELLATION, ENTITLEMENT_PENDING_PLAN_CHANGE, or ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL state, then this field will be populated with the duration of the current offer if the current offer is does not have a specific end date. Otherwise, this field will be empty. * If the entitlement is in ENTITLEMENT_CANCELLED state, then this field will be populated with the duration of the latest offer the order was associated with if that offer does not have a specific end date. Otherwise, this field will be empty.", + "description": "Output only. The offer duration of the current offer, in ISO 8601 duration format. This is empty if the entitlement wasn't made using an offer, or if the offer has a specified end date instead of a duration. * If the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, and the upcoming offer doesn't have a specified end date, then this field is populated with the duration of the upcoming offer. Otherwise, this field is empty. * If the entitlement is in the state ENTITLEMENT_ACTIVE, ENTITLEMENT_PENDING_CANCELLATION, ENTITLEMENT_PENDING_PLAN_CHANGE, or ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL, and the current offer doesn't have a specified end date, then this field contains the duration of the current offer. Otherwise, this field is empty. * If the entitlement is in the state ENTITLEMENT_CANCELLED, and the offer doesn't have a specified end date, then this field is populated with the duration of the latest offer that the order was associated with. Otherwise, this field is empty.", "readOnly": true, "type": "string" }, "offerEndTime": { - "description": "Output only. End time for the Offer associated with this entitlement. Note that this field value can change over time. This occurs naturally even if the offer is not changed, due to auto renewal. * If the entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED state, then: * If the entitlement is not yet approved, then this field will be populated with the expected end time of the upcoming offer (in the future) if the upcoming offer has a specified end date. Otherwise this field will be empty. * If the entitlement is approved, then this field will always be populated with the expected end time of the upcoming offer (in the future). This means both this field, and the offer_duration field, can co-exist. * If the entitlement is in ENTITLEMENT_ACTIVE or ENTITLEMENT_PENDING_CANCELLATION state, then this field will be populated with the actual expected end time of the current offer (in the futre). Meaning, this field will be set, regardless of whether the offer has a specific end date or a duration. This means both this field, and the offer_duration field, can co-exist. * If the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE state: * If the current offer has already ended and became pure PAYG, then this field reflects the ACTUAL end time of the current offer (in the past). * Otherwise, then this is the EXPECTED end date of the current offer (in the future). * If the entitlement is in ENTITLEMENT_CANCELLED state, then this field will be populated with the ACTUAL end time of the latest offer the order was associated with (in the past). If the entitlement was cancelled before any offer started, then this field will be empty.", + "description": "Output only. End time for the current term of the Offer associated with this entitlement. The value of this field can change naturally over time due to auto-renewal, even if the offer isn't changed. * If the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, then: * If the entitlement isn't approved yet approved, and the offer has a specified end date, then this field is populated with the expected end time of the upcoming offer, in the future. Otherwise, this field is empty. * If the entitlement is approved, then this field is populated with the expected end time of the upcoming offer, in the future. This means that this field and the field offer_duration can both exist. * If the entitlement is in the state ENTITLEMENT_ACTIVE or ENTITLEMENT_PENDING_CANCELLATION, then this field is populated with the expected end time of the current offer, in the future. This field's value is set regardless of whether the offer has a specific end date or a duration. This means that this field and the field offer_duration can both exist. * If the entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE: * If the entitlement's pricing model is usage based and the associated offer is a private offer whose term has ended, then this field reflects the ACTUAL end time of the entitlement's associated offer (in the past), even though the entitlement associated with this private offer does not terminate at the end of that private offer's term. * Otherwise, this is the expected end date of the current offer, in the future. * If the entitlement is in the state ENTITLEMENT_CANCELLED, then this field is populated with the end time, in the past, of the latest offer that the order was associated with. If the entitlement was cancelled before any offer started, then this field is empty.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -800,7 +819,7 @@ ], "enumDescriptions": [ "Default state of the entitlement. It's only set to this value when the entitlement is first created and has not been initialized.", - "Indicates that the entitlement has been created but has not yet become active. The entitlement will remain in this state until it becomes active. If the entitlement requires provider approval, a notification is sent to the provider for the activation approval. If the provider does not approve, the entitlement is removed. If approved, the entitlement transitions to the EntitlementState.ENTITLEMENT_ACTIVE state after a delay, either a generally short processing delay or, if applicable, until the scheduled start time of the purchased offer. Plan changes are not allowed in this state. Instead, customers are expected to cancel the corresponding order and place a new order.", + "Indicates that the entitlement has been created, but it hasn't yet become active. The entitlement remains in this state until it becomes active. If the entitlement requires provider approval, a notification is sent to the provider for the activation approval. If the provider doesn't approve, the entitlement is removed. If approved, the entitlement transitions to the EntitlementState.ENTITLEMENT_ACTIVE state after either a short processing delay or, if applicable, at the scheduled start time of the purchased offer. Plan changes aren't allowed in this state. Instead, customers are expected to cancel the corresponding order and place a new order.", "Indicates that the entitlement is active. The procured item is now usable and any associated billing events will start occurring. Entitlements in this state WILL renew. The analogous state for an unexpired but non-renewing entitlement is ENTITLEMENT_PENDING_CANCELLATION. In this state, the customer can decide to cancel the entitlement, which would change the state to EntitlementState.ENTITLEMENT_PENDING_CANCELLATION, and then EntitlementState.ENTITLEMENT_CANCELLED. The user can also request a change of plan, which will transition the state to EntitlementState.ENTITLEMENT_PENDING_PLAN_CHANGE, and then back to EntitlementState.ENTITLEMENT_ACTIVE.", "Indicates that the entitlement will expire at the end of its term. This could mean the customer has elected not to renew this entitlement or the customer elected to cancel an entitlement that only expires at term end. The entitlement typically stays in this state if the entitlement/plan allows use of the underlying resource until the end of the current billing cycle. Once the billing cycle completes, the resource will transition to EntitlementState.ENTITLEMENT_CANCELLED state. The resource cannot be modified during this state.", "Indicates that the entitlement was cancelled. The entitlement can now be deleted.", diff --git a/cloudcommerceprocurement/v1/cloudcommerceprocurement-gen.go b/cloudcommerceprocurement/v1/cloudcommerceprocurement-gen.go index fd767f14533..56fac0f2d60 100644 --- a/cloudcommerceprocurement/v1/cloudcommerceprocurement-gen.go +++ b/cloudcommerceprocurement/v1/cloudcommerceprocurement-gen.go @@ -208,6 +208,12 @@ type Account struct { // account was created against. Each service provider is assigned a unique // provider value when they onboard with Cloud Commerce platform. Provider string `json:"provider,omitempty"` + // ResellerParentBillingAccount: Output only. The reseller parent billing + // account of the account's corresponding billing account, applicable only when + // the corresponding billing account is a subaccount of a reseller. Included in + // responses only for view: ACCOUNT_VIEW_FULL. Format: + // billingAccounts/{billing_account_id} + ResellerParentBillingAccount string `json:"resellerParentBillingAccount,omitempty"` // State: Output only. The state of the account. This is used to decide whether // the customer is in good standing with the provider and is able to make // purchases. An account might not be able to make a purchase if the billing @@ -437,36 +443,36 @@ type Entitlement struct { // Name: Output only. The resource name of the entitlement. Entitlement names // have the form `providers/{provider_id}/entitlements/{entitlement_id}`. Name string `json:"name,omitempty"` - // NewOfferEndTime: Output only. The end time of the new offer. If the offer - // was has a term duration instead of a specified end date, this field is - // empty. This field is populated even if the entitlement isn't active yet. If - // there's no upcoming offer, the field is empty. * If the entitlement is in + // NewOfferEndTime: Output only. The end time of the new offer, determined from + // the offer's specified end date. If the offer des not have a specified end + // date then this field is not set. This field is populated even if the + // entitlement isn't active yet. If there's no upcoming offer, the field is + // empty. * If the entitlement is in the state // ENTITLEMENT_ACTIVATION_REQUESTED, ENTITLEMENT_ACTIVE, or - // ENTITLEMENT_PENDING_CANCELLATION state, then this field will be empty. * If - // the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or - // ENTITLEMENT_PENDING_PLAN_CHANGE state, then this field will be populated - // with the expected end time of the upcoming offer (in the future) if the - // upcoming offer has a specified end date. Otherwise, this field will be - // empty. * If the entitlement is in ENTITLEMENT_CANCELLED state, then this - // field will be empty. + // ENTITLEMENT_PENDING_CANCELLATION, then this field is empty. * If the + // entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or + // ENTITLEMENT_PENDING_PLAN_CHANGE, and the upcoming offer has a specified end + // date, then this field is populated with the expected end time of the + // upcoming offer, in the future. Otherwise, this field is empty. * If the + // entitlement is in the state ENTITLEMENT_CANCELLED, then this field is empty. NewOfferEndTime string `json:"newOfferEndTime,omitempty"` // NewOfferStartTime: Output only. The timestamp when the new offer becomes // effective. This field is populated even if the entitlement isn't active yet. // If there's no upcoming offer, the field is empty. * If the entitlement is in - // ENTITLEMENT_ACTIVATION_REQUESTED state, this field will not be populated - // when the entitlement is not yet approved. But after the entitlement is - // approved, then this field will be populated with effective time of the - // upcoming offer. * If the entitlement is in ENTITLEMENT_ACTIVE or - // ENTITLEMENT_PENDING_CANCELLATION state, this field will not be populated. * - // If the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL state, - // this field will not be populated since the entitlement change is waiting on - // approval. * If the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE state, - // this field will be populated with the expected effective time of the - // upcoming offer (in the future). * If the entitlement is in - // ENTITLEMENT_CANCELLED state, then this field will be empty. + // the state ENTITLEMENT_ACTIVATION_REQUESTED, this field isn't populated when + // the entitlement isn't yet approved. After the entitlement is approved, this + // field is populated with the effective time of the upcoming offer. * If the + // entitlement is in the state ENTITLEMENT_ACTIVE or + // ENTITLEMENT_PENDING_CANCELLATION, this field isn't populated. * If the + // entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL, this + // field isn't populated, because the entitlement change is waiting on + // approval. * If the entitlement is in the state + // ENTITLEMENT_PENDING_PLAN_CHANGE, this field is populated with the expected + // effective time of the upcoming offer, which is in the future. * If the + // entitlement is in the state ENTITLEMENT_CANCELLED, then this field is empty. NewOfferStartTime string `json:"newOfferStartTime,omitempty"` - // NewPendingOffer: Output only. The name of the offer the entitlement is - // switching to upon a pending plan change. Only exists if the pending plan + // NewPendingOffer: Output only. Upon a pending plan change, the name of the + // offer that the entitlement is switching to. Only exists if the pending plan // change is moving to an offer. This field isn't populated for entitlements // which aren't active yet. Format: // 'projects/{project}/services/{service}/privateOffers/{offer}' OR @@ -475,88 +481,89 @@ type Entitlement struct { // listing service of the offer. It could be either the product service that // the offer is referencing, or a generic private offer parent service. We // recommend that you don't build your integration to rely on the meaning of - // this {service} part. * If the entitlement is in + // this {service} part. * If the entitlement is in the state // ENTITLEMENT_ACTIVATION_REQUESTED, ENTITLEMENT_ACTIVE or - // ENTITLEMENT_PENDING_CANCELLATION state, then this field will be empty. * If - // the entitlement is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or - // ENTITLEMENT_PENDING_PLAN_CHANGE state, then this field will be populated - // with the upcoming offer. * If the entitlement is in ENTITLEMENT_CANCELLED - // state, then this will be empty. + // ENTITLEMENT_PENDING_CANCELLATION, then this field is empty. * If the + // entitlement is in the state ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or + // ENTITLEMENT_PENDING_PLAN_CHANGE, then this field is populated with the + // upcoming offer. * If the entitlement is in the state ENTITLEMENT_CANCELLED, + // then this is empty. NewPendingOffer string `json:"newPendingOffer,omitempty"` // NewPendingOfferDuration: Output only. The duration of the new offer, in ISO - // 8601 duration format. This field isn't populated for entitlements which - // aren't active yet, only for pending offer changes. If the offer was has a + // 8601 duration format. This field is populated for pending offer changes. It + // isn't populated for entitlements which aren't active yet. If the offer has a // specified end date instead of a duration, this field is empty. * If the - // entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED, - // ENTITLEENTITLEMENT_ACTIVE, or ENTITLEMENT_PENDING_CANCELLATION state, then - // this field is empty. * If the entitlement is in - // ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE - // state, then this field will be populated with the duration of the upcoming - // offer, if the upcoming offer is does not have a specified end date. - // Otherwise, this field will be empty. * If the entitlement is in - // ENTITLEMENT_CANCELLED state, then this field will be empty. + // entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, + // ENTITLEMENT_ACTIVE, or ENTITLEMENT_PENDING_CANCELLATION, this field is + // empty. * If the entitlement is in the state + // ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE, + // and the upcoming offer doesn't have a specified end date, then this field is + // populated with the duration of the upcoming offer. Otherwise, this field is + // empty. * If the entitlement is in the state ENTITLEMENT_CANCELLED, then this + // field is empty. NewPendingOfferDuration string `json:"newPendingOfferDuration,omitempty"` // NewPendingPlan: Output only. The identifier of the pending new plan. // Required if the product has plans and the entitlement has a pending plan // change. NewPendingPlan string `json:"newPendingPlan,omitempty"` // Offer: Output only. The name of the offer that was procured. Field is empty - // if order was not made using an offer. Format: + // if order wasn't made using an offer. Format: // 'projects/{project}/services/{service}/privateOffers/{offer}' OR // 'projects/{project}/services/{service}/standardOffers/{offer}', depending on // whether the offer is private or public. The {service} in the name is the // listing service of the offer. It could be either the product service that // the offer is referencing, or a generic private offer parent service. We // recommend that you don't build your integration to rely on the meaning of - // this {service} part. * If the entitlement is in - // ENTITLEMENT_ACTIVATION_REQUESTED state, this field will be populated with - // the upcoming offer. * If the entitlement is in ENTITLEMENT_ACTIVE, + // this {service} part. * If the entitlement is in the state + // ENTITLEMENT_ACTIVATION_REQUESTED, this field is populated with the upcoming + // offer. * If the entitlement is in the state ENTITLEMENT_ACTIVE, // ENTITLEMENT_PENDING_CANCELLATION, ENTITLEMENT_PENDING_PLAN_CHANGE, or - // ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL state, this field will be populated - // with the current offer. * If the entitlement is in ENTITLEMENT_CANCELLED - // state, then this field will be populated with the latest offer the order was + // ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL, this field is populated with the + // current offer. * If the entitlement is in the state ENTITLEMENT_CANCELLED, + // then this field is populated with the latest offer that the order was // associated with. Offer string `json:"offer,omitempty"` - // OfferDuration: Output only. The offer duration of the current offer in ISO - // 8601 duration format. Field is empty if entitlement was not made using an - // offer. If the offer has a specified end date instead of a duration, this - // field is empty. * If the entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED - // state, then this field will be populated with the duration of the upcoming - // offer, if the upcoming offer does not have a specified end date. Otherwise, - // this field will be empty. * If the entitlement is in ENTITLEMENT_ACTIVE, + // OfferDuration: Output only. The offer duration of the current offer, in ISO + // 8601 duration format. This is empty if the entitlement wasn't made using an + // offer, or if the offer has a specified end date instead of a duration. * If + // the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, and the + // upcoming offer doesn't have a specified end date, then this field is + // populated with the duration of the upcoming offer. Otherwise, this field is + // empty. * If the entitlement is in the state ENTITLEMENT_ACTIVE, // ENTITLEMENT_PENDING_CANCELLATION, ENTITLEMENT_PENDING_PLAN_CHANGE, or - // ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL state, then this field will be - // populated with the duration of the current offer if the current offer is - // does not have a specific end date. Otherwise, this field will be empty. * If - // the entitlement is in ENTITLEMENT_CANCELLED state, then this field will be - // populated with the duration of the latest offer the order was associated - // with if that offer does not have a specific end date. Otherwise, this field - // will be empty. + // ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL, and the current offer doesn't have + // a specified end date, then this field contains the duration of the current + // offer. Otherwise, this field is empty. * If the entitlement is in the state + // ENTITLEMENT_CANCELLED, and the offer doesn't have a specified end date, then + // this field is populated with the duration of the latest offer that the order + // was associated with. Otherwise, this field is empty. OfferDuration string `json:"offerDuration,omitempty"` - // OfferEndTime: Output only. End time for the Offer associated with this - // entitlement. Note that this field value can change over time. This occurs - // naturally even if the offer is not changed, due to auto renewal. * If the - // entitlement is in ENTITLEMENT_ACTIVATION_REQUESTED state, then: * If the - // entitlement is not yet approved, then this field will be populated with the - // expected end time of the upcoming offer (in the future) if the upcoming - // offer has a specified end date. Otherwise this field will be empty. * If the - // entitlement is approved, then this field will always be populated with the - // expected end time of the upcoming offer (in the future). This means both - // this field, and the offer_duration field, can co-exist. * If the entitlement - // is in ENTITLEMENT_ACTIVE or ENTITLEMENT_PENDING_CANCELLATION state, then - // this field will be populated with the actual expected end time of the - // current offer (in the futre). Meaning, this field will be set, regardless of - // whether the offer has a specific end date or a duration. This means both - // this field, and the offer_duration field, can co-exist. * If the entitlement - // is in ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or - // ENTITLEMENT_PENDING_PLAN_CHANGE state: * If the current offer has already - // ended and became pure PAYG, then this field reflects the ACTUAL end time of - // the current offer (in the past). * Otherwise, then this is the EXPECTED end - // date of the current offer (in the future). * If the entitlement is in - // ENTITLEMENT_CANCELLED state, then this field will be populated with the - // ACTUAL end time of the latest offer the order was associated with (in the - // past). If the entitlement was cancelled before any offer started, then this - // field will be empty. + // OfferEndTime: Output only. End time for the current term of the Offer + // associated with this entitlement. The value of this field can change + // naturally over time due to auto-renewal, even if the offer isn't changed. * + // If the entitlement is in the state ENTITLEMENT_ACTIVATION_REQUESTED, then: * + // If the entitlement isn't approved yet approved, and the offer has a + // specified end date, then this field is populated with the expected end time + // of the upcoming offer, in the future. Otherwise, this field is empty. * If + // the entitlement is approved, then this field is populated with the expected + // end time of the upcoming offer, in the future. This means that this field + // and the field offer_duration can both exist. * If the entitlement is in the + // state ENTITLEMENT_ACTIVE or ENTITLEMENT_PENDING_CANCELLATION, then this + // field is populated with the expected end time of the current offer, in the + // future. This field's value is set regardless of whether the offer has a + // specific end date or a duration. This means that this field and the field + // offer_duration can both exist. * If the entitlement is in the state + // ENTITLEMENT_PENDING_PLAN_CHANGE_APPROVAL or ENTITLEMENT_PENDING_PLAN_CHANGE: + // * If the entitlement's pricing model is usage based and the associated offer + // is a private offer whose term has ended, then this field reflects the ACTUAL + // end time of the entitlement's associated offer (in the past), even though + // the entitlement associated with this private offer does not terminate at the + // end of that private offer's term. * Otherwise, this is the expected end date + // of the current offer, in the future. * If the entitlement is in the state + // ENTITLEMENT_CANCELLED, then this field is populated with the end time, in + // the past, of the latest offer that the order was associated with. If the + // entitlement was cancelled before any offer started, then this field is + // empty. OfferEndTime string `json:"offerEndTime,omitempty"` // OrderId: Output only. The order ID of this entitlement, without any // `orders/` resource name prefix. @@ -586,16 +593,15 @@ type Entitlement struct { // only set to this value when the entitlement is first created and has not // been initialized. // "ENTITLEMENT_ACTIVATION_REQUESTED" - Indicates that the entitlement has - // been created but has not yet become active. The entitlement will remain in + // been created, but it hasn't yet become active. The entitlement remains in // this state until it becomes active. If the entitlement requires provider // approval, a notification is sent to the provider for the activation - // approval. If the provider does not approve, the entitlement is removed. If + // approval. If the provider doesn't approve, the entitlement is removed. If // approved, the entitlement transitions to the - // EntitlementState.ENTITLEMENT_ACTIVE state after a delay, either a generally - // short processing delay or, if applicable, until the scheduled start time of - // the purchased offer. Plan changes are not allowed in this state. Instead, - // customers are expected to cancel the corresponding order and place a new - // order. + // EntitlementState.ENTITLEMENT_ACTIVE state after either a short processing + // delay or, if applicable, at the scheduled start time of the purchased offer. + // Plan changes aren't allowed in this state. Instead, customers are expected + // to cancel the corresponding order and place a new order. // "ENTITLEMENT_ACTIVE" - Indicates that the entitlement is active. The // procured item is now usable and any associated billing events will start // occurring. Entitlements in this state WILL renew. The analogous state for an @@ -956,6 +962,30 @@ func (r *ProvidersAccountsService) Get(name string) *ProvidersAccountsGetCall { return c } +// View sets the optional parameter "view": What information to include in the +// response. +// +// Possible values: +// +// "ACCOUNT_VIEW_UNSPECIFIED" - The default / unset value. For `GetAccount`, +// +// it defaults to the FULL view. For `ListAccounts`, it only supports BASIC +// view. +// +// "ACCOUNT_VIEW_BASIC" - Include base account information. This is the +// +// default view. All fields from Account are included except for the +// reseller_parent_billing_account field. +// +// "ACCOUNT_VIEW_FULL" - Includes all available account information, +// +// inclusive of the accounts reseller_parent_billing_account, if it's a resold +// account. +func (c *ProvidersAccountsGetCall) View(view string) *ProvidersAccountsGetCall { + c.urlParams_.Set("view", view) + 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/clouddeploy/v1/clouddeploy-api.json b/clouddeploy/v1/clouddeploy-api.json index 2dc512f72fc..d5633ac9622 100644 --- a/clouddeploy/v1/clouddeploy-api.json +++ b/clouddeploy/v1/clouddeploy-api.json @@ -169,7 +169,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -2354,7 +2354,7 @@ } } }, - "revision": "20250813", + "revision": "20250910", "rootUrl": "https://clouddeploy.googleapis.com/", "schemas": { "AbandonReleaseRequest": { diff --git a/clouddeploy/v1/clouddeploy-gen.go b/clouddeploy/v1/clouddeploy-gen.go index bd33bcd8fbd..e3a08d495df 100644 --- a/clouddeploy/v1/clouddeploy-gen.go +++ b/clouddeploy/v1/clouddeploy-gen.go @@ -6220,9 +6220,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/cloudidentity/v1beta1/cloudidentity-api.json b/cloudidentity/v1beta1/cloudidentity-api.json index d1a125964d8..42f7afc3325 100644 --- a/cloudidentity/v1beta1/cloudidentity-api.json +++ b/cloudidentity/v1beta1/cloudidentity-api.json @@ -680,7 +680,7 @@ ] }, "lookup": { - "description": "Looks up resource names of the DeviceUsers associated with the caller's credentials, as well as the properties provided in the request. This method must be called with end-user credentials with the scope: https://www.googleapis.com/auth/cloud-identity.devices.lookup If multiple properties are provided, only DeviceUsers having all of these properties are considered as matches - i.e. the query behaves like an AND. Different platforms require different amounts of information from the caller to ensure that the DeviceUser is uniquely identified. - iOS: No properties need to be passed, the caller's credentials are sufficient to identify the corresponding DeviceUser. - Android: Specifying the 'android_id' field is required. - Desktop: Specifying the 'raw_resource_id' field is required.", + "description": "Looks up resource names of the DeviceUsers associated with the caller's credentials, as well as the properties provided in the request. This method must be called with end-user credentials with the scope: https://www.googleapis.com/auth/cloud-identity.devices.lookup If multiple properties are provided, only DeviceUsers having all of these properties are considered as matches - i.e. the query behaves like an AND. Different platforms require different amounts of information from the caller to ensure that the DeviceUser is uniquely identified. - iOS: Specifying the 'partner' and 'ios_device_id' fields is required. - Android: Specifying the 'android_id' field is required. - Desktop: Specifying the 'raw_resource_id' field is required.", "flatPath": "v1beta1/devices/{devicesId}/deviceUsers:lookup", "httpMethod": "GET", "id": "cloudidentity.devices.deviceUsers.lookup", @@ -693,6 +693,11 @@ "location": "query", "type": "string" }, + "iosDeviceId": { + "description": "Optional. The partner-specified device identifier assigned to the iOS device that initiated the Lookup API call. This string must match the value of the iosDeviceId key in the app config dictionary provided to Google Workspace apps.", + "location": "query", + "type": "string" + }, "pageSize": { "description": "The maximum number of DeviceUsers to return. If unspecified, at most 20 DeviceUsers will be returned. The maximum value is 20; values above 20 will be coerced to 20.", "format": "int32", @@ -711,6 +716,11 @@ "required": true, "type": "string" }, + "partner": { + "description": "Optional. The partner ID of the calling iOS app. This string must match the value of the partner key within the app configuration dictionary provided to Google Workspace apps.", + "location": "query", + "type": "string" + }, "rawResourceId": { "description": "Raw Resource Id used by Google Endpoint Verification. If the user is enrolled into Google Endpoint Verification, this id will be saved as the 'device_resource_id' field in the following platform dependent files. Mac: ~/.secureConnect/context_aware_config.json Windows: C:\\Users\\%USERPROFILE%\\.secureConnect\\context_aware_config.json Linux: ~/.secureConnect/context_aware_config.json", "location": "query", @@ -2268,7 +2278,7 @@ } } }, - "revision": "20250805", + "revision": "20250916", "rootUrl": "https://cloudidentity.googleapis.com/", "schemas": { "AddIdpCredentialOperationMetadata": { diff --git a/cloudidentity/v1beta1/cloudidentity-gen.go b/cloudidentity/v1beta1/cloudidentity-gen.go index 76caa8a991e..746f35d93d8 100644 --- a/cloudidentity/v1beta1/cloudidentity-gen.go +++ b/cloudidentity/v1beta1/cloudidentity-gen.go @@ -6654,10 +6654,10 @@ type DevicesDeviceUsersLookupCall struct { // properties are provided, only DeviceUsers having all of these properties are // considered as matches - i.e. the query behaves like an AND. Different // platforms require different amounts of information from the caller to ensure -// that the DeviceUser is uniquely identified. - iOS: No properties need to be -// passed, the caller's credentials are sufficient to identify the -// corresponding DeviceUser. - Android: Specifying the 'android_id' field is -// required. - Desktop: Specifying the 'raw_resource_id' field is required. +// that the DeviceUser is uniquely identified. - iOS: Specifying the 'partner' +// and 'ios_device_id' fields is required. - Android: Specifying the +// 'android_id' field is required. - Desktop: Specifying the 'raw_resource_id' +// field is required. // // - parent: Must be set to "devices/-/deviceUsers" to search across all // DeviceUser belonging to the user. @@ -6675,6 +6675,15 @@ func (c *DevicesDeviceUsersLookupCall) AndroidId(androidId string) *DevicesDevic return c } +// IosDeviceId sets the optional parameter "iosDeviceId": The partner-specified +// device identifier assigned to the iOS device that initiated the Lookup API +// call. This string must match the value of the iosDeviceId key in the app +// config dictionary provided to Google Workspace apps. +func (c *DevicesDeviceUsersLookupCall) IosDeviceId(iosDeviceId string) *DevicesDeviceUsersLookupCall { + c.urlParams_.Set("iosDeviceId", iosDeviceId) + return c +} + // PageSize sets the optional parameter "pageSize": The maximum number of // DeviceUsers to return. If unspecified, at most 20 DeviceUsers will be // returned. The maximum value is 20; values above 20 will be coerced to 20. @@ -6692,6 +6701,14 @@ func (c *DevicesDeviceUsersLookupCall) PageToken(pageToken string) *DevicesDevic return c } +// Partner sets the optional parameter "partner": The partner ID of the calling +// iOS app. This string must match the value of the partner key within the app +// configuration dictionary provided to Google Workspace apps. +func (c *DevicesDeviceUsersLookupCall) Partner(partner string) *DevicesDeviceUsersLookupCall { + c.urlParams_.Set("partner", partner) + return c +} + // RawResourceId sets the optional parameter "rawResourceId": Raw Resource Id // used by Google Endpoint Verification. If the user is enrolled into Google // Endpoint Verification, this id will be saved as the 'device_resource_id' diff --git a/cloudkms/v1/cloudkms-api.json b/cloudkms/v1/cloudkms-api.json index e526019d78c..b33a6305608 100644 --- a/cloudkms/v1/cloudkms-api.json +++ b/cloudkms/v1/cloudkms-api.json @@ -203,7 +203,7 @@ "folders": { "methods": { "getAutokeyConfig": { - "description": "Returns the AutokeyConfig for a folder.", + "description": "Returns the AutokeyConfig for a folder or project.", "flatPath": "v1/folders/{foldersId}/autokeyConfig", "httpMethod": "GET", "id": "cloudkms.folders.getAutokeyConfig", @@ -212,7 +212,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the AutokeyConfig resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig`.", + "description": "Required. Name of the AutokeyConfig resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig` or `projects/{PROJECT_NUMBER}/autokeyConfig`.", "location": "path", "pattern": "^folders/[^/]+/autokeyConfig$", "required": true, @@ -393,6 +393,32 @@ }, "projects": { "methods": { + "getAutokeyConfig": { + "description": "Returns the AutokeyConfig for a folder or project.", + "flatPath": "v1/projects/{projectsId}/autokeyConfig", + "httpMethod": "GET", + "id": "cloudkms.projects.getAutokeyConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the AutokeyConfig resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig` or `projects/{PROJECT_NUMBER}/autokeyConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/autokeyConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "AutokeyConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloudkms" + ] + }, "getKajPolicyConfig": { "description": "Gets the KeyAccessJustificationsPolicyConfig for a given organization/folder/projects.", "flatPath": "v1/projects/{projectsId}/kajPolicyConfig", @@ -497,6 +523,41 @@ "https://www.googleapis.com/auth/cloudkms" ] }, + "updateAutokeyConfig": { + "description": "Updates the AutokeyConfig for a folder. The caller must have both `cloudkms.autokeyConfigs.update` permission on the parent folder and `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key project. A KeyHandle creation in the folder's descendant projects will use this configuration to determine where to create the resulting CryptoKey.", + "flatPath": "v1/projects/{projectsId}/autokeyConfig", + "httpMethod": "PATCH", + "id": "cloudkms.projects.updateAutokeyConfig", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Name of the AutokeyConfig resource, e.g. `folders/{FOLDER_NUMBER}/autokeyConfig` `projects/{PROJECT_NUMBER}/autokeyConfig`.", + "location": "path", + "pattern": "^projects/[^/]+/autokeyConfig$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Masks which fields of the AutokeyConfig to update, e.g. `keyProject`.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "AutokeyConfig" + }, + "response": { + "$ref": "AutokeyConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloudkms" + ] + }, "updateKajPolicyConfig": { "description": "Updates the KeyAccessJustificationsPolicyConfig for a given organization/folder/projects.", "flatPath": "v1/projects/{projectsId}/kajPolicyConfig", @@ -627,7 +688,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -2435,7 +2496,7 @@ } } }, - "revision": "20250818", + "revision": "20250911", "rootUrl": "https://cloudkms.googleapis.com/", "schemas": { "AsymmetricDecryptRequest": { diff --git a/cloudkms/v1/cloudkms-gen.go b/cloudkms/v1/cloudkms-gen.go index 1ad3a36615e..a6fdacdb242 100644 --- a/cloudkms/v1/cloudkms-gen.go +++ b/cloudkms/v1/cloudkms-gen.go @@ -3776,10 +3776,11 @@ type FoldersGetAutokeyConfigCall struct { header_ http.Header } -// GetAutokeyConfig: Returns the AutokeyConfig for a folder. +// GetAutokeyConfig: Returns the AutokeyConfig for a folder or project. // // - name: Name of the AutokeyConfig resource, e.g. -// `folders/{FOLDER_NUMBER}/autokeyConfig`. +// `folders/{FOLDER_NUMBER}/autokeyConfig` or +// `projects/{PROJECT_NUMBER}/autokeyConfig`. func (r *FoldersService) GetAutokeyConfig(name string) *FoldersGetAutokeyConfigCall { c := &FoldersGetAutokeyConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -4443,6 +4444,117 @@ func (c *OrganizationsUpdateKajPolicyConfigCall) Do(opts ...googleapi.CallOption return ret, nil } +type ProjectsGetAutokeyConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetAutokeyConfig: Returns the AutokeyConfig for a folder or project. +// +// - name: Name of the AutokeyConfig resource, e.g. +// `folders/{FOLDER_NUMBER}/autokeyConfig` or +// `projects/{PROJECT_NUMBER}/autokeyConfig`. +func (r *ProjectsService) GetAutokeyConfig(name string) *ProjectsGetAutokeyConfigCall { + c := &ProjectsGetAutokeyConfigCall{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 *ProjectsGetAutokeyConfigCall) Fields(s ...googleapi.Field) *ProjectsGetAutokeyConfigCall { + 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 *ProjectsGetAutokeyConfigCall) IfNoneMatch(entityTag string) *ProjectsGetAutokeyConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsGetAutokeyConfigCall) Context(ctx context.Context) *ProjectsGetAutokeyConfigCall { + 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 *ProjectsGetAutokeyConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsGetAutokeyConfigCall) 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", "cloudkms.projects.getAutokeyConfig", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudkms.projects.getAutokeyConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *AutokeyConfig.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 *ProjectsGetAutokeyConfigCall) Do(opts ...googleapi.CallOption) (*AutokeyConfig, 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 := &AutokeyConfig{ + 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", "cloudkms.projects.getAutokeyConfig", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsGetKajPolicyConfigCall struct { s *Service name string @@ -4893,6 +5005,122 @@ func (c *ProjectsShowEffectiveKeyAccessJustificationsPolicyConfigCall) Do(opts . return ret, nil } +type ProjectsUpdateAutokeyConfigCall struct { + s *Service + name string + autokeyconfig *AutokeyConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UpdateAutokeyConfig: Updates the AutokeyConfig for a folder. The caller must +// have both `cloudkms.autokeyConfigs.update` permission on the parent folder +// and `cloudkms.cryptoKeys.setIamPolicy` permission on the provided key +// project. A KeyHandle creation in the folder's descendant projects will use +// this configuration to determine where to create the resulting CryptoKey. +// +// - name: Identifier. Name of the AutokeyConfig resource, e.g. +// `folders/{FOLDER_NUMBER}/autokeyConfig` +// `projects/{PROJECT_NUMBER}/autokeyConfig`. +func (r *ProjectsService) UpdateAutokeyConfig(name string, autokeyconfig *AutokeyConfig) *ProjectsUpdateAutokeyConfigCall { + c := &ProjectsUpdateAutokeyConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.autokeyconfig = autokeyconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. Masks which +// fields of the AutokeyConfig to update, e.g. `keyProject`. +func (c *ProjectsUpdateAutokeyConfigCall) UpdateMask(updateMask string) *ProjectsUpdateAutokeyConfigCall { + 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 *ProjectsUpdateAutokeyConfigCall) Fields(s ...googleapi.Field) *ProjectsUpdateAutokeyConfigCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsUpdateAutokeyConfigCall) Context(ctx context.Context) *ProjectsUpdateAutokeyConfigCall { + 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 *ProjectsUpdateAutokeyConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsUpdateAutokeyConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.autokeyconfig) + 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", "cloudkms.projects.updateAutokeyConfig", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudkms.projects.updateAutokeyConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *AutokeyConfig.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 *ProjectsUpdateAutokeyConfigCall) Do(opts ...googleapi.CallOption) (*AutokeyConfig, 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 := &AutokeyConfig{ + 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", "cloudkms.projects.updateAutokeyConfig", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsUpdateKajPolicyConfigCall struct { s *Service name string @@ -5350,9 +5578,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/cloudscheduler/v1/cloudscheduler-api.json b/cloudscheduler/v1/cloudscheduler-api.json index cb7aecb3d40..b6cb0d8d581 100644 --- a/cloudscheduler/v1/cloudscheduler-api.json +++ b/cloudscheduler/v1/cloudscheduler-api.json @@ -105,117 +105,6 @@ }, "protocol": "rest", "resources": { - "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/operations/{operationsId}:cancel", - "httpMethod": "POST", - "id": "cloudscheduler.operations.cancel", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "The name of the operation resource to be cancelled.", - "location": "path", - "pattern": "^operations/.*$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}:cancel", - "request": { - "$ref": "CancelOperationRequest" - }, - "response": { - "$ref": "Empty" - } - }, - "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/operations/{operationsId}", - "httpMethod": "DELETE", - "id": "cloudscheduler.operations.delete", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "The name of the operation resource to be deleted.", - "location": "path", - "pattern": "^operations/.*$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "Empty" - } - }, - "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/operations/{operationsId}", - "httpMethod": "GET", - "id": "cloudscheduler.operations.get", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "The name of the operation resource.", - "location": "path", - "pattern": "^operations/.*$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "Operation" - } - }, - "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/operations", - "httpMethod": "GET", - "id": "cloudscheduler.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": "^operations$", - "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}", - "response": { - "$ref": "ListOperationsResponse" - } - } - } - }, "projects": { "resources": { "locations": { @@ -255,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -529,13 +418,136 @@ ] } } + }, + "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": "cloudscheduler.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": "cloudscheduler.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": "cloudscheduler.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": "cloudscheduler.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": "20250530", + "revision": "20250917", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { diff --git a/cloudscheduler/v1/cloudscheduler-gen.go b/cloudscheduler/v1/cloudscheduler-gen.go index 31dce52a4db..b7435b13666 100644 --- a/cloudscheduler/v1/cloudscheduler-gen.go +++ b/cloudscheduler/v1/cloudscheduler-gen.go @@ -119,7 +119,6 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err return nil, err } s := &Service{client: client, BasePath: basePath, logger: internaloption.GetLogger(opts)} - s.Operations = NewOperationsService(s) s.Projects = NewProjectsService(s) if endpoint != "" { s.BasePath = endpoint @@ -145,8 +144,6 @@ type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment - Operations *OperationsService - Projects *ProjectsService } @@ -157,15 +154,6 @@ func (s *Service) userAgent() string { return googleapi.UserAgent + " " + s.UserAgent } -func NewOperationsService(s *Service) *OperationsService { - rs := &OperationsService{s: s} - return rs -} - -type OperationsService struct { - s *Service -} - func NewProjectsService(s *Service) *ProjectsService { rs := &ProjectsService{s: s} rs.Locations = NewProjectsLocationsService(s) @@ -181,6 +169,7 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} rs.Jobs = NewProjectsLocationsJobsService(s) + rs.Operations = NewProjectsLocationsOperationsService(s) return rs } @@ -188,6 +177,8 @@ type ProjectsLocationsService struct { s *Service Jobs *ProjectsLocationsJobsService + + Operations *ProjectsLocationsOperationsService } func NewProjectsLocationsJobsService(s *Service) *ProjectsLocationsJobsService { @@ -199,6 +190,15 @@ type ProjectsLocationsJobsService struct { s *Service } +func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { + rs := &ProjectsLocationsOperationsService{s: s} + return rs +} + +type ProjectsLocationsOperationsService struct { + s *Service +} + // AppEngineHttpTarget: App Engine target. The job will be pushed to a job // handler by means of an HTTP request via an http_method such as HTTP POST, // HTTP GET, etc. The job is acknowledged by means of an HTTP response code in @@ -1011,67 +1011,65 @@ func (s Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -type OperationsCancelCall struct { - s *Service - name string - canceloperationrequest *CancelOperationRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + 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`. +// Get: Gets information about a location. // -// - name: The name of the operation resource to be cancelled. -func (r *OperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OperationsCancelCall { - c := &OperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 - 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 *OperationsCancelCall) Fields(s ...googleapi.Field) *OperationsCancelCall { +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 *OperationsCancelCall) Context(ctx context.Context) *OperationsCancelCall { +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 *OperationsCancelCall) Header() http.Header { +func (c *ProjectsLocationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OperationsCancelCall) 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 +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}:cancel") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -1079,16 +1077,16 @@ func (c *OperationsCancelCall) doRequest(alt string) (*http.Response, error) { googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.operations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.operations.cancel" call. +// Do executes the "cloudscheduler.projects.locations.get" 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 +// *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 *OperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) { +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 { @@ -1107,7 +1105,7 @@ func (c *OperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &Location{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1118,60 +1116,101 @@ func (c *OperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, error) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.operations.cancel", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type OperationsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + 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`. +// List: Lists information about the supported locations for this service. // -// - name: The name of the operation resource to be deleted. -func (r *OperationsService) Delete(name string) *OperationsDeleteCall { - c := &OperationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 } +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. +func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { + c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) + 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 *OperationsDeleteCall) Fields(s ...googleapi.Field) *OperationsDeleteCall { +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 *OperationsDeleteCall) Context(ctx context.Context) *OperationsDeleteCall { +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 *OperationsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OperationsDeleteCall) doRequest(alt string) (*http.Response, error) { +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}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/locations") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -1179,16 +1218,17 @@ func (c *OperationsDeleteCall) doRequest(alt string) (*http.Response, error) { googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.operations.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.operations.delete" call. +// Do executes the "cloudscheduler.projects.locations.list" 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 *OperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { +// *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 { @@ -1207,7 +1247,7 @@ func (c *OperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &ListLocationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1218,88 +1258,102 @@ func (c *OperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.operations.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type OperationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +// 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) + } } -// 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. +type ProjectsLocationsJobsCreateCall struct { + s *Service + parent string + job *Job + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a job. // -// - name: The name of the operation resource. -func (r *OperationsService) Get(name string) *OperationsGetCall { - c := &OperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The location name. For example: +// `projects/PROJECT_ID/locations/LOCATION_ID`. +func (r *ProjectsLocationsJobsService) Create(parent string, job *Job) *ProjectsLocationsJobsCreateCall { + c := &ProjectsLocationsJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.job = job 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 *OperationsGetCall) Fields(s ...googleapi.Field) *OperationsGetCall { +func (c *ProjectsLocationsJobsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsCreateCall { 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 *OperationsGetCall) IfNoneMatch(entityTag string) *OperationsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *OperationsGetCall) Context(ctx context.Context) *OperationsGetCall { +func (c *ProjectsLocationsJobsCreateCall) Context(ctx context.Context) *ProjectsLocationsJobsCreateCall { 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 *OperationsGetCall) Header() http.Header { +func (c *ProjectsLocationsJobsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OperationsGetCall) 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 *ProjectsLocationsJobsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.job) + 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 := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/jobs") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + 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, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.operations.get" call. +// Do executes the "cloudscheduler.projects.locations.jobs.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 +// *Job.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 *OperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) { +func (c *ProjectsLocationsJobsCreateCall) Do(opts ...googleapi.CallOption) (*Job, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1318,7 +1372,7 @@ func (c *OperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Operation{ + ret := &Job{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1329,90 +1383,58 @@ func (c *OperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type OperationsListCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsJobsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + 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`. +// Delete: Deletes a job. // -// - name: The name of the operation's parent resource. -func (r *OperationsService) List(name string) *OperationsListCall { - c := &OperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The job name. For example: +// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. +func (r *ProjectsLocationsJobsService) Delete(name string) *ProjectsLocationsJobsDeleteCall { + c := &ProjectsLocationsJobsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Filter sets the optional parameter "filter": The standard list filter. -func (c *OperationsListCall) Filter(filter string) *OperationsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": The standard list page -// size. -func (c *OperationsListCall) PageSize(pageSize int64) *OperationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": The standard list page -// token. -func (c *OperationsListCall) PageToken(pageToken string) *OperationsListCall { - 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 *OperationsListCall) Fields(s ...googleapi.Field) *OperationsListCall { +func (c *ProjectsLocationsJobsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsDeleteCall { 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 *OperationsListCall) IfNoneMatch(entityTag string) *OperationsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *OperationsListCall) Context(ctx context.Context) *OperationsListCall { +func (c *ProjectsLocationsJobsDeleteCall) Context(ctx context.Context) *ProjectsLocationsJobsDeleteCall { 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 *OperationsListCall) Header() http.Header { +func (c *ProjectsLocationsJobsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OperationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsJobsDeleteCall) 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) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -1420,17 +1442,16 @@ func (c *OperationsListCall) doRequest(alt string) (*http.Response, error) { googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.operations.list" call. +// Do executes the "cloudscheduler.projects.locations.jobs.delete" 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 *OperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, error) { +// *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 *ProjectsLocationsJobsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1449,7 +1470,7 @@ func (c *OperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsRe if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListOperationsResponse{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1460,32 +1481,11 @@ func (c *OperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsRe if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.delete", "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 *OperationsListCall) 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) - } -} - -type ProjectsLocationsGetCall struct { +type ProjectsLocationsJobsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -1494,11 +1494,12 @@ type ProjectsLocationsGetCall struct { header_ http.Header } -// Get: Gets information about a location. +// Get: Gets a job. // -// - name: Resource name for the location. -func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { - c := &ProjectsLocationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The job name. For example: +// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. +func (r *ProjectsLocationsJobsService) Get(name string) *ProjectsLocationsJobsGetCall { + c := &ProjectsLocationsJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -1506,7 +1507,7 @@ func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { // 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 { +func (c *ProjectsLocationsJobsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -1514,27 +1515,27 @@ func (c *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocatio // 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 { +func (c *ProjectsLocationsJobsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsJobsGetCall { 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 { +func (c *ProjectsLocationsJobsGetCall) Context(ctx context.Context) *ProjectsLocationsJobsGetCall { 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 { +func (c *ProjectsLocationsJobsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsJobsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -1551,16 +1552,16 @@ func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.get" call. +// Do executes the "cloudscheduler.projects.locations.jobs.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 +// *Job.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) { +func (c *ProjectsLocationsJobsGetCall) Do(opts ...googleapi.CallOption) (*Job, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1579,7 +1580,7 @@ func (c *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Location{ + ret := &Job{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1590,56 +1591,44 @@ func (c *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsListCall struct { +type ProjectsLocationsJobsListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists information about the supported locations for this service. +// List: Lists jobs. // -// - 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 -} - -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": A list -// of extra location types that should be used as conditions for controlling -// the visibility of the locations. -func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { - c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) - 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) +// - parent: The location name. For example: +// `projects/PROJECT_ID/locations/LOCATION_ID`. +func (r *ProjectsLocationsJobsService) List(parent string) *ProjectsLocationsJobsListCall { + c := &ProjectsLocationsJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent 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 { +// PageSize sets the optional parameter "pageSize": Requested page size. The +// maximum page size is 500. If unspecified, the page size will be the maximum. +// Fewer jobs than requested might be returned, even if more jobs exist; use +// next_page_token to determine if more jobs exist. +func (c *ProjectsLocationsJobsListCall) PageSize(pageSize int64) *ProjectsLocationsJobsListCall { 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 { +// PageToken sets the optional parameter "pageToken": A token identifying a +// page of results the server will return. To request the first page results, +// page_token must be empty. To request the next page of results, page_token +// must be the value of next_page_token returned from the previous call to +// ListJobs. +func (c *ProjectsLocationsJobsListCall) PageToken(pageToken string) *ProjectsLocationsJobsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -1647,7 +1636,7 @@ func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocatio // 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 { +func (c *ProjectsLocationsJobsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -1655,34 +1644,34 @@ func (c *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocati // 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 { +func (c *ProjectsLocationsJobsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsJobsListCall { 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 { +func (c *ProjectsLocationsJobsListCall) Context(ctx context.Context) *ProjectsLocationsJobsListCall { 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 { +func (c *ProjectsLocationsJobsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsJobsListCall) 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 := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/jobs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -1690,19 +1679,19 @@ func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.list" call. +// Do executes the "cloudscheduler.projects.locations.jobs.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 +// *ListJobsResponse.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) { +func (c *ProjectsLocationsJobsListCall) Do(opts ...googleapi.CallOption) (*ListJobsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1721,7 +1710,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListLocationsResponse{ + ret := &ListJobsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1732,14 +1721,14 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocat if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.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 { +func (c *ProjectsLocationsJobsListCall) Pages(ctx context.Context, f func(*ListJobsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -1757,50 +1746,70 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat } } -type ProjectsLocationsJobsCreateCall struct { +type ProjectsLocationsJobsPatchCall struct { s *Service - parent string + name string job *Job urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } -// Create: Creates a job. +// Patch: Updates a job. If successful, the updated Job is returned. If the job +// does not exist, `NOT_FOUND` is returned. If UpdateJob does not successfully +// return, it is possible for the job to be in an Job.State.UPDATE_FAILED +// state. A job in this state may not be executed. If this happens, retry the +// UpdateJob request until a successful response is received. // -// - parent: The location name. For example: -// `projects/PROJECT_ID/locations/LOCATION_ID`. -func (r *ProjectsLocationsJobsService) Create(parent string, job *Job) *ProjectsLocationsJobsCreateCall { - c := &ProjectsLocationsJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent +// - name: Optionally caller-specified in CreateJob, after which it becomes +// output only. The job name. For example: +// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. * `PROJECT_ID` +// can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), +// or periods (.). For more information, see Identifying projects +// (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) +// - `LOCATION_ID` is the canonical ID for the job's location. The list of +// available locations can be obtained by calling ListLocations. For more +// information, see https://cloud.google.com/about/locations/. * `JOB_ID` can +// contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or +// underscores (_). The maximum length is 500 characters. +func (r *ProjectsLocationsJobsService) Patch(name string, job *Job) *ProjectsLocationsJobsPatchCall { + c := &ProjectsLocationsJobsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name c.job = job return c } +// UpdateMask sets the optional parameter "updateMask": A mask used to specify +// which fields of the job are being updated. +func (c *ProjectsLocationsJobsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsJobsPatchCall { + 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 *ProjectsLocationsJobsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsCreateCall { +func (c *ProjectsLocationsJobsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsJobsCreateCall) Context(ctx context.Context) *ProjectsLocationsJobsCreateCall { +func (c *ProjectsLocationsJobsPatchCall) Context(ctx context.Context) *ProjectsLocationsJobsPatchCall { 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 *ProjectsLocationsJobsCreateCall) Header() http.Header { +func (c *ProjectsLocationsJobsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsJobsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsJobsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.job) if err != nil { @@ -1808,26 +1817,26 @@ func (c *ProjectsLocationsJobsCreateCall) doRequest(alt string) (*http.Response, } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/jobs") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.jobs.create" call. +// Do executes the "cloudscheduler.projects.locations.jobs.patch" call. // Any non-2xx status code is an error. Response headers are in either // *Job.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 *ProjectsLocationsJobsCreateCall) Do(opts ...googleapi.CallOption) (*Job, error) { +func (c *ProjectsLocationsJobsPatchCall) Do(opts ...googleapi.CallOption) (*Job, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1857,58 +1866,67 @@ func (c *ProjectsLocationsJobsCreateCall) Do(opts ...googleapi.CallOption) (*Job if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsJobsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsJobsPauseCall struct { + s *Service + name string + pausejobrequest *PauseJobRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a job. +// Pause: Pauses a job. If a job is paused then the system will stop executing +// the job until it is re-enabled via ResumeJob. The state of the job is stored +// in state; if paused it will be set to Job.State.PAUSED. A job must be in +// Job.State.ENABLED to be paused. // // - name: The job name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. -func (r *ProjectsLocationsJobsService) Delete(name string) *ProjectsLocationsJobsDeleteCall { - c := &ProjectsLocationsJobsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsJobsService) Pause(name string, pausejobrequest *PauseJobRequest) *ProjectsLocationsJobsPauseCall { + c := &ProjectsLocationsJobsPauseCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.pausejobrequest = pausejobrequest 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 *ProjectsLocationsJobsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsDeleteCall { +func (c *ProjectsLocationsJobsPauseCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsPauseCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsJobsDeleteCall) Context(ctx context.Context) *ProjectsLocationsJobsDeleteCall { +func (c *ProjectsLocationsJobsPauseCall) Context(ctx context.Context) *ProjectsLocationsJobsPauseCall { 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 *ProjectsLocationsJobsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsJobsPauseCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsJobsDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) +func (c *ProjectsLocationsJobsPauseCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.pausejobrequest) + 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 := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:pause") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -1916,16 +1934,16 @@ func (c *ProjectsLocationsJobsDeleteCall) doRequest(alt string) (*http.Response, googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.pause", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.jobs.delete" call. +// Do executes the "cloudscheduler.projects.locations.jobs.pause" 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 +// *Job.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 *ProjectsLocationsJobsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { +func (c *ProjectsLocationsJobsPauseCall) Do(opts ...googleapi.CallOption) (*Job, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -1944,7 +1962,7 @@ func (c *ProjectsLocationsJobsDeleteCall) Do(opts ...googleapi.CallOption) (*Emp if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &Job{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -1955,70 +1973,67 @@ func (c *ProjectsLocationsJobsDeleteCall) Do(opts ...googleapi.CallOption) (*Emp if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.pause", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsJobsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsJobsResumeCall struct { + s *Service + name string + resumejobrequest *ResumeJobRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Get: Gets a job. +// Resume: Resume a job. This method reenables a job after it has been +// Job.State.PAUSED. The state of a job is stored in Job.state; after calling +// this method it will be set to Job.State.ENABLED. A job must be in +// Job.State.PAUSED to be resumed. // // - name: The job name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. -func (r *ProjectsLocationsJobsService) Get(name string) *ProjectsLocationsJobsGetCall { - c := &ProjectsLocationsJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsJobsService) Resume(name string, resumejobrequest *ResumeJobRequest) *ProjectsLocationsJobsResumeCall { + c := &ProjectsLocationsJobsResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.resumejobrequest = resumejobrequest 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 *ProjectsLocationsJobsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsGetCall { +func (c *ProjectsLocationsJobsResumeCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsResumeCall { 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 *ProjectsLocationsJobsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsJobsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsJobsGetCall) Context(ctx context.Context) *ProjectsLocationsJobsGetCall { +func (c *ProjectsLocationsJobsResumeCall) Context(ctx context.Context) *ProjectsLocationsJobsResumeCall { 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 *ProjectsLocationsJobsGetCall) Header() http.Header { +func (c *ProjectsLocationsJobsResumeCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsJobsGetCall) 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 *ProjectsLocationsJobsResumeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.resumejobrequest) + 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 := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:resume") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -2026,16 +2041,16 @@ func (c *ProjectsLocationsJobsGetCall) doRequest(alt string) (*http.Response, er googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.resume", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.jobs.get" call. +// Do executes the "cloudscheduler.projects.locations.jobs.resume" call. // Any non-2xx status code is an error. Response headers are in either // *Job.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 *ProjectsLocationsJobsGetCall) Do(opts ...googleapi.CallOption) (*Job, error) { +func (c *ProjectsLocationsJobsResumeCall) Do(opts ...googleapi.CallOption) (*Job, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -2065,107 +2080,82 @@ func (c *ProjectsLocationsJobsGetCall) Do(opts ...googleapi.CallOption) (*Job, e if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.resume", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsJobsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsJobsRunCall struct { + s *Service + name string + runjobrequest *RunJobRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists jobs. +// Run: Forces a job to run now. When this method is called, Cloud Scheduler +// will dispatch the job, even if the job is already running. // -// - parent: The location name. For example: -// `projects/PROJECT_ID/locations/LOCATION_ID`. -func (r *ProjectsLocationsJobsService) List(parent string) *ProjectsLocationsJobsListCall { - c := &ProjectsLocationsJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// PageSize sets the optional parameter "pageSize": Requested page size. The -// maximum page size is 500. If unspecified, the page size will be the maximum. -// Fewer jobs than requested might be returned, even if more jobs exist; use -// next_page_token to determine if more jobs exist. -func (c *ProjectsLocationsJobsListCall) PageSize(pageSize int64) *ProjectsLocationsJobsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": A token identifying a -// page of results the server will return. To request the first page results, -// page_token must be empty. To request the next page of results, page_token -// must be the value of next_page_token returned from the previous call to -// ListJobs. -func (c *ProjectsLocationsJobsListCall) PageToken(pageToken string) *ProjectsLocationsJobsListCall { - c.urlParams_.Set("pageToken", pageToken) +// - name: The job name. For example: +// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. +func (r *ProjectsLocationsJobsService) Run(name string, runjobrequest *RunJobRequest) *ProjectsLocationsJobsRunCall { + c := &ProjectsLocationsJobsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.runjobrequest = runjobrequest 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 *ProjectsLocationsJobsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsListCall { +func (c *ProjectsLocationsJobsRunCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsRunCall { 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 *ProjectsLocationsJobsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsJobsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsJobsListCall) Context(ctx context.Context) *ProjectsLocationsJobsListCall { +func (c *ProjectsLocationsJobsRunCall) Context(ctx context.Context) *ProjectsLocationsJobsRunCall { 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 *ProjectsLocationsJobsListCall) Header() http.Header { +func (c *ProjectsLocationsJobsRunCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsJobsListCall) 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 *ProjectsLocationsJobsRunCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.runjobrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/jobs") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:run") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + 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, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.run", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.jobs.list" call. +// Do executes the "cloudscheduler.projects.locations.jobs.run" call. // Any non-2xx status code is an error. Response headers are in either -// *ListJobsResponse.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 *ProjectsLocationsJobsListCall) Do(opts ...googleapi.CallOption) (*ListJobsResponse, error) { +// *Job.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 *ProjectsLocationsJobsRunCall) Do(opts ...googleapi.CallOption) (*Job, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -2184,7 +2174,7 @@ func (c *ProjectsLocationsJobsListCall) Do(opts ...googleapi.CallOption) (*ListJ if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListJobsResponse{ + ret := &Job{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -2195,105 +2185,71 @@ func (c *ProjectsLocationsJobsListCall) Do(opts ...googleapi.CallOption) (*ListJ if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.run", "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 *ProjectsLocationsJobsListCall) Pages(ctx context.Context, f func(*ListJobsResponse) 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 ProjectsLocationsJobsPatchCall struct { - s *Service - name string - job *Job - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Updates a job. If successful, the updated Job is returned. If the job -// does not exist, `NOT_FOUND` is returned. If UpdateJob does not successfully -// return, it is possible for the job to be in an Job.State.UPDATE_FAILED -// state. A job in this state may not be executed. If this happens, retry the -// UpdateJob request until a successful response is received. +// 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: Optionally caller-specified in CreateJob, after which it becomes -// output only. The job name. For example: -// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. * `PROJECT_ID` -// can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), -// or periods (.). For more information, see Identifying projects -// (https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) -// - `LOCATION_ID` is the canonical ID for the job's location. The list of -// available locations can be obtained by calling ListLocations. For more -// information, see https://cloud.google.com/about/locations/. * `JOB_ID` can -// contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or -// underscores (_). The maximum length is 500 characters. -func (r *ProjectsLocationsJobsService) Patch(name string, job *Job) *ProjectsLocationsJobsPatchCall { - c := &ProjectsLocationsJobsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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.job = job - return c -} - -// UpdateMask sets the optional parameter "updateMask": A mask used to specify -// which fields of the job are being updated. -func (c *ProjectsLocationsJobsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsJobsPatchCall { - c.urlParams_.Set("updateMask", updateMask) + 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 *ProjectsLocationsJobsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsPatchCall { +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 *ProjectsLocationsJobsPatchCall) Context(ctx context.Context) *ProjectsLocationsJobsPatchCall { +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 *ProjectsLocationsJobsPatchCall) Header() http.Header { +func (c *ProjectsLocationsOperationsCancelCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsJobsPatchCall) doRequest(alt string) (*http.Response, error) { +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.job) + 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}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:cancel") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -2301,16 +2257,16 @@ func (c *ProjectsLocationsJobsPatchCall) doRequest(alt string) (*http.Response, googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.operations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.jobs.patch" call. +// Do executes the "cloudscheduler.projects.locations.operations.cancel" call. // Any non-2xx status code is an error. Response headers are in either -// *Job.ServerResponse.Header or (if a response was returned at all) in +// *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 *ProjectsLocationsJobsPatchCall) Do(opts ...googleapi.CallOption) (*Job, error) { +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 { @@ -2329,7 +2285,7 @@ func (c *ProjectsLocationsJobsPatchCall) Do(opts ...googleapi.CallOption) (*Job, if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Job{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -2340,67 +2296,60 @@ func (c *ProjectsLocationsJobsPatchCall) Do(opts ...googleapi.CallOption) (*Job, if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.operations.cancel", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsJobsPauseCall struct { - s *Service - name string - pausejobrequest *PauseJobRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsOperationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Pause: Pauses a job. If a job is paused then the system will stop executing -// the job until it is re-enabled via ResumeJob. The state of the job is stored -// in state; if paused it will be set to Job.State.PAUSED. A job must be in -// Job.State.ENABLED to be paused. +// 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 job name. For example: -// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. -func (r *ProjectsLocationsJobsService) Pause(name string, pausejobrequest *PauseJobRequest) *ProjectsLocationsJobsPauseCall { - c := &ProjectsLocationsJobsPauseCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 - c.pausejobrequest = pausejobrequest 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 *ProjectsLocationsJobsPauseCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsPauseCall { +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 *ProjectsLocationsJobsPauseCall) Context(ctx context.Context) *ProjectsLocationsJobsPauseCall { +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 *ProjectsLocationsJobsPauseCall) Header() http.Header { +func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsJobsPauseCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.pausejobrequest) - if err != nil { - return nil, err - } +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}:pause") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -2408,16 +2357,16 @@ func (c *ProjectsLocationsJobsPauseCall) doRequest(alt string) (*http.Response, googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.pause", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.operations.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.jobs.pause" call. +// Do executes the "cloudscheduler.projects.locations.operations.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *Job.ServerResponse.Header or (if a response was returned at all) in +// *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 *ProjectsLocationsJobsPauseCall) Do(opts ...googleapi.CallOption) (*Job, error) { +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 { @@ -2436,7 +2385,7 @@ func (c *ProjectsLocationsJobsPauseCall) Do(opts ...googleapi.CallOption) (*Job, if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Job{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -2447,67 +2396,71 @@ func (c *ProjectsLocationsJobsPauseCall) Do(opts ...googleapi.CallOption) (*Job, if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.pause", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.operations.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsJobsResumeCall struct { - s *Service - name string - resumejobrequest *ResumeJobRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Resume: Resume a job. This method reenables a job after it has been -// Job.State.PAUSED. The state of a job is stored in Job.state; after calling -// this method it will be set to Job.State.ENABLED. A job must be in -// Job.State.PAUSED to be resumed. +// 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 job name. For example: -// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. -func (r *ProjectsLocationsJobsService) Resume(name string, resumejobrequest *ResumeJobRequest) *ProjectsLocationsJobsResumeCall { - c := &ProjectsLocationsJobsResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 - c.resumejobrequest = resumejobrequest 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 *ProjectsLocationsJobsResumeCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsResumeCall { +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 *ProjectsLocationsJobsResumeCall) Context(ctx context.Context) *ProjectsLocationsJobsResumeCall { +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 *ProjectsLocationsJobsResumeCall) Header() http.Header { +func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsJobsResumeCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.resumejobrequest) - if err != nil { - return nil, err +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}:resume") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -2515,16 +2468,16 @@ func (c *ProjectsLocationsJobsResumeCall) doRequest(alt string) (*http.Response, googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.resume", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.jobs.resume" call. +// Do executes the "cloudscheduler.projects.locations.operations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *Job.ServerResponse.Header or (if a response was returned at all) in +// *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 *ProjectsLocationsJobsResumeCall) Do(opts ...googleapi.CallOption) (*Job, error) { +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 { @@ -2543,7 +2496,7 @@ func (c *ProjectsLocationsJobsResumeCall) Do(opts ...googleapi.CallOption) (*Job if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Job{ + ret := &Operation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -2554,65 +2507,90 @@ func (c *ProjectsLocationsJobsResumeCall) Do(opts ...googleapi.CallOption) (*Job if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.resume", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.operations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsJobsRunCall struct { - s *Service - name string - runjobrequest *RunJobRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Run: Forces a job to run now. When this method is called, Cloud Scheduler -// will dispatch the job, even if the job is already running. +// List: Lists operations that match the specified filter in the request. If +// the server doesn't support this method, it returns `UNIMPLEMENTED`. // -// - name: The job name. For example: -// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. -func (r *ProjectsLocationsJobsService) Run(name string, runjobrequest *RunJobRequest) *ProjectsLocationsJobsRunCall { - c := &ProjectsLocationsJobsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 - c.runjobrequest = runjobrequest + 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 *ProjectsLocationsJobsRunCall) Fields(s ...googleapi.Field) *ProjectsLocationsJobsRunCall { +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 *ProjectsLocationsJobsRunCall) Context(ctx context.Context) *ProjectsLocationsJobsRunCall { +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 *ProjectsLocationsJobsRunCall) Header() http.Header { +func (c *ProjectsLocationsOperationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsJobsRunCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.runjobrequest) - if err != nil { - return nil, err +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}:run") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/operations") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -2620,16 +2598,17 @@ func (c *ProjectsLocationsJobsRunCall) doRequest(alt string) (*http.Response, er googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.run", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "cloudscheduler.projects.locations.jobs.run" call. +// Do executes the "cloudscheduler.projects.locations.operations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *Job.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 *ProjectsLocationsJobsRunCall) Do(opts ...googleapi.CallOption) (*Job, error) { +// *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 { @@ -2648,7 +2627,7 @@ func (c *ProjectsLocationsJobsRunCall) Do(opts ...googleapi.CallOption) (*Job, e if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Job{ + ret := &ListOperationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -2659,6 +2638,27 @@ func (c *ProjectsLocationsJobsRunCall) Do(opts ...googleapi.CallOption) (*Job, e if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.projects.locations.jobs.run", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "cloudscheduler.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/cloudscheduler/v1beta1/cloudscheduler-api.json b/cloudscheduler/v1beta1/cloudscheduler-api.json index 96abc811db7..d7772501f72 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-api.json +++ b/cloudscheduler/v1beta1/cloudscheduler-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -439,7 +439,7 @@ } } }, - "revision": "20250530", + "revision": "20250917", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { diff --git a/cloudscheduler/v1beta1/cloudscheduler-gen.go b/cloudscheduler/v1beta1/cloudscheduler-gen.go index ec240befc57..2e5d47d53a8 100644 --- a/cloudscheduler/v1beta1/cloudscheduler-gen.go +++ b/cloudscheduler/v1beta1/cloudscheduler-gen.go @@ -1073,9 +1073,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": A list -// of extra location types that should be used as conditions for controlling -// the visibility of the locations. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/cloudtasks/v2/cloudtasks-api.json b/cloudtasks/v2/cloudtasks-api.json index 976b1c5a23e..3bf3c646a7e 100644 --- a/cloudtasks/v2/cloudtasks-api.json +++ b/cloudtasks/v2/cloudtasks-api.json @@ -169,7 +169,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -658,7 +658,7 @@ ] }, "get": { - "description": "Gets a task.", + "description": "Gets a task. After a task is successfully executed or has exhausted its retry attempts, the task is deleted. A `GetTask` request for a deleted task returns a `NOT_FOUND` error.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}/tasks/{tasksId}", "httpMethod": "GET", "id": "cloudtasks.projects.locations.queues.tasks.get", @@ -785,7 +785,7 @@ } } }, - "revision": "20250411", + "revision": "20250914", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpRequest": { @@ -968,7 +968,7 @@ }, "task": { "$ref": "Task", - "description": "Required. The task to add. Task names have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. The user can optionally specify a task name. If a name is not specified then the system will generate a random unique task id, which will be set in the task returned in the response. If schedule_time is not set or is in the past then Cloud Tasks will set it to the current time. Task De-duplication: Explicitly specifying a task ID enables task de-duplication. If a task's ID is identical to that of an existing task or a task that was deleted or executed recently then the call will fail with ALREADY_EXISTS. The IDs of deleted tasks are not immediately available for reuse. It can take up to 4 hours (or 9 days if the task's queue was created using a queue.yaml or queue.xml) for the task ID to be released and made available again. Because there is an extra lookup cost to identify duplicate task names, these CreateTask calls have significantly increased latency. Using hashed strings for the task id or for the prefix of the task id is recommended. Choosing task ids that are sequential or have sequential prefixes, for example using a timestamp, causes an increase in latency and error rates in all task commands. The infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently." + "description": "Required. The task to add. Task names have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. The user can optionally specify a task name. If a name is not specified then the system will generate a random unique task id, which will be set in the task returned in the response. If schedule_time is not set or is in the past then Cloud Tasks will set it to the current time. Task De-duplication: Explicitly specifying a task ID enables task de-duplication. If a task's ID is identical to that of an existing task or a task that was deleted or executed recently then the call will fail with ALREADY_EXISTS. The IDs of deleted tasks are not immediately available for reuse. It can take up to 24 hours (or 9 days if the task's queue was created using a queue.yaml or queue.xml) for the task ID to be released and made available again. Because there is an extra lookup cost to identify duplicate task names, these CreateTask calls have significantly increased latency. Using hashed strings for the task id or for the prefix of the task id is recommended. Choosing task ids that are sequential or have sequential prefixes, for example using a timestamp, causes an increase in latency and error rates in all task commands. The infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently." } }, "type": "object" @@ -1649,7 +1649,7 @@ "description": "URI path. When specified, replaces the existing path of the task URL. Setting the path value to an empty string clears the URI path segment." }, "port": { - "description": "Port override. When specified, replaces the port part of the task URI. For instance, for a URI http://www.google.com/foo and port=123, the overridden URI becomes http://www.google.com:123/foo. Note that the port value must be a positive integer. Setting the port to 0 (Zero) clears the URI port.", + "description": "Port override. When specified, replaces the port part of the task URI. For instance, for a URI \"https://www.example.com/example\" and port=123, the overridden URI becomes \"https://www.example.com:123/example\". Note that the port value must be a positive integer. Setting the port to 0 (Zero) clears the URI port.", "format": "int64", "type": "string" }, @@ -1666,8 +1666,8 @@ ], "enumDescriptions": [ "Scheme unspecified. Defaults to HTTPS.", - "Convert the scheme to HTTP, e.g., https://www.google.ca will change to http://www.google.ca.", - "Convert the scheme to HTTPS, e.g., http://www.google.ca will change to https://www.google.ca." + "Convert the scheme to HTTP, e.g., \"https://www.example.com\" will change to \"http://www.example.com\".", + "Convert the scheme to HTTPS, e.g., \"http://www.example.com\" will change to \"https://www.example.com\"." ], "type": "string" }, diff --git a/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index f371e600b5c..6803aabfc9a 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -623,7 +623,7 @@ type CreateTaskRequest struct { // Explicitly specifying a task ID enables task de-duplication. If a task's ID // is identical to that of an existing task or a task that was deleted or // executed recently then the call will fail with ALREADY_EXISTS. The IDs of - // deleted tasks are not immediately available for reuse. It can take up to 4 + // deleted tasks are not immediately available for reuse. It can take up to 24 // hours (or 9 days if the task's queue was created using a queue.yaml or // queue.xml) for the task ID to be released and made available again. Because // there is an extra lookup cost to identify duplicate task names, these @@ -1920,10 +1920,10 @@ type UriOverride struct { // segment. PathOverride *PathOverride `json:"pathOverride,omitempty"` // Port: Port override. When specified, replaces the port part of the task URI. - // For instance, for a URI http://www.google.com/foo and port=123, the - // overridden URI becomes http://www.google.com:123/foo. Note that the port - // value must be a positive integer. Setting the port to 0 (Zero) clears the - // URI port. + // For instance, for a URI "https://www.example.com/example" and port=123, the + // overridden URI becomes "https://www.example.com:123/example". Note that the + // port value must be a positive integer. Setting the port to 0 (Zero) clears + // the URI port. Port int64 `json:"port,omitempty,string"` // QueryOverride: URI query. When specified, replaces the query part of the // task URI. Setting the query value to an empty string clears the URI query @@ -1934,10 +1934,10 @@ type UriOverride struct { // // Possible values: // "SCHEME_UNSPECIFIED" - Scheme unspecified. Defaults to HTTPS. - // "HTTP" - Convert the scheme to HTTP, e.g., https://www.google.ca will - // change to http://www.google.ca. - // "HTTPS" - Convert the scheme to HTTPS, e.g., http://www.google.ca will - // change to https://www.google.ca. + // "HTTP" - Convert the scheme to HTTP, e.g., "https://www.example.com" will + // change to "http://www.example.com". + // "HTTPS" - Convert the scheme to HTTPS, e.g., "http://www.example.com" will + // change to "https://www.example.com". Scheme string `json:"scheme,omitempty"` // UriOverrideEnforceMode: URI Override Enforce Mode When specified, determines // the Target UriOverride mode. If not specified, it defaults to ALWAYS. @@ -2207,9 +2207,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": A list -// of extra location types that should be used as conditions for controlling -// the visibility of the locations. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c @@ -4076,7 +4076,9 @@ type ProjectsLocationsQueuesTasksGetCall struct { header_ http.Header } -// Get: Gets a task. +// Get: Gets a task. After a task is successfully executed or has exhausted its +// retry attempts, the task is deleted. A `GetTask` request for a deleted task +// returns a `NOT_FOUND` error. // // - name: The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. diff --git a/cloudtasks/v2beta2/cloudtasks-api.json b/cloudtasks/v2beta2/cloudtasks-api.json index 15553eb7031..36af8c6cebd 100644 --- a/cloudtasks/v2beta2/cloudtasks-api.json +++ b/cloudtasks/v2beta2/cloudtasks-api.json @@ -201,7 +201,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -941,7 +941,7 @@ } } }, - "revision": "20250411", + "revision": "20250914", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AcknowledgeTaskRequest": { @@ -1173,7 +1173,7 @@ }, "task": { "$ref": "Task", - "description": "Required. The task to add. Task names have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. The user can optionally specify a task name. If a name is not specified then the system will generate a random unique task id, which will be set in the task returned in the response. If schedule_time is not set or is in the past then Cloud Tasks will set it to the current time. Task De-duplication: Explicitly specifying a task ID enables task de-duplication. If a task's ID is identical to that of an existing task or a task that was deleted or completed recently then the call will fail with ALREADY_EXISTS. The IDs of deleted tasks are not immediately available for reuse. It can take up to 4 hours (or 9 days if the task's queue was created using a queue.yaml or queue.xml) for the task ID to be released and made available again. Because there is an extra lookup cost to identify duplicate task names, these CreateTask calls have significantly increased latency. Using hashed strings for the task id or for the prefix of the task id is recommended. Choosing task ids that are sequential or have sequential prefixes, for example using a timestamp, causes an increase in latency and error rates in all task commands. The infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently." + "description": "Required. The task to add. Task names have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. The user can optionally specify a task name. If a name is not specified then the system will generate a random unique task id, which will be set in the task returned in the response. If schedule_time is not set or is in the past then Cloud Tasks will set it to the current time. Task De-duplication: Explicitly specifying a task ID enables task de-duplication. If a task's ID is identical to that of an existing task or a task that was deleted or completed recently then the call will fail with ALREADY_EXISTS. The IDs of deleted tasks are not immediately available for reuse. It can take up to 24 hours (or 9 days if the task's queue was created using a queue.yaml or queue.xml) for the task ID to be released and made available again. Because there is an extra lookup cost to identify duplicate task names, these CreateTask calls have significantly increased latency. Using hashed strings for the task id or for the prefix of the task id is recommended. Choosing task ids that are sequential or have sequential prefixes, for example using a timestamp, causes an increase in latency and error rates in all task commands. The infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently." } }, "type": "object" @@ -2010,7 +2010,7 @@ "description": "URI path. When specified, replaces the existing path of the task URL. Setting the path value to an empty string clears the URI path segment." }, "port": { - "description": "Port override. When specified, replaces the port part of the task URI. For instance, for a URI http://www.google.com/foo and port=123, the overridden URI becomes http://www.google.com:123/foo. Note that the port value must be a positive integer. Setting the port to 0 (Zero) clears the URI port.", + "description": "Port override. When specified, replaces the port part of the task URI. For instance, for a URI \"https://www.example.com/example\" and port=123, the overridden URI becomes \"https://www.example.com:123/example\". Note that the port value must be a positive integer. Setting the port to 0 (Zero) clears the URI port.", "format": "int64", "type": "string" }, @@ -2027,8 +2027,8 @@ ], "enumDescriptions": [ "Scheme unspecified. Defaults to HTTPS.", - "Convert the scheme to HTTP, e.g., https://www.google.ca will change to http://www.google.ca.", - "Convert the scheme to HTTPS, e.g., http://www.google.ca will change to https://www.google.ca." + "Convert the scheme to HTTP, e.g., \"https://www.example.com\" will change to \"http://www.example.com\".", + "Convert the scheme to HTTPS, e.g., \"http://www.example.com\" will change to \"https://www.example.com\"." ], "type": "string" }, diff --git a/cloudtasks/v2beta2/cloudtasks-gen.go b/cloudtasks/v2beta2/cloudtasks-gen.go index 1e9e766c744..8fb5262e0e3 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -762,7 +762,7 @@ type CreateTaskRequest struct { // Explicitly specifying a task ID enables task de-duplication. If a task's ID // is identical to that of an existing task or a task that was deleted or // completed recently then the call will fail with ALREADY_EXISTS. The IDs of - // deleted tasks are not immediately available for reuse. It can take up to 4 + // deleted tasks are not immediately available for reuse. It can take up to 24 // hours (or 9 days if the task's queue was created using a queue.yaml or // queue.xml) for the task ID to be released and made available again. Because // there is an extra lookup cost to identify duplicate task names, these @@ -2250,10 +2250,10 @@ type UriOverride struct { // segment. PathOverride *PathOverride `json:"pathOverride,omitempty"` // Port: Port override. When specified, replaces the port part of the task URI. - // For instance, for a URI http://www.google.com/foo and port=123, the - // overridden URI becomes http://www.google.com:123/foo. Note that the port - // value must be a positive integer. Setting the port to 0 (Zero) clears the - // URI port. + // For instance, for a URI "https://www.example.com/example" and port=123, the + // overridden URI becomes "https://www.example.com:123/example". Note that the + // port value must be a positive integer. Setting the port to 0 (Zero) clears + // the URI port. Port int64 `json:"port,omitempty,string"` // QueryOverride: URI Query. When specified, replaces the query part of the // task URI. Setting the query value to an empty string clears the URI query @@ -2264,10 +2264,10 @@ type UriOverride struct { // // Possible values: // "SCHEME_UNSPECIFIED" - Scheme unspecified. Defaults to HTTPS. - // "HTTP" - Convert the scheme to HTTP, e.g., https://www.google.ca will - // change to http://www.google.ca. - // "HTTPS" - Convert the scheme to HTTPS, e.g., http://www.google.ca will - // change to https://www.google.ca. + // "HTTP" - Convert the scheme to HTTP, e.g., "https://www.example.com" will + // change to "http://www.example.com". + // "HTTPS" - Convert the scheme to HTTPS, e.g., "http://www.example.com" will + // change to "https://www.example.com". Scheme string `json:"scheme,omitempty"` // UriOverrideEnforceMode: URI Override Enforce Mode When specified, determines // the Target UriOverride mode. If not specified, it defaults to ALWAYS. @@ -2645,9 +2645,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": A list -// of extra location types that should be used as conditions for controlling -// the visibility of the locations. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/cloudtasks/v2beta3/cloudtasks-api.json b/cloudtasks/v2beta3/cloudtasks-api.json index d071562a903..87cf12632ce 100644 --- a/cloudtasks/v2beta3/cloudtasks-api.json +++ b/cloudtasks/v2beta3/cloudtasks-api.json @@ -169,7 +169,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -670,7 +670,7 @@ ] }, "get": { - "description": "Gets a task.", + "description": "Gets a task. After a task is successfully executed or has exhausted its retry attempts, the task is deleted. A `GetTask` request for a deleted task returns a `NOT_FOUND` error.", "flatPath": "v2beta3/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}/tasks/{tasksId}", "httpMethod": "GET", "id": "cloudtasks.projects.locations.queues.tasks.get", @@ -797,7 +797,7 @@ } } }, - "revision": "20250411", + "revision": "20250914", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpQueue": { @@ -991,7 +991,7 @@ }, "task": { "$ref": "Task", - "description": "Required. The task to add. Task names have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. The user can optionally specify a task name. If a name is not specified then the system will generate a random unique task id, which will be set in the task returned in the response. If schedule_time is not set or is in the past then Cloud Tasks will set it to the current time. Task De-duplication: Explicitly specifying a task ID enables task de-duplication. If a task's ID is identical to that of an existing task or a task that was deleted or executed recently then the call will fail with ALREADY_EXISTS. The IDs of deleted tasks are not immediately available for reuse. It can take up to 4 hours (or 9 days if the task's queue was created using a queue.yaml or queue.xml) for the task ID to be released and made available again. Because there is an extra lookup cost to identify duplicate task names, these CreateTask calls have significantly increased latency. Using hashed strings for the task id or for the prefix of the task id is recommended. Choosing task ids that are sequential or have sequential prefixes, for example using a timestamp, causes an increase in latency and error rates in all task commands. The infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently." + "description": "Required. The task to add. Task names have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. The user can optionally specify a task name. If a name is not specified then the system will generate a random unique task id, which will be set in the task returned in the response. If schedule_time is not set or is in the past then Cloud Tasks will set it to the current time. Task De-duplication: Explicitly specifying a task ID enables task de-duplication. If a task's ID is identical to that of an existing task or a task that was deleted or executed recently then the call will fail with ALREADY_EXISTS. The IDs of deleted tasks are not immediately available for reuse. It can take up to 24 hours (or 9 days if the task's queue was created using a queue.yaml or queue.xml) for the task ID to be released and made available again. Because there is an extra lookup cost to identify duplicate task names, these CreateTask calls have significantly increased latency. Using hashed strings for the task id or for the prefix of the task id is recommended. Choosing task ids that are sequential or have sequential prefixes, for example using a timestamp, causes an increase in latency and error rates in all task commands. The infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently." } }, "type": "object" @@ -1758,7 +1758,7 @@ "description": "URI path. When specified, replaces the existing path of the task URL. Setting the path value to an empty string clears the URI path segment." }, "port": { - "description": "Port override. When specified, replaces the port part of the task URI. For instance, for a URI http://www.google.com/foo and port=123, the overridden URI becomes http://www.google.com:123/foo. Note that the port value must be a positive integer. Setting the port to 0 (Zero) clears the URI port.", + "description": "Port override. When specified, replaces the port part of the task URI. For instance, for a URI \"https://www.example.com/example\" and port=123, the overridden URI becomes \"https://www.example.com:123/example\". Note that the port value must be a positive integer. Setting the port to 0 (Zero) clears the URI port.", "format": "int64", "type": "string" }, @@ -1775,8 +1775,8 @@ ], "enumDescriptions": [ "Scheme unspecified. Defaults to HTTPS.", - "Convert the scheme to HTTP, e.g., https://www.google.ca will change to http://www.google.ca.", - "Convert the scheme to HTTPS, e.g., http://www.google.ca will change to https://www.google.ca." + "Convert the scheme to HTTP, e.g., \"https://www.example.com\" will change to \"http://www.example.com\".", + "Convert the scheme to HTTPS, e.g., \"http://www.example.com\" will change to \"https://www.example.com\"." ], "type": "string" }, diff --git a/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index 3d419c1f233..357d49caa7e 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -649,7 +649,7 @@ type CreateTaskRequest struct { // Explicitly specifying a task ID enables task de-duplication. If a task's ID // is identical to that of an existing task or a task that was deleted or // executed recently then the call will fail with ALREADY_EXISTS. The IDs of - // deleted tasks are not immediately available for reuse. It can take up to 4 + // deleted tasks are not immediately available for reuse. It can take up to 24 // hours (or 9 days if the task's queue was created using a queue.yaml or // queue.xml) for the task ID to be released and made available again. Because // there is an extra lookup cost to identify duplicate task names, these @@ -2077,10 +2077,10 @@ type UriOverride struct { // segment. PathOverride *PathOverride `json:"pathOverride,omitempty"` // Port: Port override. When specified, replaces the port part of the task URI. - // For instance, for a URI http://www.google.com/foo and port=123, the - // overridden URI becomes http://www.google.com:123/foo. Note that the port - // value must be a positive integer. Setting the port to 0 (Zero) clears the - // URI port. + // For instance, for a URI "https://www.example.com/example" and port=123, the + // overridden URI becomes "https://www.example.com:123/example". Note that the + // port value must be a positive integer. Setting the port to 0 (Zero) clears + // the URI port. Port int64 `json:"port,omitempty,string"` // QueryOverride: URI Query. When specified, replaces the query part of the // task URI. Setting the query value to an empty string clears the URI query @@ -2091,10 +2091,10 @@ type UriOverride struct { // // Possible values: // "SCHEME_UNSPECIFIED" - Scheme unspecified. Defaults to HTTPS. - // "HTTP" - Convert the scheme to HTTP, e.g., https://www.google.ca will - // change to http://www.google.ca. - // "HTTPS" - Convert the scheme to HTTPS, e.g., http://www.google.ca will - // change to https://www.google.ca. + // "HTTP" - Convert the scheme to HTTP, e.g., "https://www.example.com" will + // change to "http://www.example.com". + // "HTTPS" - Convert the scheme to HTTPS, e.g., "http://www.example.com" will + // change to "https://www.example.com". Scheme string `json:"scheme,omitempty"` // UriOverrideEnforceMode: URI Override Enforce Mode When specified, determines // the Target UriOverride mode. If not specified, it defaults to ALWAYS. @@ -2364,9 +2364,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": A list -// of extra location types that should be used as conditions for controlling -// the visibility of the locations. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c @@ -4251,7 +4251,9 @@ type ProjectsLocationsQueuesTasksGetCall struct { header_ http.Header } -// Get: Gets a task. +// Get: Gets a task. After a task is successfully executed or has exhausted its +// retry attempts, the task is deleted. A `GetTask` request for a deleted task +// returns a `NOT_FOUND` error. // // - name: The task name. For example: // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`. diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index d982c35e143..42e002ab7b4 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -21606,6 +21606,48 @@ "https://www.googleapis.com/auth/compute" ] }, + "cancelRequestRemovePeering": { + "description": "Cancel requests to remove a peering from the specified network. Applicable only for PeeringConnection with update_strategy=CONSENSUS. Cancels a request to remove a peering from the specified network.", + "flatPath": "projects/{project}/global/networks/{network}/cancelRequestRemovePeering", + "httpMethod": "POST", + "id": "compute.networks.cancelRequestRemovePeering", + "parameterOrder": [ + "project", + "network" + ], + "parameters": { + "network": { + "description": "Name of the network resource to remove peering from.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "location": "path", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "projects/{project}/global/networks/{network}/cancelRequestRemovePeering", + "request": { + "$ref": "NetworksCancelRequestRemovePeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "delete": { "description": "Deletes the specified network.", "flatPath": "projects/{project}/global/networks/{network}", @@ -24101,6 +24143,12 @@ "pattern": "(securityPolicies/)?[0-9]{0,20}", "required": true, "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" } }, "path": "locations/global/securityPolicies/{securityPolicy}", @@ -24141,6 +24189,12 @@ "pattern": "(securityPolicies/)?[0-9]{0,20}", "required": true, "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" } }, "path": "locations/global/securityPolicies/{securityPolicy}/patchRule", @@ -25024,7 +25078,8 @@ ] }, "moveDisk": { - "description": "Moves a persistent disk from one zone to another.", + "deprecated": true, + "description": "Starting September 29, 2025, you can't use the moveDisk API on new projects. To move a disk to a different region or zone, follow the steps in [Change the location of a disk](https://{$universe.dns_names.final_documentation_domain}/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). Projects that already use the moveDisk API can continue usage until September 29, 2026. Starting November 1, 2025, API responses will include a warning message in the response body about the upcoming deprecation. You can skip the message to continue using the service without interruption.", "flatPath": "projects/{project}/moveDisk", "httpMethod": "POST", "id": "compute.projects.moveDisk", @@ -52501,7 +52556,7 @@ } } }, - "revision": "20250902", + "revision": "20250909", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -87150,13 +87205,17 @@ "enum": [ "DELETE_ACKNOWLEDGED", "DELETE_STATUS_UNSPECIFIED", + "LOCAL_CANCEL_REQUESTED", "LOCAL_DELETE_REQUESTED", + "PEER_CANCEL_REQUESTED", "PEER_DELETE_REQUESTED" ], "enumDescriptions": [ "Both network admins have agreed this consensus peering connection can be deleted.", "", + "The local network admin requested to cancel their delete request after DELETE_ACKNOWLEDGED.", "Network admin has requested deletion of this peering connection.", + "The peer network admin requested to cancel their delete request after DELETE_ACKNOWLEDGED.", "The peer network admin has requested deletion of this peering connection." ], "type": "string" @@ -88755,6 +88814,16 @@ }, "type": "object" }, + "NetworksCancelRequestRemovePeeringRequest": { + "id": "NetworksCancelRequestRemovePeeringRequest", + "properties": { + "name": { + "description": "Name of the peering, which should conform to RFC1035.", + "type": "string" + } + }, + "type": "object" + }, "NetworksGetEffectiveFirewallsResponse": { "id": "NetworksGetEffectiveFirewallsResponse", "properties": { @@ -103101,6 +103170,10 @@ "description": "IPv6 address of the interface inside Google Cloud Platform.", "type": "string" }, + "linkedCustomHardware": { + "description": "The linked custom hardware resource. The URI of the custom hardware link attachment is where you will establish the BGP session from the Cloud Router. This link attachment must reside in the same subnetwork as the associated router interface.", + "type": "string" + }, "managementType": { "description": "[Output Only] The resource that configures and manages this BGP peer. - MANAGED_BY_USER is the default value and can be managed by you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted. ", "enum": [ @@ -103870,6 +103943,10 @@ "description": "IPv6 address of the local BGP interface.", "type": "string" }, + "linkedCustomHardware": { + "description": "The URI of the linked custom hardware resource, CustomHardwareLinkAttachment. This CustomHardwareLinkAttachment resource is the one that will establish the BGP session from the Cloud Router.", + "type": "string" + }, "linkedVpnTunnel": { "description": "URL of the VPN tunnel that this BGP peer controls.", "type": "string" diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 1eb1dc0302f..caeea2079da 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -41622,8 +41622,12 @@ type NetworkPeeringConnectionStatusConsensusState struct { // "DELETE_ACKNOWLEDGED" - Both network admins have agreed this consensus // peering connection can be deleted. // "DELETE_STATUS_UNSPECIFIED" + // "LOCAL_CANCEL_REQUESTED" - The local network admin requested to cancel + // their delete request after DELETE_ACKNOWLEDGED. // "LOCAL_DELETE_REQUESTED" - Network admin has requested deletion of this // peering connection. + // "PEER_CANCEL_REQUESTED" - The peer network admin requested to cancel their + // delete request after DELETE_ACKNOWLEDGED. // "PEER_DELETE_REQUESTED" - The peer network admin has requested deletion of // this peering connection. DeleteStatus string `json:"deleteStatus,omitempty"` @@ -43090,6 +43094,27 @@ func (s NetworksAddPeeringRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +type NetworksCancelRequestRemovePeeringRequest struct { + // Name: Name of the peering, which should conform to RFC1035. + Name string `json:"name,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 NetworksCancelRequestRemovePeeringRequest) MarshalJSON() ([]byte, error) { + type NoMethod NetworksCancelRequestRemovePeeringRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type NetworksGetEffectiveFirewallsResponse struct { // FirewallPolicys: [Output Only] Effective firewalls from firewall policy. It // returns Global Network Firewall Policies and Hierarchical Firewall Policies. @@ -58328,6 +58353,11 @@ type RouterBgpPeer struct { // Ipv6NexthopAddress: IPv6 address of the interface inside Google Cloud // Platform. Ipv6NexthopAddress string `json:"ipv6NexthopAddress,omitempty"` + // LinkedCustomHardware: The linked custom hardware resource. The URI of the + // custom hardware link attachment is where you will establish the BGP session + // from the Cloud Router. This link attachment must reside in the same + // subnetwork as the associated router interface. + LinkedCustomHardware string `json:"linkedCustomHardware,omitempty"` // ManagementType: [Output Only] The resource that configures and manages this // BGP peer. - MANAGED_BY_USER is the default value and can be managed by you // or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and @@ -59184,6 +59214,10 @@ type RouterStatusBgpPeerStatus struct { Ipv4NexthopAddress string `json:"ipv4NexthopAddress,omitempty"` // Ipv6NexthopAddress: IPv6 address of the local BGP interface. Ipv6NexthopAddress string `json:"ipv6NexthopAddress,omitempty"` + // LinkedCustomHardware: The URI of the linked custom hardware resource, + // CustomHardwareLinkAttachment. This CustomHardwareLinkAttachment resource is + // the one that will establish the BGP session from the Cloud Router. + LinkedCustomHardware string `json:"linkedCustomHardware,omitempty"` // LinkedVpnTunnel: URL of the VPN tunnel that this BGP peer controls. LinkedVpnTunnel string `json:"linkedVpnTunnel,omitempty"` // Md5AuthEnabled: Informs whether MD5 authentication is enabled on this BGP diff --git a/compute/v0.alpha/compute2-gen.go b/compute/v0.alpha/compute2-gen.go index 0c48a542e9b..d5f5a8f6f43 100644 --- a/compute/v0.alpha/compute2-gen.go +++ b/compute/v0.alpha/compute2-gen.go @@ -63509,6 +63509,131 @@ func (c *NetworksAddPeeringCall) Do(opts ...googleapi.CallOption) (*Operation, e return ret, nil } +type NetworksCancelRequestRemovePeeringCall struct { + s *Service + project string + network string + networkscancelrequestremovepeeringrequest *NetworksCancelRequestRemovePeeringRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// CancelRequestRemovePeering: Cancel requests to remove a peering from the +// specified network. Applicable only for PeeringConnection with +// update_strategy=CONSENSUS. Cancels a request to remove a peering from the +// specified network. +// +// - network: Name of the network resource to remove peering from. +// - project: Project ID for this request. +func (r *NetworksService) CancelRequestRemovePeering(project string, network string, networkscancelrequestremovepeeringrequest *NetworksCancelRequestRemovePeeringRequest) *NetworksCancelRequestRemovePeeringCall { + c := &NetworksCancelRequestRemovePeeringCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.network = network + c.networkscancelrequestremovepeeringrequest = networkscancelrequestremovepeeringrequest + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. For example, consider a situation where you make an initial +// request and the request times out. If you make the request again with the +// same request ID, the server can check if original operation with the same +// request ID was received, and if so, will ignore the second request. This +// prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported ( 00000000-0000-0000-0000-000000000000). +func (c *NetworksCancelRequestRemovePeeringCall) RequestId(requestId string) *NetworksCancelRequestRemovePeeringCall { + 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 *NetworksCancelRequestRemovePeeringCall) Fields(s ...googleapi.Field) *NetworksCancelRequestRemovePeeringCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *NetworksCancelRequestRemovePeeringCall) Context(ctx context.Context) *NetworksCancelRequestRemovePeeringCall { + 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 *NetworksCancelRequestRemovePeeringCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *NetworksCancelRequestRemovePeeringCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.networkscancelrequestremovepeeringrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "projects/{project}/global/networks/{network}/cancelRequestRemovePeering") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "network": c.network, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "compute.networks.cancelRequestRemovePeering", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "compute.networks.cancelRequestRemovePeering" 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 *NetworksCancelRequestRemovePeeringCall) 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", "compute.networks.cancelRequestRemovePeering", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type NetworksDeleteCall struct { s *Service project string @@ -71069,6 +71194,13 @@ func (c *OrganizationSecurityPoliciesPatchCall) RequestId(requestId string) *Org return c } +// UpdateMask sets the optional parameter "updateMask": Indicates fields to be +// cleared as part of this request. +func (c *OrganizationSecurityPoliciesPatchCall) UpdateMask(updateMask string) *OrganizationSecurityPoliciesPatchCall { + 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. @@ -71196,6 +71328,13 @@ func (c *OrganizationSecurityPoliciesPatchRuleCall) RequestId(requestId string) return c } +// UpdateMask sets the optional parameter "updateMask": Indicates fields to be +// cleared as part of this request. +func (c *OrganizationSecurityPoliciesPatchRuleCall) UpdateMask(updateMask string) *OrganizationSecurityPoliciesPatchRuleCall { + 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. @@ -74123,7 +74262,14 @@ type ProjectsMoveDiskCall struct { header_ http.Header } -// MoveDisk: Moves a persistent disk from one zone to another. +// MoveDisk: Starting September 29, 2025, you can't use the moveDisk API on new +// projects. To move a disk to a different region or zone, follow the steps in +// Change the location of a disk +// (https://{$universe.dns_names.final_documentation_domain}/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). +// Projects that already use the moveDisk API can continue usage until +// September 29, 2026. Starting November 1, 2025, API responses will include a +// warning message in the response body about the upcoming deprecation. You can +// skip the message to continue using the service without interruption. // // - project: Project ID for this request. func (r *ProjectsService) MoveDisk(project string, diskmoverequest *DiskMoveRequest) *ProjectsMoveDiskCall { diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index 8b9036ed4d1..4fc023b9ef9 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -22201,6 +22201,12 @@ "pattern": "(securityPolicies/)?[0-9]{0,20}", "required": true, "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" } }, "path": "locations/global/securityPolicies/{securityPolicy}", @@ -22241,6 +22247,12 @@ "pattern": "(securityPolicies/)?[0-9]{0,20}", "required": true, "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "format": "google-fieldmask", + "location": "query", + "type": "string" } }, "path": "locations/global/securityPolicies/{securityPolicy}/patchRule", @@ -23124,7 +23136,8 @@ ] }, "moveDisk": { - "description": "Moves a persistent disk from one zone to another.", + "deprecated": true, + "description": "Starting September 29, 2025, you can't use the moveDisk API on new projects. To move a disk to a different region or zone, follow the steps in [Change the location of a disk](https://{$universe.dns_names.final_documentation_domain}/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). Projects that already use the moveDisk API can continue usage until September 29, 2026. Starting November 1, 2025, API responses will include a warning message in the response body about the upcoming deprecation. You can skip the message to continue using the service without interruption.", "flatPath": "projects/{project}/moveDisk", "httpMethod": "POST", "id": "compute.projects.moveDisk", @@ -45753,7 +45766,7 @@ } } }, - "revision": "20250902", + "revision": "20250909", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -68795,6 +68808,13 @@ "description": "[Output Only] Server-defined URL for the resource.", "type": "string" }, + "singleRegionProductionCriticalPeerLocations": { + "description": "[Output Only] URLs of the other locations that can pair up with this location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% peer locations of each other.", + "items": { + "type": "string" + }, + "type": "array" + }, "status": { "description": "[Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. ", "enum": [ diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index bbf51440be3..99dc64e9d24 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -28453,6 +28453,11 @@ type InterconnectLocation struct { RegionInfos []*InterconnectLocationRegionInfo `json:"regionInfos,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` + // SingleRegionProductionCriticalPeerLocations: [Output Only] URLs of the other + // locations that can pair up with this location to support Single-Region + // 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% + // peer locations of each other. + SingleRegionProductionCriticalPeerLocations []string `json:"singleRegionProductionCriticalPeerLocations,omitempty"` // Status: [Output Only] The status of this InterconnectLocation, which can // take one of the following values: - CLOSED: The InterconnectLocation is // closed and is unavailable for provisioning new Interconnects. - AVAILABLE: diff --git a/compute/v0.beta/compute2-gen.go b/compute/v0.beta/compute2-gen.go index b0ecac8f7f0..19e3ad9c04a 100644 --- a/compute/v0.beta/compute2-gen.go +++ b/compute/v0.beta/compute2-gen.go @@ -65565,6 +65565,13 @@ func (c *OrganizationSecurityPoliciesPatchCall) RequestId(requestId string) *Org return c } +// UpdateMask sets the optional parameter "updateMask": Indicates fields to be +// cleared as part of this request. +func (c *OrganizationSecurityPoliciesPatchCall) UpdateMask(updateMask string) *OrganizationSecurityPoliciesPatchCall { + 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. @@ -65692,6 +65699,13 @@ func (c *OrganizationSecurityPoliciesPatchRuleCall) RequestId(requestId string) return c } +// UpdateMask sets the optional parameter "updateMask": Indicates fields to be +// cleared as part of this request. +func (c *OrganizationSecurityPoliciesPatchRuleCall) UpdateMask(updateMask string) *OrganizationSecurityPoliciesPatchRuleCall { + 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. @@ -68619,7 +68633,14 @@ type ProjectsMoveDiskCall struct { header_ http.Header } -// MoveDisk: Moves a persistent disk from one zone to another. +// MoveDisk: Starting September 29, 2025, you can't use the moveDisk API on new +// projects. To move a disk to a different region or zone, follow the steps in +// Change the location of a disk +// (https://{$universe.dns_names.final_documentation_domain}/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). +// Projects that already use the moveDisk API can continue usage until +// September 29, 2026. Starting November 1, 2025, API responses will include a +// warning message in the response body about the upcoming deprecation. You can +// skip the message to continue using the service without interruption. // // - project: Project ID for this request. func (r *ProjectsService) MoveDisk(project string, diskmoverequest *DiskMoveRequest) *ProjectsMoveDiskCall { diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index 13a805f378a..8ffb1521383 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -20558,7 +20558,8 @@ ] }, "moveDisk": { - "description": "Moves a persistent disk from one zone to another.", + "deprecated": true, + "description": "Starting September 29, 2025, you can't use the moveDisk API on new projects. To move a disk to a different region or zone, follow the steps in [Change the location of a disk](https://{$universe.dns_names.final_documentation_domain}/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). Projects that already use the moveDisk API can continue usage until September 29, 2026. Starting November 1, 2025, API responses will include a warning message in the response body about the upcoming deprecation. You can skip the message to continue using the service without interruption.", "flatPath": "projects/{project}/moveDisk", "httpMethod": "POST", "id": "compute.projects.moveDisk", @@ -35508,6 +35509,20 @@ "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", "required": true, "type": "string" + }, + "views": { + "description": "Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. ", + "enum": [ + "DEFAULT", + "WITH_UTILIZATION" + ], + "enumDescriptions": [ + "", + "Utilization data is included in the response." + ], + "location": "query", + "repeated": true, + "type": "string" } }, "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", @@ -35662,6 +35677,20 @@ "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", "location": "query", "type": "boolean" + }, + "views": { + "description": "Defines the extra views returned back in the subnetwork resource. Supported values: - WITH_UTILIZATION: Utilization data is included in the response. ", + "enum": [ + "DEFAULT", + "WITH_UTILIZATION" + ], + "enumDescriptions": [ + "", + "Utilization data is included in the response." + ], + "location": "query", + "repeated": true, + "type": "string" } }, "path": "projects/{project}/regions/{region}/subnetworks", @@ -40372,7 +40401,7 @@ } } }, - "revision": "20250902", + "revision": "20250909", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -60915,6 +60944,13 @@ "description": "[Output Only] Server-defined URL for the resource.", "type": "string" }, + "singleRegionProductionCriticalPeerLocations": { + "description": "[Output Only] URLs of the other locations that can pair up with this location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% peer locations of each other.", + "items": { + "type": "string" + }, + "type": "array" + }, "status": { "description": "[Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. ", "enum": [ @@ -61355,6 +61391,11 @@ "format": "int32", "type": "integer" }, + "maxLagSize400Gbps": { + "description": "[Output Only] The maximum number of 400 Gbps ports supported in a link aggregation group (LAG). When linkType is 400 Gbps, requestedLinkCount cannot exceed max_lag_size_400_gbps.", + "format": "int32", + "type": "integer" + }, "name": { "description": "[Output Only] Name of the resource.", "type": "string" @@ -74233,6 +74274,11 @@ "backendService": { "description": "The full or partial URL to the BackendService resource being mirrored to. The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. ", "type": "string" + }, + "mirrorPercent": { + "description": "The percentage of requests to be mirrored to `backend_service`.", + "format": "double", + "type": "number" } }, "type": "object" @@ -85168,6 +85214,11 @@ }, "readOnly": true, "type": "array" + }, + "utilizationDetails": { + "$ref": "SubnetworkUtilizationDetails", + "description": "Output only. [Output Only] The current IP utilization of all subnetwork ranges. Contains the total number of allocated and free IPs in each range.", + "readOnly": true } }, "type": "object" @@ -85583,6 +85634,64 @@ }, "type": "object" }, + "SubnetworkUtilizationDetails": { + "description": "The current IP utilization of all subnetwork ranges. Contains the total number of allocated and free IPs in each range.", + "id": "SubnetworkUtilizationDetails", + "properties": { + "externalIpv6InstanceUtilization": { + "$ref": "SubnetworkUtilizationDetailsIPV6Utilization", + "description": "Utilizations of external IPV6 IP range." + }, + "externalIpv6LbUtilization": { + "$ref": "SubnetworkUtilizationDetailsIPV6Utilization", + "description": "Utilizations of external IPV6 IP range for NetLB." + }, + "internalIpv6Utilization": { + "$ref": "SubnetworkUtilizationDetailsIPV6Utilization", + "description": "Utilizations of internal IPV6 IP range." + }, + "ipv4Utilizations": { + "description": "Utilizations of all IPV4 IP ranges. For primary ranges, the range name will be empty.", + "items": { + "$ref": "SubnetworkUtilizationDetailsIPV4Utilization" + }, + "type": "array" + } + }, + "type": "object" + }, + "SubnetworkUtilizationDetailsIPV4Utilization": { + "description": "The IPV4 utilization of a single IP range.", + "id": "SubnetworkUtilizationDetailsIPV4Utilization", + "properties": { + "rangeName": { + "description": "Will be set for secondary range. Empty for primary IPv4 range.", + "type": "string" + }, + "totalAllocatedIp": { + "format": "int64", + "type": "string" + }, + "totalFreeIp": { + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "SubnetworkUtilizationDetailsIPV6Utilization": { + "description": "The IPV6 utilization of a single IP range.", + "id": "SubnetworkUtilizationDetailsIPV6Utilization", + "properties": { + "totalAllocatedIp": { + "$ref": "Uint128" + }, + "totalFreeIp": { + "$ref": "Uint128" + } + }, + "type": "object" + }, "SubnetworksExpandIpCidrRangeRequest": { "id": "SubnetworksExpandIpCidrRangeRequest", "properties": { diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index 802dd6907f5..d00a211b8a9 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -25408,6 +25408,11 @@ type InterconnectLocation struct { RegionInfos []*InterconnectLocationRegionInfo `json:"regionInfos,omitempty"` // SelfLink: [Output Only] Server-defined URL for the resource. SelfLink string `json:"selfLink,omitempty"` + // SingleRegionProductionCriticalPeerLocations: [Output Only] URLs of the other + // locations that can pair up with this location to support Single-Region + // 99.99% SLA. E.g. iad-zone1-1 and iad-zone2-5467 are Single-Region 99.99% + // peer locations of each other. + SingleRegionProductionCriticalPeerLocations []string `json:"singleRegionProductionCriticalPeerLocations,omitempty"` // Status: [Output Only] The status of this InterconnectLocation, which can // take one of the following values: - CLOSED: The InterconnectLocation is // closed and is unavailable for provisioning new Interconnects. - AVAILABLE: @@ -25908,6 +25913,10 @@ type InterconnectRemoteLocation struct { // supported in a link aggregation group (LAG). When linkType is 10 Gbps, // requestedLinkCount cannot exceed max_lag_size_10_gbps. MaxLagSize10Gbps int64 `json:"maxLagSize10Gbps,omitempty"` + // MaxLagSize400Gbps: [Output Only] The maximum number of 400 Gbps ports + // supported in a link aggregation group (LAG). When linkType is 400 Gbps, + // requestedLinkCount cannot exceed max_lag_size_400_gbps. + MaxLagSize400Gbps int64 `json:"maxLagSize400Gbps,omitempty"` // Name: [Output Only] Name of the resource. Name string `json:"name,omitempty"` // PeeringdbFacilityId: [Output Only] The peeringdb identifier for this @@ -39644,6 +39653,9 @@ type RequestMirrorPolicy struct { // matched in the URL map. Serverless NEG backends are not currently supported // as a mirrored backend service. BackendService string `json:"backendService,omitempty"` + // MirrorPercent: The percentage of requests to be mirrored to + // `backend_service`. + MirrorPercent float64 `json:"mirrorPercent,omitempty"` // ForceSendFields is a list of field names (e.g. "BackendService") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -39662,6 +39674,20 @@ func (s RequestMirrorPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +func (s *RequestMirrorPolicy) UnmarshalJSON(data []byte) error { + type NoMethod RequestMirrorPolicy + var s1 struct { + MirrorPercent gensupport.JSONFloat64 `json:"mirrorPercent"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.MirrorPercent = float64(s1.MirrorPercent) + return nil +} + // Reservation: Represents a reservation resource. A reservation ensures that // capacity is held in a specific zone even if the reserved VMs are not // running. For more information, read Reserving zonal resources. @@ -51307,6 +51333,10 @@ type Subnetwork struct { // internal IPv6 network ranges reserved from the subnetwork's internal IPv6 // range for system use. SystemReservedInternalIpv6Ranges []string `json:"systemReservedInternalIpv6Ranges,omitempty"` + // UtilizationDetails: Output only. [Output Only] The current IP utilization of + // all subnetwork ranges. Contains the total number of allocated and free IPs + // in each range. + UtilizationDetails *SubnetworkUtilizationDetails `json:"utilizationDetails,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -51782,6 +51812,85 @@ func (s SubnetworkSecondaryRange) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// SubnetworkUtilizationDetails: The current IP utilization of all subnetwork +// ranges. Contains the total number of allocated and free IPs in each range. +type SubnetworkUtilizationDetails struct { + // ExternalIpv6InstanceUtilization: Utilizations of external IPV6 IP range. + ExternalIpv6InstanceUtilization *SubnetworkUtilizationDetailsIPV6Utilization `json:"externalIpv6InstanceUtilization,omitempty"` + // ExternalIpv6LbUtilization: Utilizations of external IPV6 IP range for NetLB. + ExternalIpv6LbUtilization *SubnetworkUtilizationDetailsIPV6Utilization `json:"externalIpv6LbUtilization,omitempty"` + // InternalIpv6Utilization: Utilizations of internal IPV6 IP range. + InternalIpv6Utilization *SubnetworkUtilizationDetailsIPV6Utilization `json:"internalIpv6Utilization,omitempty"` + // Ipv4Utilizations: Utilizations of all IPV4 IP ranges. For primary ranges, + // the range name will be empty. + Ipv4Utilizations []*SubnetworkUtilizationDetailsIPV4Utilization `json:"ipv4Utilizations,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "ExternalIpv6InstanceUtilization") 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. "ExternalIpv6InstanceUtilization") + // 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 SubnetworkUtilizationDetails) MarshalJSON() ([]byte, error) { + type NoMethod SubnetworkUtilizationDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// SubnetworkUtilizationDetailsIPV4Utilization: The IPV4 utilization of a +// single IP range. +type SubnetworkUtilizationDetailsIPV4Utilization struct { + // RangeName: Will be set for secondary range. Empty for primary IPv4 range. + RangeName string `json:"rangeName,omitempty"` + TotalAllocatedIp int64 `json:"totalAllocatedIp,omitempty,string"` + TotalFreeIp int64 `json:"totalFreeIp,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "RangeName") 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. "RangeName") 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 SubnetworkUtilizationDetailsIPV4Utilization) MarshalJSON() ([]byte, error) { + type NoMethod SubnetworkUtilizationDetailsIPV4Utilization + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// SubnetworkUtilizationDetailsIPV6Utilization: The IPV6 utilization of a +// single IP range. +type SubnetworkUtilizationDetailsIPV6Utilization struct { + TotalAllocatedIp *Uint128 `json:"totalAllocatedIp,omitempty"` + TotalFreeIp *Uint128 `json:"totalFreeIp,omitempty"` + // ForceSendFields is a list of field names (e.g. "TotalAllocatedIp") 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. "TotalAllocatedIp") 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 SubnetworkUtilizationDetailsIPV6Utilization) MarshalJSON() ([]byte, error) { + type NoMethod SubnetworkUtilizationDetailsIPV6Utilization + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + type SubnetworksExpandIpCidrRangeRequest struct { // IpCidrRange: The IP (in CIDR format or netmask) of internal addresses that // are legal on this Subnetwork. This range should be disjoint from other diff --git a/compute/v1/compute2-gen.go b/compute/v1/compute2-gen.go index 9c468b4cc08..4d6905c11e6 100644 --- a/compute/v1/compute2-gen.go +++ b/compute/v1/compute2-gen.go @@ -60847,7 +60847,14 @@ type ProjectsMoveDiskCall struct { header_ http.Header } -// MoveDisk: Moves a persistent disk from one zone to another. +// MoveDisk: Starting September 29, 2025, you can't use the moveDisk API on new +// projects. To move a disk to a different region or zone, follow the steps in +// Change the location of a disk +// (https://{$universe.dns_names.final_documentation_domain}/compute/docs/disks/migrate-to-hyperdisk#migrate-to-hd). +// Projects that already use the moveDisk API can continue usage until +// September 29, 2026. Starting November 1, 2025, API responses will include a +// warning message in the response body about the upcoming deprecation. You can +// skip the message to continue using the service without interruption. // // - project: Project ID for this request. func (r *ProjectsService) MoveDisk(project string, diskmoverequest *DiskMoveRequest) *ProjectsMoveDiskCall { diff --git a/compute/v1/compute3-gen.go b/compute/v1/compute3-gen.go index 1d3ab07858c..12a8cbbc353 100644 --- a/compute/v1/compute3-gen.go +++ b/compute/v1/compute3-gen.go @@ -39849,6 +39849,19 @@ func (r *SubnetworksService) Get(project string, region string, subnetwork strin return c } +// Views sets the optional parameter "views": Defines the extra views returned +// back in the subnetwork resource. Supported values: - WITH_UTILIZATION: +// Utilization data is included in the response. +// +// Possible values: +// +// "DEFAULT" +// "WITH_UTILIZATION" - Utilization data is included in the response. +func (c *SubnetworksGetCall) Views(views ...string) *SubnetworksGetCall { + c.urlParams_.SetMulti("views", append([]string{}, views...)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -40289,6 +40302,19 @@ func (c *SubnetworksListCall) ReturnPartialSuccess(returnPartialSuccess bool) *S return c } +// Views sets the optional parameter "views": Defines the extra views returned +// back in the subnetwork resource. Supported values: - WITH_UTILIZATION: +// Utilization data is included in the response. +// +// Possible values: +// +// "DEFAULT" +// "WITH_UTILIZATION" - Utilization data is included in the response. +func (c *SubnetworksListCall) Views(views ...string) *SubnetworksListCall { + c.urlParams_.SetMulti("views", append([]string{}, views...)) + 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/config/v1/config-api.json b/config/v1/config-api.json index ea99f1dc53d..323662221c4 100644 --- a/config/v1/config-api.json +++ b/config/v1/config-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1345,7 +1345,7 @@ } } }, - "revision": "20250813", + "revision": "20250907", "rootUrl": "https://config.googleapis.com/", "schemas": { "ApplyResults": { diff --git a/config/v1/config-gen.go b/config/v1/config-gen.go index e1d234490a1..9dcfa27fb79 100644 --- a/config/v1/config-gen.go +++ b/config/v1/config-gen.go @@ -2539,9 +2539,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/connectors/v1/connectors-api.json b/connectors/v1/connectors-api.json index 6cded376146..e9105ae86d1 100644 --- a/connectors/v1/connectors-api.json +++ b/connectors/v1/connectors-api.json @@ -194,7 +194,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -2757,7 +2757,7 @@ } } }, - "revision": "20250826", + "revision": "20250917", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/connectors/v1/connectors-gen.go b/connectors/v1/connectors-gen.go index b57febb728b..4a37b948483 100644 --- a/connectors/v1/connectors-gen.go +++ b/connectors/v1/connectors-gen.go @@ -7035,9 +7035,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/connectors/v2/connectors-api.json b/connectors/v2/connectors-api.json index 51831bd6e0e..d161156c977 100644 --- a/connectors/v2/connectors-api.json +++ b/connectors/v2/connectors-api.json @@ -769,7 +769,7 @@ } } }, - "revision": "20250826", + "revision": "20250917", "rootUrl": "https://connectors.googleapis.com/", "schemas": { "AccessCredentials": { @@ -2710,6 +2710,10 @@ "description": "Message representing a single tool.", "id": "Tool", "properties": { + "annotations": { + "$ref": "ToolAnnotations", + "description": "Annotations for the tool." + }, "dependsOn": { "description": "List of tool names that this tool depends on.", "items": { @@ -2736,6 +2740,33 @@ }, "type": "object" }, + "ToolAnnotations": { + "description": "ToolAnnotations holds annotations for a tool.", + "id": "ToolAnnotations", + "properties": { + "destructiveHint": { + "description": "If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates. (This property is meaningful only when `read_only_hint == false`)", + "type": "boolean" + }, + "idempotentHint": { + "description": "If true, calling the tool repeatedly with the same arguments will have no additional effect on the environment. (This property is meaningful only when `read_only_hint == false`)", + "type": "boolean" + }, + "openWorldHint": { + "description": "If true, this tool may interact with an \"open world\" of external entities. If false, the tool's domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not.", + "type": "boolean" + }, + "readOnlyHint": { + "description": "If true, the tool does not modify its environment.", + "type": "boolean" + }, + "title": { + "description": "A human-readable title for the tool.", + "type": "string" + } + }, + "type": "object" + }, "UpdateEntitiesWithConditionsResponse": { "description": "Response message for EntityService.UpdateEntitiesWithConditions", "id": "UpdateEntitiesWithConditionsResponse", diff --git a/connectors/v2/connectors-gen.go b/connectors/v2/connectors-gen.go index b2f34044e53..42a2101d3fc 100644 --- a/connectors/v2/connectors-gen.go +++ b/connectors/v2/connectors-gen.go @@ -1967,6 +1967,8 @@ func (s TimeOfDay) MarshalJSON() ([]byte, error) { // Tool: Message representing a single tool. type Tool struct { + // Annotations: Annotations for the tool. + Annotations *ToolAnnotations `json:"annotations,omitempty"` // DependsOn: List of tool names that this tool depends on. DependsOn []string `json:"dependsOn,omitempty"` // Description: Description of the tool. @@ -1977,13 +1979,13 @@ type Tool struct { Name string `json:"name,omitempty"` // OutputSchema: JSON schema for the output of the tool. OutputSchema *JsonSchema `json:"outputSchema,omitempty"` - // ForceSendFields is a list of field names (e.g. "DependsOn") to + // ForceSendFields is a list of field names (e.g. "Annotations") 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. "DependsOn") to include in API + // NullFields is a list of field names (e.g. "Annotations") 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. @@ -1995,6 +1997,43 @@ func (s Tool) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ToolAnnotations: ToolAnnotations holds annotations for a tool. +type ToolAnnotations struct { + // DestructiveHint: If true, the tool may perform destructive updates to its + // environment. If false, the tool performs only additive updates. (This + // property is meaningful only when `read_only_hint == false`) + DestructiveHint bool `json:"destructiveHint,omitempty"` + // IdempotentHint: If true, calling the tool repeatedly with the same arguments + // will have no additional effect on the environment. (This property is + // meaningful only when `read_only_hint == false`) + IdempotentHint bool `json:"idempotentHint,omitempty"` + // OpenWorldHint: If true, this tool may interact with an "open world" of + // external entities. If false, the tool's domain of interaction is closed. For + // example, the world of a web search tool is open, whereas that of a memory + // tool is not. + OpenWorldHint bool `json:"openWorldHint,omitempty"` + // ReadOnlyHint: If true, the tool does not modify its environment. + ReadOnlyHint bool `json:"readOnlyHint,omitempty"` + // Title: A human-readable title for the tool. + Title string `json:"title,omitempty"` + // ForceSendFields is a list of field names (e.g. "DestructiveHint") 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. "DestructiveHint") 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 ToolAnnotations) MarshalJSON() ([]byte, error) { + type NoMethod ToolAnnotations + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // UpdateEntitiesWithConditionsResponse: Response message for // EntityService.UpdateEntitiesWithConditions type UpdateEntitiesWithConditionsResponse struct { diff --git a/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-api.json b/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-api.json index c94a435a0a4..2f487413732 100644 --- a/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-api.json +++ b/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -518,7 +518,7 @@ } } }, - "revision": "20250821", + "revision": "20250918", "rootUrl": "https://contactcenteraiplatform.googleapis.com/", "schemas": { "AdminUser": { diff --git a/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-gen.go b/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-gen.go index 382c999f752..cb3b9dcfacf 100644 --- a/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-gen.go +++ b/contactcenteraiplatform/v1alpha1/contactcenteraiplatform-gen.go @@ -1226,9 +1226,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/contactcenterinsights/v1/contactcenterinsights-api.json b/contactcenterinsights/v1/contactcenterinsights-api.json index 660c147e986..4dd19df9e1b 100644 --- a/contactcenterinsights/v1/contactcenterinsights-api.json +++ b/contactcenterinsights/v1/contactcenterinsights-api.json @@ -5638,7 +5638,7 @@ } } }, - "revision": "20250909", + "revision": "20250923", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1Analysis": { @@ -7567,6 +7567,11 @@ "$ref": "GoogleCloudContactcenterinsightsV1DimensionQaQuestionDimensionMetadata", "description": "Output only. Metadata about the QA question dimension.", "readOnly": true + }, + "qaScorecardDimensionMetadata": { + "$ref": "GoogleCloudContactcenterinsightsV1DimensionQaScorecardDimensionMetadata", + "description": "Output only. Metadata about the QA scorecard dimension.", + "readOnly": true } }, "type": "object" @@ -7651,6 +7656,17 @@ }, "type": "object" }, + "GoogleCloudContactcenterinsightsV1DimensionQaScorecardDimensionMetadata": { + "description": "Metadata about the QA scorecard dimension.", + "id": "GoogleCloudContactcenterinsightsV1DimensionQaScorecardDimensionMetadata", + "properties": { + "qaScorecardId": { + "description": "Optional. The QA scorecard ID.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudContactcenterinsightsV1EncryptionSpec": { "description": "A customer-managed encryption key specification that can be applied to all created resources (e.g. `Conversation`).", "id": "GoogleCloudContactcenterinsightsV1EncryptionSpec", @@ -7829,6 +7845,7 @@ "EXPORT_V8", "EXPORT_V9", "EXPORT_V10", + "EXPORT_V11", "EXPORT_VERSION_LATEST_AVAILABLE" ], "enumDescriptions": [ @@ -7843,6 +7860,7 @@ "Export schema version 8.", "Export schema version 9.", "Export schema version 10.", + "Export schema version 11.", "Export schema version latest available." ], "type": "string" @@ -9308,6 +9326,11 @@ "readOnly": true, "type": "number" }, + "rationale": { + "$ref": "GoogleCloudContactcenterinsightsV1QaAnswerAnswerValueQaAnswerRationale", + "description": "Output only. The rationale for the answer. This field is only populated for answers that are generated by the LLM. Manual edits currently do not have rationales.", + "readOnly": true + }, "score": { "description": "Output only. Numerical score of the answer.", "format": "double", @@ -9326,6 +9349,17 @@ }, "type": "object" }, + "GoogleCloudContactcenterinsightsV1QaAnswerAnswerValueQaAnswerRationale": { + "description": "Wrapper for the rationale for the answer.", + "id": "GoogleCloudContactcenterinsightsV1QaAnswerAnswerValueQaAnswerRationale", + "properties": { + "rationale": { + "description": "The rationale string for the answer.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudContactcenterinsightsV1QaQuestion": { "description": "A single question to be scored by the Insights QA feature.", "id": "GoogleCloudContactcenterinsightsV1QaQuestion", @@ -9867,7 +9901,7 @@ }, "macroAverageSlice": { "$ref": "GoogleCloudContactcenterinsightsV1QueryMetricsResponseSlice", - "description": "The macro average slice contains aggregated averages across the selected dimension. i.e. if group_by agent is specified this field will contain the average across all agents. This field is only populated if the request specifies a Dimension." + "description": "The macro average slice contains aggregated averages across all selected dimensions. i.e. if group_by agent and scorecard_id is specified, this field will contain the average across all agents and all scorecards. This field is only populated if the request specifies a Dimension." }, "slices": { "description": "A slice contains a total and (if the request specified a time granularity) a time series of metric values. Each slice contains a unique combination of the cardinality of dimensions from the request.", @@ -12050,6 +12084,11 @@ "$ref": "GoogleCloudContactcenterinsightsV1alpha1DimensionQaQuestionDimensionMetadata", "description": "Output only. Metadata about the QA question dimension.", "readOnly": true + }, + "qaScorecardDimensionMetadata": { + "$ref": "GoogleCloudContactcenterinsightsV1alpha1DimensionQaScorecardDimensionMetadata", + "description": "Output only. Metadata about the QA scorecard dimension.", + "readOnly": true } }, "type": "object" @@ -12134,6 +12173,17 @@ }, "type": "object" }, + "GoogleCloudContactcenterinsightsV1alpha1DimensionQaScorecardDimensionMetadata": { + "description": "Metadata about the QA scorecard dimension.", + "id": "GoogleCloudContactcenterinsightsV1alpha1DimensionQaScorecardDimensionMetadata", + "properties": { + "qaScorecardId": { + "description": "Optional. The QA scorecard ID.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudContactcenterinsightsV1alpha1EncryptionSpec": { "description": "A customer-managed encryption key specification that can be applied to all created resources (e.g. `Conversation`).", "id": "GoogleCloudContactcenterinsightsV1alpha1EncryptionSpec", @@ -12301,6 +12351,7 @@ "EXPORT_V8", "EXPORT_V9", "EXPORT_V10", + "EXPORT_V11", "EXPORT_VERSION_LATEST_AVAILABLE" ], "enumDescriptions": [ @@ -12315,6 +12366,7 @@ "Export schema version 8.", "Export schema version 9.", "Export schema version 10.", + "Export schema version 11.", "Export schema version latest available." ], "type": "string" @@ -13254,6 +13306,11 @@ "readOnly": true, "type": "number" }, + "rationale": { + "$ref": "GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValueQaAnswerRationale", + "description": "Output only. The rationale for the answer. This field is only populated for answers that are generated by the LLM. Manual edits currently do not have rationales.", + "readOnly": true + }, "score": { "description": "Output only. Numerical score of the answer.", "format": "double", @@ -13272,6 +13329,17 @@ }, "type": "object" }, + "GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValueQaAnswerRationale": { + "description": "Wrapper for the rationale for the answer.", + "id": "GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValueQaAnswerRationale", + "properties": { + "rationale": { + "description": "The rationale string for the answer.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudContactcenterinsightsV1alpha1QaQuestionTag": { "description": "A tag is a resource which aims to categorize a set of questions across multiple scorecards, e.g., \"Customer Satisfaction\",\"Billing\", etc.", "id": "GoogleCloudContactcenterinsightsV1alpha1QaQuestionTag", @@ -13461,7 +13529,7 @@ }, "macroAverageSlice": { "$ref": "GoogleCloudContactcenterinsightsV1alpha1QueryMetricsResponseSlice", - "description": "The macro average slice contains aggregated averages across the selected dimension. i.e. if group_by agent is specified this field will contain the average across all agents. This field is only populated if the request specifies a Dimension." + "description": "The macro average slice contains aggregated averages across all selected dimensions. i.e. if group_by agent and scorecard_id is specified, this field will contain the average across all agents and all scorecards. This field is only populated if the request specifies a Dimension." }, "slices": { "description": "A slice contains a total and (if the request specified a time granularity) a time series of metric values. Each slice contains a unique combination of the cardinality of dimensions from the request.", diff --git a/contactcenterinsights/v1/contactcenterinsights-gen.go b/contactcenterinsights/v1/contactcenterinsights-gen.go index ee0d147f4f1..a1e15b31214 100644 --- a/contactcenterinsights/v1/contactcenterinsights-gen.go +++ b/contactcenterinsights/v1/contactcenterinsights-gen.go @@ -2886,6 +2886,9 @@ type GoogleCloudContactcenterinsightsV1Dimension struct { // QaQuestionDimensionMetadata: Output only. Metadata about the QA question // dimension. QaQuestionDimensionMetadata *GoogleCloudContactcenterinsightsV1DimensionQaQuestionDimensionMetadata `json:"qaQuestionDimensionMetadata,omitempty"` + // QaScorecardDimensionMetadata: Output only. Metadata about the QA scorecard + // dimension. + QaScorecardDimensionMetadata *GoogleCloudContactcenterinsightsV1DimensionQaScorecardDimensionMetadata `json:"qaScorecardDimensionMetadata,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentDimensionMetadata") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -3017,6 +3020,29 @@ func (s GoogleCloudContactcenterinsightsV1DimensionQaQuestionDimensionMetadata) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudContactcenterinsightsV1DimensionQaScorecardDimensionMetadata: +// Metadata about the QA scorecard dimension. +type GoogleCloudContactcenterinsightsV1DimensionQaScorecardDimensionMetadata struct { + // QaScorecardId: Optional. The QA scorecard ID. + QaScorecardId string `json:"qaScorecardId,omitempty"` + // ForceSendFields is a list of field names (e.g. "QaScorecardId") 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. "QaScorecardId") 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 GoogleCloudContactcenterinsightsV1DimensionQaScorecardDimensionMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudContactcenterinsightsV1DimensionQaScorecardDimensionMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudContactcenterinsightsV1EncryptionSpec: A customer-managed // encryption key specification that can be applied to all created resources // (e.g. `Conversation`). @@ -3245,6 +3271,7 @@ type GoogleCloudContactcenterinsightsV1ExportInsightsDataRequest struct { // "EXPORT_V8" - Export schema version 8. // "EXPORT_V9" - Export schema version 9. // "EXPORT_V10" - Export schema version 10. + // "EXPORT_V11" - Export schema version 11. // "EXPORT_VERSION_LATEST_AVAILABLE" - Export schema version latest // available. ExportSchemaVersion string `json:"exportSchemaVersion,omitempty"` @@ -5205,6 +5232,10 @@ type GoogleCloudContactcenterinsightsV1QaAnswerAnswerValue struct { NumValue float64 `json:"numValue,omitempty"` // PotentialScore: Output only. The maximum potential score of the question. PotentialScore float64 `json:"potentialScore,omitempty"` + // Rationale: Output only. The rationale for the answer. This field is only + // populated for answers that are generated by the LLM. Manual edits currently + // do not have rationales. + Rationale *GoogleCloudContactcenterinsightsV1QaAnswerAnswerValueQaAnswerRationale `json:"rationale,omitempty"` // Score: Output only. Numerical score of the answer. Score float64 `json:"score,omitempty"` // SkipValue: Output only. A value of "Skip". If provided, this field may only @@ -5252,6 +5283,29 @@ func (s *GoogleCloudContactcenterinsightsV1QaAnswerAnswerValue) UnmarshalJSON(da return nil } +// GoogleCloudContactcenterinsightsV1QaAnswerAnswerValueQaAnswerRationale: +// Wrapper for the rationale for the answer. +type GoogleCloudContactcenterinsightsV1QaAnswerAnswerValueQaAnswerRationale struct { + // Rationale: The rationale string for the answer. + Rationale string `json:"rationale,omitempty"` + // ForceSendFields is a list of field names (e.g. "Rationale") 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. "Rationale") 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 GoogleCloudContactcenterinsightsV1QaAnswerAnswerValueQaAnswerRationale) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudContactcenterinsightsV1QaAnswerAnswerValueQaAnswerRationale + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudContactcenterinsightsV1QaQuestion: A single question to be scored // by the Insights QA feature. type GoogleCloudContactcenterinsightsV1QaQuestion struct { @@ -5933,9 +5987,10 @@ type GoogleCloudContactcenterinsightsV1QueryMetricsResponse struct { // "projects/{project}/locations/{location}" Location string `json:"location,omitempty"` // MacroAverageSlice: The macro average slice contains aggregated averages - // across the selected dimension. i.e. if group_by agent is specified this - // field will contain the average across all agents. This field is only - // populated if the request specifies a Dimension. + // across all selected dimensions. i.e. if group_by agent and scorecard_id is + // specified, this field will contain the average across all agents and all + // scorecards. This field is only populated if the request specifies a + // Dimension. MacroAverageSlice *GoogleCloudContactcenterinsightsV1QueryMetricsResponseSlice `json:"macroAverageSlice,omitempty"` // Slices: A slice contains a total and (if the request specified a time // granularity) a time series of metric values. Each slice contains a unique @@ -8784,6 +8839,9 @@ type GoogleCloudContactcenterinsightsV1alpha1Dimension struct { // QaQuestionDimensionMetadata: Output only. Metadata about the QA question // dimension. QaQuestionDimensionMetadata *GoogleCloudContactcenterinsightsV1alpha1DimensionQaQuestionDimensionMetadata `json:"qaQuestionDimensionMetadata,omitempty"` + // QaScorecardDimensionMetadata: Output only. Metadata about the QA scorecard + // dimension. + QaScorecardDimensionMetadata *GoogleCloudContactcenterinsightsV1alpha1DimensionQaScorecardDimensionMetadata `json:"qaScorecardDimensionMetadata,omitempty"` // ForceSendFields is a list of field names (e.g. "AgentDimensionMetadata") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -8914,6 +8972,29 @@ func (s GoogleCloudContactcenterinsightsV1alpha1DimensionQaQuestionDimensionMeta return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudContactcenterinsightsV1alpha1DimensionQaScorecardDimensionMetadata +// : Metadata about the QA scorecard dimension. +type GoogleCloudContactcenterinsightsV1alpha1DimensionQaScorecardDimensionMetadata struct { + // QaScorecardId: Optional. The QA scorecard ID. + QaScorecardId string `json:"qaScorecardId,omitempty"` + // ForceSendFields is a list of field names (e.g. "QaScorecardId") 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. "QaScorecardId") 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 GoogleCloudContactcenterinsightsV1alpha1DimensionQaScorecardDimensionMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudContactcenterinsightsV1alpha1DimensionQaScorecardDimensionMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudContactcenterinsightsV1alpha1EncryptionSpec: A customer-managed // encryption key specification that can be applied to all created resources // (e.g. `Conversation`). @@ -9115,6 +9196,7 @@ type GoogleCloudContactcenterinsightsV1alpha1ExportInsightsDataRequest struct { // "EXPORT_V8" - Export schema version 8. // "EXPORT_V9" - Export schema version 9. // "EXPORT_V10" - Export schema version 10. + // "EXPORT_V11" - Export schema version 11. // "EXPORT_VERSION_LATEST_AVAILABLE" - Export schema version latest // available. ExportSchemaVersion string `json:"exportSchemaVersion,omitempty"` @@ -10313,6 +10395,10 @@ type GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValue struct { NumValue float64 `json:"numValue,omitempty"` // PotentialScore: Output only. The maximum potential score of the question. PotentialScore float64 `json:"potentialScore,omitempty"` + // Rationale: Output only. The rationale for the answer. This field is only + // populated for answers that are generated by the LLM. Manual edits currently + // do not have rationales. + Rationale *GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValueQaAnswerRationale `json:"rationale,omitempty"` // Score: Output only. Numerical score of the answer. Score float64 `json:"score,omitempty"` // SkipValue: Output only. A value of "Skip". If provided, this field may only @@ -10360,6 +10446,30 @@ func (s *GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValue) UnmarshalJ return nil } +// GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValueQaAnswerRationale: +// +// Wrapper for the rationale for the answer. +type GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValueQaAnswerRationale struct { + // Rationale: The rationale string for the answer. + Rationale string `json:"rationale,omitempty"` + // ForceSendFields is a list of field names (e.g. "Rationale") 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. "Rationale") 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 GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValueQaAnswerRationale) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudContactcenterinsightsV1alpha1QaAnswerAnswerValueQaAnswerRationale + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudContactcenterinsightsV1alpha1QaQuestionTag: A tag is a resource // which aims to categorize a set of questions across multiple scorecards, // e.g., "Customer Satisfaction","Billing", etc. @@ -10604,9 +10714,10 @@ type GoogleCloudContactcenterinsightsV1alpha1QueryMetricsResponse struct { // "projects/{project}/locations/{location}" Location string `json:"location,omitempty"` // MacroAverageSlice: The macro average slice contains aggregated averages - // across the selected dimension. i.e. if group_by agent is specified this - // field will contain the average across all agents. This field is only - // populated if the request specifies a Dimension. + // across all selected dimensions. i.e. if group_by agent and scorecard_id is + // specified, this field will contain the average across all agents and all + // scorecards. This field is only populated if the request specifies a + // Dimension. MacroAverageSlice *GoogleCloudContactcenterinsightsV1alpha1QueryMetricsResponseSlice `json:"macroAverageSlice,omitempty"` // Slices: A slice contains a total and (if the request specified a time // granularity) a time series of metric values. Each slice contains a unique diff --git a/content/v2.1/content-api.json b/content/v2.1/content-api.json index 6e4b91eafec..88255867183 100644 --- a/content/v2.1/content-api.json +++ b/content/v2.1/content-api.json @@ -12,7 +12,7 @@ "baseUrl": "https://shoppingcontent.googleapis.com/content/v2.1/", "batchPath": "batch", "canonicalName": "Shopping Content", - "description": "Manage your product listings and accounts for Google Shopping", + "description": "This API is deprecated. Please use Merchant API instead: https://developers.google.com/merchant/api. ", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/shopping-content/v2/", "fullyEncodeReservedExpansion": true, @@ -4570,7 +4570,7 @@ } } }, - "revision": "20250723", + "revision": "20250921", "rootUrl": "https://shoppingcontent.googleapis.com/", "schemas": { "Account": { diff --git a/dataform/v1beta1/dataform-api.json b/dataform/v1beta1/dataform-api.json index 27cc2469566..1764a494a2e 100644 --- a/dataform/v1beta1/dataform-api.json +++ b/dataform/v1beta1/dataform-api.json @@ -248,100 +248,6 @@ } }, "resources": { - "folders": { - "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:getIamPolicy", - "httpMethod": "GET", - "id": "dataform.projects.locations.folders.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/[^/]+/folders/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:getIamPolicy", - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:setIamPolicy", - "httpMethod": "POST", - "id": "dataform.projects.locations.folders.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/[^/]+/folders/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:setIamPolicy", - "request": { - "$ref": "SetIamPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:testIamPermissions", - "httpMethod": "POST", - "id": "dataform.projects.locations.folders.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/[^/]+/folders/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:testIamPermissions", - "request": { - "$ref": "TestIamPermissionsRequest" - }, - "response": { - "$ref": "TestIamPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - }, "operations": { "methods": { "cancel": { @@ -680,38 +586,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": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:getIamPolicy", - "httpMethod": "GET", - "id": "dataform.projects.locations.repositories.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/[^/]+/repositories/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:getIamPolicy", - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "list": { "description": "Lists Repositories in a given project and location. **Note:** *This method can return repositories not shown in the [Dataform UI](https://console.cloud.google.com/bigquery/dataform)*.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories", @@ -876,64 +750,6 @@ "https://www.googleapis.com/auth/bigquery", "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:setIamPolicy", - "httpMethod": "POST", - "id": "dataform.projects.locations.repositories.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/[^/]+/repositories/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:setIamPolicy", - "request": { - "$ref": "SetIamPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:testIamPermissions", - "httpMethod": "POST", - "id": "dataform.projects.locations.repositories.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/[^/]+/repositories/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:testIamPermissions", - "request": { - "$ref": "TestIamPermissionsRequest" - }, - "response": { - "$ref": "TestIamPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "https://www.googleapis.com/auth/cloud-platform" - ] } }, "resources": { @@ -1812,38 +1628,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": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:getIamPolicy", - "httpMethod": "GET", - "id": "dataform.projects.locations.repositories.workspaces.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/[^/]+/repositories/[^/]+/workspaces/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:getIamPolicy", - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "installNpmPackages": { "description": "Installs dependency NPM packages (inside a Workspace).", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:installNpmPackages", @@ -2272,64 +2056,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": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:setIamPolicy", - "httpMethod": "POST", - "id": "dataform.projects.locations.repositories.workspaces.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/[^/]+/repositories/[^/]+/workspaces/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:setIamPolicy", - "request": { - "$ref": "SetIamPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:testIamPermissions", - "httpMethod": "POST", - "id": "dataform.projects.locations.repositories.workspaces.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/[^/]+/repositories/[^/]+/workspaces/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:testIamPermissions", - "request": { - "$ref": "TestIamPermissionsRequest" - }, - "response": { - "$ref": "TestIamPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "writeFile": { "description": "Writes to a file (inside a Workspace).", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:writeFile", @@ -2362,107 +2088,13 @@ } } } - }, - "teamFolders": { - "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:getIamPolicy", - "httpMethod": "GET", - "id": "dataform.projects.locations.teamFolders.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/[^/]+/teamFolders/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:getIamPolicy", - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:setIamPolicy", - "httpMethod": "POST", - "id": "dataform.projects.locations.teamFolders.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/[^/]+/teamFolders/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:setIamPolicy", - "request": { - "$ref": "SetIamPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "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": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:testIamPermissions", - "httpMethod": "POST", - "id": "dataform.projects.locations.teamFolders.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/[^/]+/teamFolders/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta1/{+resource}:testIamPermissions", - "request": { - "$ref": "TestIamPermissionsRequest" - }, - "response": { - "$ref": "TestIamPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } } } } } } }, - "revision": "20250907", + "revision": "20250917", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -2594,28 +2226,6 @@ }, "type": "object" }, - "Binding": { - "description": "Associates `members`, or principals, with a `role`.", - "id": "Binding", - "properties": { - "condition": { - "$ref": "Expr", - "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." - }, - "members": { - "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", - "items": { - "type": "string" - }, - "type": "array" - }, - "role": { - "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).", - "type": "string" - } - }, - "type": "object" - }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", @@ -3134,29 +2744,6 @@ }, "type": "object" }, - "Expr": { - "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", - "id": "Expr", - "properties": { - "description": { - "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", - "type": "string" - }, - "expression": { - "description": "Textual representation of an expression in Common Expression Language syntax.", - "type": "string" - }, - "location": { - "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.", - "type": "string" - }, - "title": { - "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.", - "type": "string" - } - }, - "type": "object" - }, "FetchFileDiffResponse": { "description": "`FetchFileDiff` response message.", "id": "FetchFileDiffResponse", @@ -3912,30 +3499,6 @@ }, "type": "object" }, - "Policy": { - "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", - "id": "Policy", - "properties": { - "bindings": { - "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.", - "items": { - "$ref": "Binding" - }, - "type": "array" - }, - "etag": { - "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.", - "format": "byte", - "type": "string" - }, - "version": { - "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. 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", - "type": "integer" - } - }, - "type": "object" - }, "PolicyName": { "description": "An internal name for an IAM policy, based on the resource to which the policy applies. Not to be confused with a resource's external full resource name. For more information on this distinction, see go/iam-full-resource-names.", "id": "PolicyName", @@ -4453,17 +4016,6 @@ }, "type": "object" }, - "SetIamPolicyRequest": { - "description": "Request message for `SetIamPolicy` method.", - "id": "SetIamPolicyRequest", - "properties": { - "policy": { - "$ref": "Policy", - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them." - } - }, - "type": "object" - }, "SimpleLoadMode": { "description": "Simple load definition", "id": "SimpleLoadMode", @@ -4550,34 +4102,6 @@ }, "type": "object" }, - "TestIamPermissionsRequest": { - "description": "Request message for `TestIamPermissions` method.", - "id": "TestIamPermissionsRequest", - "properties": { - "permissions": { - "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, - "TestIamPermissionsResponse": { - "description": "Response message for `TestIamPermissions` method.", - "id": "TestIamPermissionsResponse", - "properties": { - "permissions": { - "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "UncommittedFileChange": { "description": "Represents the Git state of a file with uncommitted changes.", "id": "UncommittedFileChange", diff --git a/dataform/v1beta1/dataform-gen.go b/dataform/v1beta1/dataform-gen.go index 625fde41906..a7272013721 100644 --- a/dataform/v1beta1/dataform-gen.go +++ b/dataform/v1beta1/dataform-gen.go @@ -178,32 +178,17 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} - rs.Folders = NewProjectsLocationsFoldersService(s) rs.Operations = NewProjectsLocationsOperationsService(s) rs.Repositories = NewProjectsLocationsRepositoriesService(s) - rs.TeamFolders = NewProjectsLocationsTeamFoldersService(s) return rs } type ProjectsLocationsService struct { s *Service - Folders *ProjectsLocationsFoldersService - Operations *ProjectsLocationsOperationsService Repositories *ProjectsLocationsRepositoriesService - - TeamFolders *ProjectsLocationsTeamFoldersService -} - -func NewProjectsLocationsFoldersService(s *Service) *ProjectsLocationsFoldersService { - rs := &ProjectsLocationsFoldersService{s: s} - return rs -} - -type ProjectsLocationsFoldersService struct { - s *Service } func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { @@ -284,15 +269,6 @@ type ProjectsLocationsRepositoriesWorkspacesService struct { s *Service } -func NewProjectsLocationsTeamFoldersService(s *Service) *ProjectsLocationsTeamFoldersService { - rs := &ProjectsLocationsTeamFoldersService{s: s} - return rs -} - -type ProjectsLocationsTeamFoldersService struct { - s *Service -} - // ActionErrorTable: Error table information, used to write error data into a // BigQuery table. type ActionErrorTable struct { @@ -464,105 +440,6 @@ func (s BigQueryAction) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Binding: Associates `members`, or principals, with a `role`. -type Binding struct { - // Condition: The condition that is associated with this binding. If the - // condition evaluates to `true`, then this binding applies to the current - // request. If the condition evaluates to `false`, then this binding does not - // apply to the current request. However, a different role binding might grant - // the same role to one or more of the principals in this binding. To learn - // which resources support conditions in their IAM policies, see the IAM - // documentation - // (https://cloud.google.com/iam/help/conditions/resource-policies). - Condition *Expr `json:"condition,omitempty"` - // Members: Specifies the principals requesting access for a Google Cloud - // resource. `members` can have the following values: * `allUsers`: A special - // identifier that represents anyone who is on the internet; with or without a - // Google account. * `allAuthenticatedUsers`: A special identifier that - // represents anyone who is authenticated with a Google account or a service - // account. Does not include identities that come from external identity - // providers (IdPs) through identity federation. * `user:{emailid}`: An email - // address that represents a specific Google account. For example, - // `alice@example.com` . * `serviceAccount:{emailid}`: An email address that - // represents a Google service account. For example, - // `my-other-app@appspot.gserviceaccount.com`. * - // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An - // identifier for a Kubernetes service account - // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). - // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * - // `group:{emailid}`: An email address that represents a Google group. For - // example, `admins@example.com`. * `domain:{domain}`: The G Suite domain - // (primary) that represents all the users of that domain. For example, - // `google.com` or `example.com`. * - // `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/sub - // ject/{subject_attribute_value}`: A single identity in a workforce identity - // pool. * - // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/ - // group/{group_id}`: All workforce identities in a group. * - // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/ - // attribute.{attribute_name}/{attribute_value}`: All workforce identities with - // a specific attribute value. * - // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/ - // *`: All identities in a workforce identity pool. * - // `principal://iam.googleapis.com/projects/{project_number}/locations/global/wo - // rkloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single - // identity in a workload identity pool. * - // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global - // /workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool - // group. * - // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global - // /workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value} - // `: All identities in a workload identity pool with a certain attribute. * - // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global - // /workloadIdentityPools/{pool_id}/*`: All identities in a workload identity - // pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus - // unique identifier) representing a user that has been recently deleted. For - // example, `alice@example.com?uid=123456789012345678901`. If the user is - // recovered, this value reverts to `user:{emailid}` and the recovered user - // retains the role in the binding. * - // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus - // unique identifier) representing a service account that has been recently - // deleted. For example, - // `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the - // service account is undeleted, this value reverts to - // `serviceAccount:{emailid}` and the undeleted service account retains the - // role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email - // address (plus unique identifier) representing a Google group that has been - // recently deleted. For example, - // `admins@example.com?uid=123456789012345678901`. If the group is recovered, - // this value reverts to `group:{emailid}` and the recovered group retains the - // role in the binding. * - // `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool - // _id}/subject/{subject_attribute_value}`: Deleted single identity in a - // workforce identity pool. For example, - // `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-po - // ol-id/subject/my-subject-attribute-value`. - Members []string `json:"members,omitempty"` - // Role: Role that is assigned to the list of `members`, or principals. For - // example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview - // of the IAM roles and permissions, see the IAM documentation - // (https://cloud.google.com/iam/docs/roles-overview). For a list of the - // available pre-defined roles, see here - // (https://cloud.google.com/iam/docs/understanding-roles). - Role string `json:"role,omitempty"` - // ForceSendFields is a list of field names (e.g. "Condition") 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. "Condition") 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 Binding) MarshalJSON() ([]byte, error) { - type NoMethod Binding - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } @@ -1216,54 +1093,6 @@ func (s ErrorTable) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Expr: Represents a textual expression in the Common Expression Language -// (CEL) syntax. CEL is a C-like expression language. The syntax and semantics -// of CEL are documented at https://github.com/google/cel-spec. Example -// (Comparison): title: "Summary size limit" description: "Determines if a -// summary is less than 100 chars" expression: "document.summary.size() < 100" -// Example (Equality): title: "Requestor is owner" description: "Determines if -// requestor is the document owner" expression: "document.owner == -// request.auth.claims.email" Example (Logic): title: "Public documents" -// description: "Determine whether the document should be publicly visible" -// expression: "document.type != 'private' && document.type != 'internal'" -// Example (Data Manipulation): title: "Notification string" description: -// "Create a notification string with a timestamp." expression: "'New message -// received at ' + string(document.create_time)" The exact variables and -// functions that may be referenced within an expression are determined by the -// service that evaluates it. See the service documentation for additional -// information. -type Expr struct { - // Description: Optional. Description of the expression. This is a longer text - // which describes the expression, e.g. when hovered over it in a UI. - Description string `json:"description,omitempty"` - // Expression: Textual representation of an expression in Common Expression - // Language syntax. - Expression string `json:"expression,omitempty"` - // Location: Optional. String indicating the location of the expression for - // error reporting, e.g. a file name and a position in the file. - Location string `json:"location,omitempty"` - // Title: Optional. Title for the expression, i.e. a short string describing - // its purpose. This can be used e.g. in UIs which allow to enter the - // expression. - Title string `json:"title,omitempty"` - // ForceSendFields is a list of field names (e.g. "Description") 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. "Description") 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 Expr) MarshalJSON() ([]byte, error) { - type NoMethod Expr - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // FetchFileDiffResponse: `FetchFileDiff` response message. type FetchFileDiffResponse struct { // FormattedDiff: The raw formatted Git diff for the file. @@ -2264,96 +2093,6 @@ func (s Operations) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Policy: An Identity and Access Management (IAM) policy, which specifies -// access controls for Google Cloud resources. A `Policy` is a collection of -// `bindings`. A `binding` binds one or more `members`, or principals, to a -// single `role`. Principals can be user accounts, service accounts, Google -// groups, and domains (such as G Suite). A `role` is a named list of -// permissions; each `role` can be an IAM predefined role or a user-created -// custom role. For some types of Google Cloud resources, a `binding` can also -// specify a `condition`, which is a logical expression that allows access to a -// resource only if the expression evaluates to `true`. A condition can add -// constraints based on attributes of the request, the resource, or both. To -// learn which resources support conditions in their IAM policies, see the IAM -// documentation -// (https://cloud.google.com/iam/help/conditions/resource-policies). **JSON -// example:** ``` { "bindings": [ { "role": -// "roles/resourcemanager.organizationAdmin", "members": [ -// "user:mike@example.com", "group:admins@example.com", "domain:google.com", -// "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": -// "roles/resourcemanager.organizationViewer", "members": [ -// "user:eve@example.com" ], "condition": { "title": "expirable access", -// "description": "Does not grant access after Sep 2020", "expression": -// "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": -// "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - -// members: - user:mike@example.com - group:admins@example.com - -// domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com -// role: roles/resourcemanager.organizationAdmin - members: - -// user:eve@example.com role: roles/resourcemanager.organizationViewer -// condition: title: expirable access description: Does not grant access after -// Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') -// etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, -// see the IAM documentation (https://cloud.google.com/iam/docs/). -type Policy struct { - // Bindings: Associates a list of `members`, or principals, with a `role`. - // Optionally, may specify a `condition` that determines how and when the - // `bindings` are applied. Each of the `bindings` must contain at least one - // principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; - // up to 250 of these principals can be Google groups. Each occurrence of a - // principal counts towards these limits. For example, if the `bindings` grant - // 50 different roles to `user:alice@example.com`, and not to any other - // principal, then you can add another 1,450 principals to the `bindings` in - // the `Policy`. - Bindings []*Binding `json:"bindings,omitempty"` - // Etag: `etag` is used for optimistic concurrency control as a way to help - // prevent simultaneous updates of a policy from overwriting each other. It is - // strongly suggested that systems make use of the `etag` in the - // read-modify-write cycle to perform policy updates in order to avoid race - // conditions: An `etag` is returned in the response to `getIamPolicy`, and - // systems are expected to put that etag in the request to `setIamPolicy` to - // ensure that their change will be applied to the same version of the policy. - // **Important:** If you use IAM Conditions, you must include the `etag` field - // whenever you call `setIamPolicy`. If you omit this field, then IAM allows - // you to overwrite a version `3` policy with a version `1` policy, and all of - // the conditions in the version `3` policy are lost. - Etag string `json:"etag,omitempty"` - // Version: Specifies the format of the policy. Valid values are `0`, `1`, and - // `3`. Requests that specify an invalid value are rejected. Any operation that - // affects conditional role bindings must specify version `3`. This requirement - // applies to the following operations: * Getting a policy that includes a - // conditional role binding * Adding a conditional role binding to a policy * - // Changing a conditional role binding in a policy * Removing any role binding, - // with or without a condition, from a policy that includes conditions - // **Important:** If you use IAM Conditions, you must include the `etag` field - // whenever you call `setIamPolicy`. If you omit this field, then IAM allows - // you to overwrite a version `3` policy with a version `1` policy, and all of - // the conditions in the version `3` policy are lost. If a policy does not - // include any conditions, operations on that policy may specify any valid - // version or leave the field unset. To learn which resources support - // conditions in their IAM policies, see the IAM documentation - // (https://cloud.google.com/iam/help/conditions/resource-policies). - Version int64 `json:"version,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Bindings") 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. "Bindings") 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 Policy) MarshalJSON() ([]byte, error) { - type NoMethod Policy - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // PolicyName: An internal name for an IAM policy, based on the resource to // which the policy applies. Not to be confused with a resource's external full // resource name. For more information on this distinction, see @@ -3039,31 +2778,6 @@ func (s SearchResult) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// SetIamPolicyRequest: Request message for `SetIamPolicy` method. -type SetIamPolicyRequest struct { - // Policy: REQUIRED: The complete policy to be applied to the `resource`. The - // size of the policy is limited to a few 10s of KB. An empty policy is a valid - // policy but certain Google Cloud services (such as Projects) might reject - // them. - Policy *Policy `json:"policy,omitempty"` - // ForceSendFields is a list of field names (e.g. "Policy") 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. "Policy") 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 SetIamPolicyRequest) MarshalJSON() ([]byte, error) { - type NoMethod SetIamPolicyRequest - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // SimpleLoadMode: Simple load definition type SimpleLoadMode struct { } @@ -3185,58 +2899,6 @@ func (s Target) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// TestIamPermissionsRequest: Request message for `TestIamPermissions` method. -type TestIamPermissionsRequest struct { - // Permissions: The set of permissions to check for the `resource`. Permissions - // with wildcards (such as `*` or `storage.*`) are not allowed. For more - // information see IAM Overview - // (https://cloud.google.com/iam/docs/overview#permissions). - Permissions []string `json:"permissions,omitempty"` - // ForceSendFields is a list of field names (e.g. "Permissions") 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. "Permissions") 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 TestIamPermissionsRequest) MarshalJSON() ([]byte, error) { - type NoMethod TestIamPermissionsRequest - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - -// TestIamPermissionsResponse: Response message for `TestIamPermissions` -// method. -type TestIamPermissionsResponse struct { - // Permissions: A subset of `TestPermissionsRequest.permissions` that the - // caller is allowed. - Permissions []string `json:"permissions,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the server. - googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Permissions") 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. "Permissions") 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 TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { - type NoMethod TestIamPermissionsResponse - return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) -} - // UncommittedFileChange: Represents the Git state of a file with uncommitted // changes. type UncommittedFileChange struct { @@ -4063,102 +3725,84 @@ func (c *ProjectsLocationsUpdateConfigCall) Do(opts ...googleapi.CallOption) (*C return ret, nil } -type ProjectsLocationsFoldersGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + 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. +// 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`. // -// - 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 *ProjectsLocationsFoldersService) GetIamPolicy(resource string) *ProjectsLocationsFoldersGetIamPolicyCall { - c := &ProjectsLocationsFoldersGetIamPolicyCall{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 *ProjectsLocationsFoldersGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsFoldersGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// - 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 *ProjectsLocationsFoldersGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsFoldersGetIamPolicyCall { +func (c *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { 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 *ProjectsLocationsFoldersGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsFoldersGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsFoldersGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsFoldersGetIamPolicyCall { +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 *ProjectsLocationsFoldersGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsOperationsCancelCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsFoldersGetIamPolicyCall) 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 *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, "v1beta1/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:cancel") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + 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, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.folders.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.folders.getIamPolicy" call. +// Do executes the "dataform.projects.locations.operations.cancel" call. // Any non-2xx status code is an error. Response headers are in either -// *Policy.ServerResponse.Header or (if a response was returned at all) in +// *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 *ProjectsLocationsFoldersGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +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 { @@ -4177,7 +3821,7 @@ func (c *ProjectsLocationsFoldersGetIamPolicyCall) Do(opts ...googleapi.CallOpti if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4188,84 +3832,77 @@ func (c *ProjectsLocationsFoldersGetIamPolicyCall) Do(opts ...googleapi.CallOpti if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.folders.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.cancel", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsFoldersSetIamPolicyCall struct { - s *Service - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsOperationsDeleteCall struct { + s *Service + name string + 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. +// 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`. // -// - 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 *ProjectsLocationsFoldersService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsFoldersSetIamPolicyCall { - c := &ProjectsLocationsFoldersSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.setiampolicyrequest = setiampolicyrequest +// - 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 *ProjectsLocationsFoldersSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsFoldersSetIamPolicyCall { +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 *ProjectsLocationsFoldersSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsFoldersSetIamPolicyCall { +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 *ProjectsLocationsFoldersSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsOperationsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsFoldersSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.setiampolicyrequest) - if err != nil { - return nil, err - } +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, "v1beta1/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } 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", "dataform.projects.locations.folders.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.folders.setIamPolicy" call. +// Do executes the "dataform.projects.locations.operations.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *Policy.ServerResponse.Header or (if a response was returned at all) in +// *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 *ProjectsLocationsFoldersSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +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 { @@ -4284,7 +3921,7 @@ func (c *ProjectsLocationsFoldersSetIamPolicyCall) Do(opts ...googleapi.CallOpti if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4295,88 +3932,88 @@ func (c *ProjectsLocationsFoldersSetIamPolicyCall) Do(opts ...googleapi.CallOpti if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.folders.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsFoldersTestIamPermissionsCall struct { - s *Service - resource string - testiampermissionsrequest *TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsOperationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + 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. +// 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. // -// - 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 *ProjectsLocationsFoldersService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsFoldersTestIamPermissionsCall { - c := &ProjectsLocationsFoldersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest +// - 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 *ProjectsLocationsFoldersTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsFoldersTestIamPermissionsCall { +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 *ProjectsLocationsFoldersTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsFoldersTestIamPermissionsCall { +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 *ProjectsLocationsFoldersTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsOperationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsFoldersTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.testiampermissionsrequest) - if err != nil { - return nil, err +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, "v1beta1/{+resource}:testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + 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, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.folders.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.folders.testIamPermissions" call. +// Do executes the "dataform.projects.locations.operations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *TestIamPermissionsResponse.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 *ProjectsLocationsFoldersTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { +// *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 { @@ -4395,7 +4032,7 @@ func (c *ProjectsLocationsFoldersTestIamPermissionsCall) Do(opts ...googleapi.Ca if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &TestIamPermissionsResponse{ + ret := &Operation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4406,71 +4043,90 @@ func (c *ProjectsLocationsFoldersTestIamPermissionsCall) Do(opts ...googleapi.Ca if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.folders.testIamPermissions", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.get", "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`. +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 resource to be cancelled. -func (r *ProjectsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *ProjectsLocationsOperationsCancelCall { - c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - 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 - c.canceloperationrequest = canceloperationrequest + 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 *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { +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 *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { +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 *ProjectsLocationsOperationsCancelCall) Header() http.Header { +func (c *ProjectsLocationsOperationsListCall) 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 +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, "v1beta1/{+name}:cancel") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}/operations") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -4478,16 +4134,17 @@ func (c *ProjectsLocationsOperationsCancelCall) doRequest(alt string) (*http.Res googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.operations.cancel" call. +// Do executes the "dataform.projects.locations.operations.list" 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) { +// *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 { @@ -4506,7 +4163,7 @@ func (c *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &ListOperationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4517,60 +4174,85 @@ func (c *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.cancel", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsOperationsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// 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) + } } -// 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`. +type ProjectsLocationsRepositoriesCommitCall struct { + s *Service + name string + commitrepositorychangesrequest *CommitRepositoryChangesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Commit: Applies a Git commit to a Repository. The Repository must not have a +// value for `git_remote_settings.url`. // -// - 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)} +// - name: The repository's name. +func (r *ProjectsLocationsRepositoriesService) Commit(name string, commitrepositorychangesrequest *CommitRepositoryChangesRequest) *ProjectsLocationsRepositoriesCommitCall { + c := &ProjectsLocationsRepositoriesCommitCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.commitrepositorychangesrequest = commitrepositorychangesrequest 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 { +func (c *ProjectsLocationsRepositoriesCommitCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCommitCall { 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 { +func (c *ProjectsLocationsRepositoriesCommitCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCommitCall { 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 { +func (c *ProjectsLocationsRepositoriesCommitCall) 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_) +func (c *ProjectsLocationsRepositoriesCommitCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.commitrepositorychangesrequest) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:commit") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -4578,16 +4260,17 @@ func (c *ProjectsLocationsOperationsDeleteCall) doRequest(alt string) (*http.Res googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.commit", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.operations.delete" call. +// Do executes the "dataform.projects.locations.repositories.commit" 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) { +// *CommitRepositoryChangesResponse.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 *ProjectsLocationsRepositoriesCommitCall) Do(opts ...googleapi.CallOption) (*CommitRepositoryChangesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4606,7 +4289,7 @@ func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &CommitRepositoryChangesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4617,11 +4300,11 @@ func (c *ProjectsLocationsOperationsDeleteCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.commit", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsOperationsGetCall struct { +type ProjectsLocationsRepositoriesComputeAccessTokenStatusCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -4630,13 +4313,11 @@ type ProjectsLocationsOperationsGetCall struct { 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. +// ComputeAccessTokenStatus: Computes a Repository's Git access token status. // -// - name: The name of the operation resource. -func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { - c := &ProjectsLocationsOperationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The repository's name. +func (r *ProjectsLocationsRepositoriesService) ComputeAccessTokenStatus(name string) *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall { + c := &ProjectsLocationsRepositoriesComputeAccessTokenStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -4644,7 +4325,7 @@ func (r *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocations // 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 { +func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -4652,34 +4333,34 @@ func (c *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *Proje // 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 { +func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall { 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 { +func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall { 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 { +func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) 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 := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:computeAccessTokenStatus") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -4689,16 +4370,17 @@ func (c *ProjectsLocationsOperationsGetCall) doRequest(alt string) (*http.Respon googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.computeAccessTokenStatus", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.operations.get" call. +// Do executes the "dataform.projects.locations.repositories.computeAccessTokenStatus" 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) { +// *ComputeRepositoryAccessTokenStatusResponse.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 *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Do(opts ...googleapi.CallOption) (*ComputeRepositoryAccessTokenStatusResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4717,7 +4399,7 @@ func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (* if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Operation{ + ret := &ComputeRepositoryAccessTokenStatusResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4728,108 +4410,89 @@ func (c *ProjectsLocationsOperationsGetCall) Do(opts ...googleapi.CallOption) (* if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.computeAccessTokenStatus", "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 +type ProjectsLocationsRepositoriesCreateCall struct { + s *Service + parent string + repository *Repository + urlParams_ gensupport.URLParams + 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`. +// Create: Creates a new Repository in a given project and location. // -// - 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) +// - parent: The location in which to create the repository. Must be in the +// format `projects/*/locations/*`. +func (r *ProjectsLocationsRepositoriesService) Create(parent string, repository *Repository) *ProjectsLocationsRepositoriesCreateCall { + c := &ProjectsLocationsRepositoriesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.repository = repository 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) +// RepositoryId sets the optional parameter "repositoryId": Required. The ID to +// use for the repository, which will become the final component of the +// repository's resource name. +func (c *ProjectsLocationsRepositoriesCreateCall) RepositoryId(repositoryId string) *ProjectsLocationsRepositoriesCreateCall { + c.urlParams_.Set("repositoryId", repositoryId) 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 { +func (c *ProjectsLocationsRepositoriesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCreateCall { 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 { +func (c *ProjectsLocationsRepositoriesCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCreateCall { 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 { +func (c *ProjectsLocationsRepositoriesCreateCall) 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_) +func (c *ProjectsLocationsRepositoriesCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.repository) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}/operations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/repositories") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + 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, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.operations.list" call. +// Do executes the "dataform.projects.locations.repositories.create" 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) { +// *Repository.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 *ProjectsLocationsRepositoriesCreateCall) Do(opts ...googleapi.CallOption) (*Repository, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4848,7 +4511,7 @@ func (c *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) ( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListOperationsResponse{ + ret := &Repository{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4859,85 +4522,68 @@ func (c *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) ( if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.operations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.create", "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) - } -} - -type ProjectsLocationsRepositoriesCommitCall struct { - s *Service - name string - commitrepositorychangesrequest *CommitRepositoryChangesRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Commit: Applies a Git commit to a Repository. The Repository must not have a -// value for `git_remote_settings.url`. +// Delete: Deletes a single Repository. // // - name: The repository's name. -func (r *ProjectsLocationsRepositoriesService) Commit(name string, commitrepositorychangesrequest *CommitRepositoryChangesRequest) *ProjectsLocationsRepositoriesCommitCall { - c := &ProjectsLocationsRepositoriesCommitCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesService) Delete(name string) *ProjectsLocationsRepositoriesDeleteCall { + c := &ProjectsLocationsRepositoriesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.commitrepositorychangesrequest = commitrepositorychangesrequest + return c +} + +// Force sets the optional parameter "force": If set to true, child resources +// of this repository (compilation results and workflow invocations) will also +// be deleted. Otherwise, the request will only succeed if the repository has +// no child resources. **Note:** *This flag doesn't support deletion of +// workspaces, release configs or workflow configs. If any of such resources +// exists in the repository, the request will fail.*. +func (c *ProjectsLocationsRepositoriesDeleteCall) Force(force bool) *ProjectsLocationsRepositoriesDeleteCall { + c.urlParams_.Set("force", fmt.Sprint(force)) 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 *ProjectsLocationsRepositoriesCommitCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCommitCall { +func (c *ProjectsLocationsRepositoriesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesCommitCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCommitCall { +func (c *ProjectsLocationsRepositoriesDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesDeleteCall { 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 *ProjectsLocationsRepositoriesCommitCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesCommitCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.commitrepositorychangesrequest) - if err != nil { - return nil, err - } +func (c *ProjectsLocationsRepositoriesDeleteCall) 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, "v1beta1/{+name}:commit") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -4945,17 +4591,16 @@ func (c *ProjectsLocationsRepositoriesCommitCall) 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", "dataform.projects.locations.repositories.commit", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.commit" call. +// Do executes the "dataform.projects.locations.repositories.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *CommitRepositoryChangesResponse.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 *ProjectsLocationsRepositoriesCommitCall) Do(opts ...googleapi.CallOption) (*CommitRepositoryChangesResponse, error) { +// *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 *ProjectsLocationsRepositoriesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4974,7 +4619,7 @@ func (c *ProjectsLocationsRepositoriesCommitCall) Do(opts ...googleapi.CallOptio if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &CommitRepositoryChangesResponse{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4985,11 +4630,11 @@ func (c *ProjectsLocationsRepositoriesCommitCall) Do(opts ...googleapi.CallOptio if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.commit", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesComputeAccessTokenStatusCall struct { +type ProjectsLocationsRepositoriesFetchHistoryCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -4998,19 +4643,38 @@ type ProjectsLocationsRepositoriesComputeAccessTokenStatusCall struct { header_ http.Header } -// ComputeAccessTokenStatus: Computes a Repository's Git access token status. +// FetchHistory: Fetches a Repository's history of commits. The Repository must +// not have a value for `git_remote_settings.url`. // // - name: The repository's name. -func (r *ProjectsLocationsRepositoriesService) ComputeAccessTokenStatus(name string) *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall { - c := &ProjectsLocationsRepositoriesComputeAccessTokenStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesService) FetchHistory(name string) *ProjectsLocationsRepositoriesFetchHistoryCall { + c := &ProjectsLocationsRepositoriesFetchHistoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } +// PageSize sets the optional parameter "pageSize": Maximum number of commits +// to return. The server may return fewer items than requested. If unspecified, +// the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesFetchHistoryCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesFetchHistoryCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous `FetchRepositoryHistory` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `FetchRepositoryHistory`, with the exception of `page_size`, must match the +// call that provided the page token. +func (c *ProjectsLocationsRepositoriesFetchHistoryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesFetchHistoryCall { + 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 *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall { +func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesFetchHistoryCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -5018,34 +4682,34 @@ func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) 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 *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall { +func (c *ProjectsLocationsRepositoriesFetchHistoryCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesFetchHistoryCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall { +func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesFetchHistoryCall { 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 *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesFetchHistoryCall) 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}:computeAccessTokenStatus") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:fetchHistory") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -5055,17 +4719,17 @@ func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) doRequest(al googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.computeAccessTokenStatus", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.fetchHistory", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.computeAccessTokenStatus" call. +// Do executes the "dataform.projects.locations.repositories.fetchHistory" call. // Any non-2xx status code is an error. Response headers are in either -// *ComputeRepositoryAccessTokenStatusResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *FetchRepositoryHistoryResponse.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 *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Do(opts ...googleapi.CallOption) (*ComputeRepositoryAccessTokenStatusResponse, error) { +func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Do(opts ...googleapi.CallOption) (*FetchRepositoryHistoryResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5084,7 +4748,7 @@ func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Do(opts ...g if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ComputeRepositoryAccessTokenStatusResponse{ + ret := &FetchRepositoryHistoryResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5095,89 +4759,108 @@ func (c *ProjectsLocationsRepositoriesComputeAccessTokenStatusCall) Do(opts ...g if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.computeAccessTokenStatus", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.fetchHistory", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesCreateCall struct { - s *Service - parent string - repository *Repository - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// 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 *ProjectsLocationsRepositoriesFetchHistoryCall) Pages(ctx context.Context, f func(*FetchRepositoryHistoryResponse) 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) + } } -// Create: Creates a new Repository in a given project and location. -// -// - parent: The location in which to create the repository. Must be in the -// format `projects/*/locations/*`. -func (r *ProjectsLocationsRepositoriesService) Create(parent string, repository *Repository) *ProjectsLocationsRepositoriesCreateCall { - c := &ProjectsLocationsRepositoriesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.repository = repository - return c +type ProjectsLocationsRepositoriesFetchRemoteBranchesCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// RepositoryId sets the optional parameter "repositoryId": Required. The ID to -// use for the repository, which will become the final component of the -// repository's resource name. -func (c *ProjectsLocationsRepositoriesCreateCall) RepositoryId(repositoryId string) *ProjectsLocationsRepositoriesCreateCall { - c.urlParams_.Set("repositoryId", repositoryId) +// FetchRemoteBranches: Fetches a Repository's remote branches. +// +// - name: The repository's name. +func (r *ProjectsLocationsRepositoriesService) FetchRemoteBranches(name string) *ProjectsLocationsRepositoriesFetchRemoteBranchesCall { + c := &ProjectsLocationsRepositoriesFetchRemoteBranchesCall{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 *ProjectsLocationsRepositoriesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCreateCall { +func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesFetchRemoteBranchesCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCreateCall { - c.ctx_ = ctx +// 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 *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesFetchRemoteBranchesCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesFetchRemoteBranchesCall { + 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 *ProjectsLocationsRepositoriesCreateCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.repository) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) 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/{+parent}/repositories") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:fetchRemoteBranches") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + 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, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.fetchRemoteBranches", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.create" call. +// Do executes the "dataform.projects.locations.repositories.fetchRemoteBranches" call. // Any non-2xx status code is an error. Response headers are in either -// *Repository.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 *ProjectsLocationsRepositoriesCreateCall) Do(opts ...googleapi.CallOption) (*Repository, error) { +// *FetchRemoteBranchesResponse.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 *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Do(opts ...googleapi.CallOption) (*FetchRemoteBranchesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5196,7 +4879,7 @@ func (c *ProjectsLocationsRepositoriesCreateCall) Do(opts ...googleapi.CallOptio if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Repository{ + ret := &FetchRemoteBranchesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5207,68 +4890,69 @@ func (c *ProjectsLocationsRepositoriesCreateCall) Do(opts ...googleapi.CallOptio if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.fetchRemoteBranches", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a single Repository. +// Get: Fetches a single Repository. // // - name: The repository's name. -func (r *ProjectsLocationsRepositoriesService) Delete(name string) *ProjectsLocationsRepositoriesDeleteCall { - c := &ProjectsLocationsRepositoriesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesService) Get(name string) *ProjectsLocationsRepositoriesGetCall { + c := &ProjectsLocationsRepositoriesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// Force sets the optional parameter "force": If set to true, child resources -// of this repository (compilation results and workflow invocations) will also -// be deleted. Otherwise, the request will only succeed if the repository has -// no child resources. **Note:** *This flag doesn't support deletion of -// workspaces, release configs or workflow configs. If any of such resources -// exists in the repository, the request will fail.*. -func (c *ProjectsLocationsRepositoriesDeleteCall) Force(force bool) *ProjectsLocationsRepositoriesDeleteCall { - c.urlParams_.Set("force", fmt.Sprint(force)) - 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 *ProjectsLocationsRepositoriesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesDeleteCall { +func (c *ProjectsLocationsRepositoriesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesGetCall { 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 *ProjectsLocationsRepositoriesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesDeleteCall { +func (c *ProjectsLocationsRepositoriesGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesGetCall { 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 *ProjectsLocationsRepositoriesDeleteCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesGetCall) 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("DELETE", urls, nil) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -5276,16 +4960,16 @@ func (c *ProjectsLocationsRepositoriesDeleteCall) 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", "dataform.projects.locations.repositories.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.delete" call. +// Do executes the "dataform.projects.locations.repositories.get" 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 +// *Repository.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 *ProjectsLocationsRepositoriesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { +func (c *ProjectsLocationsRepositoriesGetCall) Do(opts ...googleapi.CallOption) (*Repository, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5304,7 +4988,7 @@ func (c *ProjectsLocationsRepositoriesDeleteCall) Do(opts ...googleapi.CallOptio if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &Repository{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5315,43 +4999,59 @@ func (c *ProjectsLocationsRepositoriesDeleteCall) Do(opts ...googleapi.CallOptio if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesFetchHistoryCall struct { +type ProjectsLocationsRepositoriesListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// FetchHistory: Fetches a Repository's history of commits. The Repository must -// not have a value for `git_remote_settings.url`. +// List: Lists Repositories in a given project and location. **Note:** *This +// method can return repositories not shown in the Dataform UI +// (https://console.cloud.google.com/bigquery/dataform)*. // -// - name: The repository's name. -func (r *ProjectsLocationsRepositoriesService) FetchHistory(name string) *ProjectsLocationsRepositoriesFetchHistoryCall { - c := &ProjectsLocationsRepositoriesFetchHistoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The location in which to list repositories. Must be in the format +// `projects/*/locations/*`. +func (r *ProjectsLocationsRepositoriesService) List(parent string) *ProjectsLocationsRepositoriesListCall { + c := &ProjectsLocationsRepositoriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } -// PageSize sets the optional parameter "pageSize": Maximum number of commits -// to return. The server may return fewer items than requested. If unspecified, -// the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesFetchHistoryCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesFetchHistoryCall { +// Filter sets the optional parameter "filter": Filter for the returned list. +func (c *ProjectsLocationsRepositoriesListCall) Filter(filter string) *ProjectsLocationsRepositoriesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": This field only supports +// ordering by `name`. If unspecified, the server will choose the ordering. If +// specified, the default order is ascending for the `name` field. +func (c *ProjectsLocationsRepositoriesListCall) OrderBy(orderBy string) *ProjectsLocationsRepositoriesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// repositories to return. The server may return fewer items than requested. If +// unspecified, the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": Page token received from -// a previous `FetchRepositoryHistory` call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// `FetchRepositoryHistory`, with the exception of `page_size`, must match the -// call that provided the page token. -func (c *ProjectsLocationsRepositoriesFetchHistoryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesFetchHistoryCall { +// a previous `ListRepositories` call. Provide this to retrieve the subsequent +// page. When paginating, all other parameters provided to `ListRepositories`, +// with the exception of `page_size`, must match the call that provided the +// page token. +func (c *ProjectsLocationsRepositoriesListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -5359,7 +5059,7 @@ func (c *ProjectsLocationsRepositoriesFetchHistoryCall) PageToken(pageToken stri // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesFetchHistoryCall { +func (c *ProjectsLocationsRepositoriesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -5367,34 +5067,34 @@ func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Fields(s ...googleapi.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 *ProjectsLocationsRepositoriesFetchHistoryCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesFetchHistoryCall { +func (c *ProjectsLocationsRepositoriesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesFetchHistoryCall { +func (c *ProjectsLocationsRepositoriesListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesListCall { 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 *ProjectsLocationsRepositoriesFetchHistoryCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesFetchHistoryCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesListCall) 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}:fetchHistory") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/repositories") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -5402,19 +5102,19 @@ func (c *ProjectsLocationsRepositoriesFetchHistoryCall) doRequest(alt string) (* } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.fetchHistory", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.fetchHistory" call. +// Do executes the "dataform.projects.locations.repositories.list" call. // Any non-2xx status code is an error. Response headers are in either -// *FetchRepositoryHistoryResponse.ServerResponse.Header or (if a response was +// *ListRepositoriesResponse.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 *ProjectsLocationsRepositoriesFetchHistoryCall) Do(opts ...googleapi.CallOption) (*FetchRepositoryHistoryResponse, error) { +func (c *ProjectsLocationsRepositoriesListCall) Do(opts ...googleapi.CallOption) (*ListRepositoriesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5433,7 +5133,7 @@ func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Do(opts ...googleapi.Cal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &FetchRepositoryHistoryResponse{ + ret := &ListRepositoriesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5444,14 +5144,14 @@ func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Do(opts ...googleapi.Cal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.fetchHistory", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.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 *ProjectsLocationsRepositoriesFetchHistoryCall) Pages(ctx context.Context, f func(*FetchRepositoryHistoryResponse) error) error { +func (c *ProjectsLocationsRepositoriesListCall) Pages(ctx context.Context, f func(*ListRepositoriesResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -5469,65 +5169,69 @@ func (c *ProjectsLocationsRepositoriesFetchHistoryCall) Pages(ctx context.Contex } } -type ProjectsLocationsRepositoriesFetchRemoteBranchesCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesPatchCall struct { + s *Service + name string + repository *Repository + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// FetchRemoteBranches: Fetches a Repository's remote branches. +// Patch: Updates a single Repository. **Note:** *This method does not fully +// implement AIP/134 (https://google.aip.dev/134). The wildcard entry (\*) is +// treated as a bad request, and when the `field_mask` is omitted, the request +// is treated as a full update on all modifiable fields.* // -// - name: The repository's name. -func (r *ProjectsLocationsRepositoriesService) FetchRemoteBranches(name string) *ProjectsLocationsRepositoriesFetchRemoteBranchesCall { - c := &ProjectsLocationsRepositoriesFetchRemoteBranchesCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Identifier. The repository's name. +func (r *ProjectsLocationsRepositoriesService) Patch(name string, repository *Repository) *ProjectsLocationsRepositoriesPatchCall { + c := &ProjectsLocationsRepositoriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name + c.repository = repository + return c +} + +// UpdateMask sets the optional parameter "updateMask": Specifies the fields to +// be updated in the repository. If left unset, all fields will be updated. +func (c *ProjectsLocationsRepositoriesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsRepositoriesPatchCall { + 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 *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesFetchRemoteBranchesCall { +func (c *ProjectsLocationsRepositoriesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesPatchCall { 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 *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesFetchRemoteBranchesCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesFetchRemoteBranchesCall { +func (c *ProjectsLocationsRepositoriesPatchCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesPatchCall { 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 *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) 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 *ProjectsLocationsRepositoriesPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.repository) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:fetchRemoteBranches") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -5535,17 +5239,16 @@ func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) doRequest(alt str googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.fetchRemoteBranches", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.fetchRemoteBranches" call. +// Do executes the "dataform.projects.locations.repositories.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *FetchRemoteBranchesResponse.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 *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Do(opts ...googleapi.CallOption) (*FetchRemoteBranchesResponse, error) { +// *Repository.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 *ProjectsLocationsRepositoriesPatchCall) Do(opts ...googleapi.CallOption) (*Repository, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5564,7 +5267,7 @@ func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Do(opts ...google if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &FetchRemoteBranchesResponse{ + ret := &Repository{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5575,11 +5278,11 @@ func (c *ProjectsLocationsRepositoriesFetchRemoteBranchesCall) Do(opts ...google if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.fetchRemoteBranches", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesGetCall struct { +type ProjectsLocationsRepositoriesQueryDirectoryContentsCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -5588,19 +5291,53 @@ type ProjectsLocationsRepositoriesGetCall struct { header_ http.Header } -// Get: Fetches a single Repository. +// QueryDirectoryContents: Returns the contents of a given Repository +// directory. The Repository must not have a value for +// `git_remote_settings.url`. // // - name: The repository's name. -func (r *ProjectsLocationsRepositoriesService) Get(name string) *ProjectsLocationsRepositoriesGetCall { - c := &ProjectsLocationsRepositoriesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesService) QueryDirectoryContents(name string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { + c := &ProjectsLocationsRepositoriesQueryDirectoryContentsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } +// CommitSha sets the optional parameter "commitSha": The Commit SHA for the +// commit to query from. If unset, the directory will be queried from HEAD. +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) CommitSha(commitSha string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { + c.urlParams_.Set("commitSha", commitSha) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of paths to +// return. The server may return fewer items than requested. If unspecified, +// the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous `QueryRepositoryDirectoryContents` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `QueryRepositoryDirectoryContents`, with the exception of `page_size`, must +// match the call that provided the page token. +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Path sets the optional parameter "path": The directory's full path including +// directory name, relative to root. If left unset, the root is used. +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Path(path string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { + c.urlParams_.Set("path", path) + 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 *ProjectsLocationsRepositoriesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesGetCall { +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -5608,34 +5345,34 @@ func (c *ProjectsLocationsRepositoriesGetCall) Fields(s ...googleapi.Field) *Pro // 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 *ProjectsLocationsRepositoriesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesGetCall { +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesGetCall { +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { 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 *ProjectsLocationsRepositoriesGetCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) 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 := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:queryDirectoryContents") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -5645,16 +5382,17 @@ func (c *ProjectsLocationsRepositoriesGetCall) doRequest(alt string) (*http.Resp googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.queryDirectoryContents", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.get" call. +// Do executes the "dataform.projects.locations.repositories.queryDirectoryContents" call. // Any non-2xx status code is an error. Response headers are in either -// *Repository.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 *ProjectsLocationsRepositoriesGetCall) Do(opts ...googleapi.CallOption) (*Repository, error) { +// *QueryRepositoryDirectoryContentsResponse.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 *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Do(opts ...googleapi.CallOption) (*QueryRepositoryDirectoryContentsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5673,7 +5411,7 @@ func (c *ProjectsLocationsRepositoriesGetCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Repository{ + ret := &QueryRepositoryDirectoryContentsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5684,52 +5422,68 @@ func (c *ProjectsLocationsRepositoriesGetCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.queryDirectoryContents", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesGetIamPolicyCall struct { +// 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 *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Pages(ctx context.Context, f func(*QueryRepositoryDirectoryContentsResponse) 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 ProjectsLocationsRepositoriesReadFileCall struct { s *Service - resource string + name 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. +// ReadFile: Returns the contents of a file (inside a Repository). The +// Repository must not have a value for `git_remote_settings.url`. // -// - 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 *ProjectsLocationsRepositoriesService) GetIamPolicy(resource string) *ProjectsLocationsRepositoriesGetIamPolicyCall { - c := &ProjectsLocationsRepositoriesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource +// - name: The repository's name. +func (r *ProjectsLocationsRepositoriesService) ReadFile(name string) *ProjectsLocationsRepositoriesReadFileCall { + c := &ProjectsLocationsRepositoriesReadFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// CommitSha sets the optional parameter "commitSha": The commit SHA for the +// commit to read from. If unset, the file will be read from HEAD. +func (c *ProjectsLocationsRepositoriesReadFileCall) CommitSha(commitSha string) *ProjectsLocationsRepositoriesReadFileCall { + c.urlParams_.Set("commitSha", commitSha) 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 *ProjectsLocationsRepositoriesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRepositoriesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// Path sets the optional parameter "path": Required. Full file path to read +// including filename, from repository root. +func (c *ProjectsLocationsRepositoriesReadFileCall) Path(path string) *ProjectsLocationsRepositoriesReadFileCall { + c.urlParams_.Set("path", path) 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 *ProjectsLocationsRepositoriesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesGetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesReadFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReadFileCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -5737,34 +5491,34 @@ func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) Fields(s ...googleapi.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 *ProjectsLocationsRepositoriesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesGetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesReadFileCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesReadFileCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesGetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesReadFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReadFileCall { 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 *ProjectsLocationsRepositoriesGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesReadFileCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesReadFileCall) 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/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:readFile") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -5772,18 +5526,19 @@ func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) doRequest(alt string) (* } 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", "dataform.projects.locations.repositories.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.readFile", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.getIamPolicy" call. +// Do executes the "dataform.projects.locations.repositories.readFile" call. // Any non-2xx status code is an error. Response headers are in either -// *Policy.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 *ProjectsLocationsRepositoriesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +// *ReadRepositoryFileResponse.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 *ProjectsLocationsRepositoriesReadFileCall) Do(opts ...googleapi.CallOption) (*ReadRepositoryFileResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5802,7 +5557,7 @@ func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) Do(opts ...googleapi.Cal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &ReadRepositoryFileResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5813,104 +5568,64 @@ func (c *ProjectsLocationsRepositoriesGetIamPolicyCall) Do(opts ...googleapi.Cal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.readFile", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesCompilationResultsCreateCall struct { + s *Service + parent string + compilationresult *CompilationResult + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists Repositories in a given project and location. **Note:** *This -// method can return repositories not shown in the Dataform UI -// (https://console.cloud.google.com/bigquery/dataform)*. +// Create: Creates a new CompilationResult in a given project and location. // -// - parent: The location in which to list repositories. Must be in the format -// `projects/*/locations/*`. -func (r *ProjectsLocationsRepositoriesService) List(parent string) *ProjectsLocationsRepositoriesListCall { - c := &ProjectsLocationsRepositoriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The repository in which to create the compilation result. Must be +// in the format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesCompilationResultsService) Create(parent string, compilationresult *CompilationResult) *ProjectsLocationsRepositoriesCompilationResultsCreateCall { + c := &ProjectsLocationsRepositoriesCompilationResultsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter for the returned list. -func (c *ProjectsLocationsRepositoriesListCall) Filter(filter string) *ProjectsLocationsRepositoriesListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": This field only supports -// ordering by `name`. If unspecified, the server will choose the ordering. If -// specified, the default order is ascending for the `name` field. -func (c *ProjectsLocationsRepositoriesListCall) OrderBy(orderBy string) *ProjectsLocationsRepositoriesListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// repositories to return. The server may return fewer items than requested. If -// unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token received from -// a previous `ListRepositories` call. Provide this to retrieve the subsequent -// page. When paginating, all other parameters provided to `ListRepositories`, -// with the exception of `page_size`, must match the call that provided the -// page token. -func (c *ProjectsLocationsRepositoriesListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesListCall { - c.urlParams_.Set("pageToken", pageToken) + c.compilationresult = compilationresult 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 *ProjectsLocationsRepositoriesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesListCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCompilationResultsCreateCall { 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 *ProjectsLocationsRepositoriesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesListCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCompilationResultsCreateCall { 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 *ProjectsLocationsRepositoriesListCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesListCall) 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 *ProjectsLocationsRepositoriesCompilationResultsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.compilationresult) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/repositories") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/compilationResults") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -5918,17 +5633,17 @@ func (c *ProjectsLocationsRepositoriesListCall) doRequest(alt string) (*http.Res googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.list" call. +// Do executes the "dataform.projects.locations.repositories.compilationResults.create" call. // Any non-2xx status code is an error. Response headers are in either -// *ListRepositoriesResponse.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 *ProjectsLocationsRepositoriesListCall) Do(opts ...googleapi.CallOption) (*ListRepositoriesResponse, error) { +// *CompilationResult.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 *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Do(opts ...googleapi.CallOption) (*CompilationResult, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -5947,7 +5662,7 @@ func (c *ProjectsLocationsRepositoriesListCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListRepositoriesResponse{ + ret := &CompilationResult{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -5958,94 +5673,69 @@ func (c *ProjectsLocationsRepositoriesListCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.create", "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 *ProjectsLocationsRepositoriesListCall) Pages(ctx context.Context, f func(*ListRepositoriesResponse) 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 ProjectsLocationsRepositoriesPatchCall struct { - s *Service - name string - repository *Repository - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesCompilationResultsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Patch: Updates a single Repository. **Note:** *This method does not fully -// implement AIP/134 (https://google.aip.dev/134). The wildcard entry (\*) is -// treated as a bad request, and when the `field_mask` is omitted, the request -// is treated as a full update on all modifiable fields.* +// Get: Fetches a single CompilationResult. // -// - name: Identifier. The repository's name. -func (r *ProjectsLocationsRepositoriesService) Patch(name string, repository *Repository) *ProjectsLocationsRepositoriesPatchCall { - c := &ProjectsLocationsRepositoriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The compilation result's name. +func (r *ProjectsLocationsRepositoriesCompilationResultsService) Get(name string) *ProjectsLocationsRepositoriesCompilationResultsGetCall { + c := &ProjectsLocationsRepositoriesCompilationResultsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.repository = repository - return c -} - -// UpdateMask sets the optional parameter "updateMask": Specifies the fields to -// be updated in the repository. If left unset, all fields will be updated. -func (c *ProjectsLocationsRepositoriesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsRepositoriesPatchCall { - 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 *ProjectsLocationsRepositoriesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesPatchCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCompilationResultsGetCall { 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 *ProjectsLocationsRepositoriesCompilationResultsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesCompilationResultsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesPatchCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesPatchCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCompilationResultsGetCall { 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 *ProjectsLocationsRepositoriesPatchCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.repository) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) 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("PATCH", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -6053,16 +5743,17 @@ func (c *ProjectsLocationsRepositoriesPatchCall) 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", "dataform.projects.locations.repositories.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.patch" call. +// Do executes the "dataform.projects.locations.repositories.compilationResults.get" call. // Any non-2xx status code is an error. Response headers are in either -// *Repository.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 *ProjectsLocationsRepositoriesPatchCall) Do(opts ...googleapi.CallOption) (*Repository, error) { +// *CompilationResult.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 *ProjectsLocationsRepositoriesCompilationResultsGetCall) Do(opts ...googleapi.CallOption) (*CompilationResult, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6081,7 +5772,7 @@ func (c *ProjectsLocationsRepositoriesPatchCall) Do(opts ...googleapi.CallOption if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Repository{ + ret := &CompilationResult{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6092,66 +5783,66 @@ func (c *ProjectsLocationsRepositoriesPatchCall) Do(opts ...googleapi.CallOption if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesQueryDirectoryContentsCall struct { +type ProjectsLocationsRepositoriesCompilationResultsListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// QueryDirectoryContents: Returns the contents of a given Repository -// directory. The Repository must not have a value for -// `git_remote_settings.url`. +// List: Lists CompilationResults in a given Repository. // -// - name: The repository's name. -func (r *ProjectsLocationsRepositoriesService) QueryDirectoryContents(name string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { - c := &ProjectsLocationsRepositoriesQueryDirectoryContentsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The repository in which to list compilation results. Must be in +// the format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesCompilationResultsService) List(parent string) *ProjectsLocationsRepositoriesCompilationResultsListCall { + c := &ProjectsLocationsRepositoriesCompilationResultsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } -// CommitSha sets the optional parameter "commitSha": The Commit SHA for the -// commit to query from. If unset, the directory will be queried from HEAD. -func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) CommitSha(commitSha string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { - c.urlParams_.Set("commitSha", commitSha) +// Filter sets the optional parameter "filter": Filter for the returned list. +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) Filter(filter string) *ProjectsLocationsRepositoriesCompilationResultsListCall { + c.urlParams_.Set("filter", filter) return c } -// PageSize sets the optional parameter "pageSize": Maximum number of paths to -// return. The server may return fewer items than requested. If unspecified, -// the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) +// OrderBy sets the optional parameter "orderBy": This field only supports +// ordering by `name` and `create_time`. If unspecified, the server will choose +// the ordering. If specified, the default order is ascending for the `name` +// field. +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) OrderBy(orderBy string) *ProjectsLocationsRepositoriesCompilationResultsListCall { + c.urlParams_.Set("orderBy", orderBy) return c } -// PageToken sets the optional parameter "pageToken": Page token received from -// a previous `QueryRepositoryDirectoryContents` call. Provide this to retrieve -// the subsequent page. When paginating, all other parameters provided to -// `QueryRepositoryDirectoryContents`, with the exception of `page_size`, must -// match the call that provided the page token. -func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { - c.urlParams_.Set("pageToken", pageToken) +// PageSize sets the optional parameter "pageSize": Maximum number of +// compilation results to return. The server may return fewer items than +// requested. If unspecified, the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesCompilationResultsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// Path sets the optional parameter "path": The directory's full path including -// directory name, relative to root. If left unset, the root is used. -func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Path(path string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { - c.urlParams_.Set("path", path) +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous `ListCompilationResults` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListCompilationResults`, with the exception of `page_size`, must match the +// call that provided the page token. +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesCompilationResultsListCall { + 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 *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCompilationResultsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -6159,34 +5850,34 @@ func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) 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 *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesCompilationResultsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesQueryDirectoryContentsCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCompilationResultsListCall { 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 *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) 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}:queryDirectoryContents") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/compilationResults") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -6194,19 +5885,19 @@ func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) doRequest(alt } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.queryDirectoryContents", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.queryDirectoryContents" call. +// Do executes the "dataform.projects.locations.repositories.compilationResults.list" call. // Any non-2xx status code is an error. Response headers are in either -// *QueryRepositoryDirectoryContentsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *ListCompilationResultsResponse.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 *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Do(opts ...googleapi.CallOption) (*QueryRepositoryDirectoryContentsResponse, error) { +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) Do(opts ...googleapi.CallOption) (*ListCompilationResultsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6225,7 +5916,7 @@ func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &QueryRepositoryDirectoryContentsResponse{ + ret := &ListCompilationResultsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6236,14 +5927,14 @@ func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.queryDirectoryContents", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.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 *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Pages(ctx context.Context, f func(*QueryRepositoryDirectoryContentsResponse) error) error { +func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) Pages(ctx context.Context, f func(*ListCompilationResultsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -6261,7 +5952,7 @@ func (c *ProjectsLocationsRepositoriesQueryDirectoryContentsCall) Pages(ctx cont } } -type ProjectsLocationsRepositoriesReadFileCall struct { +type ProjectsLocationsRepositoriesCompilationResultsQueryCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -6270,34 +5961,45 @@ type ProjectsLocationsRepositoriesReadFileCall struct { header_ http.Header } -// ReadFile: Returns the contents of a file (inside a Repository). The -// Repository must not have a value for `git_remote_settings.url`. +// Query: Returns CompilationResultActions in a given CompilationResult. // -// - name: The repository's name. -func (r *ProjectsLocationsRepositoriesService) ReadFile(name string) *ProjectsLocationsRepositoriesReadFileCall { - c := &ProjectsLocationsRepositoriesReadFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The compilation result's name. +func (r *ProjectsLocationsRepositoriesCompilationResultsService) Query(name string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { + c := &ProjectsLocationsRepositoriesCompilationResultsQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } -// CommitSha sets the optional parameter "commitSha": The commit SHA for the -// commit to read from. If unset, the file will be read from HEAD. -func (c *ProjectsLocationsRepositoriesReadFileCall) CommitSha(commitSha string) *ProjectsLocationsRepositoriesReadFileCall { - c.urlParams_.Set("commitSha", commitSha) +// Filter sets the optional parameter "filter": Optional filter for the +// returned list. Filtering is only currently supported on the `file_path` +// field. +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Filter(filter string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { + c.urlParams_.Set("filter", filter) return c } -// Path sets the optional parameter "path": Required. Full file path to read -// including filename, from repository root. -func (c *ProjectsLocationsRepositoriesReadFileCall) Path(path string) *ProjectsLocationsRepositoriesReadFileCall { - c.urlParams_.Set("path", path) +// PageSize sets the optional parameter "pageSize": Maximum number of +// compilation results to return. The server may return fewer items than +// requested. If unspecified, the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous `QueryCompilationResultActions` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `QueryCompilationResultActions`, with the exception of `page_size`, must +// match the call that provided the page token. +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { + 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 *ProjectsLocationsRepositoriesReadFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReadFileCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -6305,34 +6007,34 @@ func (c *ProjectsLocationsRepositoriesReadFileCall) 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 *ProjectsLocationsRepositoriesReadFileCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesReadFileCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesReadFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReadFileCall { +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { 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 *ProjectsLocationsRepositoriesReadFileCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesReadFileCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) 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}:readFile") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:query") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -6342,17 +6044,17 @@ func (c *ProjectsLocationsRepositoriesReadFileCall) doRequest(alt string) (*http googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.readFile", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.query", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.readFile" call. +// Do executes the "dataform.projects.locations.repositories.compilationResults.query" call. // Any non-2xx status code is an error. Response headers are in either -// *ReadRepositoryFileResponse.ServerResponse.Header or (if a response was -// returned at all) in error.(*googleapi.Error).Header. Use +// *QueryCompilationResultActionsResponse.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 *ProjectsLocationsRepositoriesReadFileCall) Do(opts ...googleapi.CallOption) (*ReadRepositoryFileResponse, error) { +func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Do(opts ...googleapi.CallOption) (*QueryCompilationResultActionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6371,7 +6073,7 @@ func (c *ProjectsLocationsRepositoriesReadFileCall) Do(opts ...googleapi.CallOpt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ReadRepositoryFileResponse{ + ret := &QueryCompilationResultActionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6382,65 +6084,91 @@ func (c *ProjectsLocationsRepositoriesReadFileCall) Do(opts ...googleapi.CallOpt if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.readFile", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.query", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesSetIamPolicyCall struct { - s *Service - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// 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 *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Pages(ctx context.Context, f func(*QueryCompilationResultActionsResponse) 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) + } } -// 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 *ProjectsLocationsRepositoriesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsRepositoriesSetIamPolicyCall { - c := &ProjectsLocationsRepositoriesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.setiampolicyrequest = setiampolicyrequest - return c +type ProjectsLocationsRepositoriesReleaseConfigsCreateCall struct { + s *Service + parent string + releaseconfig *ReleaseConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new ReleaseConfig in a given Repository. +// +// - parent: The repository in which to create the release config. Must be in +// the format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesReleaseConfigsService) Create(parent string, releaseconfig *ReleaseConfig) *ProjectsLocationsRepositoriesReleaseConfigsCreateCall { + c := &ProjectsLocationsRepositoriesReleaseConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.releaseconfig = releaseconfig + return c +} + +// ReleaseConfigId sets the optional parameter "releaseConfigId": Required. The +// ID to use for the release config, which will become the final component of +// the release config's resource name. +func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) ReleaseConfigId(releaseConfigId string) *ProjectsLocationsRepositoriesReleaseConfigsCreateCall { + c.urlParams_.Set("releaseConfigId", releaseConfigId) + 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 *ProjectsLocationsRepositoriesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesSetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesSetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsCreateCall { 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 *ProjectsLocationsRepositoriesSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.setiampolicyrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.releaseconfig) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/releaseConfigs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -6448,18 +6176,18 @@ func (c *ProjectsLocationsRepositoriesSetIamPolicyCall) doRequest(alt string) (* } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.setIamPolicy" call. +// Do executes the "dataform.projects.locations.repositories.releaseConfigs.create" call. // Any non-2xx status code is an error. Response headers are in either -// *Policy.ServerResponse.Header or (if a response was returned at all) in -// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check +// *ReleaseConfig.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 *ProjectsLocationsRepositoriesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) Do(opts ...googleapi.CallOption) (*ReleaseConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6478,7 +6206,7 @@ func (c *ProjectsLocationsRepositoriesSetIamPolicyCall) Do(opts ...googleapi.Cal if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &ReleaseConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6489,88 +6217,74 @@ func (c *ProjectsLocationsRepositoriesSetIamPolicyCall) Do(opts ...googleapi.Cal if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesTestIamPermissionsCall struct { - s *Service - resource string - testiampermissionsrequest *TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesReleaseConfigsDeleteCall struct { + s *Service + name string + 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. +// Delete: Deletes a single ReleaseConfig. // -// - 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 *ProjectsLocationsRepositoriesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsRepositoriesTestIamPermissionsCall { - c := &ProjectsLocationsRepositoriesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest +// - name: The release config's name. +func (r *ProjectsLocationsRepositoriesReleaseConfigsService) Delete(name string) *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall { + c := &ProjectsLocationsRepositoriesReleaseConfigsDeleteCall{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 *ProjectsLocationsRepositoriesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesTestIamPermissionsCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesTestIamPermissionsCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall { 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 *ProjectsLocationsRepositoriesTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.testiampermissionsrequest) - if err != nil { - return nil, err - } +func (c *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) 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, "v1beta1/{+resource}:testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } 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", "dataform.projects.locations.repositories.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.testIamPermissions" call. +// Do executes the "dataform.projects.locations.repositories.releaseConfigs.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *TestIamPermissionsResponse.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 *ProjectsLocationsRepositoriesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { +// *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 *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6589,7 +6303,7 @@ func (c *ProjectsLocationsRepositoriesTestIamPermissionsCall) Do(opts ...googlea if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &TestIamPermissionsResponse{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6600,82 +6314,86 @@ func (c *ProjectsLocationsRepositoriesTestIamPermissionsCall) Do(opts ...googlea if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.testIamPermissions", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesCompilationResultsCreateCall struct { - s *Service - parent string - compilationresult *CompilationResult - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesReleaseConfigsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Create: Creates a new CompilationResult in a given project and location. +// Get: Fetches a single ReleaseConfig. // -// - parent: The repository in which to create the compilation result. Must be -// in the format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesCompilationResultsService) Create(parent string, compilationresult *CompilationResult) *ProjectsLocationsRepositoriesCompilationResultsCreateCall { - c := &ProjectsLocationsRepositoriesCompilationResultsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.compilationresult = compilationresult +// - name: The release config's name. +func (r *ProjectsLocationsRepositoriesReleaseConfigsService) Get(name string) *ProjectsLocationsRepositoriesReleaseConfigsGetCall { + c := &ProjectsLocationsRepositoriesReleaseConfigsGetCall{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 *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCompilationResultsCreateCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsGetCall { 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 *ProjectsLocationsRepositoriesReleaseConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesReleaseConfigsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCompilationResultsCreateCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsGetCall { 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 *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesReleaseConfigsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesCompilationResultsCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.compilationresult) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesReleaseConfigsGetCall) 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/{+parent}/compilationResults") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + 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, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.compilationResults.create" call. +// Do executes the "dataform.projects.locations.repositories.releaseConfigs.get" call. // Any non-2xx status code is an error. Response headers are in either -// *CompilationResult.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 *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Do(opts ...googleapi.CallOption) (*CompilationResult, error) { +// *ReleaseConfig.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 *ProjectsLocationsRepositoriesReleaseConfigsGetCall) Do(opts ...googleapi.CallOption) (*ReleaseConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6694,7 +6412,7 @@ func (c *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Do(opts ...g if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &CompilationResult{ + ret := &ReleaseConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6705,32 +6423,51 @@ func (c *ProjectsLocationsRepositoriesCompilationResultsCreateCall) Do(opts ...g if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesCompilationResultsGetCall struct { +type ProjectsLocationsRepositoriesReleaseConfigsListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// Get: Fetches a single CompilationResult. +// List: Lists ReleaseConfigs in a given Repository. // -// - name: The compilation result's name. -func (r *ProjectsLocationsRepositoriesCompilationResultsService) Get(name string) *ProjectsLocationsRepositoriesCompilationResultsGetCall { - c := &ProjectsLocationsRepositoriesCompilationResultsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The repository in which to list release configs. Must be in the +// format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesReleaseConfigsService) List(parent string) *ProjectsLocationsRepositoriesReleaseConfigsListCall { + c := &ProjectsLocationsRepositoriesReleaseConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of release +// configs to return. The server may return fewer items than requested. If +// unspecified, the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesReleaseConfigsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous `ListReleaseConfigs` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListReleaseConfigs`, with the exception of `page_size`, must match the call +// that provided the page token. +func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesReleaseConfigsListCall { + 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 *ProjectsLocationsRepositoriesCompilationResultsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCompilationResultsGetCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -6738,34 +6475,34 @@ func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) Fields(s ...goo // 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 *ProjectsLocationsRepositoriesCompilationResultsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesCompilationResultsGetCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesReleaseConfigsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCompilationResultsGetCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsListCall { 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 *ProjectsLocationsRepositoriesCompilationResultsGetCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) 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 := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/releaseConfigs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -6773,19 +6510,19 @@ func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) doRequest(alt s } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.compilationResults.get" call. +// Do executes the "dataform.projects.locations.repositories.releaseConfigs.list" call. // Any non-2xx status code is an error. Response headers are in either -// *CompilationResult.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 *ProjectsLocationsRepositoriesCompilationResultsGetCall) Do(opts ...googleapi.CallOption) (*CompilationResult, error) { +// *ListReleaseConfigsResponse.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 *ProjectsLocationsRepositoriesReleaseConfigsListCall) Do(opts ...googleapi.CallOption) (*ListReleaseConfigsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -6804,7 +6541,7 @@ func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) Do(opts ...goog if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &CompilationResult{ + ret := &ListReleaseConfigsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -6815,1548 +6552,94 @@ func (c *ProjectsLocationsRepositoriesCompilationResultsGetCall) Do(opts ...goog if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.compilationResults.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesCompilationResultsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +// 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 *ProjectsLocationsRepositoriesReleaseConfigsListCall) Pages(ctx context.Context, f func(*ListReleaseConfigsResponse) 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) + } } -// List: Lists CompilationResults in a given Repository. -// -// - parent: The repository in which to list compilation results. Must be in -// the format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesCompilationResultsService) List(parent string) *ProjectsLocationsRepositoriesCompilationResultsListCall { - c := &ProjectsLocationsRepositoriesCompilationResultsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c +type ProjectsLocationsRepositoriesReleaseConfigsPatchCall struct { + s *Service + name string + releaseconfig *ReleaseConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Filter sets the optional parameter "filter": Filter for the returned list. -func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) Filter(filter string) *ProjectsLocationsRepositoriesCompilationResultsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": This field only supports -// ordering by `name` and `create_time`. If unspecified, the server will choose -// the ordering. If specified, the default order is ascending for the `name` -// field. -func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) OrderBy(orderBy string) *ProjectsLocationsRepositoriesCompilationResultsListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// compilation results to return. The server may return fewer items than -// requested. If unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesCompilationResultsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token received from -// a previous `ListCompilationResults` call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// `ListCompilationResults`, with the exception of `page_size`, must match the -// call that provided the page token. -func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesCompilationResultsListCall { - 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 *ProjectsLocationsRepositoriesCompilationResultsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCompilationResultsListCall { - 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 *ProjectsLocationsRepositoriesCompilationResultsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesCompilationResultsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCompilationResultsListCall { - 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 *ProjectsLocationsRepositoriesCompilationResultsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesCompilationResultsListCall) 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/{+parent}/compilationResults") - 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", "dataform.projects.locations.repositories.compilationResults.list", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.compilationResults.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *ListCompilationResultsResponse.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 *ProjectsLocationsRepositoriesCompilationResultsListCall) Do(opts ...googleapi.CallOption) (*ListCompilationResultsResponse, 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 := &ListCompilationResultsResponse{ - 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", "dataform.projects.locations.repositories.compilationResults.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 *ProjectsLocationsRepositoriesCompilationResultsListCall) Pages(ctx context.Context, f func(*ListCompilationResultsResponse) 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 ProjectsLocationsRepositoriesCompilationResultsQueryCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Query: Returns CompilationResultActions in a given CompilationResult. -// -// - name: The compilation result's name. -func (r *ProjectsLocationsRepositoriesCompilationResultsService) Query(name string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { - c := &ProjectsLocationsRepositoriesCompilationResultsQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - return c -} - -// Filter sets the optional parameter "filter": Optional filter for the -// returned list. Filtering is only currently supported on the `file_path` -// field. -func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Filter(filter string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// compilation results to return. The server may return fewer items than -// requested. If unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token received from -// a previous `QueryCompilationResultActions` call. Provide this to retrieve -// the subsequent page. When paginating, all other parameters provided to -// `QueryCompilationResultActions`, with the exception of `page_size`, must -// match the call that provided the page token. -func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { - 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 *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { - 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 *ProjectsLocationsRepositoriesCompilationResultsQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesCompilationResultsQueryCall { - 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 *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesCompilationResultsQueryCall) 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}:query") - 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", "dataform.projects.locations.repositories.compilationResults.query", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.compilationResults.query" call. -// Any non-2xx status code is an error. Response headers are in either -// *QueryCompilationResultActionsResponse.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 *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Do(opts ...googleapi.CallOption) (*QueryCompilationResultActionsResponse, 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 := &QueryCompilationResultActionsResponse{ - 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", "dataform.projects.locations.repositories.compilationResults.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 *ProjectsLocationsRepositoriesCompilationResultsQueryCall) Pages(ctx context.Context, f func(*QueryCompilationResultActionsResponse) 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 ProjectsLocationsRepositoriesReleaseConfigsCreateCall struct { - s *Service - parent string - releaseconfig *ReleaseConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Create: Creates a new ReleaseConfig in a given Repository. -// -// - parent: The repository in which to create the release config. Must be in -// the format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesReleaseConfigsService) Create(parent string, releaseconfig *ReleaseConfig) *ProjectsLocationsRepositoriesReleaseConfigsCreateCall { - c := &ProjectsLocationsRepositoriesReleaseConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.releaseconfig = releaseconfig - return c -} - -// ReleaseConfigId sets the optional parameter "releaseConfigId": Required. The -// ID to use for the release config, which will become the final component of -// the release config's resource name. -func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) ReleaseConfigId(releaseConfigId string) *ProjectsLocationsRepositoriesReleaseConfigsCreateCall { - c.urlParams_.Set("releaseConfigId", releaseConfigId) - 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 *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsCreateCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsCreateCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.releaseconfig) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/releaseConfigs") - 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", "dataform.projects.locations.repositories.releaseConfigs.create", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.releaseConfigs.create" call. -// Any non-2xx status code is an error. Response headers are in either -// *ReleaseConfig.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 *ProjectsLocationsRepositoriesReleaseConfigsCreateCall) Do(opts ...googleapi.CallOption) (*ReleaseConfig, 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 := &ReleaseConfig{ - 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", "dataform.projects.locations.repositories.releaseConfigs.create", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesReleaseConfigsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Delete: Deletes a single ReleaseConfig. -// -// - name: The release config's name. -func (r *ProjectsLocationsRepositoriesReleaseConfigsService) Delete(name string) *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall { - c := &ProjectsLocationsRepositoriesReleaseConfigsDeleteCall{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 *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) 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, "v1beta1/{+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", "dataform.projects.locations.repositories.releaseConfigs.delete", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.releaseConfigs.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 *ProjectsLocationsRepositoriesReleaseConfigsDeleteCall) 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", "dataform.projects.locations.repositories.releaseConfigs.delete", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesReleaseConfigsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Fetches a single ReleaseConfig. -// -// - name: The release config's name. -func (r *ProjectsLocationsRepositoriesReleaseConfigsService) Get(name string) *ProjectsLocationsRepositoriesReleaseConfigsGetCall { - c := &ProjectsLocationsRepositoriesReleaseConfigsGetCall{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 *ProjectsLocationsRepositoriesReleaseConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsGetCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesReleaseConfigsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesReleaseConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsGetCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesReleaseConfigsGetCall) 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", "dataform.projects.locations.repositories.releaseConfigs.get", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.releaseConfigs.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *ReleaseConfig.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 *ProjectsLocationsRepositoriesReleaseConfigsGetCall) Do(opts ...googleapi.CallOption) (*ReleaseConfig, 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 := &ReleaseConfig{ - 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", "dataform.projects.locations.repositories.releaseConfigs.get", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesReleaseConfigsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists ReleaseConfigs in a given Repository. -// -// - parent: The repository in which to list release configs. Must be in the -// format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesReleaseConfigsService) List(parent string) *ProjectsLocationsRepositoriesReleaseConfigsListCall { - c := &ProjectsLocationsRepositoriesReleaseConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of release -// configs to return. The server may return fewer items than requested. If -// unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesReleaseConfigsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token received from -// a previous `ListReleaseConfigs` call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// `ListReleaseConfigs`, with the exception of `page_size`, must match the call -// that provided the page token. -func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesReleaseConfigsListCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsListCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesReleaseConfigsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsListCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesReleaseConfigsListCall) 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/{+parent}/releaseConfigs") - 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", "dataform.projects.locations.repositories.releaseConfigs.list", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.releaseConfigs.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *ListReleaseConfigsResponse.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 *ProjectsLocationsRepositoriesReleaseConfigsListCall) Do(opts ...googleapi.CallOption) (*ListReleaseConfigsResponse, 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 := &ListReleaseConfigsResponse{ - 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", "dataform.projects.locations.repositories.releaseConfigs.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 *ProjectsLocationsRepositoriesReleaseConfigsListCall) Pages(ctx context.Context, f func(*ListReleaseConfigsResponse) 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 ProjectsLocationsRepositoriesReleaseConfigsPatchCall struct { - s *Service - name string - releaseconfig *ReleaseConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Patch: Updates a single ReleaseConfig. **Note:** *This method does not fully -// implement AIP/134 (https://google.aip.dev/134). The wildcard entry (\*) is -// treated as a bad request, and when the `field_mask` is omitted, the request -// is treated as a full update on all modifiable fields.* -// -// - name: Identifier. The release config's name. -func (r *ProjectsLocationsRepositoriesReleaseConfigsService) Patch(name string, releaseconfig *ReleaseConfig) *ProjectsLocationsRepositoriesReleaseConfigsPatchCall { - c := &ProjectsLocationsRepositoriesReleaseConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.releaseconfig = releaseconfig - return c -} - -// UpdateMask sets the optional parameter "updateMask": Specifies the fields to -// be updated in the release config. If left unset, all fields will be updated. -func (c *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsRepositoriesReleaseConfigsPatchCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsPatchCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsPatchCall { - 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 *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.releaseconfig) - if err != nil { - return nil, err - } - 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("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", "dataform.projects.locations.repositories.releaseConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.releaseConfigs.patch" call. -// Any non-2xx status code is an error. Response headers are in either -// *ReleaseConfig.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 *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) Do(opts ...googleapi.CallOption) (*ReleaseConfig, 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 := &ReleaseConfig{ - 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", "dataform.projects.locations.repositories.releaseConfigs.patch", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesWorkflowConfigsCreateCall struct { - s *Service - parent string - workflowconfig *WorkflowConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Create: Creates a new WorkflowConfig in a given Repository. -// -// - parent: The repository in which to create the workflow config. Must be in -// the format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) Create(parent string, workflowconfig *WorkflowConfig) *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall { - c := &ProjectsLocationsRepositoriesWorkflowConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.workflowconfig = workflowconfig - return c -} - -// WorkflowConfigId sets the optional parameter "workflowConfigId": Required. -// The ID to use for the workflow config, which will become the final component -// of the workflow config's resource name. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) WorkflowConfigId(workflowConfigId string) *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall { - c.urlParams_.Set("workflowConfigId", workflowConfigId) - 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 *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.workflowconfig) - if err != nil { - return nil, err - } - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workflowConfigs") - 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", "dataform.projects.locations.repositories.workflowConfigs.create", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.workflowConfigs.create" call. -// Any non-2xx status code is an error. Response headers are in either -// *WorkflowConfig.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 *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) Do(opts ...googleapi.CallOption) (*WorkflowConfig, 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 := &WorkflowConfig{ - 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", "dataform.projects.locations.repositories.workflowConfigs.create", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Delete: Deletes a single WorkflowConfig. -// -// - name: The workflow config's name. -func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) Delete(name string) *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall { - c := &ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall{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 *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) 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, "v1beta1/{+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", "dataform.projects.locations.repositories.workflowConfigs.delete", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.workflowConfigs.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 *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) 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", "dataform.projects.locations.repositories.workflowConfigs.delete", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesWorkflowConfigsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Fetches a single WorkflowConfig. -// -// - name: The workflow config's name. -func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) Get(name string) *ProjectsLocationsRepositoriesWorkflowConfigsGetCall { - c := &ProjectsLocationsRepositoriesWorkflowConfigsGetCall{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 *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsGetCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowConfigsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsGetCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) 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", "dataform.projects.locations.repositories.workflowConfigs.get", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.workflowConfigs.get" call. -// Any non-2xx status code is an error. Response headers are in either -// *WorkflowConfig.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 *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) Do(opts ...googleapi.CallOption) (*WorkflowConfig, 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 := &WorkflowConfig{ - 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", "dataform.projects.locations.repositories.workflowConfigs.get", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesWorkflowConfigsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists WorkflowConfigs in a given Repository. -// -// - parent: The repository in which to list workflow configs. Must be in the -// format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) List(parent string) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { - c := &ProjectsLocationsRepositoriesWorkflowConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of workflow -// configs to return. The server may return fewer items than requested. If -// unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token received from -// a previous `ListWorkflowConfigs` call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// `ListWorkflowConfigs`, with the exception of `page_size`, must match the -// call that provided the page token. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) 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/{+parent}/workflowConfigs") - 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", "dataform.projects.locations.repositories.workflowConfigs.list", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.workflowConfigs.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *ListWorkflowConfigsResponse.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 *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Do(opts ...googleapi.CallOption) (*ListWorkflowConfigsResponse, 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 := &ListWorkflowConfigsResponse{ - 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", "dataform.projects.locations.repositories.workflowConfigs.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 *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Pages(ctx context.Context, f func(*ListWorkflowConfigsResponse) 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 ProjectsLocationsRepositoriesWorkflowConfigsPatchCall struct { - s *Service - name string - workflowconfig *WorkflowConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Patch: Updates a single WorkflowConfig. **Note:** *This method does not -// fully implement AIP/134 (https://google.aip.dev/134). The wildcard entry -// (\*) is treated as a bad request, and when the `field_mask` is omitted, the -// request is treated as a full update on all modifiable fields.* -// -// - name: Identifier. The workflow config's name. -func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) Patch(name string, workflowconfig *WorkflowConfig) *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall { - c := &ProjectsLocationsRepositoriesWorkflowConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.workflowconfig = workflowconfig - return c -} - -// UpdateMask sets the optional parameter "updateMask": Specifies the fields to -// be updated in the workflow config. If left unset, all fields will be -// updated. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall { - 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 *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.workflowconfig) - if err != nil { - return nil, err - } - 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("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", "dataform.projects.locations.repositories.workflowConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.workflowConfigs.patch" call. -// Any non-2xx status code is an error. Response headers are in either -// *WorkflowConfig.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 *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) Do(opts ...googleapi.CallOption) (*WorkflowConfig, 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 := &WorkflowConfig{ - 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", "dataform.projects.locations.repositories.workflowConfigs.patch", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall struct { - s *Service - name string - cancelworkflowinvocationrequest *CancelWorkflowInvocationRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Cancel: Requests cancellation of a running WorkflowInvocation. +// Patch: Updates a single ReleaseConfig. **Note:** *This method does not fully +// implement AIP/134 (https://google.aip.dev/134). The wildcard entry (\*) is +// treated as a bad request, and when the `field_mask` is omitted, the request +// is treated as a full update on all modifiable fields.* // -// - name: The workflow invocation resource's name. -func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Cancel(name string, cancelworkflowinvocationrequest *CancelWorkflowInvocationRequest) *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall { - c := &ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Identifier. The release config's name. +func (r *ProjectsLocationsRepositoriesReleaseConfigsService) Patch(name string, releaseconfig *ReleaseConfig) *ProjectsLocationsRepositoriesReleaseConfigsPatchCall { + c := &ProjectsLocationsRepositoriesReleaseConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.cancelworkflowinvocationrequest = cancelworkflowinvocationrequest + c.releaseconfig = releaseconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Specifies the fields to +// be updated in the release config. If left unset, all fields will be updated. +func (c *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsRepositoriesReleaseConfigsPatchCall { + 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 *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesReleaseConfigsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall { +func (c *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesReleaseConfigsPatchCall { 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 *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.cancelworkflowinvocationrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.releaseconfig) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:cancel") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -8364,17 +6647,16 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) doRequest(a googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workflowInvocations.cancel" call. +// Do executes the "dataform.projects.locations.repositories.releaseConfigs.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *CancelWorkflowInvocationResponse.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 *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Do(opts ...googleapi.CallOption) (*CancelWorkflowInvocationResponse, error) { +// *ReleaseConfig.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 *ProjectsLocationsRepositoriesReleaseConfigsPatchCall) Do(opts ...googleapi.CallOption) (*ReleaseConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8393,7 +6675,7 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &CancelWorkflowInvocationResponse{ + ret := &ReleaseConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -8404,62 +6686,70 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.cancel", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.releaseConfigs.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall struct { - s *Service - parent string - workflowinvocation *WorkflowInvocation - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkflowConfigsCreateCall struct { + s *Service + parent string + workflowconfig *WorkflowConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Create: Creates a new WorkflowInvocation in a given Repository. +// Create: Creates a new WorkflowConfig in a given Repository. // -// - parent: The repository in which to create the workflow invocation. Must be -// in the format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Create(parent string, workflowinvocation *WorkflowInvocation) *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall { - c := &ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The repository in which to create the workflow config. Must be in +// the format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) Create(parent string, workflowconfig *WorkflowConfig) *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall { + c := &ProjectsLocationsRepositoriesWorkflowConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent - c.workflowinvocation = workflowinvocation + c.workflowconfig = workflowconfig + return c +} + +// WorkflowConfigId sets the optional parameter "workflowConfigId": Required. +// The ID to use for the workflow config, which will become the final component +// of the workflow config's resource name. +func (c *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) WorkflowConfigId(workflowConfigId string) *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall { + c.urlParams_.Set("workflowConfigId", workflowConfigId) 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 *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall { 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 *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.workflowinvocation) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.workflowconfig) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workflowInvocations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workflowConfigs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -8469,17 +6759,16 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) doRequest(a googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workflowInvocations.create" call. +// Do executes the "dataform.projects.locations.repositories.workflowConfigs.create" call. // Any non-2xx status code is an error. Response headers are in either -// *WorkflowInvocation.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 *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Do(opts ...googleapi.CallOption) (*WorkflowInvocation, error) { +// *WorkflowConfig.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 *ProjectsLocationsRepositoriesWorkflowConfigsCreateCall) Do(opts ...googleapi.CallOption) (*WorkflowConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8498,7 +6787,7 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &WorkflowInvocation{ + ret := &WorkflowConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -8509,11 +6798,11 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall struct { +type ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -8521,11 +6810,11 @@ type ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall struct { header_ http.Header } -// Delete: Deletes a single WorkflowInvocation. +// Delete: Deletes a single WorkflowConfig. // -// - name: The workflow invocation resource's name. -func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Delete(name string) *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall { - c := &ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The workflow config's name. +func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) Delete(name string) *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall { + c := &ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -8533,27 +6822,27 @@ func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Delete(name st // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall { 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 *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") @@ -8567,126 +6856,16 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) doRequest(a googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.delete", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.workflowInvocations.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 *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) 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", "dataform.projects.locations.repositories.workflowInvocations.delete", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsRepositoriesWorkflowInvocationsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Fetches a single WorkflowInvocation. -// -// - name: The workflow invocation resource's name. -func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Get(name string) *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall { - c := &ProjectsLocationsRepositoriesWorkflowInvocationsGetCall{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 *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall { - 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 *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall { - 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 *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) 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", "dataform.projects.locations.repositories.workflowInvocations.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workflowInvocations.get" call. +// Do executes the "dataform.projects.locations.repositories.workflowConfigs.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *WorkflowInvocation.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 *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Do(opts ...googleapi.CallOption) (*WorkflowInvocation, error) { +// *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 *ProjectsLocationsRepositoriesWorkflowConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8705,7 +6884,7 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &WorkflowInvocation{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -8716,65 +6895,32 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkflowInvocationsListCall struct { +type ProjectsLocationsRepositoriesWorkflowConfigsGetCall struct { s *Service - parent string + name string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// List: Lists WorkflowInvocations in a given Repository. +// Get: Fetches a single WorkflowConfig. // -// - parent: The parent resource of the WorkflowInvocation type. Must be in the -// format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) List(parent string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { - c := &ProjectsLocationsRepositoriesWorkflowInvocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter for the returned list. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Filter(filter string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": This field only supports -// ordering by `name`. If unspecified, the server will choose the ordering. If -// specified, the default order is ascending for the `name` field. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) OrderBy(orderBy string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of workflow -// invocations to return. The server may return fewer items than requested. If -// unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token received from -// a previous `ListWorkflowInvocations` call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// `ListWorkflowInvocations`, with the exception of `page_size`, must match the -// call that provided the page token. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { - c.urlParams_.Set("pageToken", pageToken) +// - name: The workflow config's name. +func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) Get(name string) *ProjectsLocationsRepositoriesWorkflowConfigsGetCall { + c := &ProjectsLocationsRepositoriesWorkflowConfigsGetCall{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 *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -8782,34 +6928,34 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Fields(s ...g // 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 *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowConfigsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsGetCall { 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 *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) 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/{+parent}/workflowInvocations") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -8817,19 +6963,18 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) doRequest(alt } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workflowInvocations.list" call. +// Do executes the "dataform.projects.locations.repositories.workflowConfigs.get" call. // Any non-2xx status code is an error. Response headers are in either -// *ListWorkflowInvocationsResponse.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 *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Do(opts ...googleapi.CallOption) (*ListWorkflowInvocationsResponse, error) { +// *WorkflowConfig.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 *ProjectsLocationsRepositoriesWorkflowConfigsGetCall) Do(opts ...googleapi.CallOption) (*WorkflowConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8848,7 +6993,7 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Do(opts ...go if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListWorkflowInvocationsResponse{ + ret := &WorkflowConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -8859,63 +7004,43 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.get", "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 *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Pages(ctx context.Context, f func(*ListWorkflowInvocationsResponse) 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 ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall struct { +type ProjectsLocationsRepositoriesWorkflowConfigsListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// Query: Returns WorkflowInvocationActions in a given WorkflowInvocation. +// List: Lists WorkflowConfigs in a given Repository. // -// - name: The workflow invocation's name. -func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Query(name string) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { - c := &ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The repository in which to list workflow configs. Must be in the +// format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) List(parent string) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { + c := &ProjectsLocationsRepositoriesWorkflowConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } // PageSize sets the optional parameter "pageSize": Maximum number of workflow -// invocations to return. The server may return fewer items than requested. If +// configs to return. The server may return fewer items than requested. If // unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": Page token received from -// a previous `QueryWorkflowInvocationActions` call. Provide this to retrieve -// the subsequent page. When paginating, all other parameters provided to -// `QueryWorkflowInvocationActions`, with the exception of `page_size`, must -// match the call that provided the page token. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { +// a previous `ListWorkflowConfigs` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListWorkflowConfigs`, with the exception of `page_size`, must match the +// call that provided the page token. +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { c.urlParams_.Set("pageToken", pageToken) return c } @@ -8923,7 +7048,7 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) PageToken(pa // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -8931,34 +7056,34 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) 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 *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsListCall { 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 *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) 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}:query") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workflowConfigs") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -8966,19 +7091,19 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) doRequest(al } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.query", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workflowInvocations.query" call. +// Do executes the "dataform.projects.locations.repositories.workflowConfigs.list" call. // Any non-2xx status code is an error. Response headers are in either -// *QueryWorkflowInvocationActionsResponse.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *ListWorkflowConfigsResponse.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 *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Do(opts ...googleapi.CallOption) (*QueryWorkflowInvocationActionsResponse, error) { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Do(opts ...googleapi.CallOption) (*ListWorkflowConfigsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -8997,7 +7122,7 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Do(opts ...g if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &QueryWorkflowInvocationActionsResponse{ + ret := &ListWorkflowConfigsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9008,14 +7133,14 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Do(opts ...g if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.query", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.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 *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Pages(ctx context.Context, f func(*QueryWorkflowInvocationActionsResponse) error) error { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsListCall) Pages(ctx context.Context, f func(*ListWorkflowConfigsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -9033,59 +7158,70 @@ func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Pages(ctx co } } -type ProjectsLocationsRepositoriesWorkspacesCommitCall struct { - s *Service - name string - commitworkspacechangesrequest *CommitWorkspaceChangesRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkflowConfigsPatchCall struct { + s *Service + name string + workflowconfig *WorkflowConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Commit: Applies a Git commit for uncommitted files in a Workspace. +// Patch: Updates a single WorkflowConfig. **Note:** *This method does not +// fully implement AIP/134 (https://google.aip.dev/134). The wildcard entry +// (\*) is treated as a bad request, and when the `field_mask` is omitted, the +// request is treated as a full update on all modifiable fields.* // -// - name: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) Commit(name string, commitworkspacechangesrequest *CommitWorkspaceChangesRequest) *ProjectsLocationsRepositoriesWorkspacesCommitCall { - c := &ProjectsLocationsRepositoriesWorkspacesCommitCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Identifier. The workflow config's name. +func (r *ProjectsLocationsRepositoriesWorkflowConfigsService) Patch(name string, workflowconfig *WorkflowConfig) *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall { + c := &ProjectsLocationsRepositoriesWorkflowConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.commitworkspacechangesrequest = commitworkspacechangesrequest + c.workflowconfig = workflowconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Specifies the fields to +// be updated in the workflow config. If left unset, all fields will be +// updated. +func (c *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall { + 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 *ProjectsLocationsRepositoriesWorkspacesCommitCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesCommitCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesCommitCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesCommitCall { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall { 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 *ProjectsLocationsRepositoriesWorkspacesCommitCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesCommitCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.commitworkspacechangesrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.workflowconfig) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:commit") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -9093,17 +7229,16 @@ func (c *ProjectsLocationsRepositoriesWorkspacesCommitCall) doRequest(alt string googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.commit", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.commit" call. +// Do executes the "dataform.projects.locations.repositories.workflowConfigs.patch" call. // Any non-2xx status code is an error. Response headers are in either -// *CommitWorkspaceChangesResponse.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 *ProjectsLocationsRepositoriesWorkspacesCommitCall) Do(opts ...googleapi.CallOption) (*CommitWorkspaceChangesResponse, error) { +// *WorkflowConfig.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 *ProjectsLocationsRepositoriesWorkflowConfigsPatchCall) Do(opts ...googleapi.CallOption) (*WorkflowConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9122,7 +7257,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesCommitCall) Do(opts ...googleapi if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &CommitWorkspaceChangesResponse{ + ret := &WorkflowConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9133,70 +7268,61 @@ func (c *ProjectsLocationsRepositoriesWorkspacesCommitCall) Do(opts ...googleapi if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.commit", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowConfigs.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } - -type ProjectsLocationsRepositoriesWorkspacesCreateCall struct { - s *Service - parent string - workspace *Workspace - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Create: Creates a new Workspace in a given Repository. -// -// - parent: The repository in which to create the workspace. Must be in the -// format `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesWorkspacesService) Create(parent string, workspace *Workspace) *ProjectsLocationsRepositoriesWorkspacesCreateCall { - c := &ProjectsLocationsRepositoriesWorkspacesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - c.workspace = workspace - return c + +type ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall struct { + s *Service + name string + cancelworkflowinvocationrequest *CancelWorkflowInvocationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// WorkspaceId sets the optional parameter "workspaceId": Required. The ID to -// use for the workspace, which will become the final component of the -// workspace's resource name. -func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) WorkspaceId(workspaceId string) *ProjectsLocationsRepositoriesWorkspacesCreateCall { - c.urlParams_.Set("workspaceId", workspaceId) +// Cancel: Requests cancellation of a running WorkflowInvocation. +// +// - name: The workflow invocation resource's name. +func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Cancel(name string, cancelworkflowinvocationrequest *CancelWorkflowInvocationRequest) *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall { + c := &ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.cancelworkflowinvocationrequest = cancelworkflowinvocationrequest 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 *ProjectsLocationsRepositoriesWorkspacesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesCreateCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesCreateCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall { 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 *ProjectsLocationsRepositoriesWorkspacesCreateCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.workspace) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.cancelworkflowinvocationrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workspaces") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:cancel") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -9204,18 +7330,19 @@ func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) doRequest(alt string } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.create", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.cancel", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.create" call. +// Do executes the "dataform.projects.locations.repositories.workflowInvocations.cancel" call. // Any non-2xx status code is an error. Response headers are in either -// *Workspace.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 *ProjectsLocationsRepositoriesWorkspacesCreateCall) Do(opts ...googleapi.CallOption) (*Workspace, error) { +// *CancelWorkflowInvocationResponse.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 *ProjectsLocationsRepositoriesWorkflowInvocationsCancelCall) Do(opts ...googleapi.CallOption) (*CancelWorkflowInvocationResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9234,7 +7361,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) Do(opts ...googleapi if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Workspace{ + ret := &CancelWorkflowInvocationResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9245,74 +7372,82 @@ func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) Do(opts ...googleapi if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.create", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.cancel", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesDeleteCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall struct { + s *Service + parent string + workflowinvocation *WorkflowInvocation + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Delete: Deletes a single Workspace. +// Create: Creates a new WorkflowInvocation in a given Repository. // -// - name: The workspace resource's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) Delete(name string) *ProjectsLocationsRepositoriesWorkspacesDeleteCall { - c := &ProjectsLocationsRepositoriesWorkspacesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The repository in which to create the workflow invocation. Must be +// in the format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Create(parent string, workflowinvocation *WorkflowInvocation) *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall { + c := &ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.workflowinvocation = workflowinvocation 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 *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesDeleteCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesDeleteCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall { 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 *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesDeleteCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.workflowinvocation) + if err != nil { + return nil, err + } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workflowInvocations") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("DELETE", urls, nil) + 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, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.delete" call. +// Do executes the "dataform.projects.locations.repositories.workflowInvocations.create" 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 *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { +// *WorkflowInvocation.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 *ProjectsLocationsRepositoriesWorkflowInvocationsCreateCall) Do(opts ...googleapi.CallOption) (*WorkflowInvocation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9331,7 +7466,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Do(opts ...googleapi if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Empty{ + ret := &WorkflowInvocation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9342,94 +7477,74 @@ func (c *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Do(opts ...googleapi if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall struct { - s *Service - workspace string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// FetchFileDiff: Fetches Git diff for an uncommitted file in a Workspace. +// Delete: Deletes a single WorkflowInvocation. // -// - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) FetchFileDiff(workspace string) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { - c := &ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.workspace = workspace - return c -} - -// Path sets the optional parameter "path": Required. The file's full path -// including filename, relative to the workspace root. -func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Path(path string) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { - c.urlParams_.Set("path", path) +// - name: The workflow invocation resource's name. +func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Delete(name string) *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall { + c := &ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall{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 *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall { 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 *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall { 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 *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) 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/{+workspace}:fetchFileDiff") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "workspace": c.workspace, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchFileDiff", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.fetchFileDiff" call. +// Do executes the "dataform.projects.locations.repositories.workflowInvocations.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *FetchFileDiffResponse.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 *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Do(opts ...googleapi.CallOption) (*FetchFileDiffResponse, error) { +// *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 *ProjectsLocationsRepositoriesWorkflowInvocationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9448,7 +7563,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Do(opts ...go if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &FetchFileDiffResponse{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9459,11 +7574,11 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchFileDiff", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall struct { +type ProjectsLocationsRepositoriesWorkflowInvocationsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -9472,11 +7587,11 @@ type ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall struct { header_ http.Header } -// FetchFileGitStatuses: Fetches Git statuses for the files in a Workspace. +// Get: Fetches a single WorkflowInvocation. // -// - name: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) FetchFileGitStatuses(name string) *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall { - c := &ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The workflow invocation resource's name. +func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Get(name string) *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall { + c := &ProjectsLocationsRepositoriesWorkflowInvocationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -9484,7 +7599,7 @@ func (r *ProjectsLocationsRepositoriesWorkspacesService) FetchFileGitStatuses(na // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -9492,34 +7607,34 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) 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 *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall { 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 *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) 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}:fetchFileGitStatuses") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -9529,17 +7644,17 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) doRequ googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchFileGitStatuses", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.fetchFileGitStatuses" call. +// Do executes the "dataform.projects.locations.repositories.workflowInvocations.get" call. // Any non-2xx status code is an error. Response headers are in either -// *FetchFileGitStatusesResponse.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 *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Do(opts ...googleapi.CallOption) (*FetchFileGitStatusesResponse, error) { +// *WorkflowInvocation.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 *ProjectsLocationsRepositoriesWorkflowInvocationsGetCall) Do(opts ...googleapi.CallOption) (*WorkflowInvocation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9558,7 +7673,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Do(opt if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &FetchFileGitStatusesResponse{ + ret := &WorkflowInvocation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9569,40 +7684,65 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Do(opt if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchFileGitStatuses", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall struct { +type ProjectsLocationsRepositoriesWorkflowInvocationsListCall struct { s *Service - name string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// FetchGitAheadBehind: Fetches Git ahead/behind against a remote branch. +// List: Lists WorkflowInvocations in a given Repository. // -// - name: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) FetchGitAheadBehind(name string) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { - c := &ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name +// - parent: The parent resource of the WorkflowInvocation type. Must be in the +// format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) List(parent string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { + c := &ProjectsLocationsRepositoriesWorkflowInvocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter for the returned list. +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Filter(filter string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": This field only supports +// ordering by `name`. If unspecified, the server will choose the ordering. If +// specified, the default order is ascending for the `name` field. +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) OrderBy(orderBy string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of workflow +// invocations to return. The server may return fewer items than requested. If +// unspecified, the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// RemoteBranch sets the optional parameter "remoteBranch": The name of the -// branch in the Git remote against which this workspace should be compared. If -// left unset, the repository's default branch name will be used. -func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) RemoteBranch(remoteBranch string) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { - c.urlParams_.Set("remoteBranch", remoteBranch) +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous `ListWorkflowInvocations` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `ListWorkflowInvocations`, with the exception of `page_size`, must match the +// call that provided the page token. +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { + 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 *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -9610,34 +7750,34 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) 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 *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsListCall { 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 *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) 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}:fetchGitAheadBehind") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workflowInvocations") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -9645,19 +7785,19 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) doReque } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchGitAheadBehind", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.fetchGitAheadBehind" call. +// Do executes the "dataform.projects.locations.repositories.workflowInvocations.list" call. // Any non-2xx status code is an error. Response headers are in either -// *FetchGitAheadBehindResponse.ServerResponse.Header or (if a response was +// *ListWorkflowInvocationsResponse.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 *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Do(opts ...googleapi.CallOption) (*FetchGitAheadBehindResponse, error) { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Do(opts ...googleapi.CallOption) (*ListWorkflowInvocationsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9676,7 +7816,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &FetchGitAheadBehindResponse{ + ret := &ListWorkflowInvocationsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9687,11 +7827,32 @@ func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchGitAheadBehind", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesGetCall struct { +// 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 *ProjectsLocationsRepositoriesWorkflowInvocationsListCall) Pages(ctx context.Context, f func(*ListWorkflowInvocationsResponse) 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 ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -9700,19 +7861,37 @@ type ProjectsLocationsRepositoriesWorkspacesGetCall struct { header_ http.Header } -// Get: Fetches a single Workspace. +// Query: Returns WorkflowInvocationActions in a given WorkflowInvocation. // -// - name: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) Get(name string) *ProjectsLocationsRepositoriesWorkspacesGetCall { - c := &ProjectsLocationsRepositoriesWorkspacesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The workflow invocation's name. +func (r *ProjectsLocationsRepositoriesWorkflowInvocationsService) Query(name string) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { + c := &ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } +// PageSize sets the optional parameter "pageSize": Maximum number of workflow +// invocations to return. The server may return fewer items than requested. If +// unspecified, the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous `QueryWorkflowInvocationActions` call. Provide this to retrieve +// the subsequent page. When paginating, all other parameters provided to +// `QueryWorkflowInvocationActions`, with the exception of `page_size`, must +// match the call that provided the page token. +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { + 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 *ProjectsLocationsRepositoriesWorkspacesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesGetCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -9720,34 +7899,34 @@ func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) Fields(s ...googleapi.F // 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 *ProjectsLocationsRepositoriesWorkspacesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesGetCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesGetCall { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall { 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 *ProjectsLocationsRepositoriesWorkspacesGetCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) 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 := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:query") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -9757,16 +7936,17 @@ func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) doRequest(alt string) ( googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.query", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.get" call. +// Do executes the "dataform.projects.locations.repositories.workflowInvocations.query" call. // Any non-2xx status code is an error. Response headers are in either -// *Workspace.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 *ProjectsLocationsRepositoriesWorkspacesGetCall) Do(opts ...googleapi.CallOption) (*Workspace, error) { +// *QueryWorkflowInvocationActionsResponse.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 *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Do(opts ...googleapi.CallOption) (*QueryWorkflowInvocationActionsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9785,7 +7965,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) Do(opts ...googleapi.Ca if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Workspace{ + ret := &QueryWorkflowInvocationActionsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9796,106 +7976,102 @@ func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) Do(opts ...googleapi.Ca if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.get", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workflowInvocations.query", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +// 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 *ProjectsLocationsRepositoriesWorkflowInvocationsQueryCall) Pages(ctx context.Context, f func(*QueryWorkflowInvocationActionsResponse) 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) + } } -// 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 *ProjectsLocationsRepositoriesWorkspacesService) GetIamPolicy(resource string) *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall { - c := &ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - return c +type ProjectsLocationsRepositoriesWorkspacesCommitCall struct { + s *Service + name string + commitworkspacechangesrequest *CommitWorkspaceChangesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// 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 *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// Commit: Applies a Git commit for uncommitted files in a Workspace. +// +// - name: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) Commit(name string, commitworkspacechangesrequest *CommitWorkspaceChangesRequest) *ProjectsLocationsRepositoriesWorkspacesCommitCall { + c := &ProjectsLocationsRepositoriesWorkspacesCommitCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.commitworkspacechangesrequest = commitworkspacechangesrequest 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 *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesWorkspacesCommitCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesCommitCall { 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 *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesWorkspacesCommitCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesCommitCall { 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 *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesCommitCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) 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 *ProjectsLocationsRepositoriesWorkspacesCommitCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.commitworkspacechangesrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:commit") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + 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, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.commit", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.getIamPolicy" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.commit" call. // Any non-2xx status code is an error. Response headers are in either -// *Policy.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 *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +// *CommitWorkspaceChangesResponse.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 *ProjectsLocationsRepositoriesWorkspacesCommitCall) Do(opts ...googleapi.CallOption) (*CommitWorkspaceChangesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9914,7 +8090,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &CommitWorkspaceChangesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9925,61 +8101,70 @@ func (c *ProjectsLocationsRepositoriesWorkspacesGetIamPolicyCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.commit", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall struct { - s *Service - workspace string - installnpmpackagesrequest *InstallNpmPackagesRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesCreateCall struct { + s *Service + parent string + workspace *Workspace + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// InstallNpmPackages: Installs dependency NPM packages (inside a Workspace). +// Create: Creates a new Workspace in a given Repository. // -// - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) InstallNpmPackages(workspace string, installnpmpackagesrequest *InstallNpmPackagesRequest) *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall { - c := &ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The repository in which to create the workspace. Must be in the +// format `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesWorkspacesService) Create(parent string, workspace *Workspace) *ProjectsLocationsRepositoriesWorkspacesCreateCall { + c := &ProjectsLocationsRepositoriesWorkspacesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent c.workspace = workspace - c.installnpmpackagesrequest = installnpmpackagesrequest + return c +} + +// WorkspaceId sets the optional parameter "workspaceId": Required. The ID to +// use for the workspace, which will become the final component of the +// workspace's resource name. +func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) WorkspaceId(workspaceId string) *ProjectsLocationsRepositoriesWorkspacesCreateCall { + c.urlParams_.Set("workspaceId", workspaceId) 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 *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall { +func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesCreateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall { +func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesCreateCall { 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 *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesCreateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.installnpmpackagesrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.workspace) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:installNpmPackages") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workspaces") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -9987,19 +8172,18 @@ func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) doReques } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "workspace": c.workspace, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.installNpmPackages", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.installNpmPackages" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.create" call. // Any non-2xx status code is an error. Response headers are in either -// *InstallNpmPackagesResponse.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 *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Do(opts ...googleapi.CallOption) (*InstallNpmPackagesResponse, error) { +// *Workspace.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 *ProjectsLocationsRepositoriesWorkspacesCreateCall) Do(opts ...googleapi.CallOption) (*Workspace, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10018,7 +8202,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &InstallNpmPackagesResponse{ + ret := &Workspace{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10029,120 +8213,74 @@ func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.installNpmPackages", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.create", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists Workspaces in a given Repository. +// Delete: Deletes a single Workspace. // -// - parent: The repository in which to list workspaces. Must be in the format -// `projects/*/locations/*/repositories/*`. -func (r *ProjectsLocationsRepositoriesWorkspacesService) List(parent string) *ProjectsLocationsRepositoriesWorkspacesListCall { - c := &ProjectsLocationsRepositoriesWorkspacesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter for the returned list. -func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Filter(filter string) *ProjectsLocationsRepositoriesWorkspacesListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// OrderBy sets the optional parameter "orderBy": This field only supports -// ordering by `name`. If unspecified, the server will choose the ordering. If -// specified, the default order is ascending for the `name` field. -func (c *ProjectsLocationsRepositoriesWorkspacesListCall) OrderBy(orderBy string) *ProjectsLocationsRepositoriesWorkspacesListCall { - c.urlParams_.Set("orderBy", orderBy) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of -// workspaces to return. The server may return fewer items than requested. If -// unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesWorkspacesListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkspacesListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": Page token received from -// a previous `ListWorkspaces` call. Provide this to retrieve the subsequent -// page. When paginating, all other parameters provided to `ListWorkspaces`, -// with the exception of `page_size`, must match the call that provided the -// page token. -func (c *ProjectsLocationsRepositoriesWorkspacesListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesListCall { - c.urlParams_.Set("pageToken", pageToken) +// - name: The workspace resource's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) Delete(name string) *ProjectsLocationsRepositoriesWorkspacesDeleteCall { + c := &ProjectsLocationsRepositoriesWorkspacesDeleteCall{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 *ProjectsLocationsRepositoriesWorkspacesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesListCall { +func (c *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesDeleteCall { 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 *ProjectsLocationsRepositoriesWorkspacesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesListCall { +func (c *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesDeleteCall { 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 *ProjectsLocationsRepositoriesWorkspacesListCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesListCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesDeleteCall) 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/{+parent}/workspaces") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "parent": c.parent, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.list" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *ListWorkspacesResponse.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 *ProjectsLocationsRepositoriesWorkspacesListCall) Do(opts ...googleapi.CallOption) (*ListWorkspacesResponse, error) { +// *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 *ProjectsLocationsRepositoriesWorkspacesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10161,7 +8299,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListWorkspacesResponse{ + ret := &Empty{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10172,84 +8310,76 @@ func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Do(opts ...googleapi.C if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.delete", "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 *ProjectsLocationsRepositoriesWorkspacesListCall) Pages(ctx context.Context, f func(*ListWorkspacesResponse) 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 ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall struct { - s *Service - workspace string - makedirectoryrequest *MakeDirectoryRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall struct { + s *Service + workspace string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// MakeDirectory: Creates a directory inside a Workspace. +// FetchFileDiff: Fetches Git diff for an uncommitted file in a Workspace. // // - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) MakeDirectory(workspace string, makedirectoryrequest *MakeDirectoryRequest) *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall { - c := &ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesWorkspacesService) FetchFileDiff(workspace string) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { + c := &ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.workspace = workspace - c.makedirectoryrequest = makedirectoryrequest + return c +} + +// Path sets the optional parameter "path": Required. The file's full path +// including filename, relative to the workspace root. +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Path(path string) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { + c.urlParams_.Set("path", path) 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 *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { 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 *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall { 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 *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.makedirectoryrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) 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/{+workspace}:makeDirectory") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:fetchFileDiff") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -10257,17 +8387,17 @@ func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) doRequest(alt googleapi.Expand(req.URL, map[string]string{ "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.makeDirectory", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchFileDiff", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.makeDirectory" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.fetchFileDiff" call. // Any non-2xx status code is an error. Response headers are in either -// *MakeDirectoryResponse.ServerResponse.Header or (if a response was returned +// *FetchFileDiffResponse.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 *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Do(opts ...googleapi.CallOption) (*MakeDirectoryResponse, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileDiffCall) Do(opts ...googleapi.CallOption) (*FetchFileDiffResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10286,7 +8416,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Do(opts ...go if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &MakeDirectoryResponse{ + ret := &FetchFileDiffResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10297,82 +8427,87 @@ func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.makeDirectory", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchFileDiff", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall struct { - s *Service - workspace string - movedirectoryrequest *MoveDirectoryRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// MoveDirectory: Moves a directory (inside a Workspace), and all of its -// contents, to a new location. +// FetchFileGitStatuses: Fetches Git statuses for the files in a Workspace. // -// - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) MoveDirectory(workspace string, movedirectoryrequest *MoveDirectoryRequest) *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall { - c := &ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.workspace = workspace - c.movedirectoryrequest = movedirectoryrequest +// - name: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) FetchFileGitStatuses(name string) *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall { + c := &ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall{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 *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall { 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 *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall { 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 *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.movedirectoryrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) 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/{+workspace}:moveDirectory") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:fetchFileGitStatuses") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "workspace": c.workspace, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.moveDirectory", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchFileGitStatuses", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.moveDirectory" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.fetchFileGitStatuses" call. // Any non-2xx status code is an error. Response headers are in either -// *MoveDirectoryResponse.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 *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Do(opts ...googleapi.CallOption) (*MoveDirectoryResponse, error) { +// *FetchFileGitStatusesResponse.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 *ProjectsLocationsRepositoriesWorkspacesFetchFileGitStatusesCall) Do(opts ...googleapi.CallOption) (*FetchFileGitStatusesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10391,7 +8526,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Do(opts ...go if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &MoveDirectoryResponse{ + ret := &FetchFileGitStatusesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10402,81 +8537,95 @@ func (c *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Do(opts ...go if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.moveDirectory", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchFileGitStatuses", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesMoveFileCall struct { - s *Service - workspace string - movefilerequest *MoveFileRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// MoveFile: Moves a file (inside a Workspace) to a new location. +// FetchGitAheadBehind: Fetches Git ahead/behind against a remote branch. // -// - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) MoveFile(workspace string, movefilerequest *MoveFileRequest) *ProjectsLocationsRepositoriesWorkspacesMoveFileCall { - c := &ProjectsLocationsRepositoriesWorkspacesMoveFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.workspace = workspace - c.movefilerequest = movefilerequest +// - name: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) FetchGitAheadBehind(name string) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { + c := &ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// RemoteBranch sets the optional parameter "remoteBranch": The name of the +// branch in the Git remote against which this workspace should be compared. If +// left unset, the repository's default branch name will be used. +func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) RemoteBranch(remoteBranch string) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { + c.urlParams_.Set("remoteBranch", remoteBranch) 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 *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesMoveFileCall { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { 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 *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesMoveFileCall { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall { 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 *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.movefilerequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) 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/{+workspace}:moveFile") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:fetchGitAheadBehind") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "workspace": c.workspace, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.moveFile", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchGitAheadBehind", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.moveFile" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.fetchGitAheadBehind" call. // Any non-2xx status code is an error. Response headers are in either -// *MoveFileResponse.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 *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Do(opts ...googleapi.CallOption) (*MoveFileResponse, error) { +// *FetchGitAheadBehindResponse.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 *ProjectsLocationsRepositoriesWorkspacesFetchGitAheadBehindCall) Do(opts ...googleapi.CallOption) (*FetchGitAheadBehindResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10495,7 +8644,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Do(opts ...googlea if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &MoveFileResponse{ + ret := &FetchGitAheadBehindResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10506,63 +8655,69 @@ func (c *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Do(opts ...googlea if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.moveFile", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.fetchGitAheadBehind", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesPullCall struct { - s *Service - name string - pullgitcommitsrequest *PullGitCommitsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Pull: Pulls Git commits from the Repository's remote into a Workspace. +// Get: Fetches a single Workspace. // // - name: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) Pull(name string, pullgitcommitsrequest *PullGitCommitsRequest) *ProjectsLocationsRepositoriesWorkspacesPullCall { - c := &ProjectsLocationsRepositoriesWorkspacesPullCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesWorkspacesService) Get(name string) *ProjectsLocationsRepositoriesWorkspacesGetCall { + c := &ProjectsLocationsRepositoriesWorkspacesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.pullgitcommitsrequest = pullgitcommitsrequest 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 *ProjectsLocationsRepositoriesWorkspacesPullCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesPullCall { +func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesGetCall { 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 *ProjectsLocationsRepositoriesWorkspacesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesPullCall { +func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesGetCall { 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 *ProjectsLocationsRepositoriesWorkspacesPullCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.pullgitcommitsrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesWorkspacesGetCall) 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}:pull") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("GET", urls, nil) if err != nil { return nil, err } @@ -10570,17 +8725,16 @@ func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) doRequest(alt string) googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.pull", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.pull" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.get" call. // Any non-2xx status code is an error. Response headers are in either -// *PullGitCommitsResponse.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 *ProjectsLocationsRepositoriesWorkspacesPullCall) Do(opts ...googleapi.CallOption) (*PullGitCommitsResponse, error) { +// *Workspace.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 *ProjectsLocationsRepositoriesWorkspacesGetCall) Do(opts ...googleapi.CallOption) (*Workspace, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10599,7 +8753,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &PullGitCommitsResponse{ + ret := &Workspace{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10610,61 +8764,61 @@ func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) Do(opts ...googleapi.C if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.pull", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesPushCall struct { - s *Service - name string - pushgitcommitsrequest *PushGitCommitsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall struct { + s *Service + workspace string + installnpmpackagesrequest *InstallNpmPackagesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Push: Pushes Git commits from a Workspace to the Repository's remote. +// InstallNpmPackages: Installs dependency NPM packages (inside a Workspace). // -// - name: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) Push(name string, pushgitcommitsrequest *PushGitCommitsRequest) *ProjectsLocationsRepositoriesWorkspacesPushCall { - c := &ProjectsLocationsRepositoriesWorkspacesPushCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.pushgitcommitsrequest = pushgitcommitsrequest +// - workspace: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) InstallNpmPackages(workspace string, installnpmpackagesrequest *InstallNpmPackagesRequest) *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall { + c := &ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.workspace = workspace + c.installnpmpackagesrequest = installnpmpackagesrequest 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 *ProjectsLocationsRepositoriesWorkspacesPushCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesPushCall { +func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesPushCall { +func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall { 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 *ProjectsLocationsRepositoriesWorkspacesPushCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.pushgitcommitsrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.installnpmpackagesrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:push") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:installNpmPackages") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -10672,19 +8826,19 @@ func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) doRequest(alt string) } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "name": c.name, + "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.push", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.installNpmPackages", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.push" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.installNpmPackages" call. // Any non-2xx status code is an error. Response headers are in either -// *PushGitCommitsResponse.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 *ProjectsLocationsRepositoriesWorkspacesPushCall) Do(opts ...googleapi.CallOption) (*PushGitCommitsResponse, error) { +// *InstallNpmPackagesResponse.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 *ProjectsLocationsRepositoriesWorkspacesInstallNpmPackagesCall) Do(opts ...googleapi.CallOption) (*InstallNpmPackagesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10703,7 +8857,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &PushGitCommitsResponse{ + ret := &InstallNpmPackagesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10714,58 +8868,65 @@ func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) Do(opts ...googleapi.C if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.push", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.installNpmPackages", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall struct { +type ProjectsLocationsRepositoriesWorkspacesListCall struct { s *Service - workspace string + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } -// QueryDirectoryContents: Returns the contents of a given Workspace directory. +// List: Lists Workspaces in a given Repository. // -// - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) QueryDirectoryContents(workspace string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { - c := &ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.workspace = workspace +// - parent: The repository in which to list workspaces. Must be in the format +// `projects/*/locations/*/repositories/*`. +func (r *ProjectsLocationsRepositoriesWorkspacesService) List(parent string) *ProjectsLocationsRepositoriesWorkspacesListCall { + c := &ProjectsLocationsRepositoriesWorkspacesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent return c } -// PageSize sets the optional parameter "pageSize": Maximum number of paths to -// return. The server may return fewer items than requested. If unspecified, -// the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { +// Filter sets the optional parameter "filter": Filter for the returned list. +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Filter(filter string) *ProjectsLocationsRepositoriesWorkspacesListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": This field only supports +// ordering by `name`. If unspecified, the server will choose the ordering. If +// specified, the default order is ascending for the `name` field. +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) OrderBy(orderBy string) *ProjectsLocationsRepositoriesWorkspacesListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// workspaces to return. The server may return fewer items than requested. If +// unspecified, the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkspacesListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": Page token received from -// a previous `QueryDirectoryContents` call. Provide this to retrieve the -// subsequent page. When paginating, all other parameters provided to -// `QueryDirectoryContents`, with the exception of `page_size`, must match the -// call that provided the page token. -func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { +// a previous `ListWorkspaces` call. Provide this to retrieve the subsequent +// page. When paginating, all other parameters provided to `ListWorkspaces`, +// with the exception of `page_size`, must match the call that provided the +// page token. +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesListCall { c.urlParams_.Set("pageToken", pageToken) return c } -// Path sets the optional parameter "path": The directory's full path including -// directory name, relative to the workspace root. If left unset, the workspace -// root is used. -func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Path(path string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { - c.urlParams_.Set("path", path) - 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 *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesListCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -10773,34 +8934,34 @@ func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Fiel // 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 *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesListCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesListCall { 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 *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) 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/{+workspace}:queryDirectoryContents") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+parent}/workspaces") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -10808,19 +8969,19 @@ func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) doRe } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "workspace": c.workspace, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.queryDirectoryContents", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.queryDirectoryContents" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.list" call. // Any non-2xx status code is an error. Response headers are in either -// *QueryDirectoryContentsResponse.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 *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Do(opts ...googleapi.CallOption) (*QueryDirectoryContentsResponse, error) { +// *ListWorkspacesResponse.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 *ProjectsLocationsRepositoriesWorkspacesListCall) Do(opts ...googleapi.CallOption) (*ListWorkspacesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10839,7 +9000,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Do(o if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &QueryDirectoryContentsResponse{ + ret := &ListWorkspacesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10850,14 +9011,14 @@ func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Do(o if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.queryDirectoryContents", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.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 *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Pages(ctx context.Context, f func(*QueryDirectoryContentsResponse) error) error { +func (c *ProjectsLocationsRepositoriesWorkspacesListCall) Pages(ctx context.Context, f func(*ListWorkspacesResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -10875,80 +9036,164 @@ func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Page } } -type ProjectsLocationsRepositoriesWorkspacesReadFileCall struct { - s *Service - workspace string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall struct { + s *Service + workspace string + makedirectoryrequest *MakeDirectoryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// ReadFile: Returns the contents of a file (inside a Workspace). +// MakeDirectory: Creates a directory inside a Workspace. // // - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) ReadFile(workspace string) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { - c := &ProjectsLocationsRepositoriesWorkspacesReadFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesWorkspacesService) MakeDirectory(workspace string, makedirectoryrequest *MakeDirectoryRequest) *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall { + c := &ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.workspace = workspace + c.makedirectoryrequest = makedirectoryrequest return c } -// Path sets the optional parameter "path": Required. The file's full path -// including filename, relative to the workspace root. -func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Path(path string) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { - c.urlParams_.Set("path", path) +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more +// details. +func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } -// Revision sets the optional parameter "revision": The Git revision of the -// file to return. If left empty, the current contents of `path` will be +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall { + 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 *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.makedirectoryrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:makeDirectory") + 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{ + "workspace": c.workspace, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.makeDirectory", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dataform.projects.locations.repositories.workspaces.makeDirectory" call. +// Any non-2xx status code is an error. Response headers are in either +// *MakeDirectoryResponse.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 *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Revision(revision string) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { - c.urlParams_.Set("revision", revision) +func (c *ProjectsLocationsRepositoriesWorkspacesMakeDirectoryCall) Do(opts ...googleapi.CallOption) (*MakeDirectoryResponse, 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 := &MakeDirectoryResponse{ + 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", "dataform.projects.locations.repositories.workspaces.makeDirectory", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall struct { + s *Service + workspace string + movedirectoryrequest *MoveDirectoryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// MoveDirectory: Moves a directory (inside a Workspace), and all of its +// contents, to a new location. +// +// - workspace: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) MoveDirectory(workspace string, movedirectoryrequest *MoveDirectoryRequest) *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall { + c := &ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.workspace = workspace + c.movedirectoryrequest = movedirectoryrequest 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 *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { +func (c *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall { 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 *ProjectsLocationsRepositoriesWorkspacesReadFileCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { +func (c *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall { 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 *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) 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 *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.movedirectoryrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:readFile") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:moveDirectory") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -10956,17 +9201,17 @@ func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) doRequest(alt stri googleapi.Expand(req.URL, map[string]string{ "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.readFile", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.moveDirectory", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.readFile" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.moveDirectory" call. // Any non-2xx status code is an error. Response headers are in either -// *ReadFileResponse.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// *MoveDirectoryResponse.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 *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Do(opts ...googleapi.CallOption) (*ReadFileResponse, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesMoveDirectoryCall) Do(opts ...googleapi.CallOption) (*MoveDirectoryResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -10985,7 +9230,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Do(opts ...googlea if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ReadFileResponse{ + ret := &MoveDirectoryResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -10996,62 +9241,61 @@ func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Do(opts ...googlea if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.readFile", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.moveDirectory", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall struct { - s *Service - workspace string - removedirectoryrequest *RemoveDirectoryRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesMoveFileCall struct { + s *Service + workspace string + movefilerequest *MoveFileRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// RemoveDirectory: Deletes a directory (inside a Workspace) and all of its -// contents. +// MoveFile: Moves a file (inside a Workspace) to a new location. // // - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) RemoveDirectory(workspace string, removedirectoryrequest *RemoveDirectoryRequest) *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall { - c := &ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesWorkspacesService) MoveFile(workspace string, movefilerequest *MoveFileRequest) *ProjectsLocationsRepositoriesWorkspacesMoveFileCall { + c := &ProjectsLocationsRepositoriesWorkspacesMoveFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.workspace = workspace - c.removedirectoryrequest = removedirectoryrequest + c.movefilerequest = movefilerequest 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 *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall { +func (c *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesMoveFileCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall { +func (c *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesMoveFileCall { 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 *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.removedirectoryrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.movefilerequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:removeDirectory") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:moveFile") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -11061,17 +9305,17 @@ func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) doRequest(a googleapi.Expand(req.URL, map[string]string{ "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.removeDirectory", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.moveFile", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "dataform.projects.locations.repositories.workspaces.removeDirectory" call. -// Any non-2xx status code is an error. Response headers are in either -// *RemoveDirectoryResponse.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 *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Do(opts ...googleapi.CallOption) (*RemoveDirectoryResponse, error) { +} + +// Do executes the "dataform.projects.locations.repositories.workspaces.moveFile" call. +// Any non-2xx status code is an error. Response headers are in either +// *MoveFileResponse.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 *ProjectsLocationsRepositoriesWorkspacesMoveFileCall) Do(opts ...googleapi.CallOption) (*MoveFileResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11090,7 +9334,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Do(opts ... if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &RemoveDirectoryResponse{ + ret := &MoveFileResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11101,61 +9345,61 @@ func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Do(opts ... if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.removeDirectory", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.moveFile", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesRemoveFileCall struct { - s *Service - workspace string - removefilerequest *RemoveFileRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesPullCall struct { + s *Service + name string + pullgitcommitsrequest *PullGitCommitsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// RemoveFile: Deletes a file (inside a Workspace). +// Pull: Pulls Git commits from the Repository's remote into a Workspace. // -// - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) RemoveFile(workspace string, removefilerequest *RemoveFileRequest) *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall { - c := &ProjectsLocationsRepositoriesWorkspacesRemoveFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.workspace = workspace - c.removefilerequest = removefilerequest +// - name: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) Pull(name string, pullgitcommitsrequest *PullGitCommitsRequest) *ProjectsLocationsRepositoriesWorkspacesPullCall { + c := &ProjectsLocationsRepositoriesWorkspacesPullCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.pullgitcommitsrequest = pullgitcommitsrequest 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 *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall { +func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesPullCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall { +func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesPullCall { 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 *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.removefilerequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.pullgitcommitsrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:removeFile") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:pull") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -11163,19 +9407,19 @@ func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) doRequest(alt st } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "workspace": c.workspace, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.removeFile", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.pull", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.removeFile" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.pull" call. // Any non-2xx status code is an error. Response headers are in either -// *RemoveFileResponse.ServerResponse.Header or (if a response was returned at -// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// *PullGitCommitsResponse.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 *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Do(opts ...googleapi.CallOption) (*RemoveFileResponse, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesPullCall) Do(opts ...googleapi.CallOption) (*PullGitCommitsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11194,7 +9438,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Do(opts ...googl if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &RemoveFileResponse{ + ret := &PullGitCommitsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11205,61 +9449,61 @@ func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Do(opts ...googl if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.removeFile", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.pull", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesResetCall struct { - s *Service - name string - resetworkspacechangesrequest *ResetWorkspaceChangesRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesPushCall struct { + s *Service + name string + pushgitcommitsrequest *PushGitCommitsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Reset: Performs a Git reset for uncommitted files in a Workspace. +// Push: Pushes Git commits from a Workspace to the Repository's remote. // // - name: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) Reset(name string, resetworkspacechangesrequest *ResetWorkspaceChangesRequest) *ProjectsLocationsRepositoriesWorkspacesResetCall { - c := &ProjectsLocationsRepositoriesWorkspacesResetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesWorkspacesService) Push(name string, pushgitcommitsrequest *PushGitCommitsRequest) *ProjectsLocationsRepositoriesWorkspacesPushCall { + c := &ProjectsLocationsRepositoriesWorkspacesPushCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.resetworkspacechangesrequest = resetworkspacechangesrequest + c.pushgitcommitsrequest = pushgitcommitsrequest 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 *ProjectsLocationsRepositoriesWorkspacesResetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesResetCall { +func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesPushCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesResetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesResetCall { +func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesPushCall { 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 *ProjectsLocationsRepositoriesWorkspacesResetCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesResetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesPushCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.resetworkspacechangesrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.pushgitcommitsrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:reset") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:push") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -11269,17 +9513,17 @@ func (c *ProjectsLocationsRepositoriesWorkspacesResetCall) doRequest(alt string) googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.reset", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.push", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.reset" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.push" call. // Any non-2xx status code is an error. Response headers are in either -// *ResetWorkspaceChangesResponse.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 *ProjectsLocationsRepositoriesWorkspacesResetCall) Do(opts ...googleapi.CallOption) (*ResetWorkspaceChangesResponse, error) { +// *PushGitCommitsResponse.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 *ProjectsLocationsRepositoriesWorkspacesPushCall) Do(opts ...googleapi.CallOption) (*PushGitCommitsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11298,7 +9542,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesResetCall) Do(opts ...googleapi. if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ResetWorkspaceChangesResponse{ + ret := &PushGitCommitsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11309,11 +9553,11 @@ func (c *ProjectsLocationsRepositoriesWorkspacesResetCall) Do(opts ...googleapi. if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.reset", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.push", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesSearchFilesCall struct { +type ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall struct { s *Service workspace string urlParams_ gensupport.URLParams @@ -11322,45 +9566,45 @@ type ProjectsLocationsRepositoriesWorkspacesSearchFilesCall struct { header_ http.Header } -// SearchFiles: Finds the contents of a given Workspace directory by filter. +// QueryDirectoryContents: Returns the contents of a given Workspace directory. // // - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) SearchFiles(workspace string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { - c := &ProjectsLocationsRepositoriesWorkspacesSearchFilesCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesWorkspacesService) QueryDirectoryContents(workspace string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { + c := &ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.workspace = workspace return c } -// Filter sets the optional parameter "filter": Optional filter for the -// returned list in filtering format. Filtering is only currently supported on -// the `path` field. See https://google.aip.dev/160 for details. -func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Filter(filter string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": Maximum number of search -// results to return. The server may return fewer items than requested. If -// unspecified, the server will pick an appropriate default. -func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { +// PageSize sets the optional parameter "pageSize": Maximum number of paths to +// return. The server may return fewer items than requested. If unspecified, +// the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } // PageToken sets the optional parameter "pageToken": Page token received from -// a previous `SearchFilesRequest` call. Provide this to retrieve the +// a previous `QueryDirectoryContents` call. Provide this to retrieve the // subsequent page. When paginating, all other parameters provided to -// `SearchFilesRequest`, with the exception of `page_size`, must match the call -// that provided the page token. -func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { +// `QueryDirectoryContents`, with the exception of `page_size`, must match the +// call that provided the page token. +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { c.urlParams_.Set("pageToken", pageToken) return c } +// Path sets the optional parameter "path": The directory's full path including +// directory name, relative to the workspace root. If left unset, the workspace +// root is used. +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Path(path string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { + c.urlParams_.Set("path", path) + 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 *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -11368,34 +9612,34 @@ func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Fields(s ...goo // 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 *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall { 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 *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) 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/{+workspace}:searchFiles") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:queryDirectoryContents") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, nil) if err != nil { @@ -11405,17 +9649,17 @@ func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) doRequest(alt s googleapi.Expand(req.URL, map[string]string{ "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.searchFiles", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.queryDirectoryContents", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.searchFiles" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.queryDirectoryContents" call. // Any non-2xx status code is an error. Response headers are in either -// *SearchFilesResponse.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 *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Do(opts ...googleapi.CallOption) (*SearchFilesResponse, error) { +// *QueryDirectoryContentsResponse.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 *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Do(opts ...googleapi.CallOption) (*QueryDirectoryContentsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11434,7 +9678,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Do(opts ...goog if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &SearchFilesResponse{ + ret := &QueryDirectoryContentsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11445,14 +9689,14 @@ func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Do(opts ...goog if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.searchFiles", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.queryDirectoryContents", "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 *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Pages(ctx context.Context, f func(*SearchFilesResponse) error) error { +func (c *ProjectsLocationsRepositoriesWorkspacesQueryDirectoryContentsCall) Pages(ctx context.Context, f func(*QueryDirectoryContentsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { @@ -11470,80 +9714,98 @@ func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Pages(ctx conte } } -type ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall struct { - s *Service - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesReadFileCall struct { + s *Service + workspace string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + 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. +// ReadFile: Returns the contents of a file (inside a Workspace). // -// - 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 *ProjectsLocationsRepositoriesWorkspacesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall { - c := &ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.setiampolicyrequest = setiampolicyrequest +// - workspace: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) ReadFile(workspace string) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { + c := &ProjectsLocationsRepositoriesWorkspacesReadFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.workspace = workspace + return c +} + +// Path sets the optional parameter "path": Required. The file's full path +// including filename, relative to the workspace root. +func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Path(path string) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { + c.urlParams_.Set("path", path) + return c +} + +// Revision sets the optional parameter "revision": The Git revision of the +// file to return. If left empty, the current contents of `path` will be +// returned. +func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Revision(revision string) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { + c.urlParams_.Set("revision", revision) 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 *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { 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 *ProjectsLocationsRepositoriesWorkspacesReadFileCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesReadFileCall { 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 *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.setiampolicyrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesWorkspacesReadFileCall) 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/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:readFile") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + 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, + "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.readFile", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.setIamPolicy" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.readFile" call. // Any non-2xx status code is an error. Response headers are in either -// *Policy.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 *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +// *ReadFileResponse.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 *ProjectsLocationsRepositoriesWorkspacesReadFileCall) Do(opts ...googleapi.CallOption) (*ReadFileResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11562,7 +9824,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall) Do(opts ...goo if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &ReadFileResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11573,68 +9835,62 @@ func (c *ProjectsLocationsRepositoriesWorkspacesSetIamPolicyCall) Do(opts ...goo if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.readFile", "response", internallog.HTTPResponse(res, b)) return ret, nil } - -type ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall struct { - s *Service - resource string - testiampermissionsrequest *TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header + +type ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall struct { + s *Service + workspace string + removedirectoryrequest *RemoveDirectoryRequest + 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. +// RemoveDirectory: Deletes a directory (inside a Workspace) and all of its +// contents. // -// - 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 *ProjectsLocationsRepositoriesWorkspacesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall { - c := &ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest +// - workspace: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) RemoveDirectory(workspace string, removedirectoryrequest *RemoveDirectoryRequest) *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall { + c := &ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.workspace = workspace + c.removedirectoryrequest = removedirectoryrequest 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 *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall { 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 *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.testiampermissionsrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.removedirectoryrequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+resource}:testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:removeDirectory") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -11642,19 +9898,19 @@ func (c *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall) doReques } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.removeDirectory", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.testIamPermissions" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.removeDirectory" call. // Any non-2xx status code is an error. Response headers are in either -// *TestIamPermissionsResponse.ServerResponse.Header or (if a response was +// *RemoveDirectoryResponse.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 *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveDirectoryCall) Do(opts ...googleapi.CallOption) (*RemoveDirectoryResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11673,7 +9929,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall) Do(opts if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &TestIamPermissionsResponse{ + ret := &RemoveDirectoryResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11684,61 +9940,61 @@ func (c *ProjectsLocationsRepositoriesWorkspacesTestIamPermissionsCall) Do(opts if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.testIamPermissions", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.removeDirectory", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsRepositoriesWorkspacesWriteFileCall struct { - s *Service - workspace string - writefilerequest *WriteFileRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesRemoveFileCall struct { + s *Service + workspace string + removefilerequest *RemoveFileRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// WriteFile: Writes to a file (inside a Workspace). +// RemoveFile: Deletes a file (inside a Workspace). // // - workspace: The workspace's name. -func (r *ProjectsLocationsRepositoriesWorkspacesService) WriteFile(workspace string, writefilerequest *WriteFileRequest) *ProjectsLocationsRepositoriesWorkspacesWriteFileCall { - c := &ProjectsLocationsRepositoriesWorkspacesWriteFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsRepositoriesWorkspacesService) RemoveFile(workspace string, removefilerequest *RemoveFileRequest) *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall { + c := &ProjectsLocationsRepositoriesWorkspacesRemoveFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.workspace = workspace - c.writefilerequest = writefilerequest + c.removefilerequest = removefilerequest 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 *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesWriteFileCall { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesWriteFileCall { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall { 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 *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.writefilerequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.removefilerequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:writeFile") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:removeFile") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -11748,17 +10004,17 @@ func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) doRequest(alt str googleapi.Expand(req.URL, map[string]string{ "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.writeFile", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.removeFile", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.repositories.workspaces.writeFile" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.removeFile" call. // Any non-2xx status code is an error. Response headers are in either -// *WriteFileResponse.ServerResponse.Header or (if a response was returned at +// *RemoveFileResponse.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 *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Do(opts ...googleapi.CallOption) (*WriteFileResponse, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesRemoveFileCall) Do(opts ...googleapi.CallOption) (*RemoveFileResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11777,7 +10033,7 @@ func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Do(opts ...google if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &WriteFileResponse{ + ret := &RemoveFileResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11788,106 +10044,81 @@ func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Do(opts ...google if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.writeFile", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.removeFile", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsTeamFoldersGetIamPolicyCall struct { - s *Service - resource string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesResetCall struct { + s *Service + name string + resetworkspacechangesrequest *ResetWorkspaceChangesRequest + 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. +// Reset: Performs a Git reset for uncommitted files in a Workspace. // -// - 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 *ProjectsLocationsTeamFoldersService) GetIamPolicy(resource string) *ProjectsLocationsTeamFoldersGetIamPolicyCall { - c := &ProjectsLocationsTeamFoldersGetIamPolicyCall{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 *ProjectsLocationsTeamFoldersGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsTeamFoldersGetIamPolicyCall { - c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) +// - name: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) Reset(name string, resetworkspacechangesrequest *ResetWorkspaceChangesRequest) *ProjectsLocationsRepositoriesWorkspacesResetCall { + c := &ProjectsLocationsRepositoriesWorkspacesResetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.resetworkspacechangesrequest = resetworkspacechangesrequest 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 *ProjectsLocationsTeamFoldersGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsTeamFoldersGetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesWorkspacesResetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesResetCall { 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 *ProjectsLocationsTeamFoldersGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsTeamFoldersGetIamPolicyCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsTeamFoldersGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsTeamFoldersGetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesWorkspacesResetCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesResetCall { 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 *ProjectsLocationsTeamFoldersGetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesResetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsTeamFoldersGetIamPolicyCall) 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 *ProjectsLocationsRepositoriesWorkspacesResetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.resetworkspacechangesrequest) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+resource}:getIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+name}:reset") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + 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, + "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.teamFolders.getIamPolicy", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.reset", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.teamFolders.getIamPolicy" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.reset" call. // Any non-2xx status code is an error. Response headers are in either -// *Policy.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 *ProjectsLocationsTeamFoldersGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +// *ResetWorkspaceChangesResponse.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 *ProjectsLocationsRepositoriesWorkspacesResetCall) Do(opts ...googleapi.CallOption) (*ResetWorkspaceChangesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -11906,7 +10137,7 @@ func (c *ProjectsLocationsTeamFoldersGetIamPolicyCall) Do(opts ...googleapi.Call if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &ResetWorkspaceChangesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -11917,84 +10148,113 @@ func (c *ProjectsLocationsTeamFoldersGetIamPolicyCall) Do(opts ...googleapi.Call if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.teamFolders.getIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.reset", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsTeamFoldersSetIamPolicyCall struct { - s *Service - resource string - setiampolicyrequest *SetIamPolicyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsRepositoriesWorkspacesSearchFilesCall struct { + s *Service + workspace string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + 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. +// SearchFiles: Finds the contents of a given Workspace directory by filter. // -// - 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 *ProjectsLocationsTeamFoldersService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsTeamFoldersSetIamPolicyCall { - c := &ProjectsLocationsTeamFoldersSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.setiampolicyrequest = setiampolicyrequest +// - workspace: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) SearchFiles(workspace string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { + c := &ProjectsLocationsRepositoriesWorkspacesSearchFilesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.workspace = workspace + return c +} + +// Filter sets the optional parameter "filter": Optional filter for the +// returned list in filtering format. Filtering is only currently supported on +// the `path` field. See https://google.aip.dev/160 for details. +func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Filter(filter string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of search +// results to return. The server may return fewer items than requested. If +// unspecified, the server will pick an appropriate default. +func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) PageSize(pageSize int64) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": Page token received from +// a previous `SearchFilesRequest` call. Provide this to retrieve the +// subsequent page. When paginating, all other parameters provided to +// `SearchFilesRequest`, with the exception of `page_size`, must match the call +// that provided the page token. +func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) PageToken(pageToken string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { + 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 *ProjectsLocationsTeamFoldersSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsTeamFoldersSetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { 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 *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) IfNoneMatch(entityTag string) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsTeamFoldersSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsTeamFoldersSetIamPolicyCall { +func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall { 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 *ProjectsLocationsTeamFoldersSetIamPolicyCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsTeamFoldersSetIamPolicyCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.setiampolicyrequest) - if err != nil { - return nil, err +func (c *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) 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/{+resource}:setIamPolicy") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:searchFiles") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + 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, + "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.teamFolders.setIamPolicy", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.searchFiles", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.teamFolders.setIamPolicy" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.searchFiles" call. // Any non-2xx status code is an error. Response headers are in either -// *Policy.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 *ProjectsLocationsTeamFoldersSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { +// *SearchFilesResponse.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 *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Do(opts ...googleapi.CallOption) (*SearchFilesResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12013,7 +10273,7 @@ func (c *ProjectsLocationsTeamFoldersSetIamPolicyCall) Do(opts ...googleapi.Call if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &Policy{ + ret := &SearchFilesResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -12024,68 +10284,82 @@ func (c *ProjectsLocationsTeamFoldersSetIamPolicyCall) Do(opts ...googleapi.Call if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.teamFolders.setIamPolicy", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.searchFiles", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsTeamFoldersTestIamPermissionsCall struct { - s *Service - resource string - testiampermissionsrequest *TestIamPermissionsRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +// 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 *ProjectsLocationsRepositoriesWorkspacesSearchFilesCall) Pages(ctx context.Context, f func(*SearchFilesResponse) 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 ProjectsLocationsRepositoriesWorkspacesWriteFileCall struct { + s *Service + workspace string + writefilerequest *WriteFileRequest + 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. +// WriteFile: Writes to a file (inside a Workspace). // -// - 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 *ProjectsLocationsTeamFoldersService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsTeamFoldersTestIamPermissionsCall { - c := &ProjectsLocationsTeamFoldersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.resource = resource - c.testiampermissionsrequest = testiampermissionsrequest +// - workspace: The workspace's name. +func (r *ProjectsLocationsRepositoriesWorkspacesService) WriteFile(workspace string, writefilerequest *WriteFileRequest) *ProjectsLocationsRepositoriesWorkspacesWriteFileCall { + c := &ProjectsLocationsRepositoriesWorkspacesWriteFileCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.workspace = workspace + c.writefilerequest = writefilerequest 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 *ProjectsLocationsTeamFoldersTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsTeamFoldersTestIamPermissionsCall { +func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Fields(s ...googleapi.Field) *ProjectsLocationsRepositoriesWorkspacesWriteFileCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsTeamFoldersTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsTeamFoldersTestIamPermissionsCall { +func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Context(ctx context.Context) *ProjectsLocationsRepositoriesWorkspacesWriteFileCall { 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 *ProjectsLocationsTeamFoldersTestIamPermissionsCall) Header() http.Header { +func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsTeamFoldersTestIamPermissionsCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.testiampermissionsrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.writefilerequest) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+resource}:testIamPermissions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1beta1/{+workspace}:writeFile") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { @@ -12093,19 +10367,19 @@ func (c *ProjectsLocationsTeamFoldersTestIamPermissionsCall) doRequest(alt strin } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ - "resource": c.resource, + "workspace": c.workspace, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.teamFolders.testIamPermissions", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.writeFile", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "dataform.projects.locations.teamFolders.testIamPermissions" call. +// Do executes the "dataform.projects.locations.repositories.workspaces.writeFile" call. // Any non-2xx status code is an error. Response headers are in either -// *TestIamPermissionsResponse.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 *ProjectsLocationsTeamFoldersTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { +// *WriteFileResponse.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 *ProjectsLocationsRepositoriesWorkspacesWriteFileCall) Do(opts ...googleapi.CallOption) (*WriteFileResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -12124,7 +10398,7 @@ func (c *ProjectsLocationsTeamFoldersTestIamPermissionsCall) Do(opts ...googleap if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &TestIamPermissionsResponse{ + ret := &WriteFileResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -12135,6 +10409,6 @@ func (c *ProjectsLocationsTeamFoldersTestIamPermissionsCall) Do(opts ...googleap if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.teamFolders.testIamPermissions", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "dataform.projects.locations.repositories.workspaces.writeFile", "response", internallog.HTTPResponse(res, b)) return ret, nil } diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index d7535de5e32..7162bd8bf7a 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -809,7 +809,7 @@ ] }, "lookupEntry": { - "description": "Looks up an entry by name using the permission on the source system.", + "description": "Looks up an entry by name using the permission on the source system. Caution: The Vertex AI, Bigtable, Spanner, Pub/Sub, Dataform, and Dataproc Metastore metadata that is stored in Dataplex Universal Catalog is changing. For more information, see Changes to metadata stored in Dataplex Universal Catalog (https://cloud.google.com/dataplex/docs/metadata-changes).", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:lookupEntry", "httpMethod": "GET", "id": "dataplex.projects.locations.lookupEntry", @@ -2925,7 +2925,7 @@ ] }, "get": { - "description": "Gets an Entry.", + "description": "Gets an Entry. Caution: The Vertex AI, Bigtable, Spanner, Pub/Sub, Dataform, and Dataproc Metastore metadata that is stored in Dataplex Universal Catalog is changing. For more information, see Changes to metadata stored in Dataplex Universal Catalog (https://cloud.google.com/dataplex/docs/metadata-changes).", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}/entries/{entriesId}", "httpMethod": "GET", "id": "dataplex.projects.locations.entryGroups.entries.get", @@ -2981,7 +2981,7 @@ ] }, "list": { - "description": "Lists Entries within an EntryGroup.", + "description": "Lists Entries within an EntryGroup. Caution: The Vertex AI, Bigtable, Spanner, Pub/Sub, Dataform, and Dataproc Metastore metadata that is stored in Dataplex Universal Catalog is changing. For more information, see Changes to metadata stored in Dataplex Universal Catalog (https://cloud.google.com/dataplex/docs/metadata-changes).", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}/entries", "httpMethod": "GET", "id": "dataplex.projects.locations.entryGroups.entries.list", @@ -7149,7 +7149,7 @@ } } }, - "revision": "20250907", + "revision": "20250915", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -9756,12 +9756,14 @@ "enum": [ "TRIGGER_UNSPECIFIED", "ON_DEMAND", - "SCHEDULE" + "SCHEDULE", + "ONE_TIME" ], "enumDescriptions": [ "An unspecified trigger type.", "Data scan triggers on demand.", - "Data scan triggers as per schedule." + "Data scan triggers as per schedule.", + "Data scan is run one time on creation." ], "type": "string" }, @@ -12571,7 +12573,7 @@ "type": "array" }, "entryGroups": { - "description": "Required. The entry group that is in scope for the import job, specified as a relative resource name in the format projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}. Only entries and aspects that belong to the specified entry group are affected by the job.Must contain exactly one element. The entry group and the job must be in the same location.", + "description": "Required. The entry groups that are in scope for the import job, specified as relative resource names in the format projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}. Only entries and aspects that belong to the specified entry groups are affected by the job.The entry groups and the job must be in the same location.", "items": { "type": "string" }, diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index 3a1e92634c2..0d901d21234 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -3793,6 +3793,7 @@ type GoogleCloudDataplexV1DataScanEvent struct { // "TRIGGER_UNSPECIFIED" - An unspecified trigger type. // "ON_DEMAND" - Data scan triggers on demand. // "SCHEDULE" - Data scan triggers as per schedule. + // "ONE_TIME" - Data scan is run one time on creation. Trigger string `json:"trigger,omitempty"` // Type: The type of the data scan. // @@ -7012,12 +7013,12 @@ type GoogleCloudDataplexV1MetadataJobImportJobSpecImportJobScope struct { // aspects.The location of an aspect type must either match the location of the // job, or the aspect type must be global. AspectTypes []string `json:"aspectTypes,omitempty"` - // EntryGroups: Required. The entry group that is in scope for the import job, - // specified as a relative resource name in the format + // EntryGroups: Required. The entry groups that are in scope for the import + // job, specified as relative resource names in the format // projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_gr - // oup_id}. Only entries and aspects that belong to the specified entry group - // are affected by the job.Must contain exactly one element. The entry group - // and the job must be in the same location. + // oup_id}. Only entries and aspects that belong to the specified entry groups + // are affected by the job.The entry groups and the job must be in the same + // location. EntryGroups []string `json:"entryGroups,omitempty"` // EntryLinkTypes: Optional. The entry link types that are in scope for the // import job, specified as relative resource names in the format @@ -10837,7 +10838,10 @@ type ProjectsLocationsLookupEntryCall struct { } // LookupEntry: Looks up an entry by name using the permission on the source -// system. +// system. Caution: The Vertex AI, Bigtable, Spanner, Pub/Sub, Dataform, and +// Dataproc Metastore metadata that is stored in Dataplex Universal Catalog is +// changing. For more information, see Changes to metadata stored in Dataplex +// Universal Catalog (https://cloud.google.com/dataplex/docs/metadata-changes). // // - name: The project to which the request should be attributed in the // following form: projects/{project}/locations/{location}. @@ -18323,7 +18327,11 @@ type ProjectsLocationsEntryGroupsEntriesGetCall struct { header_ http.Header } -// Get: Gets an Entry. +// Get: Gets an Entry. Caution: The Vertex AI, Bigtable, Spanner, Pub/Sub, +// Dataform, and Dataproc Metastore metadata that is stored in Dataplex +// Universal Catalog is changing. For more information, see Changes to metadata +// stored in Dataplex Universal Catalog +// (https://cloud.google.com/dataplex/docs/metadata-changes). // // - name: The resource name of the Entry: // projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{ @@ -18473,7 +18481,11 @@ type ProjectsLocationsEntryGroupsEntriesListCall struct { header_ http.Header } -// List: Lists Entries within an EntryGroup. +// List: Lists Entries within an EntryGroup. Caution: The Vertex AI, Bigtable, +// Spanner, Pub/Sub, Dataform, and Dataproc Metastore metadata that is stored +// in Dataplex Universal Catalog is changing. For more information, see Changes +// to metadata stored in Dataplex Universal Catalog +// (https://cloud.google.com/dataplex/docs/metadata-changes). // // - parent: The resource name of the parent Entry Group: // projects/{project}/locations/{location}/entryGroups/{entry_group}. diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index aba8632c1d1..2c13cf20c90 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -4407,7 +4407,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -8027,6 +8027,130 @@ "https://www.googleapis.com/auth/dialogflow" ] } + }, + "resources": { + "evaluations": { + "methods": { + "create": { + "description": "Creates evaluation of a generator.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/generators/{generatorsId}/evaluations", + "httpMethod": "POST", + "id": "dialogflow.projects.locations.generators.evaluations.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The generator resource name. Format: `projects//locations//generators/`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/generators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/evaluations", + "request": { + "$ref": "GoogleCloudDialogflowV2GeneratorEvaluation" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/dialogflow" + ] + }, + "delete": { + "description": "Deletes an evaluation of generator.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/generators/{generatorsId}/evaluations/{evaluationsId}", + "httpMethod": "DELETE", + "id": "dialogflow.projects.locations.generators.evaluations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The generator evaluation resource name. Format: `projects//locations//generators// evaluations/`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/generators/[^/]+/evaluations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/dialogflow" + ] + }, + "get": { + "description": "Gets an evaluation of generator.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/generators/{generatorsId}/evaluations/{evaluationsId}", + "httpMethod": "GET", + "id": "dialogflow.projects.locations.generators.evaluations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The generator evaluation resource name. Format: `projects//locations//generators//evaluations/`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/generators/[^/]+/evaluations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "GoogleCloudDialogflowV2GeneratorEvaluation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/dialogflow" + ] + }, + "list": { + "description": "Lists evaluations of generator.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/generators/{generatorsId}/evaluations", + "httpMethod": "GET", + "id": "dialogflow.projects.locations.generators.evaluations.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Maximum number of evaluations to return in a single page. By default 100 and at most 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The next_page_token value returned from a previous list request.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The generator resource name. Format: `projects//locations//generators/` Wildcard value `-` is supported on generator_id to list evaluations across all generators under same project.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/generators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/evaluations", + "response": { + "$ref": "GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/dialogflow" + ] + } + } + } } }, "knowledgeBases": { @@ -8962,7 +9086,7 @@ } } }, - "revision": "20250902", + "revision": "20250919", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -15948,6 +16072,23 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2EvaluationStatus": { + "description": "A common evalaution pipeline status.", + "id": "GoogleCloudDialogflowV2EvaluationStatus", + "properties": { + "done": { + "description": "Output only. If the value is `false`, it means the evaluation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "readOnly": true, + "type": "boolean" + }, + "pipelineStatus": { + "$ref": "GoogleRpcStatus", + "description": "Output only. The error result of the evaluation in case of failure in evaluation pipeline.", + "readOnly": true + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2EventInput": { "description": "Events allow for matching intents by event name instead of the natural language input. For instance, input `` can trigger a personalized welcome response. The parameter `name` may be used by the agent in the response: `\"Hello #welcome_event.name! What can I do for you today?\"`.", "id": "GoogleCloudDialogflowV2EventInput", @@ -16496,6 +16637,199 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2GeneratorEvaluation": { + "description": "Represents evaluation result of a generator.", + "id": "GoogleCloudDialogflowV2GeneratorEvaluation", + "properties": { + "completeTime": { + "description": "Output only. Completion time of this generator evaluation.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. Creation time of this generator evaluation.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. The display name of the generator evaluation. At most 64 bytes long.", + "type": "string" + }, + "evaluationStatus": { + "$ref": "GoogleCloudDialogflowV2EvaluationStatus", + "description": "Output only. The result status of the evaluation pipeline. Provides the status information including if the evaluation is still in progress, completed or failed with certain error and user actionable message.", + "readOnly": true + }, + "generatorEvaluationConfig": { + "$ref": "GoogleCloudDialogflowV2GeneratorEvaluationConfig", + "description": "Required. The configuration of the evaluation task." + }, + "initialGenerator": { + "$ref": "GoogleCloudDialogflowV2Generator", + "description": "Required. The initial generator that was used when creating this evaluation. This is a copy of the generator read from storage when creating the evaluation." + }, + "name": { + "description": "Output only. Identifier. The resource name of the evaluation. Format: `projects//locations//generators// evaluations/`", + "readOnly": true, + "type": "string" + }, + "summarizationMetrics": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetrics", + "description": "Output only. Only available when the summarization generator is provided.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2GeneratorEvaluationConfig": { + "description": "Generator evaluation input config.", + "id": "GoogleCloudDialogflowV2GeneratorEvaluationConfig", + "properties": { + "inputDataConfig": { + "$ref": "GoogleCloudDialogflowV2GeneratorEvaluationConfigInputDataConfig", + "description": "Required. The config/source of input data." + }, + "outputGcsBucketPath": { + "description": "Required. The output Cloud Storage bucket path to store eval files, e.g. per_summary_accuracy_score report. This path is provided by customer and files stored in it are visible to customer, no internal data should be stored in this path.", + "type": "string" + }, + "summarizationConfig": { + "$ref": "GoogleCloudDialogflowV2GeneratorEvaluationConfigSummarizationConfig", + "description": "Evaluation configs for summarization generator." + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2GeneratorEvaluationConfigAgentAssistInputDataConfig": { + "description": "The distinctive configs for Agent Assist conversations as the conversation source.", + "id": "GoogleCloudDialogflowV2GeneratorEvaluationConfigAgentAssistInputDataConfig", + "properties": { + "endTime": { + "description": "Required. The end of the time range for conversations to be evaluated. Only conversations ended at or before this timestamp will be sampled.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Required. The start of the time range for conversations to be evaluated. Only conversations created at or after this timestamp will be sampled.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2GeneratorEvaluationConfigDatasetInputDataConfig": { + "description": "The distinctive configs for dataset as the conversation source.", + "id": "GoogleCloudDialogflowV2GeneratorEvaluationConfigDatasetInputDataConfig", + "properties": { + "dataset": { + "description": "Required. The identifier of the dataset to be evaluated. Format: `projects//locations//datasets/`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2GeneratorEvaluationConfigInputDataConfig": { + "description": "Input data config details", + "id": "GoogleCloudDialogflowV2GeneratorEvaluationConfigInputDataConfig", + "properties": { + "agentAssistInputDataConfig": { + "$ref": "GoogleCloudDialogflowV2GeneratorEvaluationConfigAgentAssistInputDataConfig", + "description": "The distinctive configs for Agent Assist conversations as the conversation source." + }, + "datasetInputDataConfig": { + "$ref": "GoogleCloudDialogflowV2GeneratorEvaluationConfigDatasetInputDataConfig", + "description": "The distinctive configs for dataset as the conversation source." + }, + "endTime": { + "deprecated": true, + "description": "Optional. The end timestamp to fetch conversation data.", + "format": "google-datetime", + "type": "string" + }, + "inputDataSourceType": { + "deprecated": true, + "description": "Required. The source type of input data.", + "enum": [ + "INPUT_DATA_SOURCE_TYPE_UNSPECIFIED", + "AGENT_ASSIST_CONVERSATIONS", + "INSIGHTS_CONVERSATIONS" + ], + "enumDescriptions": [ + "Unspecified InputDataSourceType. Should not be used.", + "Fetch data from Agent Assist storage. If this source type is chosen, input_data_config.start_time and input_data_config.end_timestamp must be provided.", + "Fetch data from Insights storage. If this source type is chosen, input_data_config.start_time and input_data_config.end_timestamp must be provided." + ], + "type": "string" + }, + "isSummaryGenerationAllowed": { + "deprecated": true, + "description": "Optional. Whether the summary generation is allowed when the pre-existing qualified summaries are insufficient to cover the sample size.", + "type": "boolean" + }, + "sampleSize": { + "description": "Optional. Desired number of conversation-summary pairs to be evaluated.", + "format": "int32", + "type": "integer" + }, + "startTime": { + "deprecated": true, + "description": "Optional. The start timestamp to fetch conversation data.", + "format": "google-datetime", + "type": "string" + }, + "summaryGenerationOption": { + "description": "Optional. Option to control whether summaries are generated during evaluation.", + "enum": [ + "SUMMARY_GENERATION_OPTION_UNSPECIFIED", + "ALWAYS_GENERATE", + "GENERATE_IF_MISSING", + "DO_NOT_GENERATE" + ], + "enumDescriptions": [ + "Default option will not be used", + "Always Generate summary for all conversations.", + "Gnerate only missing summaries.", + "Do not generate new summaries. Only use existing summaries found." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2GeneratorEvaluationConfigSummarizationConfig": { + "description": "Evaluation configs for summarization generator.", + "id": "GoogleCloudDialogflowV2GeneratorEvaluationConfigSummarizationConfig", + "properties": { + "accuracyEvaluationVersion": { + "deprecated": true, + "description": "Optional. Version for summarization accuracy. This will determine the prompt and model used at backend.", + "type": "string" + }, + "completenessEvaluationVersion": { + "deprecated": true, + "description": "Optional. Version for summarization completeness. This will determine the prompt and model used at backend.", + "type": "string" + }, + "enableAccuracyEvaluation": { + "deprecated": true, + "description": "Optional. Enable accuracy evaluation.", + "type": "boolean" + }, + "enableCompletenessEvaluation": { + "deprecated": true, + "description": "Optional. Enable completeness evaluation.", + "type": "boolean" + }, + "evaluatorVersion": { + "description": "Output only. Version for summarization evaluation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2GeneratorSuggestion": { "description": "Suggestion generated using a Generator.", "id": "GoogleCloudDialogflowV2GeneratorSuggestion", @@ -18535,6 +18869,24 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse": { + "description": "Response of ListGeneratorEvaluations.", + "id": "GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse", + "properties": { + "generatorEvaluations": { + "description": "The list of evaluations to return.", + "items": { + "$ref": "GoogleCloudDialogflowV2GeneratorEvaluation" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2ListGeneratorsResponse": { "description": "Response of ListGenerators.", "id": "GoogleCloudDialogflowV2ListGeneratorsResponse", @@ -20240,6 +20592,346 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetrics": { + "description": "Evaluation metrics for summarization generator.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetrics", + "properties": { + "conversationDetails": { + "description": "Output only. List of conversation details.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetail" + }, + "readOnly": true, + "type": "array" + }, + "overallMetrics": { + "description": "Output only. A list of aggregated(average) scores per metric section.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsOverallScoresByMetric" + }, + "readOnly": true, + "type": "array" + }, + "overallSectionTokens": { + "description": "Output only. Overall token per section. This is an aggregated(sum) result of input token of summary acorss all conversations that are selected for summarization evaluation.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken" + }, + "readOnly": true, + "type": "array" + }, + "summarizationEvaluationMergedResultsUri": { + "description": "Output only. User bucket uri for merged evaluation score and aggregation score csv.", + "readOnly": true, + "type": "string" + }, + "summarizationEvaluationResults": { + "description": "Output only. A list of evaluation results per conversation(\u0026summary), metric and section.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition": { + "description": "Decomposition details for accuracy.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition", + "properties": { + "accuracyReasoning": { + "description": "Output only. The accuracy reasoning of the breakdown point.", + "readOnly": true, + "type": "string" + }, + "isAccurate": { + "description": "Output only. Whether the breakdown point is accurate or not.", + "readOnly": true, + "type": "boolean" + }, + "point": { + "description": "Output only. The breakdown point of the summary.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceDecomposition": { + "deprecated": true, + "description": "Decomposition details for adherence.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceDecomposition", + "properties": { + "adherenceReasoning": { + "description": "Output only. The adherence reasoning of the breakdown point.", + "readOnly": true, + "type": "string" + }, + "isAdherent": { + "description": "Output only. Whether the breakdown point is adherent or not.", + "readOnly": true, + "type": "boolean" + }, + "point": { + "description": "Output only. The breakdown point of the given instructions.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceRubric": { + "description": "Rubric result of the adherence evaluation. A rubric is ued to determine if the summary adheres to all aspects of the given instructions.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceRubric", + "properties": { + "isAddressed": { + "description": "Output only. A boolean that indicates whether the rubric question is addressed or not.", + "readOnly": true, + "type": "boolean" + }, + "question": { + "description": "Output only. The question generated from instruction that used to evaluate summary.", + "readOnly": true, + "type": "string" + }, + "reasoning": { + "description": "Output only. The reasoning of the rubric question is addressed or not.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsCompletenessRubric": { + "description": "Rubric details of the completeness evaluation result.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsCompletenessRubric", + "properties": { + "isAddressed": { + "description": "Output only. A boolean that indicates whether the rubric question is addressed or not.", + "readOnly": true, + "type": "boolean" + }, + "question": { + "description": "Output only. The question generated from instruction that used to evaluate summary.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetail": { + "description": "Aggregated evaluation result on conversation level. This conatins evaluation results of all the metrics and sections.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetail", + "properties": { + "messageEntries": { + "description": "Output only. Conversation transcript that used for summarization evaluation as a reference.", + "items": { + "$ref": "GoogleCloudDialogflowV2MessageEntry" + }, + "readOnly": true, + "type": "array" + }, + "metricDetails": { + "description": "Output only. List of metric details.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail" + }, + "readOnly": true, + "type": "array" + }, + "sectionTokens": { + "description": "Output only. Conversation level token count per section. This is an aggregated(sum) result of input token of summary acorss all metrics for a single conversation.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken" + }, + "readOnly": true, + "type": "array" + }, + "summarySections": { + "description": "Output only. Summary sections that used for summarization evaluation as a reference.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarySuggestionSummarySection" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail": { + "description": "Aggregated result on metric level. This conatins the evaluation results of all the sections.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail", + "properties": { + "metric": { + "description": "Output only. Metrics name. e.g. accuracy, adherence, completeness.", + "readOnly": true, + "type": "string" + }, + "score": { + "description": "Output only. Aggregated(average) score on this metric across all sections.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "sectionDetails": { + "description": "Output only. List of section details.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail": { + "description": "Section level result.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail", + "properties": { + "evaluationResults": { + "description": "Output only. List of evaluation result. The list only contains one kind of the evaluation result.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult" + }, + "readOnly": true, + "type": "array" + }, + "score": { + "description": "Output only. Aggregated(average) score on this section across all evaluation results. Either decompositions or rubrics.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "section": { + "description": "Output only. The name of the summary instruction.", + "readOnly": true, + "type": "string" + }, + "sectionSummary": { + "description": "Output only. Summary for this section", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsDecomposition": { + "deprecated": true, + "description": "Decomposition details", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsDecomposition", + "properties": { + "accuracyDecomposition": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition", + "description": "only available for accuracy metric." + }, + "adherenceDecomposition": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceDecomposition", + "description": "only available for adherence metric." + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult": { + "description": "Evaluation result that contains one of accuracy, adherence or completeness evaluation result.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult", + "properties": { + "accuracyDecomposition": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition", + "description": "Only available for accuracy metric." + }, + "adherenceRubric": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceRubric", + "description": "Only available for adherence metric." + }, + "completenessRubric": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsCompletenessRubric", + "description": "Only available for completeness metric." + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsOverallScoresByMetric": { + "description": "Overall performance per metric. This is the aggregated score for each metric across all conversations that are selected for summarization evaluation.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsOverallScoresByMetric", + "properties": { + "metric": { + "description": "Output only. Metric name. e.g. accuracy, adherence, completeness.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken": { + "description": "A pair of section name and input token count of the input summary section.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken", + "properties": { + "section": { + "description": "Output only. The name of the summary instruction.", + "readOnly": true, + "type": "string" + }, + "tokenCount": { + "description": "Output only. Token count.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult": { + "description": "Evaluation result per conversation(\u0026summary), metric and section.", + "id": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult", + "properties": { + "decompositions": { + "deprecated": true, + "description": "Output only. List of decompostion details", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsDecomposition" + }, + "readOnly": true, + "type": "array" + }, + "evaluationResults": { + "description": "Output only. List of evaluation results.", + "items": { + "$ref": "GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult" + }, + "readOnly": true, + "type": "array" + }, + "metric": { + "description": "Output only. metric name, e.g. accuracy, completeness, adherence, etc.", + "readOnly": true, + "type": "string" + }, + "score": { + "description": "Output only. score calculated from decompositions", + "format": "float", + "readOnly": true, + "type": "number" + }, + "section": { + "description": "Output only. section/task name, e.g. action, situation, etc", + "readOnly": true, + "type": "string" + }, + "sectionSummary": { + "description": "Output only. Summary of this section", + "readOnly": true, + "type": "string" + }, + "sessionId": { + "deprecated": true, + "description": "Output only. conversation session id", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2SummarizationSection": { "description": "Represents the section of summarization.", "id": "GoogleCloudDialogflowV2SummarizationSection", diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 58b8c2c4544..d3c3edccca9 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -860,11 +860,23 @@ type ProjectsLocationsEncryptionSpecService struct { func NewProjectsLocationsGeneratorsService(s *Service) *ProjectsLocationsGeneratorsService { rs := &ProjectsLocationsGeneratorsService{s: s} + rs.Evaluations = NewProjectsLocationsGeneratorsEvaluationsService(s) return rs } type ProjectsLocationsGeneratorsService struct { s *Service + + Evaluations *ProjectsLocationsGeneratorsEvaluationsService +} + +func NewProjectsLocationsGeneratorsEvaluationsService(s *Service) *ProjectsLocationsGeneratorsEvaluationsService { + rs := &ProjectsLocationsGeneratorsEvaluationsService{s: s} + return rs +} + +type ProjectsLocationsGeneratorsEvaluationsService struct { + s *Service } func NewProjectsLocationsKnowledgeBasesService(s *Service) *ProjectsLocationsKnowledgeBasesService { @@ -10530,6 +10542,34 @@ func (s GoogleCloudDialogflowV2EvaluationConfigSmartReplyConfig) MarshalJSON() ( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2EvaluationStatus: A common evalaution pipeline +// status. +type GoogleCloudDialogflowV2EvaluationStatus struct { + // Done: Output only. If the value is `false`, it means the evaluation is still + // in progress. If `true`, the operation is completed, and either `error` or + // `response` is available. + Done bool `json:"done,omitempty"` + // PipelineStatus: Output only. The error result of the evaluation in case of + // failure in evaluation pipeline. + PipelineStatus *GoogleRpcStatus `json:"pipelineStatus,omitempty"` + // 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 GoogleCloudDialogflowV2EvaluationStatus) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2EvaluationStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowV2EventInput: Events allow for matching intents by // event name instead of the natural language input. For instance, input “ can // trigger a personalized welcome response. The parameter `name` may be used by @@ -11344,6 +11384,232 @@ func (s GoogleCloudDialogflowV2Generator) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2GeneratorEvaluation: Represents evaluation result of +// a generator. +type GoogleCloudDialogflowV2GeneratorEvaluation struct { + // CompleteTime: Output only. Completion time of this generator evaluation. + CompleteTime string `json:"completeTime,omitempty"` + // CreateTime: Output only. Creation time of this generator evaluation. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Optional. The display name of the generator evaluation. At most + // 64 bytes long. + DisplayName string `json:"displayName,omitempty"` + // EvaluationStatus: Output only. The result status of the evaluation pipeline. + // Provides the status information including if the evaluation is still in + // progress, completed or failed with certain error and user actionable + // message. + EvaluationStatus *GoogleCloudDialogflowV2EvaluationStatus `json:"evaluationStatus,omitempty"` + // GeneratorEvaluationConfig: Required. The configuration of the evaluation + // task. + GeneratorEvaluationConfig *GoogleCloudDialogflowV2GeneratorEvaluationConfig `json:"generatorEvaluationConfig,omitempty"` + // InitialGenerator: Required. The initial generator that was used when + // creating this evaluation. This is a copy of the generator read from storage + // when creating the evaluation. + InitialGenerator *GoogleCloudDialogflowV2Generator `json:"initialGenerator,omitempty"` + // Name: Output only. Identifier. The resource name of the evaluation. Format: + // `projects//locations//generators// evaluations/` + Name string `json:"name,omitempty"` + // SummarizationMetrics: Output only. Only available when the summarization + // generator is provided. + SummarizationMetrics *GoogleCloudDialogflowV2SummarizationEvaluationMetrics `json:"summarizationMetrics,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CompleteTime") 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. "CompleteTime") 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 GoogleCloudDialogflowV2GeneratorEvaluation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2GeneratorEvaluation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2GeneratorEvaluationConfig: Generator evaluation input +// config. +type GoogleCloudDialogflowV2GeneratorEvaluationConfig struct { + // InputDataConfig: Required. The config/source of input data. + InputDataConfig *GoogleCloudDialogflowV2GeneratorEvaluationConfigInputDataConfig `json:"inputDataConfig,omitempty"` + // OutputGcsBucketPath: Required. The output Cloud Storage bucket path to store + // eval files, e.g. per_summary_accuracy_score report. This path is provided by + // customer and files stored in it are visible to customer, no internal data + // should be stored in this path. + OutputGcsBucketPath string `json:"outputGcsBucketPath,omitempty"` + // SummarizationConfig: Evaluation configs for summarization generator. + SummarizationConfig *GoogleCloudDialogflowV2GeneratorEvaluationConfigSummarizationConfig `json:"summarizationConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "InputDataConfig") 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. "InputDataConfig") 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 GoogleCloudDialogflowV2GeneratorEvaluationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2GeneratorEvaluationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2GeneratorEvaluationConfigAgentAssistInputDataConfig: +// The distinctive configs for Agent Assist conversations as the conversation +// source. +type GoogleCloudDialogflowV2GeneratorEvaluationConfigAgentAssistInputDataConfig struct { + // EndTime: Required. The end of the time range for conversations to be + // evaluated. Only conversations ended at or before this timestamp will be + // sampled. + EndTime string `json:"endTime,omitempty"` + // StartTime: Required. The start of the time range for conversations to be + // evaluated. Only conversations created at or after this timestamp will be + // sampled. + 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 GoogleCloudDialogflowV2GeneratorEvaluationConfigAgentAssistInputDataConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2GeneratorEvaluationConfigAgentAssistInputDataConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2GeneratorEvaluationConfigDatasetInputDataConfig: The +// distinctive configs for dataset as the conversation source. +type GoogleCloudDialogflowV2GeneratorEvaluationConfigDatasetInputDataConfig struct { + // Dataset: Required. The identifier of the dataset to be evaluated. Format: + // `projects//locations//datasets/`. + 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 + // 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. "Dataset") 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 GoogleCloudDialogflowV2GeneratorEvaluationConfigDatasetInputDataConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2GeneratorEvaluationConfigDatasetInputDataConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2GeneratorEvaluationConfigInputDataConfig: Input data +// config details +type GoogleCloudDialogflowV2GeneratorEvaluationConfigInputDataConfig struct { + // AgentAssistInputDataConfig: The distinctive configs for Agent Assist + // conversations as the conversation source. + AgentAssistInputDataConfig *GoogleCloudDialogflowV2GeneratorEvaluationConfigAgentAssistInputDataConfig `json:"agentAssistInputDataConfig,omitempty"` + // DatasetInputDataConfig: The distinctive configs for dataset as the + // conversation source. + DatasetInputDataConfig *GoogleCloudDialogflowV2GeneratorEvaluationConfigDatasetInputDataConfig `json:"datasetInputDataConfig,omitempty"` + // EndTime: Optional. The end timestamp to fetch conversation data. + EndTime string `json:"endTime,omitempty"` + // InputDataSourceType: Required. The source type of input data. + // + // Possible values: + // "INPUT_DATA_SOURCE_TYPE_UNSPECIFIED" - Unspecified InputDataSourceType. + // Should not be used. + // "AGENT_ASSIST_CONVERSATIONS" - Fetch data from Agent Assist storage. If + // this source type is chosen, input_data_config.start_time and + // input_data_config.end_timestamp must be provided. + // "INSIGHTS_CONVERSATIONS" - Fetch data from Insights storage. If this + // source type is chosen, input_data_config.start_time and + // input_data_config.end_timestamp must be provided. + InputDataSourceType string `json:"inputDataSourceType,omitempty"` + // IsSummaryGenerationAllowed: Optional. Whether the summary generation is + // allowed when the pre-existing qualified summaries are insufficient to cover + // the sample size. + IsSummaryGenerationAllowed bool `json:"isSummaryGenerationAllowed,omitempty"` + // SampleSize: Optional. Desired number of conversation-summary pairs to be + // evaluated. + SampleSize int64 `json:"sampleSize,omitempty"` + // StartTime: Optional. The start timestamp to fetch conversation data. + StartTime string `json:"startTime,omitempty"` + // SummaryGenerationOption: Optional. Option to control whether summaries are + // generated during evaluation. + // + // Possible values: + // "SUMMARY_GENERATION_OPTION_UNSPECIFIED" - Default option will not be used + // "ALWAYS_GENERATE" - Always Generate summary for all conversations. + // "GENERATE_IF_MISSING" - Gnerate only missing summaries. + // "DO_NOT_GENERATE" - Do not generate new summaries. Only use existing + // summaries found. + SummaryGenerationOption string `json:"summaryGenerationOption,omitempty"` + // ForceSendFields is a list of field names (e.g. "AgentAssistInputDataConfig") + // 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. "AgentAssistInputDataConfig") 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 GoogleCloudDialogflowV2GeneratorEvaluationConfigInputDataConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2GeneratorEvaluationConfigInputDataConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2GeneratorEvaluationConfigSummarizationConfig: +// Evaluation configs for summarization generator. +type GoogleCloudDialogflowV2GeneratorEvaluationConfigSummarizationConfig struct { + // AccuracyEvaluationVersion: Optional. Version for summarization accuracy. + // This will determine the prompt and model used at backend. + AccuracyEvaluationVersion string `json:"accuracyEvaluationVersion,omitempty"` + // CompletenessEvaluationVersion: Optional. Version for summarization + // completeness. This will determine the prompt and model used at backend. + CompletenessEvaluationVersion string `json:"completenessEvaluationVersion,omitempty"` + // EnableAccuracyEvaluation: Optional. Enable accuracy evaluation. + EnableAccuracyEvaluation bool `json:"enableAccuracyEvaluation,omitempty"` + // EnableCompletenessEvaluation: Optional. Enable completeness evaluation. + EnableCompletenessEvaluation bool `json:"enableCompletenessEvaluation,omitempty"` + // EvaluatorVersion: Output only. Version for summarization evaluation. + EvaluatorVersion string `json:"evaluatorVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccuracyEvaluationVersion") + // 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. "AccuracyEvaluationVersion") 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 GoogleCloudDialogflowV2GeneratorEvaluationConfigSummarizationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2GeneratorEvaluationConfigSummarizationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowV2GeneratorSuggestion: Suggestion generated using a // Generator. type GoogleCloudDialogflowV2GeneratorSuggestion struct { @@ -14275,6 +14541,35 @@ func (s GoogleCloudDialogflowV2ListEnvironmentsResponse) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse: Response of +// ListGeneratorEvaluations. +type GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse struct { + // GeneratorEvaluations: The list of evaluations to return. + GeneratorEvaluations []*GoogleCloudDialogflowV2GeneratorEvaluation `json:"generatorEvaluations,omitempty"` + // NextPageToken: Token to retrieve the next page of results, or empty if there + // are no more results in the list. + 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. "GeneratorEvaluations") 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. "GeneratorEvaluations") 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 GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowV2ListGeneratorsResponse: Response of ListGenerators. type GoogleCloudDialogflowV2ListGeneratorsResponse struct { // Generators: List of generators retrieved. @@ -16874,6 +17169,430 @@ func (s GoogleCloudDialogflowV2SummarizationContext) MarshalJSON() ([]byte, erro return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2SummarizationEvaluationMetrics: Evaluation metrics +// for summarization generator. +type GoogleCloudDialogflowV2SummarizationEvaluationMetrics struct { + // ConversationDetails: Output only. List of conversation details. + ConversationDetails []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetail `json:"conversationDetails,omitempty"` + // OverallMetrics: Output only. A list of aggregated(average) scores per metric + // section. + OverallMetrics []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsOverallScoresByMetric `json:"overallMetrics,omitempty"` + // OverallSectionTokens: Output only. Overall token per section. This is an + // aggregated(sum) result of input token of summary acorss all conversations + // that are selected for summarization evaluation. + OverallSectionTokens []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken `json:"overallSectionTokens,omitempty"` + // SummarizationEvaluationMergedResultsUri: Output only. User bucket uri for + // merged evaluation score and aggregation score csv. + SummarizationEvaluationMergedResultsUri string `json:"summarizationEvaluationMergedResultsUri,omitempty"` + // SummarizationEvaluationResults: Output only. A list of evaluation results + // per conversation(&summary), metric and section. + SummarizationEvaluationResults []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult `json:"summarizationEvaluationResults,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConversationDetails") 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. "ConversationDetails") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetrics) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetrics + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition: +// Decomposition details for accuracy. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition struct { + // AccuracyReasoning: Output only. The accuracy reasoning of the breakdown + // point. + AccuracyReasoning string `json:"accuracyReasoning,omitempty"` + // IsAccurate: Output only. Whether the breakdown point is accurate or not. + IsAccurate bool `json:"isAccurate,omitempty"` + // Point: Output only. The breakdown point of the summary. + Point string `json:"point,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccuracyReasoning") 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. "AccuracyReasoning") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceDecomposition: +// Decomposition details for adherence. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceDecomposition struct { + // AdherenceReasoning: Output only. The adherence reasoning of the breakdown + // point. + AdherenceReasoning string `json:"adherenceReasoning,omitempty"` + // IsAdherent: Output only. Whether the breakdown point is adherent or not. + IsAdherent bool `json:"isAdherent,omitempty"` + // Point: Output only. The breakdown point of the given instructions. + Point string `json:"point,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdherenceReasoning") 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. "AdherenceReasoning") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceDecomposition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceDecomposition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceRubric: Rubric +// result of the adherence evaluation. A rubric is ued to determine if the +// summary adheres to all aspects of the given instructions. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceRubric struct { + // IsAddressed: Output only. A boolean that indicates whether the rubric + // question is addressed or not. + IsAddressed bool `json:"isAddressed,omitempty"` + // Question: Output only. The question generated from instruction that used to + // evaluate summary. + Question string `json:"question,omitempty"` + // Reasoning: Output only. The reasoning of the rubric question is addressed or + // not. + Reasoning string `json:"reasoning,omitempty"` + // ForceSendFields is a list of field names (e.g. "IsAddressed") 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. "IsAddressed") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceRubric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceRubric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsCompletenessRubric: +// Rubric details of the completeness evaluation result. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsCompletenessRubric struct { + // IsAddressed: Output only. A boolean that indicates whether the rubric + // question is addressed or not. + IsAddressed bool `json:"isAddressed,omitempty"` + // Question: Output only. The question generated from instruction that used to + // evaluate summary. + Question string `json:"question,omitempty"` + // ForceSendFields is a list of field names (e.g. "IsAddressed") 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. "IsAddressed") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsCompletenessRubric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsCompletenessRubric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetail: +// Aggregated evaluation result on conversation level. This conatins evaluation +// results of all the metrics and sections. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetail struct { + // MessageEntries: Output only. Conversation transcript that used for + // summarization evaluation as a reference. + MessageEntries []*GoogleCloudDialogflowV2MessageEntry `json:"messageEntries,omitempty"` + // MetricDetails: Output only. List of metric details. + MetricDetails []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail `json:"metricDetails,omitempty"` + // SectionTokens: Output only. Conversation level token count per section. This + // is an aggregated(sum) result of input token of summary acorss all metrics + // for a single conversation. + SectionTokens []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken `json:"sectionTokens,omitempty"` + // SummarySections: Output only. Summary sections that used for summarization + // evaluation as a reference. + SummarySections []*GoogleCloudDialogflowV2SummarySuggestionSummarySection `json:"summarySections,omitempty"` + // ForceSendFields is a list of field names (e.g. "MessageEntries") 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. "MessageEntries") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetail) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetric +// Detail: Aggregated result on metric level. This conatins the evaluation +// results of all the sections. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail struct { + // Metric: Output only. Metrics name. e.g. accuracy, adherence, completeness. + Metric string `json:"metric,omitempty"` + // Score: Output only. Aggregated(average) score on this metric across all + // sections. + Score float64 `json:"score,omitempty"` + // SectionDetails: Output only. List of section details. + SectionDetails []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail `json:"sectionDetails,omitempty"` + // ForceSendFields is a list of field names (e.g. "Metric") 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. "Metric") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetail + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetric +// DetailSectionDetail: Section level result. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail struct { + // EvaluationResults: Output only. List of evaluation result. The list only + // contains one kind of the evaluation result. + EvaluationResults []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult `json:"evaluationResults,omitempty"` + // Score: Output only. Aggregated(average) score on this section across all + // evaluation results. Either decompositions or rubrics. + Score float64 `json:"score,omitempty"` + // Section: Output only. The name of the summary instruction. + Section string `json:"section,omitempty"` + // SectionSummary: Output only. Summary for this section + SectionSummary string `json:"sectionSummary,omitempty"` + // ForceSendFields is a list of field names (e.g. "EvaluationResults") 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. "EvaluationResults") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsDecomposition: +// Decomposition details +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsDecomposition struct { + // AccuracyDecomposition: only available for accuracy metric. + AccuracyDecomposition *GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition `json:"accuracyDecomposition,omitempty"` + // AdherenceDecomposition: only available for adherence metric. + AdherenceDecomposition *GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceDecomposition `json:"adherenceDecomposition,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccuracyDecomposition") 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. "AccuracyDecomposition") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsDecomposition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsDecomposition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult: +// Evaluation result that contains one of accuracy, adherence or completeness +// evaluation result. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult struct { + // AccuracyDecomposition: Only available for accuracy metric. + AccuracyDecomposition *GoogleCloudDialogflowV2SummarizationEvaluationMetricsAccuracyDecomposition `json:"accuracyDecomposition,omitempty"` + // AdherenceRubric: Only available for adherence metric. + AdherenceRubric *GoogleCloudDialogflowV2SummarizationEvaluationMetricsAdherenceRubric `json:"adherenceRubric,omitempty"` + // CompletenessRubric: Only available for completeness metric. + CompletenessRubric *GoogleCloudDialogflowV2SummarizationEvaluationMetricsCompletenessRubric `json:"completenessRubric,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccuracyDecomposition") 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. "AccuracyDecomposition") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsOverallScoresByMetric: +// Overall performance per metric. This is the aggregated score for each metric +// across all conversations that are selected for summarization evaluation. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsOverallScoresByMetric struct { + // Metric: Output only. Metric name. e.g. accuracy, adherence, completeness. + Metric string `json:"metric,omitempty"` + // ForceSendFields is a list of field names (e.g. "Metric") 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. "Metric") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsOverallScoresByMetric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsOverallScoresByMetric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken: A pair of +// section name and input token count of the input summary section. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken struct { + // Section: Output only. The name of the summary instruction. + Section string `json:"section,omitempty"` + // TokenCount: Output only. Token count. + TokenCount int64 `json:"tokenCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "Section") 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. "Section") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsSectionToken + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationR +// esult: Evaluation result per conversation(&summary), metric and section. +type GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult struct { + // Decompositions: Output only. List of decompostion details + Decompositions []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsDecomposition `json:"decompositions,omitempty"` + // EvaluationResults: Output only. List of evaluation results. + EvaluationResults []*GoogleCloudDialogflowV2SummarizationEvaluationMetricsEvaluationResult `json:"evaluationResults,omitempty"` + // Metric: Output only. metric name, e.g. accuracy, completeness, adherence, + // etc. + Metric string `json:"metric,omitempty"` + // Score: Output only. score calculated from decompositions + Score float64 `json:"score,omitempty"` + // Section: Output only. section/task name, e.g. action, situation, etc + Section string `json:"section,omitempty"` + // SectionSummary: Output only. Summary of this section + SectionSummary string `json:"sectionSummary,omitempty"` + // SessionId: Output only. conversation session id + SessionId string `json:"sessionId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Decompositions") 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. "Decompositions") 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 GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2SummarizationEvaluationMetricsSummarizationEvaluationResult + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + // GoogleCloudDialogflowV2SummarizationSection: Represents the section of // summarization. type GoogleCloudDialogflowV2SummarizationSection struct { @@ -37584,9 +38303,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c @@ -50781,6 +51500,468 @@ func (c *ProjectsLocationsGeneratorsPatchCall) Do(opts ...googleapi.CallOption) return ret, nil } +type ProjectsLocationsGeneratorsEvaluationsCreateCall struct { + s *Service + parent string + googleclouddialogflowv2generatorevaluation *GoogleCloudDialogflowV2GeneratorEvaluation + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates evaluation of a generator. +// +// - parent: The generator resource name. Format: +// `projects//locations//generators/`. +func (r *ProjectsLocationsGeneratorsEvaluationsService) Create(parent string, googleclouddialogflowv2generatorevaluation *GoogleCloudDialogflowV2GeneratorEvaluation) *ProjectsLocationsGeneratorsEvaluationsCreateCall { + c := &ProjectsLocationsGeneratorsEvaluationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddialogflowv2generatorevaluation = googleclouddialogflowv2generatorevaluation + 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 *ProjectsLocationsGeneratorsEvaluationsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsGeneratorsEvaluationsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGeneratorsEvaluationsCreateCall) Context(ctx context.Context) *ProjectsLocationsGeneratorsEvaluationsCreateCall { + 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 *ProjectsLocationsGeneratorsEvaluationsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGeneratorsEvaluationsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddialogflowv2generatorevaluation) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+parent}/evaluations") + 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", "dialogflow.projects.locations.generators.evaluations.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dialogflow.projects.locations.generators.evaluations.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 *ProjectsLocationsGeneratorsEvaluationsCreateCall) 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", "dialogflow.projects.locations.generators.evaluations.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGeneratorsEvaluationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an evaluation of generator. +// +// - name: The generator evaluation resource name. Format: +// `projects//locations//generators// evaluations/`. +func (r *ProjectsLocationsGeneratorsEvaluationsService) Delete(name string) *ProjectsLocationsGeneratorsEvaluationsDeleteCall { + c := &ProjectsLocationsGeneratorsEvaluationsDeleteCall{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 *ProjectsLocationsGeneratorsEvaluationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsGeneratorsEvaluationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGeneratorsEvaluationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsGeneratorsEvaluationsDeleteCall { + 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 *ProjectsLocationsGeneratorsEvaluationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGeneratorsEvaluationsDeleteCall) 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, "v2/{+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", "dialogflow.projects.locations.generators.evaluations.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dialogflow.projects.locations.generators.evaluations.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 *ProjectsLocationsGeneratorsEvaluationsDeleteCall) 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", "dialogflow.projects.locations.generators.evaluations.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGeneratorsEvaluationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets an evaluation of generator. +// +// - name: The generator evaluation resource name. Format: +// `projects//locations//generators//evaluations/`. +func (r *ProjectsLocationsGeneratorsEvaluationsService) Get(name string) *ProjectsLocationsGeneratorsEvaluationsGetCall { + c := &ProjectsLocationsGeneratorsEvaluationsGetCall{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 *ProjectsLocationsGeneratorsEvaluationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGeneratorsEvaluationsGetCall { + 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 *ProjectsLocationsGeneratorsEvaluationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGeneratorsEvaluationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGeneratorsEvaluationsGetCall) Context(ctx context.Context) *ProjectsLocationsGeneratorsEvaluationsGetCall { + 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 *ProjectsLocationsGeneratorsEvaluationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGeneratorsEvaluationsGetCall) 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/{+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", "dialogflow.projects.locations.generators.evaluations.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dialogflow.projects.locations.generators.evaluations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDialogflowV2GeneratorEvaluation.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 *ProjectsLocationsGeneratorsEvaluationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDialogflowV2GeneratorEvaluation, 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 := &GoogleCloudDialogflowV2GeneratorEvaluation{ + 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", "dialogflow.projects.locations.generators.evaluations.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGeneratorsEvaluationsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists evaluations of generator. +// +// - parent: The generator resource name. Format: +// `projects//locations//generators/` Wildcard value `-` is supported on +// generator_id to list evaluations across all generators under same project. +func (r *ProjectsLocationsGeneratorsEvaluationsService) List(parent string) *ProjectsLocationsGeneratorsEvaluationsListCall { + c := &ProjectsLocationsGeneratorsEvaluationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// evaluations to return in a single page. By default 100 and at most 1000. +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) PageSize(pageSize int64) *ProjectsLocationsGeneratorsEvaluationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The next_page_token value +// returned from a previous list request. +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) PageToken(pageToken string) *ProjectsLocationsGeneratorsEvaluationsListCall { + 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 *ProjectsLocationsGeneratorsEvaluationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGeneratorsEvaluationsListCall { + 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 *ProjectsLocationsGeneratorsEvaluationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGeneratorsEvaluationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) Context(ctx context.Context) *ProjectsLocationsGeneratorsEvaluationsListCall { + 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 *ProjectsLocationsGeneratorsEvaluationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) 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}/evaluations") + 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", "dialogflow.projects.locations.generators.evaluations.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dialogflow.projects.locations.generators.evaluations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse.ServerResponse.Heade +// r or (if a response was returned at all) in error.(*googleapi.Error).Header. +// Use googleapi.IsNotModified to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse, 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 := &GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse{ + 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", "dialogflow.projects.locations.generators.evaluations.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 *ProjectsLocationsGeneratorsEvaluationsListCall) Pages(ctx context.Context, f func(*GoogleCloudDialogflowV2ListGeneratorEvaluationsResponse) 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 ProjectsLocationsKnowledgeBasesCreateCall struct { s *Service parent string diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index ebbce301ca9..22881ce4ae1 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -4172,7 +4172,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -7419,6 +7419,130 @@ "https://www.googleapis.com/auth/dialogflow" ] } + }, + "resources": { + "evaluations": { + "methods": { + "create": { + "description": "Creates evaluation of a generator.", + "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/generators/{generatorsId}/evaluations", + "httpMethod": "POST", + "id": "dialogflow.projects.locations.generators.evaluations.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The generator resource name. Format: `projects//locations//generators/`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/generators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta1/{+parent}/evaluations", + "request": { + "$ref": "GoogleCloudDialogflowV2beta1GeneratorEvaluation" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/dialogflow" + ] + }, + "delete": { + "description": "Deletes an evaluation of generator.", + "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/generators/{generatorsId}/evaluations/{evaluationsId}", + "httpMethod": "DELETE", + "id": "dialogflow.projects.locations.generators.evaluations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The generator evaluation resource name. Format: `projects//locations//generators// evaluations/`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/generators/[^/]+/evaluations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta1/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/dialogflow" + ] + }, + "get": { + "description": "Gets an evaluation of generator.", + "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/generators/{generatorsId}/evaluations/{evaluationsId}", + "httpMethod": "GET", + "id": "dialogflow.projects.locations.generators.evaluations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The generator evaluation resource name. Format: `projects//locations//generators//evaluations/`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/generators/[^/]+/evaluations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta1/{+name}", + "response": { + "$ref": "GoogleCloudDialogflowV2beta1GeneratorEvaluation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/dialogflow" + ] + }, + "list": { + "description": "Lists evaluations of generator.", + "flatPath": "v2beta1/projects/{projectsId}/locations/{locationsId}/generators/{generatorsId}/evaluations", + "httpMethod": "GET", + "id": "dialogflow.projects.locations.generators.evaluations.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Maximum number of evaluations to return in a single page. By default 100 and at most 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The next_page_token value returned from a previous list request.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The generator resource name. Format: `projects//locations//generators/` Wildcard value `-` is supported on generator_id to list evaluations across all generators under same project.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/generators/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2beta1/{+parent}/evaluations", + "response": { + "$ref": "GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/dialogflow" + ] + } + } + } } }, "knowledgeBases": { @@ -8602,7 +8726,7 @@ } } }, - "revision": "20250828", + "revision": "20250919", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -17966,6 +18090,23 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2beta1EvaluationStatus": { + "description": "A common evalaution pipeline status.", + "id": "GoogleCloudDialogflowV2beta1EvaluationStatus", + "properties": { + "done": { + "description": "Output only. If the value is `false`, it means the evaluation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "readOnly": true, + "type": "boolean" + }, + "pipelineStatus": { + "$ref": "GoogleRpcStatus", + "description": "Output only. The error result of the evaluation in case of failure in evaluation pipeline.", + "readOnly": true + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2beta1EventInput": { "description": "Events allow for matching intents by event name instead of the natural language input. For instance, input `` can trigger a personalized welcome response. The parameter `name` may be used by the agent in the response: `\"Hello #welcome_event.name! What can I do for you today?\"`.", "id": "GoogleCloudDialogflowV2beta1EventInput", @@ -18506,6 +18647,199 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2beta1GeneratorEvaluation": { + "description": "Represents evaluation result of a generator.", + "id": "GoogleCloudDialogflowV2beta1GeneratorEvaluation", + "properties": { + "completeTime": { + "description": "Output only. Completion time of this generator evaluation.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. Creation time of this generator evaluation.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. The display name of the generator evaluation. At most 64 bytes long.", + "type": "string" + }, + "evaluationStatus": { + "$ref": "GoogleCloudDialogflowV2beta1EvaluationStatus", + "description": "Output only. The result status of the evaluation pipeline. Provides the status information including if the evaluation is still in progress, completed or failed with certain error and user actionable message.", + "readOnly": true + }, + "generatorEvaluationConfig": { + "$ref": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfig", + "description": "Required. The configuration of the evaluation task." + }, + "initialGenerator": { + "$ref": "GoogleCloudDialogflowV2beta1Generator", + "description": "Required. The initial generator that was used when creating this evaluation. This is a copy of the generator read from storage when creating the evaluation." + }, + "name": { + "description": "Output only. Identifier. The resource name of the evaluation. Format: `projects//locations//generators// evaluations/`", + "readOnly": true, + "type": "string" + }, + "summarizationMetrics": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetrics", + "description": "Output only. Only available when the summarization generator is provided.", + "readOnly": true + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfig": { + "description": "Generator evaluation input config.", + "id": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfig", + "properties": { + "inputDataConfig": { + "$ref": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigInputDataConfig", + "description": "Required. The config/source of input data." + }, + "outputGcsBucketPath": { + "description": "Required. The output Cloud Storage bucket path to store eval files, e.g. per_summary_accuracy_score report. This path is provided by customer and files stored in it are visible to customer, no internal data should be stored in this path.", + "type": "string" + }, + "summarizationConfig": { + "$ref": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigSummarizationConfig", + "description": "Evaluation configs for summarization generator." + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigAgentAssistInputDataConfig": { + "description": "The distinctive configs for Agent Assist conversations as the conversation source.", + "id": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigAgentAssistInputDataConfig", + "properties": { + "endTime": { + "description": "Required. The end of the time range for conversations to be evaluated. Only conversations ended at or before this timestamp will be sampled.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Required. The start of the time range for conversations to be evaluated. Only conversations created at or after this timestamp will be sampled.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigDatasetInputDataConfig": { + "description": "The distinctive configs for dataset as the conversation source.", + "id": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigDatasetInputDataConfig", + "properties": { + "dataset": { + "description": "Required. The identifier of the dataset to be evaluated. Format: `projects//locations//datasets/`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigInputDataConfig": { + "description": "Input data config details", + "id": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigInputDataConfig", + "properties": { + "agentAssistInputDataConfig": { + "$ref": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigAgentAssistInputDataConfig", + "description": "The distinctive configs for Agent Assist conversations as the conversation source." + }, + "datasetInputDataConfig": { + "$ref": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigDatasetInputDataConfig", + "description": "The distinctive configs for dataset as the conversation source." + }, + "endTime": { + "deprecated": true, + "description": "Optional. The end timestamp to fetch conversation data.", + "format": "google-datetime", + "type": "string" + }, + "inputDataSourceType": { + "deprecated": true, + "description": "Required. The source type of input data.", + "enum": [ + "INPUT_DATA_SOURCE_TYPE_UNSPECIFIED", + "AGENT_ASSIST_CONVERSATIONS", + "INSIGHTS_CONVERSATIONS" + ], + "enumDescriptions": [ + "Unspecified InputDataSourceType. Should not be used.", + "Fetch data from Agent Assist storage. If this source type is chosen, input_data_config.start_time and input_data_config.end_timestamp must be provided.", + "Fetch data from Insights storage. If this source type is chosen, input_data_config.start_time and input_data_config.end_timestamp must be provided." + ], + "type": "string" + }, + "isSummaryGenerationAllowed": { + "deprecated": true, + "description": "Optional. Whether the summary generation is allowed when the pre-existing qualified summaries are insufficient to cover the sample size.", + "type": "boolean" + }, + "sampleSize": { + "description": "Optional. Desired number of conversation-summary pairs to be evaluated.", + "format": "int32", + "type": "integer" + }, + "startTime": { + "deprecated": true, + "description": "Optional. The start timestamp to fetch conversation data.", + "format": "google-datetime", + "type": "string" + }, + "summaryGenerationOption": { + "description": "Optional. Option to control whether summaries are generated during evaluation.", + "enum": [ + "SUMMARY_GENERATION_OPTION_UNSPECIFIED", + "ALWAYS_GENERATE", + "GENERATE_IF_MISSING", + "DO_NOT_GENERATE" + ], + "enumDescriptions": [ + "Default option will not be used", + "Always Generate summary for all conversations.", + "Gnerate only missing summaries.", + "Do not generate new summaries. Only use existing summaries found." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigSummarizationConfig": { + "description": "Evaluation configs for summarization generator.", + "id": "GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigSummarizationConfig", + "properties": { + "accuracyEvaluationVersion": { + "deprecated": true, + "description": "Optional. Version for summarization accuracy. This will determine the prompt and model used at backend.", + "type": "string" + }, + "completenessEvaluationVersion": { + "deprecated": true, + "description": "Optional. Version for summarization completeness. This will determine the prompt and model used at backend.", + "type": "string" + }, + "enableAccuracyEvaluation": { + "deprecated": true, + "description": "Optional. Enable accuracy evaluation.", + "type": "boolean" + }, + "enableCompletenessEvaluation": { + "deprecated": true, + "description": "Optional. Enable completeness evaluation.", + "type": "boolean" + }, + "evaluatorVersion": { + "description": "Output only. Version for summarization evaluation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2beta1GeneratorSuggestion": { "description": "Suggestion generated using a Generator.", "id": "GoogleCloudDialogflowV2beta1GeneratorSuggestion", @@ -19104,7 +19438,7 @@ ], "enumDescriptions": [ "Not specified.", - "Uncompressed 16-bit signed little-endian samples (Linear PCM). LINT: LEGACY_NAMES", + "Uncompressed 16-bit signed little-endian samples (Linear PCM).", "[`FLAC`](https://xiph.org/flac/documentation.html) (Free Lossless Audio Codec) is the recommended encoding because it is lossless (therefore recognition is not compromised) and requires only about half the bandwidth of `LINEAR16`. `FLAC` stream encoding supports 16-bit and 24-bit samples, however, not all fields in `STREAMINFO` are supported.", "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.", "Adaptive Multi-Rate Narrowband codec. `sample_rate_hertz` must be 8000.", @@ -20796,6 +21130,24 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse": { + "description": "Response of ListGeneratorEvaluations.", + "id": "GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse", + "properties": { + "generatorEvaluations": { + "description": "The list of evaluations to return.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1GeneratorEvaluation" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2beta1ListGeneratorsResponse": { "description": "Response of ListGenerators.", "id": "GoogleCloudDialogflowV2beta1ListGeneratorsResponse", @@ -21192,9 +21544,9 @@ ], "enumDescriptions": [ "Not specified.", - "Uncompressed 16-bit signed little-endian samples (Linear PCM). Audio content returned as LINEAR16 also contains a WAV header. LINT: LEGACY_NAMES", + "Uncompressed 16-bit signed little-endian samples (Linear PCM). Audio content returned as LINEAR16 also contains a WAV header.", "MP3 audio at 32kbps.", - "MP3 audio at 64kbps. LINT: LEGACY_NAMES", + "MP3 audio at 64kbps.", "Opus encoded audio wrapped in an ogg container. The result will be a file which can be played natively on Android, and in browsers (at least Chrome and Firefox). The quality of the encoding is considerably higher than MP3 while using approximately the same bitrate.", "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.", "8-bit samples that compand 13-bit audio samples using G.711 PCMU/a-law." @@ -22182,7 +22534,7 @@ ], "enumDescriptions": [ "Not specified.", - "Uncompressed 16-bit signed little-endian samples (Linear PCM). LINT: LEGACY_NAMES", + "Uncompressed 16-bit signed little-endian samples (Linear PCM).", "[`FLAC`](https://xiph.org/flac/documentation.html) (Free Lossless Audio Codec) is the recommended encoding because it is lossless (therefore recognition is not compromised) and requires only about half the bandwidth of `LINEAR16`. `FLAC` stream encoding supports 16-bit and 24-bit samples, however, not all fields in `STREAMINFO` are supported.", "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.", "Adaptive Multi-Rate Narrowband codec. `sample_rate_hertz` must be 8000.", @@ -22832,6 +23184,346 @@ }, "type": "object" }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetrics": { + "description": "Evaluation metrics for summarization generator.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetrics", + "properties": { + "conversationDetails": { + "description": "Output only. List of conversation details.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetail" + }, + "readOnly": true, + "type": "array" + }, + "overallMetrics": { + "description": "Output only. A list of aggregated(average) scores per metric section.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsOverallScoresByMetric" + }, + "readOnly": true, + "type": "array" + }, + "overallSectionTokens": { + "description": "Output only. Overall token per section. This is an aggregated(sum) result of input token of summary acorss all conversations that are selected for summarization evaluation.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken" + }, + "readOnly": true, + "type": "array" + }, + "summarizationEvaluationMergedResultsUri": { + "description": "Output only. User bucket uri for merged evaluation score and aggregation score csv.", + "readOnly": true, + "type": "string" + }, + "summarizationEvaluationResults": { + "description": "Output only. A list of evaluation results per conversation(\u0026summary), metric and section.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition": { + "description": "Decomposition details for accuracy.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition", + "properties": { + "accuracyReasoning": { + "description": "Output only. The accuracy reasoning of the breakdown point.", + "readOnly": true, + "type": "string" + }, + "isAccurate": { + "description": "Output only. Whether the breakdown point is accurate or not.", + "readOnly": true, + "type": "boolean" + }, + "point": { + "description": "Output only. The breakdown point of the summary.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceDecomposition": { + "deprecated": true, + "description": "Decomposition details for adherence.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceDecomposition", + "properties": { + "adherenceReasoning": { + "description": "Output only. The adherence reasoning of the breakdown point.", + "readOnly": true, + "type": "string" + }, + "isAdherent": { + "description": "Output only. Whether the breakdown point is adherent or not.", + "readOnly": true, + "type": "boolean" + }, + "point": { + "description": "Output only. The breakdown point of the given instructions.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceRubric": { + "description": "Rubric result of the adherence evaluation. A rubric is ued to determine if the summary adheres to all aspects of the given instructions.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceRubric", + "properties": { + "isAddressed": { + "description": "Output only. A boolean that indicates whether the rubric question is addressed or not.", + "readOnly": true, + "type": "boolean" + }, + "question": { + "description": "Output only. The question generated from instruction that used to evaluate summary.", + "readOnly": true, + "type": "string" + }, + "reasoning": { + "description": "Output only. The reasoning of the rubric question is addressed or not.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsCompletenessRubric": { + "description": "Rubric details of the completeness evaluation result.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsCompletenessRubric", + "properties": { + "isAddressed": { + "description": "Output only. A boolean that indicates whether the rubric question is addressed or not.", + "readOnly": true, + "type": "boolean" + }, + "question": { + "description": "Output only. The question generated from instruction that used to evaluate summary.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetail": { + "description": "Aggregated evaluation result on conversation level. This contains evaluation results of all the metrics and sections.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetail", + "properties": { + "messageEntries": { + "description": "Output only. Conversation transcript that used for summarization evaluation as a reference.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1MessageEntry" + }, + "readOnly": true, + "type": "array" + }, + "metricDetails": { + "description": "Output only. List of metric details.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail" + }, + "readOnly": true, + "type": "array" + }, + "sectionTokens": { + "description": "Output only. Conversation level token count per section. This is an aggregated(sum) result of input token of summary acorss all metrics for a single conversation.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken" + }, + "readOnly": true, + "type": "array" + }, + "summarySections": { + "description": "Output only. Summary sections that used for summarization evaluation as a reference.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarySuggestionSummarySection" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail": { + "description": "Aggregated result on metric level. This contains the evaluation results of all the sections.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail", + "properties": { + "metric": { + "description": "Output only. Metrics name. e.g. accuracy, adherence, completeness.", + "readOnly": true, + "type": "string" + }, + "score": { + "description": "Output only. Aggregated(average) score on this metric across all sections.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "sectionDetails": { + "description": "Output only. List of section details.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail": { + "description": "Section level result.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail", + "properties": { + "evaluationResults": { + "description": "Output only. List of evaluation result. The list only contains one kind of the evaluation result.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult" + }, + "readOnly": true, + "type": "array" + }, + "score": { + "description": "Output only. Aggregated(average) score on this section across all evaluation results. Either decompositions or rubrics.", + "format": "float", + "readOnly": true, + "type": "number" + }, + "section": { + "description": "Output only. The name of the summary instruction.", + "readOnly": true, + "type": "string" + }, + "sectionSummary": { + "description": "Output only. Summary for this section", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsDecomposition": { + "deprecated": true, + "description": "Decomposition details", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsDecomposition", + "properties": { + "accuracyDecomposition": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition", + "description": "only available for accuracy metric." + }, + "adherenceDecomposition": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceDecomposition", + "description": "only available for adherence metric." + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult": { + "description": "Evaluation result that contains one of accuracy, adherence or completeness evaluation result.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult", + "properties": { + "accuracyDecomposition": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition", + "description": "Only available for accuracy metric." + }, + "adherenceRubric": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceRubric", + "description": "Only available for adherence metric." + }, + "completenessRubric": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsCompletenessRubric", + "description": "Only available for completeness metric." + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsOverallScoresByMetric": { + "description": "Overall performance per metric. This is the aggregated score for each metric across all conversations that are selected for summarization evaluation.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsOverallScoresByMetric", + "properties": { + "metric": { + "description": "Output only. Metric name. e.g. accuracy, adherence, completeness.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken": { + "description": "A pair of section name and input token count of the input summary section.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken", + "properties": { + "section": { + "description": "Output only. The name of the summary instruction.", + "readOnly": true, + "type": "string" + }, + "tokenCount": { + "description": "Output only. Token count.", + "format": "int64", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult": { + "description": "Evaluation result per conversation(\u0026summary), metric and section.", + "id": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult", + "properties": { + "decompositions": { + "deprecated": true, + "description": "Output only. List of decompostion details", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsDecomposition" + }, + "readOnly": true, + "type": "array" + }, + "evaluationResults": { + "description": "Output only. List of evaluation results.", + "items": { + "$ref": "GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult" + }, + "readOnly": true, + "type": "array" + }, + "metric": { + "description": "Output only. metric name, e.g. accuracy, completeness, adherence, etc.", + "readOnly": true, + "type": "string" + }, + "score": { + "description": "Output only. score calculated from decompositions", + "format": "float", + "readOnly": true, + "type": "number" + }, + "section": { + "description": "Output only. section/task name, e.g. action, situation, etc", + "readOnly": true, + "type": "string" + }, + "sectionSummary": { + "description": "Output only. Summary of this section", + "readOnly": true, + "type": "string" + }, + "sessionId": { + "deprecated": true, + "description": "Output only. conversation session id", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDialogflowV2beta1SummarizationSection": { "description": "Represents the section of summarization.", "id": "GoogleCloudDialogflowV2beta1SummarizationSection", @@ -23046,9 +23738,9 @@ ], "enumDescriptions": [ "Not specified.", - "Uncompressed 16-bit signed little-endian samples (Linear PCM). Audio content returned as LINEAR16 also contains a WAV header. LINT: LEGACY_NAMES", + "Uncompressed 16-bit signed little-endian samples (Linear PCM). Audio content returned as LINEAR16 also contains a WAV header.", "MP3 audio at 32kbps.", - "MP3 audio at 64kbps. LINT: LEGACY_NAMES", + "MP3 audio at 64kbps.", "Opus encoded audio wrapped in an ogg container. The result will be a file which can be played natively on Android, and in browsers (at least Chrome and Firefox). The quality of the encoding is considerably higher than MP3 while using approximately the same bitrate.", "8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.", "8-bit samples that compand 13-bit audio samples using G.711 PCMU/a-law." diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 08b67c6b145..100d354dd43 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -794,11 +794,23 @@ type ProjectsLocationsEncryptionSpecService struct { func NewProjectsLocationsGeneratorsService(s *Service) *ProjectsLocationsGeneratorsService { rs := &ProjectsLocationsGeneratorsService{s: s} + rs.Evaluations = NewProjectsLocationsGeneratorsEvaluationsService(s) return rs } type ProjectsLocationsGeneratorsService struct { s *Service + + Evaluations *ProjectsLocationsGeneratorsEvaluationsService +} + +func NewProjectsLocationsGeneratorsEvaluationsService(s *Service) *ProjectsLocationsGeneratorsEvaluationsService { + rs := &ProjectsLocationsGeneratorsEvaluationsService{s: s} + return rs +} + +type ProjectsLocationsGeneratorsEvaluationsService struct { + s *Service } func NewProjectsLocationsKnowledgeBasesService(s *Service) *ProjectsLocationsKnowledgeBasesService { @@ -13775,6 +13787,34 @@ func (s GoogleCloudDialogflowV2beta1EnvironmentHistoryEntry) MarshalJSON() ([]by return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2beta1EvaluationStatus: A common evalaution pipeline +// status. +type GoogleCloudDialogflowV2beta1EvaluationStatus struct { + // Done: Output only. If the value is `false`, it means the evaluation is still + // in progress. If `true`, the operation is completed, and either `error` or + // `response` is available. + Done bool `json:"done,omitempty"` + // PipelineStatus: Output only. The error result of the evaluation in case of + // failure in evaluation pipeline. + PipelineStatus *GoogleRpcStatus `json:"pipelineStatus,omitempty"` + // 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 GoogleCloudDialogflowV2beta1EvaluationStatus) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1EvaluationStatus + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowV2beta1EventInput: Events allow for matching intents by // event name instead of the natural language input. For instance, input “ can // trigger a personalized welcome response. The parameter `name` may be used by @@ -14585,6 +14625,232 @@ func (s GoogleCloudDialogflowV2beta1Generator) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2beta1GeneratorEvaluation: Represents evaluation +// result of a generator. +type GoogleCloudDialogflowV2beta1GeneratorEvaluation struct { + // CompleteTime: Output only. Completion time of this generator evaluation. + CompleteTime string `json:"completeTime,omitempty"` + // CreateTime: Output only. Creation time of this generator evaluation. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Optional. The display name of the generator evaluation. At most + // 64 bytes long. + DisplayName string `json:"displayName,omitempty"` + // EvaluationStatus: Output only. The result status of the evaluation pipeline. + // Provides the status information including if the evaluation is still in + // progress, completed or failed with certain error and user actionable + // message. + EvaluationStatus *GoogleCloudDialogflowV2beta1EvaluationStatus `json:"evaluationStatus,omitempty"` + // GeneratorEvaluationConfig: Required. The configuration of the evaluation + // task. + GeneratorEvaluationConfig *GoogleCloudDialogflowV2beta1GeneratorEvaluationConfig `json:"generatorEvaluationConfig,omitempty"` + // InitialGenerator: Required. The initial generator that was used when + // creating this evaluation. This is a copy of the generator read from storage + // when creating the evaluation. + InitialGenerator *GoogleCloudDialogflowV2beta1Generator `json:"initialGenerator,omitempty"` + // Name: Output only. Identifier. The resource name of the evaluation. Format: + // `projects//locations//generators// evaluations/` + Name string `json:"name,omitempty"` + // SummarizationMetrics: Output only. Only available when the summarization + // generator is provided. + SummarizationMetrics *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetrics `json:"summarizationMetrics,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "CompleteTime") 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. "CompleteTime") 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 GoogleCloudDialogflowV2beta1GeneratorEvaluation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1GeneratorEvaluation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1GeneratorEvaluationConfig: Generator evaluation +// input config. +type GoogleCloudDialogflowV2beta1GeneratorEvaluationConfig struct { + // InputDataConfig: Required. The config/source of input data. + InputDataConfig *GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigInputDataConfig `json:"inputDataConfig,omitempty"` + // OutputGcsBucketPath: Required. The output Cloud Storage bucket path to store + // eval files, e.g. per_summary_accuracy_score report. This path is provided by + // customer and files stored in it are visible to customer, no internal data + // should be stored in this path. + OutputGcsBucketPath string `json:"outputGcsBucketPath,omitempty"` + // SummarizationConfig: Evaluation configs for summarization generator. + SummarizationConfig *GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigSummarizationConfig `json:"summarizationConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "InputDataConfig") 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. "InputDataConfig") 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 GoogleCloudDialogflowV2beta1GeneratorEvaluationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1GeneratorEvaluationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigAgentAssistInputDataConf +// ig: The distinctive configs for Agent Assist conversations as the +// conversation source. +type GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigAgentAssistInputDataConfig struct { + // EndTime: Required. The end of the time range for conversations to be + // evaluated. Only conversations ended at or before this timestamp will be + // sampled. + EndTime string `json:"endTime,omitempty"` + // StartTime: Required. The start of the time range for conversations to be + // evaluated. Only conversations created at or after this timestamp will be + // sampled. + 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 GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigAgentAssistInputDataConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigAgentAssistInputDataConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigDatasetInputDataConfig: +// The distinctive configs for dataset as the conversation source. +type GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigDatasetInputDataConfig struct { + // Dataset: Required. The identifier of the dataset to be evaluated. Format: + // `projects//locations//datasets/`. + 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 + // 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. "Dataset") 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 GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigDatasetInputDataConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigDatasetInputDataConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigInputDataConfig: Input +// data config details +type GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigInputDataConfig struct { + // AgentAssistInputDataConfig: The distinctive configs for Agent Assist + // conversations as the conversation source. + AgentAssistInputDataConfig *GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigAgentAssistInputDataConfig `json:"agentAssistInputDataConfig,omitempty"` + // DatasetInputDataConfig: The distinctive configs for dataset as the + // conversation source. + DatasetInputDataConfig *GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigDatasetInputDataConfig `json:"datasetInputDataConfig,omitempty"` + // EndTime: Optional. The end timestamp to fetch conversation data. + EndTime string `json:"endTime,omitempty"` + // InputDataSourceType: Required. The source type of input data. + // + // Possible values: + // "INPUT_DATA_SOURCE_TYPE_UNSPECIFIED" - Unspecified InputDataSourceType. + // Should not be used. + // "AGENT_ASSIST_CONVERSATIONS" - Fetch data from Agent Assist storage. If + // this source type is chosen, input_data_config.start_time and + // input_data_config.end_timestamp must be provided. + // "INSIGHTS_CONVERSATIONS" - Fetch data from Insights storage. If this + // source type is chosen, input_data_config.start_time and + // input_data_config.end_timestamp must be provided. + InputDataSourceType string `json:"inputDataSourceType,omitempty"` + // IsSummaryGenerationAllowed: Optional. Whether the summary generation is + // allowed when the pre-existing qualified summaries are insufficient to cover + // the sample size. + IsSummaryGenerationAllowed bool `json:"isSummaryGenerationAllowed,omitempty"` + // SampleSize: Optional. Desired number of conversation-summary pairs to be + // evaluated. + SampleSize int64 `json:"sampleSize,omitempty"` + // StartTime: Optional. The start timestamp to fetch conversation data. + StartTime string `json:"startTime,omitempty"` + // SummaryGenerationOption: Optional. Option to control whether summaries are + // generated during evaluation. + // + // Possible values: + // "SUMMARY_GENERATION_OPTION_UNSPECIFIED" - Default option will not be used + // "ALWAYS_GENERATE" - Always Generate summary for all conversations. + // "GENERATE_IF_MISSING" - Gnerate only missing summaries. + // "DO_NOT_GENERATE" - Do not generate new summaries. Only use existing + // summaries found. + SummaryGenerationOption string `json:"summaryGenerationOption,omitempty"` + // ForceSendFields is a list of field names (e.g. "AgentAssistInputDataConfig") + // 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. "AgentAssistInputDataConfig") 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 GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigInputDataConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigInputDataConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigSummarizationConfig: +// Evaluation configs for summarization generator. +type GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigSummarizationConfig struct { + // AccuracyEvaluationVersion: Optional. Version for summarization accuracy. + // This will determine the prompt and model used at backend. + AccuracyEvaluationVersion string `json:"accuracyEvaluationVersion,omitempty"` + // CompletenessEvaluationVersion: Optional. Version for summarization + // completeness. This will determine the prompt and model used at backend. + CompletenessEvaluationVersion string `json:"completenessEvaluationVersion,omitempty"` + // EnableAccuracyEvaluation: Optional. Enable accuracy evaluation. + EnableAccuracyEvaluation bool `json:"enableAccuracyEvaluation,omitempty"` + // EnableCompletenessEvaluation: Optional. Enable completeness evaluation. + EnableCompletenessEvaluation bool `json:"enableCompletenessEvaluation,omitempty"` + // EvaluatorVersion: Output only. Version for summarization evaluation. + EvaluatorVersion string `json:"evaluatorVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccuracyEvaluationVersion") + // 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. "AccuracyEvaluationVersion") 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 GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigSummarizationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1GeneratorEvaluationConfigSummarizationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowV2beta1GeneratorSuggestion: Suggestion generated using // a Generator. type GoogleCloudDialogflowV2beta1GeneratorSuggestion struct { @@ -15569,7 +15835,7 @@ type GoogleCloudDialogflowV2beta1InputAudioConfig struct { // Possible values: // "AUDIO_ENCODING_UNSPECIFIED" - Not specified. // "AUDIO_ENCODING_LINEAR_16" - Uncompressed 16-bit signed little-endian - // samples (Linear PCM). LINT: LEGACY_NAMES + // samples (Linear PCM). // "AUDIO_ENCODING_FLAC" - [`FLAC`](https://xiph.org/flac/documentation.html) // (Free Lossless Audio Codec) is the recommended encoding because it is // lossless (therefore recognition is not compromised) and requires only about @@ -17875,6 +18141,35 @@ func (s GoogleCloudDialogflowV2beta1ListEnvironmentsResponse) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse: Response of +// ListGeneratorEvaluations. +type GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse struct { + // GeneratorEvaluations: The list of evaluations to return. + GeneratorEvaluations []*GoogleCloudDialogflowV2beta1GeneratorEvaluation `json:"generatorEvaluations,omitempty"` + // NextPageToken: Token to retrieve the next page of results, or empty if there + // are no more results in the list. + 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. "GeneratorEvaluations") 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. "GeneratorEvaluations") 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 GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDialogflowV2beta1ListGeneratorsResponse: Response of // ListGenerators. type GoogleCloudDialogflowV2beta1ListGeneratorsResponse struct { @@ -18433,10 +18728,9 @@ type GoogleCloudDialogflowV2beta1OutputAudioConfig struct { // "OUTPUT_AUDIO_ENCODING_UNSPECIFIED" - Not specified. // "OUTPUT_AUDIO_ENCODING_LINEAR_16" - Uncompressed 16-bit signed // little-endian samples (Linear PCM). Audio content returned as LINEAR16 also - // contains a WAV header. LINT: LEGACY_NAMES + // contains a WAV header. // "OUTPUT_AUDIO_ENCODING_MP3" - MP3 audio at 32kbps. - // "OUTPUT_AUDIO_ENCODING_MP3_64_KBPS" - MP3 audio at 64kbps. LINT: - // LEGACY_NAMES + // "OUTPUT_AUDIO_ENCODING_MP3_64_KBPS" - MP3 audio at 64kbps. // "OUTPUT_AUDIO_ENCODING_OGG_OPUS" - Opus encoded audio wrapped in an ogg // container. The result will be a file which can be played natively on // Android, and in browsers (at least Chrome and Firefox). The quality of the @@ -19894,7 +20188,7 @@ type GoogleCloudDialogflowV2beta1SpeechToTextConfig struct { // Possible values: // "AUDIO_ENCODING_UNSPECIFIED" - Not specified. // "AUDIO_ENCODING_LINEAR_16" - Uncompressed 16-bit signed little-endian - // samples (Linear PCM). LINT: LEGACY_NAMES + // samples (Linear PCM). // "AUDIO_ENCODING_FLAC" - [`FLAC`](https://xiph.org/flac/documentation.html) // (Free Lossless Audio Codec) is the recommended encoding because it is // lossless (therefore recognition is not compromised) and requires only about @@ -20884,6 +21178,435 @@ func (s GoogleCloudDialogflowV2beta1SummarizationContext) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetrics: Evaluation +// metrics for summarization generator. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetrics struct { + // ConversationDetails: Output only. List of conversation details. + ConversationDetails []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetail `json:"conversationDetails,omitempty"` + // OverallMetrics: Output only. A list of aggregated(average) scores per metric + // section. + OverallMetrics []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsOverallScoresByMetric `json:"overallMetrics,omitempty"` + // OverallSectionTokens: Output only. Overall token per section. This is an + // aggregated(sum) result of input token of summary acorss all conversations + // that are selected for summarization evaluation. + OverallSectionTokens []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken `json:"overallSectionTokens,omitempty"` + // SummarizationEvaluationMergedResultsUri: Output only. User bucket uri for + // merged evaluation score and aggregation score csv. + SummarizationEvaluationMergedResultsUri string `json:"summarizationEvaluationMergedResultsUri,omitempty"` + // SummarizationEvaluationResults: Output only. A list of evaluation results + // per conversation(&summary), metric and section. + SummarizationEvaluationResults []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult `json:"summarizationEvaluationResults,omitempty"` + // ForceSendFields is a list of field names (e.g. "ConversationDetails") 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. "ConversationDetails") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetrics) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetrics + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecompositi +// on: Decomposition details for accuracy. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition struct { + // AccuracyReasoning: Output only. The accuracy reasoning of the breakdown + // point. + AccuracyReasoning string `json:"accuracyReasoning,omitempty"` + // IsAccurate: Output only. Whether the breakdown point is accurate or not. + IsAccurate bool `json:"isAccurate,omitempty"` + // Point: Output only. The breakdown point of the summary. + Point string `json:"point,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccuracyReasoning") 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. "AccuracyReasoning") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceDecomposit +// ion: Decomposition details for adherence. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceDecomposition struct { + // AdherenceReasoning: Output only. The adherence reasoning of the breakdown + // point. + AdherenceReasoning string `json:"adherenceReasoning,omitempty"` + // IsAdherent: Output only. Whether the breakdown point is adherent or not. + IsAdherent bool `json:"isAdherent,omitempty"` + // Point: Output only. The breakdown point of the given instructions. + Point string `json:"point,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdherenceReasoning") 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. "AdherenceReasoning") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceDecomposition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceDecomposition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceRubric: +// Rubric result of the adherence evaluation. A rubric is ued to determine if +// the summary adheres to all aspects of the given instructions. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceRubric struct { + // IsAddressed: Output only. A boolean that indicates whether the rubric + // question is addressed or not. + IsAddressed bool `json:"isAddressed,omitempty"` + // Question: Output only. The question generated from instruction that used to + // evaluate summary. + Question string `json:"question,omitempty"` + // Reasoning: Output only. The reasoning of the rubric question is addressed or + // not. + Reasoning string `json:"reasoning,omitempty"` + // ForceSendFields is a list of field names (e.g. "IsAddressed") 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. "IsAddressed") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceRubric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceRubric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsCompletenessRubric: +// +// Rubric details of the completeness evaluation result. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsCompletenessRubric struct { + // IsAddressed: Output only. A boolean that indicates whether the rubric + // question is addressed or not. + IsAddressed bool `json:"isAddressed,omitempty"` + // Question: Output only. The question generated from instruction that used to + // evaluate summary. + Question string `json:"question,omitempty"` + // ForceSendFields is a list of field names (e.g. "IsAddressed") 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. "IsAddressed") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsCompletenessRubric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsCompletenessRubric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetail: +// +// Aggregated evaluation result on conversation level. This contains +// +// evaluation results of all the metrics and sections. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetail struct { + // MessageEntries: Output only. Conversation transcript that used for + // summarization evaluation as a reference. + MessageEntries []*GoogleCloudDialogflowV2beta1MessageEntry `json:"messageEntries,omitempty"` + // MetricDetails: Output only. List of metric details. + MetricDetails []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail `json:"metricDetails,omitempty"` + // SectionTokens: Output only. Conversation level token count per section. This + // is an aggregated(sum) result of input token of summary acorss all metrics + // for a single conversation. + SectionTokens []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken `json:"sectionTokens,omitempty"` + // SummarySections: Output only. Summary sections that used for summarization + // evaluation as a reference. + SummarySections []*GoogleCloudDialogflowV2beta1SummarySuggestionSummarySection `json:"summarySections,omitempty"` + // ForceSendFields is a list of field names (e.g. "MessageEntries") 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. "MessageEntries") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetail) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailM +// etricDetail: Aggregated result on metric level. This contains the evaluation +// results of all the sections. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail struct { + // Metric: Output only. Metrics name. e.g. accuracy, adherence, completeness. + Metric string `json:"metric,omitempty"` + // Score: Output only. Aggregated(average) score on this metric across all + // sections. + Score float64 `json:"score,omitempty"` + // SectionDetails: Output only. List of section details. + SectionDetails []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail `json:"sectionDetails,omitempty"` + // ForceSendFields is a list of field names (e.g. "Metric") 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. "Metric") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetail + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailM +// etricDetailSectionDetail: Section level result. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail struct { + // EvaluationResults: Output only. List of evaluation result. The list only + // contains one kind of the evaluation result. + EvaluationResults []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult `json:"evaluationResults,omitempty"` + // Score: Output only. Aggregated(average) score on this section across all + // evaluation results. Either decompositions or rubrics. + Score float64 `json:"score,omitempty"` + // Section: Output only. The name of the summary instruction. + Section string `json:"section,omitempty"` + // SectionSummary: Output only. Summary for this section + SectionSummary string `json:"sectionSummary,omitempty"` + // ForceSendFields is a list of field names (e.g. "EvaluationResults") 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. "EvaluationResults") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsConversationDetailMetricDetailSectionDetail + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsDecomposition: +// Decomposition details +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsDecomposition struct { + // AccuracyDecomposition: only available for accuracy metric. + AccuracyDecomposition *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition `json:"accuracyDecomposition,omitempty"` + // AdherenceDecomposition: only available for adherence metric. + AdherenceDecomposition *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceDecomposition `json:"adherenceDecomposition,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccuracyDecomposition") 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. "AccuracyDecomposition") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsDecomposition) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsDecomposition + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult: +// Evaluation result that contains one of accuracy, adherence or completeness +// evaluation result. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult struct { + // AccuracyDecomposition: Only available for accuracy metric. + AccuracyDecomposition *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAccuracyDecomposition `json:"accuracyDecomposition,omitempty"` + // AdherenceRubric: Only available for adherence metric. + AdherenceRubric *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsAdherenceRubric `json:"adherenceRubric,omitempty"` + // CompletenessRubric: Only available for completeness metric. + CompletenessRubric *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsCompletenessRubric `json:"completenessRubric,omitempty"` + // ForceSendFields is a list of field names (e.g. "AccuracyDecomposition") 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. "AccuracyDecomposition") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsOverallScoresByMetr +// ic: Overall performance per metric. This is the aggregated score for each +// metric across all conversations that are selected for summarization +// evaluation. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsOverallScoresByMetric struct { + // Metric: Output only. Metric name. e.g. accuracy, adherence, completeness. + Metric string `json:"metric,omitempty"` + // ForceSendFields is a list of field names (e.g. "Metric") 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. "Metric") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsOverallScoresByMetric) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsOverallScoresByMetric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken: A +// pair of section name and input token count of the input summary section. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken struct { + // Section: Output only. The name of the summary instruction. + Section string `json:"section,omitempty"` + // TokenCount: Output only. Token count. + TokenCount int64 `json:"tokenCount,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "Section") 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. "Section") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSectionToken + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvalua +// tionResult: Evaluation result per conversation(&summary), metric and +// section. +type GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult struct { + // Decompositions: Output only. List of decompostion details + Decompositions []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsDecomposition `json:"decompositions,omitempty"` + // EvaluationResults: Output only. List of evaluation results. + EvaluationResults []*GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsEvaluationResult `json:"evaluationResults,omitempty"` + // Metric: Output only. metric name, e.g. accuracy, completeness, adherence, + // etc. + Metric string `json:"metric,omitempty"` + // Score: Output only. score calculated from decompositions + Score float64 `json:"score,omitempty"` + // Section: Output only. section/task name, e.g. action, situation, etc + Section string `json:"section,omitempty"` + // SectionSummary: Output only. Summary of this section + SectionSummary string `json:"sectionSummary,omitempty"` + // SessionId: Output only. conversation session id + SessionId string `json:"sessionId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Decompositions") 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. "Decompositions") 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 GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudDialogflowV2beta1SummarizationEvaluationMetricsSummarizationEvaluationResult + var s1 struct { + Score gensupport.JSONFloat64 `json:"score"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Score = float64(s1.Score) + return nil +} + // GoogleCloudDialogflowV2beta1SummarizationSection: Represents the section of // summarization. type GoogleCloudDialogflowV2beta1SummarizationSection struct { @@ -21159,10 +21882,9 @@ type GoogleCloudDialogflowV2beta1TextToSpeechSettings struct { // "OUTPUT_AUDIO_ENCODING_UNSPECIFIED" - Not specified. // "OUTPUT_AUDIO_ENCODING_LINEAR_16" - Uncompressed 16-bit signed // little-endian samples (Linear PCM). Audio content returned as LINEAR16 also - // contains a WAV header. LINT: LEGACY_NAMES + // contains a WAV header. // "OUTPUT_AUDIO_ENCODING_MP3" - MP3 audio at 32kbps. - // "OUTPUT_AUDIO_ENCODING_MP3_64_KBPS" - MP3 audio at 64kbps. LINT: - // LEGACY_NAMES + // "OUTPUT_AUDIO_ENCODING_MP3_64_KBPS" - MP3 audio at 64kbps. // "OUTPUT_AUDIO_ENCODING_OGG_OPUS" - Opus encoded audio wrapped in an ogg // container. The result will be a file which can be played natively on // Android, and in browsers (at least Chrome and Firefox). The quality of the @@ -36804,9 +37526,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c @@ -48647,6 +49369,468 @@ func (c *ProjectsLocationsGeneratorsPatchCall) Do(opts ...googleapi.CallOption) return ret, nil } +type ProjectsLocationsGeneratorsEvaluationsCreateCall struct { + s *Service + parent string + googleclouddialogflowv2beta1generatorevaluation *GoogleCloudDialogflowV2beta1GeneratorEvaluation + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates evaluation of a generator. +// +// - parent: The generator resource name. Format: +// `projects//locations//generators/`. +func (r *ProjectsLocationsGeneratorsEvaluationsService) Create(parent string, googleclouddialogflowv2beta1generatorevaluation *GoogleCloudDialogflowV2beta1GeneratorEvaluation) *ProjectsLocationsGeneratorsEvaluationsCreateCall { + c := &ProjectsLocationsGeneratorsEvaluationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddialogflowv2beta1generatorevaluation = googleclouddialogflowv2beta1generatorevaluation + 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 *ProjectsLocationsGeneratorsEvaluationsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsGeneratorsEvaluationsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGeneratorsEvaluationsCreateCall) Context(ctx context.Context) *ProjectsLocationsGeneratorsEvaluationsCreateCall { + 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 *ProjectsLocationsGeneratorsEvaluationsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGeneratorsEvaluationsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddialogflowv2beta1generatorevaluation) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta1/{+parent}/evaluations") + 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", "dialogflow.projects.locations.generators.evaluations.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dialogflow.projects.locations.generators.evaluations.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 *ProjectsLocationsGeneratorsEvaluationsCreateCall) 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", "dialogflow.projects.locations.generators.evaluations.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGeneratorsEvaluationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an evaluation of generator. +// +// - name: The generator evaluation resource name. Format: +// `projects//locations//generators// evaluations/`. +func (r *ProjectsLocationsGeneratorsEvaluationsService) Delete(name string) *ProjectsLocationsGeneratorsEvaluationsDeleteCall { + c := &ProjectsLocationsGeneratorsEvaluationsDeleteCall{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 *ProjectsLocationsGeneratorsEvaluationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsGeneratorsEvaluationsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGeneratorsEvaluationsDeleteCall) Context(ctx context.Context) *ProjectsLocationsGeneratorsEvaluationsDeleteCall { + 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 *ProjectsLocationsGeneratorsEvaluationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGeneratorsEvaluationsDeleteCall) 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, "v2beta1/{+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", "dialogflow.projects.locations.generators.evaluations.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dialogflow.projects.locations.generators.evaluations.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 *ProjectsLocationsGeneratorsEvaluationsDeleteCall) 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", "dialogflow.projects.locations.generators.evaluations.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGeneratorsEvaluationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets an evaluation of generator. +// +// - name: The generator evaluation resource name. Format: +// `projects//locations//generators//evaluations/`. +func (r *ProjectsLocationsGeneratorsEvaluationsService) Get(name string) *ProjectsLocationsGeneratorsEvaluationsGetCall { + c := &ProjectsLocationsGeneratorsEvaluationsGetCall{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 *ProjectsLocationsGeneratorsEvaluationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGeneratorsEvaluationsGetCall { + 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 *ProjectsLocationsGeneratorsEvaluationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGeneratorsEvaluationsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGeneratorsEvaluationsGetCall) Context(ctx context.Context) *ProjectsLocationsGeneratorsEvaluationsGetCall { + 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 *ProjectsLocationsGeneratorsEvaluationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGeneratorsEvaluationsGetCall) 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, "v2beta1/{+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", "dialogflow.projects.locations.generators.evaluations.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dialogflow.projects.locations.generators.evaluations.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDialogflowV2beta1GeneratorEvaluation.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 *ProjectsLocationsGeneratorsEvaluationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDialogflowV2beta1GeneratorEvaluation, 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 := &GoogleCloudDialogflowV2beta1GeneratorEvaluation{ + 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", "dialogflow.projects.locations.generators.evaluations.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGeneratorsEvaluationsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists evaluations of generator. +// +// - parent: The generator resource name. Format: +// `projects//locations//generators/` Wildcard value `-` is supported on +// generator_id to list evaluations across all generators under same project. +func (r *ProjectsLocationsGeneratorsEvaluationsService) List(parent string) *ProjectsLocationsGeneratorsEvaluationsListCall { + c := &ProjectsLocationsGeneratorsEvaluationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// evaluations to return in a single page. By default 100 and at most 1000. +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) PageSize(pageSize int64) *ProjectsLocationsGeneratorsEvaluationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The next_page_token value +// returned from a previous list request. +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) PageToken(pageToken string) *ProjectsLocationsGeneratorsEvaluationsListCall { + 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 *ProjectsLocationsGeneratorsEvaluationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGeneratorsEvaluationsListCall { + 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 *ProjectsLocationsGeneratorsEvaluationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGeneratorsEvaluationsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) Context(ctx context.Context) *ProjectsLocationsGeneratorsEvaluationsListCall { + 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 *ProjectsLocationsGeneratorsEvaluationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGeneratorsEvaluationsListCall) 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, "v2beta1/{+parent}/evaluations") + 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", "dialogflow.projects.locations.generators.evaluations.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "dialogflow.projects.locations.generators.evaluations.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse.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 *ProjectsLocationsGeneratorsEvaluationsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse, 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 := &GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse{ + 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", "dialogflow.projects.locations.generators.evaluations.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 *ProjectsLocationsGeneratorsEvaluationsListCall) Pages(ctx context.Context, f func(*GoogleCloudDialogflowV2beta1ListGeneratorEvaluationsResponse) 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 ProjectsLocationsKnowledgeBasesCreateCall struct { s *Service parent string diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index dcfd224a361..9c57cdbeb50 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -148,7 +148,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -5309,7 +5309,7 @@ } } }, - "revision": "20250902", + "revision": "20250919", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3Action": { diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 29f7e0aa5d4..19e0e97d4d8 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -22124,9 +22124,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index abc964b6b44..80aa196d306 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -148,7 +148,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -5436,7 +5436,7 @@ } } }, - "revision": "20250828", + "revision": "20250919", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index ea88b6344c2..c16ad32f0a4 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -23389,9 +23389,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/discoveryengine/v1/discoveryengine-api.json b/discoveryengine/v1/discoveryengine-api.json index 753d16ef069..bc0d5028349 100644 --- a/discoveryengine/v1/discoveryengine-api.json +++ b/discoveryengine/v1/discoveryengine-api.json @@ -260,6 +260,72 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "setUpDataConnector": { + "description": "Creates a Collection and sets up the DataConnector for it. To stop a DataConnector after setup, use the CollectionService.DeleteCollection method.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:setUpDataConnector", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.setUpDataConnector", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent of Collection, in the format of `projects/{project}/locations/{location}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}:setUpDataConnector", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setUpDataConnectorV2": { + "description": "Creates a Collection and sets up the DataConnector for it. To stop a DataConnector after setup, use the CollectionService.DeleteCollection method.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:setUpDataConnectorV2", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.setUpDataConnectorV2", + "parameterOrder": [ + "parent" + ], + "parameters": { + "collectionDisplayName": { + "description": "Required. The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.", + "location": "query", + "type": "string" + }, + "collectionId": { + "description": "Required. The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of Collection, in the format of `projects/{project}/locations/{location}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}:setUpDataConnectorV2", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnector" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "updateAclConfig": { "description": "Default ACL configuration for use in a location of a customer's project. Updates will only reflect to new data stores. Existing data stores will still use the old value.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aclConfig", @@ -436,6 +502,92 @@ } }, "collections": { + "methods": { + "delete": { + "description": "Deletes a Collection.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}", + "httpMethod": "DELETE", + "id": "discoveryengine.projects.locations.collections.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The full resource name of the Collection, in the format of `projects/{project}/locations/{location}/collections/{collection}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getDataConnector": { + "description": "Gets the DataConnector. DataConnector is a singleton resource for each Collection.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataConnector", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.getDataConnector", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full resource name of DataConnector, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataConnector`. If the caller does not have permission to access the DataConnector, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. If the requested DataConnector does not exist, a NOT_FOUND error is returned.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataConnector$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnector" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "updateDataConnector": { + "description": "Updates a DataConnector.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataConnector", + "httpMethod": "PATCH", + "id": "discoveryengine.projects.locations.collections.updateDataConnector", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. The full resource name of the Data Connector. Format: `projects/*/locations/*/collections/*/dataConnector`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataConnector$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates which fields in the provided DataConnector to update. Supported field paths include: - refresh_interval - params - auto_run_disabled - action_config - action_config.action_params - action_config.service_name - destination_configs - blocking_reasons - sync_mode - incremental_sync_disabled - incremental_refresh_interval Note: Support for these fields may vary depending on the connector type. For example, not all connectors support `destination_configs`. If an unsupported or unknown field path is provided, the request will return an INVALID_ARGUMENT error.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnector" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnector" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, "resources": { "dataConnector": { "resources": { @@ -7344,7 +7496,7 @@ } } }, - "revision": "20250908", + "revision": "20250921", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GdataBlobstore2Info": { @@ -8205,6 +8357,38 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1ActionConfig": { + "description": "Informations to support actions on the connector.", + "id": "GoogleCloudDiscoveryengineV1ActionConfig", + "properties": { + "actionParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Action parameters in structured json format.", + "type": "object" + }, + "isActionConfigured": { + "description": "Output only. The connector contains the necessary parameters and is configured to support actions.", + "readOnly": true, + "type": "boolean" + }, + "jsonActionParams": { + "description": "Optional. Action parameters in json string format.", + "type": "string" + }, + "serviceName": { + "description": "Optional. The Service Directory resource name (projects/*/locations/*/namespaces/*/services/*) representing a VPC network endpoint used to connect to the data source's `instance_uri`, defined in DataConnector.params. Required when VPC Service Controls are enabled.", + "type": "string" + }, + "useStaticSecrets": { + "description": "Optional. Whether to use static secrets for the connector. If true, the secrets provided in the action_params will be ignored.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest": { "description": "Request message for CompletionService.AdvancedCompleteQuery method. .", "id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest", @@ -8532,6 +8716,49 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1AlertPolicyConfig": { + "description": "The connector level alert config.", + "id": "GoogleCloudDiscoveryengineV1AlertPolicyConfig", + "properties": { + "alertEnrollments": { + "description": "Optional. The enrollment states of each alert.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment" + }, + "type": "array" + }, + "alertPolicyName": { + "description": "Immutable. The fully qualified resource name of the AlertPolicy.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment": { + "description": "The alert enrollment status.", + "id": "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment", + "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" + }, "GoogleCloudDiscoveryengineV1AlloyDbSource": { "description": "AlloyDB source import data from.", "id": "GoogleCloudDiscoveryengineV1AlloyDbSource", @@ -10227,6 +10454,10 @@ "description": "Domain name from the document URI. Note that the `uri` field may contain a URL that redirects to the actual website, in which case this will contain the domain name of the target site.", "type": "string" }, + "mimeType": { + "description": "The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml.", + "type": "string" + }, "pageIdentifier": { "description": "Page identifier.", "type": "string" @@ -10305,6 +10536,39 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1BAPConfig": { + "description": "The configuration for the BAP connector.", + "id": "GoogleCloudDiscoveryengineV1BAPConfig", + "properties": { + "enabledActions": { + "description": "Optional. The actions enabled on the associated BAP connection.", + "items": { + "type": "string" + }, + "type": "array" + }, + "supportedConnectorModes": { + "description": "Required. The supported connector modes for the associated BAP connection.", + "items": { + "enum": [ + "CONNECTOR_MODE_UNSPECIFIED", + "DATA_INGESTION", + "ACTIONS", + "END_USER_AUTHENTICATION" + ], + "enumDescriptions": [ + "Connector mode unspecified.", + "Connector utilized for data ingestion.", + "Connector utilized for Actions", + "Connector utilized for End User Authentication." + ], + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata": { "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata", @@ -11107,6 +11371,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1Collection": { + "description": "Collection is a container for configuring resources and access to a set of DataStores.", + "id": "GoogleCloudDiscoveryengineV1Collection", + "properties": { + "createTime": { + "description": "Output only. Timestamp the Collection was created at.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Required. The Collection display name. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "type": "string" + }, + "name": { + "description": "Immutable. The full resource name of the Collection. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1CompleteQueryResponse": { "description": "Response message for CompletionService.CompleteQuery method.", "id": "GoogleCloudDiscoveryengineV1CompleteQueryResponse", @@ -11827,38 +12112,537 @@ }, "type": "object" }, - "GoogleCloudDiscoveryengineV1DataStore": { - "description": "DataStore captures global settings and configs at the DataStore level.", - "id": "GoogleCloudDiscoveryengineV1DataStore", + "GoogleCloudDiscoveryengineV1DataConnector": { + "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through DataConnectorService.SetUpDataConnector method, which will create a new Collection and initialize its DataConnector.", + "id": "GoogleCloudDiscoveryengineV1DataConnector", "properties": { "aclEnabled": { - "description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.", + "description": "Optional. Whether the connector will be created with an ACL config. Currently this field only affects Cloud Storage and BigQuery connectors.", "type": "boolean" }, - "advancedSiteSearchConfig": { - "$ref": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", - "description": "Optional. Configuration for advanced site search." - }, - "billingEstimation": { - "$ref": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", - "description": "Output only. Data size estimation for billing.", - "readOnly": true - }, - "cmekConfig": { - "$ref": "GoogleCloudDiscoveryengineV1CmekConfig", - "description": "Output only. CMEK-related information for the DataStore.", - "readOnly": true + "actionConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ActionConfig", + "description": "Optional. Action configurations to make the connector support actions." }, - "contentConfig": { - "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", + "actionState": { + "description": "Output only. State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors.", "enum": [ - "CONTENT_CONFIG_UNSPECIFIED", - "NO_CONTENT", - "CONTENT_REQUIRED", - "PUBLIC_WEBSITE", - "GOOGLE_WORKSPACE" - ], - "enumDescriptions": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" + ], + "enumDescriptions": [ + "Default value.", + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." + ], + "readOnly": true, + "type": "string" + }, + "alertPolicyConfigs": { + "description": "Optional. The connector level alert config.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1AlertPolicyConfig" + }, + "type": "array" + }, + "autoRunDisabled": { + "description": "Optional. Indicates whether the connector is disabled for auto run. It can be used to pause periodical and real time sync. Update: with the introduction of incremental_sync_disabled, auto_run_disabled is used to pause/disable only full syncs", + "type": "boolean" + }, + "bapConfig": { + "$ref": "GoogleCloudDiscoveryengineV1BAPConfig", + "description": "Optional. The configuration for establishing a BAP connection." + }, + "blockingReasons": { + "description": "Output only. User actions that must be completed before the connector can start syncing data.", + "items": { + "enum": [ + "BLOCKING_REASON_UNSPECIFIED", + "ALLOWLIST_STATIC_IP", + "ALLOWLIST_IN_SERVICE_ATTACHMENT", + "ALLOWLIST_SERVICE_ACCOUNT" + ], + "enumDescriptions": [ + "Default value.", + "Connector requires customer to allowlist static IPs.", + "Connector requires customer to allowlist our project in their service attachment.", + "Connector requires customer to allowlist service account in their project." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "connectorModes": { + "description": "Optional. The modes enabled for this connector. Default state is CONNECTOR_MODE_UNSPECIFIED.", + "items": { + "enum": [ + "CONNECTOR_MODE_UNSPECIFIED", + "DATA_INGESTION", + "ACTIONS", + "FEDERATED", + "EUA", + "FEDERATED_AND_EUA" + ], + "enumDescriptions": [ + "Connector mode unspecified.", + "Connector utilized for data ingestion.", + "Connector utilized for actions.", + "Connector utilized for federated search.", + "Connector utilized for End User Authentication.", + "Hybrid connector utilized for federated search and End User Authentication." + ], + "type": "string" + }, + "type": "array" + }, + "connectorType": { + "description": "Output only. The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system.", + "enum": [ + "CONNECTOR_TYPE_UNSPECIFIED", + "THIRD_PARTY", + "GCP_FHIR", + "BIG_QUERY", + "GCS", + "GOOGLE_MAIL", + "GOOGLE_CALENDAR", + "GOOGLE_DRIVE", + "NATIVE_CLOUD_IDENTITY", + "THIRD_PARTY_FEDERATED", + "THIRD_PARTY_EUA", + "GCNV" + ], + "enumDescriptions": [ + "Default value.", + "Third party connector to connector to third party application.", + "Data connector connects between FHIR store and VAIS datastore.", + "Big query connector.", + "Google Cloud Storage connector.", + "Gmail connector.", + "Google Calendar connector.", + "Google Drive connector.", + "Native Cloud Identity connector for people search powered by People API.", + "Federated connector, it is a third party connector that doesn't ingestion data, and search is powered by third party application's API.", + "Connector utilized for End User Authentication features.", + "Google Cloud NetApp Volumes connector." + ], + "readOnly": true, + "type": "string" + }, + "createEuaSaas": { + "description": "Optional. Whether the END USER AUTHENTICATION connector is created in SaaS.", + "type": "boolean" + }, + "createTime": { + "description": "Output only. Timestamp the DataConnector was created at.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "dataSource": { + "description": "Required. The name of the data source. Supported values: `salesforce`, `jira`, `confluence`, `bigquery`.", + "type": "string" + }, + "destinationConfigs": { + "description": "Optional. Any target destinations used to connect to third-party services.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DestinationConfig" + }, + "type": "array" + }, + "endUserConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig", + "description": "Optional. Any params and credentials used specifically for EUA connectors." + }, + "entities": { + "description": "List of entities from the connected data source to ingest.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity" + }, + "type": "array" + }, + "errors": { + "description": "Output only. The errors from initialization or from the latest connector run.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "readOnly": true, + "type": "array" + }, + "federatedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig", + "description": "Optional. Any params and credentials used specifically for hybrid connectors supporting FEDERATED mode. This field should only be set if the connector is a hybrid connector and we want to enable FEDERATED mode." + }, + "hybridIngestionDisabled": { + "description": "Optional. If the connector is a hybrid connector, determines whether ingestion is enabled and appropriate resources are provisioned during connector creation. If the connector is not a hybrid connector, this field is ignored.", + "type": "boolean" + }, + "identityRefreshInterval": { + "deprecated": true, + "description": "The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", + "format": "google-duration", + "type": "string" + }, + "identityScheduleConfig": { + "$ref": "GoogleCloudDiscoveryengineV1IdentityScheduleConfig", + "description": "The configuration for the identity data synchronization runs. This contains the refresh interval to sync the Access Control List information for the documents ingested by this connector." + }, + "incrementalRefreshInterval": { + "description": "Optional. The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.", + "format": "google-duration", + "type": "string" + }, + "incrementalSyncDisabled": { + "description": "Optional. Indicates whether incremental syncs are paused for this connector. This is independent of auto_run_disabled. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled, i.e. set to true.", + "type": "boolean" + }, + "jsonParams": { + "description": "Required data connector parameters in json string format.", + "type": "string" + }, + "kmsKeyName": { + "description": "Input only. The KMS key to be used to protect the DataStores managed by this connector. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStores created by this connector will be protected by the KMS key.", + "type": "string" + }, + "lastSyncTime": { + "description": "Output only. For periodic connectors only, the last time a data sync was completed.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "latestPauseTime": { + "description": "Output only. The most recent timestamp when this DataConnector was paused, affecting all functionalities such as data synchronization. Pausing a connector has the following effects: - All functionalities, including data synchronization, are halted. - Any ongoing data synchronization job will be canceled. - No future data synchronization runs will be scheduled nor can be triggered.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. The full resource name of the Data Connector. Format: `projects/*/locations/*/collections/*/dataConnector`.", + "readOnly": true, + "type": "string" + }, + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Defines the scheduled time for the next data synchronization. This field requires hour , minute, and time_zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). This is utilized when the data connector has a refresh interval greater than 1 day. When the hours or minutes are not specified, we will assume a sync time of 0:00. The user must provide a time zone to avoid ambiguity." + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Required data connector parameters in structured json format.", + "type": "object" + }, + "privateConnectivityProjectId": { + "description": "Output only. The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.", + "readOnly": true, + "type": "string" + }, + "realtimeState": { + "description": "Output only. real-time sync state", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" + ], + "enumDescriptions": [ + "Default value.", + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." + ], + "readOnly": true, + "type": "string" + }, + "realtimeSyncConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig", + "description": "Optional. The configuration for realtime sync." + }, + "refreshInterval": { + "description": "Required. The refresh interval for data sync. If duration is set to 0, the data will be synced in real time. The streaming feature is not supported yet. The minimum is 30 minutes and maximum is 7 days. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.", + "format": "google-duration", + "type": "string" + }, + "removeParamKeys": { + "description": "Optional. Specifies keys to be removed from the 'params' field. This is only active when 'params' is included in the 'update_mask' in an UpdateDataConnectorRequest. Deletion takes precedence if a key is both in 'remove_param_keys' and present in the 'params' field of the request.", + "items": { + "type": "string" + }, + "type": "array" + }, + "state": { + "description": "Output only. State of the connector.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" + ], + "enumDescriptions": [ + "Default value.", + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." + ], + "readOnly": true, + "type": "string" + }, + "staticIpAddresses": { + "description": "Output only. The static IP addresses used by this connector.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "staticIpEnabled": { + "description": "Optional. Whether customer has enabled static IP addresses for this connector.", + "type": "boolean" + }, + "syncMode": { + "description": "The data synchronization mode supported by the data connector.", + "enum": [ + "PERIODIC", + "STREAMING", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "The connector will sync data periodically based on the refresh_interval. Use it with auto_run_disabled to pause the periodic sync, or indicate a one-time sync.", + "The data will be synced in real time.", + "Connector that doesn't ingest data will have this value" + ], + "type": "string" + }, + "updateTime": { + "description": "Output only. Timestamp the DataConnector was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig": { + "description": "Any params and credentials used specifically for EUA connectors.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig", + "properties": { + "additionalParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any additional parameters needed for EUA.", + "type": "object" + }, + "authParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any authentication parameters specific to EUA connectors.", + "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to EUA connectors in json string format.", + "type": "string" + }, + "tenant": { + "$ref": "GoogleCloudDiscoveryengineV1Tenant", + "description": "Optional. The tenant project the connector is connected to." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig": { + "description": "Any params and credentials used specifically for hybrid connectors supporting FEDERATED mode.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig", + "properties": { + "additionalParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any additional parameters needed for FEDERATED.", + "type": "object" + }, + "authParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any authentication parameters specific to FEDERATED connectors.", + "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to FEDERATED connectors in json string format.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig": { + "description": "The configuration for realtime sync to store additional params for realtime sync.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig", + "properties": { + "realtimeSyncSecret": { + "description": "Optional. The ID of the Secret Manager secret used for webhook secret.", + "type": "string" + }, + "streamingError": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError", + "description": "Optional. Streaming error details." + }, + "webhookUri": { + "description": "Optional. Webhook url for the connector to specify additional params for realtime sync.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError": { + "description": "Streaming error details.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Optional. Error details." + }, + "streamingErrorReason": { + "description": "Optional. Streaming error.", + "enum": [ + "STREAMING_ERROR_REASON_UNSPECIFIED", + "STREAMING_SETUP_ERROR", + "STREAMING_SYNC_ERROR", + "INGRESS_ENDPOINT_REQUIRED" + ], + "enumDescriptions": [ + "Streaming error reason unspecified.", + "Some error occurred while setting up resources for realtime sync.", + "Some error was encountered while running realtime sync for the connector.", + "Ingress endpoint is required when setting up realtime sync in private connectivity." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity": { + "description": "Represents an entity in the data source. For example, the `Account` object in Salesforce.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity", + "properties": { + "dataStore": { + "description": "Output only. The full resource name of the associated data store for the source entity. Format: `projects/*/locations/*/collections/*/dataStores/*`. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity.", + "readOnly": true, + "type": "string" + }, + "entityName": { + "description": "The name of the entity. Supported values by data source: * Salesforce: `Lead`, `Opportunity`, `Contact`, `Account`, `Case`, `Contract`, `Campaign` * Jira: `Issue` * Confluence: `Content`, `Space`", + "type": "string" + }, + "healthcareFhirConfig": { + "$ref": "GoogleCloudDiscoveryengineV1HealthcareFhirConfig", + "description": "Optional. Configuration for `HEALTHCARE_FHIR` vertical." + }, + "jsonParams": { + "description": "The parameters for the entity to facilitate data ingestion in json string format.", + "type": "string" + }, + "keyPropertyMappings": { + "additionalProperties": { + "type": "string" + }, + "description": "Attributes for indexing. Key: Field name. Value: The key property to map a field to, such as `title`, and `description`. Supported key properties: * `title`: The title for data record. This would be displayed on search results. * `description`: The description for data record. This would be displayed on search results.", + "type": "object" + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "The parameters for the entity to facilitate data ingestion in structured json format.", + "type": "object" + }, + "startingSchema": { + "$ref": "GoogleCloudDiscoveryengineV1Schema", + "description": "Optional. The start schema to use for the DataStore created from this SourceEntity. If unset, a default vertical specialized schema will be used. This field is only used by SetUpDataConnector API, and will be ignored if used in other APIs. This field will be omitted from all API responses including GetDataConnector API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataStore": { + "description": "DataStore captures global settings and configs at the DataStore level.", + "id": "GoogleCloudDiscoveryengineV1DataStore", + "properties": { + "aclEnabled": { + "description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.", + "type": "boolean" + }, + "advancedSiteSearchConfig": { + "$ref": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", + "description": "Optional. Configuration for advanced site search." + }, + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, + "cmekConfig": { + "$ref": "GoogleCloudDiscoveryengineV1CmekConfig", + "description": "Output only. CMEK-related information for the DataStore.", + "readOnly": true + }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, + "contentConfig": { + "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", + "enum": [ + "CONTENT_CONFIG_UNSPECIFIED", + "NO_CONTENT", + "CONTENT_REQUIRED", + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" + ], + "enumDescriptions": [ "Default value.", "Only contains documents without any Document.content.", "Only contains documents with Document.content.", @@ -12023,6 +12807,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DeleteCollectionMetadata": { + "description": "Metadata related to the progress of the CollectionService.UpdateCollection operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1DeleteCollectionMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata", @@ -12112,15 +12913,61 @@ "description": "Metadata related to the progress of the SiteSearchEngineService.DeleteTargetSite operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1DeleteTargetSiteMetadata", "properties": { - "createTime": { - "description": "Operation create time.", - "format": "google-datetime", + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DestinationConfig": { + "description": "Defines target endpoints used to connect to third-party sources.", + "id": "GoogleCloudDiscoveryengineV1DestinationConfig", + "properties": { + "destinations": { + "description": "Optional. The destinations for the corresponding key.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DestinationConfigDestination" + }, + "type": "array" + }, + "jsonParams": { + "description": "Additional parameters for this destination config in json string format.", + "type": "string" + }, + "key": { + "description": "Optional. Unique destination identifier that is supported by the connector.", + "type": "string" + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Additional parameters for this destination config in structured json format.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DestinationConfigDestination": { + "description": "Defines a target endpoint", + "id": "GoogleCloudDiscoveryengineV1DestinationConfigDestination", + "properties": { + "host": { + "description": "Publicly routable host.", "type": "string" }, - "updateTime": { - "description": "Operation last update time. If the operation is done, this is also the finish time.", - "format": "google-datetime", - "type": "string" + "port": { + "description": "Optional. Target port number accepted by the destination.", + "format": "int32", + "type": "integer" } }, "type": "object" @@ -12550,6 +13397,18 @@ "$ref": "GoogleCloudDiscoveryengineV1EngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -12585,7 +13444,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -13082,6 +13941,22 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1IdentityScheduleConfig": { + "description": "The configuration for the identity data synchronization runs.", + "id": "GoogleCloudDiscoveryengineV1IdentityScheduleConfig", + "properties": { + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Optional. The UTC time when the next data sync is expected to start for the Data Connector. Customers are only able to specify the hour and minute to schedule the data sync. This is utilized when the data connector has a refresh interval greater than 1 day." + }, + "refreshInterval": { + "description": "Optional. The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1IdpConfig": { "description": "Identity Provider Config.", "id": "GoogleCloudDiscoveryengineV1IdpConfig", @@ -13913,6 +14788,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -13935,6 +14814,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1ProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1ProjectServiceTerms", @@ -14008,6 +14924,10 @@ "acceptBizQos": { "description": "Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].", "type": "boolean" + }, + "isBiz": { + "description": "Optional. Indicates if the current request is for Biz edition (= true) or not (= false).", + "type": "boolean" } }, "type": "object" @@ -14663,8 +15583,12 @@ "description": "The BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see [Standard fields](https://cloud.google.com/apis/design/standard_fields). This field helps to better interpret the query. If a value isn't specified, the query language code is automatically detected, which may not be accurate.", "type": "string" }, + "naturalLanguageQueryUnderstandingSpec": { + "$ref": "GoogleCloudDiscoveryengineV1SearchRequestNaturalLanguageQueryUnderstandingSpec", + "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." + }, "offset": { - "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.", + "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold.", "format": "int32", "type": "integer" }, @@ -15190,6 +16114,55 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1SearchRequestNaturalLanguageQueryUnderstandingSpec": { + "description": "Specification to enable natural language understanding capabilities for search requests.", + "id": "GoogleCloudDiscoveryengineV1SearchRequestNaturalLanguageQueryUnderstandingSpec", + "properties": { + "allowedFieldNames": { + "description": "Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.", + "items": { + "type": "string" + }, + "type": "array" + }, + "extractedFilterBehavior": { + "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.", + "enum": [ + "EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED", + "HARD_FILTER", + "SOFT_BOOST" + ], + "enumDescriptions": [ + "`EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED` will use the default behavior for extracted filters. For single datastore search, the default is to apply as hard filters. For multi-datastore search, the default is to apply as soft boosts.", + "Applies all extracted filters as hard filters on the results. Results that do not pass the extracted filters will not be returned in the result set.", + "Applies all extracted filters as soft boosts. Results that pass the filters will be boosted up to higher ranks in the result set." + ], + "type": "string" + }, + "filterExtractionCondition": { + "description": "The condition under which filter extraction should occur. Server behavior defaults to `DISABLED`.", + "enum": [ + "CONDITION_UNSPECIFIED", + "DISABLED", + "ENABLED" + ], + "enumDescriptions": [ + "Server behavior defaults to `DISABLED`.", + "Disables NL filter extraction.", + "Enables NL filter extraction." + ], + "type": "string" + }, + "geoSearchQueryDetectionFieldNames": { + "description": "Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to `ENABLED`. If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1SearchRequestQueryExpansionSpec": { "description": "Specification to determine under which conditions query expansion should occur.", "id": "GoogleCloudDiscoveryengineV1SearchRequestQueryExpansionSpec", @@ -15963,6 +16936,31 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata": { + "description": "Metadata for DataConnectorService.SetUpDataConnector method.", + "id": "GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest": { + "description": "Request for DataConnectorService.SetUpDataConnector method.", + "id": "GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest", + "properties": { + "collectionDisplayName": { + "description": "Required. The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.", + "type": "string" + }, + "collectionId": { + "description": "Required. The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "type": "string" + }, + "dataConnector": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnector", + "description": "Required. The DataConnector to initialize in the newly created Collection." + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1SingleRegionKey": { "description": "Metadata for single-regional CMEKs.", "id": "GoogleCloudDiscoveryengineV1SingleRegionKey", @@ -16320,6 +17318,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1Tenant": { + "description": "Tenant information for a connector source. This includes some of the same information stored in the Credential message, but is limited to only what is needed to provide a list of accessible tenants to the user.", + "id": "GoogleCloudDiscoveryengineV1Tenant", + "properties": { + "displayName": { + "description": "Optional display name for the tenant, e.g. \"My Slack Team\".", + "type": "string" + }, + "id": { + "description": "The tenant's instance ID. Examples: Jira (\"8594f221-9797-5f78-1fa4-485e198d7cd0\"), Slack (\"T123456\").", + "type": "string" + }, + "uri": { + "description": "The URI of the tenant, if applicable. For example, the URI of a Jira instance is https://my-jira-instance.atlassian.net, and a Slack tenant does not have a URI.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1TextInput": { "description": "Defines text input.", "id": "GoogleCloudDiscoveryengineV1TextInput", @@ -16775,7 +17792,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Required. Params needed to support actions in the format of (Key, Value) pairs. Required parameters for sources that support OAUTH, i.e. `gmail`, `google_calendar`, `jira`, `workday`, `salesforce`, `confluence`: * Key: `client_id` * Value: type STRING. The client ID for the service provider to identify your application. * Key: `client_secret` * Value:type STRING. The client secret generated by the application's authorization server.", + "description": "Optional. Action parameters in structured json format.", "type": "object" }, "isActionConfigured": { @@ -16783,6 +17800,10 @@ "readOnly": true, "type": "boolean" }, + "jsonActionParams": { + "description": "Optional. Action parameters in json string format.", + "type": "string" + }, "serviceName": { "description": "Optional. The Service Directory resource name (projects/*/locations/*/namespaces/*/services/*) representing a VPC network endpoint used to connect to the data source's `instance_uri`, defined in DataConnector.params. Required when VPC Service Controls are enabled.", "type": "string" @@ -17480,6 +18501,13 @@ "description": "The configuration for the BAP connector.", "id": "GoogleCloudDiscoveryengineV1alphaBAPConfig", "properties": { + "enabledActions": { + "description": "Optional. The actions enabled on the associated BAP connection.", + "items": { + "type": "string" + }, + "type": "array" + }, "supportedConnectorModes": { "description": "Required. The supported connector modes for the associated BAP connection.", "items": { @@ -18508,6 +19536,10 @@ "description": "Optional. Indicates whether incremental syncs are paused for this connector. This is independent of auto_run_disabled. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled, i.e. set to true.", "type": "boolean" }, + "jsonParams": { + "description": "Required data connector parameters in json string format.", + "type": "string" + }, "kmsKeyName": { "description": "Input only. The KMS key to be used to protect the DataStores managed by this connector. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStores created by this connector will be protected by the KMS key.", "type": "string" @@ -18538,7 +19570,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Required. Params needed to access the source in the format of (Key, Value) pairs. Required parameters for all data sources: * Key: `instance_uri` * Value: type STRING. The uri to access the data source. Required parameters for sources that support OAUTH, i.e. `salesforce`: * Key: `client_id` * Value: type STRING. The client ID for the third party service provider to identify your application. * Key: `client_secret` * Value:type STRING. The client secret generated by the third party authorization server. * Key: `access_token` * Value: type STRING. OAuth token for UCS to access to the protected resource. * Key: `refresh_token` * Value: type STRING. OAuth refresh token for UCS to obtain a new access token without user interaction. Required parameters for sources that support basic API token auth, i.e. `jira`, `confluence`: * Key: `user_account` * Value: type STRING. The username or email with the source. * Key: `api_token` * Value: type STRING. The API token generated for the source account, that is used for authenticating anywhere where you would have used a password. Example: ```json { \"instance_uri\": \"https://xxx.atlassian.net\", \"user_account\": \"xxxx.xxx@xxx.com\", \"api_token\": \"test-token\" } ``` Optional parameter to specify the authorization type to use for multiple authorization types support: * Key: `auth_type` * Value: type STRING. The authorization type for the data source. Supported values: `BASIC_AUTH`, `OAUTH`, `OAUTH_ACCESS_TOKEN`, `OAUTH_TWO_LEGGED`, `OAUTH_JWT_BEARER`, `OAUTH_PASSWORD_GRANT`, `JWT`, `API_TOKEN`, `FEDERATED_CREDENTIAL`.", + "description": "Required data connector parameters in structured json format.", "type": "object" }, "privateConnectivityProjectId": { @@ -18667,6 +19699,10 @@ "description": "Optional. Any authentication parameters specific to EUA connectors.", "type": "object" }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to EUA connectors in json string format.", + "type": "string" + }, "tenant": { "$ref": "GoogleCloudDiscoveryengineV1alphaTenant", "description": "Optional. The tenant project the connector is connected to." @@ -18691,8 +19727,12 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. Any authentication parameters specific to FEDERATED.", + "description": "Optional. Any authentication parameters specific to FEDERATED connectors.", "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to FEDERATED connectors in json string format.", + "type": "string" } }, "type": "object" @@ -18760,6 +19800,10 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaHealthcareFhirConfig", "description": "Optional. Configuration for `HEALTHCARE_FHIR` vertical." }, + "jsonParams": { + "description": "The parameters for the entity to facilitate data ingestion in json string format.", + "type": "string" + }, "keyPropertyMappings": { "additionalProperties": { "type": "string" @@ -18772,7 +19816,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The parameters for the entity to facilitate data ingestion. E.g. for BigQuery connectors: * Key: `document_id_column` * Value: type STRING. The value of the column ID.", + "description": "The parameters for the entity to facilitate data ingestion in structured json format.", "type": "object" }, "startingSchema": { @@ -18804,6 +19848,20 @@ "description": "Output only. CMEK-related information for the DataStore.", "readOnly": true }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -19155,6 +20213,10 @@ }, "type": "array" }, + "jsonParams": { + "description": "Additional parameters for this destination config in json string format.", + "type": "string" + }, "key": { "description": "Optional. Unique destination identifier that is supported by the connector.", "type": "string" @@ -19164,7 +20226,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. Additional parameters for this destination config.", + "description": "Optional. Additional parameters for this destination config in structured json format.", "type": "object" } }, @@ -19405,6 +20467,18 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaEngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -19440,7 +20514,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -20626,6 +21700,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -20648,6 +21726,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1alphaProjectServiceTerms", @@ -21311,10 +22426,10 @@ }, "naturalLanguageQueryUnderstandingSpec": { "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", - "description": "Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." + "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "offset": { - "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.", + "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold.", "format": "int32", "type": "integer" }, @@ -21414,6 +22529,10 @@ "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" }, + "searchAddonSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec", + "description": "Optional. SearchAddonSpec is used to disable add-ons for search as per new repricing model. This field is only supported for search requests." + }, "searchAsYouTypeSpec": { "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec", "description": "Search as you type configuration. Only supported for the IndustryVertical.MEDIA vertical." @@ -21920,6 +23039,13 @@ "description": "Specification to enable natural language understanding capabilities for search requests.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { + "allowedFieldNames": { + "description": "Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.", + "items": { + "type": "string" + }, + "type": "array" + }, "extractedFilterBehavior": { "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.", "enum": [ @@ -22015,6 +23141,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec": { + "description": "SearchAddonSpec is used to disable add-ons for search as per new repricing model. By default if the SearchAddonSpec is not specified, we consider that the customer wants to enable them wherever applicable.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec", + "properties": { + "disableGenerativeAnswerAddOn": { + "description": "Optional. If true, generative answer add-on is disabled. Generative answer add-on includes natural language to filters and simple answers.", + "type": "boolean" + }, + "disableKpiPersonalizationAddOn": { + "description": "Optional. If true, disables event re-ranking and personalization to optimize KPIs \u0026 personalize results.", + "type": "boolean" + }, + "disableSemanticAddOn": { + "description": "Optional. If true, semantic add-on is disabled. Semantic add-on includes embeddings and jetstream.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec": { "description": "Specification for search as you type in search requests.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec", @@ -23290,6 +24435,20 @@ "description": "Output only. CMEK-related information for the DataStore.", "readOnly": true }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -23799,6 +24958,18 @@ "$ref": "GoogleCloudDiscoveryengineV1betaEngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -23834,7 +25005,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -24645,6 +25816,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -24667,6 +25842,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1betaProjectServiceTerms", @@ -25008,10 +26220,10 @@ }, "naturalLanguageQueryUnderstandingSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", - "description": "Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." + "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "offset": { - "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.", + "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold.", "format": "int32", "type": "integer" }, @@ -25111,6 +26323,10 @@ "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" }, + "searchAddonSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec", + "description": "Optional. SearchAddonSpec is used to disable add-ons for search as per new repricing model. This field is only supported for search requests." + }, "searchAsYouTypeSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec", "description": "Search as you type configuration. Only supported for the IndustryVertical.MEDIA vertical." @@ -25613,6 +26829,13 @@ "description": "Specification to enable natural language understanding capabilities for search requests.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { + "allowedFieldNames": { + "description": "Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.", + "items": { + "type": "string" + }, + "type": "array" + }, "extractedFilterBehavior": { "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.", "enum": [ @@ -25708,6 +26931,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec": { + "description": "SearchAddonSpec is used to disable add-ons for search as per new repricing model. By default if the SearchAddonSpec is not specified, we consider that the customer wants to enable them wherever applicable.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec", + "properties": { + "disableGenerativeAnswerAddOn": { + "description": "Optional. If true, generative answer add-on is disabled. Generative answer add-on includes natural language to filters and simple answers.", + "type": "boolean" + }, + "disableKpiPersonalizationAddOn": { + "description": "Optional. If true, disables event re-ranking and personalization to optimize KPIs \u0026 personalize results.", + "type": "boolean" + }, + "disableSemanticAddOn": { + "description": "Optional. If true, semantic add-on is disabled. Semantic add-on includes embeddings and jetstream.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec": { "description": "Specification for search as you type in search requests.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec", diff --git a/discoveryengine/v1/discoveryengine-gen.go b/discoveryengine/v1/discoveryengine-gen.go index c673f2df357..89abb63beca 100644 --- a/discoveryengine/v1/discoveryengine-gen.go +++ b/discoveryengine/v1/discoveryengine-gen.go @@ -2274,6 +2274,42 @@ func (s GoogleCloudDiscoveryengineV1AclConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1ActionConfig: Informations to support actions on +// the connector. +type GoogleCloudDiscoveryengineV1ActionConfig struct { + // ActionParams: Optional. Action parameters in structured json format. + ActionParams googleapi.RawMessage `json:"actionParams,omitempty"` + // IsActionConfigured: Output only. The connector contains the necessary + // parameters and is configured to support actions. + IsActionConfigured bool `json:"isActionConfigured,omitempty"` + // JsonActionParams: Optional. Action parameters in json string format. + JsonActionParams string `json:"jsonActionParams,omitempty"` + // ServiceName: Optional. The Service Directory resource name + // (projects/*/locations/*/namespaces/*/services/*) representing a VPC network + // endpoint used to connect to the data source's `instance_uri`, defined in + // DataConnector.params. Required when VPC Service Controls are enabled. + ServiceName string `json:"serviceName,omitempty"` + // UseStaticSecrets: Optional. Whether to use static secrets for the connector. + // If true, the secrets provided in the action_params will be ignored. + UseStaticSecrets bool `json:"useStaticSecrets,omitempty"` + // ForceSendFields is a list of field names (e.g. "ActionParams") 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. "ActionParams") 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 GoogleCloudDiscoveryengineV1ActionConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ActionConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest: Request message // for CompletionService.AdvancedCompleteQuery method. . type GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest struct { @@ -2726,6 +2762,63 @@ func (s GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1AlertPolicyConfig: The connector level alert +// config. +type GoogleCloudDiscoveryengineV1AlertPolicyConfig struct { + // AlertEnrollments: Optional. The enrollment states of each alert. + AlertEnrollments []*GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment `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 GoogleCloudDiscoveryengineV1AlertPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AlertPolicyConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment: The alert +// enrollment status. +type GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment 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 GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1AlloyDbSource: AlloyDB source import data from. type GoogleCloudDiscoveryengineV1AlloyDbSource struct { // ClusterId: Required. The AlloyDB cluster to copy the data from with a length @@ -5055,6 +5148,9 @@ type GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataRe // contain a URL that redirects to the actual website, in which case this will // contain the domain name of the target site. Domain string `json:"domain,omitempty"` + // MimeType: The mime type of the document. + // https://www.iana.org/assignments/media-types/media-types.xhtml. + MimeType string `json:"mimeType,omitempty"` // PageIdentifier: Page identifier. PageIdentifier string `json:"pageIdentifier,omitempty"` // Title: Title. @@ -5177,6 +5273,40 @@ func (s GoogleCloudDiscoveryengineV1AssistantToolList) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1BAPConfig: The configuration for the BAP +// connector. +type GoogleCloudDiscoveryengineV1BAPConfig struct { + // EnabledActions: Optional. The actions enabled on the associated BAP + // connection. + EnabledActions []string `json:"enabledActions,omitempty"` + // SupportedConnectorModes: Required. The supported connector modes for the + // associated BAP connection. + // + // Possible values: + // "CONNECTOR_MODE_UNSPECIFIED" - Connector mode unspecified. + // "DATA_INGESTION" - Connector utilized for data ingestion. + // "ACTIONS" - Connector utilized for Actions + // "END_USER_AUTHENTICATION" - Connector utilized for End User + // Authentication. + SupportedConnectorModes []string `json:"supportedConnectorModes,omitempty"` + // ForceSendFields is a list of field names (e.g. "EnabledActions") 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. "EnabledActions") 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 GoogleCloudDiscoveryengineV1BAPConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1BAPConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata: Metadata related // to the progress of the SiteSearchEngineService.BatchCreateTargetSites // operation. This will be returned by the @@ -6232,6 +6362,37 @@ func (s GoogleCloudDiscoveryengineV1CmekConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1Collection: Collection is a container for +// configuring resources and access to a set of DataStores. +type GoogleCloudDiscoveryengineV1Collection struct { + // CreateTime: Output only. Timestamp the Collection was created at. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Required. The Collection display name. This field must be a + // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. + DisplayName string `json:"displayName,omitempty"` + // Name: Immutable. The full resource name of the Collection. Format: + // `projects/{project}/locations/{location}/collections/{collection_id}`. This + // field must be a UTF-8 encoded string with a length limit of 1024 characters. + Name string `json:"name,omitempty"` + // 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 GoogleCloudDiscoveryengineV1Collection) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1Collection + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1CompleteQueryResponse: Response message for // CompletionService.CompleteQuery method. type GoogleCloudDiscoveryengineV1CompleteQueryResponse struct { @@ -7258,111 +7419,253 @@ func (s GoogleCloudDiscoveryengineV1CustomTuningModel) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings -// and configs at the DataStore level. -type GoogleCloudDiscoveryengineV1DataStore struct { - // AclEnabled: Immutable. Whether data in the DataStore has ACL information. If - // set to `true`, the source data must have ACL. ACL will be ingested when data - // is ingested by DocumentService.ImportDocuments methods. When ACL is enabled - // for the DataStore, Document can't be accessed by calling - // DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL - // is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` - // content config. +// GoogleCloudDiscoveryengineV1DataConnector: Manages the connection to +// external data sources for all data stores grouped under a Collection. It's a +// singleton resource of Collection. The initialization is only supported +// through DataConnectorService.SetUpDataConnector method, which will create a +// new Collection and initialize its DataConnector. +type GoogleCloudDiscoveryengineV1DataConnector struct { + // AclEnabled: Optional. Whether the connector will be created with an ACL + // config. Currently this field only affects Cloud Storage and BigQuery + // connectors. AclEnabled bool `json:"aclEnabled,omitempty"` - // AdvancedSiteSearchConfig: Optional. Configuration for advanced site search. - AdvancedSiteSearchConfig *GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig `json:"advancedSiteSearchConfig,omitempty"` - // BillingEstimation: Output only. Data size estimation for billing. - BillingEstimation *GoogleCloudDiscoveryengineV1DataStoreBillingEstimation `json:"billingEstimation,omitempty"` - // CmekConfig: Output only. CMEK-related information for the DataStore. - CmekConfig *GoogleCloudDiscoveryengineV1CmekConfig `json:"cmekConfig,omitempty"` - // ContentConfig: Immutable. The content config of the data store. If this - // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. + // ActionConfig: Optional. Action configurations to make the connector support + // actions. + ActionConfig *GoogleCloudDiscoveryengineV1ActionConfig `json:"actionConfig,omitempty"` + // ActionState: Output only. State of the action connector. This reflects + // whether the action connector is initializing, active or has encountered + // errors. // // Possible values: - // "CONTENT_CONFIG_UNSPECIFIED" - Default value. - // "NO_CONTENT" - Only contains documents without any Document.content. - // "CONTENT_REQUIRED" - Only contains documents with Document.content. - // "PUBLIC_WEBSITE" - The data store is used for public website search. - // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details - // of workspace data store are specified in the WorkspaceConfig. - ContentConfig string `json:"contentConfig,omitempty"` - // CreateTime: Output only. Timestamp the DataStore was created at. - CreateTime string `json:"createTime,omitempty"` - // DefaultSchemaId: Output only. The id of the default Schema associated to - // this data store. - DefaultSchemaId string `json:"defaultSchemaId,omitempty"` - // DisplayName: Required. The data store display name. This field must be a - // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an - // INVALID_ARGUMENT error is returned. - DisplayName string `json:"displayName,omitempty"` - // DocumentProcessingConfig: Configuration for Document understanding and - // enrichment. - DocumentProcessingConfig *GoogleCloudDiscoveryengineV1DocumentProcessingConfig `json:"documentProcessingConfig,omitempty"` - // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` - // vertical. - HealthcareFhirConfig *GoogleCloudDiscoveryengineV1HealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` - // IdentityMappingStore: Immutable. The fully qualified resource name of the - // associated IdentityMappingStore. This field can only be set for acl_enabled - // DataStores with `THIRD_PARTY` or `GSUITE` IdP. Format: - // `projects/{project}/locations/{location}/identityMappingStores/{identity_mapp - // ing_store}`. - IdentityMappingStore string `json:"identityMappingStore,omitempty"` - // IndustryVertical: Immutable. The industry vertical that the data store - // registers. + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + ActionState string `json:"actionState,omitempty"` + // AlertPolicyConfigs: Optional. The connector level alert config. + AlertPolicyConfigs []*GoogleCloudDiscoveryengineV1AlertPolicyConfig `json:"alertPolicyConfigs,omitempty"` + // AutoRunDisabled: Optional. Indicates whether the connector is disabled for + // auto run. It can be used to pause periodical and real time sync. Update: + // with the introduction of incremental_sync_disabled, auto_run_disabled is + // used to pause/disable only full syncs + AutoRunDisabled bool `json:"autoRunDisabled,omitempty"` + // BapConfig: Optional. The configuration for establishing a BAP connection. + BapConfig *GoogleCloudDiscoveryengineV1BAPConfig `json:"bapConfig,omitempty"` + // BlockingReasons: Output only. User actions that must be completed before the + // connector can start syncing data. // // Possible values: - // "INDUSTRY_VERTICAL_UNSPECIFIED" - Value used when unset. - // "GENERIC" - The generic vertical for documents that are not specific to - // any industry vertical. - // "MEDIA" - The media industry vertical. - // "HEALTHCARE_FHIR" - The healthcare FHIR vertical. - IndustryVertical string `json:"industryVertical,omitempty"` - // IsInfobotFaqDataStore: Optional. If set, this DataStore is an Infobot FAQ - // DataStore. - IsInfobotFaqDataStore bool `json:"isInfobotFaqDataStore,omitempty"` - // KmsKeyName: Input only. The KMS key to be used to protect this DataStore at - // creation time. Must be set for requests that need to comply with CMEK Org - // Policy protections. If this field is set and processed successfully, the - // DataStore will be protected by the KMS key, as indicated in the cmek_config - // field. - KmsKeyName string `json:"kmsKeyName,omitempty"` - // Name: Immutable. Identifier. The full resource name of the data store. - // Format: - // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor - // es/{data_store_id}`. This field must be a UTF-8 encoded string with a length - // limit of 1024 characters. - Name string `json:"name,omitempty"` - // ServingConfigDataStore: Optional. Stores serving config at DataStore level. - ServingConfigDataStore *GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore `json:"servingConfigDataStore,omitempty"` - // SolutionTypes: The solutions that the data store enrolls. Available - // solutions for each industry_vertical: * `MEDIA`: - // `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: - // `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be - // enrolled. + // "BLOCKING_REASON_UNSPECIFIED" - Default value. + // "ALLOWLIST_STATIC_IP" - Connector requires customer to allowlist static + // IPs. + // "ALLOWLIST_IN_SERVICE_ATTACHMENT" - Connector requires customer to + // allowlist our project in their service attachment. + // "ALLOWLIST_SERVICE_ACCOUNT" - Connector requires customer to allowlist + // service account in their project. + BlockingReasons []string `json:"blockingReasons,omitempty"` + // ConnectorModes: Optional. The modes enabled for this connector. Default + // state is CONNECTOR_MODE_UNSPECIFIED. // // Possible values: - // "SOLUTION_TYPE_UNSPECIFIED" - Default value. - // "SOLUTION_TYPE_RECOMMENDATION" - Used for Recommendations AI. - // "SOLUTION_TYPE_SEARCH" - Used for Discovery Search. - // "SOLUTION_TYPE_CHAT" - Used for use cases related to the Generative AI - // agent. - // "SOLUTION_TYPE_GENERATIVE_CHAT" - Used for use cases related to the - // Generative Chat agent. It's used for Generative chat engine only, the - // associated data stores must enrolled with `SOLUTION_TYPE_CHAT` solution. - SolutionTypes []string `json:"solutionTypes,omitempty"` - // StartingSchema: The start schema to use for this DataStore when provisioning - // it. If unset, a default vertical specialized schema will be used. This field - // is only used by CreateDataStore API, and will be ignored if used in other - // APIs. This field will be omitted from all API responses including - // CreateDataStore API. To retrieve a schema of a DataStore, use - // SchemaService.GetSchema API instead. The provided schema will be validated - // against certain rules on schema. Learn more from this doc - // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). - StartingSchema *GoogleCloudDiscoveryengineV1Schema `json:"startingSchema,omitempty"` - // WorkspaceConfig: Config to store data store type configuration for workspace - // data. This must be set when DataStore.content_config is set as - // DataStore.ContentConfig.GOOGLE_WORKSPACE. - WorkspaceConfig *GoogleCloudDiscoveryengineV1WorkspaceConfig `json:"workspaceConfig,omitempty"` + // "CONNECTOR_MODE_UNSPECIFIED" - Connector mode unspecified. + // "DATA_INGESTION" - Connector utilized for data ingestion. + // "ACTIONS" - Connector utilized for actions. + // "FEDERATED" - Connector utilized for federated search. + // "EUA" - Connector utilized for End User Authentication. + // "FEDERATED_AND_EUA" - Hybrid connector utilized for federated search and + // End User Authentication. + ConnectorModes []string `json:"connectorModes,omitempty"` + // ConnectorType: Output only. The type of connector. Each source can only map + // to one type. For example, salesforce, confluence and jira have THIRD_PARTY + // connector type. It is not mutable once set by system. + // + // Possible values: + // "CONNECTOR_TYPE_UNSPECIFIED" - Default value. + // "THIRD_PARTY" - Third party connector to connector to third party + // application. + // "GCP_FHIR" - Data connector connects between FHIR store and VAIS + // datastore. + // "BIG_QUERY" - Big query connector. + // "GCS" - Google Cloud Storage connector. + // "GOOGLE_MAIL" - Gmail connector. + // "GOOGLE_CALENDAR" - Google Calendar connector. + // "GOOGLE_DRIVE" - Google Drive connector. + // "NATIVE_CLOUD_IDENTITY" - Native Cloud Identity connector for people + // search powered by People API. + // "THIRD_PARTY_FEDERATED" - Federated connector, it is a third party + // connector that doesn't ingestion data, and search is powered by third party + // application's API. + // "THIRD_PARTY_EUA" - Connector utilized for End User Authentication + // features. + // "GCNV" - Google Cloud NetApp Volumes connector. + ConnectorType string `json:"connectorType,omitempty"` + // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is + // created in SaaS. + CreateEuaSaas bool `json:"createEuaSaas,omitempty"` + // CreateTime: Output only. Timestamp the DataConnector was created at. + CreateTime string `json:"createTime,omitempty"` + // DataSource: Required. The name of the data source. Supported values: + // `salesforce`, `jira`, `confluence`, `bigquery`. + DataSource string `json:"dataSource,omitempty"` + // DestinationConfigs: Optional. Any target destinations used to connect to + // third-party services. + DestinationConfigs []*GoogleCloudDiscoveryengineV1DestinationConfig `json:"destinationConfigs,omitempty"` + // EndUserConfig: Optional. Any params and credentials used specifically for + // EUA connectors. + EndUserConfig *GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig `json:"endUserConfig,omitempty"` + // Entities: List of entities from the connected data source to ingest. + Entities []*GoogleCloudDiscoveryengineV1DataConnectorSourceEntity `json:"entities,omitempty"` + // Errors: Output only. The errors from initialization or from the latest + // connector run. + Errors []*GoogleRpcStatus `json:"errors,omitempty"` + // FederatedConfig: Optional. Any params and credentials used specifically for + // hybrid connectors supporting FEDERATED mode. This field should only be set + // if the connector is a hybrid connector and we want to enable FEDERATED mode. + FederatedConfig *GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig `json:"federatedConfig,omitempty"` + // HybridIngestionDisabled: Optional. If the connector is a hybrid connector, + // determines whether ingestion is enabled and appropriate resources are + // provisioned during connector creation. If the connector is not a hybrid + // connector, this field is ignored. + HybridIngestionDisabled bool `json:"hybridIngestionDisabled,omitempty"` + // IdentityRefreshInterval: The refresh interval to sync the Access Control + // List information for the documents ingested by this connector. If not set, + // the access control list will be refreshed at the default interval of 30 + // minutes. The identity refresh interval can be at least 30 minutes and at + // most 7 days. + IdentityRefreshInterval string `json:"identityRefreshInterval,omitempty"` + // IdentityScheduleConfig: The configuration for the identity data + // synchronization runs. This contains the refresh interval to sync the Access + // Control List information for the documents ingested by this connector. + IdentityScheduleConfig *GoogleCloudDiscoveryengineV1IdentityScheduleConfig `json:"identityScheduleConfig,omitempty"` + // IncrementalRefreshInterval: Optional. The refresh interval specifically for + // incremental data syncs. If unset, incremental syncs will use the default + // from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. + // Applicable to only 3P connectors. When the refresh interval is set to the + // same value as the incremental refresh interval, incremental sync will be + // disabled. + IncrementalRefreshInterval string `json:"incrementalRefreshInterval,omitempty"` + // IncrementalSyncDisabled: Optional. Indicates whether incremental syncs are + // paused for this connector. This is independent of auto_run_disabled. + // Applicable to only 3P connectors. When the refresh interval is set to the + // same value as the incremental refresh interval, incremental sync will be + // disabled, i.e. set to true. + IncrementalSyncDisabled bool `json:"incrementalSyncDisabled,omitempty"` + // JsonParams: Required data connector parameters in json string format. + JsonParams string `json:"jsonParams,omitempty"` + // KmsKeyName: Input only. The KMS key to be used to protect the DataStores + // managed by this connector. Must be set for requests that need to comply with + // CMEK Org Policy protections. If this field is set and processed + // successfully, the DataStores created by this connector will be protected by + // the KMS key. + KmsKeyName string `json:"kmsKeyName,omitempty"` + // LastSyncTime: Output only. For periodic connectors only, the last time a + // data sync was completed. + LastSyncTime string `json:"lastSyncTime,omitempty"` + // LatestPauseTime: Output only. The most recent timestamp when this + // DataConnector was paused, affecting all functionalities such as data + // synchronization. Pausing a connector has the following effects: - All + // functionalities, including data synchronization, are halted. - Any ongoing + // data synchronization job will be canceled. - No future data synchronization + // runs will be scheduled nor can be triggered. + LatestPauseTime string `json:"latestPauseTime,omitempty"` + // Name: Output only. The full resource name of the Data Connector. Format: + // `projects/*/locations/*/collections/*/dataConnector`. + Name string `json:"name,omitempty"` + // NextSyncTime: Defines the scheduled time for the next data synchronization. + // This field requires hour , minute, and time_zone from the IANA Time Zone + // Database (https://www.iana.org/time-zones). This is utilized when the data + // connector has a refresh interval greater than 1 day. When the hours or + // minutes are not specified, we will assume a sync time of 0:00. The user must + // provide a time zone to avoid ambiguity. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` + // Params: Required data connector parameters in structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // PrivateConnectivityProjectId: Output only. The tenant project ID associated + // with private connectivity connectors. This project must be allowlisted by in + // order for the connector to function. + PrivateConnectivityProjectId string `json:"privateConnectivityProjectId,omitempty"` + // RealtimeState: Output only. real-time sync state + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + RealtimeState string `json:"realtimeState,omitempty"` + // RealtimeSyncConfig: Optional. The configuration for realtime sync. + RealtimeSyncConfig *GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig `json:"realtimeSyncConfig,omitempty"` + // RefreshInterval: Required. The refresh interval for data sync. If duration + // is set to 0, the data will be synced in real time. The streaming feature is + // not supported yet. The minimum is 30 minutes and maximum is 7 days. When the + // refresh interval is set to the same value as the incremental refresh + // interval, incremental sync will be disabled. + RefreshInterval string `json:"refreshInterval,omitempty"` + // RemoveParamKeys: Optional. Specifies keys to be removed from the 'params' + // field. This is only active when 'params' is included in the 'update_mask' in + // an UpdateDataConnectorRequest. Deletion takes precedence if a key is both in + // 'remove_param_keys' and present in the 'params' field of the request. + RemoveParamKeys []string `json:"removeParamKeys,omitempty"` + // State: Output only. State of the connector. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + State string `json:"state,omitempty"` + // StaticIpAddresses: Output only. The static IP addresses used by this + // connector. + StaticIpAddresses []string `json:"staticIpAddresses,omitempty"` + // StaticIpEnabled: Optional. Whether customer has enabled static IP addresses + // for this connector. + StaticIpEnabled bool `json:"staticIpEnabled,omitempty"` + // SyncMode: The data synchronization mode supported by the data connector. + // + // Possible values: + // "PERIODIC" - The connector will sync data periodically based on the + // refresh_interval. Use it with auto_run_disabled to pause the periodic sync, + // or indicate a one-time sync. + // "STREAMING" - The data will be synced in real time. + // "UNSPECIFIED" - Connector that doesn't ingest data will have this value + SyncMode string `json:"syncMode,omitempty"` + // UpdateTime: Output only. Timestamp the DataConnector was last updated. + UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` @@ -7379,195 +7682,540 @@ type GoogleCloudDiscoveryengineV1DataStore struct { NullFields []string `json:"-"` } -func (s GoogleCloudDiscoveryengineV1DataStore) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1DataStore +func (s GoogleCloudDiscoveryengineV1DataConnector) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnector return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DataStoreBillingEstimation: Estimation of data -// size per data store. -type GoogleCloudDiscoveryengineV1DataStoreBillingEstimation struct { - // StructuredDataSize: Data size for structured data in terms of bytes. - StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` - // StructuredDataUpdateTime: Last updated timestamp for structured data. - StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` - // UnstructuredDataSize: Data size for unstructured data in terms of bytes. - UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` - // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. - UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` - // WebsiteDataSize: Data size for websites in terms of bytes. - WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` - // WebsiteDataUpdateTime: Last updated timestamp for websites. - WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "StructuredDataSize") to +// GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig: Any params and +// credentials used specifically for EUA connectors. +type GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig struct { + // AdditionalParams: Optional. Any additional parameters needed for EUA. + AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` + // AuthParams: Optional. Any authentication parameters specific to EUA + // connectors. + AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to EUA + // connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` + // Tenant: Optional. The tenant project the connector is connected to. + Tenant *GoogleCloudDiscoveryengineV1Tenant `json:"tenant,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalParams") 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. "StructuredDataSize") 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. "AdditionalParams") 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 GoogleCloudDiscoveryengineV1DataStoreBillingEstimation) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1DataStoreBillingEstimation +func (s GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore: Stores -// information regarding the serving configurations at DataStore level. -type GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore struct { - // DisabledForServing: Optional. If set true, the DataStore will not be - // available for serving search requests. - DisabledForServing bool `json:"disabledForServing,omitempty"` - // ForceSendFields is a list of field names (e.g. "DisabledForServing") to +// GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig: Any params and +// credentials used specifically for hybrid connectors supporting FEDERATED +// mode. +type GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig struct { + // AdditionalParams: Optional. Any additional parameters needed for FEDERATED. + AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` + // AuthParams: Optional. Any authentication parameters specific to FEDERATED + // connectors. + AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to + // FEDERATED connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalParams") 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. "DisabledForServing") 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. "AdditionalParams") 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 GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore +func (s GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata: Metadata related to -// the progress of the CmekConfigService.DeleteCmekConfig operation. This will -// be returned by the google.longrunning.Operation.metadata field. -type GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata struct { - // CreateTime: Operation create time. - CreateTime string `json:"createTime,omitempty"` - // UpdateTime: Operation last update time. If the operation is done, this is - // also the finish time. - UpdateTime string `json:"updateTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to +// GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig: The +// configuration for realtime sync to store additional params for realtime +// sync. +type GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig struct { + // RealtimeSyncSecret: Optional. The ID of the Secret Manager secret used for + // webhook secret. + RealtimeSyncSecret string `json:"realtimeSyncSecret,omitempty"` + // StreamingError: Optional. Streaming error details. + StreamingError *GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError `json:"streamingError,omitempty"` + // WebhookUri: Optional. Webhook url for the connector to specify additional + // params for realtime sync. + WebhookUri string `json:"webhookUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "RealtimeSyncSecret") 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 + // NullFields is a list of field names (e.g. "RealtimeSyncSecret") 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 GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata +func (s GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata: Metadata related to the -// progress of the DataStoreService.DeleteDataStore operation. This will be -// returned by the google.longrunning.Operation.metadata field. -type GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata struct { - // CreateTime: Operation create time. - CreateTime string `json:"createTime,omitempty"` - // UpdateTime: Operation last update time. If the operation is done, this is - // also the finish time. - UpdateTime string `json:"updateTime,omitempty"` - // 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 +// GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError: +// Streaming error details. +type GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError struct { + // Error: Optional. Error details. + Error *GoogleRpcStatus `json:"error,omitempty"` + // StreamingErrorReason: Optional. Streaming error. + // + // Possible values: + // "STREAMING_ERROR_REASON_UNSPECIFIED" - Streaming error reason unspecified. + // "STREAMING_SETUP_ERROR" - Some error occurred while setting up resources + // for realtime sync. + // "STREAMING_SYNC_ERROR" - Some error was encountered while running realtime + // sync for the connector. + // "INGRESS_ENDPOINT_REQUIRED" - Ingress endpoint is required when setting up + // realtime sync in private connectivity. + StreamingErrorReason string `json:"streamingErrorReason,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") 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 + // NullFields is a list of field names (e.g. "Error") 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 GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata +func (s GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DeleteEngineMetadata: Metadata related to the -// progress of the EngineService.DeleteEngine operation. This will be returned -// by the google.longrunning.Operation.metadata field. -type GoogleCloudDiscoveryengineV1DeleteEngineMetadata struct { - // CreateTime: Operation create time. - CreateTime string `json:"createTime,omitempty"` - // UpdateTime: Operation last update time. If the operation is done, this is - // also the finish time. - UpdateTime string `json:"updateTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to +// GoogleCloudDiscoveryengineV1DataConnectorSourceEntity: Represents an entity +// in the data source. For example, the `Account` object in Salesforce. +type GoogleCloudDiscoveryengineV1DataConnectorSourceEntity struct { + // DataStore: Output only. The full resource name of the associated data store + // for the source entity. Format: + // `projects/*/locations/*/collections/*/dataStores/*`. When the connector is + // initialized by the DataConnectorService.SetUpDataConnector method, a + // DataStore is automatically created for each source entity. + DataStore string `json:"dataStore,omitempty"` + // EntityName: The name of the entity. Supported values by data source: * + // Salesforce: `Lead`, `Opportunity`, `Contact`, `Account`, `Case`, `Contract`, + // `Campaign` * Jira: `Issue` * Confluence: `Content`, `Space` + EntityName string `json:"entityName,omitempty"` + // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` + // vertical. + HealthcareFhirConfig *GoogleCloudDiscoveryengineV1HealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` + // JsonParams: The parameters for the entity to facilitate data ingestion in + // json string format. + JsonParams string `json:"jsonParams,omitempty"` + // KeyPropertyMappings: Attributes for indexing. Key: Field name. Value: The + // key property to map a field to, such as `title`, and `description`. + // Supported key properties: * `title`: The title for data record. This would + // be displayed on search results. * `description`: The description for data + // record. This would be displayed on search results. + KeyPropertyMappings map[string]string `json:"keyPropertyMappings,omitempty"` + // Params: The parameters for the entity to facilitate data ingestion in + // structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // StartingSchema: Optional. The start schema to use for the DataStore created + // from this SourceEntity. If unset, a default vertical specialized schema will + // be used. This field is only used by SetUpDataConnector API, and will be + // ignored if used in other APIs. This field will be omitted from all API + // responses including GetDataConnector API. To retrieve a schema of a + // DataStore, use SchemaService.GetSchema API instead. The provided schema will + // be validated against certain rules on schema. Learn more from this doc + // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). + StartingSchema *GoogleCloudDiscoveryengineV1Schema `json:"startingSchema,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 // 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 + // NullFields is a list of field names (e.g. "DataStore") 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 GoogleCloudDiscoveryengineV1DeleteEngineMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1DeleteEngineMetadata +func (s GoogleCloudDiscoveryengineV1DataConnectorSourceEntity) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorSourceEntity return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata: Metadata -// related to the progress of the -// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will -// be returned by the google.longrunning.Operation.metadata field. -type GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata struct { - // CreateTime: Operation create time. +// GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings +// and configs at the DataStore level. +type GoogleCloudDiscoveryengineV1DataStore struct { + // AclEnabled: Immutable. Whether data in the DataStore has ACL information. If + // set to `true`, the source data must have ACL. ACL will be ingested when data + // is ingested by DocumentService.ImportDocuments methods. When ACL is enabled + // for the DataStore, Document can't be accessed by calling + // DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL + // is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` + // content config. + AclEnabled bool `json:"aclEnabled,omitempty"` + // AdvancedSiteSearchConfig: Optional. Configuration for advanced site search. + AdvancedSiteSearchConfig *GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig `json:"advancedSiteSearchConfig,omitempty"` + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1DataStoreBillingEstimation `json:"billingEstimation,omitempty"` + // CmekConfig: Output only. CMEK-related information for the DataStore. + CmekConfig *GoogleCloudDiscoveryengineV1CmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ContentConfig: Immutable. The content config of the data store. If this + // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. + // + // Possible values: + // "CONTENT_CONFIG_UNSPECIFIED" - Default value. + // "NO_CONTENT" - Only contains documents without any Document.content. + // "CONTENT_REQUIRED" - Only contains documents with Document.content. + // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. + ContentConfig string `json:"contentConfig,omitempty"` + // CreateTime: Output only. Timestamp the DataStore was created at. CreateTime string `json:"createTime,omitempty"` - // UpdateTime: Operation last update time. If the operation is done, this is - // also the finish time. - UpdateTime string `json:"updateTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to + // DefaultSchemaId: Output only. The id of the default Schema associated to + // this data store. + DefaultSchemaId string `json:"defaultSchemaId,omitempty"` + // DisplayName: Required. The data store display name. This field must be a + // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. + DisplayName string `json:"displayName,omitempty"` + // DocumentProcessingConfig: Configuration for Document understanding and + // enrichment. + DocumentProcessingConfig *GoogleCloudDiscoveryengineV1DocumentProcessingConfig `json:"documentProcessingConfig,omitempty"` + // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` + // vertical. + HealthcareFhirConfig *GoogleCloudDiscoveryengineV1HealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` + // IdentityMappingStore: Immutable. The fully qualified resource name of the + // associated IdentityMappingStore. This field can only be set for acl_enabled + // DataStores with `THIRD_PARTY` or `GSUITE` IdP. Format: + // `projects/{project}/locations/{location}/identityMappingStores/{identity_mapp + // ing_store}`. + IdentityMappingStore string `json:"identityMappingStore,omitempty"` + // IndustryVertical: Immutable. The industry vertical that the data store + // registers. + // + // Possible values: + // "INDUSTRY_VERTICAL_UNSPECIFIED" - Value used when unset. + // "GENERIC" - The generic vertical for documents that are not specific to + // any industry vertical. + // "MEDIA" - The media industry vertical. + // "HEALTHCARE_FHIR" - The healthcare FHIR vertical. + IndustryVertical string `json:"industryVertical,omitempty"` + // IsInfobotFaqDataStore: Optional. If set, this DataStore is an Infobot FAQ + // DataStore. + IsInfobotFaqDataStore bool `json:"isInfobotFaqDataStore,omitempty"` + // KmsKeyName: Input only. The KMS key to be used to protect this DataStore at + // creation time. Must be set for requests that need to comply with CMEK Org + // Policy protections. If this field is set and processed successfully, the + // DataStore will be protected by the KMS key, as indicated in the cmek_config + // field. + KmsKeyName string `json:"kmsKeyName,omitempty"` + // Name: Immutable. Identifier. The full resource name of the data store. + // Format: + // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor + // es/{data_store_id}`. This field must be a UTF-8 encoded string with a length + // limit of 1024 characters. + Name string `json:"name,omitempty"` + // ServingConfigDataStore: Optional. Stores serving config at DataStore level. + ServingConfigDataStore *GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore `json:"servingConfigDataStore,omitempty"` + // SolutionTypes: The solutions that the data store enrolls. Available + // solutions for each industry_vertical: * `MEDIA`: + // `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: + // `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be + // enrolled. + // + // Possible values: + // "SOLUTION_TYPE_UNSPECIFIED" - Default value. + // "SOLUTION_TYPE_RECOMMENDATION" - Used for Recommendations AI. + // "SOLUTION_TYPE_SEARCH" - Used for Discovery Search. + // "SOLUTION_TYPE_CHAT" - Used for use cases related to the Generative AI + // agent. + // "SOLUTION_TYPE_GENERATIVE_CHAT" - Used for use cases related to the + // Generative Chat agent. It's used for Generative chat engine only, the + // associated data stores must enrolled with `SOLUTION_TYPE_CHAT` solution. + SolutionTypes []string `json:"solutionTypes,omitempty"` + // StartingSchema: The start schema to use for this DataStore when provisioning + // it. If unset, a default vertical specialized schema will be used. This field + // is only used by CreateDataStore API, and will be ignored if used in other + // APIs. This field will be omitted from all API responses including + // CreateDataStore API. To retrieve a schema of a DataStore, use + // SchemaService.GetSchema API instead. The provided schema will be validated + // against certain rules on schema. Learn more from this doc + // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). + StartingSchema *GoogleCloudDiscoveryengineV1Schema `json:"startingSchema,omitempty"` + // WorkspaceConfig: Config to store data store type configuration for workspace + // data. This must be set when DataStore.content_config is set as + // DataStore.ContentConfig.GOOGLE_WORKSPACE. + WorkspaceConfig *GoogleCloudDiscoveryengineV1WorkspaceConfig `json:"workspaceConfig,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "AclEnabled") 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 + // NullFields is a list of field names (e.g. "AclEnabled") 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 GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata +func (s GoogleCloudDiscoveryengineV1DataStore) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataStore return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DeleteSchemaMetadata: Metadata for DeleteSchema -// LRO. -type GoogleCloudDiscoveryengineV1DeleteSchemaMetadata struct { - // CreateTime: Operation create time. - CreateTime string `json:"createTime,omitempty"` - // UpdateTime: Operation last update time. If the operation is done, this is - // also the finish time. - UpdateTime string `json:"updateTime,omitempty"` - // ForceSendFields is a list of field names (e.g. "CreateTime") to +// GoogleCloudDiscoveryengineV1DataStoreBillingEstimation: Estimation of data +// size per data store. +type GoogleCloudDiscoveryengineV1DataStoreBillingEstimation struct { + // StructuredDataSize: Data size for structured data in terms of bytes. + StructuredDataSize int64 `json:"structuredDataSize,omitempty,string"` + // StructuredDataUpdateTime: Last updated timestamp for structured data. + StructuredDataUpdateTime string `json:"structuredDataUpdateTime,omitempty"` + // UnstructuredDataSize: Data size for unstructured data in terms of bytes. + UnstructuredDataSize int64 `json:"unstructuredDataSize,omitempty,string"` + // UnstructuredDataUpdateTime: Last updated timestamp for unstructured data. + UnstructuredDataUpdateTime string `json:"unstructuredDataUpdateTime,omitempty"` + // WebsiteDataSize: Data size for websites in terms of bytes. + WebsiteDataSize int64 `json:"websiteDataSize,omitempty,string"` + // WebsiteDataUpdateTime: Last updated timestamp for websites. + WebsiteDataUpdateTime string `json:"websiteDataUpdateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "StructuredDataSize") 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 is a list of field names (e.g. "StructuredDataSize") 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 GoogleCloudDiscoveryengineV1DataStoreBillingEstimation) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataStoreBillingEstimation + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore: Stores +// information regarding the serving configurations at DataStore level. +type GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore struct { + // DisabledForServing: Optional. If set true, the DataStore will not be + // available for serving search requests. + DisabledForServing bool `json:"disabledForServing,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisabledForServing") 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. "DisabledForServing") 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 GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata: Metadata related to +// the progress of the CmekConfigService.DeleteCmekConfig operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // 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 GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DeleteCollectionMetadata: Metadata related to +// the progress of the CollectionService.UpdateCollection operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteCollectionMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // 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 GoogleCloudDiscoveryengineV1DeleteCollectionMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteCollectionMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata: Metadata related to the +// progress of the DataStoreService.DeleteDataStore operation. This will be +// returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // 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 GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DeleteEngineMetadata: Metadata related to the +// progress of the EngineService.DeleteEngine operation. This will be returned +// by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteEngineMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // 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 GoogleCloudDiscoveryengineV1DeleteEngineMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteEngineMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata: Metadata +// related to the progress of the +// IdentityMappingStoreService.DeleteIdentityMappingStore operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // 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 GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteIdentityMappingStoreMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DeleteSchemaMetadata: Metadata for DeleteSchema +// LRO. +type GoogleCloudDiscoveryengineV1DeleteSchemaMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // 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:"-"` } @@ -7630,6 +8278,63 @@ func (s GoogleCloudDiscoveryengineV1DeleteTargetSiteMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DestinationConfig: Defines target endpoints used +// to connect to third-party sources. +type GoogleCloudDiscoveryengineV1DestinationConfig struct { + // Destinations: Optional. The destinations for the corresponding key. + Destinations []*GoogleCloudDiscoveryengineV1DestinationConfigDestination `json:"destinations,omitempty"` + // JsonParams: Additional parameters for this destination config in json string + // format. + JsonParams string `json:"jsonParams,omitempty"` + // Key: Optional. Unique destination identifier that is supported by the + // connector. + Key string `json:"key,omitempty"` + // Params: Optional. Additional parameters for this destination config in + // structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // ForceSendFields is a list of field names (e.g. "Destinations") 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. "Destinations") 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 GoogleCloudDiscoveryengineV1DestinationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DestinationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DestinationConfigDestination: Defines a target +// endpoint +type GoogleCloudDiscoveryengineV1DestinationConfigDestination struct { + // Host: Publicly routable host. + Host string `json:"host,omitempty"` + // Port: Optional. Target port number accepted by the destination. + Port int64 `json:"port,omitempty"` + // ForceSendFields is a list of field names (e.g. "Host") 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. "Host") 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 GoogleCloudDiscoveryengineV1DestinationConfigDestination) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DestinationConfigDestination + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchMetadata: Metadata // related to the progress of the // SiteSearchEngineService.DisableAdvancedSiteSearch operation. This will be @@ -8220,6 +8925,15 @@ type GoogleCloudDiscoveryengineV1Engine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1EngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1EngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -8241,8 +8955,8 @@ type GoogleCloudDiscoveryengineV1Engine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -9053,6 +9767,38 @@ func (s GoogleCloudDiscoveryengineV1IdentityMappingStore) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1IdentityScheduleConfig: The configuration for +// the identity data synchronization runs. +type GoogleCloudDiscoveryengineV1IdentityScheduleConfig struct { + // NextSyncTime: Optional. The UTC time when the next data sync is expected to + // start for the Data Connector. Customers are only able to specify the hour + // and minute to schedule the data sync. This is utilized when the data + // connector has a refresh interval greater than 1 day. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` + // RefreshInterval: Optional. The refresh interval to sync the Access Control + // List information for the documents ingested by this connector. If not set, + // the access control list will be refreshed at the default interval of 30 + // minutes. The identity refresh interval can be at least 30 minutes and at + // most 7 days. + RefreshInterval string `json:"refreshInterval,omitempty"` + // ForceSendFields is a list of field names (e.g. "NextSyncTime") 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. "NextSyncTime") 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 GoogleCloudDiscoveryengineV1IdentityScheduleConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1IdentityScheduleConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1IdpConfig: Identity Provider Config. type GoogleCloudDiscoveryengineV1IdpConfig struct { // ExternalIdpConfig: External Identity provider config. @@ -10302,6 +11048,8 @@ func (s GoogleCloudDiscoveryengineV1Principal) MarshalJSON() ([]byte, error) { type GoogleCloudDiscoveryengineV1Project struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -10332,7 +11080,86 @@ func (s GoogleCloudDiscoveryengineV1Project) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1ProjectServiceTerms: Metadata about the terms of +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig: Customer provided +// configurations. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig: +// Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigMode +// lArmorConfig: Configuration for customer defined Model Armor templates to be +// used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1ProjectServiceTerms: Metadata about the terms of // service. type GoogleCloudDiscoveryengineV1ProjectServiceTerms struct { // AcceptTime: The last time when the project agreed to the terms of service. @@ -10422,6 +11249,9 @@ type GoogleCloudDiscoveryengineV1ProvisionProjectRequestSaasParams struct { // would like to give consent to the [Terms for Agent Space quality of // service]. AcceptBizQos bool `json:"acceptBizQos,omitempty"` + // IsBiz: Optional. Indicates if the current request is for Biz edition (= + // true) or not (= false). + IsBiz bool `json:"isBiz,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceptBizQos") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -11398,10 +12228,18 @@ type GoogleCloudDiscoveryengineV1SearchRequest struct { // better interpret the query. If a value isn't specified, the query language // code is automatically detected, which may not be accurate. LanguageCode string `json:"languageCode,omitempty"` + // NaturalLanguageQueryUnderstandingSpec: Optional. Config for natural language + // query understanding capabilities, such as extracting structured field + // filters from the query. Refer to this documentation + // (https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) + // for more information. If `naturalLanguageQueryUnderstandingSpec` is not + // specified, no additional natural language query understanding will be done. + NaturalLanguageQueryUnderstandingSpec *GoogleCloudDiscoveryengineV1SearchRequestNaturalLanguageQueryUnderstandingSpec `json:"naturalLanguageQueryUnderstandingSpec,omitempty"` // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as // relevant) in search results. This field is only considered if page_token is - // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. + // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large + // offset may be capped to a reasonable threshold. Offset int64 `json:"offset,omitempty"` // OneBoxPageSize: The maximum number of results to return for OneBox. This // applies to each OneBox type individually. Default number is 10. @@ -12310,6 +13148,72 @@ func (s GoogleCloudDiscoveryengineV1SearchRequestImageQuery) MarshalJSON() ([]by return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1SearchRequestNaturalLanguageQueryUnderstandingSpe +// c: Specification to enable natural language understanding capabilities for +// search requests. +type GoogleCloudDiscoveryengineV1SearchRequestNaturalLanguageQueryUnderstandingSpec struct { + // AllowedFieldNames: Optional. Allowlist of fields that can be used for + // natural language filter extraction. By default, if this is unspecified, all + // indexable fields are eligible for natural language filter extraction (but + // are not guaranteed to be used). If any fields are specified in + // allowed_field_names, only the fields that are both marked as indexable in + // the schema and specified in the allowlist will be eligible for natural + // language filter extraction. Note: for multi-datastore search, this is not + // yet supported, and will be ignored. + AllowedFieldNames []string `json:"allowedFieldNames,omitempty"` + // ExtractedFilterBehavior: Optional. Controls behavior of how extracted + // filters are applied to the search. The default behavior depends on the + // request. For single datastore structured search, the default is + // `HARD_FILTER`. For multi-datastore search, the default behavior is + // `SOFT_BOOST`. Location-based filters are always applied as hard filters, and + // the `SOFT_BOOST` setting will not affect them. This field is only used if + // SearchRequest.natural_language_query_understanding_spec.filter_extraction_con + // dition is set to FilterExtractionCondition.ENABLED. + // + // Possible values: + // "EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED" - + // `EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED` will use the default behavior for + // extracted filters. For single datastore search, the default is to apply as + // hard filters. For multi-datastore search, the default is to apply as soft + // boosts. + // "HARD_FILTER" - Applies all extracted filters as hard filters on the + // results. Results that do not pass the extracted filters will not be returned + // in the result set. + // "SOFT_BOOST" - Applies all extracted filters as soft boosts. Results that + // pass the filters will be boosted up to higher ranks in the result set. + ExtractedFilterBehavior string `json:"extractedFilterBehavior,omitempty"` + // FilterExtractionCondition: The condition under which filter extraction + // should occur. Server behavior defaults to `DISABLED`. + // + // Possible values: + // "CONDITION_UNSPECIFIED" - Server behavior defaults to `DISABLED`. + // "DISABLED" - Disables NL filter extraction. + // "ENABLED" - Enables NL filter extraction. + FilterExtractionCondition string `json:"filterExtractionCondition,omitempty"` + // GeoSearchQueryDetectionFieldNames: Field names used for location-based + // filtering, where geolocation filters are detected in natural language search + // queries. Only valid when the FilterExtractionCondition is set to `ENABLED`. + // If this field is set, it overrides the field names set in + // ServingConfig.geo_search_query_detection_field_names. + GeoSearchQueryDetectionFieldNames []string `json:"geoSearchQueryDetectionFieldNames,omitempty"` + // ForceSendFields is a list of field names (e.g. "AllowedFieldNames") 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. "AllowedFieldNames") 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 GoogleCloudDiscoveryengineV1SearchRequestNaturalLanguageQueryUnderstandingSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1SearchRequestNaturalLanguageQueryUnderstandingSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1SearchRequestQueryExpansionSpec: Specification // to determine under which conditions query expansion should occur. type GoogleCloudDiscoveryengineV1SearchRequestQueryExpansionSpec struct { @@ -13355,6 +14259,47 @@ func (s GoogleCloudDiscoveryengineV1SessionTurn) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata: Metadata for +// DataConnectorService.SetUpDataConnector method. +type GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata struct { +} + +// GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest: Request for +// DataConnectorService.SetUpDataConnector method. +type GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest struct { + // CollectionDisplayName: Required. The display name of the Collection. Should + // be human readable, used to display collections in the Console Dashboard. + // UTF-8 encoded string with limit of 1024 characters. + CollectionDisplayName string `json:"collectionDisplayName,omitempty"` + // CollectionId: Required. The ID to use for the Collection, which will become + // the final component of the Collection's resource name. A new Collection is + // created as part of the DataConnector setup. DataConnector is a singleton + // resource under Collection, managing all DataStores of the Collection. This + // field must conform to RFC-1034 (https://tools.ietf.org/html/rfc1034) + // standard with a length limit of 63 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. + CollectionId string `json:"collectionId,omitempty"` + // DataConnector: Required. The DataConnector to initialize in the newly + // created Collection. + DataConnector *GoogleCloudDiscoveryengineV1DataConnector `json:"dataConnector,omitempty"` + // ForceSendFields is a list of field names (e.g. "CollectionDisplayName") 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. "CollectionDisplayName") 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 GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1SingleRegionKey: Metadata for single-regional // CMEKs. type GoogleCloudDiscoveryengineV1SingleRegionKey struct { @@ -13877,6 +14822,38 @@ func (s GoogleCloudDiscoveryengineV1TargetSiteFailureReasonQuotaFailure) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1Tenant: Tenant information for a connector +// source. This includes some of the same information stored in the Credential +// message, but is limited to only what is needed to provide a list of +// accessible tenants to the user. +type GoogleCloudDiscoveryengineV1Tenant struct { + // DisplayName: Optional display name for the tenant, e.g. "My Slack Team". + DisplayName string `json:"displayName,omitempty"` + // Id: The tenant's instance ID. Examples: Jira + // ("8594f221-9797-5f78-1fa4-485e198d7cd0"), Slack ("T123456"). + Id string `json:"id,omitempty"` + // Uri: The URI of the tenant, if applicable. For example, the URI of a Jira + // instance is https://my-jira-instance.atlassian.net, and a Slack tenant does + // not have a URI. + Uri string `json:"uri,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 GoogleCloudDiscoveryengineV1Tenant) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1Tenant + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1TextInput: Defines text input. type GoogleCloudDiscoveryengineV1TextInput struct { // Context: Conversation context of the input. @@ -14519,17 +15496,13 @@ func (s GoogleCloudDiscoveryengineV1alphaAclConfig) MarshalJSON() ([]byte, error // GoogleCloudDiscoveryengineV1alphaActionConfig: Informations to support // actions on the connector. type GoogleCloudDiscoveryengineV1alphaActionConfig struct { - // ActionParams: Required. Params needed to support actions in the format of - // (Key, Value) pairs. Required parameters for sources that support OAUTH, i.e. - // `gmail`, `google_calendar`, `jira`, `workday`, `salesforce`, `confluence`: * - // Key: `client_id` * Value: type STRING. The client ID for the service - // provider to identify your application. * Key: `client_secret` * Value:type - // STRING. The client secret generated by the application's authorization - // server. + // ActionParams: Optional. Action parameters in structured json format. ActionParams googleapi.RawMessage `json:"actionParams,omitempty"` // IsActionConfigured: Output only. The connector contains the necessary // parameters and is configured to support actions. IsActionConfigured bool `json:"isActionConfigured,omitempty"` + // JsonActionParams: Optional. Action parameters in json string format. + JsonActionParams string `json:"jsonActionParams,omitempty"` // ServiceName: Optional. The Service Directory resource name // (projects/*/locations/*/namespaces/*/services/*) representing a VPC network // endpoint used to connect to the data source's `instance_uri`, defined in @@ -15393,6 +16366,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerStepActionSearchAction) MarshalJS // GoogleCloudDiscoveryengineV1alphaBAPConfig: The configuration for the BAP // connector. type GoogleCloudDiscoveryengineV1alphaBAPConfig struct { + // EnabledActions: Optional. The actions enabled on the associated BAP + // connection. + EnabledActions []string `json:"enabledActions,omitempty"` // SupportedConnectorModes: Required. The supported connector modes for the // associated BAP connection. // @@ -15403,15 +16379,15 @@ type GoogleCloudDiscoveryengineV1alphaBAPConfig struct { // "END_USER_AUTHENTICATION" - Connector utilized for End User // Authentication. SupportedConnectorModes []string `json:"supportedConnectorModes,omitempty"` - // ForceSendFields is a list of field names (e.g. "SupportedConnectorModes") to + // ForceSendFields is a list of field names (e.g. "EnabledActions") 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. "SupportedConnectorModes") 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. "EnabledActions") 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:"-"` } @@ -16572,6 +17548,8 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // same value as the incremental refresh interval, incremental sync will be // disabled, i.e. set to true. IncrementalSyncDisabled bool `json:"incrementalSyncDisabled,omitempty"` + // JsonParams: Required data connector parameters in json string format. + JsonParams string `json:"jsonParams,omitempty"` // KmsKeyName: Input only. The KMS key to be used to protect the DataStores // managed by this connector. Must be set for requests that need to comply with // CMEK Org Policy protections. If this field is set and processed @@ -16598,28 +17576,7 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // minutes are not specified, we will assume a sync time of 0:00. The user must // provide a time zone to avoid ambiguity. NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` - // Params: Required. Params needed to access the source in the format of (Key, - // Value) pairs. Required parameters for all data sources: * Key: - // `instance_uri` * Value: type STRING. The uri to access the data source. - // Required parameters for sources that support OAUTH, i.e. `salesforce`: * - // Key: `client_id` * Value: type STRING. The client ID for the third party - // service provider to identify your application. * Key: `client_secret` * - // Value:type STRING. The client secret generated by the third party - // authorization server. * Key: `access_token` * Value: type STRING. OAuth - // token for UCS to access to the protected resource. * Key: `refresh_token` * - // Value: type STRING. OAuth refresh token for UCS to obtain a new access token - // without user interaction. Required parameters for sources that support basic - // API token auth, i.e. `jira`, `confluence`: * Key: `user_account` * Value: - // type STRING. The username or email with the source. * Key: `api_token` * - // Value: type STRING. The API token generated for the source account, that is - // used for authenticating anywhere where you would have used a password. - // Example: ```json { "instance_uri": "https://xxx.atlassian.net", - // "user_account": "xxxx.xxx@xxx.com", "api_token": "test-token" } ``` Optional - // parameter to specify the authorization type to use for multiple - // authorization types support: * Key: `auth_type` * Value: type STRING. The - // authorization type for the data source. Supported values: `BASIC_AUTH`, - // `OAUTH`, `OAUTH_ACCESS_TOKEN`, `OAUTH_TWO_LEGGED`, `OAUTH_JWT_BEARER`, - // `OAUTH_PASSWORD_GRANT`, `JWT`, `API_TOKEN`, `FEDERATED_CREDENTIAL`. + // Params: Required data connector parameters in structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // PrivateConnectivityProjectId: Output only. The tenant project ID associated // with private connectivity connectors. This project must be allowlisted by in @@ -16721,6 +17678,9 @@ type GoogleCloudDiscoveryengineV1alphaDataConnectorEndUserConfig struct { // AuthParams: Optional. Any authentication parameters specific to EUA // connectors. AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to EUA + // connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` // Tenant: Optional. The tenant project the connector is connected to. Tenant *GoogleCloudDiscoveryengineV1alphaTenant `json:"tenant,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalParams") to @@ -16747,8 +17707,12 @@ func (s GoogleCloudDiscoveryengineV1alphaDataConnectorEndUserConfig) MarshalJSON type GoogleCloudDiscoveryengineV1alphaDataConnectorFederatedConfig struct { // AdditionalParams: Optional. Any additional parameters needed for FEDERATED. AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` - // AuthParams: Optional. Any authentication parameters specific to FEDERATED. + // AuthParams: Optional. Any authentication parameters specific to FEDERATED + // connectors. AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to + // FEDERATED connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalParams") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -16847,15 +17811,17 @@ type GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity struct { // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` // vertical. HealthcareFhirConfig *GoogleCloudDiscoveryengineV1alphaHealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` + // JsonParams: The parameters for the entity to facilitate data ingestion in + // json string format. + JsonParams string `json:"jsonParams,omitempty"` // KeyPropertyMappings: Attributes for indexing. Key: Field name. Value: The // key property to map a field to, such as `title`, and `description`. // Supported key properties: * `title`: The title for data record. This would // be displayed on search results. * `description`: The description for data // record. This would be displayed on search results. KeyPropertyMappings map[string]string `json:"keyPropertyMappings,omitempty"` - // Params: The parameters for the entity to facilitate data ingestion. E.g. for - // BigQuery connectors: * Key: `document_id_column` * Value: type STRING. The - // value of the column ID. + // Params: The parameters for the entity to facilitate data ingestion in + // structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // StartingSchema: Optional. The start schema to use for the DataStore created // from this SourceEntity. If unset, a default vertical specialized schema will @@ -16901,6 +17867,18 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { BillingEstimation *GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // CmekConfig: Output only. CMEK-related information for the DataStore. CmekConfig *GoogleCloudDiscoveryengineV1alphaCmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -17356,10 +18334,14 @@ func (s GoogleCloudDiscoveryengineV1alphaDeleteTargetSiteMetadata) MarshalJSON() type GoogleCloudDiscoveryengineV1alphaDestinationConfig struct { // Destinations: Optional. The destinations for the corresponding key. Destinations []*GoogleCloudDiscoveryengineV1alphaDestinationConfigDestination `json:"destinations,omitempty"` + // JsonParams: Additional parameters for this destination config in json string + // format. + JsonParams string `json:"jsonParams,omitempty"` // Key: Optional. Unique destination identifier that is supported by the // connector. Key string `json:"key,omitempty"` - // Params: Optional. Additional parameters for this destination config. + // Params: Optional. Additional parameters for this destination config in + // structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // ForceSendFields is a list of field names (e.g. "Destinations") to // unconditionally include in API requests. By default, fields with empty or @@ -17688,6 +18670,15 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1alphaEngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1alphaEngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -17709,8 +18700,8 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -19361,6 +20352,8 @@ func (s GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries) MarshalJSON type GoogleCloudDiscoveryengineV1alphaProject struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -19391,6 +20384,85 @@ func (s GoogleCloudDiscoveryengineV1alphaProject) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig: Customer +// provided configurations. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfi +// g: Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfi +// gModelArmorConfig: Configuration for customer defined Model Armor templates +// to be used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaProjectServiceTerms: Metadata about the // terms of service. type GoogleCloudDiscoveryengineV1alphaProjectServiceTerms struct { @@ -20205,9 +21277,9 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // better interpret the query. If a value isn't specified, the query language // code is automatically detected, which may not be accurate. LanguageCode string `json:"languageCode,omitempty"` - // NaturalLanguageQueryUnderstandingSpec: Config for natural language query - // understanding capabilities, such as extracting structured field filters from - // the query. Refer to this documentation + // NaturalLanguageQueryUnderstandingSpec: Optional. Config for natural language + // query understanding capabilities, such as extracting structured field + // filters from the query. Refer to this documentation // (https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) // for more information. If `naturalLanguageQueryUnderstandingSpec` is not // specified, no additional natural language query understanding will be done. @@ -20215,7 +21287,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as // relevant) in search results. This field is only considered if page_token is - // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. + // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large + // offset may be capped to a reasonable threshold. Offset int64 `json:"offset,omitempty"` // OneBoxPageSize: The maximum number of results to return for OneBox. This // applies to each OneBox type individually. Default number is 10. @@ -20357,6 +21430,10 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` + // SearchAddonSpec: Optional. SearchAddonSpec is used to disable add-ons for + // search as per new repricing model. This field is only supported for search + // requests. + SearchAddonSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec `json:"searchAddonSpec,omitempty"` // SearchAsYouTypeSpec: Search as you type configuration. Only supported for // the IndustryVertical.MEDIA vertical. SearchAsYouTypeSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec `json:"searchAsYouTypeSpec,omitempty"` @@ -21254,6 +22331,15 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestImageQuery) MarshalJSON() // ngSpec: Specification to enable natural language understanding capabilities // for search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { + // AllowedFieldNames: Optional. Allowlist of fields that can be used for + // natural language filter extraction. By default, if this is unspecified, all + // indexable fields are eligible for natural language filter extraction (but + // are not guaranteed to be used). If any fields are specified in + // allowed_field_names, only the fields that are both marked as indexable in + // the schema and specified in the allowlist will be eligible for natural + // language filter extraction. Note: for multi-datastore search, this is not + // yet supported, and will be ignored. + AllowedFieldNames []string `json:"allowedFieldNames,omitempty"` // ExtractedFilterBehavior: Optional. Controls behavior of how extracted // filters are applied to the search. The default behavior depends on the // request. For single datastore structured search, the default is @@ -21289,15 +22375,15 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstan // If this field is set, it overrides the field names set in // ServingConfig.geo_search_query_detection_field_names. GeoSearchQueryDetectionFieldNames []string `json:"geoSearchQueryDetectionFieldNames,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExtractedFilterBehavior") to + // ForceSendFields is a list of field names (e.g. "AllowedFieldNames") 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. "ExtractedFilterBehavior") 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. "AllowedFieldNames") 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:"-"` } @@ -21397,6 +22483,39 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceScoreSpec) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec: +// SearchAddonSpec is used to disable add-ons for search as per new repricing +// model. By default if the SearchAddonSpec is not specified, we consider that +// the customer wants to enable them wherever applicable. +type GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec struct { + // DisableGenerativeAnswerAddOn: Optional. If true, generative answer add-on is + // disabled. Generative answer add-on includes natural language to filters and + // simple answers. + DisableGenerativeAnswerAddOn bool `json:"disableGenerativeAnswerAddOn,omitempty"` + // DisableKpiPersonalizationAddOn: Optional. If true, disables event re-ranking + // and personalization to optimize KPIs & personalize results. + DisableKpiPersonalizationAddOn bool `json:"disableKpiPersonalizationAddOn,omitempty"` + // DisableSemanticAddOn: Optional. If true, semantic add-on is disabled. + // Semantic add-on includes embeddings and jetstream. + DisableSemanticAddOn bool `json:"disableSemanticAddOn,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DisableGenerativeAnswerAddOn") 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. "DisableGenerativeAnswerAddOn") 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 GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec: // Specification for search as you type in search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec struct { @@ -23116,6 +24235,18 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { BillingEstimation *GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // CmekConfig: Output only. CMEK-related information for the DataStore. CmekConfig *GoogleCloudDiscoveryengineV1betaCmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -23768,6 +24899,15 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1betaEngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1betaEngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -23789,8 +24929,8 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -24959,6 +26099,8 @@ func (s GoogleCloudDiscoveryengineV1betaOrganicCrawlRateTimeSeries) MarshalJSON( type GoogleCloudDiscoveryengineV1betaProject struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -24989,43 +26131,122 @@ func (s GoogleCloudDiscoveryengineV1betaProject) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1betaProjectServiceTerms: Metadata about the -// terms of service. -type GoogleCloudDiscoveryengineV1betaProjectServiceTerms struct { - // AcceptTime: The last time when the project agreed to the terms of service. - AcceptTime string `json:"acceptTime,omitempty"` - // DeclineTime: The last time when the project declined or revoked the - // agreement to terms of service. - DeclineTime string `json:"declineTime,omitempty"` - // Id: The unique identifier of this terms of service. Available terms: * - // `GA_DATA_USE_TERMS`: Terms for data use - // (https://cloud.google.com/retail/data-use-terms). When using this as `id`, - // the acceptable version to provide is `2022-11-23`. - Id string `json:"id,omitempty"` - // State: Whether the project has accepted/rejected the service terms or it is - // still pending. - // - // Possible values: - // "STATE_UNSPECIFIED" - The default value of the enum. This value is not - // actually used. - // "TERMS_ACCEPTED" - The project has given consent to the terms of service. - // "TERMS_PENDING" - The project is pending to review and accept the terms of - // service. - // "TERMS_DECLINED" - The project has declined or revoked the agreement to - // terms of service. - State string `json:"state,omitempty"` - // Version: The version string of the terms of service. For acceptable values, - // see the comments for id above. - Version string `json:"version,omitempty"` - // ForceSendFields is a list of field names (e.g. "AcceptTime") to +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig: Customer +// provided configurations. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "AcceptTime") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig +// : Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig +// ModelArmorConfig: Configuration for customer defined Model Armor templates +// to be used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaProjectServiceTerms: Metadata about the +// terms of service. +type GoogleCloudDiscoveryengineV1betaProjectServiceTerms struct { + // AcceptTime: The last time when the project agreed to the terms of service. + AcceptTime string `json:"acceptTime,omitempty"` + // DeclineTime: The last time when the project declined or revoked the + // agreement to terms of service. + DeclineTime string `json:"declineTime,omitempty"` + // Id: The unique identifier of this terms of service. Available terms: * + // `GA_DATA_USE_TERMS`: Terms for data use + // (https://cloud.google.com/retail/data-use-terms). When using this as `id`, + // the acceptable version to provide is `2022-11-23`. + Id string `json:"id,omitempty"` + // State: Whether the project has accepted/rejected the service terms or it is + // still pending. + // + // Possible values: + // "STATE_UNSPECIFIED" - The default value of the enum. This value is not + // actually used. + // "TERMS_ACCEPTED" - The project has given consent to the terms of service. + // "TERMS_PENDING" - The project is pending to review and accept the terms of + // service. + // "TERMS_DECLINED" - The project has declined or revoked the agreement to + // terms of service. + State string `json:"state,omitempty"` + // Version: The version string of the terms of service. For acceptable values, + // see the comments for id above. + Version string `json:"version,omitempty"` + // ForceSendFields is a list of field names (e.g. "AcceptTime") 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. "AcceptTime") 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:"-"` } @@ -25452,9 +26673,9 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // better interpret the query. If a value isn't specified, the query language // code is automatically detected, which may not be accurate. LanguageCode string `json:"languageCode,omitempty"` - // NaturalLanguageQueryUnderstandingSpec: Config for natural language query - // understanding capabilities, such as extracting structured field filters from - // the query. Refer to this documentation + // NaturalLanguageQueryUnderstandingSpec: Optional. Config for natural language + // query understanding capabilities, such as extracting structured field + // filters from the query. Refer to this documentation // (https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) // for more information. If `naturalLanguageQueryUnderstandingSpec` is not // specified, no additional natural language query understanding will be done. @@ -25462,7 +26683,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as // relevant) in search results. This field is only considered if page_token is - // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. + // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large + // offset may be capped to a reasonable threshold. Offset int64 `json:"offset,omitempty"` // OneBoxPageSize: The maximum number of results to return for OneBox. This // applies to each OneBox type individually. Default number is 10. @@ -25604,6 +26826,10 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` + // SearchAddonSpec: Optional. SearchAddonSpec is used to disable add-ons for + // search as per new repricing model. This field is only supported for search + // requests. + SearchAddonSpec *GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec `json:"searchAddonSpec,omitempty"` // SearchAsYouTypeSpec: Search as you type configuration. Only supported for // the IndustryVertical.MEDIA vertical. SearchAsYouTypeSpec *GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec `json:"searchAsYouTypeSpec,omitempty"` @@ -26496,6 +27722,15 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestImageQuery) MarshalJSON() ( // gSpec: Specification to enable natural language understanding capabilities // for search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { + // AllowedFieldNames: Optional. Allowlist of fields that can be used for + // natural language filter extraction. By default, if this is unspecified, all + // indexable fields are eligible for natural language filter extraction (but + // are not guaranteed to be used). If any fields are specified in + // allowed_field_names, only the fields that are both marked as indexable in + // the schema and specified in the allowlist will be eligible for natural + // language filter extraction. Note: for multi-datastore search, this is not + // yet supported, and will be ignored. + AllowedFieldNames []string `json:"allowedFieldNames,omitempty"` // ExtractedFilterBehavior: Optional. Controls behavior of how extracted // filters are applied to the search. The default behavior depends on the // request. For single datastore structured search, the default is @@ -26531,15 +27766,15 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstand // If this field is set, it overrides the field names set in // ServingConfig.geo_search_query_detection_field_names. GeoSearchQueryDetectionFieldNames []string `json:"geoSearchQueryDetectionFieldNames,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExtractedFilterBehavior") to + // ForceSendFields is a list of field names (e.g. "AllowedFieldNames") 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. "ExtractedFilterBehavior") 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. "AllowedFieldNames") 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:"-"` } @@ -26639,6 +27874,39 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceScoreSpec) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec: +// SearchAddonSpec is used to disable add-ons for search as per new repricing +// model. By default if the SearchAddonSpec is not specified, we consider that +// the customer wants to enable them wherever applicable. +type GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec struct { + // DisableGenerativeAnswerAddOn: Optional. If true, generative answer add-on is + // disabled. Generative answer add-on includes natural language to filters and + // simple answers. + DisableGenerativeAnswerAddOn bool `json:"disableGenerativeAnswerAddOn,omitempty"` + // DisableKpiPersonalizationAddOn: Optional. If true, disables event re-ranking + // and personalization to optimize KPIs & personalize results. + DisableKpiPersonalizationAddOn bool `json:"disableKpiPersonalizationAddOn,omitempty"` + // DisableSemanticAddOn: Optional. If true, semantic add-on is disabled. + // Semantic add-on includes embeddings and jetstream. + DisableSemanticAddOn bool `json:"disableSemanticAddOn,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DisableGenerativeAnswerAddOn") 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. "DisableGenerativeAnswerAddOn") 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 GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec: // Specification for search as you type in search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec struct { @@ -27778,44 +29046,737 @@ func (c *MediaDownloadCall) ViewId(viewId string) *MediaDownloadCall { // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *MediaDownloadCall) Fields(s ...googleapi.Field) *MediaDownloadCall { +func (c *MediaDownloadCall) Fields(s ...googleapi.Field) *MediaDownloadCall { + 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 *MediaDownloadCall) IfNoneMatch(entityTag string) *MediaDownloadCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do and Download methods. +func (c *MediaDownloadCall) Context(ctx context.Context) *MediaDownloadCall { + 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 *MediaDownloadCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *MediaDownloadCall) 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}:downloadFile") + 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.media.download", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Download fetches the API endpoint's "media" value, instead of the normal +// API response value. If the returned error is nil, the Response is guaranteed to +// have a 2xx status code. Callers must close the Response.Body as usual. +func (c *MediaDownloadCall) Download(opts ...googleapi.CallOption) (*http.Response, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("media") + if err != nil { + return nil, err + } + if err := googleapi.CheckResponse(res); err != nil { + res.Body.Close() + return nil, gensupport.WrapError(err) + } + return res, nil +} + +// Do executes the "discoveryengine.media.download" call. +// Any non-2xx status code is an error. Response headers are in either +// *GdataMedia.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 *MediaDownloadCall) Do(opts ...googleapi.CallOption) (*GdataMedia, 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 := &GdataMedia{ + 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.media.download", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsProvisionCall struct { + s *Service + name string + googleclouddiscoveryenginev1provisionprojectrequest *GoogleCloudDiscoveryengineV1ProvisionProjectRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Provision: Provisions the project resource. During the process, related +// systems will get prepared and initialized. Caller must read the Terms for +// data use (https://cloud.google.com/retail/data-use-terms), and optionally +// specify in request to provide consent to that service terms. +// +// - name: Full resource name of a Project, such as +// `projects/{project_id_or_number}`. +func (r *ProjectsService) Provision(name string, googleclouddiscoveryenginev1provisionprojectrequest *GoogleCloudDiscoveryengineV1ProvisionProjectRequest) *ProjectsProvisionCall { + c := &ProjectsProvisionCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1provisionprojectrequest = googleclouddiscoveryenginev1provisionprojectrequest + 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 *ProjectsProvisionCall) Fields(s ...googleapi.Field) *ProjectsProvisionCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsProvisionCall) Context(ctx context.Context) *ProjectsProvisionCall { + 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 *ProjectsProvisionCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsProvisionCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1provisionprojectrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:provision") + 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", "discoveryengine.projects.provision", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.provision" 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 *ProjectsProvisionCall) 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.provision", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGetAclConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetAclConfig: Gets the AclConfig. +// +// - name: Resource name of AclConfig, such as +// `projects/*/locations/*/aclConfig`. If the caller does not have permission +// to access the AclConfig, regardless of whether or not it exists, a +// PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsService) GetAclConfig(name string) *ProjectsLocationsGetAclConfigCall { + c := &ProjectsLocationsGetAclConfigCall{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 *ProjectsLocationsGetAclConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetAclConfigCall { + 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 *ProjectsLocationsGetAclConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetAclConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGetAclConfigCall) Context(ctx context.Context) *ProjectsLocationsGetAclConfigCall { + 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 *ProjectsLocationsGetAclConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetAclConfigCall) 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.getAclConfig", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.getAclConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1AclConfig.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 *ProjectsLocationsGetAclConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AclConfig, 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 := &GoogleCloudDiscoveryengineV1AclConfig{ + 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.getAclConfig", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsGetCmekConfigCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetCmekConfig: Gets the CmekConfig. +// +// - name: Resource name of CmekConfig, such as +// `projects/*/locations/*/cmekConfig` or +// `projects/*/locations/*/cmekConfigs/*`. If the caller does not have +// permission to access the CmekConfig, regardless of whether or not it +// exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsService) GetCmekConfig(name string) *ProjectsLocationsGetCmekConfigCall { + c := &ProjectsLocationsGetCmekConfigCall{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 *ProjectsLocationsGetCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCmekConfigCall { + 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 *ProjectsLocationsGetCmekConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCmekConfigCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGetCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsGetCmekConfigCall { + 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 *ProjectsLocationsGetCmekConfigCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCmekConfigCall) 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.getCmekConfig", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.getCmekConfig" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1CmekConfig.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 *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CmekConfig, 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 := &GoogleCloudDiscoveryengineV1CmekConfig{ + 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.getCmekConfig", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsSetUpDataConnectorCall struct { + s *Service + parent string + googleclouddiscoveryenginev1setupdataconnectorrequest *GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetUpDataConnector: Creates a Collection and sets up the DataConnector for +// it. To stop a DataConnector after setup, use the +// CollectionService.DeleteCollection method. +// +// - parent: The parent of Collection, in the format of +// `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) SetUpDataConnector(parent string, googleclouddiscoveryenginev1setupdataconnectorrequest *GoogleCloudDiscoveryengineV1SetUpDataConnectorRequest) *ProjectsLocationsSetUpDataConnectorCall { + c := &ProjectsLocationsSetUpDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1setupdataconnectorrequest = googleclouddiscoveryenginev1setupdataconnectorrequest + 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 *ProjectsLocationsSetUpDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsSetUpDataConnectorCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSetUpDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsSetUpDataConnectorCall { + 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 *ProjectsLocationsSetUpDataConnectorCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSetUpDataConnectorCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1setupdataconnectorrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:setUpDataConnector") + 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", "discoveryengine.projects.locations.setUpDataConnector", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.setUpDataConnector" 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 *ProjectsLocationsSetUpDataConnectorCall) 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.setUpDataConnector", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsSetUpDataConnectorV2Call struct { + s *Service + parent string + googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetUpDataConnectorV2: Creates a Collection and sets up the DataConnector for +// it. To stop a DataConnector after setup, use the +// CollectionService.DeleteCollection method. +// +// - parent: The parent of Collection, in the format of +// `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) SetUpDataConnectorV2(parent string, googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector) *ProjectsLocationsSetUpDataConnectorV2Call { + c := &ProjectsLocationsSetUpDataConnectorV2Call{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1dataconnector = googleclouddiscoveryenginev1dataconnector + return c +} + +// CollectionDisplayName sets the optional parameter "collectionDisplayName": +// Required. The display name of the Collection. Should be human readable, used +// to display collections in the Console Dashboard. UTF-8 encoded string with +// limit of 1024 characters. +func (c *ProjectsLocationsSetUpDataConnectorV2Call) CollectionDisplayName(collectionDisplayName string) *ProjectsLocationsSetUpDataConnectorV2Call { + c.urlParams_.Set("collectionDisplayName", collectionDisplayName) + return c +} + +// CollectionId sets the optional parameter "collectionId": Required. The ID to +// use for the Collection, which will become the final component of the +// Collection's resource name. A new Collection is created as part of the +// DataConnector setup. DataConnector is a singleton resource under Collection, +// managing all DataStores of the Collection. This field must conform to +// RFC-1034 (https://tools.ietf.org/html/rfc1034) standard with a length limit +// of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned. +func (c *ProjectsLocationsSetUpDataConnectorV2Call) CollectionId(collectionId string) *ProjectsLocationsSetUpDataConnectorV2Call { + c.urlParams_.Set("collectionId", collectionId) + 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 *ProjectsLocationsSetUpDataConnectorV2Call) Fields(s ...googleapi.Field) *ProjectsLocationsSetUpDataConnectorV2Call { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSetUpDataConnectorV2Call) Context(ctx context.Context) *ProjectsLocationsSetUpDataConnectorV2Call { + 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 *ProjectsLocationsSetUpDataConnectorV2Call) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSetUpDataConnectorV2Call) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1dataconnector) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:setUpDataConnectorV2") + 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", "discoveryengine.projects.locations.setUpDataConnectorV2", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.setUpDataConnectorV2" 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 *ProjectsLocationsSetUpDataConnectorV2Call) 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.setUpDataConnectorV2", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsUpdateAclConfigCall struct { + s *Service + name string + googleclouddiscoveryenginev1aclconfig *GoogleCloudDiscoveryengineV1AclConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// UpdateAclConfig: Default ACL configuration for use in a location of a +// customer's project. Updates will only reflect to new data stores. Existing +// data stores will still use the old value. +// +// - name: Immutable. The full resource name of the acl configuration. Format: +// `projects/{project}/locations/{location}/aclConfig`. This field must be a +// UTF-8 encoded string with a length limit of 1024 characters. +func (r *ProjectsLocationsService) UpdateAclConfig(name string, googleclouddiscoveryenginev1aclconfig *GoogleCloudDiscoveryengineV1AclConfig) *ProjectsLocationsUpdateAclConfigCall { + c := &ProjectsLocationsUpdateAclConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1aclconfig = googleclouddiscoveryenginev1aclconfig + 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 *ProjectsLocationsUpdateAclConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateAclConfigCall { 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 *MediaDownloadCall) IfNoneMatch(entityTag string) *MediaDownloadCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do and Download methods. -func (c *MediaDownloadCall) Context(ctx context.Context) *MediaDownloadCall { +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsUpdateAclConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateAclConfigCall { 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 *MediaDownloadCall) Header() http.Header { +func (c *ProjectsLocationsUpdateAclConfigCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *MediaDownloadCall) 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 *ProjectsLocationsUpdateAclConfigCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1aclconfig) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:downloadFile") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -27823,32 +29784,17 @@ func (c *MediaDownloadCall) doRequest(alt string) (*http.Response, error) { googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.media.download", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateAclConfig", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Download fetches the API endpoint's "media" value, instead of the normal -// API response value. If the returned error is nil, the Response is guaranteed to -// have a 2xx status code. Callers must close the Response.Body as usual. -func (c *MediaDownloadCall) Download(opts ...googleapi.CallOption) (*http.Response, error) { - gensupport.SetOptions(c.urlParams_, opts...) - res, err := c.doRequest("media") - if err != nil { - return nil, err - } - if err := googleapi.CheckResponse(res); err != nil { - res.Body.Close() - return nil, gensupport.WrapError(err) - } - return res, nil -} - -// Do executes the "discoveryengine.media.download" call. +// Do executes the "discoveryengine.projects.locations.updateAclConfig" call. // Any non-2xx status code is an error. Response headers are in either -// *GdataMedia.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 *MediaDownloadCall) Do(opts ...googleapi.CallOption) (*GdataMedia, error) { +// *GoogleCloudDiscoveryengineV1AclConfig.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 *ProjectsLocationsUpdateAclConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AclConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -27867,7 +29813,7 @@ func (c *MediaDownloadCall) Do(opts ...googleapi.CallOption) (*GdataMedia, error if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GdataMedia{ + ret := &GoogleCloudDiscoveryengineV1AclConfig{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -27878,67 +29824,76 @@ func (c *MediaDownloadCall) Do(opts ...googleapi.CallOption) (*GdataMedia, error if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.media.download", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateAclConfig", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsProvisionCall struct { - s *Service - name string - googleclouddiscoveryenginev1provisionprojectrequest *GoogleCloudDiscoveryengineV1ProvisionProjectRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsUpdateCmekConfigCall struct { + s *Service + name string + googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Provision: Provisions the project resource. During the process, related -// systems will get prepared and initialized. Caller must read the Terms for -// data use (https://cloud.google.com/retail/data-use-terms), and optionally -// specify in request to provide consent to that service terms. +// UpdateCmekConfig: Provisions a CMEK key for use in a location of a +// customer's project. This method will also conduct location validation on the +// provided cmekConfig to make sure the key is valid and can be used in the +// selected location. // -// - name: Full resource name of a Project, such as -// `projects/{project_id_or_number}`. -func (r *ProjectsService) Provision(name string, googleclouddiscoveryenginev1provisionprojectrequest *GoogleCloudDiscoveryengineV1ProvisionProjectRequest) *ProjectsProvisionCall { - c := &ProjectsProvisionCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The name of the CmekConfig of the form +// `projects/{project}/locations/{location}/cmekConfig` or +// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. +func (r *ProjectsLocationsService) UpdateCmekConfig(name string, googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { + c := &ProjectsLocationsUpdateCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1provisionprojectrequest = googleclouddiscoveryenginev1provisionprojectrequest + c.googleclouddiscoveryenginev1cmekconfig = googleclouddiscoveryenginev1cmekconfig + return c +} + +// SetDefault sets the optional parameter "setDefault": Set the following +// CmekConfig as the default to be used for child resources if one is not +// specified. +func (c *ProjectsLocationsUpdateCmekConfigCall) SetDefault(setDefault bool) *ProjectsLocationsUpdateCmekConfigCall { + c.urlParams_.Set("setDefault", fmt.Sprint(setDefault)) 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 *ProjectsProvisionCall) Fields(s ...googleapi.Field) *ProjectsProvisionCall { +func (c *ProjectsLocationsUpdateCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateCmekConfigCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsProvisionCall) Context(ctx context.Context) *ProjectsProvisionCall { +func (c *ProjectsLocationsUpdateCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateCmekConfigCall { 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 *ProjectsProvisionCall) Header() http.Header { +func (c *ProjectsLocationsUpdateCmekConfigCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsProvisionCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1provisionprojectrequest) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1cmekconfig) if err != nil { return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:provision") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("POST", urls, body) + req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } @@ -27946,17 +29901,17 @@ func (c *ProjectsProvisionCall) doRequest(alt string) (*http.Response, error) { googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.provision", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateCmekConfig", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.provision" call. +// Do executes the "discoveryengine.projects.locations.updateCmekConfig" 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 *ProjectsProvisionCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -27986,27 +29941,24 @@ func (c *ProjectsProvisionCall) Do(opts ...googleapi.CallOption) (*GoogleLongrun if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.provision", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateCmekConfig", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsGetAclConfigCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCmekConfigsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// GetAclConfig: Gets the AclConfig. +// Delete: De-provisions a CmekConfig. // -// - name: Resource name of AclConfig, such as -// `projects/*/locations/*/aclConfig`. If the caller does not have permission -// to access the AclConfig, regardless of whether or not it exists, a -// PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsService) GetAclConfig(name string) *ProjectsLocationsGetAclConfigCall { - c := &ProjectsLocationsGetAclConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The resource name of the CmekConfig to delete, such as +// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. +func (r *ProjectsLocationsCmekConfigsService) Delete(name string) *ProjectsLocationsCmekConfigsDeleteCall { + c := &ProjectsLocationsCmekConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -28014,44 +29966,33 @@ func (r *ProjectsLocationsService) GetAclConfig(name string) *ProjectsLocationsG // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsGetAclConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetAclConfigCall { +func (c *ProjectsLocationsCmekConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsDeleteCall { 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 *ProjectsLocationsGetAclConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetAclConfigCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGetAclConfigCall) Context(ctx context.Context) *ProjectsLocationsGetAclConfigCall { +func (c *ProjectsLocationsCmekConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsDeleteCall { 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 *ProjectsLocationsGetAclConfigCall) Header() http.Header { +func (c *ProjectsLocationsCmekConfigsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGetAclConfigCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCmekConfigsDeleteCall) 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) + req, err := http.NewRequest("DELETE", urls, nil) if err != nil { return nil, err } @@ -28059,17 +30000,17 @@ func (c *ProjectsLocationsGetAclConfigCall) doRequest(alt string) (*http.Respons googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getAclConfig", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.getAclConfig" call. +// Do executes the "discoveryengine.projects.locations.cmekConfigs.delete" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1AclConfig.ServerResponse.Header or (if a -// response was returned at all) in error.(*googleapi.Error).Header. Use +// *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 *ProjectsLocationsGetAclConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AclConfig, error) { +func (c *ProjectsLocationsCmekConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -28088,7 +30029,7 @@ func (c *ProjectsLocationsGetAclConfigCall) Do(opts ...googleapi.CallOption) (*G if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1AclConfig{ + ret := &GoogleLongrunningOperation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -28099,11 +30040,11 @@ func (c *ProjectsLocationsGetAclConfigCall) Do(opts ...googleapi.CallOption) (*G if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getAclConfig", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsGetCmekConfigCall struct { +type ProjectsLocationsCmekConfigsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -28112,15 +30053,15 @@ type ProjectsLocationsGetCmekConfigCall struct { header_ http.Header } -// GetCmekConfig: Gets the CmekConfig. +// Get: Gets the CmekConfig. // // - name: Resource name of CmekConfig, such as // `projects/*/locations/*/cmekConfig` or // `projects/*/locations/*/cmekConfigs/*`. If the caller does not have // permission to access the CmekConfig, regardless of whether or not it // exists, a PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsService) GetCmekConfig(name string) *ProjectsLocationsGetCmekConfigCall { - c := &ProjectsLocationsGetCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsCmekConfigsService) Get(name string) *ProjectsLocationsCmekConfigsGetCall { + c := &ProjectsLocationsCmekConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -28128,7 +30069,7 @@ func (r *ProjectsLocationsService) GetCmekConfig(name string) *ProjectsLocations // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsGetCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCmekConfigCall { +func (c *ProjectsLocationsCmekConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -28136,27 +30077,27 @@ func (c *ProjectsLocationsGetCmekConfigCall) Fields(s ...googleapi.Field) *Proje // 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 *ProjectsLocationsGetCmekConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCmekConfigCall { +func (c *ProjectsLocationsCmekConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCmekConfigsGetCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGetCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsGetCmekConfigCall { +func (c *ProjectsLocationsCmekConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsGetCall { 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 *ProjectsLocationsGetCmekConfigCall) Header() http.Header { +func (c *ProjectsLocationsCmekConfigsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGetCmekConfigCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCmekConfigsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -28173,17 +30114,17 @@ func (c *ProjectsLocationsGetCmekConfigCall) doRequest(alt string) (*http.Respon googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getCmekConfig", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.get", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.getCmekConfig" call. +// Do executes the "discoveryengine.projects.locations.cmekConfigs.get" call. // Any non-2xx status code is an error. Response headers are in either // *GoogleCloudDiscoveryengineV1CmekConfig.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 *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CmekConfig, error) { +func (c *ProjectsLocationsCmekConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CmekConfig, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -28213,85 +30154,90 @@ func (c *ProjectsLocationsGetCmekConfigCall) Do(opts ...googleapi.CallOption) (* if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.getCmekConfig", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.get", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsUpdateAclConfigCall struct { - s *Service - name string - googleclouddiscoveryenginev1aclconfig *GoogleCloudDiscoveryengineV1AclConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCmekConfigsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// UpdateAclConfig: Default ACL configuration for use in a location of a -// customer's project. Updates will only reflect to new data stores. Existing -// data stores will still use the old value. +// List: Lists all the CmekConfigs with the project. // -// - name: Immutable. The full resource name of the acl configuration. Format: -// `projects/{project}/locations/{location}/aclConfig`. This field must be a -// UTF-8 encoded string with a length limit of 1024 characters. -func (r *ProjectsLocationsService) UpdateAclConfig(name string, googleclouddiscoveryenginev1aclconfig *GoogleCloudDiscoveryengineV1AclConfig) *ProjectsLocationsUpdateAclConfigCall { - c := &ProjectsLocationsUpdateAclConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googleclouddiscoveryenginev1aclconfig = googleclouddiscoveryenginev1aclconfig +// - parent: The parent location resource name, such as +// `projects/{project}/locations/{location}`. If the caller does not have +// permission to list CmekConfigs under this location, regardless of whether +// or not a CmekConfig exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCmekConfigsService) List(parent string) *ProjectsLocationsCmekConfigsListCall { + c := &ProjectsLocationsCmekConfigsListCall{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 *ProjectsLocationsUpdateAclConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateAclConfigCall { +func (c *ProjectsLocationsCmekConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsListCall { 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 *ProjectsLocationsCmekConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCmekConfigsListCall { + c.ifNoneMatch_ = entityTag + return c +} + // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsUpdateAclConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateAclConfigCall { +func (c *ProjectsLocationsCmekConfigsListCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsListCall { 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 *ProjectsLocationsUpdateAclConfigCall) Header() http.Header { +func (c *ProjectsLocationsCmekConfigsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsUpdateAclConfigCall) doRequest(alt string) (*http.Response, error) { - reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1aclconfig) - if err != nil { - return nil, err +func (c *ProjectsLocationsCmekConfigsListCall) 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 := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/cmekConfigs") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + 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, + "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateAclConfig", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.list", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.updateAclConfig" call. +// Do executes the "discoveryengine.projects.locations.cmekConfigs.list" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1AclConfig.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 +// *GoogleCloudDiscoveryengineV1ListCmekConfigsResponse.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 *ProjectsLocationsUpdateAclConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1AclConfig, error) { +func (c *ProjectsLocationsCmekConfigsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListCmekConfigsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -28310,7 +30256,7 @@ func (c *ProjectsLocationsUpdateAclConfigCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1AclConfig{ + ret := &GoogleCloudDiscoveryengineV1ListCmekConfigsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -28321,11 +30267,11 @@ func (c *ProjectsLocationsUpdateAclConfigCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateAclConfig", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.list", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsUpdateCmekConfigCall struct { +type ProjectsLocationsCmekConfigsPatchCall struct { s *Service name string googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig @@ -28334,16 +30280,15 @@ type ProjectsLocationsUpdateCmekConfigCall struct { header_ http.Header } -// UpdateCmekConfig: Provisions a CMEK key for use in a location of a -// customer's project. This method will also conduct location validation on the -// provided cmekConfig to make sure the key is valid and can be used in the -// selected location. +// Patch: Provisions a CMEK key for use in a location of a customer's project. +// This method will also conduct location validation on the provided cmekConfig +// to make sure the key is valid and can be used in the selected location. // // - name: The name of the CmekConfig of the form // `projects/{project}/locations/{location}/cmekConfig` or // `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. -func (r *ProjectsLocationsService) UpdateCmekConfig(name string, googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig) *ProjectsLocationsUpdateCmekConfigCall { - c := &ProjectsLocationsUpdateCmekConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} +func (r *ProjectsLocationsCmekConfigsService) Patch(name string, googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig) *ProjectsLocationsCmekConfigsPatchCall { + c := &ProjectsLocationsCmekConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name c.googleclouddiscoveryenginev1cmekconfig = googleclouddiscoveryenginev1cmekconfig return c @@ -28352,7 +30297,7 @@ func (r *ProjectsLocationsService) UpdateCmekConfig(name string, googleclouddisc // SetDefault sets the optional parameter "setDefault": Set the following // CmekConfig as the default to be used for child resources if one is not // specified. -func (c *ProjectsLocationsUpdateCmekConfigCall) SetDefault(setDefault bool) *ProjectsLocationsUpdateCmekConfigCall { +func (c *ProjectsLocationsCmekConfigsPatchCall) SetDefault(setDefault bool) *ProjectsLocationsCmekConfigsPatchCall { c.urlParams_.Set("setDefault", fmt.Sprint(setDefault)) return c } @@ -28360,27 +30305,27 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) SetDefault(setDefault bool) *Pro // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsUpdateCmekConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsUpdateCmekConfigCall { +func (c *ProjectsLocationsCmekConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsUpdateCmekConfigCall) Context(ctx context.Context) *ProjectsLocationsUpdateCmekConfigCall { +func (c *ProjectsLocationsCmekConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsPatchCall { 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 *ProjectsLocationsUpdateCmekConfigCall) Header() http.Header { +func (c *ProjectsLocationsCmekConfigsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCmekConfigsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1cmekconfig) if err != nil { @@ -28398,17 +30343,17 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) doRequest(alt string) (*http.Res googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateCmekConfig", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.updateCmekConfig" call. +// Do executes the "discoveryengine.projects.locations.cmekConfigs.patch" 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 *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCmekConfigsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -28438,11 +30383,11 @@ func (c *ProjectsLocationsUpdateCmekConfigCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.updateCmekConfig", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.patch", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCmekConfigsDeleteCall struct { +type ProjectsLocationsCollectionsDeleteCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -28450,12 +30395,12 @@ type ProjectsLocationsCmekConfigsDeleteCall struct { header_ http.Header } -// Delete: De-provisions a CmekConfig. +// Delete: Deletes a Collection. // -// - name: The resource name of the CmekConfig to delete, such as -// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. -func (r *ProjectsLocationsCmekConfigsService) Delete(name string) *ProjectsLocationsCmekConfigsDeleteCall { - c := &ProjectsLocationsCmekConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: The full resource name of the Collection, in the format of +// `projects/{project}/locations/{location}/collections/{collection}`. +func (r *ProjectsLocationsCollectionsService) Delete(name string) *ProjectsLocationsCollectionsDeleteCall { + c := &ProjectsLocationsCollectionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -28463,27 +30408,27 @@ func (r *ProjectsLocationsCmekConfigsService) Delete(name string) *ProjectsLocat // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCmekConfigsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsDeleteCall { +func (c *ProjectsLocationsCollectionsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDeleteCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCmekConfigsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsDeleteCall { +func (c *ProjectsLocationsCollectionsDeleteCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDeleteCall { 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 *ProjectsLocationsCmekConfigsDeleteCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsDeleteCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCmekConfigsDeleteCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsDeleteCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") @@ -28497,17 +30442,17 @@ func (c *ProjectsLocationsCmekConfigsDeleteCall) 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", "discoveryengine.projects.locations.cmekConfigs.delete", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.delete", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.cmekConfigs.delete" call. +// Do executes the "discoveryengine.projects.locations.collections.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 *ProjectsLocationsCmekConfigsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsDeleteCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -28537,11 +30482,11 @@ func (c *ProjectsLocationsCmekConfigsDeleteCall) Do(opts ...googleapi.CallOption if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.delete", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.delete", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCmekConfigsGetCall struct { +type ProjectsLocationsCollectionsGetDataConnectorCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -28550,15 +30495,17 @@ type ProjectsLocationsCmekConfigsGetCall struct { header_ http.Header } -// Get: Gets the CmekConfig. +// GetDataConnector: Gets the DataConnector. DataConnector is a singleton +// resource for each Collection. // -// - name: Resource name of CmekConfig, such as -// `projects/*/locations/*/cmekConfig` or -// `projects/*/locations/*/cmekConfigs/*`. If the caller does not have -// permission to access the CmekConfig, regardless of whether or not it -// exists, a PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsCmekConfigsService) Get(name string) *ProjectsLocationsCmekConfigsGetCall { - c := &ProjectsLocationsCmekConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Full resource name of DataConnector, such as +// `projects/{project}/locations/{location}/collections/{collection_id}/dataCo +// nnector`. If the caller does not have permission to access the +// DataConnector, regardless of whether or not it exists, a PERMISSION_DENIED +// error is returned. If the requested DataConnector does not exist, a +// NOT_FOUND error is returned. +func (r *ProjectsLocationsCollectionsService) GetDataConnector(name string) *ProjectsLocationsCollectionsGetDataConnectorCall { + c := &ProjectsLocationsCollectionsGetDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -28566,7 +30513,7 @@ func (r *ProjectsLocationsCmekConfigsService) Get(name string) *ProjectsLocation // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. -func (c *ProjectsLocationsCmekConfigsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsGetCall { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsGetDataConnectorCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -28574,27 +30521,27 @@ func (c *ProjectsLocationsCmekConfigsGetCall) Fields(s ...googleapi.Field) *Proj // 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 *ProjectsLocationsCmekConfigsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCmekConfigsGetCall { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsGetDataConnectorCall { c.ifNoneMatch_ = entityTag return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCmekConfigsGetCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsGetCall { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsCollectionsGetDataConnectorCall { 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 *ProjectsLocationsCmekConfigsGetCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCmekConfigsGetCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "", c.header_) if c.ifNoneMatch_ != "" { reqHeaders.Set("If-None-Match", c.ifNoneMatch_) @@ -28611,130 +30558,17 @@ func (c *ProjectsLocationsCmekConfigsGetCall) doRequest(alt string) (*http.Respo googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.get", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.getDataConnector", "request", internallog.HTTPRequest(req, nil)) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.cmekConfigs.get" call. +// Do executes the "discoveryengine.projects.locations.collections.getDataConnector" call. // Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1CmekConfig.ServerResponse.Header or (if a +// *GoogleCloudDiscoveryengineV1DataConnector.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 *ProjectsLocationsCmekConfigsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1CmekConfig, 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 := &GoogleCloudDiscoveryengineV1CmekConfig{ - 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.cmekConfigs.get", "response", internallog.HTTPResponse(res, b)) - return ret, nil -} - -type ProjectsLocationsCmekConfigsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists all the CmekConfigs with the project. -// -// - parent: The parent location resource name, such as -// `projects/{project}/locations/{location}`. If the caller does not have -// permission to list CmekConfigs under this location, regardless of whether -// or not a CmekConfig exists, a PERMISSION_DENIED error is returned. -func (r *ProjectsLocationsCmekConfigsService) List(parent string) *ProjectsLocationsCmekConfigsListCall { - c := &ProjectsLocationsCmekConfigsListCall{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 *ProjectsLocationsCmekConfigsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsListCall { - 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 *ProjectsLocationsCmekConfigsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCmekConfigsListCall { - c.ifNoneMatch_ = entityTag - return c -} - -// Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCmekConfigsListCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsListCall { - 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 *ProjectsLocationsCmekConfigsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsCmekConfigsListCall) 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}/cmekConfigs") - 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", "discoveryengine.projects.locations.cmekConfigs.list", "request", internallog.HTTPRequest(req, nil)) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "discoveryengine.projects.locations.cmekConfigs.list" call. -// Any non-2xx status code is an error. Response headers are in either -// *GoogleCloudDiscoveryengineV1ListCmekConfigsResponse.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 *ProjectsLocationsCmekConfigsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1ListCmekConfigsResponse, error) { +func (c *ProjectsLocationsCollectionsGetDataConnectorCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataConnector, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -28753,7 +30587,7 @@ func (c *ProjectsLocationsCmekConfigsListCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleCloudDiscoveryengineV1ListCmekConfigsResponse{ + ret := &GoogleCloudDiscoveryengineV1DataConnector{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -28764,67 +30598,70 @@ func (c *ProjectsLocationsCmekConfigsListCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.getDataConnector", "response", internallog.HTTPResponse(res, b)) return ret, nil } -type ProjectsLocationsCmekConfigsPatchCall struct { - s *Service - name string - googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type ProjectsLocationsCollectionsUpdateDataConnectorCall struct { + s *Service + name string + googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// Patch: Provisions a CMEK key for use in a location of a customer's project. -// This method will also conduct location validation on the provided cmekConfig -// to make sure the key is valid and can be used in the selected location. +// UpdateDataConnector: Updates a DataConnector. // -// - name: The name of the CmekConfig of the form -// `projects/{project}/locations/{location}/cmekConfig` or -// `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`. -func (r *ProjectsLocationsCmekConfigsService) Patch(name string, googleclouddiscoveryenginev1cmekconfig *GoogleCloudDiscoveryengineV1CmekConfig) *ProjectsLocationsCmekConfigsPatchCall { - c := &ProjectsLocationsCmekConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Output only. The full resource name of the Data Connector. Format: +// `projects/*/locations/*/collections/*/dataConnector`. +func (r *ProjectsLocationsCollectionsService) UpdateDataConnector(name string, googleclouddiscoveryenginev1dataconnector *GoogleCloudDiscoveryengineV1DataConnector) *ProjectsLocationsCollectionsUpdateDataConnectorCall { + c := &ProjectsLocationsCollectionsUpdateDataConnectorCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name - c.googleclouddiscoveryenginev1cmekconfig = googleclouddiscoveryenginev1cmekconfig + c.googleclouddiscoveryenginev1dataconnector = googleclouddiscoveryenginev1dataconnector return c } -// SetDefault sets the optional parameter "setDefault": Set the following -// CmekConfig as the default to be used for child resources if one is not -// specified. -func (c *ProjectsLocationsCmekConfigsPatchCall) SetDefault(setDefault bool) *ProjectsLocationsCmekConfigsPatchCall { - c.urlParams_.Set("setDefault", fmt.Sprint(setDefault)) +// UpdateMask sets the optional parameter "updateMask": Indicates which fields +// in the provided DataConnector to update. Supported field paths include: - +// refresh_interval - params - auto_run_disabled - action_config - +// action_config.action_params - action_config.service_name - +// destination_configs - blocking_reasons - sync_mode - +// incremental_sync_disabled - incremental_refresh_interval Note: Support for +// these fields may vary depending on the connector type. For example, not all +// connectors support `destination_configs`. If an unsupported or unknown field +// path is provided, the request will return an INVALID_ARGUMENT error. +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) UpdateMask(updateMask string) *ProjectsLocationsCollectionsUpdateDataConnectorCall { + 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 *ProjectsLocationsCmekConfigsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCmekConfigsPatchCall { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsUpdateDataConnectorCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsCmekConfigsPatchCall) Context(ctx context.Context) *ProjectsLocationsCmekConfigsPatchCall { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Context(ctx context.Context) *ProjectsLocationsCollectionsUpdateDataConnectorCall { 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 *ProjectsLocationsCmekConfigsPatchCall) Header() http.Header { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsCmekConfigsPatchCall) doRequest(alt string) (*http.Response, error) { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) doRequest(alt string) (*http.Response, error) { reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) - body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1cmekconfig) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1dataconnector) if err != nil { return nil, err } @@ -28840,17 +30677,17 @@ func (c *ProjectsLocationsCmekConfigsPatchCall) doRequest(alt string) (*http.Res googleapi.Expand(req.URL, map[string]string{ "name": c.name, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.updateDataConnector", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "discoveryengine.projects.locations.cmekConfigs.patch" call. +// Do executes the "discoveryengine.projects.locations.collections.updateDataConnector" 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 +// *GoogleCloudDiscoveryengineV1DataConnector.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 *ProjectsLocationsCmekConfigsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningOperation, error) { +func (c *ProjectsLocationsCollectionsUpdateDataConnectorCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1DataConnector, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -28869,7 +30706,7 @@ func (c *ProjectsLocationsCmekConfigsPatchCall) Do(opts ...googleapi.CallOption) if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &GoogleLongrunningOperation{ + ret := &GoogleCloudDiscoveryengineV1DataConnector{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -28880,7 +30717,7 @@ func (c *ProjectsLocationsCmekConfigsPatchCall) Do(opts ...googleapi.CallOption) if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.cmekConfigs.patch", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "discoveryengine.projects.locations.collections.updateDataConnector", "response", internallog.HTTPResponse(res, b)) return ret, nil } diff --git a/discoveryengine/v1alpha/discoveryengine-api.json b/discoveryengine/v1alpha/discoveryengine-api.json index 9dc2420e232..d5d3699b248 100644 --- a/discoveryengine/v1alpha/discoveryengine-api.json +++ b/discoveryengine/v1alpha/discoveryengine-api.json @@ -203,6 +203,40 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "patch": { + "description": "Updates the editable settings of a Discovery Engine Project.", + "flatPath": "v1alpha/projects/{projectsId}", + "httpMethod": "PATCH", + "id": "discoveryengine.projects.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update. Supported fields: * `customer_provided_config`", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProject" + }, + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProject" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "provision": { "description": "Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms.", "flatPath": "v1alpha/projects/{projectsId}:provision", @@ -453,6 +487,44 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "setUpDataConnectorV2": { + "description": "Creates a Collection and sets up the DataConnector for it. To stop a DataConnector after setup, use the CollectionService.DeleteCollection method.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}:setUpDataConnectorV2", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.setUpDataConnectorV2", + "parameterOrder": [ + "parent" + ], + "parameters": { + "collectionDisplayName": { + "description": "Required. The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.", + "location": "query", + "type": "string" + }, + "collectionId": { + "description": "Required. The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent of Collection, in the format of `projects/{project}/locations/{location}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}:setUpDataConnectorV2", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDataConnector" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "updateAclConfig": { "description": "Default ACL configuration for use in a location of a customer's project. Updates will only reflect to new data stores. Existing data stores will still use the old value.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aclConfig", @@ -819,7 +891,7 @@ "dataConnector": { "methods": { "acquireAccessToken": { - "description": "Uses the per-user refresh token minted with AcquireAndStoreRefreshToken to generate and return a new access token and its details. Takes the access token from cache if available. Rotates the stored refresh token if needed. Uses the end user identity to return the user specific access token. Does *not* return the credentials configured by the administrator. Used by Agentspace action execution and Agentspace UI.", + "description": "Uses the per-user refresh token minted with AcquireAndStoreRefreshToken to generate and return a new access token and its details. Takes the access token from cache if available. Rotates the stored refresh token if needed. Uses the end user identity to return the user specific access token. Does *not* return the credentials configured by the administrator. Used by action execution and UI.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataConnector:acquireAccessToken", "httpMethod": "POST", "id": "discoveryengine.projects.locations.collections.dataConnector.acquireAccessToken", @@ -1390,6 +1462,86 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "get": { + "description": "Retrieves a Branch.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches/{branchesId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.branches.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the branch to retrieve. Format: `projects/*/locations/global/dataStores/default_data_store/branches/some_branch_id`. \"default_branch\" can be used as a special branch_id, it returns the default branch that has been set for the document.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "The view to apply to the returned Branch. Defaults to Branch.BranchView.BASIC if unspecified.", + "enum": [ + "BRANCH_VIEW_UNSPECIFIED", + "BRANCH_VIEW_BASIC", + "BRANCH_VIEW_FULL" + ], + "enumDescriptions": [ + "The value when it's unspecified. This defaults to the BASIC view.", + "Includes basic metadata about the branch, but not statistical fields. See documentation of individual fields of Branch to know what is excluded.", + "Includes all fields of a Branch." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaBranch" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists all Branchs under the specified parent DataStore.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/branches", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.dataStores.branches.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent data store resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "The view to apply to the returned Branch. Defaults to Branch.BranchView.BASIC if unspecified.", + "enum": [ + "BRANCH_VIEW_UNSPECIFIED", + "BRANCH_VIEW_BASIC", + "BRANCH_VIEW_FULL" + ], + "enumDescriptions": [ + "The value when it's unspecified. This defaults to the BASIC view.", + "Includes basic metadata about the branch, but not statistical fields. See documentation of individual fields of Branch to know what is excluded.", + "Includes all fields of a Branch." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/branches", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaListBranchesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -5770,6 +5922,86 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "get": { + "description": "Retrieves a Branch.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches/{branchesId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.dataStores.branches.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the branch to retrieve. Format: `projects/*/locations/global/dataStores/default_data_store/branches/some_branch_id`. \"default_branch\" can be used as a special branch_id, it returns the default branch that has been set for the document.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "The view to apply to the returned Branch. Defaults to Branch.BranchView.BASIC if unspecified.", + "enum": [ + "BRANCH_VIEW_UNSPECIFIED", + "BRANCH_VIEW_BASIC", + "BRANCH_VIEW_FULL" + ], + "enumDescriptions": [ + "The value when it's unspecified. This defaults to the BASIC view.", + "Includes basic metadata about the branch, but not statistical fields. See documentation of individual fields of Branch to know what is excluded.", + "Includes all fields of a Branch." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaBranch" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists all Branchs under the specified parent DataStore.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/branches", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.dataStores.branches.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent data store resource name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "The view to apply to the returned Branch. Defaults to Branch.BranchView.BASIC if unspecified.", + "enum": [ + "BRANCH_VIEW_UNSPECIFIED", + "BRANCH_VIEW_BASIC", + "BRANCH_VIEW_FULL" + ], + "enumDescriptions": [ + "The value when it's unspecified. This defaults to the BASIC view.", + "Includes basic metadata about the branch, but not statistical fields. See documentation of individual fields of Branch to know what is excluded.", + "Includes all fields of a Branch." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/branches", + "response": { + "$ref": "GoogleCloudDiscoveryengineV1alphaListBranchesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } }, "resources": { @@ -9676,7 +9908,7 @@ } } }, - "revision": "20250908", + "revision": "20250921", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "ApiservingMediaRequestInfo": { @@ -9719,6 +9951,11 @@ ], "type": "string" }, + "physicalHeaders": { + "description": "The physical headers provided by RequestReceivedParameters in Scotty request. type is uploader_service.KeyValuePairs.", + "format": "byte", + "type": "string" + }, "requestId": { "description": "The Scotty request ID.", "type": "string" @@ -10699,6 +10936,38 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1ActionConfig": { + "description": "Informations to support actions on the connector.", + "id": "GoogleCloudDiscoveryengineV1ActionConfig", + "properties": { + "actionParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Action parameters in structured json format.", + "type": "object" + }, + "isActionConfigured": { + "description": "Output only. The connector contains the necessary parameters and is configured to support actions.", + "readOnly": true, + "type": "boolean" + }, + "jsonActionParams": { + "description": "Optional. Action parameters in json string format.", + "type": "string" + }, + "serviceName": { + "description": "Optional. The Service Directory resource name (projects/*/locations/*/namespaces/*/services/*) representing a VPC network endpoint used to connect to the data source's `instance_uri`, defined in DataConnector.params. Required when VPC Service Controls are enabled.", + "type": "string" + }, + "useStaticSecrets": { + "description": "Optional. Whether to use static secrets for the connector. If true, the secrets provided in the action_params will be ignored.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", @@ -10714,6 +10983,49 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1AlertPolicyConfig": { + "description": "The connector level alert config.", + "id": "GoogleCloudDiscoveryengineV1AlertPolicyConfig", + "properties": { + "alertEnrollments": { + "description": "Optional. The enrollment states of each alert.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment" + }, + "type": "array" + }, + "alertPolicyName": { + "description": "Immutable. The fully qualified resource name of the AlertPolicy.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment": { + "description": "The alert enrollment status.", + "id": "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment", + "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" + }, "GoogleCloudDiscoveryengineV1AnswerGenerationSpec": { "description": "The specification for answer generation.", "id": "GoogleCloudDiscoveryengineV1AnswerGenerationSpec", @@ -10941,6 +11253,39 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1BAPConfig": { + "description": "The configuration for the BAP connector.", + "id": "GoogleCloudDiscoveryengineV1BAPConfig", + "properties": { + "enabledActions": { + "description": "Optional. The actions enabled on the associated BAP connection.", + "items": { + "type": "string" + }, + "type": "array" + }, + "supportedConnectorModes": { + "description": "Required. The supported connector modes for the associated BAP connection.", + "items": { + "enum": [ + "CONNECTOR_MODE_UNSPECIFIED", + "DATA_INGESTION", + "ACTIONS", + "END_USER_AUTHENTICATION" + ], + "enumDescriptions": [ + "Connector mode unspecified.", + "Connector utilized for data ingestion.", + "Connector utilized for Actions", + "Connector utilized for End User Authentication." + ], + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata": { "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata", @@ -11102,8 +11447,29 @@ }, "type": "object" }, - "GoogleCloudDiscoveryengineV1Condition": { - "description": "Defines circumstances to be checked before allowing a behavior", + "GoogleCloudDiscoveryengineV1Collection": { + "description": "Collection is a container for configuring resources and access to a set of DataStores.", + "id": "GoogleCloudDiscoveryengineV1Collection", + "properties": { + "createTime": { + "description": "Output only. Timestamp the Collection was created at.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Required. The Collection display name. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "type": "string" + }, + "name": { + "description": "Immutable. The full resource name of the Collection. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1Condition": { + "description": "Defines circumstances to be checked before allowing a behavior", "id": "GoogleCloudDiscoveryengineV1Condition", "properties": { "activeTimeRange": { @@ -11474,169 +11840,668 @@ }, "type": "object" }, - "GoogleCloudDiscoveryengineV1DataStore": { - "description": "DataStore captures global settings and configs at the DataStore level.", - "id": "GoogleCloudDiscoveryengineV1DataStore", + "GoogleCloudDiscoveryengineV1DataConnector": { + "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through DataConnectorService.SetUpDataConnector method, which will create a new Collection and initialize its DataConnector.", + "id": "GoogleCloudDiscoveryengineV1DataConnector", "properties": { "aclEnabled": { - "description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.", + "description": "Optional. Whether the connector will be created with an ACL config. Currently this field only affects Cloud Storage and BigQuery connectors.", "type": "boolean" }, - "advancedSiteSearchConfig": { - "$ref": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", - "description": "Optional. Configuration for advanced site search." - }, - "billingEstimation": { - "$ref": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", - "description": "Output only. Data size estimation for billing.", - "readOnly": true - }, - "cmekConfig": { - "$ref": "GoogleCloudDiscoveryengineV1CmekConfig", - "description": "Output only. CMEK-related information for the DataStore.", - "readOnly": true + "actionConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ActionConfig", + "description": "Optional. Action configurations to make the connector support actions." }, - "contentConfig": { - "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", + "actionState": { + "description": "Output only. State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors.", "enum": [ - "CONTENT_CONFIG_UNSPECIFIED", - "NO_CONTENT", - "CONTENT_REQUIRED", - "PUBLIC_WEBSITE", - "GOOGLE_WORKSPACE" + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" ], "enumDescriptions": [ "Default value.", - "Only contains documents without any Document.content.", - "Only contains documents with Document.content.", - "The data store is used for public website search.", - "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." ], - "type": "string" - }, - "createTime": { - "description": "Output only. Timestamp the DataStore was created at.", - "format": "google-datetime", - "readOnly": true, - "type": "string" - }, - "defaultSchemaId": { - "description": "Output only. The id of the default Schema associated to this data store.", "readOnly": true, "type": "string" }, - "displayName": { - "description": "Required. The data store display name. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", - "type": "string" - }, - "documentProcessingConfig": { - "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfig", - "description": "Configuration for Document understanding and enrichment." - }, - "healthcareFhirConfig": { - "$ref": "GoogleCloudDiscoveryengineV1HealthcareFhirConfig", - "description": "Optional. Configuration for `HEALTHCARE_FHIR` vertical." - }, - "identityMappingStore": { - "description": "Immutable. The fully qualified resource name of the associated IdentityMappingStore. This field can only be set for acl_enabled DataStores with `THIRD_PARTY` or `GSUITE` IdP. Format: `projects/{project}/locations/{location}/identityMappingStores/{identity_mapping_store}`.", - "type": "string" - }, - "industryVertical": { - "description": "Immutable. The industry vertical that the data store registers.", - "enum": [ - "INDUSTRY_VERTICAL_UNSPECIFIED", - "GENERIC", - "MEDIA", - "HEALTHCARE_FHIR" - ], - "enumDescriptions": [ - "Value used when unset.", - "The generic vertical for documents that are not specific to any industry vertical.", - "The media industry vertical.", - "The healthcare FHIR vertical." - ], - "type": "string" + "alertPolicyConfigs": { + "description": "Optional. The connector level alert config.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1AlertPolicyConfig" + }, + "type": "array" }, - "isInfobotFaqDataStore": { - "description": "Optional. If set, this DataStore is an Infobot FAQ DataStore.", + "autoRunDisabled": { + "description": "Optional. Indicates whether the connector is disabled for auto run. It can be used to pause periodical and real time sync. Update: with the introduction of incremental_sync_disabled, auto_run_disabled is used to pause/disable only full syncs", "type": "boolean" }, - "kmsKeyName": { - "description": "Input only. The KMS key to be used to protect this DataStore at creation time. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStore will be protected by the KMS key, as indicated in the cmek_config field.", - "type": "string" - }, - "name": { - "description": "Immutable. Identifier. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.", - "type": "string" - }, - "servingConfigDataStore": { - "$ref": "GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore", - "description": "Optional. Stores serving config at DataStore level." + "bapConfig": { + "$ref": "GoogleCloudDiscoveryengineV1BAPConfig", + "description": "Optional. The configuration for establishing a BAP connection." }, - "solutionTypes": { - "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.", + "blockingReasons": { + "description": "Output only. User actions that must be completed before the connector can start syncing data.", "items": { "enum": [ - "SOLUTION_TYPE_UNSPECIFIED", - "SOLUTION_TYPE_RECOMMENDATION", - "SOLUTION_TYPE_SEARCH", - "SOLUTION_TYPE_CHAT", - "SOLUTION_TYPE_GENERATIVE_CHAT" + "BLOCKING_REASON_UNSPECIFIED", + "ALLOWLIST_STATIC_IP", + "ALLOWLIST_IN_SERVICE_ATTACHMENT", + "ALLOWLIST_SERVICE_ACCOUNT" ], "enumDescriptions": [ "Default value.", - "Used for Recommendations AI.", - "Used for Discovery Search.", - "Used for use cases related to the Generative AI agent.", - "Used for use cases related to the Generative Chat agent. It's used for Generative chat engine only, the associated data stores must enrolled with `SOLUTION_TYPE_CHAT` solution." + "Connector requires customer to allowlist static IPs.", + "Connector requires customer to allowlist our project in their service attachment.", + "Connector requires customer to allowlist service account in their project." ], "type": "string" }, + "readOnly": true, "type": "array" }, - "startingSchema": { - "$ref": "GoogleCloudDiscoveryengineV1Schema", - "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + "connectorModes": { + "description": "Optional. The modes enabled for this connector. Default state is CONNECTOR_MODE_UNSPECIFIED.", + "items": { + "enum": [ + "CONNECTOR_MODE_UNSPECIFIED", + "DATA_INGESTION", + "ACTIONS", + "FEDERATED", + "EUA", + "FEDERATED_AND_EUA" + ], + "enumDescriptions": [ + "Connector mode unspecified.", + "Connector utilized for data ingestion.", + "Connector utilized for actions.", + "Connector utilized for federated search.", + "Connector utilized for End User Authentication.", + "Hybrid connector utilized for federated search and End User Authentication." + ], + "type": "string" + }, + "type": "array" }, - "workspaceConfig": { - "$ref": "GoogleCloudDiscoveryengineV1WorkspaceConfig", - "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." - } - }, - "type": "object" - }, - "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation": { - "description": "Estimation of data size per data store.", - "id": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", - "properties": { - "structuredDataSize": { - "description": "Data size for structured data in terms of bytes.", - "format": "int64", + "connectorType": { + "description": "Output only. The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system.", + "enum": [ + "CONNECTOR_TYPE_UNSPECIFIED", + "THIRD_PARTY", + "GCP_FHIR", + "BIG_QUERY", + "GCS", + "GOOGLE_MAIL", + "GOOGLE_CALENDAR", + "GOOGLE_DRIVE", + "NATIVE_CLOUD_IDENTITY", + "THIRD_PARTY_FEDERATED", + "THIRD_PARTY_EUA", + "GCNV" + ], + "enumDescriptions": [ + "Default value.", + "Third party connector to connector to third party application.", + "Data connector connects between FHIR store and VAIS datastore.", + "Big query connector.", + "Google Cloud Storage connector.", + "Gmail connector.", + "Google Calendar connector.", + "Google Drive connector.", + "Native Cloud Identity connector for people search powered by People API.", + "Federated connector, it is a third party connector that doesn't ingestion data, and search is powered by third party application's API.", + "Connector utilized for End User Authentication features.", + "Google Cloud NetApp Volumes connector." + ], + "readOnly": true, "type": "string" }, - "structuredDataUpdateTime": { - "description": "Last updated timestamp for structured data.", + "createEuaSaas": { + "description": "Optional. Whether the END USER AUTHENTICATION connector is created in SaaS.", + "type": "boolean" + }, + "createTime": { + "description": "Output only. Timestamp the DataConnector was created at.", "format": "google-datetime", + "readOnly": true, "type": "string" }, - "unstructuredDataSize": { - "description": "Data size for unstructured data in terms of bytes.", - "format": "int64", + "dataSource": { + "description": "Required. The name of the data source. Supported values: `salesforce`, `jira`, `confluence`, `bigquery`.", "type": "string" }, - "unstructuredDataUpdateTime": { - "description": "Last updated timestamp for unstructured data.", - "format": "google-datetime", - "type": "string" + "destinationConfigs": { + "description": "Optional. Any target destinations used to connect to third-party services.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DestinationConfig" + }, + "type": "array" }, - "websiteDataSize": { - "description": "Data size for websites in terms of bytes.", - "format": "int64", - "type": "string" + "endUserConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig", + "description": "Optional. Any params and credentials used specifically for EUA connectors." }, - "websiteDataUpdateTime": { - "description": "Last updated timestamp for websites.", - "format": "google-datetime", + "entities": { + "description": "List of entities from the connected data source to ingest.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity" + }, + "type": "array" + }, + "errors": { + "description": "Output only. The errors from initialization or from the latest connector run.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "readOnly": true, + "type": "array" + }, + "federatedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig", + "description": "Optional. Any params and credentials used specifically for hybrid connectors supporting FEDERATED mode. This field should only be set if the connector is a hybrid connector and we want to enable FEDERATED mode." + }, + "hybridIngestionDisabled": { + "description": "Optional. If the connector is a hybrid connector, determines whether ingestion is enabled and appropriate resources are provisioned during connector creation. If the connector is not a hybrid connector, this field is ignored.", + "type": "boolean" + }, + "identityRefreshInterval": { + "deprecated": true, + "description": "The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", + "format": "google-duration", + "type": "string" + }, + "identityScheduleConfig": { + "$ref": "GoogleCloudDiscoveryengineV1IdentityScheduleConfig", + "description": "The configuration for the identity data synchronization runs. This contains the refresh interval to sync the Access Control List information for the documents ingested by this connector." + }, + "incrementalRefreshInterval": { + "description": "Optional. The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.", + "format": "google-duration", + "type": "string" + }, + "incrementalSyncDisabled": { + "description": "Optional. Indicates whether incremental syncs are paused for this connector. This is independent of auto_run_disabled. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled, i.e. set to true.", + "type": "boolean" + }, + "jsonParams": { + "description": "Required data connector parameters in json string format.", + "type": "string" + }, + "kmsKeyName": { + "description": "Input only. The KMS key to be used to protect the DataStores managed by this connector. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStores created by this connector will be protected by the KMS key.", + "type": "string" + }, + "lastSyncTime": { + "description": "Output only. For periodic connectors only, the last time a data sync was completed.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "latestPauseTime": { + "description": "Output only. The most recent timestamp when this DataConnector was paused, affecting all functionalities such as data synchronization. Pausing a connector has the following effects: - All functionalities, including data synchronization, are halted. - Any ongoing data synchronization job will be canceled. - No future data synchronization runs will be scheduled nor can be triggered.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. The full resource name of the Data Connector. Format: `projects/*/locations/*/collections/*/dataConnector`.", + "readOnly": true, + "type": "string" + }, + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Defines the scheduled time for the next data synchronization. This field requires hour , minute, and time_zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). This is utilized when the data connector has a refresh interval greater than 1 day. When the hours or minutes are not specified, we will assume a sync time of 0:00. The user must provide a time zone to avoid ambiguity." + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Required data connector parameters in structured json format.", + "type": "object" + }, + "privateConnectivityProjectId": { + "description": "Output only. The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.", + "readOnly": true, + "type": "string" + }, + "realtimeState": { + "description": "Output only. real-time sync state", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" + ], + "enumDescriptions": [ + "Default value.", + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." + ], + "readOnly": true, + "type": "string" + }, + "realtimeSyncConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig", + "description": "Optional. The configuration for realtime sync." + }, + "refreshInterval": { + "description": "Required. The refresh interval for data sync. If duration is set to 0, the data will be synced in real time. The streaming feature is not supported yet. The minimum is 30 minutes and maximum is 7 days. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.", + "format": "google-duration", + "type": "string" + }, + "removeParamKeys": { + "description": "Optional. Specifies keys to be removed from the 'params' field. This is only active when 'params' is included in the 'update_mask' in an UpdateDataConnectorRequest. Deletion takes precedence if a key is both in 'remove_param_keys' and present in the 'params' field of the request.", + "items": { + "type": "string" + }, + "type": "array" + }, + "state": { + "description": "Output only. State of the connector.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" + ], + "enumDescriptions": [ + "Default value.", + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." + ], + "readOnly": true, + "type": "string" + }, + "staticIpAddresses": { + "description": "Output only. The static IP addresses used by this connector.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "staticIpEnabled": { + "description": "Optional. Whether customer has enabled static IP addresses for this connector.", + "type": "boolean" + }, + "syncMode": { + "description": "The data synchronization mode supported by the data connector.", + "enum": [ + "PERIODIC", + "STREAMING", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "The connector will sync data periodically based on the refresh_interval. Use it with auto_run_disabled to pause the periodic sync, or indicate a one-time sync.", + "The data will be synced in real time.", + "Connector that doesn't ingest data will have this value" + ], + "type": "string" + }, + "updateTime": { + "description": "Output only. Timestamp the DataConnector was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig": { + "description": "Any params and credentials used specifically for EUA connectors.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig", + "properties": { + "additionalParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any additional parameters needed for EUA.", + "type": "object" + }, + "authParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any authentication parameters specific to EUA connectors.", + "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to EUA connectors in json string format.", + "type": "string" + }, + "tenant": { + "$ref": "GoogleCloudDiscoveryengineV1Tenant", + "description": "Optional. The tenant project the connector is connected to." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig": { + "description": "Any params and credentials used specifically for hybrid connectors supporting FEDERATED mode.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig", + "properties": { + "additionalParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any additional parameters needed for FEDERATED.", + "type": "object" + }, + "authParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any authentication parameters specific to FEDERATED connectors.", + "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to FEDERATED connectors in json string format.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig": { + "description": "The configuration for realtime sync to store additional params for realtime sync.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig", + "properties": { + "realtimeSyncSecret": { + "description": "Optional. The ID of the Secret Manager secret used for webhook secret.", + "type": "string" + }, + "streamingError": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError", + "description": "Optional. Streaming error details." + }, + "webhookUri": { + "description": "Optional. Webhook url for the connector to specify additional params for realtime sync.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError": { + "description": "Streaming error details.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Optional. Error details." + }, + "streamingErrorReason": { + "description": "Optional. Streaming error.", + "enum": [ + "STREAMING_ERROR_REASON_UNSPECIFIED", + "STREAMING_SETUP_ERROR", + "STREAMING_SYNC_ERROR", + "INGRESS_ENDPOINT_REQUIRED" + ], + "enumDescriptions": [ + "Streaming error reason unspecified.", + "Some error occurred while setting up resources for realtime sync.", + "Some error was encountered while running realtime sync for the connector.", + "Ingress endpoint is required when setting up realtime sync in private connectivity." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity": { + "description": "Represents an entity in the data source. For example, the `Account` object in Salesforce.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity", + "properties": { + "dataStore": { + "description": "Output only. The full resource name of the associated data store for the source entity. Format: `projects/*/locations/*/collections/*/dataStores/*`. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity.", + "readOnly": true, + "type": "string" + }, + "entityName": { + "description": "The name of the entity. Supported values by data source: * Salesforce: `Lead`, `Opportunity`, `Contact`, `Account`, `Case`, `Contract`, `Campaign` * Jira: `Issue` * Confluence: `Content`, `Space`", + "type": "string" + }, + "healthcareFhirConfig": { + "$ref": "GoogleCloudDiscoveryengineV1HealthcareFhirConfig", + "description": "Optional. Configuration for `HEALTHCARE_FHIR` vertical." + }, + "jsonParams": { + "description": "The parameters for the entity to facilitate data ingestion in json string format.", + "type": "string" + }, + "keyPropertyMappings": { + "additionalProperties": { + "type": "string" + }, + "description": "Attributes for indexing. Key: Field name. Value: The key property to map a field to, such as `title`, and `description`. Supported key properties: * `title`: The title for data record. This would be displayed on search results. * `description`: The description for data record. This would be displayed on search results.", + "type": "object" + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "The parameters for the entity to facilitate data ingestion in structured json format.", + "type": "object" + }, + "startingSchema": { + "$ref": "GoogleCloudDiscoveryengineV1Schema", + "description": "Optional. The start schema to use for the DataStore created from this SourceEntity. If unset, a default vertical specialized schema will be used. This field is only used by SetUpDataConnector API, and will be ignored if used in other APIs. This field will be omitted from all API responses including GetDataConnector API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataStore": { + "description": "DataStore captures global settings and configs at the DataStore level.", + "id": "GoogleCloudDiscoveryengineV1DataStore", + "properties": { + "aclEnabled": { + "description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.", + "type": "boolean" + }, + "advancedSiteSearchConfig": { + "$ref": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", + "description": "Optional. Configuration for advanced site search." + }, + "billingEstimation": { + "$ref": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "description": "Output only. Data size estimation for billing.", + "readOnly": true + }, + "cmekConfig": { + "$ref": "GoogleCloudDiscoveryengineV1CmekConfig", + "description": "Output only. CMEK-related information for the DataStore.", + "readOnly": true + }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, + "contentConfig": { + "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", + "enum": [ + "CONTENT_CONFIG_UNSPECIFIED", + "NO_CONTENT", + "CONTENT_REQUIRED", + "PUBLIC_WEBSITE", + "GOOGLE_WORKSPACE" + ], + "enumDescriptions": [ + "Default value.", + "Only contains documents without any Document.content.", + "Only contains documents with Document.content.", + "The data store is used for public website search.", + "The data store is used for workspace search. Details of workspace data store are specified in the WorkspaceConfig." + ], + "type": "string" + }, + "createTime": { + "description": "Output only. Timestamp the DataStore was created at.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "defaultSchemaId": { + "description": "Output only. The id of the default Schema associated to this data store.", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Required. The data store display name. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "type": "string" + }, + "documentProcessingConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfig", + "description": "Configuration for Document understanding and enrichment." + }, + "healthcareFhirConfig": { + "$ref": "GoogleCloudDiscoveryengineV1HealthcareFhirConfig", + "description": "Optional. Configuration for `HEALTHCARE_FHIR` vertical." + }, + "identityMappingStore": { + "description": "Immutable. The fully qualified resource name of the associated IdentityMappingStore. This field can only be set for acl_enabled DataStores with `THIRD_PARTY` or `GSUITE` IdP. Format: `projects/{project}/locations/{location}/identityMappingStores/{identity_mapping_store}`.", + "type": "string" + }, + "industryVertical": { + "description": "Immutable. The industry vertical that the data store registers.", + "enum": [ + "INDUSTRY_VERTICAL_UNSPECIFIED", + "GENERIC", + "MEDIA", + "HEALTHCARE_FHIR" + ], + "enumDescriptions": [ + "Value used when unset.", + "The generic vertical for documents that are not specific to any industry vertical.", + "The media industry vertical.", + "The healthcare FHIR vertical." + ], + "type": "string" + }, + "isInfobotFaqDataStore": { + "description": "Optional. If set, this DataStore is an Infobot FAQ DataStore.", + "type": "boolean" + }, + "kmsKeyName": { + "description": "Input only. The KMS key to be used to protect this DataStore at creation time. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStore will be protected by the KMS key, as indicated in the cmek_config field.", + "type": "string" + }, + "name": { + "description": "Immutable. Identifier. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.", + "type": "string" + }, + "servingConfigDataStore": { + "$ref": "GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore", + "description": "Optional. Stores serving config at DataStore level." + }, + "solutionTypes": { + "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.", + "items": { + "enum": [ + "SOLUTION_TYPE_UNSPECIFIED", + "SOLUTION_TYPE_RECOMMENDATION", + "SOLUTION_TYPE_SEARCH", + "SOLUTION_TYPE_CHAT", + "SOLUTION_TYPE_GENERATIVE_CHAT" + ], + "enumDescriptions": [ + "Default value.", + "Used for Recommendations AI.", + "Used for Discovery Search.", + "Used for use cases related to the Generative AI agent.", + "Used for use cases related to the Generative Chat agent. It's used for Generative chat engine only, the associated data stores must enrolled with `SOLUTION_TYPE_CHAT` solution." + ], + "type": "string" + }, + "type": "array" + }, + "startingSchema": { + "$ref": "GoogleCloudDiscoveryengineV1Schema", + "description": "The start schema to use for this DataStore when provisioning it. If unset, a default vertical specialized schema will be used. This field is only used by CreateDataStore API, and will be ignored if used in other APIs. This field will be omitted from all API responses including CreateDataStore API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." + }, + "workspaceConfig": { + "$ref": "GoogleCloudDiscoveryengineV1WorkspaceConfig", + "description": "Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation": { + "description": "Estimation of data size per data store.", + "id": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation", + "properties": { + "structuredDataSize": { + "description": "Data size for structured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "structuredDataUpdateTime": { + "description": "Last updated timestamp for structured data.", + "format": "google-datetime", + "type": "string" + }, + "unstructuredDataSize": { + "description": "Data size for unstructured data in terms of bytes.", + "format": "int64", + "type": "string" + }, + "unstructuredDataUpdateTime": { + "description": "Last updated timestamp for unstructured data.", + "format": "google-datetime", + "type": "string" + }, + "websiteDataSize": { + "description": "Data size for websites in terms of bytes.", + "format": "int64", + "type": "string" + }, + "websiteDataUpdateTime": { + "description": "Last updated timestamp for websites.", + "format": "google-datetime", "type": "string" } }, @@ -11670,6 +12535,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DeleteCollectionMetadata": { + "description": "Metadata related to the progress of the CollectionService.UpdateCollection operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1DeleteCollectionMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata", @@ -11764,10 +12646,56 @@ "format": "google-datetime", "type": "string" }, - "updateTime": { - "description": "Operation last update time. If the operation is done, this is also the finish time.", - "format": "google-datetime", - "type": "string" + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DestinationConfig": { + "description": "Defines target endpoints used to connect to third-party sources.", + "id": "GoogleCloudDiscoveryengineV1DestinationConfig", + "properties": { + "destinations": { + "description": "Optional. The destinations for the corresponding key.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DestinationConfigDestination" + }, + "type": "array" + }, + "jsonParams": { + "description": "Additional parameters for this destination config in json string format.", + "type": "string" + }, + "key": { + "description": "Optional. Unique destination identifier that is supported by the connector.", + "type": "string" + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Additional parameters for this destination config in structured json format.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DestinationConfigDestination": { + "description": "Defines a target endpoint", + "id": "GoogleCloudDiscoveryengineV1DestinationConfigDestination", + "properties": { + "host": { + "description": "Publicly routable host.", + "type": "string" + }, + "port": { + "description": "Optional. Target port number accepted by the destination.", + "format": "int32", + "type": "integer" } }, "type": "object" @@ -11991,6 +12919,18 @@ "$ref": "GoogleCloudDiscoveryengineV1EngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -12026,7 +12966,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -12312,6 +13252,22 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1IdentityScheduleConfig": { + "description": "The configuration for the identity data synchronization runs.", + "id": "GoogleCloudDiscoveryengineV1IdentityScheduleConfig", + "properties": { + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Optional. The UTC time when the next data sync is expected to start for the Data Connector. Customers are only able to specify the hour and minute to schedule the data sync. This is utilized when the data connector has a refresh interval greater than 1 day." + }, + "refreshInterval": { + "description": "Optional. The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1IdpConfig": { "description": "Identity Provider Config.", "id": "GoogleCloudDiscoveryengineV1IdpConfig", @@ -12574,6 +13530,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -12596,6 +13556,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1ProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1ProjectServiceTerms", @@ -13170,6 +14167,12 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata": { + "description": "Metadata for DataConnectorService.SetUpDataConnector method.", + "id": "GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata", + "properties": {}, + "type": "object" + }, "GoogleCloudDiscoveryengineV1SingleRegionKey": { "description": "Metadata for single-regional CMEKs.", "id": "GoogleCloudDiscoveryengineV1SingleRegionKey", @@ -13337,6 +14340,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1Tenant": { + "description": "Tenant information for a connector source. This includes some of the same information stored in the Credential message, but is limited to only what is needed to provide a list of accessible tenants to the user.", + "id": "GoogleCloudDiscoveryengineV1Tenant", + "properties": { + "displayName": { + "description": "Optional display name for the tenant, e.g. \"My Slack Team\".", + "type": "string" + }, + "id": { + "description": "The tenant's instance ID. Examples: Jira (\"8594f221-9797-5f78-1fa4-485e198d7cd0\"), Slack (\"T123456\").", + "type": "string" + }, + "uri": { + "description": "The URI of the tenant, if applicable. For example, the URI of a Jira instance is https://my-jira-instance.atlassian.net, and a Slack tenant does not have a URI.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata": { "description": "Metadata related to the progress of the TrainCustomModel operation. This is returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata", @@ -13587,7 +14609,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Required. Params needed to support actions in the format of (Key, Value) pairs. Required parameters for sources that support OAUTH, i.e. `gmail`, `google_calendar`, `jira`, `workday`, `salesforce`, `confluence`: * Key: `client_id` * Value: type STRING. The client ID for the service provider to identify your application. * Key: `client_secret` * Value:type STRING. The client secret generated by the application's authorization server.", + "description": "Optional. Action parameters in structured json format.", "type": "object" }, "isActionConfigured": { @@ -13595,6 +14617,10 @@ "readOnly": true, "type": "boolean" }, + "jsonActionParams": { + "description": "Optional. Action parameters in json string format.", + "type": "string" + }, "serviceName": { "description": "Optional. The Service Directory resource name (projects/*/locations/*/namespaces/*/services/*) representing a VPC network endpoint used to connect to the data source's `instance_uri`, defined in DataConnector.params. Required when VPC Service Controls are enabled.", "type": "string" @@ -15446,6 +16472,11 @@ "groundedContent": { "$ref": "GoogleCloudDiscoveryengineV1alphaAssistantGroundedContent", "description": "Possibly grounded response text or media from the assistant." + }, + "replyId": { + "description": "Output only. When set, uniquely identifies a reply within the `AssistAnswer` resource. During an AssistantService.StreamAssist call, multiple `Reply` messages with the same ID can occur within the response stream (across multiple AssistantService.StreamAssistResponse messages). These represent parts of a single `Reply` message in the final `AssistAnswer` resource.", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -15776,6 +16807,10 @@ "description": "Domain name from the document URI. Note that the `uri` field may contain a URL that redirects to the actual website, in which case this will contain the domain name of the target site.", "type": "string" }, + "mimeType": { + "description": "The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml.", + "type": "string" + }, "pageIdentifier": { "description": "Page identifier.", "type": "string" @@ -15858,6 +16893,13 @@ "description": "The configuration for the BAP connector.", "id": "GoogleCloudDiscoveryengineV1alphaBAPConfig", "properties": { + "enabledActions": { + "description": "Optional. The actions enabled on the associated BAP connection.", + "items": { + "type": "string" + }, + "type": "array" + }, "supportedConnectorModes": { "description": "Required. The supported connector modes for the associated BAP connection.", "items": { @@ -16275,6 +17317,53 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaBranch": { + "description": "A data branch that stores Documents.", + "id": "GoogleCloudDiscoveryengineV1alphaBranch", + "properties": { + "branchStats": { + "$ref": "GoogleCloudDiscoveryengineV1alphaBranchBranchStats", + "description": "Output only. Stistics describing a branch. This field is not populated in BranchView.BASIC view.", + "readOnly": true + }, + "displayName": { + "description": "Output only. Human readable name of the branch to display in the UI.", + "readOnly": true, + "type": "string" + }, + "isDefault": { + "description": "Output only. Indicates whether this branch is set as the default branch of its parent data store.", + "readOnly": true, + "type": "boolean" + }, + "lastDocumentImportTime": { + "description": "Output only. Timestamp of last import through DocumentService.ImportDocuments. Empty value means no import has been made to this branch.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Immutable. Full resource name of the branch, such as `projects/*/locations/global/dataStores/data_store/branches/branch_id`.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaBranchBranchStats": { + "description": "Statistics describing a branch.", + "id": "GoogleCloudDiscoveryengineV1alphaBranchBranchStats", + "properties": { + "documentCounts": { + "additionalProperties": { + "format": "int64", + "type": "string" + }, + "description": "The number of documents in a given branch. The key is a group representing a set of documents, and the value is the number of document in that group. Note: keys in this map may change over time. Supported keys: ['all'].", + "type": "object" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaCheckGroundingRequest": { "description": "Request message for GroundedGenerationService.CheckGrounding method.", "id": "GoogleCloudDiscoveryengineV1alphaCheckGroundingRequest", @@ -17974,6 +19063,10 @@ "description": "Optional. Indicates whether incremental syncs are paused for this connector. This is independent of auto_run_disabled. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled, i.e. set to true.", "type": "boolean" }, + "jsonParams": { + "description": "Required data connector parameters in json string format.", + "type": "string" + }, "kmsKeyName": { "description": "Input only. The KMS key to be used to protect the DataStores managed by this connector. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStores created by this connector will be protected by the KMS key.", "type": "string" @@ -18004,7 +19097,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Required. Params needed to access the source in the format of (Key, Value) pairs. Required parameters for all data sources: * Key: `instance_uri` * Value: type STRING. The uri to access the data source. Required parameters for sources that support OAUTH, i.e. `salesforce`: * Key: `client_id` * Value: type STRING. The client ID for the third party service provider to identify your application. * Key: `client_secret` * Value:type STRING. The client secret generated by the third party authorization server. * Key: `access_token` * Value: type STRING. OAuth token for UCS to access to the protected resource. * Key: `refresh_token` * Value: type STRING. OAuth refresh token for UCS to obtain a new access token without user interaction. Required parameters for sources that support basic API token auth, i.e. `jira`, `confluence`: * Key: `user_account` * Value: type STRING. The username or email with the source. * Key: `api_token` * Value: type STRING. The API token generated for the source account, that is used for authenticating anywhere where you would have used a password. Example: ```json { \"instance_uri\": \"https://xxx.atlassian.net\", \"user_account\": \"xxxx.xxx@xxx.com\", \"api_token\": \"test-token\" } ``` Optional parameter to specify the authorization type to use for multiple authorization types support: * Key: `auth_type` * Value: type STRING. The authorization type for the data source. Supported values: `BASIC_AUTH`, `OAUTH`, `OAUTH_ACCESS_TOKEN`, `OAUTH_TWO_LEGGED`, `OAUTH_JWT_BEARER`, `OAUTH_PASSWORD_GRANT`, `JWT`, `API_TOKEN`, `FEDERATED_CREDENTIAL`.", + "description": "Required data connector parameters in structured json format.", "type": "object" }, "privateConnectivityProjectId": { @@ -18133,6 +19226,10 @@ "description": "Optional. Any authentication parameters specific to EUA connectors.", "type": "object" }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to EUA connectors in json string format.", + "type": "string" + }, "tenant": { "$ref": "GoogleCloudDiscoveryengineV1alphaTenant", "description": "Optional. The tenant project the connector is connected to." @@ -18157,8 +19254,12 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. Any authentication parameters specific to FEDERATED.", + "description": "Optional. Any authentication parameters specific to FEDERATED connectors.", "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to FEDERATED connectors in json string format.", + "type": "string" } }, "type": "object" @@ -18226,6 +19327,10 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaHealthcareFhirConfig", "description": "Optional. Configuration for `HEALTHCARE_FHIR` vertical." }, + "jsonParams": { + "description": "The parameters for the entity to facilitate data ingestion in json string format.", + "type": "string" + }, "keyPropertyMappings": { "additionalProperties": { "type": "string" @@ -18238,7 +19343,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The parameters for the entity to facilitate data ingestion. E.g. for BigQuery connectors: * Key: `document_id_column` * Value: type STRING. The value of the column ID.", + "description": "The parameters for the entity to facilitate data ingestion in structured json format.", "type": "object" }, "startingSchema": { @@ -18270,6 +19375,20 @@ "description": "Output only. CMEK-related information for the DataStore.", "readOnly": true }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -18621,6 +19740,10 @@ }, "type": "array" }, + "jsonParams": { + "description": "Additional parameters for this destination config in json string format.", + "type": "string" + }, "key": { "description": "Optional. Unique destination identifier that is supported by the connector.", "type": "string" @@ -18630,7 +19753,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. Additional parameters for this destination config.", + "description": "Optional. Additional parameters for this destination config in structured json format.", "type": "object" } }, @@ -19088,6 +20211,18 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaEngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -19123,7 +20258,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -20990,6 +22125,20 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaListBranchesResponse": { + "description": "Response for BranchService.ListBranches method.", + "id": "GoogleCloudDiscoveryengineV1alphaListBranchesResponse", + "properties": { + "branches": { + "description": "The Branches.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1alphaBranch" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaListChunksResponse": { "description": "Response message for ChunkService.ListChunks method.", "id": "GoogleCloudDiscoveryengineV1alphaListChunksResponse", @@ -21642,6 +22791,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -21664,6 +22817,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1alphaProjectServiceTerms", @@ -21737,6 +22927,10 @@ "acceptBizQos": { "description": "Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].", "type": "boolean" + }, + "isBiz": { + "description": "Optional. Indicates if the current request is for Biz edition (= true) or not (= false).", + "type": "boolean" } }, "type": "object" @@ -23041,10 +24235,10 @@ }, "naturalLanguageQueryUnderstandingSpec": { "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", - "description": "Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." + "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "offset": { - "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.", + "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold.", "format": "int32", "type": "integer" }, @@ -23144,6 +24338,10 @@ "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" }, + "searchAddonSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec", + "description": "Optional. SearchAddonSpec is used to disable add-ons for search as per new repricing model. This field is only supported for search requests." + }, "searchAsYouTypeSpec": { "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec", "description": "Search as you type configuration. Only supported for the IndustryVertical.MEDIA vertical." @@ -23650,6 +24848,13 @@ "description": "Specification to enable natural language understanding capabilities for search requests.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { + "allowedFieldNames": { + "description": "Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.", + "items": { + "type": "string" + }, + "type": "array" + }, "extractedFilterBehavior": { "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.", "enum": [ @@ -23745,6 +24950,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec": { + "description": "SearchAddonSpec is used to disable add-ons for search as per new repricing model. By default if the SearchAddonSpec is not specified, we consider that the customer wants to enable them wherever applicable.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec", + "properties": { + "disableGenerativeAnswerAddOn": { + "description": "Optional. If true, generative answer add-on is disabled. Generative answer add-on includes natural language to filters and simple answers.", + "type": "boolean" + }, + "disableKpiPersonalizationAddOn": { + "description": "Optional. If true, disables event re-ranking and personalization to optimize KPIs \u0026 personalize results.", + "type": "boolean" + }, + "disableSemanticAddOn": { + "description": "Optional. If true, semantic add-on is disabled. Semantic add-on includes embeddings and jetstream.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec": { "description": "Specification for search as you type in search requests.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec", @@ -26583,6 +27807,10 @@ "description": "Whether or not to enable autocomplete.", "type": "boolean" }, + "enableCreateAgentButton": { + "description": "Optional. If set to true, the widget will enable the create agent button.", + "type": "boolean" + }, "enablePeopleSearch": { "description": "Optional. If set to true, the widget will enable people search.", "type": "boolean" @@ -26617,7 +27845,7 @@ ], "type": "string" }, - "description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "readOnly": true, "type": "object" }, @@ -27366,6 +28594,20 @@ "description": "Output only. CMEK-related information for the DataStore.", "readOnly": true }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -27875,6 +29117,18 @@ "$ref": "GoogleCloudDiscoveryengineV1betaEngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -27910,7 +29164,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -28721,6 +29975,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -28743,6 +30001,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1betaProjectServiceTerms", @@ -29084,10 +30379,10 @@ }, "naturalLanguageQueryUnderstandingSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", - "description": "Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." + "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "offset": { - "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.", + "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold.", "format": "int32", "type": "integer" }, @@ -29187,6 +30482,10 @@ "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" }, + "searchAddonSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec", + "description": "Optional. SearchAddonSpec is used to disable add-ons for search as per new repricing model. This field is only supported for search requests." + }, "searchAsYouTypeSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec", "description": "Search as you type configuration. Only supported for the IndustryVertical.MEDIA vertical." @@ -29689,6 +30988,13 @@ "description": "Specification to enable natural language understanding capabilities for search requests.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { + "allowedFieldNames": { + "description": "Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.", + "items": { + "type": "string" + }, + "type": "array" + }, "extractedFilterBehavior": { "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.", "enum": [ @@ -29784,6 +31090,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec": { + "description": "SearchAddonSpec is used to disable add-ons for search as per new repricing model. By default if the SearchAddonSpec is not specified, we consider that the customer wants to enable them wherever applicable.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec", + "properties": { + "disableGenerativeAnswerAddOn": { + "description": "Optional. If true, generative answer add-on is disabled. Generative answer add-on includes natural language to filters and simple answers.", + "type": "boolean" + }, + "disableKpiPersonalizationAddOn": { + "description": "Optional. If true, disables event re-ranking and personalization to optimize KPIs \u0026 personalize results.", + "type": "boolean" + }, + "disableSemanticAddOn": { + "description": "Optional. If true, semantic add-on is disabled. Semantic add-on includes embeddings and jetstream.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec": { "description": "Specification for search as you type in search requests.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec", @@ -30328,16 +31653,15 @@ "description": "An audio overview of a notebook. This is a summary of the notebook in audio format.", "id": "GoogleCloudNotebooklmV1alphaAudioOverview", "properties": { - "audio": { - "description": "The audio overview in wav format. This is only present if the status is AUDIO_OVERVIEW_STATUS_COMPLETE.", - "format": "byte", - "type": "string" - }, "audioOverviewId": { "description": "Output only. Unique ID of the audio overview.", "readOnly": true, "type": "string" }, + "generationOptions": { + "$ref": "GoogleCloudNotebooklmV1alphaAudioOverviewGenerationOptions", + "description": "The options used to generate the audio overview." + }, "languageCode": { "description": "The language code of the generated audio overview. Use the BCP 47 language code (e.g. \"en\", \"es\", \"hi\", etc.).", "type": "string" @@ -30360,10 +31684,6 @@ "description": "Identifier. The full resource name of the notebook. Format: `projects/{project}/locations/{location}/notebooks/{notebook}/audioOverviews/{audio_overview_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.", "type": "string" }, - "playbackUrl": { - "description": "The url used to play the audio overview.", - "type": "string" - }, "status": { "description": "The status of the audio overview.", "enum": [ diff --git a/discoveryengine/v1alpha/discoveryengine-gen.go b/discoveryengine/v1alpha/discoveryengine-gen.go index ad0ee121b74..fa8d2c5dfbc 100644 --- a/discoveryengine/v1alpha/discoveryengine-gen.go +++ b/discoveryengine/v1alpha/discoveryengine-gen.go @@ -1287,6 +1287,9 @@ type ApiservingMediaRequestInfo struct { // requests are just for informational purposes, the response does not need to // contain anything. NotificationType string `json:"notificationType,omitempty"` + // PhysicalHeaders: The physical headers provided by RequestReceivedParameters + // in Scotty request. type is uploader_service.KeyValuePairs. + PhysicalHeaders string `json:"physicalHeaders,omitempty"` // RequestId: The Scotty request ID. RequestId string `json:"requestId,omitempty"` // RequestReceivedParamsServingInfo: The partition of the Scotty server @@ -2680,6 +2683,42 @@ func (s GoogleCloudDiscoveryengineV1AclConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1ActionConfig: Informations to support actions on +// the connector. +type GoogleCloudDiscoveryengineV1ActionConfig struct { + // ActionParams: Optional. Action parameters in structured json format. + ActionParams googleapi.RawMessage `json:"actionParams,omitempty"` + // IsActionConfigured: Output only. The connector contains the necessary + // parameters and is configured to support actions. + IsActionConfigured bool `json:"isActionConfigured,omitempty"` + // JsonActionParams: Optional. Action parameters in json string format. + JsonActionParams string `json:"jsonActionParams,omitempty"` + // ServiceName: Optional. The Service Directory resource name + // (projects/*/locations/*/namespaces/*/services/*) representing a VPC network + // endpoint used to connect to the data source's `instance_uri`, defined in + // DataConnector.params. Required when VPC Service Controls are enabled. + ServiceName string `json:"serviceName,omitempty"` + // UseStaticSecrets: Optional. Whether to use static secrets for the connector. + // If true, the secrets provided in the action_params will be ignored. + UseStaticSecrets bool `json:"useStaticSecrets,omitempty"` + // ForceSendFields is a list of field names (e.g. "ActionParams") 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. "ActionParams") 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 GoogleCloudDiscoveryengineV1ActionConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ActionConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig: Configuration data for // advance site search. type GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig struct { @@ -2707,6 +2746,63 @@ func (s GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1AlertPolicyConfig: The connector level alert +// config. +type GoogleCloudDiscoveryengineV1AlertPolicyConfig struct { + // AlertEnrollments: Optional. The enrollment states of each alert. + AlertEnrollments []*GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment `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 GoogleCloudDiscoveryengineV1AlertPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AlertPolicyConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment: The alert +// enrollment status. +type GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment 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 GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1AnswerGenerationSpec: The specification for // answer generation. type GoogleCloudDiscoveryengineV1AnswerGenerationSpec struct { @@ -3049,6 +3145,40 @@ func (s GoogleCloudDiscoveryengineV1AssistantToolList) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1BAPConfig: The configuration for the BAP +// connector. +type GoogleCloudDiscoveryengineV1BAPConfig struct { + // EnabledActions: Optional. The actions enabled on the associated BAP + // connection. + EnabledActions []string `json:"enabledActions,omitempty"` + // SupportedConnectorModes: Required. The supported connector modes for the + // associated BAP connection. + // + // Possible values: + // "CONNECTOR_MODE_UNSPECIFIED" - Connector mode unspecified. + // "DATA_INGESTION" - Connector utilized for data ingestion. + // "ACTIONS" - Connector utilized for Actions + // "END_USER_AUTHENTICATION" - Connector utilized for End User + // Authentication. + SupportedConnectorModes []string `json:"supportedConnectorModes,omitempty"` + // ForceSendFields is a list of field names (e.g. "EnabledActions") 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. "EnabledActions") 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 GoogleCloudDiscoveryengineV1BAPConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1BAPConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata: Metadata related // to the progress of the SiteSearchEngineService.BatchCreateTargetSites // operation. This will be returned by the @@ -3223,6 +3353,37 @@ func (s GoogleCloudDiscoveryengineV1CmekConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1Collection: Collection is a container for +// configuring resources and access to a set of DataStores. +type GoogleCloudDiscoveryengineV1Collection struct { + // CreateTime: Output only. Timestamp the Collection was created at. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Required. The Collection display name. This field must be a + // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. + DisplayName string `json:"displayName,omitempty"` + // Name: Immutable. The full resource name of the Collection. Format: + // `projects/{project}/locations/{location}/collections/{collection_id}`. This + // field must be a UTF-8 encoded string with a length limit of 1024 characters. + Name string `json:"name,omitempty"` + // 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 GoogleCloudDiscoveryengineV1Collection) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1Collection + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1Condition: Defines circumstances to be checked // before allowing a behavior type GoogleCloudDiscoveryengineV1Condition struct { @@ -3779,6 +3940,451 @@ func (s GoogleCloudDiscoveryengineV1CreateTargetSiteMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DataConnector: Manages the connection to +// external data sources for all data stores grouped under a Collection. It's a +// singleton resource of Collection. The initialization is only supported +// through DataConnectorService.SetUpDataConnector method, which will create a +// new Collection and initialize its DataConnector. +type GoogleCloudDiscoveryengineV1DataConnector struct { + // AclEnabled: Optional. Whether the connector will be created with an ACL + // config. Currently this field only affects Cloud Storage and BigQuery + // connectors. + AclEnabled bool `json:"aclEnabled,omitempty"` + // ActionConfig: Optional. Action configurations to make the connector support + // actions. + ActionConfig *GoogleCloudDiscoveryengineV1ActionConfig `json:"actionConfig,omitempty"` + // ActionState: Output only. State of the action connector. This reflects + // whether the action connector is initializing, active or has encountered + // errors. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + ActionState string `json:"actionState,omitempty"` + // AlertPolicyConfigs: Optional. The connector level alert config. + AlertPolicyConfigs []*GoogleCloudDiscoveryengineV1AlertPolicyConfig `json:"alertPolicyConfigs,omitempty"` + // AutoRunDisabled: Optional. Indicates whether the connector is disabled for + // auto run. It can be used to pause periodical and real time sync. Update: + // with the introduction of incremental_sync_disabled, auto_run_disabled is + // used to pause/disable only full syncs + AutoRunDisabled bool `json:"autoRunDisabled,omitempty"` + // BapConfig: Optional. The configuration for establishing a BAP connection. + BapConfig *GoogleCloudDiscoveryengineV1BAPConfig `json:"bapConfig,omitempty"` + // BlockingReasons: Output only. User actions that must be completed before the + // connector can start syncing data. + // + // Possible values: + // "BLOCKING_REASON_UNSPECIFIED" - Default value. + // "ALLOWLIST_STATIC_IP" - Connector requires customer to allowlist static + // IPs. + // "ALLOWLIST_IN_SERVICE_ATTACHMENT" - Connector requires customer to + // allowlist our project in their service attachment. + // "ALLOWLIST_SERVICE_ACCOUNT" - Connector requires customer to allowlist + // service account in their project. + BlockingReasons []string `json:"blockingReasons,omitempty"` + // ConnectorModes: Optional. The modes enabled for this connector. Default + // state is CONNECTOR_MODE_UNSPECIFIED. + // + // Possible values: + // "CONNECTOR_MODE_UNSPECIFIED" - Connector mode unspecified. + // "DATA_INGESTION" - Connector utilized for data ingestion. + // "ACTIONS" - Connector utilized for actions. + // "FEDERATED" - Connector utilized for federated search. + // "EUA" - Connector utilized for End User Authentication. + // "FEDERATED_AND_EUA" - Hybrid connector utilized for federated search and + // End User Authentication. + ConnectorModes []string `json:"connectorModes,omitempty"` + // ConnectorType: Output only. The type of connector. Each source can only map + // to one type. For example, salesforce, confluence and jira have THIRD_PARTY + // connector type. It is not mutable once set by system. + // + // Possible values: + // "CONNECTOR_TYPE_UNSPECIFIED" - Default value. + // "THIRD_PARTY" - Third party connector to connector to third party + // application. + // "GCP_FHIR" - Data connector connects between FHIR store and VAIS + // datastore. + // "BIG_QUERY" - Big query connector. + // "GCS" - Google Cloud Storage connector. + // "GOOGLE_MAIL" - Gmail connector. + // "GOOGLE_CALENDAR" - Google Calendar connector. + // "GOOGLE_DRIVE" - Google Drive connector. + // "NATIVE_CLOUD_IDENTITY" - Native Cloud Identity connector for people + // search powered by People API. + // "THIRD_PARTY_FEDERATED" - Federated connector, it is a third party + // connector that doesn't ingestion data, and search is powered by third party + // application's API. + // "THIRD_PARTY_EUA" - Connector utilized for End User Authentication + // features. + // "GCNV" - Google Cloud NetApp Volumes connector. + ConnectorType string `json:"connectorType,omitempty"` + // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is + // created in SaaS. + CreateEuaSaas bool `json:"createEuaSaas,omitempty"` + // CreateTime: Output only. Timestamp the DataConnector was created at. + CreateTime string `json:"createTime,omitempty"` + // DataSource: Required. The name of the data source. Supported values: + // `salesforce`, `jira`, `confluence`, `bigquery`. + DataSource string `json:"dataSource,omitempty"` + // DestinationConfigs: Optional. Any target destinations used to connect to + // third-party services. + DestinationConfigs []*GoogleCloudDiscoveryengineV1DestinationConfig `json:"destinationConfigs,omitempty"` + // EndUserConfig: Optional. Any params and credentials used specifically for + // EUA connectors. + EndUserConfig *GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig `json:"endUserConfig,omitempty"` + // Entities: List of entities from the connected data source to ingest. + Entities []*GoogleCloudDiscoveryengineV1DataConnectorSourceEntity `json:"entities,omitempty"` + // Errors: Output only. The errors from initialization or from the latest + // connector run. + Errors []*GoogleRpcStatus `json:"errors,omitempty"` + // FederatedConfig: Optional. Any params and credentials used specifically for + // hybrid connectors supporting FEDERATED mode. This field should only be set + // if the connector is a hybrid connector and we want to enable FEDERATED mode. + FederatedConfig *GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig `json:"federatedConfig,omitempty"` + // HybridIngestionDisabled: Optional. If the connector is a hybrid connector, + // determines whether ingestion is enabled and appropriate resources are + // provisioned during connector creation. If the connector is not a hybrid + // connector, this field is ignored. + HybridIngestionDisabled bool `json:"hybridIngestionDisabled,omitempty"` + // IdentityRefreshInterval: The refresh interval to sync the Access Control + // List information for the documents ingested by this connector. If not set, + // the access control list will be refreshed at the default interval of 30 + // minutes. The identity refresh interval can be at least 30 minutes and at + // most 7 days. + IdentityRefreshInterval string `json:"identityRefreshInterval,omitempty"` + // IdentityScheduleConfig: The configuration for the identity data + // synchronization runs. This contains the refresh interval to sync the Access + // Control List information for the documents ingested by this connector. + IdentityScheduleConfig *GoogleCloudDiscoveryengineV1IdentityScheduleConfig `json:"identityScheduleConfig,omitempty"` + // IncrementalRefreshInterval: Optional. The refresh interval specifically for + // incremental data syncs. If unset, incremental syncs will use the default + // from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. + // Applicable to only 3P connectors. When the refresh interval is set to the + // same value as the incremental refresh interval, incremental sync will be + // disabled. + IncrementalRefreshInterval string `json:"incrementalRefreshInterval,omitempty"` + // IncrementalSyncDisabled: Optional. Indicates whether incremental syncs are + // paused for this connector. This is independent of auto_run_disabled. + // Applicable to only 3P connectors. When the refresh interval is set to the + // same value as the incremental refresh interval, incremental sync will be + // disabled, i.e. set to true. + IncrementalSyncDisabled bool `json:"incrementalSyncDisabled,omitempty"` + // JsonParams: Required data connector parameters in json string format. + JsonParams string `json:"jsonParams,omitempty"` + // KmsKeyName: Input only. The KMS key to be used to protect the DataStores + // managed by this connector. Must be set for requests that need to comply with + // CMEK Org Policy protections. If this field is set and processed + // successfully, the DataStores created by this connector will be protected by + // the KMS key. + KmsKeyName string `json:"kmsKeyName,omitempty"` + // LastSyncTime: Output only. For periodic connectors only, the last time a + // data sync was completed. + LastSyncTime string `json:"lastSyncTime,omitempty"` + // LatestPauseTime: Output only. The most recent timestamp when this + // DataConnector was paused, affecting all functionalities such as data + // synchronization. Pausing a connector has the following effects: - All + // functionalities, including data synchronization, are halted. - Any ongoing + // data synchronization job will be canceled. - No future data synchronization + // runs will be scheduled nor can be triggered. + LatestPauseTime string `json:"latestPauseTime,omitempty"` + // Name: Output only. The full resource name of the Data Connector. Format: + // `projects/*/locations/*/collections/*/dataConnector`. + Name string `json:"name,omitempty"` + // NextSyncTime: Defines the scheduled time for the next data synchronization. + // This field requires hour , minute, and time_zone from the IANA Time Zone + // Database (https://www.iana.org/time-zones). This is utilized when the data + // connector has a refresh interval greater than 1 day. When the hours or + // minutes are not specified, we will assume a sync time of 0:00. The user must + // provide a time zone to avoid ambiguity. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` + // Params: Required data connector parameters in structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // PrivateConnectivityProjectId: Output only. The tenant project ID associated + // with private connectivity connectors. This project must be allowlisted by in + // order for the connector to function. + PrivateConnectivityProjectId string `json:"privateConnectivityProjectId,omitempty"` + // RealtimeState: Output only. real-time sync state + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + RealtimeState string `json:"realtimeState,omitempty"` + // RealtimeSyncConfig: Optional. The configuration for realtime sync. + RealtimeSyncConfig *GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig `json:"realtimeSyncConfig,omitempty"` + // RefreshInterval: Required. The refresh interval for data sync. If duration + // is set to 0, the data will be synced in real time. The streaming feature is + // not supported yet. The minimum is 30 minutes and maximum is 7 days. When the + // refresh interval is set to the same value as the incremental refresh + // interval, incremental sync will be disabled. + RefreshInterval string `json:"refreshInterval,omitempty"` + // RemoveParamKeys: Optional. Specifies keys to be removed from the 'params' + // field. This is only active when 'params' is included in the 'update_mask' in + // an UpdateDataConnectorRequest. Deletion takes precedence if a key is both in + // 'remove_param_keys' and present in the 'params' field of the request. + RemoveParamKeys []string `json:"removeParamKeys,omitempty"` + // State: Output only. State of the connector. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + State string `json:"state,omitempty"` + // StaticIpAddresses: Output only. The static IP addresses used by this + // connector. + StaticIpAddresses []string `json:"staticIpAddresses,omitempty"` + // StaticIpEnabled: Optional. Whether customer has enabled static IP addresses + // for this connector. + StaticIpEnabled bool `json:"staticIpEnabled,omitempty"` + // SyncMode: The data synchronization mode supported by the data connector. + // + // Possible values: + // "PERIODIC" - The connector will sync data periodically based on the + // refresh_interval. Use it with auto_run_disabled to pause the periodic sync, + // or indicate a one-time sync. + // "STREAMING" - The data will be synced in real time. + // "UNSPECIFIED" - Connector that doesn't ingest data will have this value + SyncMode string `json:"syncMode,omitempty"` + // UpdateTime: Output only. Timestamp the DataConnector was last updated. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "AclEnabled") 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. "AclEnabled") 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 GoogleCloudDiscoveryengineV1DataConnector) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnector + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig: Any params and +// credentials used specifically for EUA connectors. +type GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig struct { + // AdditionalParams: Optional. Any additional parameters needed for EUA. + AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` + // AuthParams: Optional. Any authentication parameters specific to EUA + // connectors. + AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to EUA + // connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` + // Tenant: Optional. The tenant project the connector is connected to. + Tenant *GoogleCloudDiscoveryengineV1Tenant `json:"tenant,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalParams") 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. "AdditionalParams") 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 GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig: Any params and +// credentials used specifically for hybrid connectors supporting FEDERATED +// mode. +type GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig struct { + // AdditionalParams: Optional. Any additional parameters needed for FEDERATED. + AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` + // AuthParams: Optional. Any authentication parameters specific to FEDERATED + // connectors. + AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to + // FEDERATED connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalParams") 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. "AdditionalParams") 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 GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig: The +// configuration for realtime sync to store additional params for realtime +// sync. +type GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig struct { + // RealtimeSyncSecret: Optional. The ID of the Secret Manager secret used for + // webhook secret. + RealtimeSyncSecret string `json:"realtimeSyncSecret,omitempty"` + // StreamingError: Optional. Streaming error details. + StreamingError *GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError `json:"streamingError,omitempty"` + // WebhookUri: Optional. Webhook url for the connector to specify additional + // params for realtime sync. + WebhookUri string `json:"webhookUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "RealtimeSyncSecret") 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. "RealtimeSyncSecret") 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 GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError: +// Streaming error details. +type GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError struct { + // Error: Optional. Error details. + Error *GoogleRpcStatus `json:"error,omitempty"` + // StreamingErrorReason: Optional. Streaming error. + // + // Possible values: + // "STREAMING_ERROR_REASON_UNSPECIFIED" - Streaming error reason unspecified. + // "STREAMING_SETUP_ERROR" - Some error occurred while setting up resources + // for realtime sync. + // "STREAMING_SYNC_ERROR" - Some error was encountered while running realtime + // sync for the connector. + // "INGRESS_ENDPOINT_REQUIRED" - Ingress endpoint is required when setting up + // realtime sync in private connectivity. + StreamingErrorReason string `json:"streamingErrorReason,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") 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. "Error") 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 GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorSourceEntity: Represents an entity +// in the data source. For example, the `Account` object in Salesforce. +type GoogleCloudDiscoveryengineV1DataConnectorSourceEntity struct { + // DataStore: Output only. The full resource name of the associated data store + // for the source entity. Format: + // `projects/*/locations/*/collections/*/dataStores/*`. When the connector is + // initialized by the DataConnectorService.SetUpDataConnector method, a + // DataStore is automatically created for each source entity. + DataStore string `json:"dataStore,omitempty"` + // EntityName: The name of the entity. Supported values by data source: * + // Salesforce: `Lead`, `Opportunity`, `Contact`, `Account`, `Case`, `Contract`, + // `Campaign` * Jira: `Issue` * Confluence: `Content`, `Space` + EntityName string `json:"entityName,omitempty"` + // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` + // vertical. + HealthcareFhirConfig *GoogleCloudDiscoveryengineV1HealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` + // JsonParams: The parameters for the entity to facilitate data ingestion in + // json string format. + JsonParams string `json:"jsonParams,omitempty"` + // KeyPropertyMappings: Attributes for indexing. Key: Field name. Value: The + // key property to map a field to, such as `title`, and `description`. + // Supported key properties: * `title`: The title for data record. This would + // be displayed on search results. * `description`: The description for data + // record. This would be displayed on search results. + KeyPropertyMappings map[string]string `json:"keyPropertyMappings,omitempty"` + // Params: The parameters for the entity to facilitate data ingestion in + // structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // StartingSchema: Optional. The start schema to use for the DataStore created + // from this SourceEntity. If unset, a default vertical specialized schema will + // be used. This field is only used by SetUpDataConnector API, and will be + // ignored if used in other APIs. This field will be omitted from all API + // responses including GetDataConnector API. To retrieve a schema of a + // DataStore, use SchemaService.GetSchema API instead. The provided schema will + // be validated against certain rules on schema. Learn more from this doc + // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). + StartingSchema *GoogleCloudDiscoveryengineV1Schema `json:"startingSchema,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 + // 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. "DataStore") 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 GoogleCloudDiscoveryengineV1DataConnectorSourceEntity) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorSourceEntity + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings // and configs at the DataStore level. type GoogleCloudDiscoveryengineV1DataStore struct { @@ -3796,6 +4402,18 @@ type GoogleCloudDiscoveryengineV1DataStore struct { BillingEstimation *GoogleCloudDiscoveryengineV1DataStoreBillingEstimation `json:"billingEstimation,omitempty"` // CmekConfig: Output only. CMEK-related information for the DataStore. CmekConfig *GoogleCloudDiscoveryengineV1CmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -3986,6 +4604,33 @@ func (s GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DeleteCollectionMetadata: Metadata related to +// the progress of the CollectionService.UpdateCollection operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteCollectionMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // 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 GoogleCloudDiscoveryengineV1DeleteCollectionMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteCollectionMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata: Metadata related to the // progress of the DataStoreService.DeleteDataStore operation. This will be // returned by the google.longrunning.Operation.metadata field. @@ -4148,6 +4793,63 @@ func (s GoogleCloudDiscoveryengineV1DeleteTargetSiteMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DestinationConfig: Defines target endpoints used +// to connect to third-party sources. +type GoogleCloudDiscoveryengineV1DestinationConfig struct { + // Destinations: Optional. The destinations for the corresponding key. + Destinations []*GoogleCloudDiscoveryengineV1DestinationConfigDestination `json:"destinations,omitempty"` + // JsonParams: Additional parameters for this destination config in json string + // format. + JsonParams string `json:"jsonParams,omitempty"` + // Key: Optional. Unique destination identifier that is supported by the + // connector. + Key string `json:"key,omitempty"` + // Params: Optional. Additional parameters for this destination config in + // structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // ForceSendFields is a list of field names (e.g. "Destinations") 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. "Destinations") 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 GoogleCloudDiscoveryengineV1DestinationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DestinationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DestinationConfigDestination: Defines a target +// endpoint +type GoogleCloudDiscoveryengineV1DestinationConfigDestination struct { + // Host: Publicly routable host. + Host string `json:"host,omitempty"` + // Port: Optional. Target port number accepted by the destination. + Port int64 `json:"port,omitempty"` + // ForceSendFields is a list of field names (e.g. "Host") 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. "Host") 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 GoogleCloudDiscoveryengineV1DestinationConfigDestination) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DestinationConfigDestination + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchMetadata: Metadata // related to the progress of the // SiteSearchEngineService.DisableAdvancedSiteSearch operation. This will be @@ -4432,6 +5134,15 @@ type GoogleCloudDiscoveryengineV1Engine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1EngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1EngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -4453,8 +5164,8 @@ type GoogleCloudDiscoveryengineV1Engine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -4925,6 +5636,38 @@ func (s GoogleCloudDiscoveryengineV1IdentityMappingEntryOperationMetadata) Marsh return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1IdentityScheduleConfig: The configuration for +// the identity data synchronization runs. +type GoogleCloudDiscoveryengineV1IdentityScheduleConfig struct { + // NextSyncTime: Optional. The UTC time when the next data sync is expected to + // start for the Data Connector. Customers are only able to specify the hour + // and minute to schedule the data sync. This is utilized when the data + // connector has a refresh interval greater than 1 day. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` + // RefreshInterval: Optional. The refresh interval to sync the Access Control + // List information for the documents ingested by this connector. If not set, + // the access control list will be refreshed at the default interval of 30 + // minutes. The identity refresh interval can be at least 30 minutes and at + // most 7 days. + RefreshInterval string `json:"refreshInterval,omitempty"` + // ForceSendFields is a list of field names (e.g. "NextSyncTime") 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. "NextSyncTime") 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 GoogleCloudDiscoveryengineV1IdentityScheduleConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1IdentityScheduleConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1IdpConfig: Identity Provider Config. type GoogleCloudDiscoveryengineV1IdpConfig struct { // ExternalIdpConfig: External Identity provider config. @@ -5272,6 +6015,8 @@ func (s GoogleCloudDiscoveryengineV1ImportUserEventsResponse) MarshalJSON() ([]b type GoogleCloudDiscoveryengineV1Project struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -5302,6 +6047,85 @@ func (s GoogleCloudDiscoveryengineV1Project) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig: Customer provided +// configurations. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig: +// Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigMode +// lArmorConfig: Configuration for customer defined Model Armor templates to be +// used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1ProjectServiceTerms: Metadata about the terms of // service. type GoogleCloudDiscoveryengineV1ProjectServiceTerms struct { @@ -6106,6 +6930,11 @@ func (s *GoogleCloudDiscoveryengineV1ServingConfigMediaConfig) UnmarshalJSON(dat return nil } +// GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata: Metadata for +// DataConnectorService.SetUpDataConnector method. +type GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata struct { +} + // GoogleCloudDiscoveryengineV1SingleRegionKey: Metadata for single-regional // CMEKs. type GoogleCloudDiscoveryengineV1SingleRegionKey struct { @@ -6312,6 +7141,38 @@ func (s GoogleCloudDiscoveryengineV1TargetSiteFailureReasonQuotaFailure) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1Tenant: Tenant information for a connector +// source. This includes some of the same information stored in the Credential +// message, but is limited to only what is needed to provide a list of +// accessible tenants to the user. +type GoogleCloudDiscoveryengineV1Tenant struct { + // DisplayName: Optional display name for the tenant, e.g. "My Slack Team". + DisplayName string `json:"displayName,omitempty"` + // Id: The tenant's instance ID. Examples: Jira + // ("8594f221-9797-5f78-1fa4-485e198d7cd0"), Slack ("T123456"). + Id string `json:"id,omitempty"` + // Uri: The URI of the tenant, if applicable. For example, the URI of a Jira + // instance is https://my-jira-instance.atlassian.net, and a Slack tenant does + // not have a URI. + Uri string `json:"uri,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 GoogleCloudDiscoveryengineV1Tenant) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1Tenant + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1TrainCustomModelMetadata: Metadata related to // the progress of the TrainCustomModel operation. This is returned by the // google.longrunning.Operation.metadata field. @@ -6624,17 +7485,13 @@ func (s GoogleCloudDiscoveryengineV1alphaAcquireAccessTokenResponse) MarshalJSON // GoogleCloudDiscoveryengineV1alphaActionConfig: Informations to support // actions on the connector. type GoogleCloudDiscoveryengineV1alphaActionConfig struct { - // ActionParams: Required. Params needed to support actions in the format of - // (Key, Value) pairs. Required parameters for sources that support OAUTH, i.e. - // `gmail`, `google_calendar`, `jira`, `workday`, `salesforce`, `confluence`: * - // Key: `client_id` * Value: type STRING. The client ID for the service - // provider to identify your application. * Key: `client_secret` * Value:type - // STRING. The client secret generated by the application's authorization - // server. + // ActionParams: Optional. Action parameters in structured json format. ActionParams googleapi.RawMessage `json:"actionParams,omitempty"` // IsActionConfigured: Output only. The connector contains the necessary // parameters and is configured to support actions. IsActionConfigured bool `json:"isActionConfigured,omitempty"` + // JsonActionParams: Optional. Action parameters in json string format. + JsonActionParams string `json:"jsonActionParams,omitempty"` // ServiceName: Optional. The Service Directory resource name // (projects/*/locations/*/namespaces/*/services/*) representing a VPC network // endpoint used to connect to the data source's `instance_uri`, defined in @@ -9125,6 +9982,13 @@ type GoogleCloudDiscoveryengineV1alphaAssistAnswerReply struct { // GroundedContent: Possibly grounded response text or media from the // assistant. GroundedContent *GoogleCloudDiscoveryengineV1alphaAssistantGroundedContent `json:"groundedContent,omitempty"` + // ReplyId: Output only. When set, uniquely identifies a reply within the + // `AssistAnswer` resource. During an AssistantService.StreamAssist call, + // multiple `Reply` messages with the same ID can occur within the response + // stream (across multiple AssistantService.StreamAssistResponse messages). + // These represent parts of a single `Reply` message in the final + // `AssistAnswer` resource. + ReplyId string `json:"replyId,omitempty"` // ForceSendFields is a list of field names (e.g. "GroundedContent") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -9612,6 +10476,9 @@ type GoogleCloudDiscoveryengineV1alphaAssistantGroundedContentTextGroundingMetad // contain a URL that redirects to the actual website, in which case this will // contain the domain name of the target site. Domain string `json:"domain,omitempty"` + // MimeType: The mime type of the document. + // https://www.iana.org/assignments/media-types/media-types.xhtml. + MimeType string `json:"mimeType,omitempty"` // PageIdentifier: Page identifier. PageIdentifier string `json:"pageIdentifier,omitempty"` // Title: Title. @@ -9737,6 +10604,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAssistantToolList) MarshalJSON() ([]byt // GoogleCloudDiscoveryengineV1alphaBAPConfig: The configuration for the BAP // connector. type GoogleCloudDiscoveryengineV1alphaBAPConfig struct { + // EnabledActions: Optional. The actions enabled on the associated BAP + // connection. + EnabledActions []string `json:"enabledActions,omitempty"` // SupportedConnectorModes: Required. The supported connector modes for the // associated BAP connection. // @@ -9747,15 +10617,15 @@ type GoogleCloudDiscoveryengineV1alphaBAPConfig struct { // "END_USER_AUTHENTICATION" - Connector utilized for End User // Authentication. SupportedConnectorModes []string `json:"supportedConnectorModes,omitempty"` - // ForceSendFields is a list of field names (e.g. "SupportedConnectorModes") to + // ForceSendFields is a list of field names (e.g. "EnabledActions") 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. "SupportedConnectorModes") 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. "EnabledActions") 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:"-"` } @@ -10294,6 +11164,72 @@ func (s GoogleCloudDiscoveryengineV1alphaBigtableSource) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaBranch: A data branch that stores +// Documents. +type GoogleCloudDiscoveryengineV1alphaBranch struct { + // BranchStats: Output only. Stistics describing a branch. This field is not + // populated in BranchView.BASIC view. + BranchStats *GoogleCloudDiscoveryengineV1alphaBranchBranchStats `json:"branchStats,omitempty"` + // DisplayName: Output only. Human readable name of the branch to display in + // the UI. + DisplayName string `json:"displayName,omitempty"` + // IsDefault: Output only. Indicates whether this branch is set as the default + // branch of its parent data store. + IsDefault bool `json:"isDefault,omitempty"` + // LastDocumentImportTime: Output only. Timestamp of last import through + // DocumentService.ImportDocuments. Empty value means no import has been made + // to this branch. + LastDocumentImportTime string `json:"lastDocumentImportTime,omitempty"` + // Name: Immutable. Full resource name of the branch, such as + // `projects/*/locations/global/dataStores/data_store/branches/branch_id`. + 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. "BranchStats") 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. "BranchStats") 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 GoogleCloudDiscoveryengineV1alphaBranch) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaBranch + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaBranchBranchStats: Statistics describing a +// branch. +type GoogleCloudDiscoveryengineV1alphaBranchBranchStats struct { + // DocumentCounts: The number of documents in a given branch. The key is a + // group representing a set of documents, and the value is the number of + // document in that group. Note: keys in this map may change over time. + // Supported keys: ['all']. + DocumentCounts map[string]string `json:"documentCounts,omitempty"` + // ForceSendFields is a list of field names (e.g. "DocumentCounts") 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. "DocumentCounts") 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 GoogleCloudDiscoveryengineV1alphaBranchBranchStats) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaBranchBranchStats + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaCheckGroundingRequest: Request message for // GroundedGenerationService.CheckGrounding method. type GoogleCloudDiscoveryengineV1alphaCheckGroundingRequest struct { @@ -12416,6 +13352,8 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // same value as the incremental refresh interval, incremental sync will be // disabled, i.e. set to true. IncrementalSyncDisabled bool `json:"incrementalSyncDisabled,omitempty"` + // JsonParams: Required data connector parameters in json string format. + JsonParams string `json:"jsonParams,omitempty"` // KmsKeyName: Input only. The KMS key to be used to protect the DataStores // managed by this connector. Must be set for requests that need to comply with // CMEK Org Policy protections. If this field is set and processed @@ -12442,28 +13380,7 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // minutes are not specified, we will assume a sync time of 0:00. The user must // provide a time zone to avoid ambiguity. NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` - // Params: Required. Params needed to access the source in the format of (Key, - // Value) pairs. Required parameters for all data sources: * Key: - // `instance_uri` * Value: type STRING. The uri to access the data source. - // Required parameters for sources that support OAUTH, i.e. `salesforce`: * - // Key: `client_id` * Value: type STRING. The client ID for the third party - // service provider to identify your application. * Key: `client_secret` * - // Value:type STRING. The client secret generated by the third party - // authorization server. * Key: `access_token` * Value: type STRING. OAuth - // token for UCS to access to the protected resource. * Key: `refresh_token` * - // Value: type STRING. OAuth refresh token for UCS to obtain a new access token - // without user interaction. Required parameters for sources that support basic - // API token auth, i.e. `jira`, `confluence`: * Key: `user_account` * Value: - // type STRING. The username or email with the source. * Key: `api_token` * - // Value: type STRING. The API token generated for the source account, that is - // used for authenticating anywhere where you would have used a password. - // Example: ```json { "instance_uri": "https://xxx.atlassian.net", - // "user_account": "xxxx.xxx@xxx.com", "api_token": "test-token" } ``` Optional - // parameter to specify the authorization type to use for multiple - // authorization types support: * Key: `auth_type` * Value: type STRING. The - // authorization type for the data source. Supported values: `BASIC_AUTH`, - // `OAUTH`, `OAUTH_ACCESS_TOKEN`, `OAUTH_TWO_LEGGED`, `OAUTH_JWT_BEARER`, - // `OAUTH_PASSWORD_GRANT`, `JWT`, `API_TOKEN`, `FEDERATED_CREDENTIAL`. + // Params: Required data connector parameters in structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // PrivateConnectivityProjectId: Output only. The tenant project ID associated // with private connectivity connectors. This project must be allowlisted by in @@ -12568,6 +13485,9 @@ type GoogleCloudDiscoveryengineV1alphaDataConnectorEndUserConfig struct { // AuthParams: Optional. Any authentication parameters specific to EUA // connectors. AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to EUA + // connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` // Tenant: Optional. The tenant project the connector is connected to. Tenant *GoogleCloudDiscoveryengineV1alphaTenant `json:"tenant,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalParams") to @@ -12594,8 +13514,12 @@ func (s GoogleCloudDiscoveryengineV1alphaDataConnectorEndUserConfig) MarshalJSON type GoogleCloudDiscoveryengineV1alphaDataConnectorFederatedConfig struct { // AdditionalParams: Optional. Any additional parameters needed for FEDERATED. AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` - // AuthParams: Optional. Any authentication parameters specific to FEDERATED. + // AuthParams: Optional. Any authentication parameters specific to FEDERATED + // connectors. AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to + // FEDERATED connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalParams") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -12694,15 +13618,17 @@ type GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity struct { // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` // vertical. HealthcareFhirConfig *GoogleCloudDiscoveryengineV1alphaHealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` + // JsonParams: The parameters for the entity to facilitate data ingestion in + // json string format. + JsonParams string `json:"jsonParams,omitempty"` // KeyPropertyMappings: Attributes for indexing. Key: Field name. Value: The // key property to map a field to, such as `title`, and `description`. // Supported key properties: * `title`: The title for data record. This would // be displayed on search results. * `description`: The description for data // record. This would be displayed on search results. KeyPropertyMappings map[string]string `json:"keyPropertyMappings,omitempty"` - // Params: The parameters for the entity to facilitate data ingestion. E.g. for - // BigQuery connectors: * Key: `document_id_column` * Value: type STRING. The - // value of the column ID. + // Params: The parameters for the entity to facilitate data ingestion in + // structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // StartingSchema: Optional. The start schema to use for the DataStore created // from this SourceEntity. If unset, a default vertical specialized schema will @@ -12748,6 +13674,18 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { BillingEstimation *GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // CmekConfig: Output only. CMEK-related information for the DataStore. CmekConfig *GoogleCloudDiscoveryengineV1alphaCmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -13206,10 +14144,14 @@ func (s GoogleCloudDiscoveryengineV1alphaDeleteTargetSiteMetadata) MarshalJSON() type GoogleCloudDiscoveryengineV1alphaDestinationConfig struct { // Destinations: Optional. The destinations for the corresponding key. Destinations []*GoogleCloudDiscoveryengineV1alphaDestinationConfigDestination `json:"destinations,omitempty"` + // JsonParams: Additional parameters for this destination config in json string + // format. + JsonParams string `json:"jsonParams,omitempty"` // Key: Optional. Unique destination identifier that is supported by the // connector. Key string `json:"key,omitempty"` - // Params: Optional. Additional parameters for this destination config. + // Params: Optional. Additional parameters for this destination config in + // structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // ForceSendFields is a list of field names (e.g. "Destinations") to // unconditionally include in API requests. By default, fields with empty or @@ -13871,6 +14813,15 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1alphaEngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1alphaEngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -13892,8 +14843,8 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -16470,6 +17421,32 @@ func (s GoogleCloudDiscoveryengineV1alphaLanguageInfo) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaListBranchesResponse: Response for +// BranchService.ListBranches method. +type GoogleCloudDiscoveryengineV1alphaListBranchesResponse struct { + // Branches: The Branches. + Branches []*GoogleCloudDiscoveryengineV1alphaBranch `json:"branches,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "Branches") 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. "Branches") 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 GoogleCloudDiscoveryengineV1alphaListBranchesResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaListBranchesResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaListChunksResponse: Response message for // ChunkService.ListChunks method. type GoogleCloudDiscoveryengineV1alphaListChunksResponse struct { @@ -17534,6 +18511,8 @@ func (s GoogleCloudDiscoveryengineV1alphaProcessedDocument) MarshalJSON() ([]byt type GoogleCloudDiscoveryengineV1alphaProject struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -17567,6 +18546,85 @@ func (s GoogleCloudDiscoveryengineV1alphaProject) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig: Customer +// provided configurations. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfi +// g: Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfi +// gModelArmorConfig: Configuration for customer defined Model Armor templates +// to be used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaProjectServiceTerms: Metadata about the // terms of service. type GoogleCloudDiscoveryengineV1alphaProjectServiceTerms struct { @@ -17657,6 +18715,9 @@ type GoogleCloudDiscoveryengineV1alphaProvisionProjectRequestSaasParams struct { // would like to give consent to the [Terms for Agent Space quality of // service]. AcceptBizQos bool `json:"acceptBizQos,omitempty"` + // IsBiz: Optional. Indicates if the current request is for Biz edition (= + // true) or not (= false). + IsBiz bool `json:"isBiz,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceptBizQos") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -19513,9 +20574,9 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // better interpret the query. If a value isn't specified, the query language // code is automatically detected, which may not be accurate. LanguageCode string `json:"languageCode,omitempty"` - // NaturalLanguageQueryUnderstandingSpec: Config for natural language query - // understanding capabilities, such as extracting structured field filters from - // the query. Refer to this documentation + // NaturalLanguageQueryUnderstandingSpec: Optional. Config for natural language + // query understanding capabilities, such as extracting structured field + // filters from the query. Refer to this documentation // (https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) // for more information. If `naturalLanguageQueryUnderstandingSpec` is not // specified, no additional natural language query understanding will be done. @@ -19523,7 +20584,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as // relevant) in search results. This field is only considered if page_token is - // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. + // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large + // offset may be capped to a reasonable threshold. Offset int64 `json:"offset,omitempty"` // OneBoxPageSize: The maximum number of results to return for OneBox. This // applies to each OneBox type individually. Default number is 10. @@ -19665,6 +20727,10 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` + // SearchAddonSpec: Optional. SearchAddonSpec is used to disable add-ons for + // search as per new repricing model. This field is only supported for search + // requests. + SearchAddonSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec `json:"searchAddonSpec,omitempty"` // SearchAsYouTypeSpec: Search as you type configuration. Only supported for // the IndustryVertical.MEDIA vertical. SearchAsYouTypeSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec `json:"searchAsYouTypeSpec,omitempty"` @@ -20562,6 +21628,15 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestImageQuery) MarshalJSON() // ngSpec: Specification to enable natural language understanding capabilities // for search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { + // AllowedFieldNames: Optional. Allowlist of fields that can be used for + // natural language filter extraction. By default, if this is unspecified, all + // indexable fields are eligible for natural language filter extraction (but + // are not guaranteed to be used). If any fields are specified in + // allowed_field_names, only the fields that are both marked as indexable in + // the schema and specified in the allowlist will be eligible for natural + // language filter extraction. Note: for multi-datastore search, this is not + // yet supported, and will be ignored. + AllowedFieldNames []string `json:"allowedFieldNames,omitempty"` // ExtractedFilterBehavior: Optional. Controls behavior of how extracted // filters are applied to the search. The default behavior depends on the // request. For single datastore structured search, the default is @@ -20597,15 +21672,15 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstan // If this field is set, it overrides the field names set in // ServingConfig.geo_search_query_detection_field_names. GeoSearchQueryDetectionFieldNames []string `json:"geoSearchQueryDetectionFieldNames,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExtractedFilterBehavior") to + // ForceSendFields is a list of field names (e.g. "AllowedFieldNames") 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. "ExtractedFilterBehavior") 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. "AllowedFieldNames") 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:"-"` } @@ -20705,6 +21780,39 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceScoreSpec) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec: +// SearchAddonSpec is used to disable add-ons for search as per new repricing +// model. By default if the SearchAddonSpec is not specified, we consider that +// the customer wants to enable them wherever applicable. +type GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec struct { + // DisableGenerativeAnswerAddOn: Optional. If true, generative answer add-on is + // disabled. Generative answer add-on includes natural language to filters and + // simple answers. + DisableGenerativeAnswerAddOn bool `json:"disableGenerativeAnswerAddOn,omitempty"` + // DisableKpiPersonalizationAddOn: Optional. If true, disables event re-ranking + // and personalization to optimize KPIs & personalize results. + DisableKpiPersonalizationAddOn bool `json:"disableKpiPersonalizationAddOn,omitempty"` + // DisableSemanticAddOn: Optional. If true, semantic add-on is disabled. + // Semantic add-on includes embeddings and jetstream. + DisableSemanticAddOn bool `json:"disableSemanticAddOn,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DisableGenerativeAnswerAddOn") 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. "DisableGenerativeAnswerAddOn") 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 GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec: // Specification for search as you type in search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec struct { @@ -24369,6 +25477,9 @@ type GoogleCloudDiscoveryengineV1alphaWidgetConfigUiSettings struct { DisableUserEventsCollection bool `json:"disableUserEventsCollection,omitempty"` // EnableAutocomplete: Whether or not to enable autocomplete. EnableAutocomplete bool `json:"enableAutocomplete,omitempty"` + // EnableCreateAgentButton: Optional. If set to true, the widget will enable + // the create agent button. + EnableCreateAgentButton bool `json:"enableCreateAgentButton,omitempty"` // EnablePeopleSearch: Optional. If set to true, the widget will enable people // search. EnablePeopleSearch bool `json:"enablePeopleSearch,omitempty"` @@ -24388,8 +25499,8 @@ type GoogleCloudDiscoveryengineV1alphaWidgetConfigUiSettings struct { // features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * // `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * // `people-search-org-chart` * `bi-directional-audio` * `feedback` * - // `session-sharing` * `personalization-memory` - Enables personalization based - // on user preferences. + // `session-sharing` * `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // GenerativeAnswerConfig: Describes generative answer configuration. GenerativeAnswerConfig *GoogleCloudDiscoveryengineV1alphaWidgetConfigUiSettingsGenerativeAnswerConfig `json:"generativeAnswerConfig,omitempty"` @@ -25362,6 +26473,18 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { BillingEstimation *GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // CmekConfig: Output only. CMEK-related information for the DataStore. CmekConfig *GoogleCloudDiscoveryengineV1betaCmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -26014,6 +27137,15 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1betaEngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1betaEngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -26035,8 +27167,8 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -27205,6 +28337,8 @@ func (s GoogleCloudDiscoveryengineV1betaOrganicCrawlRateTimeSeries) MarshalJSON( type GoogleCloudDiscoveryengineV1betaProject struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -27235,6 +28369,85 @@ func (s GoogleCloudDiscoveryengineV1betaProject) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig: Customer +// provided configurations. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig +// : Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig +// ModelArmorConfig: Configuration for customer defined Model Armor templates +// to be used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaProjectServiceTerms: Metadata about the // terms of service. type GoogleCloudDiscoveryengineV1betaProjectServiceTerms struct { @@ -27698,9 +28911,9 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // better interpret the query. If a value isn't specified, the query language // code is automatically detected, which may not be accurate. LanguageCode string `json:"languageCode,omitempty"` - // NaturalLanguageQueryUnderstandingSpec: Config for natural language query - // understanding capabilities, such as extracting structured field filters from - // the query. Refer to this documentation + // NaturalLanguageQueryUnderstandingSpec: Optional. Config for natural language + // query understanding capabilities, such as extracting structured field + // filters from the query. Refer to this documentation // (https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) // for more information. If `naturalLanguageQueryUnderstandingSpec` is not // specified, no additional natural language query understanding will be done. @@ -27708,7 +28921,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as // relevant) in search results. This field is only considered if page_token is - // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. + // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large + // offset may be capped to a reasonable threshold. Offset int64 `json:"offset,omitempty"` // OneBoxPageSize: The maximum number of results to return for OneBox. This // applies to each OneBox type individually. Default number is 10. @@ -27850,6 +29064,10 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` + // SearchAddonSpec: Optional. SearchAddonSpec is used to disable add-ons for + // search as per new repricing model. This field is only supported for search + // requests. + SearchAddonSpec *GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec `json:"searchAddonSpec,omitempty"` // SearchAsYouTypeSpec: Search as you type configuration. Only supported for // the IndustryVertical.MEDIA vertical. SearchAsYouTypeSpec *GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec `json:"searchAsYouTypeSpec,omitempty"` @@ -28742,6 +29960,15 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestImageQuery) MarshalJSON() ( // gSpec: Specification to enable natural language understanding capabilities // for search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { + // AllowedFieldNames: Optional. Allowlist of fields that can be used for + // natural language filter extraction. By default, if this is unspecified, all + // indexable fields are eligible for natural language filter extraction (but + // are not guaranteed to be used). If any fields are specified in + // allowed_field_names, only the fields that are both marked as indexable in + // the schema and specified in the allowlist will be eligible for natural + // language filter extraction. Note: for multi-datastore search, this is not + // yet supported, and will be ignored. + AllowedFieldNames []string `json:"allowedFieldNames,omitempty"` // ExtractedFilterBehavior: Optional. Controls behavior of how extracted // filters are applied to the search. The default behavior depends on the // request. For single datastore structured search, the default is @@ -28777,15 +30004,15 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstand // If this field is set, it overrides the field names set in // ServingConfig.geo_search_query_detection_field_names. GeoSearchQueryDetectionFieldNames []string `json:"geoSearchQueryDetectionFieldNames,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExtractedFilterBehavior") to + // ForceSendFields is a list of field names (e.g. "AllowedFieldNames") 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. "ExtractedFilterBehavior") 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. "AllowedFieldNames") 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:"-"` } @@ -28885,6 +30112,39 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceScoreSpec) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec: +// SearchAddonSpec is used to disable add-ons for search as per new repricing +// model. By default if the SearchAddonSpec is not specified, we consider that +// the customer wants to enable them wherever applicable. +type GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec struct { + // DisableGenerativeAnswerAddOn: Optional. If true, generative answer add-on is + // disabled. Generative answer add-on includes natural language to filters and + // simple answers. + DisableGenerativeAnswerAddOn bool `json:"disableGenerativeAnswerAddOn,omitempty"` + // DisableKpiPersonalizationAddOn: Optional. If true, disables event re-ranking + // and personalization to optimize KPIs & personalize results. + DisableKpiPersonalizationAddOn bool `json:"disableKpiPersonalizationAddOn,omitempty"` + // DisableSemanticAddOn: Optional. If true, semantic add-on is disabled. + // Semantic add-on includes embeddings and jetstream. + DisableSemanticAddOn bool `json:"disableSemanticAddOn,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DisableGenerativeAnswerAddOn") 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. "DisableGenerativeAnswerAddOn") 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 GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec: // Specification for search as you type in search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec struct { @@ -29602,11 +30862,10 @@ func (s GoogleCloudNotebooklmV1alphaAgentspaceMetadata) MarshalJSON() ([]byte, e // GoogleCloudNotebooklmV1alphaAudioOverview: An audio overview of a notebook. // This is a summary of the notebook in audio format. type GoogleCloudNotebooklmV1alphaAudioOverview struct { - // Audio: The audio overview in wav format. This is only present if the status - // is AUDIO_OVERVIEW_STATUS_COMPLETE. - Audio string `json:"audio,omitempty"` // AudioOverviewId: Output only. Unique ID of the audio overview. AudioOverviewId string `json:"audioOverviewId,omitempty"` + // GenerationOptions: The options used to generate the audio overview. + GenerationOptions *GoogleCloudNotebooklmV1alphaAudioOverviewGenerationOptions `json:"generationOptions,omitempty"` // LanguageCode: The language code of the generated audio overview. Use the BCP // 47 language code (e.g. "en", "es", "hi", etc.). LanguageCode string `json:"languageCode,omitempty"` @@ -29622,8 +30881,6 @@ type GoogleCloudNotebooklmV1alphaAudioOverview struct { // {audio_overview_id}`. This field must be a UTF-8 encoded string with a // length limit of 1024 characters. Name string `json:"name,omitempty"` - // PlaybackUrl: The url used to play the audio overview. - PlaybackUrl string `json:"playbackUrl,omitempty"` // Status: The status of the audio overview. // // Possible values: @@ -29637,15 +30894,15 @@ type GoogleCloudNotebooklmV1alphaAudioOverview struct { // "AUDIO_OVERVIEW_STATUS_FAILED" - The audio overview failed to be // generated. Status string `json:"status,omitempty"` - // ForceSendFields is a list of field names (e.g. "Audio") 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. "AudioOverviewId") 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. "Audio") 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. "AudioOverviewId") 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:"-"` } @@ -31367,6 +32624,120 @@ func (c *ProjectsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscover return ret, nil } +type ProjectsPatchCall struct { + s *Service + name string + googleclouddiscoveryenginev1alphaproject *GoogleCloudDiscoveryengineV1alphaProject + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the editable settings of a Discovery Engine Project. +// +// - name: Output only. Full resource name of the project, for example +// `projects/{project}`. Note that when making requests, project number and +// project id are both acceptable, but the server will always respond in +// project number. +func (r *ProjectsService) Patch(name string, googleclouddiscoveryenginev1alphaproject *GoogleCloudDiscoveryengineV1alphaProject) *ProjectsPatchCall { + c := &ProjectsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googleclouddiscoveryenginev1alphaproject = googleclouddiscoveryenginev1alphaproject + return c +} + +// UpdateMask sets the optional parameter "updateMask": The list of fields to +// update. Supported fields: * `customer_provided_config` +func (c *ProjectsPatchCall) UpdateMask(updateMask string) *ProjectsPatchCall { + 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 *ProjectsPatchCall) Fields(s ...googleapi.Field) *ProjectsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsPatchCall) Context(ctx context.Context) *ProjectsPatchCall { + 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 *ProjectsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1alphaproject) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "discoveryengine.projects.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.patch" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaProject.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 *ProjectsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaProject, 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 := &GoogleCloudDiscoveryengineV1alphaProject{ + 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.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsProvisionCall struct { s *Service name string @@ -32350,6 +33721,134 @@ func (c *ProjectsLocationsSetUpDataConnectorCall) Do(opts ...googleapi.CallOptio return ret, nil } +type ProjectsLocationsSetUpDataConnectorV2Call struct { + s *Service + parent string + googleclouddiscoveryenginev1alphadataconnector *GoogleCloudDiscoveryengineV1alphaDataConnector + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetUpDataConnectorV2: Creates a Collection and sets up the DataConnector for +// it. To stop a DataConnector after setup, use the +// CollectionService.DeleteCollection method. +// +// - parent: The parent of Collection, in the format of +// `projects/{project}/locations/{location}`. +func (r *ProjectsLocationsService) SetUpDataConnectorV2(parent string, googleclouddiscoveryenginev1alphadataconnector *GoogleCloudDiscoveryengineV1alphaDataConnector) *ProjectsLocationsSetUpDataConnectorV2Call { + c := &ProjectsLocationsSetUpDataConnectorV2Call{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.googleclouddiscoveryenginev1alphadataconnector = googleclouddiscoveryenginev1alphadataconnector + return c +} + +// CollectionDisplayName sets the optional parameter "collectionDisplayName": +// Required. The display name of the Collection. Should be human readable, used +// to display collections in the Console Dashboard. UTF-8 encoded string with +// limit of 1024 characters. +func (c *ProjectsLocationsSetUpDataConnectorV2Call) CollectionDisplayName(collectionDisplayName string) *ProjectsLocationsSetUpDataConnectorV2Call { + c.urlParams_.Set("collectionDisplayName", collectionDisplayName) + return c +} + +// CollectionId sets the optional parameter "collectionId": Required. The ID to +// use for the Collection, which will become the final component of the +// Collection's resource name. A new Collection is created as part of the +// DataConnector setup. DataConnector is a singleton resource under Collection, +// managing all DataStores of the Collection. This field must conform to +// RFC-1034 (https://tools.ietf.org/html/rfc1034) standard with a length limit +// of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned. +func (c *ProjectsLocationsSetUpDataConnectorV2Call) CollectionId(collectionId string) *ProjectsLocationsSetUpDataConnectorV2Call { + c.urlParams_.Set("collectionId", collectionId) + 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 *ProjectsLocationsSetUpDataConnectorV2Call) Fields(s ...googleapi.Field) *ProjectsLocationsSetUpDataConnectorV2Call { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsSetUpDataConnectorV2Call) Context(ctx context.Context) *ProjectsLocationsSetUpDataConnectorV2Call { + 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 *ProjectsLocationsSetUpDataConnectorV2Call) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsSetUpDataConnectorV2Call) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.googleclouddiscoveryenginev1alphadataconnector) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1alpha/{+parent}:setUpDataConnectorV2") + 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", "discoveryengine.projects.locations.setUpDataConnectorV2", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.setUpDataConnectorV2" 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 *ProjectsLocationsSetUpDataConnectorV2Call) 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.setUpDataConnectorV2", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsUpdateAclConfigCall struct { s *Service name string @@ -33750,7 +35249,7 @@ type ProjectsLocationsCollectionsDataConnectorAcquireAccessTokenCall struct { // its details. Takes the access token from cache if available. Rotates the // stored refresh token if needed. Uses the end user identity to return the // user specific access token. Does *not* return the credentials configured by -// the administrator. Used by Agentspace action execution and Agentspace UI. +// the administrator. Used by action execution and UI. // // - name: The resource name of the connector for which a token is queried. func (r *ProjectsLocationsCollectionsDataConnectorService) AcquireAccessToken(name string, googleclouddiscoveryenginev1alphaacquireaccesstokenrequest *GoogleCloudDiscoveryengineV1alphaAcquireAccessTokenRequest) *ProjectsLocationsCollectionsDataConnectorAcquireAccessTokenCall { @@ -35875,6 +37374,269 @@ func (c *ProjectsLocationsCollectionsDataStoresBranchesBatchGetDocumentsMetadata return ret, nil } +type ProjectsLocationsCollectionsDataStoresBranchesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves a Branch. +// +// - name: The name of the branch to retrieve. Format: +// `projects/*/locations/global/dataStores/default_data_store/branches/some_br +// anch_id`. "default_branch" can be used as a special branch_id, it returns +// the default branch that has been set for the document. +func (r *ProjectsLocationsCollectionsDataStoresBranchesService) Get(name string) *ProjectsLocationsCollectionsDataStoresBranchesGetCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// View sets the optional parameter "view": The view to apply to the returned +// Branch. Defaults to Branch.BranchView.BASIC if unspecified. +// +// Possible values: +// +// "BRANCH_VIEW_UNSPECIFIED" - The value when it's unspecified. This defaults +// +// to the BASIC view. +// +// "BRANCH_VIEW_BASIC" - Includes basic metadata about the branch, but not +// +// statistical fields. See documentation of individual fields of Branch to know +// what is excluded. +// +// "BRANCH_VIEW_FULL" - Includes all fields of a Branch. +func (c *ProjectsLocationsCollectionsDataStoresBranchesGetCall) View(view string) *ProjectsLocationsCollectionsDataStoresBranchesGetCall { + c.urlParams_.Set("view", view) + 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 *ProjectsLocationsCollectionsDataStoresBranchesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesGetCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresBranchesGetCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesGetCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresBranchesGetCall) 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.collections.dataStores.branches.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaBranch.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 *ProjectsLocationsCollectionsDataStoresBranchesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaBranch, 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 := &GoogleCloudDiscoveryengineV1alphaBranch{ + 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.collections.dataStores.branches.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsCollectionsDataStoresBranchesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all Branchs under the specified parent DataStore. +// +// - parent: The parent data store resource name. +func (r *ProjectsLocationsCollectionsDataStoresBranchesService) List(parent string) *ProjectsLocationsCollectionsDataStoresBranchesListCall { + c := &ProjectsLocationsCollectionsDataStoresBranchesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// View sets the optional parameter "view": The view to apply to the returned +// Branch. Defaults to Branch.BranchView.BASIC if unspecified. +// +// Possible values: +// +// "BRANCH_VIEW_UNSPECIFIED" - The value when it's unspecified. This defaults +// +// to the BASIC view. +// +// "BRANCH_VIEW_BASIC" - Includes basic metadata about the branch, but not +// +// statistical fields. See documentation of individual fields of Branch to know +// what is excluded. +// +// "BRANCH_VIEW_FULL" - Includes all fields of a Branch. +func (c *ProjectsLocationsCollectionsDataStoresBranchesListCall) View(view string) *ProjectsLocationsCollectionsDataStoresBranchesListCall { + c.urlParams_.Set("view", view) + 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 *ProjectsLocationsCollectionsDataStoresBranchesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCollectionsDataStoresBranchesListCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCollectionsDataStoresBranchesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsCollectionsDataStoresBranchesListCall) Context(ctx context.Context) *ProjectsLocationsCollectionsDataStoresBranchesListCall { + 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 *ProjectsLocationsCollectionsDataStoresBranchesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCollectionsDataStoresBranchesListCall) 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}/branches") + 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", "discoveryengine.projects.locations.collections.dataStores.branches.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.collections.dataStores.branches.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaListBranchesResponse.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 *ProjectsLocationsCollectionsDataStoresBranchesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaListBranchesResponse, 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 := &GoogleCloudDiscoveryengineV1alphaListBranchesResponse{ + 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.collections.dataStores.branches.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsCollectionsDataStoresBranchesDocumentsCreateCall struct { s *Service parent string @@ -52258,6 +54020,269 @@ func (c *ProjectsLocationsDataStoresBranchesBatchGetDocumentsMetadataCall) Do(op return ret, nil } +type ProjectsLocationsDataStoresBranchesGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves a Branch. +// +// - name: The name of the branch to retrieve. Format: +// `projects/*/locations/global/dataStores/default_data_store/branches/some_br +// anch_id`. "default_branch" can be used as a special branch_id, it returns +// the default branch that has been set for the document. +func (r *ProjectsLocationsDataStoresBranchesService) Get(name string) *ProjectsLocationsDataStoresBranchesGetCall { + c := &ProjectsLocationsDataStoresBranchesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// View sets the optional parameter "view": The view to apply to the returned +// Branch. Defaults to Branch.BranchView.BASIC if unspecified. +// +// Possible values: +// +// "BRANCH_VIEW_UNSPECIFIED" - The value when it's unspecified. This defaults +// +// to the BASIC view. +// +// "BRANCH_VIEW_BASIC" - Includes basic metadata about the branch, but not +// +// statistical fields. See documentation of individual fields of Branch to know +// what is excluded. +// +// "BRANCH_VIEW_FULL" - Includes all fields of a Branch. +func (c *ProjectsLocationsDataStoresBranchesGetCall) View(view string) *ProjectsLocationsDataStoresBranchesGetCall { + c.urlParams_.Set("view", view) + 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 *ProjectsLocationsDataStoresBranchesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresBranchesGetCall { + 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 *ProjectsLocationsDataStoresBranchesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataStoresBranchesGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresBranchesGetCall) Context(ctx context.Context) *ProjectsLocationsDataStoresBranchesGetCall { + 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 *ProjectsLocationsDataStoresBranchesGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresBranchesGetCall) 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.dataStores.branches.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.branches.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaBranch.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 *ProjectsLocationsDataStoresBranchesGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaBranch, 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 := &GoogleCloudDiscoveryengineV1alphaBranch{ + 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.dataStores.branches.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsDataStoresBranchesListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all Branchs under the specified parent DataStore. +// +// - parent: The parent data store resource name. +func (r *ProjectsLocationsDataStoresBranchesService) List(parent string) *ProjectsLocationsDataStoresBranchesListCall { + c := &ProjectsLocationsDataStoresBranchesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// View sets the optional parameter "view": The view to apply to the returned +// Branch. Defaults to Branch.BranchView.BASIC if unspecified. +// +// Possible values: +// +// "BRANCH_VIEW_UNSPECIFIED" - The value when it's unspecified. This defaults +// +// to the BASIC view. +// +// "BRANCH_VIEW_BASIC" - Includes basic metadata about the branch, but not +// +// statistical fields. See documentation of individual fields of Branch to know +// what is excluded. +// +// "BRANCH_VIEW_FULL" - Includes all fields of a Branch. +func (c *ProjectsLocationsDataStoresBranchesListCall) View(view string) *ProjectsLocationsDataStoresBranchesListCall { + c.urlParams_.Set("view", view) + 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 *ProjectsLocationsDataStoresBranchesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsDataStoresBranchesListCall { + 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 *ProjectsLocationsDataStoresBranchesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsDataStoresBranchesListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsDataStoresBranchesListCall) Context(ctx context.Context) *ProjectsLocationsDataStoresBranchesListCall { + 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 *ProjectsLocationsDataStoresBranchesListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDataStoresBranchesListCall) 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}/branches") + 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", "discoveryengine.projects.locations.dataStores.branches.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "discoveryengine.projects.locations.dataStores.branches.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *GoogleCloudDiscoveryengineV1alphaListBranchesResponse.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 *ProjectsLocationsDataStoresBranchesListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDiscoveryengineV1alphaListBranchesResponse, 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 := &GoogleCloudDiscoveryengineV1alphaListBranchesResponse{ + 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.dataStores.branches.list", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsDataStoresBranchesDocumentsCreateCall struct { s *Service parent string diff --git a/discoveryengine/v1beta/discoveryengine-api.json b/discoveryengine/v1beta/discoveryengine-api.json index e2c609394dd..7a1186ab9d5 100644 --- a/discoveryengine/v1beta/discoveryengine-api.json +++ b/discoveryengine/v1beta/discoveryengine-api.json @@ -8200,7 +8200,7 @@ } } }, - "revision": "20250908", + "revision": "20250921", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GdataBlobstore2Info": { @@ -9061,6 +9061,38 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1ActionConfig": { + "description": "Informations to support actions on the connector.", + "id": "GoogleCloudDiscoveryengineV1ActionConfig", + "properties": { + "actionParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Action parameters in structured json format.", + "type": "object" + }, + "isActionConfigured": { + "description": "Output only. The connector contains the necessary parameters and is configured to support actions.", + "readOnly": true, + "type": "boolean" + }, + "jsonActionParams": { + "description": "Optional. Action parameters in json string format.", + "type": "string" + }, + "serviceName": { + "description": "Optional. The Service Directory resource name (projects/*/locations/*/namespaces/*/services/*) representing a VPC network endpoint used to connect to the data source's `instance_uri`, defined in DataConnector.params. Required when VPC Service Controls are enabled.", + "type": "string" + }, + "useStaticSecrets": { + "description": "Optional. Whether to use static secrets for the connector. If true, the secrets provided in the action_params will be ignored.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig": { "description": "Configuration data for advance site search.", "id": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig", @@ -9076,6 +9108,49 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1AlertPolicyConfig": { + "description": "The connector level alert config.", + "id": "GoogleCloudDiscoveryengineV1AlertPolicyConfig", + "properties": { + "alertEnrollments": { + "description": "Optional. The enrollment states of each alert.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment" + }, + "type": "array" + }, + "alertPolicyName": { + "description": "Immutable. The fully qualified resource name of the AlertPolicy.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment": { + "description": "The alert enrollment status.", + "id": "GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment", + "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" + }, "GoogleCloudDiscoveryengineV1AnswerGenerationSpec": { "description": "The specification for answer generation.", "id": "GoogleCloudDiscoveryengineV1AnswerGenerationSpec", @@ -9303,6 +9378,39 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1BAPConfig": { + "description": "The configuration for the BAP connector.", + "id": "GoogleCloudDiscoveryengineV1BAPConfig", + "properties": { + "enabledActions": { + "description": "Optional. The actions enabled on the associated BAP connection.", + "items": { + "type": "string" + }, + "type": "array" + }, + "supportedConnectorModes": { + "description": "Required. The supported connector modes for the associated BAP connection.", + "items": { + "enum": [ + "CONNECTOR_MODE_UNSPECIFIED", + "DATA_INGESTION", + "ACTIONS", + "END_USER_AUTHENTICATION" + ], + "enumDescriptions": [ + "Connector mode unspecified.", + "Connector utilized for data ingestion.", + "Connector utilized for Actions", + "Connector utilized for End User Authentication." + ], + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata": { "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata", @@ -9464,6 +9572,27 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1Collection": { + "description": "Collection is a container for configuring resources and access to a set of DataStores.", + "id": "GoogleCloudDiscoveryengineV1Collection", + "properties": { + "createTime": { + "description": "Output only. Timestamp the Collection was created at.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Required. The Collection display name. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "type": "string" + }, + "name": { + "description": "Immutable. The full resource name of the Collection. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1Condition": { "description": "Defines circumstances to be checked before allowing a behavior", "id": "GoogleCloudDiscoveryengineV1Condition", @@ -9828,10 +9957,495 @@ "format": "google-datetime", "type": "string" }, - "updateTime": { - "description": "Operation last update time. If the operation is done, this is also the finish time.", - "format": "google-datetime", - "type": "string" + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnector": { + "description": "Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through DataConnectorService.SetUpDataConnector method, which will create a new Collection and initialize its DataConnector.", + "id": "GoogleCloudDiscoveryengineV1DataConnector", + "properties": { + "aclEnabled": { + "description": "Optional. Whether the connector will be created with an ACL config. Currently this field only affects Cloud Storage and BigQuery connectors.", + "type": "boolean" + }, + "actionConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ActionConfig", + "description": "Optional. Action configurations to make the connector support actions." + }, + "actionState": { + "description": "Output only. State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" + ], + "enumDescriptions": [ + "Default value.", + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." + ], + "readOnly": true, + "type": "string" + }, + "alertPolicyConfigs": { + "description": "Optional. The connector level alert config.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1AlertPolicyConfig" + }, + "type": "array" + }, + "autoRunDisabled": { + "description": "Optional. Indicates whether the connector is disabled for auto run. It can be used to pause periodical and real time sync. Update: with the introduction of incremental_sync_disabled, auto_run_disabled is used to pause/disable only full syncs", + "type": "boolean" + }, + "bapConfig": { + "$ref": "GoogleCloudDiscoveryengineV1BAPConfig", + "description": "Optional. The configuration for establishing a BAP connection." + }, + "blockingReasons": { + "description": "Output only. User actions that must be completed before the connector can start syncing data.", + "items": { + "enum": [ + "BLOCKING_REASON_UNSPECIFIED", + "ALLOWLIST_STATIC_IP", + "ALLOWLIST_IN_SERVICE_ATTACHMENT", + "ALLOWLIST_SERVICE_ACCOUNT" + ], + "enumDescriptions": [ + "Default value.", + "Connector requires customer to allowlist static IPs.", + "Connector requires customer to allowlist our project in their service attachment.", + "Connector requires customer to allowlist service account in their project." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "connectorModes": { + "description": "Optional. The modes enabled for this connector. Default state is CONNECTOR_MODE_UNSPECIFIED.", + "items": { + "enum": [ + "CONNECTOR_MODE_UNSPECIFIED", + "DATA_INGESTION", + "ACTIONS", + "FEDERATED", + "EUA", + "FEDERATED_AND_EUA" + ], + "enumDescriptions": [ + "Connector mode unspecified.", + "Connector utilized for data ingestion.", + "Connector utilized for actions.", + "Connector utilized for federated search.", + "Connector utilized for End User Authentication.", + "Hybrid connector utilized for federated search and End User Authentication." + ], + "type": "string" + }, + "type": "array" + }, + "connectorType": { + "description": "Output only. The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system.", + "enum": [ + "CONNECTOR_TYPE_UNSPECIFIED", + "THIRD_PARTY", + "GCP_FHIR", + "BIG_QUERY", + "GCS", + "GOOGLE_MAIL", + "GOOGLE_CALENDAR", + "GOOGLE_DRIVE", + "NATIVE_CLOUD_IDENTITY", + "THIRD_PARTY_FEDERATED", + "THIRD_PARTY_EUA", + "GCNV" + ], + "enumDescriptions": [ + "Default value.", + "Third party connector to connector to third party application.", + "Data connector connects between FHIR store and VAIS datastore.", + "Big query connector.", + "Google Cloud Storage connector.", + "Gmail connector.", + "Google Calendar connector.", + "Google Drive connector.", + "Native Cloud Identity connector for people search powered by People API.", + "Federated connector, it is a third party connector that doesn't ingestion data, and search is powered by third party application's API.", + "Connector utilized for End User Authentication features.", + "Google Cloud NetApp Volumes connector." + ], + "readOnly": true, + "type": "string" + }, + "createEuaSaas": { + "description": "Optional. Whether the END USER AUTHENTICATION connector is created in SaaS.", + "type": "boolean" + }, + "createTime": { + "description": "Output only. Timestamp the DataConnector was created at.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "dataSource": { + "description": "Required. The name of the data source. Supported values: `salesforce`, `jira`, `confluence`, `bigquery`.", + "type": "string" + }, + "destinationConfigs": { + "description": "Optional. Any target destinations used to connect to third-party services.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DestinationConfig" + }, + "type": "array" + }, + "endUserConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig", + "description": "Optional. Any params and credentials used specifically for EUA connectors." + }, + "entities": { + "description": "List of entities from the connected data source to ingest.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity" + }, + "type": "array" + }, + "errors": { + "description": "Output only. The errors from initialization or from the latest connector run.", + "items": { + "$ref": "GoogleRpcStatus" + }, + "readOnly": true, + "type": "array" + }, + "federatedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig", + "description": "Optional. Any params and credentials used specifically for hybrid connectors supporting FEDERATED mode. This field should only be set if the connector is a hybrid connector and we want to enable FEDERATED mode." + }, + "hybridIngestionDisabled": { + "description": "Optional. If the connector is a hybrid connector, determines whether ingestion is enabled and appropriate resources are provisioned during connector creation. If the connector is not a hybrid connector, this field is ignored.", + "type": "boolean" + }, + "identityRefreshInterval": { + "deprecated": true, + "description": "The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", + "format": "google-duration", + "type": "string" + }, + "identityScheduleConfig": { + "$ref": "GoogleCloudDiscoveryengineV1IdentityScheduleConfig", + "description": "The configuration for the identity data synchronization runs. This contains the refresh interval to sync the Access Control List information for the documents ingested by this connector." + }, + "incrementalRefreshInterval": { + "description": "Optional. The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.", + "format": "google-duration", + "type": "string" + }, + "incrementalSyncDisabled": { + "description": "Optional. Indicates whether incremental syncs are paused for this connector. This is independent of auto_run_disabled. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled, i.e. set to true.", + "type": "boolean" + }, + "jsonParams": { + "description": "Required data connector parameters in json string format.", + "type": "string" + }, + "kmsKeyName": { + "description": "Input only. The KMS key to be used to protect the DataStores managed by this connector. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStores created by this connector will be protected by the KMS key.", + "type": "string" + }, + "lastSyncTime": { + "description": "Output only. For periodic connectors only, the last time a data sync was completed.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "latestPauseTime": { + "description": "Output only. The most recent timestamp when this DataConnector was paused, affecting all functionalities such as data synchronization. Pausing a connector has the following effects: - All functionalities, including data synchronization, are halted. - Any ongoing data synchronization job will be canceled. - No future data synchronization runs will be scheduled nor can be triggered.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. The full resource name of the Data Connector. Format: `projects/*/locations/*/collections/*/dataConnector`.", + "readOnly": true, + "type": "string" + }, + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Defines the scheduled time for the next data synchronization. This field requires hour , minute, and time_zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). This is utilized when the data connector has a refresh interval greater than 1 day. When the hours or minutes are not specified, we will assume a sync time of 0:00. The user must provide a time zone to avoid ambiguity." + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Required data connector parameters in structured json format.", + "type": "object" + }, + "privateConnectivityProjectId": { + "description": "Output only. The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.", + "readOnly": true, + "type": "string" + }, + "realtimeState": { + "description": "Output only. real-time sync state", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" + ], + "enumDescriptions": [ + "Default value.", + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." + ], + "readOnly": true, + "type": "string" + }, + "realtimeSyncConfig": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig", + "description": "Optional. The configuration for realtime sync." + }, + "refreshInterval": { + "description": "Required. The refresh interval for data sync. If duration is set to 0, the data will be synced in real time. The streaming feature is not supported yet. The minimum is 30 minutes and maximum is 7 days. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.", + "format": "google-duration", + "type": "string" + }, + "removeParamKeys": { + "description": "Optional. Specifies keys to be removed from the 'params' field. This is only active when 'params' is included in the 'update_mask' in an UpdateDataConnectorRequest. Deletion takes precedence if a key is both in 'remove_param_keys' and present in the 'params' field of the request.", + "items": { + "type": "string" + }, + "type": "array" + }, + "state": { + "description": "Output only. State of the connector.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "FAILED", + "RUNNING", + "WARNING", + "INITIALIZATION_FAILED", + "UPDATING" + ], + "enumDescriptions": [ + "Default value.", + "The connector is being set up.", + "The connector is successfully set up and awaiting next sync run.", + "The connector is in error. The error details can be found in DataConnector.errors. If the error is unfixable, the DataConnector can be deleted by [CollectionService.DeleteCollection] API.", + "The connector is actively syncing records from the data source.", + "The connector has completed a sync run, but encountered non-fatal errors.", + "Connector initialization failed. Potential causes include runtime errors or issues in the asynchronous pipeline, preventing the request from reaching downstream services (except for some connector types).", + "Connector is in the process of an update." + ], + "readOnly": true, + "type": "string" + }, + "staticIpAddresses": { + "description": "Output only. The static IP addresses used by this connector.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "staticIpEnabled": { + "description": "Optional. Whether customer has enabled static IP addresses for this connector.", + "type": "boolean" + }, + "syncMode": { + "description": "The data synchronization mode supported by the data connector.", + "enum": [ + "PERIODIC", + "STREAMING", + "UNSPECIFIED" + ], + "enumDescriptions": [ + "The connector will sync data periodically based on the refresh_interval. Use it with auto_run_disabled to pause the periodic sync, or indicate a one-time sync.", + "The data will be synced in real time.", + "Connector that doesn't ingest data will have this value" + ], + "type": "string" + }, + "updateTime": { + "description": "Output only. Timestamp the DataConnector was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig": { + "description": "Any params and credentials used specifically for EUA connectors.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig", + "properties": { + "additionalParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any additional parameters needed for EUA.", + "type": "object" + }, + "authParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any authentication parameters specific to EUA connectors.", + "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to EUA connectors in json string format.", + "type": "string" + }, + "tenant": { + "$ref": "GoogleCloudDiscoveryengineV1Tenant", + "description": "Optional. The tenant project the connector is connected to." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig": { + "description": "Any params and credentials used specifically for hybrid connectors supporting FEDERATED mode.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig", + "properties": { + "additionalParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any additional parameters needed for FEDERATED.", + "type": "object" + }, + "authParams": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Any authentication parameters specific to FEDERATED connectors.", + "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to FEDERATED connectors in json string format.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig": { + "description": "The configuration for realtime sync to store additional params for realtime sync.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig", + "properties": { + "realtimeSyncSecret": { + "description": "Optional. The ID of the Secret Manager secret used for webhook secret.", + "type": "string" + }, + "streamingError": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError", + "description": "Optional. Streaming error details." + }, + "webhookUri": { + "description": "Optional. Webhook url for the connector to specify additional params for realtime sync.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError": { + "description": "Streaming error details.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError", + "properties": { + "error": { + "$ref": "GoogleRpcStatus", + "description": "Optional. Error details." + }, + "streamingErrorReason": { + "description": "Optional. Streaming error.", + "enum": [ + "STREAMING_ERROR_REASON_UNSPECIFIED", + "STREAMING_SETUP_ERROR", + "STREAMING_SYNC_ERROR", + "INGRESS_ENDPOINT_REQUIRED" + ], + "enumDescriptions": [ + "Streaming error reason unspecified.", + "Some error occurred while setting up resources for realtime sync.", + "Some error was encountered while running realtime sync for the connector.", + "Ingress endpoint is required when setting up realtime sync in private connectivity." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity": { + "description": "Represents an entity in the data source. For example, the `Account` object in Salesforce.", + "id": "GoogleCloudDiscoveryengineV1DataConnectorSourceEntity", + "properties": { + "dataStore": { + "description": "Output only. The full resource name of the associated data store for the source entity. Format: `projects/*/locations/*/collections/*/dataStores/*`. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity.", + "readOnly": true, + "type": "string" + }, + "entityName": { + "description": "The name of the entity. Supported values by data source: * Salesforce: `Lead`, `Opportunity`, `Contact`, `Account`, `Case`, `Contract`, `Campaign` * Jira: `Issue` * Confluence: `Content`, `Space`", + "type": "string" + }, + "healthcareFhirConfig": { + "$ref": "GoogleCloudDiscoveryengineV1HealthcareFhirConfig", + "description": "Optional. Configuration for `HEALTHCARE_FHIR` vertical." + }, + "jsonParams": { + "description": "The parameters for the entity to facilitate data ingestion in json string format.", + "type": "string" + }, + "keyPropertyMappings": { + "additionalProperties": { + "type": "string" + }, + "description": "Attributes for indexing. Key: Field name. Value: The key property to map a field to, such as `title`, and `description`. Supported key properties: * `title`: The title for data record. This would be displayed on search results. * `description`: The description for data record. This would be displayed on search results.", + "type": "object" + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "The parameters for the entity to facilitate data ingestion in structured json format.", + "type": "object" + }, + "startingSchema": { + "$ref": "GoogleCloudDiscoveryengineV1Schema", + "description": "Optional. The start schema to use for the DataStore created from this SourceEntity. If unset, a default vertical specialized schema will be used. This field is only used by SetUpDataConnector API, and will be ignored if used in other APIs. This field will be omitted from all API responses including GetDataConnector API. To retrieve a schema of a DataStore, use SchemaService.GetSchema API instead. The provided schema will be validated against certain rules on schema. Learn more from [this doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema)." } }, "type": "object" @@ -9858,6 +10472,20 @@ "description": "Output only. CMEK-related information for the DataStore.", "readOnly": true }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -10032,6 +10660,23 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DeleteCollectionMetadata": { + "description": "Metadata related to the progress of the CollectionService.UpdateCollection operation. This will be returned by the google.longrunning.Operation.metadata field.", + "id": "GoogleCloudDiscoveryengineV1DeleteCollectionMetadata", + "properties": { + "createTime": { + "description": "Operation create time.", + "format": "google-datetime", + "type": "string" + }, + "updateTime": { + "description": "Operation last update time. If the operation is done, this is also the finish time.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata": { "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata", @@ -10134,6 +10779,52 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1DestinationConfig": { + "description": "Defines target endpoints used to connect to third-party sources.", + "id": "GoogleCloudDiscoveryengineV1DestinationConfig", + "properties": { + "destinations": { + "description": "Optional. The destinations for the corresponding key.", + "items": { + "$ref": "GoogleCloudDiscoveryengineV1DestinationConfigDestination" + }, + "type": "array" + }, + "jsonParams": { + "description": "Additional parameters for this destination config in json string format.", + "type": "string" + }, + "key": { + "description": "Optional. Unique destination identifier that is supported by the connector.", + "type": "string" + }, + "params": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Optional. Additional parameters for this destination config in structured json format.", + "type": "object" + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1DestinationConfigDestination": { + "description": "Defines a target endpoint", + "id": "GoogleCloudDiscoveryengineV1DestinationConfigDestination", + "properties": { + "host": { + "description": "Publicly routable host.", + "type": "string" + }, + "port": { + "description": "Optional. Target port number accepted by the destination.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchMetadata": { "description": "Metadata related to the progress of the SiteSearchEngineService.DisableAdvancedSiteSearch operation. This will be returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1DisableAdvancedSiteSearchMetadata", @@ -10353,6 +11044,18 @@ "$ref": "GoogleCloudDiscoveryengineV1EngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -10388,7 +11091,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -10674,6 +11377,22 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1IdentityScheduleConfig": { + "description": "The configuration for the identity data synchronization runs.", + "id": "GoogleCloudDiscoveryengineV1IdentityScheduleConfig", + "properties": { + "nextSyncTime": { + "$ref": "GoogleTypeDateTime", + "description": "Optional. The UTC time when the next data sync is expected to start for the Data Connector. Customers are only able to specify the hour and minute to schedule the data sync. This is utilized when the data connector has a refresh interval greater than 1 day." + }, + "refreshInterval": { + "description": "Optional. The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1IdpConfig": { "description": "Identity Provider Config.", "id": "GoogleCloudDiscoveryengineV1IdpConfig", @@ -10936,6 +11655,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -10958,6 +11681,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1ProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1ProjectServiceTerms", @@ -11532,6 +12292,12 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata": { + "description": "Metadata for DataConnectorService.SetUpDataConnector method.", + "id": "GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata", + "properties": {}, + "type": "object" + }, "GoogleCloudDiscoveryengineV1SingleRegionKey": { "description": "Metadata for single-regional CMEKs.", "id": "GoogleCloudDiscoveryengineV1SingleRegionKey", @@ -11699,6 +12465,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1Tenant": { + "description": "Tenant information for a connector source. This includes some of the same information stored in the Credential message, but is limited to only what is needed to provide a list of accessible tenants to the user.", + "id": "GoogleCloudDiscoveryengineV1Tenant", + "properties": { + "displayName": { + "description": "Optional display name for the tenant, e.g. \"My Slack Team\".", + "type": "string" + }, + "id": { + "description": "The tenant's instance ID. Examples: Jira (\"8594f221-9797-5f78-1fa4-485e198d7cd0\"), Slack (\"T123456\").", + "type": "string" + }, + "uri": { + "description": "The URI of the tenant, if applicable. For example, the URI of a Jira instance is https://my-jira-instance.atlassian.net, and a Slack tenant does not have a URI.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata": { "description": "Metadata related to the progress of the TrainCustomModel operation. This is returned by the google.longrunning.Operation.metadata field.", "id": "GoogleCloudDiscoveryengineV1TrainCustomModelMetadata", @@ -11928,7 +12713,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Required. Params needed to support actions in the format of (Key, Value) pairs. Required parameters for sources that support OAUTH, i.e. `gmail`, `google_calendar`, `jira`, `workday`, `salesforce`, `confluence`: * Key: `client_id` * Value: type STRING. The client ID for the service provider to identify your application. * Key: `client_secret` * Value:type STRING. The client secret generated by the application's authorization server.", + "description": "Optional. Action parameters in structured json format.", "type": "object" }, "isActionConfigured": { @@ -11936,6 +12721,10 @@ "readOnly": true, "type": "boolean" }, + "jsonActionParams": { + "description": "Optional. Action parameters in json string format.", + "type": "string" + }, "serviceName": { "description": "Optional. The Service Directory resource name (projects/*/locations/*/namespaces/*/services/*) representing a VPC network endpoint used to connect to the data source's `instance_uri`, defined in DataConnector.params. Required when VPC Service Controls are enabled.", "type": "string" @@ -12633,6 +13422,13 @@ "description": "The configuration for the BAP connector.", "id": "GoogleCloudDiscoveryengineV1alphaBAPConfig", "properties": { + "enabledActions": { + "description": "Optional. The actions enabled on the associated BAP connection.", + "items": { + "type": "string" + }, + "type": "array" + }, "supportedConnectorModes": { "description": "Required. The supported connector modes for the associated BAP connection.", "items": { @@ -13661,6 +14457,10 @@ "description": "Optional. Indicates whether incremental syncs are paused for this connector. This is independent of auto_run_disabled. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled, i.e. set to true.", "type": "boolean" }, + "jsonParams": { + "description": "Required data connector parameters in json string format.", + "type": "string" + }, "kmsKeyName": { "description": "Input only. The KMS key to be used to protect the DataStores managed by this connector. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStores created by this connector will be protected by the KMS key.", "type": "string" @@ -13691,7 +14491,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Required. Params needed to access the source in the format of (Key, Value) pairs. Required parameters for all data sources: * Key: `instance_uri` * Value: type STRING. The uri to access the data source. Required parameters for sources that support OAUTH, i.e. `salesforce`: * Key: `client_id` * Value: type STRING. The client ID for the third party service provider to identify your application. * Key: `client_secret` * Value:type STRING. The client secret generated by the third party authorization server. * Key: `access_token` * Value: type STRING. OAuth token for UCS to access to the protected resource. * Key: `refresh_token` * Value: type STRING. OAuth refresh token for UCS to obtain a new access token without user interaction. Required parameters for sources that support basic API token auth, i.e. `jira`, `confluence`: * Key: `user_account` * Value: type STRING. The username or email with the source. * Key: `api_token` * Value: type STRING. The API token generated for the source account, that is used for authenticating anywhere where you would have used a password. Example: ```json { \"instance_uri\": \"https://xxx.atlassian.net\", \"user_account\": \"xxxx.xxx@xxx.com\", \"api_token\": \"test-token\" } ``` Optional parameter to specify the authorization type to use for multiple authorization types support: * Key: `auth_type` * Value: type STRING. The authorization type for the data source. Supported values: `BASIC_AUTH`, `OAUTH`, `OAUTH_ACCESS_TOKEN`, `OAUTH_TWO_LEGGED`, `OAUTH_JWT_BEARER`, `OAUTH_PASSWORD_GRANT`, `JWT`, `API_TOKEN`, `FEDERATED_CREDENTIAL`.", + "description": "Required data connector parameters in structured json format.", "type": "object" }, "privateConnectivityProjectId": { @@ -13820,6 +14620,10 @@ "description": "Optional. Any authentication parameters specific to EUA connectors.", "type": "object" }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to EUA connectors in json string format.", + "type": "string" + }, "tenant": { "$ref": "GoogleCloudDiscoveryengineV1alphaTenant", "description": "Optional. The tenant project the connector is connected to." @@ -13844,8 +14648,12 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. Any authentication parameters specific to FEDERATED.", + "description": "Optional. Any authentication parameters specific to FEDERATED connectors.", "type": "object" + }, + "jsonAuthParams": { + "description": "Optional. Any authentication parameters specific to FEDERATED connectors in json string format.", + "type": "string" } }, "type": "object" @@ -13913,6 +14721,10 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaHealthcareFhirConfig", "description": "Optional. Configuration for `HEALTHCARE_FHIR` vertical." }, + "jsonParams": { + "description": "The parameters for the entity to facilitate data ingestion in json string format.", + "type": "string" + }, "keyPropertyMappings": { "additionalProperties": { "type": "string" @@ -13925,7 +14737,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The parameters for the entity to facilitate data ingestion. E.g. for BigQuery connectors: * Key: `document_id_column` * Value: type STRING. The value of the column ID.", + "description": "The parameters for the entity to facilitate data ingestion in structured json format.", "type": "object" }, "startingSchema": { @@ -13957,6 +14769,20 @@ "description": "Output only. CMEK-related information for the DataStore.", "readOnly": true }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -14308,6 +15134,10 @@ }, "type": "array" }, + "jsonParams": { + "description": "Additional parameters for this destination config in json string format.", + "type": "string" + }, "key": { "description": "Optional. Unique destination identifier that is supported by the connector.", "type": "string" @@ -14317,7 +15147,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "Optional. Additional parameters for this destination config.", + "description": "Optional. Additional parameters for this destination config in structured json format.", "type": "object" } }, @@ -14558,6 +15388,18 @@ "$ref": "GoogleCloudDiscoveryengineV1alphaEngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -14593,7 +15435,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -15779,6 +16621,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -15801,6 +16647,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1alphaProjectServiceTerms", @@ -16464,10 +17347,10 @@ }, "naturalLanguageQueryUnderstandingSpec": { "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", - "description": "Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." + "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "offset": { - "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.", + "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold.", "format": "int32", "type": "integer" }, @@ -16567,6 +17450,10 @@ "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" }, + "searchAddonSpec": { + "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec", + "description": "Optional. SearchAddonSpec is used to disable add-ons for search as per new repricing model. This field is only supported for search requests." + }, "searchAsYouTypeSpec": { "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec", "description": "Search as you type configuration. Only supported for the IndustryVertical.MEDIA vertical." @@ -17073,6 +17960,13 @@ "description": "Specification to enable natural language understanding capabilities for search requests.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { + "allowedFieldNames": { + "description": "Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.", + "items": { + "type": "string" + }, + "type": "array" + }, "extractedFilterBehavior": { "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.", "enum": [ @@ -17168,6 +18062,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec": { + "description": "SearchAddonSpec is used to disable add-ons for search as per new repricing model. By default if the SearchAddonSpec is not specified, we consider that the customer wants to enable them wherever applicable.", + "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec", + "properties": { + "disableGenerativeAnswerAddOn": { + "description": "Optional. If true, generative answer add-on is disabled. Generative answer add-on includes natural language to filters and simple answers.", + "type": "boolean" + }, + "disableKpiPersonalizationAddOn": { + "description": "Optional. If true, disables event re-ranking and personalization to optimize KPIs \u0026 personalize results.", + "type": "boolean" + }, + "disableSemanticAddOn": { + "description": "Optional. If true, semantic add-on is disabled. Semantic add-on includes embeddings and jetstream.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec": { "description": "Specification for search as you type in search requests.", "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec", @@ -19979,6 +20892,10 @@ "description": "Domain name from the document URI. Note that the `uri` field may contain a URL that redirects to the actual website, in which case this will contain the domain name of the target site.", "type": "string" }, + "mimeType": { + "description": "The mime type of the document. https://www.iana.org/assignments/media-types/media-types.xhtml.", + "type": "string" + }, "pageIdentifier": { "description": "Page identifier.", "type": "string" @@ -21625,6 +22542,20 @@ "description": "Output only. CMEK-related information for the DataStore.", "readOnly": true }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details, only apply to non-Spark UCS Search.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE", + "CONFIGURABLE_CONSUMPTION_EMBEDDING" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach.", + "Use the subscription base + overage billing for indexing core for non embedding storage.", + "Use the consumption pay-as-you-go billing for embedding storage add-on." + ], + "type": "string" + }, "contentConfig": { "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.", "enum": [ @@ -22351,6 +23282,18 @@ "$ref": "GoogleCloudDiscoveryengineV1betaEngineCommonConfig", "description": "Common config spec that specifies the metadata of the engine." }, + "configurableBillingApproach": { + "description": "Optional. Configuration for configurable billing approach. See go/vais-repricing-billing-dd for more details.", + "enum": [ + "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED", + "CONFIGURABLE_BILLING_APPROACH_ENABLED" + ], + "enumDescriptions": [ + "Default value. For Spark and non-Spark non-configurable billing approach. General pricing model.", + "The billing approach follows configurations specified by customer." + ], + "type": "string" + }, "createTime": { "description": "Output only. Timestamp the Recommendation Engine was created at.", "format": "google-datetime", @@ -22386,7 +23329,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload`", "type": "object" }, "industryVertical": { @@ -24111,6 +25054,10 @@ "readOnly": true, "type": "string" }, + "customerProvidedConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig", + "description": "Optional. Customer provided configurations." + }, "name": { "description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.", "readOnly": true, @@ -24133,6 +25080,43 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig": { + "description": "Customer provided configurations.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig", + "properties": { + "notebooklmConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig", + "description": "Optional. Configuration for NotebookLM settings." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig": { + "description": "Configuration for NotebookLM.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig", + "properties": { + "modelArmorConfig": { + "$ref": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "description": "Model Armor configuration to be used for sanitizing user prompts and LLM responses." + } + }, + "type": "object" + }, + "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig": { + "description": "Configuration for customer defined Model Armor templates to be used for sanitizing user prompts and LLM responses.", + "id": "GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig", + "properties": { + "responseTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing LLM responses. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the LLM response.", + "type": "string" + }, + "userPromptTemplate": { + "description": "Optional. The resource name of the Model Armor Template for sanitizing user prompts. Format: projects/{project}/locations/{location}/templates/{template_id} If not specified, no sanitization will be applied to the user prompt.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaProjectServiceTerms": { "description": "Metadata about the terms of service.", "id": "GoogleCloudDiscoveryengineV1betaProjectServiceTerms", @@ -24206,6 +25190,10 @@ "acceptBizQos": { "description": "Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].", "type": "boolean" + }, + "isBiz": { + "description": "Optional. Indicates if the current request is for Biz edition (= true) or not (= false).", + "type": "boolean" } }, "type": "object" @@ -25107,10 +26095,10 @@ }, "naturalLanguageQueryUnderstandingSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", - "description": "Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." + "description": "Optional. Config for natural language query understanding capabilities, such as extracting structured field filters from the query. Refer to [this documentation](https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) for more information. If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional natural language query understanding will be done." }, "offset": { - "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned.", + "description": "A 0-indexed integer that specifies the current offset (that is, starting result location, amongst the Documents deemed by the API as relevant) in search results. This field is only considered if page_token is unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large offset may be capped to a reasonable threshold.", "format": "int32", "type": "integer" }, @@ -25210,6 +26198,10 @@ "description": "Whether to turn on safe search. This is only supported for website search.", "type": "boolean" }, + "searchAddonSpec": { + "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec", + "description": "Optional. SearchAddonSpec is used to disable add-ons for search as per new repricing model. This field is only supported for search requests." + }, "searchAsYouTypeSpec": { "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec", "description": "Search as you type configuration. Only supported for the IndustryVertical.MEDIA vertical." @@ -25712,6 +26704,13 @@ "description": "Specification to enable natural language understanding capabilities for search requests.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec", "properties": { + "allowedFieldNames": { + "description": "Optional. Allowlist of fields that can be used for natural language filter extraction. By default, if this is unspecified, all indexable fields are eligible for natural language filter extraction (but are not guaranteed to be used). If any fields are specified in allowed_field_names, only the fields that are both marked as indexable in the schema and specified in the allowlist will be eligible for natural language filter extraction. Note: for multi-datastore search, this is not yet supported, and will be ignored.", + "items": { + "type": "string" + }, + "type": "array" + }, "extractedFilterBehavior": { "description": "Optional. Controls behavior of how extracted filters are applied to the search. The default behavior depends on the request. For single datastore structured search, the default is `HARD_FILTER`. For multi-datastore search, the default behavior is `SOFT_BOOST`. Location-based filters are always applied as hard filters, and the `SOFT_BOOST` setting will not affect them. This field is only used if SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition is set to FilterExtractionCondition.ENABLED.", "enum": [ @@ -25807,6 +26806,25 @@ }, "type": "object" }, + "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec": { + "description": "SearchAddonSpec is used to disable add-ons for search as per new repricing model. By default if the SearchAddonSpec is not specified, we consider that the customer wants to enable them wherever applicable.", + "id": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec", + "properties": { + "disableGenerativeAnswerAddOn": { + "description": "Optional. If true, generative answer add-on is disabled. Generative answer add-on includes natural language to filters and simple answers.", + "type": "boolean" + }, + "disableKpiPersonalizationAddOn": { + "description": "Optional. If true, disables event re-ranking and personalization to optimize KPIs \u0026 personalize results.", + "type": "boolean" + }, + "disableSemanticAddOn": { + "description": "Optional. If true, semantic add-on is disabled. Semantic add-on includes embeddings and jetstream.", + "type": "boolean" + } + }, + "type": "object" + }, "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec": { "description": "Specification for search as you type in search requests.", "id": "GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec", diff --git a/discoveryengine/v1beta/discoveryengine-gen.go b/discoveryengine/v1beta/discoveryengine-gen.go index 63c12207135..3997c5e17c0 100644 --- a/discoveryengine/v1beta/discoveryengine-gen.go +++ b/discoveryengine/v1beta/discoveryengine-gen.go @@ -2331,6 +2331,42 @@ func (s GoogleCloudDiscoveryengineV1AclConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1ActionConfig: Informations to support actions on +// the connector. +type GoogleCloudDiscoveryengineV1ActionConfig struct { + // ActionParams: Optional. Action parameters in structured json format. + ActionParams googleapi.RawMessage `json:"actionParams,omitempty"` + // IsActionConfigured: Output only. The connector contains the necessary + // parameters and is configured to support actions. + IsActionConfigured bool `json:"isActionConfigured,omitempty"` + // JsonActionParams: Optional. Action parameters in json string format. + JsonActionParams string `json:"jsonActionParams,omitempty"` + // ServiceName: Optional. The Service Directory resource name + // (projects/*/locations/*/namespaces/*/services/*) representing a VPC network + // endpoint used to connect to the data source's `instance_uri`, defined in + // DataConnector.params. Required when VPC Service Controls are enabled. + ServiceName string `json:"serviceName,omitempty"` + // UseStaticSecrets: Optional. Whether to use static secrets for the connector. + // If true, the secrets provided in the action_params will be ignored. + UseStaticSecrets bool `json:"useStaticSecrets,omitempty"` + // ForceSendFields is a list of field names (e.g. "ActionParams") 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. "ActionParams") 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 GoogleCloudDiscoveryengineV1ActionConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ActionConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig: Configuration data for // advance site search. type GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig struct { @@ -2358,6 +2394,63 @@ func (s GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1AlertPolicyConfig: The connector level alert +// config. +type GoogleCloudDiscoveryengineV1AlertPolicyConfig struct { + // AlertEnrollments: Optional. The enrollment states of each alert. + AlertEnrollments []*GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment `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 GoogleCloudDiscoveryengineV1AlertPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AlertPolicyConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment: The alert +// enrollment status. +type GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment 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 GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1AlertPolicyConfigAlertEnrollment + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1AnswerGenerationSpec: The specification for // answer generation. type GoogleCloudDiscoveryengineV1AnswerGenerationSpec struct { @@ -2700,6 +2793,40 @@ func (s GoogleCloudDiscoveryengineV1AssistantToolList) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1BAPConfig: The configuration for the BAP +// connector. +type GoogleCloudDiscoveryengineV1BAPConfig struct { + // EnabledActions: Optional. The actions enabled on the associated BAP + // connection. + EnabledActions []string `json:"enabledActions,omitempty"` + // SupportedConnectorModes: Required. The supported connector modes for the + // associated BAP connection. + // + // Possible values: + // "CONNECTOR_MODE_UNSPECIFIED" - Connector mode unspecified. + // "DATA_INGESTION" - Connector utilized for data ingestion. + // "ACTIONS" - Connector utilized for Actions + // "END_USER_AUTHENTICATION" - Connector utilized for End User + // Authentication. + SupportedConnectorModes []string `json:"supportedConnectorModes,omitempty"` + // ForceSendFields is a list of field names (e.g. "EnabledActions") 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. "EnabledActions") 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 GoogleCloudDiscoveryengineV1BAPConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1BAPConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata: Metadata related // to the progress of the SiteSearchEngineService.BatchCreateTargetSites // operation. This will be returned by the @@ -2874,6 +3001,37 @@ func (s GoogleCloudDiscoveryengineV1CmekConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1Collection: Collection is a container for +// configuring resources and access to a set of DataStores. +type GoogleCloudDiscoveryengineV1Collection struct { + // CreateTime: Output only. Timestamp the Collection was created at. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Required. The Collection display name. This field must be a + // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. + DisplayName string `json:"displayName,omitempty"` + // Name: Immutable. The full resource name of the Collection. Format: + // `projects/{project}/locations/{location}/collections/{collection_id}`. This + // field must be a UTF-8 encoded string with a length limit of 1024 characters. + Name string `json:"name,omitempty"` + // 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 GoogleCloudDiscoveryengineV1Collection) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1Collection + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1Condition: Defines circumstances to be checked // before allowing a behavior type GoogleCloudDiscoveryengineV1Condition struct { @@ -3430,94 +3588,551 @@ func (s GoogleCloudDiscoveryengineV1CreateTargetSiteMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings -// and configs at the DataStore level. -type GoogleCloudDiscoveryengineV1DataStore struct { - // AclEnabled: Immutable. Whether data in the DataStore has ACL information. If - // set to `true`, the source data must have ACL. ACL will be ingested when data - // is ingested by DocumentService.ImportDocuments methods. When ACL is enabled - // for the DataStore, Document can't be accessed by calling - // DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL - // is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` - // content config. +// GoogleCloudDiscoveryengineV1DataConnector: Manages the connection to +// external data sources for all data stores grouped under a Collection. It's a +// singleton resource of Collection. The initialization is only supported +// through DataConnectorService.SetUpDataConnector method, which will create a +// new Collection and initialize its DataConnector. +type GoogleCloudDiscoveryengineV1DataConnector struct { + // AclEnabled: Optional. Whether the connector will be created with an ACL + // config. Currently this field only affects Cloud Storage and BigQuery + // connectors. AclEnabled bool `json:"aclEnabled,omitempty"` - // AdvancedSiteSearchConfig: Optional. Configuration for advanced site search. - AdvancedSiteSearchConfig *GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig `json:"advancedSiteSearchConfig,omitempty"` - // BillingEstimation: Output only. Data size estimation for billing. - BillingEstimation *GoogleCloudDiscoveryengineV1DataStoreBillingEstimation `json:"billingEstimation,omitempty"` - // CmekConfig: Output only. CMEK-related information for the DataStore. - CmekConfig *GoogleCloudDiscoveryengineV1CmekConfig `json:"cmekConfig,omitempty"` - // ContentConfig: Immutable. The content config of the data store. If this - // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. + // ActionConfig: Optional. Action configurations to make the connector support + // actions. + ActionConfig *GoogleCloudDiscoveryengineV1ActionConfig `json:"actionConfig,omitempty"` + // ActionState: Output only. State of the action connector. This reflects + // whether the action connector is initializing, active or has encountered + // errors. // // Possible values: - // "CONTENT_CONFIG_UNSPECIFIED" - Default value. - // "NO_CONTENT" - Only contains documents without any Document.content. - // "CONTENT_REQUIRED" - Only contains documents with Document.content. - // "PUBLIC_WEBSITE" - The data store is used for public website search. - // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details - // of workspace data store are specified in the WorkspaceConfig. - ContentConfig string `json:"contentConfig,omitempty"` - // CreateTime: Output only. Timestamp the DataStore was created at. - CreateTime string `json:"createTime,omitempty"` - // DefaultSchemaId: Output only. The id of the default Schema associated to - // this data store. - DefaultSchemaId string `json:"defaultSchemaId,omitempty"` - // DisplayName: Required. The data store display name. This field must be a - // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an - // INVALID_ARGUMENT error is returned. - DisplayName string `json:"displayName,omitempty"` - // DocumentProcessingConfig: Configuration for Document understanding and - // enrichment. - DocumentProcessingConfig *GoogleCloudDiscoveryengineV1DocumentProcessingConfig `json:"documentProcessingConfig,omitempty"` - // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` - // vertical. - HealthcareFhirConfig *GoogleCloudDiscoveryengineV1HealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` - // IdentityMappingStore: Immutable. The fully qualified resource name of the - // associated IdentityMappingStore. This field can only be set for acl_enabled - // DataStores with `THIRD_PARTY` or `GSUITE` IdP. Format: - // `projects/{project}/locations/{location}/identityMappingStores/{identity_mapp - // ing_store}`. - IdentityMappingStore string `json:"identityMappingStore,omitempty"` - // IndustryVertical: Immutable. The industry vertical that the data store - // registers. + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + ActionState string `json:"actionState,omitempty"` + // AlertPolicyConfigs: Optional. The connector level alert config. + AlertPolicyConfigs []*GoogleCloudDiscoveryengineV1AlertPolicyConfig `json:"alertPolicyConfigs,omitempty"` + // AutoRunDisabled: Optional. Indicates whether the connector is disabled for + // auto run. It can be used to pause periodical and real time sync. Update: + // with the introduction of incremental_sync_disabled, auto_run_disabled is + // used to pause/disable only full syncs + AutoRunDisabled bool `json:"autoRunDisabled,omitempty"` + // BapConfig: Optional. The configuration for establishing a BAP connection. + BapConfig *GoogleCloudDiscoveryengineV1BAPConfig `json:"bapConfig,omitempty"` + // BlockingReasons: Output only. User actions that must be completed before the + // connector can start syncing data. // // Possible values: - // "INDUSTRY_VERTICAL_UNSPECIFIED" - Value used when unset. - // "GENERIC" - The generic vertical for documents that are not specific to - // any industry vertical. - // "MEDIA" - The media industry vertical. - // "HEALTHCARE_FHIR" - The healthcare FHIR vertical. - IndustryVertical string `json:"industryVertical,omitempty"` - // IsInfobotFaqDataStore: Optional. If set, this DataStore is an Infobot FAQ - // DataStore. - IsInfobotFaqDataStore bool `json:"isInfobotFaqDataStore,omitempty"` - // KmsKeyName: Input only. The KMS key to be used to protect this DataStore at - // creation time. Must be set for requests that need to comply with CMEK Org - // Policy protections. If this field is set and processed successfully, the - // DataStore will be protected by the KMS key, as indicated in the cmek_config - // field. - KmsKeyName string `json:"kmsKeyName,omitempty"` - // Name: Immutable. Identifier. The full resource name of the data store. - // Format: - // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor - // es/{data_store_id}`. This field must be a UTF-8 encoded string with a length - // limit of 1024 characters. - Name string `json:"name,omitempty"` - // ServingConfigDataStore: Optional. Stores serving config at DataStore level. - ServingConfigDataStore *GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore `json:"servingConfigDataStore,omitempty"` - // SolutionTypes: The solutions that the data store enrolls. Available - // solutions for each industry_vertical: * `MEDIA`: - // `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: - // `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be - // enrolled. + // "BLOCKING_REASON_UNSPECIFIED" - Default value. + // "ALLOWLIST_STATIC_IP" - Connector requires customer to allowlist static + // IPs. + // "ALLOWLIST_IN_SERVICE_ATTACHMENT" - Connector requires customer to + // allowlist our project in their service attachment. + // "ALLOWLIST_SERVICE_ACCOUNT" - Connector requires customer to allowlist + // service account in their project. + BlockingReasons []string `json:"blockingReasons,omitempty"` + // ConnectorModes: Optional. The modes enabled for this connector. Default + // state is CONNECTOR_MODE_UNSPECIFIED. // // Possible values: - // "SOLUTION_TYPE_UNSPECIFIED" - Default value. - // "SOLUTION_TYPE_RECOMMENDATION" - Used for Recommendations AI. - // "SOLUTION_TYPE_SEARCH" - Used for Discovery Search. - // "SOLUTION_TYPE_CHAT" - Used for use cases related to the Generative AI - // agent. + // "CONNECTOR_MODE_UNSPECIFIED" - Connector mode unspecified. + // "DATA_INGESTION" - Connector utilized for data ingestion. + // "ACTIONS" - Connector utilized for actions. + // "FEDERATED" - Connector utilized for federated search. + // "EUA" - Connector utilized for End User Authentication. + // "FEDERATED_AND_EUA" - Hybrid connector utilized for federated search and + // End User Authentication. + ConnectorModes []string `json:"connectorModes,omitempty"` + // ConnectorType: Output only. The type of connector. Each source can only map + // to one type. For example, salesforce, confluence and jira have THIRD_PARTY + // connector type. It is not mutable once set by system. + // + // Possible values: + // "CONNECTOR_TYPE_UNSPECIFIED" - Default value. + // "THIRD_PARTY" - Third party connector to connector to third party + // application. + // "GCP_FHIR" - Data connector connects between FHIR store and VAIS + // datastore. + // "BIG_QUERY" - Big query connector. + // "GCS" - Google Cloud Storage connector. + // "GOOGLE_MAIL" - Gmail connector. + // "GOOGLE_CALENDAR" - Google Calendar connector. + // "GOOGLE_DRIVE" - Google Drive connector. + // "NATIVE_CLOUD_IDENTITY" - Native Cloud Identity connector for people + // search powered by People API. + // "THIRD_PARTY_FEDERATED" - Federated connector, it is a third party + // connector that doesn't ingestion data, and search is powered by third party + // application's API. + // "THIRD_PARTY_EUA" - Connector utilized for End User Authentication + // features. + // "GCNV" - Google Cloud NetApp Volumes connector. + ConnectorType string `json:"connectorType,omitempty"` + // CreateEuaSaas: Optional. Whether the END USER AUTHENTICATION connector is + // created in SaaS. + CreateEuaSaas bool `json:"createEuaSaas,omitempty"` + // CreateTime: Output only. Timestamp the DataConnector was created at. + CreateTime string `json:"createTime,omitempty"` + // DataSource: Required. The name of the data source. Supported values: + // `salesforce`, `jira`, `confluence`, `bigquery`. + DataSource string `json:"dataSource,omitempty"` + // DestinationConfigs: Optional. Any target destinations used to connect to + // third-party services. + DestinationConfigs []*GoogleCloudDiscoveryengineV1DestinationConfig `json:"destinationConfigs,omitempty"` + // EndUserConfig: Optional. Any params and credentials used specifically for + // EUA connectors. + EndUserConfig *GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig `json:"endUserConfig,omitempty"` + // Entities: List of entities from the connected data source to ingest. + Entities []*GoogleCloudDiscoveryengineV1DataConnectorSourceEntity `json:"entities,omitempty"` + // Errors: Output only. The errors from initialization or from the latest + // connector run. + Errors []*GoogleRpcStatus `json:"errors,omitempty"` + // FederatedConfig: Optional. Any params and credentials used specifically for + // hybrid connectors supporting FEDERATED mode. This field should only be set + // if the connector is a hybrid connector and we want to enable FEDERATED mode. + FederatedConfig *GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig `json:"federatedConfig,omitempty"` + // HybridIngestionDisabled: Optional. If the connector is a hybrid connector, + // determines whether ingestion is enabled and appropriate resources are + // provisioned during connector creation. If the connector is not a hybrid + // connector, this field is ignored. + HybridIngestionDisabled bool `json:"hybridIngestionDisabled,omitempty"` + // IdentityRefreshInterval: The refresh interval to sync the Access Control + // List information for the documents ingested by this connector. If not set, + // the access control list will be refreshed at the default interval of 30 + // minutes. The identity refresh interval can be at least 30 minutes and at + // most 7 days. + IdentityRefreshInterval string `json:"identityRefreshInterval,omitempty"` + // IdentityScheduleConfig: The configuration for the identity data + // synchronization runs. This contains the refresh interval to sync the Access + // Control List information for the documents ingested by this connector. + IdentityScheduleConfig *GoogleCloudDiscoveryengineV1IdentityScheduleConfig `json:"identityScheduleConfig,omitempty"` + // IncrementalRefreshInterval: Optional. The refresh interval specifically for + // incremental data syncs. If unset, incremental syncs will use the default + // from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. + // Applicable to only 3P connectors. When the refresh interval is set to the + // same value as the incremental refresh interval, incremental sync will be + // disabled. + IncrementalRefreshInterval string `json:"incrementalRefreshInterval,omitempty"` + // IncrementalSyncDisabled: Optional. Indicates whether incremental syncs are + // paused for this connector. This is independent of auto_run_disabled. + // Applicable to only 3P connectors. When the refresh interval is set to the + // same value as the incremental refresh interval, incremental sync will be + // disabled, i.e. set to true. + IncrementalSyncDisabled bool `json:"incrementalSyncDisabled,omitempty"` + // JsonParams: Required data connector parameters in json string format. + JsonParams string `json:"jsonParams,omitempty"` + // KmsKeyName: Input only. The KMS key to be used to protect the DataStores + // managed by this connector. Must be set for requests that need to comply with + // CMEK Org Policy protections. If this field is set and processed + // successfully, the DataStores created by this connector will be protected by + // the KMS key. + KmsKeyName string `json:"kmsKeyName,omitempty"` + // LastSyncTime: Output only. For periodic connectors only, the last time a + // data sync was completed. + LastSyncTime string `json:"lastSyncTime,omitempty"` + // LatestPauseTime: Output only. The most recent timestamp when this + // DataConnector was paused, affecting all functionalities such as data + // synchronization. Pausing a connector has the following effects: - All + // functionalities, including data synchronization, are halted. - Any ongoing + // data synchronization job will be canceled. - No future data synchronization + // runs will be scheduled nor can be triggered. + LatestPauseTime string `json:"latestPauseTime,omitempty"` + // Name: Output only. The full resource name of the Data Connector. Format: + // `projects/*/locations/*/collections/*/dataConnector`. + Name string `json:"name,omitempty"` + // NextSyncTime: Defines the scheduled time for the next data synchronization. + // This field requires hour , minute, and time_zone from the IANA Time Zone + // Database (https://www.iana.org/time-zones). This is utilized when the data + // connector has a refresh interval greater than 1 day. When the hours or + // minutes are not specified, we will assume a sync time of 0:00. The user must + // provide a time zone to avoid ambiguity. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` + // Params: Required data connector parameters in structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // PrivateConnectivityProjectId: Output only. The tenant project ID associated + // with private connectivity connectors. This project must be allowlisted by in + // order for the connector to function. + PrivateConnectivityProjectId string `json:"privateConnectivityProjectId,omitempty"` + // RealtimeState: Output only. real-time sync state + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + RealtimeState string `json:"realtimeState,omitempty"` + // RealtimeSyncConfig: Optional. The configuration for realtime sync. + RealtimeSyncConfig *GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig `json:"realtimeSyncConfig,omitempty"` + // RefreshInterval: Required. The refresh interval for data sync. If duration + // is set to 0, the data will be synced in real time. The streaming feature is + // not supported yet. The minimum is 30 minutes and maximum is 7 days. When the + // refresh interval is set to the same value as the incremental refresh + // interval, incremental sync will be disabled. + RefreshInterval string `json:"refreshInterval,omitempty"` + // RemoveParamKeys: Optional. Specifies keys to be removed from the 'params' + // field. This is only active when 'params' is included in the 'update_mask' in + // an UpdateDataConnectorRequest. Deletion takes precedence if a key is both in + // 'remove_param_keys' and present in the 'params' field of the request. + RemoveParamKeys []string `json:"removeParamKeys,omitempty"` + // State: Output only. State of the connector. + // + // Possible values: + // "STATE_UNSPECIFIED" - Default value. + // "CREATING" - The connector is being set up. + // "ACTIVE" - The connector is successfully set up and awaiting next sync + // run. + // "FAILED" - The connector is in error. The error details can be found in + // DataConnector.errors. If the error is unfixable, the DataConnector can be + // deleted by [CollectionService.DeleteCollection] API. + // "RUNNING" - The connector is actively syncing records from the data + // source. + // "WARNING" - The connector has completed a sync run, but encountered + // non-fatal errors. + // "INITIALIZATION_FAILED" - Connector initialization failed. Potential + // causes include runtime errors or issues in the asynchronous pipeline, + // preventing the request from reaching downstream services (except for some + // connector types). + // "UPDATING" - Connector is in the process of an update. + State string `json:"state,omitempty"` + // StaticIpAddresses: Output only. The static IP addresses used by this + // connector. + StaticIpAddresses []string `json:"staticIpAddresses,omitempty"` + // StaticIpEnabled: Optional. Whether customer has enabled static IP addresses + // for this connector. + StaticIpEnabled bool `json:"staticIpEnabled,omitempty"` + // SyncMode: The data synchronization mode supported by the data connector. + // + // Possible values: + // "PERIODIC" - The connector will sync data periodically based on the + // refresh_interval. Use it with auto_run_disabled to pause the periodic sync, + // or indicate a one-time sync. + // "STREAMING" - The data will be synced in real time. + // "UNSPECIFIED" - Connector that doesn't ingest data will have this value + SyncMode string `json:"syncMode,omitempty"` + // UpdateTime: Output only. Timestamp the DataConnector was last updated. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "AclEnabled") 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. "AclEnabled") 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 GoogleCloudDiscoveryengineV1DataConnector) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnector + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig: Any params and +// credentials used specifically for EUA connectors. +type GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig struct { + // AdditionalParams: Optional. Any additional parameters needed for EUA. + AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` + // AuthParams: Optional. Any authentication parameters specific to EUA + // connectors. + AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to EUA + // connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` + // Tenant: Optional. The tenant project the connector is connected to. + Tenant *GoogleCloudDiscoveryengineV1Tenant `json:"tenant,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalParams") 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. "AdditionalParams") 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 GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorEndUserConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig: Any params and +// credentials used specifically for hybrid connectors supporting FEDERATED +// mode. +type GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig struct { + // AdditionalParams: Optional. Any additional parameters needed for FEDERATED. + AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` + // AuthParams: Optional. Any authentication parameters specific to FEDERATED + // connectors. + AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to + // FEDERATED connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalParams") 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. "AdditionalParams") 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 GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorFederatedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig: The +// configuration for realtime sync to store additional params for realtime +// sync. +type GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig struct { + // RealtimeSyncSecret: Optional. The ID of the Secret Manager secret used for + // webhook secret. + RealtimeSyncSecret string `json:"realtimeSyncSecret,omitempty"` + // StreamingError: Optional. Streaming error details. + StreamingError *GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError `json:"streamingError,omitempty"` + // WebhookUri: Optional. Webhook url for the connector to specify additional + // params for realtime sync. + WebhookUri string `json:"webhookUri,omitempty"` + // ForceSendFields is a list of field names (e.g. "RealtimeSyncSecret") 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. "RealtimeSyncSecret") 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 GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError: +// Streaming error details. +type GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError struct { + // Error: Optional. Error details. + Error *GoogleRpcStatus `json:"error,omitempty"` + // StreamingErrorReason: Optional. Streaming error. + // + // Possible values: + // "STREAMING_ERROR_REASON_UNSPECIFIED" - Streaming error reason unspecified. + // "STREAMING_SETUP_ERROR" - Some error occurred while setting up resources + // for realtime sync. + // "STREAMING_SYNC_ERROR" - Some error was encountered while running realtime + // sync for the connector. + // "INGRESS_ENDPOINT_REQUIRED" - Ingress endpoint is required when setting up + // realtime sync in private connectivity. + StreamingErrorReason string `json:"streamingErrorReason,omitempty"` + // ForceSendFields is a list of field names (e.g. "Error") 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. "Error") 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 GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorRealtimeSyncConfigStreamingError + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataConnectorSourceEntity: Represents an entity +// in the data source. For example, the `Account` object in Salesforce. +type GoogleCloudDiscoveryengineV1DataConnectorSourceEntity struct { + // DataStore: Output only. The full resource name of the associated data store + // for the source entity. Format: + // `projects/*/locations/*/collections/*/dataStores/*`. When the connector is + // initialized by the DataConnectorService.SetUpDataConnector method, a + // DataStore is automatically created for each source entity. + DataStore string `json:"dataStore,omitempty"` + // EntityName: The name of the entity. Supported values by data source: * + // Salesforce: `Lead`, `Opportunity`, `Contact`, `Account`, `Case`, `Contract`, + // `Campaign` * Jira: `Issue` * Confluence: `Content`, `Space` + EntityName string `json:"entityName,omitempty"` + // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` + // vertical. + HealthcareFhirConfig *GoogleCloudDiscoveryengineV1HealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` + // JsonParams: The parameters for the entity to facilitate data ingestion in + // json string format. + JsonParams string `json:"jsonParams,omitempty"` + // KeyPropertyMappings: Attributes for indexing. Key: Field name. Value: The + // key property to map a field to, such as `title`, and `description`. + // Supported key properties: * `title`: The title for data record. This would + // be displayed on search results. * `description`: The description for data + // record. This would be displayed on search results. + KeyPropertyMappings map[string]string `json:"keyPropertyMappings,omitempty"` + // Params: The parameters for the entity to facilitate data ingestion in + // structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // StartingSchema: Optional. The start schema to use for the DataStore created + // from this SourceEntity. If unset, a default vertical specialized schema will + // be used. This field is only used by SetUpDataConnector API, and will be + // ignored if used in other APIs. This field will be omitted from all API + // responses including GetDataConnector API. To retrieve a schema of a + // DataStore, use SchemaService.GetSchema API instead. The provided schema will + // be validated against certain rules on schema. Learn more from this doc + // (https://cloud.google.com/generative-ai-app-builder/docs/provide-schema). + StartingSchema *GoogleCloudDiscoveryengineV1Schema `json:"startingSchema,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 + // 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. "DataStore") 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 GoogleCloudDiscoveryengineV1DataConnectorSourceEntity) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DataConnectorSourceEntity + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DataStore: DataStore captures global settings +// and configs at the DataStore level. +type GoogleCloudDiscoveryengineV1DataStore struct { + // AclEnabled: Immutable. Whether data in the DataStore has ACL information. If + // set to `true`, the source data must have ACL. ACL will be ingested when data + // is ingested by DocumentService.ImportDocuments methods. When ACL is enabled + // for the DataStore, Document can't be accessed by calling + // DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL + // is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` + // content config. + AclEnabled bool `json:"aclEnabled,omitempty"` + // AdvancedSiteSearchConfig: Optional. Configuration for advanced site search. + AdvancedSiteSearchConfig *GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig `json:"advancedSiteSearchConfig,omitempty"` + // BillingEstimation: Output only. Data size estimation for billing. + BillingEstimation *GoogleCloudDiscoveryengineV1DataStoreBillingEstimation `json:"billingEstimation,omitempty"` + // CmekConfig: Output only. CMEK-related information for the DataStore. + CmekConfig *GoogleCloudDiscoveryengineV1CmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` + // ContentConfig: Immutable. The content config of the data store. If this + // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. + // + // Possible values: + // "CONTENT_CONFIG_UNSPECIFIED" - Default value. + // "NO_CONTENT" - Only contains documents without any Document.content. + // "CONTENT_REQUIRED" - Only contains documents with Document.content. + // "PUBLIC_WEBSITE" - The data store is used for public website search. + // "GOOGLE_WORKSPACE" - The data store is used for workspace search. Details + // of workspace data store are specified in the WorkspaceConfig. + ContentConfig string `json:"contentConfig,omitempty"` + // CreateTime: Output only. Timestamp the DataStore was created at. + CreateTime string `json:"createTime,omitempty"` + // DefaultSchemaId: Output only. The id of the default Schema associated to + // this data store. + DefaultSchemaId string `json:"defaultSchemaId,omitempty"` + // DisplayName: Required. The data store display name. This field must be a + // UTF-8 encoded string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. + DisplayName string `json:"displayName,omitempty"` + // DocumentProcessingConfig: Configuration for Document understanding and + // enrichment. + DocumentProcessingConfig *GoogleCloudDiscoveryengineV1DocumentProcessingConfig `json:"documentProcessingConfig,omitempty"` + // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` + // vertical. + HealthcareFhirConfig *GoogleCloudDiscoveryengineV1HealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` + // IdentityMappingStore: Immutable. The fully qualified resource name of the + // associated IdentityMappingStore. This field can only be set for acl_enabled + // DataStores with `THIRD_PARTY` or `GSUITE` IdP. Format: + // `projects/{project}/locations/{location}/identityMappingStores/{identity_mapp + // ing_store}`. + IdentityMappingStore string `json:"identityMappingStore,omitempty"` + // IndustryVertical: Immutable. The industry vertical that the data store + // registers. + // + // Possible values: + // "INDUSTRY_VERTICAL_UNSPECIFIED" - Value used when unset. + // "GENERIC" - The generic vertical for documents that are not specific to + // any industry vertical. + // "MEDIA" - The media industry vertical. + // "HEALTHCARE_FHIR" - The healthcare FHIR vertical. + IndustryVertical string `json:"industryVertical,omitempty"` + // IsInfobotFaqDataStore: Optional. If set, this DataStore is an Infobot FAQ + // DataStore. + IsInfobotFaqDataStore bool `json:"isInfobotFaqDataStore,omitempty"` + // KmsKeyName: Input only. The KMS key to be used to protect this DataStore at + // creation time. Must be set for requests that need to comply with CMEK Org + // Policy protections. If this field is set and processed successfully, the + // DataStore will be protected by the KMS key, as indicated in the cmek_config + // field. + KmsKeyName string `json:"kmsKeyName,omitempty"` + // Name: Immutable. Identifier. The full resource name of the data store. + // Format: + // `projects/{project}/locations/{location}/collections/{collection_id}/dataStor + // es/{data_store_id}`. This field must be a UTF-8 encoded string with a length + // limit of 1024 characters. + Name string `json:"name,omitempty"` + // ServingConfigDataStore: Optional. Stores serving config at DataStore level. + ServingConfigDataStore *GoogleCloudDiscoveryengineV1DataStoreServingConfigDataStore `json:"servingConfigDataStore,omitempty"` + // SolutionTypes: The solutions that the data store enrolls. Available + // solutions for each industry_vertical: * `MEDIA`: + // `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: + // `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be + // enrolled. + // + // Possible values: + // "SOLUTION_TYPE_UNSPECIFIED" - Default value. + // "SOLUTION_TYPE_RECOMMENDATION" - Used for Recommendations AI. + // "SOLUTION_TYPE_SEARCH" - Used for Discovery Search. + // "SOLUTION_TYPE_CHAT" - Used for use cases related to the Generative AI + // agent. // "SOLUTION_TYPE_GENERATIVE_CHAT" - Used for use cases related to the // Generative Chat agent. It's used for Generative chat engine only, the // associated data stores must enrolled with `SOLUTION_TYPE_CHAT` solution. @@ -3637,6 +4252,33 @@ func (s GoogleCloudDiscoveryengineV1DeleteCmekConfigMetadata) MarshalJSON() ([]b return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1DeleteCollectionMetadata: Metadata related to +// the progress of the CollectionService.UpdateCollection operation. This will +// be returned by the google.longrunning.Operation.metadata field. +type GoogleCloudDiscoveryengineV1DeleteCollectionMetadata struct { + // CreateTime: Operation create time. + CreateTime string `json:"createTime,omitempty"` + // UpdateTime: Operation last update time. If the operation is done, this is + // also the finish time. + UpdateTime string `json:"updateTime,omitempty"` + // 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 GoogleCloudDiscoveryengineV1DeleteCollectionMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteCollectionMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata: Metadata related to the // progress of the DataStoreService.DeleteDataStore operation. This will be // returned by the google.longrunning.Operation.metadata field. @@ -3794,8 +4436,65 @@ type GoogleCloudDiscoveryengineV1DeleteTargetSiteMetadata struct { NullFields []string `json:"-"` } -func (s GoogleCloudDiscoveryengineV1DeleteTargetSiteMetadata) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDiscoveryengineV1DeleteTargetSiteMetadata +func (s GoogleCloudDiscoveryengineV1DeleteTargetSiteMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DeleteTargetSiteMetadata + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DestinationConfig: Defines target endpoints used +// to connect to third-party sources. +type GoogleCloudDiscoveryengineV1DestinationConfig struct { + // Destinations: Optional. The destinations for the corresponding key. + Destinations []*GoogleCloudDiscoveryengineV1DestinationConfigDestination `json:"destinations,omitempty"` + // JsonParams: Additional parameters for this destination config in json string + // format. + JsonParams string `json:"jsonParams,omitempty"` + // Key: Optional. Unique destination identifier that is supported by the + // connector. + Key string `json:"key,omitempty"` + // Params: Optional. Additional parameters for this destination config in + // structured json format. + Params googleapi.RawMessage `json:"params,omitempty"` + // ForceSendFields is a list of field names (e.g. "Destinations") 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. "Destinations") 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 GoogleCloudDiscoveryengineV1DestinationConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DestinationConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1DestinationConfigDestination: Defines a target +// endpoint +type GoogleCloudDiscoveryengineV1DestinationConfigDestination struct { + // Host: Publicly routable host. + Host string `json:"host,omitempty"` + // Port: Optional. Target port number accepted by the destination. + Port int64 `json:"port,omitempty"` + // ForceSendFields is a list of field names (e.g. "Host") 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. "Host") 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 GoogleCloudDiscoveryengineV1DestinationConfigDestination) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1DestinationConfigDestination return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } @@ -4083,6 +4782,15 @@ type GoogleCloudDiscoveryengineV1Engine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1EngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1EngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -4104,8 +4812,8 @@ type GoogleCloudDiscoveryengineV1Engine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -4576,6 +5284,38 @@ func (s GoogleCloudDiscoveryengineV1IdentityMappingEntryOperationMetadata) Marsh return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1IdentityScheduleConfig: The configuration for +// the identity data synchronization runs. +type GoogleCloudDiscoveryengineV1IdentityScheduleConfig struct { + // NextSyncTime: Optional. The UTC time when the next data sync is expected to + // start for the Data Connector. Customers are only able to specify the hour + // and minute to schedule the data sync. This is utilized when the data + // connector has a refresh interval greater than 1 day. + NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` + // RefreshInterval: Optional. The refresh interval to sync the Access Control + // List information for the documents ingested by this connector. If not set, + // the access control list will be refreshed at the default interval of 30 + // minutes. The identity refresh interval can be at least 30 minutes and at + // most 7 days. + RefreshInterval string `json:"refreshInterval,omitempty"` + // ForceSendFields is a list of field names (e.g. "NextSyncTime") 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. "NextSyncTime") 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 GoogleCloudDiscoveryengineV1IdentityScheduleConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1IdentityScheduleConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1IdpConfig: Identity Provider Config. type GoogleCloudDiscoveryengineV1IdpConfig struct { // ExternalIdpConfig: External Identity provider config. @@ -4923,6 +5663,8 @@ func (s GoogleCloudDiscoveryengineV1ImportUserEventsResponse) MarshalJSON() ([]b type GoogleCloudDiscoveryengineV1Project struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -4953,6 +5695,85 @@ func (s GoogleCloudDiscoveryengineV1Project) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig: Customer provided +// configurations. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig: +// Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigMode +// lArmorConfig: Configuration for customer defined Model Armor templates to be +// used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1ProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1ProjectServiceTerms: Metadata about the terms of // service. type GoogleCloudDiscoveryengineV1ProjectServiceTerms struct { @@ -5757,6 +6578,11 @@ func (s *GoogleCloudDiscoveryengineV1ServingConfigMediaConfig) UnmarshalJSON(dat return nil } +// GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata: Metadata for +// DataConnectorService.SetUpDataConnector method. +type GoogleCloudDiscoveryengineV1SetUpDataConnectorMetadata struct { +} + // GoogleCloudDiscoveryengineV1SingleRegionKey: Metadata for single-regional // CMEKs. type GoogleCloudDiscoveryengineV1SingleRegionKey struct { @@ -5963,6 +6789,38 @@ func (s GoogleCloudDiscoveryengineV1TargetSiteFailureReasonQuotaFailure) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1Tenant: Tenant information for a connector +// source. This includes some of the same information stored in the Credential +// message, but is limited to only what is needed to provide a list of +// accessible tenants to the user. +type GoogleCloudDiscoveryengineV1Tenant struct { + // DisplayName: Optional display name for the tenant, e.g. "My Slack Team". + DisplayName string `json:"displayName,omitempty"` + // Id: The tenant's instance ID. Examples: Jira + // ("8594f221-9797-5f78-1fa4-485e198d7cd0"), Slack ("T123456"). + Id string `json:"id,omitempty"` + // Uri: The URI of the tenant, if applicable. For example, the URI of a Jira + // instance is https://my-jira-instance.atlassian.net, and a Slack tenant does + // not have a URI. + Uri string `json:"uri,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 GoogleCloudDiscoveryengineV1Tenant) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1Tenant + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1TrainCustomModelMetadata: Metadata related to // the progress of the TrainCustomModel operation. This is returned by the // google.longrunning.Operation.metadata field. @@ -6238,17 +7096,13 @@ func (s GoogleCloudDiscoveryengineV1alphaAclConfig) MarshalJSON() ([]byte, error // GoogleCloudDiscoveryengineV1alphaActionConfig: Informations to support // actions on the connector. type GoogleCloudDiscoveryengineV1alphaActionConfig struct { - // ActionParams: Required. Params needed to support actions in the format of - // (Key, Value) pairs. Required parameters for sources that support OAUTH, i.e. - // `gmail`, `google_calendar`, `jira`, `workday`, `salesforce`, `confluence`: * - // Key: `client_id` * Value: type STRING. The client ID for the service - // provider to identify your application. * Key: `client_secret` * Value:type - // STRING. The client secret generated by the application's authorization - // server. + // ActionParams: Optional. Action parameters in structured json format. ActionParams googleapi.RawMessage `json:"actionParams,omitempty"` // IsActionConfigured: Output only. The connector contains the necessary // parameters and is configured to support actions. IsActionConfigured bool `json:"isActionConfigured,omitempty"` + // JsonActionParams: Optional. Action parameters in json string format. + JsonActionParams string `json:"jsonActionParams,omitempty"` // ServiceName: Optional. The Service Directory resource name // (projects/*/locations/*/namespaces/*/services/*) representing a VPC network // endpoint used to connect to the data source's `instance_uri`, defined in @@ -7112,6 +7966,9 @@ func (s GoogleCloudDiscoveryengineV1alphaAnswerStepActionSearchAction) MarshalJS // GoogleCloudDiscoveryengineV1alphaBAPConfig: The configuration for the BAP // connector. type GoogleCloudDiscoveryengineV1alphaBAPConfig struct { + // EnabledActions: Optional. The actions enabled on the associated BAP + // connection. + EnabledActions []string `json:"enabledActions,omitempty"` // SupportedConnectorModes: Required. The supported connector modes for the // associated BAP connection. // @@ -7122,15 +7979,15 @@ type GoogleCloudDiscoveryengineV1alphaBAPConfig struct { // "END_USER_AUTHENTICATION" - Connector utilized for End User // Authentication. SupportedConnectorModes []string `json:"supportedConnectorModes,omitempty"` - // ForceSendFields is a list of field names (e.g. "SupportedConnectorModes") to + // ForceSendFields is a list of field names (e.g. "EnabledActions") 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. "SupportedConnectorModes") 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. "EnabledActions") 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:"-"` } @@ -8291,6 +9148,8 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // same value as the incremental refresh interval, incremental sync will be // disabled, i.e. set to true. IncrementalSyncDisabled bool `json:"incrementalSyncDisabled,omitempty"` + // JsonParams: Required data connector parameters in json string format. + JsonParams string `json:"jsonParams,omitempty"` // KmsKeyName: Input only. The KMS key to be used to protect the DataStores // managed by this connector. Must be set for requests that need to comply with // CMEK Org Policy protections. If this field is set and processed @@ -8317,28 +9176,7 @@ type GoogleCloudDiscoveryengineV1alphaDataConnector struct { // minutes are not specified, we will assume a sync time of 0:00. The user must // provide a time zone to avoid ambiguity. NextSyncTime *GoogleTypeDateTime `json:"nextSyncTime,omitempty"` - // Params: Required. Params needed to access the source in the format of (Key, - // Value) pairs. Required parameters for all data sources: * Key: - // `instance_uri` * Value: type STRING. The uri to access the data source. - // Required parameters for sources that support OAUTH, i.e. `salesforce`: * - // Key: `client_id` * Value: type STRING. The client ID for the third party - // service provider to identify your application. * Key: `client_secret` * - // Value:type STRING. The client secret generated by the third party - // authorization server. * Key: `access_token` * Value: type STRING. OAuth - // token for UCS to access to the protected resource. * Key: `refresh_token` * - // Value: type STRING. OAuth refresh token for UCS to obtain a new access token - // without user interaction. Required parameters for sources that support basic - // API token auth, i.e. `jira`, `confluence`: * Key: `user_account` * Value: - // type STRING. The username or email with the source. * Key: `api_token` * - // Value: type STRING. The API token generated for the source account, that is - // used for authenticating anywhere where you would have used a password. - // Example: ```json { "instance_uri": "https://xxx.atlassian.net", - // "user_account": "xxxx.xxx@xxx.com", "api_token": "test-token" } ``` Optional - // parameter to specify the authorization type to use for multiple - // authorization types support: * Key: `auth_type` * Value: type STRING. The - // authorization type for the data source. Supported values: `BASIC_AUTH`, - // `OAUTH`, `OAUTH_ACCESS_TOKEN`, `OAUTH_TWO_LEGGED`, `OAUTH_JWT_BEARER`, - // `OAUTH_PASSWORD_GRANT`, `JWT`, `API_TOKEN`, `FEDERATED_CREDENTIAL`. + // Params: Required data connector parameters in structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // PrivateConnectivityProjectId: Output only. The tenant project ID associated // with private connectivity connectors. This project must be allowlisted by in @@ -8440,6 +9278,9 @@ type GoogleCloudDiscoveryengineV1alphaDataConnectorEndUserConfig struct { // AuthParams: Optional. Any authentication parameters specific to EUA // connectors. AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to EUA + // connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` // Tenant: Optional. The tenant project the connector is connected to. Tenant *GoogleCloudDiscoveryengineV1alphaTenant `json:"tenant,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalParams") to @@ -8466,8 +9307,12 @@ func (s GoogleCloudDiscoveryengineV1alphaDataConnectorEndUserConfig) MarshalJSON type GoogleCloudDiscoveryengineV1alphaDataConnectorFederatedConfig struct { // AdditionalParams: Optional. Any additional parameters needed for FEDERATED. AdditionalParams googleapi.RawMessage `json:"additionalParams,omitempty"` - // AuthParams: Optional. Any authentication parameters specific to FEDERATED. + // AuthParams: Optional. Any authentication parameters specific to FEDERATED + // connectors. AuthParams googleapi.RawMessage `json:"authParams,omitempty"` + // JsonAuthParams: Optional. Any authentication parameters specific to + // FEDERATED connectors in json string format. + JsonAuthParams string `json:"jsonAuthParams,omitempty"` // ForceSendFields is a list of field names (e.g. "AdditionalParams") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -8566,15 +9411,17 @@ type GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity struct { // HealthcareFhirConfig: Optional. Configuration for `HEALTHCARE_FHIR` // vertical. HealthcareFhirConfig *GoogleCloudDiscoveryengineV1alphaHealthcareFhirConfig `json:"healthcareFhirConfig,omitempty"` + // JsonParams: The parameters for the entity to facilitate data ingestion in + // json string format. + JsonParams string `json:"jsonParams,omitempty"` // KeyPropertyMappings: Attributes for indexing. Key: Field name. Value: The // key property to map a field to, such as `title`, and `description`. // Supported key properties: * `title`: The title for data record. This would // be displayed on search results. * `description`: The description for data // record. This would be displayed on search results. KeyPropertyMappings map[string]string `json:"keyPropertyMappings,omitempty"` - // Params: The parameters for the entity to facilitate data ingestion. E.g. for - // BigQuery connectors: * Key: `document_id_column` * Value: type STRING. The - // value of the column ID. + // Params: The parameters for the entity to facilitate data ingestion in + // structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // StartingSchema: Optional. The start schema to use for the DataStore created // from this SourceEntity. If unset, a default vertical specialized schema will @@ -8620,6 +9467,18 @@ type GoogleCloudDiscoveryengineV1alphaDataStore struct { BillingEstimation *GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // CmekConfig: Output only. CMEK-related information for the DataStore. CmekConfig *GoogleCloudDiscoveryengineV1alphaCmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -9075,10 +9934,14 @@ func (s GoogleCloudDiscoveryengineV1alphaDeleteTargetSiteMetadata) MarshalJSON() type GoogleCloudDiscoveryengineV1alphaDestinationConfig struct { // Destinations: Optional. The destinations for the corresponding key. Destinations []*GoogleCloudDiscoveryengineV1alphaDestinationConfigDestination `json:"destinations,omitempty"` + // JsonParams: Additional parameters for this destination config in json string + // format. + JsonParams string `json:"jsonParams,omitempty"` // Key: Optional. Unique destination identifier that is supported by the // connector. Key string `json:"key,omitempty"` - // Params: Optional. Additional parameters for this destination config. + // Params: Optional. Additional parameters for this destination config in + // structured json format. Params googleapi.RawMessage `json:"params,omitempty"` // ForceSendFields is a list of field names (e.g. "Destinations") to // unconditionally include in API requests. By default, fields with empty or @@ -9407,6 +10270,15 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1alphaEngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1alphaEngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -9428,8 +10300,8 @@ type GoogleCloudDiscoveryengineV1alphaEngine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -11080,6 +11952,8 @@ func (s GoogleCloudDiscoveryengineV1alphaOrganicCrawlRateTimeSeries) MarshalJSON type GoogleCloudDiscoveryengineV1alphaProject struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -11110,6 +11984,85 @@ func (s GoogleCloudDiscoveryengineV1alphaProject) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig: Customer +// provided configurations. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfi +// g: Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfi +// gModelArmorConfig: Configuration for customer defined Model Armor templates +// to be used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaProjectServiceTerms: Metadata about the // terms of service. type GoogleCloudDiscoveryengineV1alphaProjectServiceTerms struct { @@ -11924,9 +12877,9 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // better interpret the query. If a value isn't specified, the query language // code is automatically detected, which may not be accurate. LanguageCode string `json:"languageCode,omitempty"` - // NaturalLanguageQueryUnderstandingSpec: Config for natural language query - // understanding capabilities, such as extracting structured field filters from - // the query. Refer to this documentation + // NaturalLanguageQueryUnderstandingSpec: Optional. Config for natural language + // query understanding capabilities, such as extracting structured field + // filters from the query. Refer to this documentation // (https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) // for more information. If `naturalLanguageQueryUnderstandingSpec` is not // specified, no additional natural language query understanding will be done. @@ -11934,7 +12887,8 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as // relevant) in search results. This field is only considered if page_token is - // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. + // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large + // offset may be capped to a reasonable threshold. Offset int64 `json:"offset,omitempty"` // OneBoxPageSize: The maximum number of results to return for OneBox. This // applies to each OneBox type individually. Default number is 10. @@ -12076,6 +13030,10 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequest struct { // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` + // SearchAddonSpec: Optional. SearchAddonSpec is used to disable add-ons for + // search as per new repricing model. This field is only supported for search + // requests. + SearchAddonSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec `json:"searchAddonSpec,omitempty"` // SearchAsYouTypeSpec: Search as you type configuration. Only supported for // the IndustryVertical.MEDIA vertical. SearchAsYouTypeSpec *GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec `json:"searchAsYouTypeSpec,omitempty"` @@ -12973,6 +13931,15 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestImageQuery) MarshalJSON() // ngSpec: Specification to enable natural language understanding capabilities // for search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { + // AllowedFieldNames: Optional. Allowlist of fields that can be used for + // natural language filter extraction. By default, if this is unspecified, all + // indexable fields are eligible for natural language filter extraction (but + // are not guaranteed to be used). If any fields are specified in + // allowed_field_names, only the fields that are both marked as indexable in + // the schema and specified in the allowlist will be eligible for natural + // language filter extraction. Note: for multi-datastore search, this is not + // yet supported, and will be ignored. + AllowedFieldNames []string `json:"allowedFieldNames,omitempty"` // ExtractedFilterBehavior: Optional. Controls behavior of how extracted // filters are applied to the search. The default behavior depends on the // request. For single datastore structured search, the default is @@ -13008,15 +13975,15 @@ type GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstan // If this field is set, it overrides the field names set in // ServingConfig.geo_search_query_detection_field_names. GeoSearchQueryDetectionFieldNames []string `json:"geoSearchQueryDetectionFieldNames,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExtractedFilterBehavior") to + // ForceSendFields is a list of field names (e.g. "AllowedFieldNames") 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. "ExtractedFilterBehavior") 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. "AllowedFieldNames") 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:"-"` } @@ -13116,6 +14083,39 @@ func (s GoogleCloudDiscoveryengineV1alphaSearchRequestRelevanceScoreSpec) Marsha return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec: +// SearchAddonSpec is used to disable add-ons for search as per new repricing +// model. By default if the SearchAddonSpec is not specified, we consider that +// the customer wants to enable them wherever applicable. +type GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec struct { + // DisableGenerativeAnswerAddOn: Optional. If true, generative answer add-on is + // disabled. Generative answer add-on includes natural language to filters and + // simple answers. + DisableGenerativeAnswerAddOn bool `json:"disableGenerativeAnswerAddOn,omitempty"` + // DisableKpiPersonalizationAddOn: Optional. If true, disables event re-ranking + // and personalization to optimize KPIs & personalize results. + DisableKpiPersonalizationAddOn bool `json:"disableKpiPersonalizationAddOn,omitempty"` + // DisableSemanticAddOn: Optional. If true, semantic add-on is disabled. + // Semantic add-on includes embeddings and jetstream. + DisableSemanticAddOn bool `json:"disableSemanticAddOn,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DisableGenerativeAnswerAddOn") 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. "DisableGenerativeAnswerAddOn") 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 GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAddonSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec: // Specification for search as you type in search requests. type GoogleCloudDiscoveryengineV1alphaSearchRequestSearchAsYouTypeSpec struct { @@ -16926,6 +17926,9 @@ type GoogleCloudDiscoveryengineV1betaAssistantGroundedContentTextGroundingMetada // contain a URL that redirects to the actual website, in which case this will // contain the domain name of the target site. Domain string `json:"domain,omitempty"` + // MimeType: The mime type of the document. + // https://www.iana.org/assignments/media-types/media-types.xhtml. + MimeType string `json:"mimeType,omitempty"` // PageIdentifier: Page identifier. PageIdentifier string `json:"pageIdentifier,omitempty"` // Title: Title. @@ -19178,6 +20181,18 @@ type GoogleCloudDiscoveryengineV1betaDataStore struct { BillingEstimation *GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation `json:"billingEstimation,omitempty"` // CmekConfig: Output only. CMEK-related information for the DataStore. CmekConfig *GoogleCloudDiscoveryengineV1betaCmekConfig `json:"cmekConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details, only + // apply to non-Spark UCS Search. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. + // "CONFIGURABLE_SUBSCRIPTION_INDEXING_CORE" - Use the subscription base + + // overage billing for indexing core for non embedding storage. + // "CONFIGURABLE_CONSUMPTION_EMBEDDING" - Use the consumption pay-as-you-go + // billing for embedding storage add-on. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // ContentConfig: Immutable. The content config of the data store. If this // field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. // @@ -20163,6 +21178,15 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { ChatEngineMetadata *GoogleCloudDiscoveryengineV1betaEngineChatEngineMetadata `json:"chatEngineMetadata,omitempty"` // CommonConfig: Common config spec that specifies the metadata of the engine. CommonConfig *GoogleCloudDiscoveryengineV1betaEngineCommonConfig `json:"commonConfig,omitempty"` + // ConfigurableBillingApproach: Optional. Configuration for configurable + // billing approach. See go/vais-repricing-billing-dd for more details. + // + // Possible values: + // "CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED" - Default value. For Spark and + // non-Spark non-configurable billing approach. General pricing model. + // "CONFIGURABLE_BILLING_APPROACH_ENABLED" - The billing approach follows + // configurations specified by customer. + ConfigurableBillingApproach string `json:"configurableBillingApproach,omitempty"` // CreateTime: Output only. Timestamp the Recommendation Engine was created at. CreateTime string `json:"createTime,omitempty"` // DataStoreIds: Optional. The data stores associated with this engine. For @@ -20184,8 +21208,8 @@ type GoogleCloudDiscoveryengineV1betaEngine struct { // `no-code-agent-builder` * `prompt-gallery` * `model-selector` * // `notebook-lm` * `people-search` * `people-search-org-chart` * // `bi-directional-audio` * `feedback` * `session-sharing` * - // `personalization-memory` - Enables personalization based on user - // preferences. + // `personalization-memory` * `disable-image-generation` * + // `disable-video-generation` * `disable-onedrive-upload` Features map[string]string `json:"features,omitempty"` // IndustryVertical: Optional. The industry vertical that the engine registers. // The restriction of the Engine industry vertical is based on DataStore: @@ -22814,6 +23838,8 @@ func (s GoogleCloudDiscoveryengineV1betaPrincipal) MarshalJSON() ([]byte, error) type GoogleCloudDiscoveryengineV1betaProject struct { // CreateTime: Output only. The timestamp when this project is created. CreateTime string `json:"createTime,omitempty"` + // CustomerProvidedConfig: Optional. Customer provided configurations. + CustomerProvidedConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig `json:"customerProvidedConfig,omitempty"` // Name: Output only. Full resource name of the project, for example // `projects/{project}`. Note that when making requests, project number and // project id are both acceptable, but the server will always respond in @@ -22844,6 +23870,85 @@ func (s GoogleCloudDiscoveryengineV1betaProject) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig: Customer +// provided configurations. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig struct { + // NotebooklmConfig: Optional. Configuration for NotebookLM settings. + NotebooklmConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig `json:"notebooklmConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "NotebooklmConfig") 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. "NotebooklmConfig") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig +// : Configuration for NotebookLM. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig struct { + // ModelArmorConfig: Model Armor configuration to be used for sanitizing user + // prompts and LLM responses. + ModelArmorConfig *GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig `json:"modelArmorConfig,omitempty"` + // ForceSendFields is a list of field names (e.g. "ModelArmorConfig") 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. "ModelArmorConfig") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfig +// ModelArmorConfig: Configuration for customer defined Model Armor templates +// to be used for sanitizing user prompts and LLM responses. +type GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig struct { + // ResponseTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing LLM responses. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the LLM response. + ResponseTemplate string `json:"responseTemplate,omitempty"` + // UserPromptTemplate: Optional. The resource name of the Model Armor Template + // for sanitizing user prompts. Format: + // projects/{project}/locations/{location}/templates/{template_id} If not + // specified, no sanitization will be applied to the user prompt. + UserPromptTemplate string `json:"userPromptTemplate,omitempty"` + // ForceSendFields is a list of field names (e.g. "ResponseTemplate") 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. "ResponseTemplate") 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 GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaProjectCustomerProvidedConfigNotebooklmConfigModelArmorConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaProjectServiceTerms: Metadata about the // terms of service. type GoogleCloudDiscoveryengineV1betaProjectServiceTerms struct { @@ -22934,6 +24039,9 @@ type GoogleCloudDiscoveryengineV1betaProvisionProjectRequestSaasParams struct { // would like to give consent to the [Terms for Agent Space quality of // service]. AcceptBizQos bool `json:"acceptBizQos,omitempty"` + // IsBiz: Optional. Indicates if the current request is for Biz edition (= + // true) or not (= false). + IsBiz bool `json:"isBiz,omitempty"` // ForceSendFields is a list of field names (e.g. "AcceptBizQos") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -24289,9 +25397,9 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // better interpret the query. If a value isn't specified, the query language // code is automatically detected, which may not be accurate. LanguageCode string `json:"languageCode,omitempty"` - // NaturalLanguageQueryUnderstandingSpec: Config for natural language query - // understanding capabilities, such as extracting structured field filters from - // the query. Refer to this documentation + // NaturalLanguageQueryUnderstandingSpec: Optional. Config for natural language + // query understanding capabilities, such as extracting structured field + // filters from the query. Refer to this documentation // (https://cloud.google.com/generative-ai-app-builder/docs/natural-language-queries) // for more information. If `naturalLanguageQueryUnderstandingSpec` is not // specified, no additional natural language query understanding will be done. @@ -24299,7 +25407,8 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // Offset: A 0-indexed integer that specifies the current offset (that is, // starting result location, amongst the Documents deemed by the API as // relevant) in search results. This field is only considered if page_token is - // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. + // unset. If this field is negative, an `INVALID_ARGUMENT` is returned. A large + // offset may be capped to a reasonable threshold. Offset int64 `json:"offset,omitempty"` // OneBoxPageSize: The maximum number of results to return for OneBox. This // applies to each OneBox type individually. Default number is 10. @@ -24441,6 +25550,10 @@ type GoogleCloudDiscoveryengineV1betaSearchRequest struct { // SafeSearch: Whether to turn on safe search. This is only supported for // website search. SafeSearch bool `json:"safeSearch,omitempty"` + // SearchAddonSpec: Optional. SearchAddonSpec is used to disable add-ons for + // search as per new repricing model. This field is only supported for search + // requests. + SearchAddonSpec *GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec `json:"searchAddonSpec,omitempty"` // SearchAsYouTypeSpec: Search as you type configuration. Only supported for // the IndustryVertical.MEDIA vertical. SearchAsYouTypeSpec *GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec `json:"searchAsYouTypeSpec,omitempty"` @@ -25333,6 +26446,15 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestImageQuery) MarshalJSON() ( // gSpec: Specification to enable natural language understanding capabilities // for search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec struct { + // AllowedFieldNames: Optional. Allowlist of fields that can be used for + // natural language filter extraction. By default, if this is unspecified, all + // indexable fields are eligible for natural language filter extraction (but + // are not guaranteed to be used). If any fields are specified in + // allowed_field_names, only the fields that are both marked as indexable in + // the schema and specified in the allowlist will be eligible for natural + // language filter extraction. Note: for multi-datastore search, this is not + // yet supported, and will be ignored. + AllowedFieldNames []string `json:"allowedFieldNames,omitempty"` // ExtractedFilterBehavior: Optional. Controls behavior of how extracted // filters are applied to the search. The default behavior depends on the // request. For single datastore structured search, the default is @@ -25368,15 +26490,15 @@ type GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstand // If this field is set, it overrides the field names set in // ServingConfig.geo_search_query_detection_field_names. GeoSearchQueryDetectionFieldNames []string `json:"geoSearchQueryDetectionFieldNames,omitempty"` - // ForceSendFields is a list of field names (e.g. "ExtractedFilterBehavior") to + // ForceSendFields is a list of field names (e.g. "AllowedFieldNames") 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. "ExtractedFilterBehavior") 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. "AllowedFieldNames") 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:"-"` } @@ -25476,6 +26598,39 @@ func (s GoogleCloudDiscoveryengineV1betaSearchRequestRelevanceScoreSpec) Marshal return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec: +// SearchAddonSpec is used to disable add-ons for search as per new repricing +// model. By default if the SearchAddonSpec is not specified, we consider that +// the customer wants to enable them wherever applicable. +type GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec struct { + // DisableGenerativeAnswerAddOn: Optional. If true, generative answer add-on is + // disabled. Generative answer add-on includes natural language to filters and + // simple answers. + DisableGenerativeAnswerAddOn bool `json:"disableGenerativeAnswerAddOn,omitempty"` + // DisableKpiPersonalizationAddOn: Optional. If true, disables event re-ranking + // and personalization to optimize KPIs & personalize results. + DisableKpiPersonalizationAddOn bool `json:"disableKpiPersonalizationAddOn,omitempty"` + // DisableSemanticAddOn: Optional. If true, semantic add-on is disabled. + // Semantic add-on includes embeddings and jetstream. + DisableSemanticAddOn bool `json:"disableSemanticAddOn,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "DisableGenerativeAnswerAddOn") 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. "DisableGenerativeAnswerAddOn") 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 GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDiscoveryengineV1betaSearchRequestSearchAddonSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec: // Specification for search as you type in search requests. type GoogleCloudDiscoveryengineV1betaSearchRequestSearchAsYouTypeSpec struct { diff --git a/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index 5ea2af1a6f0..3838f401fc9 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -5123,7 +5123,7 @@ } } }, - "revision": "20250824", + "revision": "20250914", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -8657,6 +8657,10 @@ "includeRegexes": { "$ref": "GooglePrivacyDlpV2FileStoreRegexes", "description": "Optional. A collection of regular expressions to match a file store against." + }, + "includeTags": { + "$ref": "GooglePrivacyDlpV2TagFilters", + "description": "Optional. To be included in the collection, a resource must meet all of the following requirements: - If tag filters are provided, match all provided tag filters. - If one or more patterns are specified, match at least one pattern. For a resource to match the tag filters, the resource must have all of the provided tags attached. Tags refer to Resource Manager tags bound to the resource or its ancestors. See https://cloud.google.com/sensitive-data-protection/docs/profile-project-cloud-storage#manage-schedules to learn more." } }, "type": "object" @@ -10800,6 +10804,10 @@ ], "type": "string" }, + "storagePath": { + "$ref": "GooglePrivacyDlpV2CloudStoragePath", + "description": "Store findings in an existing Cloud Storage bucket. Files will be generated with the job ID and file part number as the filename, and will contain findings in textproto format as SaveToGcsFindingsOutput. The file name will use the naming convention -, for example: my-job-id-2. Supported for Inspect jobs. The bucket must not be the same as the bucket being inspected. If storing findings to Cloud Storage, the output schema field should not be set. If set, it will be ignored." + }, "table": { "$ref": "GooglePrivacyDlpV2BigQueryTable", "description": "Store findings in an existing table or a new table in an existing dataset. If table_id is not set a new one will be generated for you with the following format: dlp_googleapis_yyyy_mm_dd_[dlp_job_id]. Pacific time zone will be used for generating the date details. For Inspect, each column in an existing output table must have the same name, type, and mode of a field in the `Finding` object. For Risk, an existing output table should be the output of a previous Risk analysis job run on the same source table, with the same privacy metric and quasi-identifiers. Risk jobs that analyze the same table but compute a different privacy metric, or use different sets of quasi-identifiers, cannot store their results in the same table." @@ -12298,6 +12306,35 @@ }, "type": "object" }, + "GooglePrivacyDlpV2TagFilter": { + "description": "A single tag to filter against.", + "id": "GooglePrivacyDlpV2TagFilter", + "properties": { + "namespacedTagKey": { + "description": "The namespaced name for the tag key. Must be in the format `{parent_id}/{tag_key_short_name}`, for example, \"123456/sensitive\" for an organization parent, or \"my-project/sensitive\" for a project parent.", + "type": "string" + }, + "namespacedTagValue": { + "description": "The namespaced name for the tag value. Must be in the format `{parent_id}/{tag_key_short_name}/{short_name}`, for example, \"123456/environment/prod\" for an organization parent, or \"my-project/environment/prod\" for a project parent.", + "type": "string" + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2TagFilters": { + "description": "Tags to match against for filtering.", + "id": "GooglePrivacyDlpV2TagFilters", + "properties": { + "tagFilters": { + "description": "Required. A resource must match ALL of the specified tag filters to be included in the collection.", + "items": { + "$ref": "GooglePrivacyDlpV2TagFilter" + }, + "type": "array" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2TagResources": { "description": "If set, attaches the [tags] (https://cloud.google.com/resource-manager/docs/tags/tags-overview) provided to profiled resources. Tags support [access control](https://cloud.google.com/iam/docs/tags-access-control). You can conditionally grant or deny access to a resource based on whether the resource has a specific tag.", "id": "GooglePrivacyDlpV2TagResources", diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 7670c618937..88780f31016 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -5577,6 +5577,15 @@ type GooglePrivacyDlpV2FileStoreCollection struct { // IncludeRegexes: Optional. A collection of regular expressions to match a // file store against. IncludeRegexes *GooglePrivacyDlpV2FileStoreRegexes `json:"includeRegexes,omitempty"` + // IncludeTags: Optional. To be included in the collection, a resource must + // meet all of the following requirements: - If tag filters are provided, match + // all provided tag filters. - If one or more patterns are specified, match at + // least one pattern. For a resource to match the tag filters, the resource + // must have all of the provided tags attached. Tags refer to Resource Manager + // tags bound to the resource or its ancestors. See + // https://cloud.google.com/sensitive-data-protection/docs/profile-project-cloud-storage#manage-schedules + // to learn more. + IncludeTags *GooglePrivacyDlpV2TagFilters `json:"includeTags,omitempty"` // ForceSendFields is a list of field names (e.g. "IncludeRegexes") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -8434,6 +8443,14 @@ type GooglePrivacyDlpV2OutputStorageConfig struct { // BigQuery. // "ALL_COLUMNS" - Schema containing all columns. OutputSchema string `json:"outputSchema,omitempty"` + // StoragePath: Store findings in an existing Cloud Storage bucket. Files will + // be generated with the job ID and file part number as the filename, and will + // contain findings in textproto format as SaveToGcsFindingsOutput. The file + // name will use the naming convention -, for example: my-job-id-2. Supported + // for Inspect jobs. The bucket must not be the same as the bucket being + // inspected. If storing findings to Cloud Storage, the output schema field + // should not be set. If set, it will be ignored. + StoragePath *GooglePrivacyDlpV2CloudStoragePath `json:"storagePath,omitempty"` // Table: Store findings in an existing table or a new table in an existing // dataset. If table_id is not set a new one will be generated for you with the // following format: dlp_googleapis_yyyy_mm_dd_[dlp_job_id]. Pacific time zone @@ -10502,6 +10519,58 @@ func (s GooglePrivacyDlpV2TagCondition) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2TagFilter: A single tag to filter against. +type GooglePrivacyDlpV2TagFilter struct { + // NamespacedTagKey: The namespaced name for the tag key. Must be in the format + // `{parent_id}/{tag_key_short_name}`, for example, "123456/sensitive" for an + // organization parent, or "my-project/sensitive" for a project parent. + NamespacedTagKey string `json:"namespacedTagKey,omitempty"` + // NamespacedTagValue: The namespaced name for the tag value. Must be in the + // format `{parent_id}/{tag_key_short_name}/{short_name}`, for example, + // "123456/environment/prod" for an organization parent, or + // "my-project/environment/prod" for a project parent. + NamespacedTagValue string `json:"namespacedTagValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "NamespacedTagKey") 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. "NamespacedTagKey") 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 GooglePrivacyDlpV2TagFilter) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2TagFilter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2TagFilters: Tags to match against for filtering. +type GooglePrivacyDlpV2TagFilters struct { + // TagFilters: Required. A resource must match ALL of the specified tag filters + // to be included in the collection. + TagFilters []*GooglePrivacyDlpV2TagFilter `json:"tagFilters,omitempty"` + // ForceSendFields is a list of field names (e.g. "TagFilters") 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. "TagFilters") 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 GooglePrivacyDlpV2TagFilters) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2TagFilters + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2TagResources: If set, attaches the [tags] // (https://cloud.google.com/resource-manager/docs/tags/tags-overview) provided // to profiled resources. Tags support access control diff --git a/docs/v1/docs-api.json b/docs/v1/docs-api.json index 108cfc8ba6d..3476c43b89e 100644 --- a/docs/v1/docs-api.json +++ b/docs/v1/docs-api.json @@ -221,7 +221,7 @@ } } }, - "revision": "20250325", + "revision": "20250917", "rootUrl": "https://docs.googleapis.com/", "schemas": { "AutoText": { @@ -2756,13 +2756,11 @@ "id": "PersonProperties", "properties": { "email": { - "description": "Output only. The email address linked to this Person. This field is always present.", - "readOnly": true, + "description": "The email address linked to this Person. This field is always present.", "type": "string" }, "name": { - "description": "Output only. The name of the person if it's displayed in the link text instead of the person's email address.", - "readOnly": true, + "description": "The name of the person if it's displayed in the link text instead of the person's email address.", "type": "string" } }, diff --git a/docs/v1/docs-gen.go b/docs/v1/docs-gen.go index 769227041dd..d9b795e2cc2 100644 --- a/docs/v1/docs-gen.go +++ b/docs/v1/docs-gen.go @@ -3525,11 +3525,11 @@ func (s Person) MarshalJSON() ([]byte, error) { // PersonProperties: Properties specific to a linked Person. type PersonProperties struct { - // Email: Output only. The email address linked to this Person. This field is - // always present. + // Email: The email address linked to this Person. This field is always + // present. Email string `json:"email,omitempty"` - // Name: Output only. The name of the person if it's displayed in the link text - // instead of the person's email address. + // Name: The name of the person if it's displayed in the link text instead of + // the person's email address. Name string `json:"name,omitempty"` // ForceSendFields is a list of field names (e.g. "Email") to unconditionally // include in API requests. By default, fields with empty or default values are diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index e45a050d4f0..32932ccaff8 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1048,7 +1048,7 @@ } } }, - "revision": "20250908", + "revision": "20250914", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput": { @@ -4754,6 +4754,10 @@ "description": "The first-class citizen for Document AI. Each processor defines how to extract structural information from a document.", "id": "GoogleCloudDocumentaiV1Processor", "properties": { + "activeSchemaVersion": { + "description": "Optional. SchemaVersion used by the Processor. It is the same as Processor's DatasetSchema.schema_version Format is `projects/{project}/locations/{location}/schemas/{schema}/schemaVersions/{schema_version}", + "type": "string" + }, "createTime": { "description": "Output only. The time the processor was created.", "format": "google-datetime", @@ -5308,7 +5312,7 @@ "id": "GoogleCloudDocumentaiV1TrainProcessorVersionRequestCustomDocumentExtractionOptions", "properties": { "trainingMethod": { - "description": "Training method to use for CDE training.", + "description": "Optional. Training method to use for CDE training.", "enum": [ "TRAINING_METHOD_UNSPECIFIED", "MODEL_BASED", diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index f107f4a9d0d..4f7d6f6e5c7 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -5170,6 +5170,11 @@ func (s GoogleCloudDocumentaiV1ProcessResponse) MarshalJSON() ([]byte, error) { // Each processor defines how to extract structural information from a // document. type GoogleCloudDocumentaiV1Processor struct { + // ActiveSchemaVersion: Optional. SchemaVersion used by the Processor. It is + // the same as Processor's DatasetSchema.schema_version Format is + // `projects/{project}/locations/{location}/schemas/{schema}/schemaVersions/{sch + // ema_version} + ActiveSchemaVersion string `json:"activeSchemaVersion,omitempty"` // CreateTime: Output only. The time the processor was created. CreateTime string `json:"createTime,omitempty"` // DefaultProcessorVersion: The default processor version. @@ -5219,15 +5224,15 @@ type GoogleCloudDocumentaiV1Processor struct { // 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 + // ForceSendFields is a list of field names (e.g. "ActiveSchemaVersion") 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 + // NullFields is a list of field names (e.g. "ActiveSchemaVersion") 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:"-"` } @@ -5840,7 +5845,7 @@ func (s GoogleCloudDocumentaiV1TrainProcessorVersionRequest) MarshalJSON() ([]by // tions: Options to control the training of the Custom Document Extraction // (CDE) Processor. type GoogleCloudDocumentaiV1TrainProcessorVersionRequestCustomDocumentExtractionOptions struct { - // TrainingMethod: Training method to use for CDE training. + // TrainingMethod: Optional. Training method to use for CDE training. // // Possible values: // "TRAINING_METHOD_UNSPECIFIED" diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index f634034fe30..1fe817f24c6 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1290,7 +1290,7 @@ } } }, - "revision": "20250908", + "revision": "20250914", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "CloudAiDocumentaiLabHifiaToolsValidationValidatorInput": { @@ -3767,6 +3767,10 @@ "description": "Represents a text type block.", "id": "GoogleCloudDocumentaiV1beta3DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock", "properties": { + "annotations": { + "$ref": "GoogleCloudDocumentaiV1beta3DocumentAnnotations", + "description": "Annotation of the text block." + }, "blocks": { "description": "A text block could further have child blocks. Repeated blocks support further hierarchies and nested blocks.", "items": { @@ -5753,7 +5757,7 @@ "description": "The source processor version to import from. It can be from a different environment and region than the destination processor." }, "processorVersionSource": { - "description": "The source processor version to import from. The source processor version and destination processor need to be in the same environment and region. Note that ProcessorVersions with `model_type` `MODEL_TYPE_LLM` are not supported.", + "description": "The source processor version to import from. The source processor version and destination processor need to be in the same environment and region.", "type": "string" } }, @@ -6180,6 +6184,10 @@ "description": "The first-class citizen for Document AI. Each processor defines how to extract structural information from a document.", "id": "GoogleCloudDocumentaiV1beta3Processor", "properties": { + "activeSchemaVersion": { + "description": "Optional. SchemaVersion used by the Processor. It is the same as Processor's DatasetSchema.schema_version Format is `projects/{project}/locations/{location}/schemas/{schema}/schemaVersions/{schema_version}", + "type": "string" + }, "createTime": { "description": "Output only. The time the processor was created.", "format": "google-datetime", @@ -6856,7 +6864,7 @@ "id": "GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestCustomDocumentExtractionOptions", "properties": { "trainingMethod": { - "description": "Training method to use for CDE training.", + "description": "Optional. Training method to use for CDE training.", "enum": [ "TRAINING_METHOD_UNSPECIFIED", "MODEL_BASED", diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 1f68cb205ac..0485e2e6d12 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -3604,6 +3604,8 @@ func (s GoogleCloudDocumentaiV1beta3DocumentDocumentLayoutDocumentLayoutBlockLay // GoogleCloudDocumentaiV1beta3DocumentDocumentLayoutDocumentLayoutBlockLayoutTe // xtBlock: Represents a text type block. type GoogleCloudDocumentaiV1beta3DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock struct { + // Annotations: Annotation of the text block. + Annotations *GoogleCloudDocumentaiV1beta3DocumentAnnotations `json:"annotations,omitempty"` // Blocks: A text block could further have child blocks. Repeated blocks // support further hierarchies and nested blocks. Blocks []*GoogleCloudDocumentaiV1beta3DocumentDocumentLayoutDocumentLayoutBlock `json:"blocks,omitempty"` @@ -3613,13 +3615,13 @@ type GoogleCloudDocumentaiV1beta3DocumentDocumentLayoutDocumentLayoutBlockLayout // `subtitle`, `heading-1`, `heading-2`, `heading-3`, `heading-4`, `heading-5`, // `header`, `footer`. Type string `json:"type,omitempty"` - // ForceSendFields is a list of field names (e.g. "Blocks") 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. "Annotations") 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. "Blocks") to include in API + // NullFields is a list of field names (e.g. "Annotations") 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. @@ -6197,8 +6199,7 @@ type GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequest struct { ExternalProcessorVersionSource *GoogleCloudDocumentaiV1beta3ImportProcessorVersionRequestExternalProcessorVersionSource `json:"externalProcessorVersionSource,omitempty"` // ProcessorVersionSource: The source processor version to import from. The // source processor version and destination processor need to be in the same - // environment and region. Note that ProcessorVersions with `model_type` - // `MODEL_TYPE_LLM` are not supported. + // environment and region. ProcessorVersionSource string `json:"processorVersionSource,omitempty"` // ForceSendFields is a list of field names (e.g. // "ExternalProcessorVersionSource") to unconditionally include in API @@ -6829,6 +6830,11 @@ func (s GoogleCloudDocumentaiV1beta3ProcessResponse) MarshalJSON() ([]byte, erro // AI. Each processor defines how to extract structural information from a // document. type GoogleCloudDocumentaiV1beta3Processor struct { + // ActiveSchemaVersion: Optional. SchemaVersion used by the Processor. It is + // the same as Processor's DatasetSchema.schema_version Format is + // `projects/{project}/locations/{location}/schemas/{schema}/schemaVersions/{sch + // ema_version} + ActiveSchemaVersion string `json:"activeSchemaVersion,omitempty"` // CreateTime: Output only. The time the processor was created. CreateTime string `json:"createTime,omitempty"` // DefaultProcessorVersion: The default processor version. @@ -6878,15 +6884,15 @@ type GoogleCloudDocumentaiV1beta3Processor struct { // 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 + // ForceSendFields is a list of field names (e.g. "ActiveSchemaVersion") 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 + // NullFields is a list of field names (e.g. "ActiveSchemaVersion") 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:"-"` } @@ -7615,7 +7621,7 @@ func (s GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequest) MarshalJSON() // ionOptions: Options to control the training of the Custom Document // Extraction (CDE) Processor. type GoogleCloudDocumentaiV1beta3TrainProcessorVersionRequestCustomDocumentExtractionOptions struct { - // TrainingMethod: Training method to use for CDE training. + // TrainingMethod: Optional. Training method to use for CDE training. // // Possible values: // "TRAINING_METHOD_UNSPECIFIED" diff --git a/domains/v1/domains-api.json b/domains/v1/domains-api.json index 2b5ca206d53..9a47db4af56 100644 --- a/domains/v1/domains-api.json +++ b/domains/v1/domains-api.json @@ -143,6 +143,12 @@ "name" ], "parameters": { + "extraLocationTypes": { + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", + "location": "query", + "repeated": true, + "type": "string" + }, "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", @@ -965,7 +971,7 @@ } } }, - "revision": "20250225", + "revision": "20250918", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1939,18 +1945,18 @@ "type": "object" }, "PostalAddress": { - "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", + "description": "Represents a postal address, such as for postal delivery or payments addresses. With a postal address, a postal service can deliver items to a premise, P.O. box, or similar. A postal address is not intended to model geographical locations like roads, towns, or 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 or editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput. - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478.", "id": "PostalAddress", "properties": { "addressLines": { - "description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (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).", + "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 or 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). In 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.", + "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. 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": { @@ -1958,7 +1964,7 @@ "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.", + "description": "Optional. Generally refers to the city or 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": { @@ -1966,7 +1972,7 @@ "type": "string" }, "postalCode": { - "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (For example state/zip validation in the U.S.A.).", + "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (for example, state or zip code validation in the United States).", "type": "string" }, "recipients": { @@ -1986,11 +1992,11 @@ "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).", + "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\" (Côte d'Ivoire).", "type": "string" }, "sublocality": { - "description": "Optional. Sublocality of the address. For example, this can be neighborhoods, boroughs, districts.", + "description": "Optional. Sublocality of the address. For example, this can be a neighborhood, borough, or district.", "type": "string" } }, @@ -2220,14 +2226,16 @@ "CONTACT_SUPPORT", "UNVERIFIED_EMAIL", "PROBLEM_WITH_BILLING", - "DNS_NOT_ACTIVATED" + "DNS_NOT_ACTIVATED", + "AUTO_RENEWAL_UPDATE_NOT_EFFECTIVE" ], "enumDescriptions": [ "The issue is undefined.", "Contact the Cloud Support team to resolve a problem with this domain.", "[ICANN](https://icann.org/) requires verification of the email address in the `Registration`'s `contact_settings.registrant_contact` field. To verify the email address, follow the instructions in the email the `registrant_contact` receives following registration. If you do not complete email verification within 15 days of registration, the domain is suspended. To resend the verification email, call ConfigureContactSettings and provide the current `registrant_contact.email`.", "The billing account is not in good standing. The domain is not automatically renewed at its expiration time unless you resolve problems with your billing account.", - "The registry failed to validate your DNS configuration and activate your domain. The failure might happen for the following reasons: * You recently registered the domain (wait up to 72 hours). * You provided invalid name servers or name servers that correspond to a newly created DNS zone. Verify your DNS configuration. If the configuration is incorrect, you must fix it. If the configuration is correct, either wait or call the ConfigureDnsSettings method to retry the registry validation." + "The registry failed to validate your DNS configuration and activate your domain. The failure might happen for the following reasons: * You recently registered the domain (wait up to 72 hours). * You provided invalid name servers or name servers that correspond to a newly created DNS zone. Verify your DNS configuration. If the configuration is incorrect, you must fix it. If the configuration is correct, either wait or call the ConfigureDnsSettings method to retry the registry validation.", + "Due to SquareSpace's constraints, the auto-renewal update you made may not be effective during a certain period of time. Generally, the time period is 15 days before expiration for generic TLD domains, and 15 days before expiration + 3 days after expiration for country-code TLD domains." ], "type": "string" }, diff --git a/domains/v1/domains-gen.go b/domains/v1/domains-gen.go index 7d89cf2717f..cf59fa48000 100644 --- a/domains/v1/domains-gen.go +++ b/domains/v1/domains-gen.go @@ -1585,43 +1585,43 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PostalAddress: Represents a postal address. For example for postal delivery -// or payments addresses. Given a postal address, a postal service can deliver -// items to a premise, P.O. Box or similar. It is not intended to model -// geographical locations (roads, towns, mountains). In typical usage an -// address would be created 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 +// PostalAddress: Represents a postal address, such as for postal delivery or +// payments addresses. With a postal address, a postal service can deliver +// items to a premise, P.O. box, or similar. A postal address is not intended +// to model geographical locations like roads, towns, or 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 or 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 +// https://support.google.com/business/answer/6397478. type PostalAddress struct { // AddressLines: Unstructured address lines describing the lower levels of an - // address. Because values in address_lines do not have type information and - // may sometimes contain multiple values in a single field (For example + // 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 + // address lines should be "envelope order" for the country or 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). In 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. + // state, a province, an oblast, or a prefecture. 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 @@ -1632,17 +1632,17 @@ type PostalAddress struct { // 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 + // Locality: Optional. Generally refers to the city or 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. + // 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.). + // trigger additional validation with other parts of the address (for example, + // state or zip code validation in the United States). 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 @@ -1660,13 +1660,12 @@ type PostalAddress struct { Revision int64 `json:"revision,omitempty"` // SortingCode: Optional. Additional, country-specific, sorting code. This is // not used in most regions. Where it is used, the value is either a string - // like "CEDEX", optionally followed by a number (For example "CEDEX 7"), or + // 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). + // area indicator" (Malawi) or "post office indicator" (Côte d'Ivoire). SortingCode string `json:"sortingCode,omitempty"` // Sublocality: Optional. Sublocality of the address. For example, this can be - // neighborhoods, boroughs, districts. + // a neighborhood, borough, or district. 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 @@ -1971,6 +1970,11 @@ type Registration struct { // configuration is incorrect, you must fix it. If the configuration is // correct, either wait or call the ConfigureDnsSettings method to retry the // registry validation. + // "AUTO_RENEWAL_UPDATE_NOT_EFFECTIVE" - Due to SquareSpace's constraints, + // the auto-renewal update you made may not be effective during a certain + // period of time. Generally, the time period is 15 days before expiration for + // generic TLD domains, and 15 days before expiration + 3 days after expiration + // for country-code TLD domains. Issues []string `json:"issues,omitempty"` // Labels: Set of labels associated with the `Registration`. Labels map[string]string `json:"labels,omitempty"` @@ -2781,6 +2785,14 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. +func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { + c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) + 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 diff --git a/domains/v1alpha2/domains-api.json b/domains/v1alpha2/domains-api.json index 21a350b7401..b5ce4a74fb6 100644 --- a/domains/v1alpha2/domains-api.json +++ b/domains/v1alpha2/domains-api.json @@ -143,6 +143,12 @@ "name" ], "parameters": { + "extraLocationTypes": { + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", + "location": "query", + "repeated": true, + "type": "string" + }, "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", @@ -965,7 +971,7 @@ } } }, - "revision": "20250225", + "revision": "20250918", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1939,18 +1945,18 @@ "type": "object" }, "PostalAddress": { - "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", + "description": "Represents a postal address, such as for postal delivery or payments addresses. With a postal address, a postal service can deliver items to a premise, P.O. box, or similar. A postal address is not intended to model geographical locations like roads, towns, or 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 or editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput. - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478.", "id": "PostalAddress", "properties": { "addressLines": { - "description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (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).", + "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 or 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). In 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.", + "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. 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": { @@ -1958,7 +1964,7 @@ "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.", + "description": "Optional. Generally refers to the city or 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": { @@ -1966,7 +1972,7 @@ "type": "string" }, "postalCode": { - "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (For example state/zip validation in the U.S.A.).", + "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (for example, state or zip code validation in the United States).", "type": "string" }, "recipients": { @@ -1986,11 +1992,11 @@ "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).", + "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\" (Côte d'Ivoire).", "type": "string" }, "sublocality": { - "description": "Optional. Sublocality of the address. For example, this can be neighborhoods, boroughs, districts.", + "description": "Optional. Sublocality of the address. For example, this can be a neighborhood, borough, or district.", "type": "string" } }, @@ -2220,14 +2226,16 @@ "CONTACT_SUPPORT", "UNVERIFIED_EMAIL", "PROBLEM_WITH_BILLING", - "DNS_NOT_ACTIVATED" + "DNS_NOT_ACTIVATED", + "AUTO_RENEWAL_UPDATE_NOT_EFFECTIVE" ], "enumDescriptions": [ "The issue is undefined.", "Contact the Cloud Support team to resolve a problem with this domain.", "[ICANN](https://icann.org/) requires verification of the email address in the `Registration`'s `contact_settings.registrant_contact` field. To verify the email address, follow the instructions in the email the `registrant_contact` receives following registration. If you do not complete email verification within 15 days of registration, the domain is suspended. To resend the verification email, call ConfigureContactSettings and provide the current `registrant_contact.email`.", "The billing account is not in good standing. The domain is not automatically renewed at its expiration time unless you resolve problems with your billing account.", - "The registry failed to validate your DNS configuration and activate your domain. The failure might happen for the following reasons: * You recently registered the domain (wait up to 72 hours). * You provided invalid name servers or name servers that correspond to a newly created DNS zone. Verify your DNS configuration. If the configuration is incorrect, you must fix it. If the configuration is correct, either wait or call the ConfigureDnsSettings method to retry the registry validation." + "The registry failed to validate your DNS configuration and activate your domain. The failure might happen for the following reasons: * You recently registered the domain (wait up to 72 hours). * You provided invalid name servers or name servers that correspond to a newly created DNS zone. Verify your DNS configuration. If the configuration is incorrect, you must fix it. If the configuration is correct, either wait or call the ConfigureDnsSettings method to retry the registry validation.", + "Due to SquareSpace's constraints, the auto-renewal update you made may not be effective during a certain period of time. Generally, the time period is 15 days before expiration for generic TLD domains, and 15 days before expiration + 3 days after expiration for country-code TLD domains." ], "type": "string" }, diff --git a/domains/v1alpha2/domains-gen.go b/domains/v1alpha2/domains-gen.go index 4e0845cf595..15949f8998d 100644 --- a/domains/v1alpha2/domains-gen.go +++ b/domains/v1alpha2/domains-gen.go @@ -1585,43 +1585,43 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PostalAddress: Represents a postal address. For example for postal delivery -// or payments addresses. Given a postal address, a postal service can deliver -// items to a premise, P.O. Box or similar. It is not intended to model -// geographical locations (roads, towns, mountains). In typical usage an -// address would be created 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 +// PostalAddress: Represents a postal address, such as for postal delivery or +// payments addresses. With a postal address, a postal service can deliver +// items to a premise, P.O. box, or similar. A postal address is not intended +// to model geographical locations like roads, towns, or 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 or 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 +// https://support.google.com/business/answer/6397478. type PostalAddress struct { // AddressLines: Unstructured address lines describing the lower levels of an - // address. Because values in address_lines do not have type information and - // may sometimes contain multiple values in a single field (For example + // 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 + // address lines should be "envelope order" for the country or 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). In 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. + // state, a province, an oblast, or a prefecture. 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 @@ -1632,17 +1632,17 @@ type PostalAddress struct { // 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 + // Locality: Optional. Generally refers to the city or 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. + // 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.). + // trigger additional validation with other parts of the address (for example, + // state or zip code validation in the United States). 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 @@ -1660,13 +1660,12 @@ type PostalAddress struct { Revision int64 `json:"revision,omitempty"` // SortingCode: Optional. Additional, country-specific, sorting code. This is // not used in most regions. Where it is used, the value is either a string - // like "CEDEX", optionally followed by a number (For example "CEDEX 7"), or + // 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). + // area indicator" (Malawi) or "post office indicator" (Côte d'Ivoire). SortingCode string `json:"sortingCode,omitempty"` // Sublocality: Optional. Sublocality of the address. For example, this can be - // neighborhoods, boroughs, districts. + // a neighborhood, borough, or district. 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 @@ -1971,6 +1970,11 @@ type Registration struct { // configuration is incorrect, you must fix it. If the configuration is // correct, either wait or call the ConfigureDnsSettings method to retry the // registry validation. + // "AUTO_RENEWAL_UPDATE_NOT_EFFECTIVE" - Due to SquareSpace's constraints, + // the auto-renewal update you made may not be effective during a certain + // period of time. Generally, the time period is 15 days before expiration for + // generic TLD domains, and 15 days before expiration + 3 days after expiration + // for country-code TLD domains. Issues []string `json:"issues,omitempty"` // Labels: Set of labels associated with the `Registration`. Labels map[string]string `json:"labels,omitempty"` @@ -2788,6 +2792,14 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. +func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { + c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) + 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 diff --git a/domains/v1beta1/domains-api.json b/domains/v1beta1/domains-api.json index 779f12c53d6..6c6237117b0 100644 --- a/domains/v1beta1/domains-api.json +++ b/domains/v1beta1/domains-api.json @@ -143,6 +143,12 @@ "name" ], "parameters": { + "extraLocationTypes": { + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", + "location": "query", + "repeated": true, + "type": "string" + }, "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", @@ -965,7 +971,7 @@ } } }, - "revision": "20250225", + "revision": "20250918", "rootUrl": "https://domains.googleapis.com/", "schemas": { "AuditConfig": { @@ -1939,18 +1945,18 @@ "type": "object" }, "PostalAddress": { - "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", + "description": "Represents a postal address, such as for postal delivery or payments addresses. With a postal address, a postal service can deliver items to a premise, P.O. box, or similar. A postal address is not intended to model geographical locations like roads, towns, or 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 or editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput. - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478.", "id": "PostalAddress", "properties": { "addressLines": { - "description": "Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (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).", + "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 or 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). In 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.", + "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. 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": { @@ -1958,7 +1964,7 @@ "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.", + "description": "Optional. Generally refers to the city or 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": { @@ -1966,7 +1972,7 @@ "type": "string" }, "postalCode": { - "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (For example state/zip validation in the U.S.A.).", + "description": "Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (for example, state or zip code validation in the United States).", "type": "string" }, "recipients": { @@ -1986,11 +1992,11 @@ "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).", + "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\" (Côte d'Ivoire).", "type": "string" }, "sublocality": { - "description": "Optional. Sublocality of the address. For example, this can be neighborhoods, boroughs, districts.", + "description": "Optional. Sublocality of the address. For example, this can be a neighborhood, borough, or district.", "type": "string" } }, @@ -2220,14 +2226,16 @@ "CONTACT_SUPPORT", "UNVERIFIED_EMAIL", "PROBLEM_WITH_BILLING", - "DNS_NOT_ACTIVATED" + "DNS_NOT_ACTIVATED", + "AUTO_RENEWAL_UPDATE_NOT_EFFECTIVE" ], "enumDescriptions": [ "The issue is undefined.", "Contact the Cloud Support team to resolve a problem with this domain.", "[ICANN](https://icann.org/) requires verification of the email address in the `Registration`'s `contact_settings.registrant_contact` field. To verify the email address, follow the instructions in the email the `registrant_contact` receives following registration. If you do not complete email verification within 15 days of registration, the domain is suspended. To resend the verification email, call ConfigureContactSettings and provide the current `registrant_contact.email`.", "The billing account is not in good standing. The domain is not automatically renewed at its expiration time unless you resolve problems with your billing account.", - "The registry failed to validate your DNS configuration and activate your domain. The failure might happen for the following reasons: * You recently registered the domain (wait up to 72 hours). * You provided invalid name servers or name servers that correspond to a newly created DNS zone. Verify your DNS configuration. If the configuration is incorrect, you must fix it. If the configuration is correct, either wait or call the ConfigureDnsSettings method to retry the registry validation." + "The registry failed to validate your DNS configuration and activate your domain. The failure might happen for the following reasons: * You recently registered the domain (wait up to 72 hours). * You provided invalid name servers or name servers that correspond to a newly created DNS zone. Verify your DNS configuration. If the configuration is incorrect, you must fix it. If the configuration is correct, either wait or call the ConfigureDnsSettings method to retry the registry validation.", + "Due to SquareSpace's constraints, the auto-renewal update you made may not be effective during a certain period of time. Generally, the time period is 15 days before expiration for generic TLD domains, and 15 days before expiration + 3 days after expiration for country-code TLD domains." ], "type": "string" }, diff --git a/domains/v1beta1/domains-gen.go b/domains/v1beta1/domains-gen.go index 62834e83299..31cc5a76caf 100644 --- a/domains/v1beta1/domains-gen.go +++ b/domains/v1beta1/domains-gen.go @@ -1585,43 +1585,43 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// PostalAddress: Represents a postal address. For example for postal delivery -// or payments addresses. Given a postal address, a postal service can deliver -// items to a premise, P.O. Box or similar. It is not intended to model -// geographical locations (roads, towns, mountains). In typical usage an -// address would be created 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 +// PostalAddress: Represents a postal address, such as for postal delivery or +// payments addresses. With a postal address, a postal service can deliver +// items to a premise, P.O. box, or similar. A postal address is not intended +// to model geographical locations like roads, towns, or 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 or 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 +// https://support.google.com/business/answer/6397478. type PostalAddress struct { // AddressLines: Unstructured address lines describing the lower levels of an - // address. Because values in address_lines do not have type information and - // may sometimes contain multiple values in a single field (For example + // 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 + // address lines should be "envelope order" for the country or 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). In 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. + // state, a province, an oblast, or a prefecture. 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 @@ -1632,17 +1632,17 @@ type PostalAddress struct { // 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 + // Locality: Optional. Generally refers to the city or 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. + // 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.). + // trigger additional validation with other parts of the address (for example, + // state or zip code validation in the United States). 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 @@ -1660,13 +1660,12 @@ type PostalAddress struct { Revision int64 `json:"revision,omitempty"` // SortingCode: Optional. Additional, country-specific, sorting code. This is // not used in most regions. Where it is used, the value is either a string - // like "CEDEX", optionally followed by a number (For example "CEDEX 7"), or + // 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). + // area indicator" (Malawi) or "post office indicator" (Côte d'Ivoire). SortingCode string `json:"sortingCode,omitempty"` // Sublocality: Optional. Sublocality of the address. For example, this can be - // neighborhoods, boroughs, districts. + // a neighborhood, borough, or district. 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 @@ -1971,6 +1970,11 @@ type Registration struct { // configuration is incorrect, you must fix it. If the configuration is // correct, either wait or call the ConfigureDnsSettings method to retry the // registry validation. + // "AUTO_RENEWAL_UPDATE_NOT_EFFECTIVE" - Due to SquareSpace's constraints, + // the auto-renewal update you made may not be effective during a certain + // period of time. Generally, the time period is 15 days before expiration for + // generic TLD domains, and 15 days before expiration + 3 days after expiration + // for country-code TLD domains. Issues []string `json:"issues,omitempty"` // Labels: Set of labels associated with the `Registration`. Labels map[string]string `json:"labels,omitempty"` @@ -2781,6 +2785,14 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. +func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { + c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) + 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 diff --git a/drive/v3/drive-api.json b/drive/v3/drive-api.json index 2ec55c2fdb0..ea8e305c8fa 100644 --- a/drive/v3/drive-api.json +++ b/drive/v3/drive-api.json @@ -158,7 +158,7 @@ "accessproposals": { "methods": { "get": { - "description": "Retrieves an AccessProposal by ID.", + "description": "Retrieves an access proposal by ID. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access).", "flatPath": "files/{fileId}/accessproposals/{proposalId}", "httpMethod": "GET", "id": "drive.accessproposals.get", @@ -168,13 +168,13 @@ ], "parameters": { "fileId": { - "description": "Required. The id of the item the request is on.", + "description": "Required. The ID of the item the request is on.", "location": "path", "required": true, "type": "string" }, "proposalId": { - "description": "Required. The id of the access proposal to resolve.", + "description": "Required. The ID of the access proposal to resolve.", "location": "path", "required": true, "type": "string" @@ -193,7 +193,7 @@ ] }, "list": { - "description": "List the AccessProposals on a file. Note: Only approvers are able to list AccessProposals on a file. If the user is not an approver, returns a 403.", + "description": "List the access proposals on a file. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access). Note: Only approvers are able to list access proposals on a file. If the user isn't an approver, a 403 error is returned.", "flatPath": "files/{fileId}/accessproposals", "httpMethod": "GET", "id": "drive.accessproposals.list", @@ -202,13 +202,13 @@ ], "parameters": { "fileId": { - "description": "Required. The id of the item the request is on.", + "description": "Required. The ID of the item the request is on.", "location": "path", "required": true, "type": "string" }, "pageSize": { - "description": "Optional. The number of results per page", + "description": "Optional. The number of results per page.", "format": "int32", "location": "query", "type": "integer" @@ -232,7 +232,7 @@ ] }, "resolve": { - "description": "Used to approve or deny an Access Proposal.", + "description": "Approves or denies an access proposal. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access).", "flatPath": "files/{fileId}/accessproposals/{proposalId}:resolve", "httpMethod": "POST", "id": "drive.accessproposals.resolve", @@ -242,13 +242,13 @@ ], "parameters": { "fileId": { - "description": "Required. The id of the item the request is on.", + "description": "Required. The ID of the item the request is on.", "location": "path", "required": true, "type": "string" }, "proposalId": { - "description": "Required. The id of the access proposal to resolve.", + "description": "Required. The ID of the access proposal to resolve.", "location": "path", "required": true, "type": "string" @@ -2720,7 +2720,7 @@ } } }, - "revision": "20250829", + "revision": "20250910", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -2865,36 +2865,36 @@ "type": "object" }, "AccessProposal": { - "description": "The Access Proposal resource for outstanding access proposals on a file", + "description": "Manage outstanding access proposals on a file.", "id": "AccessProposal", "properties": { "createTime": { - "description": "The creation time", + "description": "The creation time.", "format": "google-datetime", "type": "string" }, "fileId": { - "description": "The file id that the proposal for access is on", + "description": "The file ID that the proposal for access is on.", "type": "string" }, "proposalId": { - "description": "The id of the access proposal", + "description": "The ID of the access proposal.", "type": "string" }, "recipientEmailAddress": { - "description": "The email address of the user that will receive permissions if accepted", + "description": "The email address of the user that will receive permissions, if accepted.", "type": "string" }, "requestMessage": { - "description": "The message that the requester added to the proposal", + "description": "The message that the requester added to the proposal.", "type": "string" }, "requesterEmailAddress": { - "description": "The email address of the requesting user", + "description": "The email address of the requesting user.", "type": "string" }, "rolesAndViews": { - "description": "A wrapper for the role and view of an access proposal.", + "description": "A wrapper for the role and view of an access proposal. For more information, see [Roles and permissions](https://developers.google.com/workspace/drive/api/guides/ref-roles).", "items": { "$ref": "AccessProposalRoleAndView" }, @@ -2904,15 +2904,15 @@ "type": "object" }, "AccessProposalRoleAndView": { - "description": "A wrapper for the role and view of an access proposal.", + "description": "A wrapper for the role and view of an access proposal. For more information, see [Roles and permissions](https://developers.google.com/workspace/drive/api/guides/ref-roles).", "id": "AccessProposalRoleAndView", "properties": { "role": { - "description": "The role that was proposed by the requester New values may be added in the future, but the following are currently possible: * `writer` * `commenter` * `reader`", + "description": "The role that was proposed by the requester. The supported values are: * `writer` * `commenter` * `reader`", "type": "string" }, "view": { - "description": "Indicates the view for this access proposal. Only populated for proposals that belong to a view. `published` is the only supported value.", + "description": "Indicates the view for this access proposal. Only populated for proposals that belong to a view. Only `published` is supported.", "type": "string" } }, @@ -4517,11 +4517,11 @@ "type": "object" }, "ListAccessProposalsResponse": { - "description": "The response to an Access Proposal list request.", + "description": "The response to an access proposal list request.", "id": "ListAccessProposalsResponse", "properties": { "accessProposals": { - "description": "The list of Access Proposals. This field is only populated in v3 and v3beta.", + "description": "The list of access proposals. This field is only populated in Drive API v3.", "items": { "$ref": "AccessProposal" }, @@ -4839,7 +4839,7 @@ "id": "ResolveAccessProposalRequest", "properties": { "action": { - "description": "Required. The action to take on the AccessProposal.", + "description": "Required. The action to take on the access proposal.", "enum": [ "ACTION_UNSPECIFIED", "ACCEPT", @@ -4847,24 +4847,24 @@ ], "enumDescriptions": [ "Unspecified action", - "The user accepts the proposal. Note: If this action is used, the `role` field must have at least one value.", - "The user denies the proposal" + "The user accepts the access proposal. Note: If this action is used, the `role` field must have at least one value.", + "The user denies the access proposal." ], "type": "string" }, "role": { - "description": "Optional. The roles the approver has allowed, if any. Note: This field is required for the `ACCEPT` action.", + "description": "Optional. The roles that the approver has allowed, if any. For more information, see [Roles and permissions](https://developers.google.com/workspace/drive/api/guides/ref-roles). Note: This field is required for the `ACCEPT` action.", "items": { "type": "string" }, "type": "array" }, "sendNotification": { - "description": "Optional. Whether to send an email to the requester when the AccessProposal is denied or accepted.", + "description": "Optional. Whether to send an email to the requester when the access proposal is denied or accepted.", "type": "boolean" }, "view": { - "description": "Optional. Indicates the view for this access proposal. This should only be set when the proposal belongs to a view. `published` is the only supported value.", + "description": "Optional. Indicates the view for this access proposal. This should only be set when the proposal belongs to a view. Only `published` is supported.", "type": "string" } }, diff --git a/drive/v3/drive-gen.go b/drive/v3/drive-gen.go index 44a25990551..d1b790b03bb 100644 --- a/drive/v3/drive-gen.go +++ b/drive/v3/drive-gen.go @@ -493,23 +493,24 @@ func (s AboutTeamDriveThemes) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// AccessProposal: The Access Proposal resource for outstanding access -// proposals on a file +// AccessProposal: Manage outstanding access proposals on a file. type AccessProposal struct { - // CreateTime: The creation time + // CreateTime: The creation time. CreateTime string `json:"createTime,omitempty"` - // FileId: The file id that the proposal for access is on + // FileId: The file ID that the proposal for access is on. FileId string `json:"fileId,omitempty"` - // ProposalId: The id of the access proposal + // ProposalId: The ID of the access proposal. ProposalId string `json:"proposalId,omitempty"` // RecipientEmailAddress: The email address of the user that will receive - // permissions if accepted + // permissions, if accepted. RecipientEmailAddress string `json:"recipientEmailAddress,omitempty"` - // RequestMessage: The message that the requester added to the proposal + // RequestMessage: The message that the requester added to the proposal. RequestMessage string `json:"requestMessage,omitempty"` - // RequesterEmailAddress: The email address of the requesting user + // RequesterEmailAddress: The email address of the requesting user. RequesterEmailAddress string `json:"requesterEmailAddress,omitempty"` - // RolesAndViews: A wrapper for the role and view of an access proposal. + // RolesAndViews: A wrapper for the role and view of an access proposal. For + // more information, see Roles and permissions + // (https://developers.google.com/workspace/drive/api/guides/ref-roles). RolesAndViews []*AccessProposalRoleAndView `json:"rolesAndViews,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -533,14 +534,14 @@ func (s AccessProposal) MarshalJSON() ([]byte, error) { } // AccessProposalRoleAndView: A wrapper for the role and view of an access -// proposal. +// proposal. For more information, see Roles and permissions +// (https://developers.google.com/workspace/drive/api/guides/ref-roles). type AccessProposalRoleAndView struct { - // Role: The role that was proposed by the requester New values may be added in - // the future, but the following are currently possible: * `writer` * - // `commenter` * `reader` + // Role: The role that was proposed by the requester. The supported values are: + // * `writer` * `commenter` * `reader` Role string `json:"role,omitempty"` // View: Indicates the view for this access proposal. Only populated for - // proposals that belong to a view. `published` is the only supported value. + // proposals that belong to a view. Only `published` is supported. View string `json:"view,omitempty"` // ForceSendFields is a list of field names (e.g. "Role") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -2319,11 +2320,11 @@ func (s LabelModification) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListAccessProposalsResponse: The response to an Access Proposal list +// ListAccessProposalsResponse: The response to an access proposal list // request. type ListAccessProposalsResponse struct { - // AccessProposals: The list of Access Proposals. This field is only populated - // in v3 and v3beta. + // AccessProposals: The list of access proposals. This field is only populated + // in Drive API v3. AccessProposals []*AccessProposal `json:"accessProposals,omitempty"` // NextPageToken: The continuation token for the next page of results. This // will be absent if the end of the results list has been reached. If the token @@ -2735,23 +2736,25 @@ func (s ReplyList) MarshalJSON() ([]byte, error) { // ResolveAccessProposalRequest: Request message for resolving an // AccessProposal on a file. type ResolveAccessProposalRequest struct { - // Action: Required. The action to take on the AccessProposal. + // Action: Required. The action to take on the access proposal. // // Possible values: // "ACTION_UNSPECIFIED" - Unspecified action - // "ACCEPT" - The user accepts the proposal. Note: If this action is used, - // the `role` field must have at least one value. - // "DENY" - The user denies the proposal + // "ACCEPT" - The user accepts the access proposal. Note: If this action is + // used, the `role` field must have at least one value. + // "DENY" - The user denies the access proposal. Action string `json:"action,omitempty"` - // Role: Optional. The roles the approver has allowed, if any. Note: This field - // is required for the `ACCEPT` action. + // Role: Optional. The roles that the approver has allowed, if any. For more + // information, see Roles and permissions + // (https://developers.google.com/workspace/drive/api/guides/ref-roles). Note: + // This field is required for the `ACCEPT` action. Role []string `json:"role,omitempty"` // SendNotification: Optional. Whether to send an email to the requester when - // the AccessProposal is denied or accepted. + // the access proposal is denied or accepted. SendNotification bool `json:"sendNotification,omitempty"` // View: Optional. Indicates the view for this access proposal. This should - // only be set when the proposal belongs to a view. `published` is the only - // supported value. + // only be set when the proposal belongs to a view. Only `published` is + // supported. View string `json:"view,omitempty"` // ForceSendFields is a list of field names (e.g. "Action") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -3378,10 +3381,12 @@ type AccessproposalsGetCall struct { header_ http.Header } -// Get: Retrieves an AccessProposal by ID. +// Get: Retrieves an access proposal by ID. For more information, see Manage +// pending access proposals +// (https://developers.google.com/workspace/drive/api/guides/pending-access). // -// - fileId: The id of the item the request is on. -// - proposalId: The id of the access proposal to resolve. +// - fileId: The ID of the item the request is on. +// - proposalId: The ID of the access proposal to resolve. func (r *AccessproposalsService) Get(fileId string, proposalId string) *AccessproposalsGetCall { c := &AccessproposalsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.fileId = fileId @@ -3490,11 +3495,13 @@ type AccessproposalsListCall struct { header_ http.Header } -// List: List the AccessProposals on a file. Note: Only approvers are able to -// list AccessProposals on a file. If the user is not an approver, returns a -// 403. +// List: List the access proposals on a file. For more information, see Manage +// pending access proposals +// (https://developers.google.com/workspace/drive/api/guides/pending-access). +// Note: Only approvers are able to list access proposals on a file. If the +// user isn't an approver, a 403 error is returned. // -// - fileId: The id of the item the request is on. +// - fileId: The ID of the item the request is on. func (r *AccessproposalsService) List(fileId string) *AccessproposalsListCall { c := &AccessproposalsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.fileId = fileId @@ -3502,7 +3509,7 @@ func (r *AccessproposalsService) List(fileId string) *AccessproposalsListCall { } // PageSize sets the optional parameter "pageSize": The number of results per -// page +// page. func (c *AccessproposalsListCall) PageSize(pageSize int64) *AccessproposalsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -3638,10 +3645,12 @@ type AccessproposalsResolveCall struct { header_ http.Header } -// Resolve: Used to approve or deny an Access Proposal. +// Resolve: Approves or denies an access proposal. For more information, see +// Manage pending access proposals +// (https://developers.google.com/workspace/drive/api/guides/pending-access). // -// - fileId: The id of the item the request is on. -// - proposalId: The id of the access proposal to resolve. +// - fileId: The ID of the item the request is on. +// - proposalId: The ID of the access proposal to resolve. func (r *AccessproposalsService) Resolve(fileId string, proposalId string, resolveaccessproposalrequest *ResolveAccessProposalRequest) *AccessproposalsResolveCall { c := &AccessproposalsResolveCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.fileId = fileId diff --git a/eventarc/v1/eventarc-api.json b/eventarc/v1/eventarc-api.json index 9f846bdc997..2e486cd1e82 100644 --- a/eventarc/v1/eventarc-api.json +++ b/eventarc/v1/eventarc-api.json @@ -2466,7 +2466,7 @@ } } }, - "revision": "20250905", + "revision": "20250912", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { @@ -2951,6 +2951,14 @@ "description": "Identifier. Resource name of the form projects/{project}/locations/{location}/googleApiSources/{google_api_source}", "type": "string" }, + "organizationSubscription": { + "$ref": "OrganizationSubscription", + "description": "Optional. Config to enable subscribing to events from all projects in the GoogleApiSource's org." + }, + "projectSubscriptions": { + "$ref": "ProjectSubscriptions", + "description": "Optional. Config to enable subscribing to all events from a list of projects. All the projects must be in the same org as the GoogleApiSource." + }, "uid": { "description": "Output only. Server assigned unique identifier for the channel. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.", "readOnly": true, @@ -3713,6 +3721,17 @@ }, "type": "object" }, + "OrganizationSubscription": { + "description": "Config to enabled subscribing to events from other projects in the org.", + "id": "OrganizationSubscription", + "properties": { + "enabled": { + "description": "Required. Enable org level subscription.", + "type": "boolean" + } + }, + "type": "object" + }, "Pipeline": { "description": "A representation of the Pipeline resource.", "id": "Pipeline", @@ -3830,6 +3849,20 @@ }, "type": "object" }, + "ProjectSubscriptions": { + "description": "Config to enable subscribing to all events from a list of projects.", + "id": "ProjectSubscriptions", + "properties": { + "list": { + "description": "Required. A list of projects to receive events from. All the projects must be in the same org. The listed projects should have the format project/{identifier} where identifier can be either the project id for project number. A single list may contain both formats. At most 100 projects can be listed.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "Provider": { "description": "A representation of the Provider resource.", "id": "Provider", diff --git a/eventarc/v1/eventarc-gen.go b/eventarc/v1/eventarc-gen.go index 5fcd120c1f3..f309213934c 100644 --- a/eventarc/v1/eventarc-gen.go +++ b/eventarc/v1/eventarc-gen.go @@ -952,6 +952,13 @@ type GoogleApiSource struct { // Name: Identifier. Resource name of the form // projects/{project}/locations/{location}/googleApiSources/{google_api_source} Name string `json:"name,omitempty"` + // OrganizationSubscription: Optional. Config to enable subscribing to events + // from all projects in the GoogleApiSource's org. + OrganizationSubscription *OrganizationSubscription `json:"organizationSubscription,omitempty"` + // ProjectSubscriptions: Optional. Config to enable subscribing to all events + // from a list of projects. All the projects must be in the same org as the + // GoogleApiSource. + ProjectSubscriptions *ProjectSubscriptions `json:"projectSubscriptions,omitempty"` // Uid: Output only. Server assigned unique identifier for the channel. The // value is a UUID4 string and guaranteed to remain unchanged until the // resource is deleted. @@ -2182,6 +2189,29 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// OrganizationSubscription: Config to enabled subscribing to events from other +// projects in the org. +type OrganizationSubscription struct { + // Enabled: Required. Enable org level subscription. + Enabled bool `json:"enabled,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 []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 + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s OrganizationSubscription) MarshalJSON() ([]byte, error) { + type NoMethod OrganizationSubscription + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Pipeline: A representation of the Pipeline resource. type Pipeline struct { // Annotations: Optional. User-defined annotations. See @@ -2355,6 +2385,33 @@ func (s Policy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ProjectSubscriptions: Config to enable subscribing to all events from a list +// of projects. +type ProjectSubscriptions struct { + // List: Required. A list of projects to receive events from. All the projects + // must be in the same org. The listed projects should have the format + // project/{identifier} where identifier can be either the project id for + // project number. A single list may contain both formats. At most 100 projects + // can be listed. + List []string `json:"list,omitempty"` + // ForceSendFields is a list of field names (e.g. "List") 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. "List") 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 ProjectSubscriptions) MarshalJSON() ([]byte, error) { + type NoMethod ProjectSubscriptions + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Provider: A representation of the Provider resource. type Provider struct { // DisplayName: Output only. Human friendly name for the Provider. For example diff --git a/file/v1/file-api.json b/file/v1/file-api.json index de41eaff339..61a5c7b5b71 100644 --- a/file/v1/file-api.json +++ b/file/v1/file-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -908,7 +908,7 @@ } } }, - "revision": "20250825", + "revision": "20250910", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { diff --git a/file/v1/file-gen.go b/file/v1/file-gen.go index 9d36e51a4d9..5fb864dfd09 100644 --- a/file/v1/file-gen.go +++ b/file/v1/file-gen.go @@ -2152,9 +2152,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/file/v1beta1/file-api.json b/file/v1beta1/file-api.json index ffeeca7d233..5b486b90334 100644 --- a/file/v1beta1/file-api.json +++ b/file/v1beta1/file-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1131,7 +1131,7 @@ } } }, - "revision": "20250819", + "revision": "20250910", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { diff --git a/file/v1beta1/file-gen.go b/file/v1beta1/file-gen.go index a885aa96e75..510089c27be 100644 --- a/file/v1beta1/file-gen.go +++ b/file/v1beta1/file-gen.go @@ -2390,9 +2390,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json index 2b1183d33cf..1f8d37cdb16 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-api.json @@ -747,6 +747,11 @@ "name" ], "parameters": { + "allowMissing": { + "description": "Optional. If set to true, and the test case is not found, a new test case will be created.", + "location": "query", + "type": "boolean" + }, "name": { "description": "Identifier. The name of the test case resource. Format: `projects/{project_number}/apps/{app_id}/testCases/{test_case_id}`", "location": "path", @@ -807,7 +812,7 @@ } } }, - "revision": "20250912", + "revision": "20250916", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "AndroidxCrawlerOutputPoint": { diff --git a/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go b/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go index 987d412b9f0..2482b606632 100644 --- a/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go +++ b/firebaseappdistribution/v1alpha/firebaseappdistribution-gen.go @@ -4044,6 +4044,13 @@ func (r *ProjectsAppsTestCasesService) Patch(name string, googlefirebaseappdistr return c } +// AllowMissing sets the optional parameter "allowMissing": If set to true, and +// the test case is not found, a new test case will be created. +func (c *ProjectsAppsTestCasesPatchCall) AllowMissing(allowMissing bool) *ProjectsAppsTestCasesPatchCall { + c.urlParams_.Set("allowMissing", fmt.Sprint(allowMissing)) + 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/firebaseapphosting/v1beta/firebaseapphosting-api.json b/firebaseapphosting/v1beta/firebaseapphosting-api.json index 7bcb472dadf..97c60fec7fd 100644 --- a/firebaseapphosting/v1beta/firebaseapphosting-api.json +++ b/firebaseapphosting/v1beta/firebaseapphosting-api.json @@ -1098,7 +1098,7 @@ } } }, - "revision": "20250904", + "revision": "20250918", "rootUrl": "https://firebaseapphosting.googleapis.com/", "schemas": { "ArchiveSource": { @@ -1196,6 +1196,13 @@ "description": "Identifier. The resource name of the backend. Format: `projects/{project}/locations/{locationId}/backends/{backendId}`.", "type": "string" }, + "overrideEnv": { + "description": "Optional. Override environment variables for this Backend.", + "items": { + "$ref": "EnvironmentVariable" + }, + "type": "array" + }, "reconciling": { "description": "Output only. A field that, if true, indicates that the system is working to make adjustments to the backend during a LRO.", "readOnly": true, diff --git a/firebaseapphosting/v1beta/firebaseapphosting-gen.go b/firebaseapphosting/v1beta/firebaseapphosting-gen.go index 49ff3eee54c..653608322df 100644 --- a/firebaseapphosting/v1beta/firebaseapphosting-gen.go +++ b/firebaseapphosting/v1beta/firebaseapphosting-gen.go @@ -317,6 +317,8 @@ type Backend struct { // Name: Identifier. The resource name of the backend. Format: // `projects/{project}/locations/{locationId}/backends/{backendId}`. Name string `json:"name,omitempty"` + // OverrideEnv: Optional. Override environment variables for this Backend. + OverrideEnv []*EnvironmentVariable `json:"overrideEnv,omitempty"` // Reconciling: Output only. A field that, if true, indicates that the system // is working to make adjustments to the backend during a LRO. Reconciling bool `json:"reconciling,omitempty"` diff --git a/firebaseml/v2beta/firebaseml-api.json b/firebaseml/v2beta/firebaseml-api.json index cd26ed7d567..09b0c415465 100644 --- a/firebaseml/v2beta/firebaseml-api.json +++ b/firebaseml/v2beta/firebaseml-api.json @@ -206,7 +206,7 @@ } } }, - "revision": "20250909", + "revision": "20250922", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -1044,7 +1044,8 @@ "BLOCKLIST", "PROHIBITED_CONTENT", "MODEL_ARMOR", - "IMAGE_SAFETY" + "IMAGE_SAFETY", + "JAILBREAK" ], "enumDescriptions": [ "The blocked reason is unspecified.", @@ -1053,7 +1054,8 @@ "The prompt was blocked because it contains a term from the terminology blocklist.", "The prompt was blocked because it contains prohibited content.", "The prompt was blocked by Model Armor.", - "The prompt was blocked because it contains content that is unsafe for image generation." + "The prompt was blocked because it contains content that is unsafe for image generation.", + "The prompt was blocked as a jailbreak attempt." ], "readOnly": true, "type": "string" @@ -1991,7 +1993,8 @@ "HARM_CATEGORY_IMAGE_HATE", "HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT", "HARM_CATEGORY_IMAGE_HARASSMENT", - "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT" + "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_JAILBREAK" ], "enumDeprecated": [ false, @@ -2003,6 +2006,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -2015,7 +2019,8 @@ "The harm category is image hate.", "The harm category is image dangerous content.", "The harm category is image harassment.", - "The harm category is image sexually explicit content." + "The harm category is image sexually explicit content.", + "The harm category is for jailbreak prompts." ], "readOnly": true, "type": "string" @@ -2110,7 +2115,8 @@ "HARM_CATEGORY_IMAGE_HATE", "HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT", "HARM_CATEGORY_IMAGE_HARASSMENT", - "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT" + "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_JAILBREAK" ], "enumDeprecated": [ false, @@ -2122,6 +2128,7 @@ false, false, false, + false, false ], "enumDescriptions": [ @@ -2134,7 +2141,8 @@ "The harm category is image hate.", "The harm category is image dangerous content.", "The harm category is image harassment.", - "The harm category is image sexually explicit content." + "The harm category is image sexually explicit content.", + "The harm category is for jailbreak prompts." ], "type": "string" }, diff --git a/firebaseml/v2beta/firebaseml-gen.go b/firebaseml/v2beta/firebaseml-gen.go index 26d2cdfaaab..8069f8b2337 100644 --- a/firebaseml/v2beta/firebaseml-gen.go +++ b/firebaseml/v2beta/firebaseml-gen.go @@ -1311,6 +1311,7 @@ type GoogleCloudAiplatformV1beta1GenerateContentResponsePromptFeedback struct { // "MODEL_ARMOR" - The prompt was blocked by Model Armor. // "IMAGE_SAFETY" - The prompt was blocked because it contains content that // is unsafe for image generation. + // "JAILBREAK" - The prompt was blocked as a jailbreak attempt. BlockReason string `json:"blockReason,omitempty"` // BlockReasonMessage: Output only. A readable message that explains the reason // why the prompt was blocked. @@ -2585,6 +2586,7 @@ type GoogleCloudAiplatformV1beta1SafetyRating struct { // "HARM_CATEGORY_IMAGE_HARASSMENT" - The harm category is image harassment. // "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT" - The harm category is image // sexually explicit content. + // "HARM_CATEGORY_JAILBREAK" - The harm category is for jailbreak prompts. Category string `json:"category,omitempty"` // OverwrittenThreshold: Output only. The overwritten threshold for the safety // category of Gemini 2.0 image out. If minors are detected in the output @@ -2675,6 +2677,7 @@ type GoogleCloudAiplatformV1beta1SafetySetting struct { // "HARM_CATEGORY_IMAGE_HARASSMENT" - The harm category is image harassment. // "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT" - The harm category is image // sexually explicit content. + // "HARM_CATEGORY_JAILBREAK" - The harm category is for jailbreak prompts. Category string `json:"category,omitempty"` // Method: Optional. Specify if the threshold is used for probability or // severity score. If not specified, the threshold is used for probability diff --git a/firestore/v1/firestore-api.json b/firestore/v1/firestore-api.json index c803efb1a2a..609b53fd5ba 100644 --- a/firestore/v1/firestore-api.json +++ b/firestore/v1/firestore-api.json @@ -1829,7 +1829,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1961,7 +1961,7 @@ } } }, - "revision": "20250830", + "revision": "20250908", "rootUrl": "https://firestore.googleapis.com/", "schemas": { "Aggregation": { diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index 06786235005..79c45221974 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -10642,9 +10642,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/go.work.sum b/go.work.sum index 333ba9aab55..090a04d1e12 100644 --- a/go.work.sum +++ b/go.work.sum @@ -745,6 +745,7 @@ golang.org/x/net v0.21.0/go.mod h1:bIjVDfnllIU7BJ2DNgfnXvpSvtn8VRwhlsaeUTyUS44= golang.org/x/net v0.25.0/go.mod h1:JkAGAh7GEvH74S6FOH42FLoXpXbE/aqXSrIQjXgsiwM= golang.org/x/net v0.41.0/go.mod h1:B/K4NNqkfmg07DQYrbwvSluqCJOOXwUjeb/5lOisjbA= golang.org/x/net v0.42.0/go.mod h1:FF1RA5d3u7nAYA4z2TkclSCKh68eSXtiFwcWQpPXdt8= +golang.org/x/net v0.43.0/go.mod h1:vhO1fvI4dGsIjh73sWfUVjj3N7CA9WkKJNQm2svM6Jg= golang.org/x/oauth2 v0.0.0-20200107190931-bf48bf16ab8d/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.7.0/go.mod h1:hPLQkd9LyjfXTiRohC/41GhcFqxisoUQ99sCUOHO9x4= golang.org/x/oauth2 v0.15.0/go.mod h1:q48ptWNTY5XWf+JNten23lcvHpLJ0ZSxF5ttTHKVCAM= @@ -778,6 +779,7 @@ golang.org/x/term v0.30.0/go.mod h1:NYYFdzHoI5wRh/h5tDMdMqCqPJZEuNqVR5xJLd/n67g= golang.org/x/term v0.32.0/go.mod h1:uZG1FhGx848Sqfsq4/DlJr3xGGsYMu/L5GW4abiaEPQ= golang.org/x/term v0.33.0/go.mod h1:s18+ql9tYWp1IfpV9DmCtQDDSRBUjKaw9M1eAv5UeF0= golang.org/x/term v0.34.0/go.mod h1:5jC53AEywhIVebHgPVeg0mj8OD3VO9OzclacVrqpaAw= +golang.org/x/term v0.35.0/go.mod h1:TPGtkTLesOwf2DE8CgVYiZinHAOuy5AYUYT1lENIZnA= golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ= golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= golang.org/x/tools v0.14.0/go.mod h1:uYBEerGOWcJyEORxN+Ek8+TT266gXkNlHdJBwexUsBg= diff --git a/looker/v1/looker-api.json b/looker/v1/looker-api.json index 6db3a43d209..10df4c68553 100644 --- a/looker/v1/looker-api.json +++ b/looker/v1/looker-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -710,7 +710,7 @@ } } }, - "revision": "20250824", + "revision": "20250906", "rootUrl": "https://looker.googleapis.com/", "schemas": { "AdminSettings": { diff --git a/looker/v1/looker-gen.go b/looker/v1/looker-gen.go index 076eb235ae7..0783b32a599 100644 --- a/looker/v1/looker-gen.go +++ b/looker/v1/looker-gen.go @@ -1350,9 +1350,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/managedkafka/v1/managedkafka-api.json b/managedkafka/v1/managedkafka-api.json index 78988d9d6ca..e5762bcc79b 100644 --- a/managedkafka/v1/managedkafka-api.json +++ b/managedkafka/v1/managedkafka-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -2934,7 +2934,7 @@ } } }, - "revision": "20250901", + "revision": "20250911", "rootUrl": "https://managedkafka.googleapis.com/", "schemas": { "AccessConfig": { diff --git a/managedkafka/v1/managedkafka-gen.go b/managedkafka/v1/managedkafka-gen.go index c1975d0ced9..83059805013 100644 --- a/managedkafka/v1/managedkafka-gen.go +++ b/managedkafka/v1/managedkafka-gen.go @@ -2505,9 +2505,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/metastore/v1/metastore-api.json b/metastore/v1/metastore-api.json index a6a4fde1cae..b285e3f715f 100644 --- a/metastore/v1/metastore-api.json +++ b/metastore/v1/metastore-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1690,7 +1690,7 @@ } } }, - "revision": "20250814", + "revision": "20250911", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AlterMetadataResourceLocationRequest": { diff --git a/metastore/v1/metastore-gen.go b/metastore/v1/metastore-gen.go index 906f2689274..e117b3392bf 100644 --- a/metastore/v1/metastore-gen.go +++ b/metastore/v1/metastore-gen.go @@ -2888,9 +2888,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/metastore/v1alpha/metastore-api.json b/metastore/v1alpha/metastore-api.json index be6bb1837aa..9dadc9850fb 100644 --- a/metastore/v1alpha/metastore-api.json +++ b/metastore/v1alpha/metastore-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1802,7 +1802,7 @@ } } }, - "revision": "20250814", + "revision": "20250911", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AlterMetadataResourceLocationRequest": { diff --git a/metastore/v1alpha/metastore-gen.go b/metastore/v1alpha/metastore-gen.go index 01d374a1c57..0d201a16edb 100644 --- a/metastore/v1alpha/metastore-gen.go +++ b/metastore/v1alpha/metastore-gen.go @@ -3132,9 +3132,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/metastore/v1beta/metastore-api.json b/metastore/v1beta/metastore-api.json index 55e30ae6936..f7c49a1370b 100644 --- a/metastore/v1beta/metastore-api.json +++ b/metastore/v1beta/metastore-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1802,7 +1802,7 @@ } } }, - "revision": "20250814", + "revision": "20250911", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AlterMetadataResourceLocationRequest": { diff --git a/metastore/v1beta/metastore-gen.go b/metastore/v1beta/metastore-gen.go index c3b151ee302..3c7f3f5a6e5 100644 --- a/metastore/v1beta/metastore-gen.go +++ b/metastore/v1beta/metastore-gen.go @@ -3132,9 +3132,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/migrationcenter/v1alpha1/migrationcenter-api.json b/migrationcenter/v1alpha1/migrationcenter-api.json index 60b0ad7a080..e5badbbf022 100644 --- a/migrationcenter/v1alpha1/migrationcenter-api.json +++ b/migrationcenter/v1alpha1/migrationcenter-api.json @@ -2554,7 +2554,7 @@ } } }, - "revision": "20250910", + "revision": "20250917", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -3527,9 +3527,26 @@ "description": "BIOS version.", "type": "string" }, + "id": { + "description": "BIOS ID.", + "type": "string" + }, + "manufacturer": { + "description": "BIOS manufacturer.", + "type": "string" + }, + "releaseTime": { + "description": "BIOS release date.", + "format": "google-datetime", + "type": "string" + }, "smbiosUuid": { "description": "SMBIOS UUID.", "type": "string" + }, + "version": { + "description": "BIOS version.", + "type": "string" } }, "type": "object" @@ -4860,6 +4877,11 @@ "description": "Single disk entry.", "id": "DiskEntry", "properties": { + "capacityBytes": { + "description": "Disk capacity.", + "format": "int64", + "type": "string" + }, "diskLabel": { "description": "Disk label.", "type": "string" @@ -4868,6 +4890,11 @@ "description": "Disk label type (e.g. BIOS/GPT)", "type": "string" }, + "freeSpaceBytes": { + "description": "Disk free space.", + "format": "int64", + "type": "string" + }, "hwAddress": { "description": "Disk hardware address (e.g. 0:1 for SCSI).", "type": "string" @@ -5367,6 +5394,22 @@ "selinux": { "$ref": "Selinux", "description": "SELinux details." + }, + "selinuxMode": { + "description": "Security-Enhanced Linux (SELinux) mode.", + "enum": [ + "SE_LINUX_MODE_UNSPECIFIED", + "SE_LINUX_MODE_DISABLED", + "SE_LINUX_MODE_PERMISSIVE", + "SE_LINUX_MODE_ENFORCING" + ], + "enumDescriptions": [ + "SELinux mode unknown or unspecified.", + "SELinux is disabled.", + "SELinux permissive mode.", + "SELinux enforcing mode." + ], + "type": "string" } }, "type": "object" @@ -5375,6 +5418,15 @@ "description": "Guest installed application information.", "id": "GuestInstalledApplication", "properties": { + "applicationName": { + "description": "Installed application name.", + "type": "string" + }, + "installTime": { + "description": "The time when the application was installed.", + "format": "google-datetime", + "type": "string" + }, "licenses": { "description": "License strings associated with the installed application.", "items": { @@ -5427,9 +5479,33 @@ "$ref": "GuestConfigDetails", "description": "OS and app configuration." }, + "family": { + "description": "What family the OS belong to, if known.", + "enum": [ + "OS_FAMILY_UNKNOWN", + "OS_FAMILY_WINDOWS", + "OS_FAMILY_LINUX", + "OS_FAMILY_UNIX" + ], + "enumDescriptions": [ + "", + "Microsoft Windows Server and Desktop.", + "Various Linux flavors.", + "Non-Linux Unix flavors." + ], + "type": "string" + }, + "osName": { + "description": "The name of the operating system.", + "type": "string" + }, "runtime": { "$ref": "GuestRuntimeDetails", "description": "Runtime information." + }, + "version": { + "description": "The version of the operating system.", + "type": "string" } }, "type": "object" @@ -5446,6 +5522,11 @@ "$ref": "GuestInstalledApplicationList", "description": "Installed applications information." }, + "lastBootTime": { + "description": "Last time the OS was booted.", + "format": "google-datetime", + "type": "string" + }, "lastUptime": { "$ref": "Date", "description": "Date since last booted (last uptime date)." @@ -6811,6 +6892,13 @@ "description": "List of network adapters.", "id": "NetworkAdapterList", "properties": { + "entries": { + "description": "Network adapter entries.", + "items": { + "$ref": "NetworkAdapterDetails" + }, + "type": "array" + }, "networkAdapters": { "description": "Network adapter descriptions.", "items": { @@ -6868,6 +6956,13 @@ "$ref": "NetworkAddress" }, "type": "array" + }, + "entries": { + "description": "Network address entries.", + "items": { + "$ref": "NetworkAddress" + }, + "type": "array" } }, "type": "object" @@ -8011,7 +8106,8 @@ "type": "string" }, "allocatedDiskTypes": { - "description": "Set of disk types allocated to assets.", + "deprecated": true, + "description": "@deprecated. Use storage_allocations instead. Set of disk types allocated to assets.", "items": { "enum": [ "PERSISTENT_DISK_TYPE_UNSPECIFIED", @@ -8264,6 +8360,13 @@ "description": "List of running guest OS processes.", "id": "RunningProcessList", "properties": { + "entries": { + "description": "Running process entries.", + "items": { + "$ref": "RunningProcess" + }, + "type": "array" + }, "processes": { "description": "Running process entries.", "items": { @@ -8295,6 +8398,10 @@ "format": "int64", "type": "string" }, + "serviceName": { + "description": "Service name.", + "type": "string" + }, "startMode": { "description": "Service start mode (raw, OS-agnostic).", "type": "string" @@ -8314,6 +8421,13 @@ "description": "List of running guest OS services.", "id": "RunningServiceList", "properties": { + "entries": { + "description": "Running service entries.", + "items": { + "$ref": "RunningService" + }, + "type": "array" + }, "services": { "description": "Running service entries.", "items": { @@ -8339,6 +8453,15 @@ "netstatTime": { "$ref": "DateTime", "description": "Netstat time collected." + }, + "rawScanResult": { + "description": "Raw network scan result. This field is intended for human inspection. The format of this field may be netstat output or any another raw output. The exact format may change without notice and should not be relied upon.", + "type": "string" + }, + "scanTime": { + "description": "Time of the last network scan.", + "format": "google-datetime", + "type": "string" } }, "type": "object" @@ -9328,9 +9451,21 @@ "description": "VMware os enum - https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html.", "type": "string" }, + "vcenterFolder": { + "description": "Folder name in vCenter where asset resides.", + "type": "string" + }, + "vcenterUri": { + "description": "vCenter URI used in collection.", + "type": "string" + }, "vcenterVersion": { "description": "vCenter version.", "type": "string" + }, + "vcenterVmId": { + "description": "vCenter VM ID.", + "type": "string" } }, "type": "object" diff --git a/migrationcenter/v1alpha1/migrationcenter-gen.go b/migrationcenter/v1alpha1/migrationcenter-gen.go index 2ddf2374b28..2840dcc07b9 100644 --- a/migrationcenter/v1alpha1/migrationcenter-gen.go +++ b/migrationcenter/v1alpha1/migrationcenter-gen.go @@ -1426,8 +1426,16 @@ type BiosDetails struct { BiosReleaseDate string `json:"biosReleaseDate,omitempty"` // BiosVersion: BIOS version. BiosVersion string `json:"biosVersion,omitempty"` + // Id: BIOS ID. + Id string `json:"id,omitempty"` + // Manufacturer: BIOS manufacturer. + Manufacturer string `json:"manufacturer,omitempty"` + // ReleaseTime: BIOS release date. + ReleaseTime string `json:"releaseTime,omitempty"` // SmbiosUuid: SMBIOS UUID. SmbiosUuid string `json:"smbiosUuid,omitempty"` + // Version: BIOS version. + Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "BiosManufacturer") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -2867,10 +2875,14 @@ func (s DiscoveryClientDiscoveryClientRecommendedVersion) MarshalJSON() ([]byte, // DiskEntry: Single disk entry. type DiskEntry struct { + // CapacityBytes: Disk capacity. + CapacityBytes int64 `json:"capacityBytes,omitempty,string"` // DiskLabel: Disk label. DiskLabel string `json:"diskLabel,omitempty"` // DiskLabelType: Disk label type (e.g. BIOS/GPT) DiskLabelType string `json:"diskLabelType,omitempty"` + // FreeSpaceBytes: Disk free space. + FreeSpaceBytes int64 `json:"freeSpaceBytes,omitempty,string"` // HwAddress: Disk hardware address (e.g. 0:1 for SCSI). HwAddress string `json:"hwAddress,omitempty"` // InterfaceType: Disks interface type (e.g. SATA/SCSI) @@ -2883,13 +2895,13 @@ type DiskEntry struct { TotalCapacityBytes int64 `json:"totalCapacityBytes,omitempty,string"` // TotalFreeBytes: Disk free space. TotalFreeBytes int64 `json:"totalFreeBytes,omitempty,string"` - // ForceSendFields is a list of field names (e.g. "DiskLabel") to + // ForceSendFields is a list of field names (e.g. "CapacityBytes") 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. "DiskLabel") to include in API + // NullFields is a list of field names (e.g. "CapacityBytes") 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. @@ -3448,6 +3460,14 @@ type GuestConfigDetails struct { NfsExports *NfsExportList `json:"nfsExports,omitempty"` // Selinux: SELinux details. Selinux *Selinux `json:"selinux,omitempty"` + // SelinuxMode: Security-Enhanced Linux (SELinux) mode. + // + // Possible values: + // "SE_LINUX_MODE_UNSPECIFIED" - SELinux mode unknown or unspecified. + // "SE_LINUX_MODE_DISABLED" - SELinux is disabled. + // "SE_LINUX_MODE_PERMISSIVE" - SELinux permissive mode. + // "SE_LINUX_MODE_ENFORCING" - SELinux enforcing mode. + SelinuxMode string `json:"selinuxMode,omitempty"` // ForceSendFields is a list of field names (e.g. "Fstab") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -3468,6 +3488,10 @@ func (s GuestConfigDetails) MarshalJSON() ([]byte, error) { // GuestInstalledApplication: Guest installed application information. type GuestInstalledApplication struct { + // ApplicationName: Installed application name. + ApplicationName string `json:"applicationName,omitempty"` + // InstallTime: The time when the application was installed. + InstallTime string `json:"installTime,omitempty"` // Licenses: License strings associated with the installed application. Licenses []string `json:"licenses,omitempty"` // Name: Installed application name. @@ -3480,15 +3504,15 @@ type GuestInstalledApplication struct { Vendor string `json:"vendor,omitempty"` // Version: Installed application version. Version string `json:"version,omitempty"` - // ForceSendFields is a list of field names (e.g. "Licenses") to + // ForceSendFields is a list of field names (e.g. "ApplicationName") 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. "Licenses") 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. "ApplicationName") 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:"-"` } @@ -3524,8 +3548,20 @@ func (s GuestInstalledApplicationList) MarshalJSON() ([]byte, error) { type GuestOsDetails struct { // Config: OS and app configuration. Config *GuestConfigDetails `json:"config,omitempty"` + // Family: What family the OS belong to, if known. + // + // Possible values: + // "OS_FAMILY_UNKNOWN" + // "OS_FAMILY_WINDOWS" - Microsoft Windows Server and Desktop. + // "OS_FAMILY_LINUX" - Various Linux flavors. + // "OS_FAMILY_UNIX" - Non-Linux Unix flavors. + Family string `json:"family,omitempty"` + // OsName: The name of the operating system. + OsName string `json:"osName,omitempty"` // Runtime: Runtime information. Runtime *GuestRuntimeDetails `json:"runtime,omitempty"` + // Version: The version of the operating system. + Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Config") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -3550,6 +3586,8 @@ type GuestRuntimeDetails struct { Domain string `json:"domain,omitempty"` // InstalledApps: Installed applications information. InstalledApps *GuestInstalledApplicationList `json:"installedApps,omitempty"` + // LastBootTime: Last time the OS was booted. + LastBootTime string `json:"lastBootTime,omitempty"` // LastUptime: Date since last booted (last uptime date). LastUptime *Date `json:"lastUptime,omitempty"` // MachineName: Machine name. @@ -5075,17 +5113,19 @@ func (s NetworkAdapterDetails) MarshalJSON() ([]byte, error) { // NetworkAdapterList: List of network adapters. type NetworkAdapterList struct { + // Entries: Network adapter entries. + Entries []*NetworkAdapterDetails `json:"entries,omitempty"` // NetworkAdapters: Network adapter descriptions. NetworkAdapters []*NetworkAdapterDetails `json:"networkAdapters,omitempty"` - // ForceSendFields is a list of field names (e.g. "NetworkAdapters") 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. "Entries") 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. "NetworkAdapters") 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. "Entries") 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:"-"` } @@ -5134,6 +5174,8 @@ func (s NetworkAddress) MarshalJSON() ([]byte, error) { type NetworkAddressList struct { // Addresses: Network address entries. Addresses []*NetworkAddress `json:"addresses,omitempty"` + // Entries: Network address entries. + Entries []*NetworkAddress `json:"entries,omitempty"` // ForceSendFields is a list of field names (e.g. "Addresses") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -6449,7 +6491,8 @@ func (s ReportSummaryHistogramChartDataBucket) MarshalJSON() ([]byte, error) { type ReportSummaryMachineFinding struct { // AllocatedAssetCount: Count of assets which were allocated. AllocatedAssetCount int64 `json:"allocatedAssetCount,omitempty,string"` - // AllocatedDiskTypes: Set of disk types allocated to assets. + // AllocatedDiskTypes: @deprecated. Use storage_allocations instead. Set of + // disk types allocated to assets. // // Possible values: // "PERSISTENT_DISK_TYPE_UNSPECIFIED" - Unspecified. Fallback to default @@ -6807,15 +6850,17 @@ func (s RunningProcess) MarshalJSON() ([]byte, error) { // RunningProcessList: List of running guest OS processes. type RunningProcessList struct { + // Entries: Running process entries. + Entries []*RunningProcess `json:"entries,omitempty"` // Processes: Running process entries. Processes []*RunningProcess `json:"processes,omitempty"` - // ForceSendFields is a list of field names (e.g. "Processes") 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. "Entries") 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. "Processes") to include in API + // NullFields is a list of field names (e.g. "Entries") 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. @@ -6837,6 +6882,8 @@ type RunningService struct { Name string `json:"name,omitempty"` // Pid: Service pid. Pid int64 `json:"pid,omitempty,string"` + // ServiceName: Service name. + ServiceName string `json:"serviceName,omitempty"` // StartMode: Service start mode (raw, OS-agnostic). StartMode string `json:"startMode,omitempty"` // State: Service state (raw, OS-agnostic). @@ -6863,15 +6910,17 @@ func (s RunningService) MarshalJSON() ([]byte, error) { // RunningServiceList: List of running guest OS services. type RunningServiceList struct { + // Entries: Running service entries. + Entries []*RunningService `json:"entries,omitempty"` // Services: Running service entries. Services []*RunningService `json:"services,omitempty"` - // ForceSendFields is a list of field names (e.g. "Services") 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. "Entries") 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. "Services") to include in API + // NullFields is a list of field names (e.g. "Entries") 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. @@ -6891,6 +6940,13 @@ type RuntimeNetworkInfo struct { Netstat string `json:"netstat,omitempty"` // NetstatTime: Netstat time collected. NetstatTime *DateTime `json:"netstatTime,omitempty"` + // RawScanResult: Raw network scan result. This field is intended for human + // inspection. The format of this field may be netstat output or any another + // raw output. The exact format may change without notice and should not be + // relied upon. + RawScanResult string `json:"rawScanResult,omitempty"` + // ScanTime: Time of the last network scan. + ScanTime string `json:"scanTime,omitempty"` // ForceSendFields is a list of field names (e.g. "Connections") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See @@ -8064,8 +8120,14 @@ type VmwarePlatformDetails struct { // Osid: VMware os enum - // https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html. Osid string `json:"osid,omitempty"` + // VcenterFolder: Folder name in vCenter where asset resides. + VcenterFolder string `json:"vcenterFolder,omitempty"` + // VcenterUri: vCenter URI used in collection. + VcenterUri string `json:"vcenterUri,omitempty"` // VcenterVersion: vCenter version. VcenterVersion string `json:"vcenterVersion,omitempty"` + // VcenterVmId: vCenter VM ID. + VcenterVmId string `json:"vcenterVmId,omitempty"` // ForceSendFields is a list of field names (e.g. "EsxHyperthreading") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/netapp/v1/netapp-api.json b/netapp/v1/netapp-api.json index fbb87aa692d..a7d31dcb045 100644 --- a/netapp/v1/netapp-api.json +++ b/netapp/v1/netapp-api.json @@ -15,6 +15,218 @@ "description": "Google Cloud NetApp Volumes is a fully-managed, cloud-based data storage service that provides advanced data management capabilities and highly scalable performance with global availability.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/netapp/", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-east1.rep.googleapis.com/", + "location": "asia-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-east2.rep.googleapis.com/", + "location": "asia-east2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-northeast1.rep.googleapis.com/", + "location": "asia-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-northeast3.rep.googleapis.com/", + "location": "asia-northeast3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-south1.rep.googleapis.com/", + "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-south2.rep.googleapis.com/", + "location": "asia-south2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-southeast1.rep.googleapis.com/", + "location": "asia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-southeast2.rep.googleapis.com/", + "location": "asia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.australia-southeast1.rep.googleapis.com/", + "location": "australia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-central2.rep.googleapis.com/", + "location": "europe-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-north1.rep.googleapis.com/", + "location": "europe-north1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-southwest1.rep.googleapis.com/", + "location": "europe-southwest1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west10.rep.googleapis.com/", + "location": "europe-west10" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west12.rep.googleapis.com/", + "location": "europe-west12" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west2.rep.googleapis.com/", + "location": "europe-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west3.rep.googleapis.com/", + "location": "europe-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west4.rep.googleapis.com/", + "location": "europe-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west6.rep.googleapis.com/", + "location": "europe-west6" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west8.rep.googleapis.com/", + "location": "europe-west8" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west9.rep.googleapis.com/", + "location": "europe-west9" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.me-central1.rep.googleapis.com/", + "location": "me-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.me-central2.rep.googleapis.com/", + "location": "me-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.me-west1.rep.googleapis.com/", + "location": "me-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.northamerica-northeast1.rep.googleapis.com/", + "location": "northamerica-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.northamerica-northeast2.rep.googleapis.com/", + "location": "northamerica-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.northamerica-south1.rep.googleapis.com/", + "location": "northamerica-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.southamerica-east1.rep.googleapis.com/", + "location": "southamerica-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.southamerica-west1.rep.googleapis.com/", + "location": "southamerica-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-east1.rep.googleapis.com/", + "location": "us-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-east4.rep.googleapis.com/", + "location": "us-east4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-east5.rep.googleapis.com/", + "location": "us-east5" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-east7.rep.googleapis.com/", + "location": "us-east7" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-south1.rep.googleapis.com/", + "location": "us-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-west1.rep.googleapis.com/", + "location": "us-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-west2.rep.googleapis.com/", + "location": "us-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-west3.rep.googleapis.com/", + "location": "us-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-west4.rep.googleapis.com/", + "location": "us-west4" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -1592,6 +1804,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "restore": { + "description": "Restore files from a backup to a volume.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}:restore", + "httpMethod": "POST", + "id": "netapp.projects.locations.volumes.restore", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The volume resource name, in the format `projects/{project_id}/locations/{location}/volumes/{volume_id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:restore", + "request": { + "$ref": "RestoreBackupFilesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "revert": { "description": "Revert an existing volume to a specified snapshot. Warning! This operation will permanently revert all changes made after the snapshot was created.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}:revert", @@ -2270,7 +2510,7 @@ } } }, - "revision": "20250908", + "revision": "20250917", "rootUrl": "https://netapp.googleapis.com/", "schemas": { "ActiveDirectory": { @@ -2732,6 +2972,90 @@ }, "type": "object" }, + "CacheConfig": { + "description": "Configuration of the cache volume.", + "id": "CacheConfig", + "properties": { + "cifsChangeNotifyEnabled": { + "description": "Optional. Flag indicating whether a CIFS change notification is enabled for the FlexCache volume.", + "type": "boolean" + } + }, + "type": "object" + }, + "CacheParameters": { + "description": "Cache Parameters for the volume.", + "id": "CacheParameters", + "properties": { + "cacheConfig": { + "$ref": "CacheConfig", + "description": "Optional. Configuration of the cache volume." + }, + "cacheState": { + "description": "Output only. State of the cache volume indicating the peering status.", + "enum": [ + "CACHE_STATE_UNSPECIFIED", + "PENDING_CLUSTER_PEERING", + "PENDING_SVM_PEERING", + "PEERED", + "ERROR" + ], + "enumDescriptions": [ + "Default unspecified state.", + "State indicating waiting for cluster peering to be established.", + "State indicating waiting for SVM peering to be established.", + "State indicating successful establishment of peering with origin volumes's ONTAP cluster.", + "Terminal state wherein peering with origin volume's ONTAP cluster has failed." + ], + "readOnly": true, + "type": "string" + }, + "command": { + "description": "Output only. Copy-paste-able commands to be used on user's ONTAP to accept peering requests.", + "readOnly": true, + "type": "string" + }, + "enableGlobalFileLock": { + "description": "Optional. Field indicating whether cache volume as global file lock enabled.", + "type": "boolean" + }, + "passphrase": { + "description": "Output only. Temporary passphrase generated to accept cluster peering command.", + "readOnly": true, + "type": "string" + }, + "peerClusterName": { + "description": "Required. Name of the origin volume's ONTAP cluster.", + "type": "string" + }, + "peerIpAddresses": { + "description": "Required. List of IC LIF addresses of the origin volume's ONTAP cluster.", + "items": { + "type": "string" + }, + "type": "array" + }, + "peerSvmName": { + "description": "Required. Name of the origin volume's SVM.", + "type": "string" + }, + "peerVolumeName": { + "description": "Required. Name of the origin volume for the cache volume.", + "type": "string" + }, + "peeringCommandExpiryTime": { + "description": "Optional. Expiration time for the peering command to be executed on user's ONTAP.", + "format": "google-datetime", + "type": "string" + }, + "stateDetails": { + "description": "Output only. Detailed description of the current cache state.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", @@ -3838,6 +4162,28 @@ }, "type": "object" }, + "RestoreBackupFilesRequest": { + "description": "RestoreBackupFilesRequest restores files from a backup to a volume.", + "id": "RestoreBackupFilesRequest", + "properties": { + "backup": { + "description": "Required. The backup resource name, in the format `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}/backups/{backup_id}`", + "type": "string" + }, + "fileList": { + "description": "Required. List of files to be restored in the form of their absolute path as in source volume.", + "items": { + "type": "string" + }, + "type": "array" + }, + "restoreDestinationPath": { + "description": "Optional. Absolute directory path in the destination volume.", + "type": "string" + } + }, + "type": "object" + }, "RestoreParameters": { "description": "The RestoreParameters if volume is created from a snapshot or backup.", "id": "RestoreParameters", @@ -4460,6 +4806,10 @@ "$ref": "BackupConfig", "description": "BackupConfig of the volume." }, + "cacheParameters": { + "$ref": "CacheParameters", + "description": "Optional. Cache parameters for the volume." + }, "capacityGib": { "description": "Required. Capacity in GIB of the volume", "format": "int64", diff --git a/netapp/v1/netapp-gen.go b/netapp/v1/netapp-gen.go index b3171d12619..830f92ec1ec 100644 --- a/netapp/v1/netapp-gen.go +++ b/netapp/v1/netapp-gen.go @@ -684,6 +684,88 @@ func (s BackupVault) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// CacheConfig: Configuration of the cache volume. +type CacheConfig struct { + // CifsChangeNotifyEnabled: Optional. Flag indicating whether a CIFS change + // notification is enabled for the FlexCache volume. + CifsChangeNotifyEnabled bool `json:"cifsChangeNotifyEnabled,omitempty"` + // ForceSendFields is a list of field names (e.g. "CifsChangeNotifyEnabled") 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. "CifsChangeNotifyEnabled") 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 CacheConfig) MarshalJSON() ([]byte, error) { + type NoMethod CacheConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// CacheParameters: Cache Parameters for the volume. +type CacheParameters struct { + // CacheConfig: Optional. Configuration of the cache volume. + CacheConfig *CacheConfig `json:"cacheConfig,omitempty"` + // CacheState: Output only. State of the cache volume indicating the peering + // status. + // + // Possible values: + // "CACHE_STATE_UNSPECIFIED" - Default unspecified state. + // "PENDING_CLUSTER_PEERING" - State indicating waiting for cluster peering + // to be established. + // "PENDING_SVM_PEERING" - State indicating waiting for SVM peering to be + // established. + // "PEERED" - State indicating successful establishment of peering with + // origin volumes's ONTAP cluster. + // "ERROR" - Terminal state wherein peering with origin volume's ONTAP + // cluster has failed. + CacheState string `json:"cacheState,omitempty"` + // Command: Output only. Copy-paste-able commands to be used on user's ONTAP to + // accept peering requests. + Command string `json:"command,omitempty"` + // EnableGlobalFileLock: Optional. Field indicating whether cache volume as + // global file lock enabled. + EnableGlobalFileLock bool `json:"enableGlobalFileLock,omitempty"` + // Passphrase: Output only. Temporary passphrase generated to accept cluster + // peering command. + Passphrase string `json:"passphrase,omitempty"` + // PeerClusterName: Required. Name of the origin volume's ONTAP cluster. + PeerClusterName string `json:"peerClusterName,omitempty"` + // PeerIpAddresses: Required. List of IC LIF addresses of the origin volume's + // ONTAP cluster. + PeerIpAddresses []string `json:"peerIpAddresses,omitempty"` + // PeerSvmName: Required. Name of the origin volume's SVM. + PeerSvmName string `json:"peerSvmName,omitempty"` + // PeerVolumeName: Required. Name of the origin volume for the cache volume. + PeerVolumeName string `json:"peerVolumeName,omitempty"` + // PeeringCommandExpiryTime: Optional. Expiration time for the peering command + // to be executed on user's ONTAP. + PeeringCommandExpiryTime string `json:"peeringCommandExpiryTime,omitempty"` + // StateDetails: Output only. Detailed description of the current cache state. + StateDetails string `json:"stateDetails,omitempty"` + // ForceSendFields is a list of field names (e.g. "CacheConfig") 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. "CacheConfig") 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 CacheParameters) MarshalJSON() ([]byte, error) { + type NoMethod CacheParameters + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // CancelOperationRequest: The request message for Operations.CancelOperation. type CancelOperationRequest struct { } @@ -1850,6 +1932,37 @@ func (s Replication) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RestoreBackupFilesRequest: RestoreBackupFilesRequest restores files from a +// backup to a volume. +type RestoreBackupFilesRequest struct { + // Backup: Required. The backup resource name, in the format + // `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}/ba + // ckups/{backup_id}` + Backup string `json:"backup,omitempty"` + // FileList: Required. List of files to be restored in the form of their + // absolute path as in source volume. + FileList []string `json:"fileList,omitempty"` + // RestoreDestinationPath: Optional. Absolute directory path in the destination + // volume. + RestoreDestinationPath string `json:"restoreDestinationPath,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 RestoreBackupFilesRequest) MarshalJSON() ([]byte, error) { + type NoMethod RestoreBackupFilesRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RestoreParameters: The RestoreParameters if volume is created from a // snapshot or backup. type RestoreParameters struct { @@ -2484,6 +2597,8 @@ type Volume struct { ActiveDirectory string `json:"activeDirectory,omitempty"` // BackupConfig: BackupConfig of the volume. BackupConfig *BackupConfig `json:"backupConfig,omitempty"` + // CacheParameters: Optional. Cache parameters for the volume. + CacheParameters *CacheParameters `json:"cacheParameters,omitempty"` // CapacityGib: Required. Capacity in GIB of the volume CapacityGib int64 `json:"capacityGib,omitempty,string"` // ColdTierSizeGib: Output only. Size of the volume cold tier data rounded down @@ -8072,6 +8187,110 @@ func (c *ProjectsLocationsVolumesPatchCall) Do(opts ...googleapi.CallOption) (*O return ret, nil } +type ProjectsLocationsVolumesRestoreCall struct { + s *Service + name string + restorebackupfilesrequest *RestoreBackupFilesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Restore: Restore files from a backup to a volume. +// +// - name: The volume resource name, in the format +// `projects/{project_id}/locations/{location}/volumes/{volume_id}`. +func (r *ProjectsLocationsVolumesService) Restore(name string, restorebackupfilesrequest *RestoreBackupFilesRequest) *ProjectsLocationsVolumesRestoreCall { + c := &ProjectsLocationsVolumesRestoreCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.restorebackupfilesrequest = restorebackupfilesrequest + 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 *ProjectsLocationsVolumesRestoreCall) Fields(s ...googleapi.Field) *ProjectsLocationsVolumesRestoreCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsVolumesRestoreCall) Context(ctx context.Context) *ProjectsLocationsVolumesRestoreCall { + 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 *ProjectsLocationsVolumesRestoreCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsVolumesRestoreCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.restorebackupfilesrequest) + 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", "netapp.projects.locations.volumes.restore", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "netapp.projects.locations.volumes.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 *ProjectsLocationsVolumesRestoreCall) 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", "netapp.projects.locations.volumes.restore", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsVolumesRevertCall struct { s *Service name string diff --git a/netapp/v1beta1/netapp-api.json b/netapp/v1beta1/netapp-api.json index 8926c52cc10..2df9a279f27 100644 --- a/netapp/v1beta1/netapp-api.json +++ b/netapp/v1beta1/netapp-api.json @@ -15,6 +15,218 @@ "description": "Google Cloud NetApp Volumes is a fully-managed, cloud-based data storage service that provides advanced data management capabilities and highly scalable performance with global availability.", "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/netapp/", + "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-east1.rep.googleapis.com/", + "location": "asia-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-east2.rep.googleapis.com/", + "location": "asia-east2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-northeast1.rep.googleapis.com/", + "location": "asia-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-northeast3.rep.googleapis.com/", + "location": "asia-northeast3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-south1.rep.googleapis.com/", + "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-south2.rep.googleapis.com/", + "location": "asia-south2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-southeast1.rep.googleapis.com/", + "location": "asia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.asia-southeast2.rep.googleapis.com/", + "location": "asia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.australia-southeast1.rep.googleapis.com/", + "location": "australia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.australia-southeast2.rep.googleapis.com/", + "location": "australia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-central2.rep.googleapis.com/", + "location": "europe-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-north1.rep.googleapis.com/", + "location": "europe-north1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-southwest1.rep.googleapis.com/", + "location": "europe-southwest1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west1.rep.googleapis.com/", + "location": "europe-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west10.rep.googleapis.com/", + "location": "europe-west10" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west12.rep.googleapis.com/", + "location": "europe-west12" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west2.rep.googleapis.com/", + "location": "europe-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west3.rep.googleapis.com/", + "location": "europe-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west4.rep.googleapis.com/", + "location": "europe-west4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west6.rep.googleapis.com/", + "location": "europe-west6" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west8.rep.googleapis.com/", + "location": "europe-west8" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.europe-west9.rep.googleapis.com/", + "location": "europe-west9" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.me-central1.rep.googleapis.com/", + "location": "me-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.me-central2.rep.googleapis.com/", + "location": "me-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.me-west1.rep.googleapis.com/", + "location": "me-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.northamerica-northeast1.rep.googleapis.com/", + "location": "northamerica-northeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.northamerica-northeast2.rep.googleapis.com/", + "location": "northamerica-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.northamerica-south1.rep.googleapis.com/", + "location": "northamerica-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.southamerica-east1.rep.googleapis.com/", + "location": "southamerica-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.southamerica-west1.rep.googleapis.com/", + "location": "southamerica-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-east1.rep.googleapis.com/", + "location": "us-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-east4.rep.googleapis.com/", + "location": "us-east4" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-east5.rep.googleapis.com/", + "location": "us-east5" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-east7.rep.googleapis.com/", + "location": "us-east7" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-south1.rep.googleapis.com/", + "location": "us-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-west1.rep.googleapis.com/", + "location": "us-west1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-west2.rep.googleapis.com/", + "location": "us-west2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-west3.rep.googleapis.com/", + "location": "us-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://netapp.us-west4.rep.googleapis.com/", + "location": "us-west4" + } + ], "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -2326,7 +2538,7 @@ } } }, - "revision": "20250908", + "revision": "20250917", "rootUrl": "https://netapp.googleapis.com/", "schemas": { "ActiveDirectory": { @@ -4020,7 +4232,7 @@ "type": "array" }, "restoreDestinationPath": { - "description": "Required. Absolute directory path in the destination volume.", + "description": "Optional. Absolute directory path in the destination volume.", "type": "string" } }, diff --git a/netapp/v1beta1/netapp-gen.go b/netapp/v1beta1/netapp-gen.go index 2a59242c265..f9349755a26 100644 --- a/netapp/v1beta1/netapp-gen.go +++ b/netapp/v1beta1/netapp-gen.go @@ -1974,7 +1974,7 @@ type RestoreBackupFilesRequest struct { // FileList: Required. List of files to be restored in the form of their // absolute path as in source volume. FileList []string `json:"fileList,omitempty"` - // RestoreDestinationPath: Required. Absolute directory path in the destination + // RestoreDestinationPath: Optional. Absolute directory path in the destination // volume. RestoreDestinationPath string `json:"restoreDestinationPath,omitempty"` // ForceSendFields is a list of field names (e.g. "Backup") to unconditionally diff --git a/networkconnectivity/v1/networkconnectivity-api.json b/networkconnectivity/v1/networkconnectivity-api.json index 6e3495b1304..403d2c5c691 100644 --- a/networkconnectivity/v1/networkconnectivity-api.json +++ b/networkconnectivity/v1/networkconnectivity-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -2269,7 +2269,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. Name of the resource.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/remoteTransportProfiles/[^/]+$", "required": true, @@ -2294,12 +2294,12 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filtering results.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Hint for how to order the results.", "location": "query", "type": "string" }, @@ -2315,7 +2315,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent value for ListRemoteTransportProfilesRequest", + "description": "Required. Parent value for ListRemoteTransportProfilesRequest.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3626,7 +3626,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. Name of the resource.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/transports/[^/]+$", "required": true, @@ -3656,7 +3656,7 @@ ], "parameters": { "name": { - "description": "Required. Name of the resource", + "description": "Required. Name of the resource.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/transports/[^/]+$", "required": true, @@ -3681,12 +3681,12 @@ ], "parameters": { "filter": { - "description": "Optional. Filtering results", + "description": "Optional. Filtering results.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. Hint for how to order the results", + "description": "Optional. Hint for how to order the results.", "location": "query", "type": "string" }, @@ -3702,7 +3702,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent value for ListTransportsRequest", + "description": "Required. Parent value for ListTransportsRequest.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -3727,7 +3727,7 @@ ], "parameters": { "name": { - "description": "Identifier. name of resource", + "description": "Identifier. Name of the resource, see google.aip.dev/122 for resource naming.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/transports/[^/]+$", "required": true, @@ -3763,7 +3763,7 @@ } } }, - "revision": "20250829", + "revision": "20250910", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AcceptHubSpokeRequest": { @@ -5202,7 +5202,7 @@ "type": "string" }, "remoteTransportProfiles": { - "description": "The list of RemoteTransportProfiles", + "description": "The list of RemoteTransportProfiles.", "items": { "$ref": "RemoteTransportProfile" }, @@ -5394,7 +5394,7 @@ "type": "object" }, "ListTransportsResponse": { - "description": "Message for response to listing Transports", + "description": "Message for response to listing Transports.", "id": "ListTransportsResponse", "properties": { "nextPageToken": { @@ -5402,7 +5402,7 @@ "type": "string" }, "transports": { - "description": "The list of Transport", + "description": "The list of Transport.", "items": { "$ref": "Transport" }, @@ -6182,28 +6182,130 @@ "type": "object" }, "RemoteTransportProfile": { - "description": "Message describing RemoteTransportProfile object", + "description": "Message describing RemoteTransportProfile object.", "id": "RemoteTransportProfile", "properties": { "createTime": { - "description": "Output only. [Output only] Create time stamp", + "description": "Output only. [Output only] Create time stamp.", "format": "google-datetime", "readOnly": true, "type": "string" }, + "description": { + "description": "Output only. Description of the profile.", + "readOnly": true, + "type": "string" + }, + "flow": { + "description": "Output only. [Output only] Type of provisioning flows supported by this profile.", + "enum": [ + "KEY_PROVISIONING_FLOW_UNSPECIFIED", + "INPUT_ONLY", + "OUTPUT_ONLY", + "INPUT_OR_OUTPUT" + ], + "enumDescriptions": [ + "Unspecified key provisioning flow.", + "The activationKey field on the Transport must be included in a create or patch request to establish connectivity.", + "The generatedActivationKey field is populated and must be read from the resource and passed into the other provider.", + "Both activation key fields are allowed for establishing connectivity. If a key is input, the generated key is still present after provisioning is finished." + ], + "readOnly": true, + "type": "string" + }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Optional. Labels as key value pairs", + "description": "Output only. Labels as key value pairs.", + "readOnly": true, "type": "object" }, "name": { - "description": "Identifier. name of resource", + "description": "Identifier. Name of the resource in the format of $provider-$site.", "type": "string" }, + "orderState": { + "description": "Output only. [Output only] Order state for this profile.", + "enum": [ + "STATE_UNSPECIFIED", + "CLOSED", + "OPEN" + ], + "enumDescriptions": [ + "Unspecified state.", + "Not enough capacity for customers to order.", + "Enough capacity to fulfill an order." + ], + "readOnly": true, + "type": "string" + }, + "provider": { + "description": "Output only. Name of the provider on the other end of this profile. E.g. “Amazon Web Services” or “Microsoft Azure”.", + "readOnly": true, + "type": "string" + }, + "providerSite": { + "description": "Output only. If the profile is a Cloud Service Provider with compute resources, this is populated with the region where connectivity is being established. If the profile provides facility-level selection, this is an identity of the facility any connections on this profile are going through.", + "readOnly": true, + "type": "string" + }, + "region": { + "description": "Output only. GCP Region where this profile is available.", + "readOnly": true, + "type": "string" + }, + "sla": { + "description": "Output only. [Output only] Availability class that will be configured for this particular RemoteTransportProfile.", + "enum": [ + "SERVICE_LEVEL_AVAILABILITY_UNSPECIFIED", + "HIGH", + "MAXIMUM" + ], + "enumDescriptions": [ + "Unspecified service level availability.", + "This represents a 99.9% service level on the availability of the configured connectivity.", + "This represents a 99.99% service level on the availability of the configured connectivity." + ], + "readOnly": true, + "type": "string" + }, + "supportedBandwidths": { + "description": "Output only. List of bandwidth enum values that are supported by this profile.", + "items": { + "enum": [ + "BANDWIDTH_UNSPECIFIED", + "BPS_50M", + "BPS_100M", + "BPS_200M", + "BPS_300M", + "BPS_400M", + "BPS_500M", + "BPS_1G", + "BPS_2G", + "BPS_5G", + "BPS_10G" + ], + "enumDescriptions": [ + "Unspecified bandwidth.", + "50 Megabits per second.", + "100 Megabits per second.", + "200 Megabits per second.", + "300 Megabits per second.", + "400 Megabits per second.", + "500 Megabits per second.", + "1 Gigabit per second.", + "2 Gigabits per second.", + "5 Gigabits per second.", + "10 Gigabits per second." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + }, "updateTime": { - "description": "Output only. [Output only] Update time stamp", + "description": "Output only. [Output only] Update time stamp.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -7135,28 +7237,130 @@ "type": "object" }, "Transport": { - "description": "Message describing Transport object", + "description": "Message describing Transport object.", "id": "Transport", "properties": { + "adminEnabled": { + "description": "Optional. Administrative state of the underlying connectivity. If set to true (default), connectivity should be available between your environments. If set to false, the connectivity over these links is disabled. Disabling your Transport does not affect billing, and retains the underlying network bandwidth associated with the connectivity.", + "type": "boolean" + }, + "advertisedRoutes": { + "description": "Optional. [Preview only] List of IP Prefixes that will be advertised to the remote provider. Both IPv4 and IPv6 addresses are supported.", + "type": "string" + }, + "bandwidth": { + "description": "Required. Bandwidth of the Transport. This must be one of the supported bandwidths for the remote profile.", + "enum": [ + "BANDWIDTH_UNSPECIFIED", + "BPS_50M", + "BPS_100M", + "BPS_200M", + "BPS_300M", + "BPS_400M", + "BPS_500M", + "BPS_1G", + "BPS_2G", + "BPS_5G", + "BPS_10G" + ], + "enumDescriptions": [ + "Unspecified bandwidth.", + "50 Megabits per second.", + "100 Megabits per second.", + "200 Megabits per second.", + "300 Megabits per second.", + "400 Megabits per second.", + "500 Megabits per second.", + "1 Gigabit per second.", + "2 Gigabits per second.", + "5 Gigabits per second.", + "10 Gigabits per second." + ], + "type": "string" + }, "createTime": { - "description": "Output only. [Output only] Create time stamp", + "description": "Output only. [Output only] Create time stamp.", "format": "google-datetime", "readOnly": true, "type": "string" }, + "description": { + "description": "Optional. Description of the Transport.", + "type": "string" + }, + "generatedActivationKey": { + "description": "Output only. [Output only] Google-generated activation key. This is only output if the selected profile supports an OUTPUT key flow. Inputting this to the provider is only valid while the resource is in a PENDING_KEY state. Once the provider has accepted the key, the resource will move to the CONFIGURING state.", + "readOnly": true, + "type": "string" + }, "labels": { "additionalProperties": { "type": "string" }, - "description": "Optional. Labels as key value pairs", + "description": "Optional. Labels as key value pairs.", "type": "object" }, + "mtuLimit": { + "description": "Output only. [Output only] The maximum transmission unit (MTU) of a packet that can be sent over this transport.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, "name": { - "description": "Identifier. name of resource", + "description": "Identifier. Name of the resource, see google.aip.dev/122 for resource naming.", + "type": "string" + }, + "network": { + "description": "Required. [Preview only] Resource URL of the Network that will be peered with this Transport. This field must be provided during resource creation and cannot be changed.", + "type": "string" + }, + "providedActivationKey": { + "description": "Optional. Key used for establishing a connection with the remote transport. This key can only be provided if the profile supports an INPUT key flow and the resource is in the PENDING_KEY state.", + "type": "string" + }, + "region": { + "description": "Required. GCP Region where this Transport is located.", + "type": "string" + }, + "remoteProfile": { + "description": "Required. Resource URL of the remoteTransportProfile that this Transport is connecting to. Format: projects/{project}/locations/{location}/remoteTransportProfiles/{remote_transport_profile}", + "type": "string" + }, + "stackType": { + "description": "Optional. IP version stack for the established connectivity.", + "enum": [ + "STACK_TYPE_UNSPECIFIED", + "IPV4_ONLY", + "IPV4_IPV6" + ], + "enumDescriptions": [ + "Unspecified stack type.", + "Only IPv4 is supported. (default)", + "Both IPv4 and IPv6 are supported." + ], + "type": "string" + }, + "state": { + "description": "Output only. [Output only] State of the underlying connectivity.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "PENDING_CONFIG", + "PENDING_KEY", + "ACTIVE" + ], + "enumDescriptions": [ + "Unspecified state.", + "The resource exists locally and is being created / associated with the resource on the remote provider’s end of the underlying connectivity.", + "The Transport exists on both sides of the connection, and is waiting for configuration to finalize and be verified as operational.", + "The Transport was created in GCP. Depending on the profile’s key provisioning flow, this is either waiting for an activation key to be input (the key will be validated that it uses remote resources that match the Transport), or for the generated key to be input to the provider for finalizing. The configured bandwidth is not yet guaranteed.", + "The Transport is configured and the underlying connectivity is considered operational." + ], + "readOnly": true, "type": "string" }, "updateTime": { - "description": "Output only. [Output only] Update time stamp", + "description": "Output only. [Output only] Update time stamp.", "format": "google-datetime", "readOnly": true, "type": "string" diff --git a/networkconnectivity/v1/networkconnectivity-gen.go b/networkconnectivity/v1/networkconnectivity-gen.go index 26f985a5d97..1ae68ede493 100644 --- a/networkconnectivity/v1/networkconnectivity-gen.go +++ b/networkconnectivity/v1/networkconnectivity-gen.go @@ -2166,7 +2166,7 @@ type ListRemoteTransportProfilesResponse struct { // NextPageToken: A token identifying a page of results the server should // return. NextPageToken string `json:"nextPageToken,omitempty"` - // RemoteTransportProfiles: The list of RemoteTransportProfiles + // RemoteTransportProfiles: The list of RemoteTransportProfiles. RemoteTransportProfiles []*RemoteTransportProfile `json:"remoteTransportProfiles,omitempty"` // Unreachable: Unordered list. Locations that could not be reached. Unreachable []string `json:"unreachable,omitempty"` @@ -2410,12 +2410,12 @@ func (s ListSpokesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListTransportsResponse: Message for response to listing Transports +// ListTransportsResponse: Message for response to listing Transports. type ListTransportsResponse struct { // NextPageToken: A token identifying a page of results the server should // return. NextPageToken string `json:"nextPageToken,omitempty"` - // Transports: The list of Transport + // Transports: The list of Transport. Transports []*Transport `json:"transports,omitempty"` // Unreachable: Unordered list. Locations that could not be reached. Unreachable []string `json:"unreachable,omitempty"` @@ -3400,15 +3400,75 @@ func (s RejectSpokeUpdateRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// RemoteTransportProfile: Message describing RemoteTransportProfile object +// RemoteTransportProfile: Message describing RemoteTransportProfile object. type RemoteTransportProfile struct { - // CreateTime: Output only. [Output only] Create time stamp + // CreateTime: Output only. [Output only] Create time stamp. CreateTime string `json:"createTime,omitempty"` - // Labels: Optional. Labels as key value pairs + // Description: Output only. Description of the profile. + Description string `json:"description,omitempty"` + // Flow: Output only. [Output only] Type of provisioning flows supported by + // this profile. + // + // Possible values: + // "KEY_PROVISIONING_FLOW_UNSPECIFIED" - Unspecified key provisioning flow. + // "INPUT_ONLY" - The activationKey field on the Transport must be included + // in a create or patch request to establish connectivity. + // "OUTPUT_ONLY" - The generatedActivationKey field is populated and must be + // read from the resource and passed into the other provider. + // "INPUT_OR_OUTPUT" - Both activation key fields are allowed for + // establishing connectivity. If a key is input, the generated key is still + // present after provisioning is finished. + Flow string `json:"flow,omitempty"` + // Labels: Output only. Labels as key value pairs. Labels map[string]string `json:"labels,omitempty"` - // Name: Identifier. name of resource + // Name: Identifier. Name of the resource in the format of $provider-$site. Name string `json:"name,omitempty"` - // UpdateTime: Output only. [Output only] Update time stamp + // OrderState: Output only. [Output only] Order state for this profile. + // + // Possible values: + // "STATE_UNSPECIFIED" - Unspecified state. + // "CLOSED" - Not enough capacity for customers to order. + // "OPEN" - Enough capacity to fulfill an order. + OrderState string `json:"orderState,omitempty"` + // Provider: Output only. Name of the provider on the other end of this + // profile. E.g. “Amazon Web Services” or “Microsoft Azure”. + Provider string `json:"provider,omitempty"` + // ProviderSite: Output only. If the profile is a Cloud Service Provider with + // compute resources, this is populated with the region where connectivity is + // being established. If the profile provides facility-level selection, this is + // an identity of the facility any connections on this profile are going + // through. + ProviderSite string `json:"providerSite,omitempty"` + // Region: Output only. GCP Region where this profile is available. + Region string `json:"region,omitempty"` + // Sla: Output only. [Output only] Availability class that will be configured + // for this particular RemoteTransportProfile. + // + // Possible values: + // "SERVICE_LEVEL_AVAILABILITY_UNSPECIFIED" - Unspecified service level + // availability. + // "HIGH" - This represents a 99.9% service level on the availability of the + // configured connectivity. + // "MAXIMUM" - This represents a 99.99% service level on the availability of + // the configured connectivity. + Sla string `json:"sla,omitempty"` + // SupportedBandwidths: Output only. List of bandwidth enum values that are + // supported by this profile. + // + // Possible values: + // "BANDWIDTH_UNSPECIFIED" - Unspecified bandwidth. + // "BPS_50M" - 50 Megabits per second. + // "BPS_100M" - 100 Megabits per second. + // "BPS_200M" - 200 Megabits per second. + // "BPS_300M" - 300 Megabits per second. + // "BPS_400M" - 400 Megabits per second. + // "BPS_500M" - 500 Megabits per second. + // "BPS_1G" - 1 Gigabit per second. + // "BPS_2G" - 2 Gigabits per second. + // "BPS_5G" - 5 Gigabits per second. + // "BPS_10G" - 10 Gigabits per second. + SupportedBandwidths []string `json:"supportedBandwidths,omitempty"` + // UpdateTime: Output only. [Output only] Update time stamp. UpdateTime string `json:"updateTime,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -4333,26 +4393,103 @@ func (s TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Transport: Message describing Transport object +// Transport: Message describing Transport object. type Transport struct { - // CreateTime: Output only. [Output only] Create time stamp + // AdminEnabled: Optional. Administrative state of the underlying connectivity. + // If set to true (default), connectivity should be available between your + // environments. If set to false, the connectivity over these links is + // disabled. Disabling your Transport does not affect billing, and retains the + // underlying network bandwidth associated with the connectivity. + AdminEnabled bool `json:"adminEnabled,omitempty"` + // AdvertisedRoutes: Optional. [Preview only] List of IP Prefixes that will be + // advertised to the remote provider. Both IPv4 and IPv6 addresses are + // supported. + AdvertisedRoutes string `json:"advertisedRoutes,omitempty"` + // Bandwidth: Required. Bandwidth of the Transport. This must be one of the + // supported bandwidths for the remote profile. + // + // Possible values: + // "BANDWIDTH_UNSPECIFIED" - Unspecified bandwidth. + // "BPS_50M" - 50 Megabits per second. + // "BPS_100M" - 100 Megabits per second. + // "BPS_200M" - 200 Megabits per second. + // "BPS_300M" - 300 Megabits per second. + // "BPS_400M" - 400 Megabits per second. + // "BPS_500M" - 500 Megabits per second. + // "BPS_1G" - 1 Gigabit per second. + // "BPS_2G" - 2 Gigabits per second. + // "BPS_5G" - 5 Gigabits per second. + // "BPS_10G" - 10 Gigabits per second. + Bandwidth string `json:"bandwidth,omitempty"` + // CreateTime: Output only. [Output only] Create time stamp. CreateTime string `json:"createTime,omitempty"` - // Labels: Optional. Labels as key value pairs + // Description: Optional. Description of the Transport. + Description string `json:"description,omitempty"` + // GeneratedActivationKey: Output only. [Output only] Google-generated + // activation key. This is only output if the selected profile supports an + // OUTPUT key flow. Inputting this to the provider is only valid while the + // resource is in a PENDING_KEY state. Once the provider has accepted the key, + // the resource will move to the CONFIGURING state. + GeneratedActivationKey string `json:"generatedActivationKey,omitempty"` + // Labels: Optional. Labels as key value pairs. Labels map[string]string `json:"labels,omitempty"` - // Name: Identifier. name of resource + // MtuLimit: Output only. [Output only] The maximum transmission unit (MTU) of + // a packet that can be sent over this transport. + MtuLimit int64 `json:"mtuLimit,omitempty"` + // Name: Identifier. Name of the resource, see google.aip.dev/122 for resource + // naming. Name string `json:"name,omitempty"` - // UpdateTime: Output only. [Output only] Update time stamp + // Network: Required. [Preview only] Resource URL of the Network that will be + // peered with this Transport. This field must be provided during resource + // creation and cannot be changed. + Network string `json:"network,omitempty"` + // ProvidedActivationKey: Optional. Key used for establishing a connection with + // the remote transport. This key can only be provided if the profile supports + // an INPUT key flow and the resource is in the PENDING_KEY state. + ProvidedActivationKey string `json:"providedActivationKey,omitempty"` + // Region: Required. GCP Region where this Transport is located. + Region string `json:"region,omitempty"` + // RemoteProfile: Required. Resource URL of the remoteTransportProfile that + // this Transport is connecting to. Format: + // projects/{project}/locations/{location}/remoteTransportProfiles/{remote_trans + // port_profile} + RemoteProfile string `json:"remoteProfile,omitempty"` + // StackType: Optional. IP version stack for the established connectivity. + // + // Possible values: + // "STACK_TYPE_UNSPECIFIED" - Unspecified stack type. + // "IPV4_ONLY" - Only IPv4 is supported. (default) + // "IPV4_IPV6" - Both IPv4 and IPv6 are supported. + StackType string `json:"stackType,omitempty"` + // State: Output only. [Output only] State of the underlying connectivity. + // + // Possible values: + // "STATE_UNSPECIFIED" - Unspecified state. + // "CREATING" - The resource exists locally and is being created / associated + // with the resource on the remote provider’s end of the underlying + // connectivity. + // "PENDING_CONFIG" - The Transport exists on both sides of the connection, + // and is waiting for configuration to finalize and be verified as operational. + // "PENDING_KEY" - The Transport was created in GCP. Depending on the + // profile’s key provisioning flow, this is either waiting for an activation + // key to be input (the key will be validated that it uses remote resources + // that match the Transport), or for the generated key to be input to the + // provider for finalizing. The configured bandwidth is not yet guaranteed. + // "ACTIVE" - The Transport is configured and the underlying connectivity is + // considered operational. + State string `json:"state,omitempty"` + // UpdateTime: Output only. [Output only] Update time stamp. 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 + // ForceSendFields is a list of field names (e.g. "AdminEnabled") 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 + // NullFields is a list of field names (e.g. "AdminEnabled") 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. @@ -4555,9 +4692,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c @@ -12316,14 +12453,14 @@ func (r *ProjectsLocationsRemoteTransportProfilesService) List(parent string) *P return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filtering results. func (c *ProjectsLocationsRemoteTransportProfilesListCall) Filter(filter string) *ProjectsLocationsRemoteTransportProfilesListCall { c.urlParams_.Set("filter", filter) return c } // OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// results. func (c *ProjectsLocationsRemoteTransportProfilesListCall) OrderBy(orderBy string) *ProjectsLocationsRemoteTransportProfilesListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -17267,14 +17404,14 @@ func (r *ProjectsLocationsTransportsService) List(parent string) *ProjectsLocati return c } -// Filter sets the optional parameter "filter": Filtering results +// Filter sets the optional parameter "filter": Filtering results. func (c *ProjectsLocationsTransportsListCall) Filter(filter string) *ProjectsLocationsTransportsListCall { c.urlParams_.Set("filter", filter) return c } // OrderBy sets the optional parameter "orderBy": Hint for how to order the -// results +// results. func (c *ProjectsLocationsTransportsListCall) OrderBy(orderBy string) *ProjectsLocationsTransportsListCall { c.urlParams_.Set("orderBy", orderBy) return c @@ -17419,7 +17556,8 @@ type ProjectsLocationsTransportsPatchCall struct { // Patch: Updates the parameters of a single Transport. // -// - name: Identifier. name of resource. +// - name: Identifier. Name of the resource, see google.aip.dev/122 for +// resource naming. func (r *ProjectsLocationsTransportsService) Patch(name string, transport *Transport) *ProjectsLocationsTransportsPatchCall { c := &ProjectsLocationsTransportsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/networkconnectivity/v1alpha1/networkconnectivity-api.json b/networkconnectivity/v1alpha1/networkconnectivity-api.json index 9c2bf53316d..598ee2b6a36 100644 --- a/networkconnectivity/v1alpha1/networkconnectivity-api.json +++ b/networkconnectivity/v1alpha1/networkconnectivity-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1122,7 +1122,7 @@ } } }, - "revision": "20250815", + "revision": "20250910", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AllocationOptions": { diff --git a/networkconnectivity/v1alpha1/networkconnectivity-gen.go b/networkconnectivity/v1alpha1/networkconnectivity-gen.go index 44fb133c74c..b887fb727f1 100644 --- a/networkconnectivity/v1alpha1/networkconnectivity-gen.go +++ b/networkconnectivity/v1alpha1/networkconnectivity-gen.go @@ -1437,9 +1437,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/networksecurity/v1/networksecurity-api.json b/networksecurity/v1/networksecurity-api.json index 75c77c2163a..86dda20e3c0 100644 --- a/networksecurity/v1/networksecurity-api.json +++ b/networksecurity/v1/networksecurity-api.json @@ -1078,7 +1078,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -5070,7 +5070,7 @@ } } }, - "revision": "20250822", + "revision": "20250911", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -5394,7 +5394,7 @@ "type": "array" }, "principals": { - "description": "Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.", + "description": "Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 50 principals per Authorization Policy for regional internal Application Load Balancers, regional external Application Load Balancers, cross-region internal Application Load Balancers, and Cloud Service Mesh. This field is not supported for global external Application Load Balancers.", "items": { "$ref": "AuthzPolicyAuthzRulePrincipal" }, @@ -5461,7 +5461,7 @@ "Unspecified principal selector. It will be treated as CLIENT_CERT_URI_SAN by default.", "The principal rule is matched against a list of URI SANs in the validated client's certificate. A match happens when there is any exact URI SAN value match. This is the default principal selector.", "The principal rule is matched against a list of DNS Name SANs in the validated client's certificate. A match happens when there is any exact DNS Name SAN value match. This is only applicable for Application Load Balancers except for classic Global External Application load balancer. CLIENT_CERT_DNS_NAME_SAN is not supported for INTERNAL_SELF_MANAGED load balancing scheme.", - "The principal rule is matched against the common name in the client's certificate. Authorization against multiple common names in the client certificate is not supported. Requests with multiple common names in the client certificate will be rejected if CLIENT_CERT_COMMON_NAME is set as the principal selector. A match happens when there is an exact common name value match. This is only applicable for Application Load Balancers except for classic Global External Application load balancer. CLIENT_CERT_COMMON_NAME is not supported for INTERNAL_SELF_MANAGED load balancing scheme." + "The principal rule is matched against the common name in the client's certificate. Authorization against multiple common names in the client certificate is not supported. Requests with multiple common names in the client certificate will be rejected if CLIENT_CERT_COMMON_NAME is set as the principal selector. A match happens when there is an exact common name value match. This is only applicable for Application Load Balancers except for global external Application Load Balancer and classic Application Load Balancer. CLIENT_CERT_COMMON_NAME is not supported for INTERNAL_SELF_MANAGED load balancing scheme." ], "type": "string" } diff --git a/networksecurity/v1/networksecurity-gen.go b/networksecurity/v1/networksecurity-gen.go index 463f25b4122..87d647ae615 100644 --- a/networksecurity/v1/networksecurity-gen.go +++ b/networksecurity/v1/networksecurity-gen.go @@ -835,10 +835,10 @@ type AuthzPolicyAuthzRuleFromRequestSource struct { // value is matched against a list of URI SANs, DNS Name SANs, or the common // name in the client's certificate. A match happens when any principal matches // with the rule. Limited to 50 principals per Authorization Policy for - // Regional Internal Application Load Balancer, Regional External Application - // Load Balancer, Cross-region Internal Application Load Balancer, and Cloud - // Service Mesh. Limited to 25 principals per Authorization Policy for Global - // External Application Load Balancer. + // regional internal Application Load Balancers, regional external Application + // Load Balancers, cross-region internal Application Load Balancers, and Cloud + // Service Mesh. This field is not supported for global external Application + // Load Balancers. Principals []*AuthzPolicyAuthzRulePrincipal `json:"principals,omitempty"` // Resources: Optional. A list of resources to match against the resource of // the source VM of a request. Limited to 10 resources per Authorization @@ -941,9 +941,9 @@ type AuthzPolicyAuthzRulePrincipal struct { // multiple common names in the client certificate will be rejected if // CLIENT_CERT_COMMON_NAME is set as the principal selector. A match happens // when there is an exact common name value match. This is only applicable for - // Application Load Balancers except for classic Global External Application - // load balancer. CLIENT_CERT_COMMON_NAME is not supported for - // INTERNAL_SELF_MANAGED load balancing scheme. + // Application Load Balancers except for global external Application Load + // Balancer and classic Application Load Balancer. CLIENT_CERT_COMMON_NAME is + // not supported for INTERNAL_SELF_MANAGED load balancing scheme. PrincipalSelector string `json:"principalSelector,omitempty"` // ForceSendFields is a list of field names (e.g. "Principal") to // unconditionally include in API requests. By default, fields with empty or @@ -8455,9 +8455,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/networksecurity/v1beta1/networksecurity-api.json b/networksecurity/v1beta1/networksecurity-api.json index c8782752531..0b184638888 100644 --- a/networksecurity/v1beta1/networksecurity-api.json +++ b/networksecurity/v1beta1/networksecurity-api.json @@ -1078,7 +1078,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -5513,7 +5513,7 @@ } } }, - "revision": "20250903", + "revision": "20250911", "rootUrl": "https://networksecurity.googleapis.com/", "schemas": { "AddAddressGroupItemsRequest": { @@ -5837,7 +5837,7 @@ "type": "array" }, "principals": { - "description": "Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 50 principals per Authorization Policy for Regional Internal Application Load Balancer, Regional External Application Load Balancer, Cross-region Internal Application Load Balancer, and Cloud Service Mesh. Limited to 25 principals per Authorization Policy for Global External Application Load Balancer.", + "description": "Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 50 principals per Authorization Policy for regional internal Application Load Balancers, regional external Application Load Balancers, cross-region internal Application Load Balancers, and Cloud Service Mesh. This field is not supported for global external Application Load Balancers.", "items": { "$ref": "AuthzPolicyAuthzRulePrincipal" }, @@ -5904,7 +5904,7 @@ "Unspecified principal selector. It will be treated as CLIENT_CERT_URI_SAN by default.", "The principal rule is matched against a list of URI SANs in the validated client's certificate. A match happens when there is any exact URI SAN value match. This is the default principal selector.", "The principal rule is matched against a list of DNS Name SANs in the validated client's certificate. A match happens when there is any exact DNS Name SAN value match. This is only applicable for Application Load Balancers except for classic Global External Application load balancer. CLIENT_CERT_DNS_NAME_SAN is not supported for INTERNAL_SELF_MANAGED load balancing scheme.", - "The principal rule is matched against the common name in the client's certificate. Authorization against multiple common names in the client certificate is not supported. Requests with multiple common names in the client certificate will be rejected if CLIENT_CERT_COMMON_NAME is set as the principal selector. A match happens when there is an exact common name value match. This is only applicable for Application Load Balancers except for classic Global External Application load balancer. CLIENT_CERT_COMMON_NAME is not supported for INTERNAL_SELF_MANAGED load balancing scheme." + "The principal rule is matched against the common name in the client's certificate. Authorization against multiple common names in the client certificate is not supported. Requests with multiple common names in the client certificate will be rejected if CLIENT_CERT_COMMON_NAME is set as the principal selector. A match happens when there is an exact common name value match. This is only applicable for Application Load Balancers except for global external Application Load Balancer and classic Application Load Balancer. CLIENT_CERT_COMMON_NAME is not supported for INTERNAL_SELF_MANAGED load balancing scheme." ], "type": "string" } @@ -8282,6 +8282,18 @@ "readOnly": true, "type": "string" }, + "type": { + "description": "Immutable. The type of the endpoint group. If left unspecified, defaults to DIRECT.", + "enum": [ + "TYPE_UNSPECIFIED", + "DIRECT" + ], + "enumDescriptions": [ + "Not set.", + "An endpoint group that sends packets to a single deployment group." + ], + "type": "string" + }, "updateTime": { "description": "Output only. The timestamp when the resource was most recently updated. See https://google.aip.dev/148#timestamps.", "format": "google-datetime", diff --git a/networksecurity/v1beta1/networksecurity-gen.go b/networksecurity/v1beta1/networksecurity-gen.go index 04f7843f9ba..8af122e44a8 100644 --- a/networksecurity/v1beta1/networksecurity-gen.go +++ b/networksecurity/v1beta1/networksecurity-gen.go @@ -871,10 +871,10 @@ type AuthzPolicyAuthzRuleFromRequestSource struct { // value is matched against a list of URI SANs, DNS Name SANs, or the common // name in the client's certificate. A match happens when any principal matches // with the rule. Limited to 50 principals per Authorization Policy for - // Regional Internal Application Load Balancer, Regional External Application - // Load Balancer, Cross-region Internal Application Load Balancer, and Cloud - // Service Mesh. Limited to 25 principals per Authorization Policy for Global - // External Application Load Balancer. + // regional internal Application Load Balancers, regional external Application + // Load Balancers, cross-region internal Application Load Balancers, and Cloud + // Service Mesh. This field is not supported for global external Application + // Load Balancers. Principals []*AuthzPolicyAuthzRulePrincipal `json:"principals,omitempty"` // Resources: Optional. A list of resources to match against the resource of // the source VM of a request. Limited to 10 resources per Authorization @@ -977,9 +977,9 @@ type AuthzPolicyAuthzRulePrincipal struct { // multiple common names in the client certificate will be rejected if // CLIENT_CERT_COMMON_NAME is set as the principal selector. A match happens // when there is an exact common name value match. This is only applicable for - // Application Load Balancers except for classic Global External Application - // load balancer. CLIENT_CERT_COMMON_NAME is not supported for - // INTERNAL_SELF_MANAGED load balancing scheme. + // Application Load Balancers except for global external Application Load + // Balancer and classic Application Load Balancer. CLIENT_CERT_COMMON_NAME is + // not supported for INTERNAL_SELF_MANAGED load balancing scheme. PrincipalSelector string `json:"principalSelector,omitempty"` // ForceSendFields is a list of field names (e.g. "Principal") to // unconditionally include in API requests. By default, fields with empty or @@ -4143,6 +4143,14 @@ type MirroringEndpointGroup struct { // is a terminal state and the endpoint group is not expected to recover. The // only permitted operation is to retry deleting the endpoint group. State string `json:"state,omitempty"` + // Type: Immutable. The type of the endpoint group. If left unspecified, + // defaults to DIRECT. + // + // Possible values: + // "TYPE_UNSPECIFIED" - Not set. + // "DIRECT" - An endpoint group that sends packets to a single deployment + // group. + Type string `json:"type,omitempty"` // UpdateTime: Output only. The timestamp when the resource was most recently // updated. See https://google.aip.dev/148#timestamps. UpdateTime string `json:"updateTime,omitempty"` @@ -8903,9 +8911,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/oracledatabase/v1/oracledatabase-api.json b/oracledatabase/v1/oracledatabase-api.json index 6d1945e0717..fa23c35ecc7 100644 --- a/oracledatabase/v1/oracledatabase-api.json +++ b/oracledatabase/v1/oracledatabase-api.json @@ -343,6 +343,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "failover": { + "description": "Initiates a failover to target autonomous database from the associated primary database.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/autonomousDatabases/{autonomousDatabasesId}:failover", + "httpMethod": "POST", + "id": "oracledatabase.projects.locations.autonomousDatabases.failover", + "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}:failover", + "request": { + "$ref": "FailoverAutonomousDatabaseRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "generateWallet": { "description": "Generates a wallet for an Autonomous Database.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/autonomousDatabases/{autonomousDatabasesId}:generateWallet", @@ -1427,24 +1455,122 @@ } } }, - "giVersions": { + "exadbVmClusters": { "methods": { + "create": { + "description": "Creates a new Exadb (Exascale) VM Cluster resource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exadbVmClusters", + "httpMethod": "POST", + "id": "oracledatabase.projects.locations.exadbVmClusters.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "exadbVmClusterId": { + "description": "Required. The ID of the ExadbVmCluster to create. This value is restricted to (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$) and must be a maximum of 63 characters in length. The value must start with a letter and end with a letter or a number.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The value for parent of the ExadbVmCluster in the following format: 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 so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/exadbVmClusters", + "request": { + "$ref": "ExadbVmCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single Exadb (Exascale) VM Cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exadbVmClusters/{exadbVmClustersId}", + "httpMethod": "DELETE", + "id": "oracledatabase.projects.locations.exadbVmClusters.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the ExadbVmCluster in the following format: projects/{project}/locations/{location}/exadbVmClusters/{exadb_vm_cluster}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/exadbVmClusters/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single Exadb (Exascale) VM Cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exadbVmClusters/{exadbVmClustersId}", + "httpMethod": "GET", + "id": "oracledatabase.projects.locations.exadbVmClusters.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the ExadbVmCluster in the following format: projects/{project}/locations/{location}/exadbVmClusters/{exadb_vm_cluster}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/exadbVmClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "ExadbVmCluster" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "list": { - "description": "Lists all the valid Oracle Grid Infrastructure (GI) versions for the given project and location.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/giVersions", + "description": "Lists all the Exadb (Exascale) VM Clusters for the given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exadbVmClusters", "httpMethod": "GET", - "id": "oracledatabase.projects.locations.giVersions.list", + "id": "oracledatabase.projects.locations.exadbVmClusters.list", "parameterOrder": [ "parent" ], "parameters": { "filter": { - "description": "Optional. An expression for filtering the results of the request. Only the shape, gcp_oracle_zone and gi_version fields are supported in this format: `shape=\"{shape}\"`.", + "description": "Optional. An expression for filtering the results of the request.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. An expression for ordering the results of the request.", "location": "query", "type": "string" }, "pageSize": { - "description": "Optional. The maximum number of items to return. If unspecified, a maximum of 50 Oracle Grid Infrastructure (GI) versions will be returned. The maximum value is 1000; values above 1000 will be reset to 1000.", + "description": "Optional. The maximum number of items to return. If unspecified, at most 50 ExadbVmClusters will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1455,16 +1581,83 @@ "type": "string" }, "parent": { - "description": "Required. The parent value for Grid Infrastructure Version in the following format: Format: projects/{project}/locations/{location}.", + "description": "Required. The parent value for ExadbVmClusters in the following format: projects/{project}/locations/{location}.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" } }, - "path": "v1/{+parent}/giVersions", + "path": "v1/{+parent}/exadbVmClusters", "response": { - "$ref": "ListGiVersionsResponse" + "$ref": "ListExadbVmClustersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates a single Exadb (Exascale) VM Cluster. To add virtual machines to existing exadb vm cluster, only pass the node count.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exadbVmClusters/{exadbVmClustersId}", + "httpMethod": "PATCH", + "id": "oracledatabase.projects.locations.exadbVmClusters.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The name of the ExadbVmCluster resource in the following format: projects/{project}/locations/{region}/exadbVmClusters/{exadb_vm_cluster}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/exadbVmClusters/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Optional. A mask specifying which fields in th VM Cluster should be updated. A field specified in the mask is overwritten. If a mask isn't provided then all the fields in the VM Cluster are overwritten.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "ExadbVmCluster" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "removeVirtualMachine": { + "description": "Removes virtual machines from an existing exadb vm cluster.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exadbVmClusters/{exadbVmClustersId}:removeVirtualMachine", + "httpMethod": "POST", + "id": "oracledatabase.projects.locations.exadbVmClusters.removeVirtualMachine", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the ExadbVmCluster in the following format: projects/{project}/locations/{location}/exadbVmClusters/{exadb_vm_cluster}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/exadbVmClusters/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:removeVirtualMachine", + "request": { + "$ref": "RemoveVirtualMachineExadbVmClusterRequest" + }, + "response": { + "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" @@ -1472,38 +1665,38 @@ } } }, - "odbNetworks": { + "exascaleDbStorageVaults": { "methods": { "create": { - "description": "Creates a new ODB Network in a given project and location.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks", + "description": "Creates a new ExascaleDB Storage Vault resource.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exascaleDbStorageVaults", "httpMethod": "POST", - "id": "oracledatabase.projects.locations.odbNetworks.create", + "id": "oracledatabase.projects.locations.exascaleDbStorageVaults.create", "parameterOrder": [ "parent" ], "parameters": { - "odbNetworkId": { - "description": "Required. The ID of the OdbNetwork to create. This value is restricted to (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$) and must be a maximum of 63 characters in length. The value must start with a letter and end with a letter or a number.", + "exascaleDbStorageVaultId": { + "description": "Required. The ID of the ExascaleDbStorageVault to create. This value is restricted to (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$) and must be a maximum of 63 characters in length. The value must start with a letter and end with a letter or a number.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The parent value for the OdbNetwork in the following format: projects/{project}/locations/{location}.", + "description": "Required. The value for parent of the ExascaleDbStorageVault in the following format: projects/{project}/locations/{location}.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" }, "requestId": { - "description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" } }, - "path": "v1/{+parent}/odbNetworks", + "path": "v1/{+parent}/exascaleDbStorageVaults", "request": { - "$ref": "OdbNetwork" + "$ref": "ExascaleDbStorageVault" }, "response": { "$ref": "Operation" @@ -1513,18 +1706,18 @@ ] }, "delete": { - "description": "Deletes a single ODB Network.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks/{odbNetworksId}", + "description": "Deletes a single ExascaleDB Storage Vault.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exascaleDbStorageVaults/{exascaleDbStorageVaultsId}", "httpMethod": "DELETE", - "id": "oracledatabase.projects.locations.odbNetworks.delete", + "id": "oracledatabase.projects.locations.exascaleDbStorageVaults.delete", "parameterOrder": [ "name" ], "parameters": { "name": { - "description": "Required. The name of the resource in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}.", + "description": "Required. The name of the ExascaleDbStorageVault in the following format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}.", "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/odbNetworks/[^/]+$", + "pattern": "^projects/[^/]+/locations/[^/]+/exascaleDbStorageVaults/[^/]+$", "required": true, "type": "string" }, @@ -1543,51 +1736,51 @@ ] }, "get": { - "description": "Gets details of a single ODB Network.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks/{odbNetworksId}", + "description": "Gets details of a single ExascaleDB Storage Vault.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exascaleDbStorageVaults/{exascaleDbStorageVaultsId}", "httpMethod": "GET", - "id": "oracledatabase.projects.locations.odbNetworks.get", + "id": "oracledatabase.projects.locations.exascaleDbStorageVaults.get", "parameterOrder": [ "name" ], "parameters": { "name": { - "description": "Required. The name of the OdbNetwork in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}.", + "description": "Required. The name of the ExascaleDbStorageVault in the following format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}.", "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/odbNetworks/[^/]+$", + "pattern": "^projects/[^/]+/locations/[^/]+/exascaleDbStorageVaults/[^/]+$", "required": true, "type": "string" } }, "path": "v1/{+name}", "response": { - "$ref": "OdbNetwork" + "$ref": "ExascaleDbStorageVault" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { - "description": "Lists the ODB Networks in a given project and location.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks", + "description": "Lists all the ExascaleDB Storage Vaults for the given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exascaleDbStorageVaults", "httpMethod": "GET", - "id": "oracledatabase.projects.locations.odbNetworks.list", + "id": "oracledatabase.projects.locations.exascaleDbStorageVaults.list", "parameterOrder": [ "parent" ], "parameters": { "filter": { - "description": "Optional. An expression for filtering the results of the request.", + "description": "Optional. An expression for filtering the results of the request. Filter the list as specified in https://google.aip.dev/160.", "location": "query", "type": "string" }, "orderBy": { - "description": "Optional. An expression for ordering the results of the request.", + "description": "Optional. An expression for ordering the results of the request. Order results as specified in https://google.aip.dev/132.", "location": "query", "type": "string" }, "pageSize": { - "description": "Optional. The maximum number of items to return. If unspecified, at most 50 ODB Networks will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "description": "Optional. The maximum number of items to return. If unspecified, at most 50 ExascaleDbStorageVaults will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query", "type": "integer" @@ -1598,16 +1791,61 @@ "type": "string" }, "parent": { - "description": "Required. The parent value for the ODB Network in the following format: projects/{project}/locations/{location}.", + "description": "Required. The parent value for ExascaleDbStorageVault in the following format: projects/{project}/locations/{location}.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" } }, - "path": "v1/{+parent}/odbNetworks", + "path": "v1/{+parent}/exascaleDbStorageVaults", "response": { - "$ref": "ListOdbNetworksResponse" + "$ref": "ListExascaleDbStorageVaultsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "giVersions": { + "methods": { + "list": { + "description": "Lists all the valid Oracle Grid Infrastructure (GI) versions for the given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/giVersions", + "httpMethod": "GET", + "id": "oracledatabase.projects.locations.giVersions.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. An expression for filtering the results of the request. Only the shape, gcp_oracle_zone and gi_version fields are supported in this format: `shape=\"{shape}\"`.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of items to return. If unspecified, a maximum of 50 Oracle Grid Infrastructure (GI) versions will be returned. The maximum value is 1000; values above 1000 will be reset to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent value for Grid Infrastructure Version in the following format: Format: projects/{project}/locations/{location}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/giVersions", + "response": { + "$ref": "ListGiVersionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" @@ -1615,24 +1853,214 @@ } }, "resources": { - "odbSubnets": { + "minorVersions": { "methods": { - "create": { - "description": "Creates a new ODB Subnet in a given ODB Network.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks/{odbNetworksId}/odbSubnets", - "httpMethod": "POST", - "id": "oracledatabase.projects.locations.odbNetworks.odbSubnets.create", + "list": { + "description": "Lists all the valid minor versions for the given project, location, gi version and shape family.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/giVersions/{giVersionsId}/minorVersions", + "httpMethod": "GET", + "id": "oracledatabase.projects.locations.giVersions.minorVersions.list", "parameterOrder": [ "parent" ], "parameters": { - "odbSubnetId": { - "description": "Required. The ID of the OdbSubnet to create. This value is restricted to (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$) and must be a maximum of 63 characters in length. The value must start with a letter and end with a letter or a number.", + "filter": { + "description": "Optional. An expression for filtering the results of the request. Only shapeFamily and gcp_oracle_zone_id are supported in this format: `shape_family=\"{shapeFamily}\" AND gcp_oracle_zone_id=\"{gcp_oracle_zone_id}\"`.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of items to return. If unspecified, a maximum of 50 System Versions will be returned. The maximum value is 1000; values above 1000 will be reset to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying the requested page of results to return. All fields except the filter should remain the same as in the request that provided this page token.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The parent value for the OdbSubnet in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}.", + "description": "Required. The parent value for the MinorVersion resource with the format: projects/{project}/locations/{location}/giVersions/{gi_version}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/giVersions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/minorVersions", + "response": { + "$ref": "ListMinorVersionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, + "odbNetworks": { + "methods": { + "create": { + "description": "Creates a new ODB Network in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks", + "httpMethod": "POST", + "id": "oracledatabase.projects.locations.odbNetworks.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "odbNetworkId": { + "description": "Required. The ID of the OdbNetwork to create. This value is restricted to (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$) and must be a maximum of 63 characters in length. The value must start with a letter and end with a letter or a number.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent value for the OdbNetwork in the following format: projects/{project}/locations/{location}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/odbNetworks", + "request": { + "$ref": "OdbNetwork" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single ODB Network.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks/{odbNetworksId}", + "httpMethod": "DELETE", + "id": "oracledatabase.projects.locations.odbNetworks.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the resource in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/odbNetworks/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single ODB Network.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks/{odbNetworksId}", + "httpMethod": "GET", + "id": "oracledatabase.projects.locations.odbNetworks.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the OdbNetwork in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/odbNetworks/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "OdbNetwork" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the ODB Networks in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks", + "httpMethod": "GET", + "id": "oracledatabase.projects.locations.odbNetworks.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. An expression for filtering the results of the request.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. An expression for ordering the results of the request.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of items to return. If unspecified, at most 50 ODB Networks will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results the server should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent value for the ODB Network in the following format: projects/{project}/locations/{location}.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/odbNetworks", + "response": { + "$ref": "ListOdbNetworksResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "odbSubnets": { + "methods": { + "create": { + "description": "Creates a new ODB Subnet in a given ODB Network.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks/{odbNetworksId}/odbSubnets", + "httpMethod": "POST", + "id": "oracledatabase.projects.locations.odbNetworks.odbSubnets.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "odbSubnetId": { + "description": "Required. The ID of the OdbSubnet to create. This value is restricted to (^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$) and must be a maximum of 63 characters in length. The value must start with a letter and end with a letter or a number.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent value for the OdbSubnet in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/odbNetworks/[^/]+$", "required": true, @@ -1958,7 +2386,7 @@ } } }, - "revision": "20250914", + "revision": "20250918", "rootUrl": "https://oracledatabase.googleapis.com/", "schemas": { "AllConnectionStrings": { @@ -3644,6 +4072,25 @@ }, "type": "object" }, + "DataCollectionOptionsCommon": { + "description": "Data collection options for diagnostics. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/datatypes/DataCollectionOptions", + "id": "DataCollectionOptionsCommon", + "properties": { + "isDiagnosticsEventsEnabled": { + "description": "Optional. Indicates whether to enable data collection for diagnostics.", + "type": "boolean" + }, + "isHealthMonitoringEnabled": { + "description": "Optional. Indicates whether to enable health monitoring.", + "type": "boolean" + }, + "isIncidentLogsEnabled": { + "description": "Optional. Indicates whether to enable incident logs and trace collection.", + "type": "boolean" + } + }, + "type": "object" + }, "DataCollectionOptionsDbSystem": { "description": "Data collection options for DbSystem.", "id": "DataCollectionOptionsDbSystem", @@ -4812,6 +5259,386 @@ }, "type": "object" }, + "ExadbVmCluster": { + "description": "ExadbVmCluster represents a cluster of VMs that are used to run Exadata workloads. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExadbVmCluster/", + "id": "ExadbVmCluster", + "properties": { + "backupOdbSubnet": { + "description": "Required. Immutable. The name of the backup OdbSubnet associated with the ExadbVmCluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", + "type": "string" + }, + "createTime": { + "description": "Output only. The date and time that the ExadbVmCluster was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Required. Immutable. The display name for the ExadbVmCluster. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters.", + "type": "string" + }, + "entitlementId": { + "description": "Output only. The ID of the subscription entitlement associated with the ExadbVmCluster.", + "readOnly": true, + "type": "string" + }, + "gcpOracleZone": { + "description": "Output only. Immutable. The GCP Oracle zone where Oracle ExadbVmCluster is hosted. Example: us-east4-b-r2. During creation, the system will pick the zone assigned to the ExascaleDbStorageVault.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels or tags associated with the ExadbVmCluster.", + "type": "object" + }, + "name": { + "description": "Identifier. The name of the ExadbVmCluster resource in the following format: projects/{project}/locations/{region}/exadbVmClusters/{exadb_vm_cluster}", + "type": "string" + }, + "odbNetwork": { + "description": "Optional. Immutable. The name of the OdbNetwork associated with the ExadbVmCluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.", + "type": "string" + }, + "odbSubnet": { + "description": "Required. Immutable. The name of the OdbSubnet associated with the ExadbVmCluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", + "type": "string" + }, + "properties": { + "$ref": "ExadbVmClusterProperties", + "description": "Required. The properties of the ExadbVmCluster." + } + }, + "type": "object" + }, + "ExadbVmClusterProperties": { + "description": "The properties of an ExadbVmCluster.", + "id": "ExadbVmClusterProperties", + "properties": { + "additionalEcpuCountPerNode": { + "description": "Optional. Immutable. The number of additional ECPUs per node for an Exadata VM cluster on exascale infrastructure.", + "format": "int32", + "type": "integer" + }, + "clusterName": { + "description": "Optional. Immutable. The cluster name for Exascale vm cluster. The cluster name must begin with an alphabetic character and may contain hyphens(-) but can not contain underscores(_). It should be not more than 11 characters and is not case sensitive. OCI Cluster name.", + "type": "string" + }, + "dataCollectionOptions": { + "$ref": "DataCollectionOptionsCommon", + "description": "Optional. Immutable. Indicates user preference for data collection options." + }, + "enabledEcpuCountPerNode": { + "description": "Required. Immutable. The number of ECPUs enabled per node for an exadata vm cluster on exascale infrastructure.", + "format": "int32", + "type": "integer" + }, + "exascaleDbStorageVault": { + "description": "Required. Immutable. The name of ExascaleDbStorageVault associated with the ExadbVmCluster. It can refer to an existing ExascaleDbStorageVault. Or a new one can be created during the ExadbVmCluster creation (requires storage_vault_properties to be set). Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}", + "type": "string" + }, + "giVersion": { + "description": "Output only. The Oracle Grid Infrastructure (GI) software version.", + "readOnly": true, + "type": "string" + }, + "gridImageId": { + "description": "Required. Immutable. Grid Infrastructure Version.", + "type": "string" + }, + "hostname": { + "description": "Output only. The hostname of the ExadbVmCluster.", + "readOnly": true, + "type": "string" + }, + "hostnamePrefix": { + "description": "Required. Immutable. Prefix for VM cluster host names.", + "type": "string" + }, + "licenseModel": { + "description": "Optional. Immutable. The license type of the ExadbVmCluster.", + "enum": [ + "LICENSE_MODEL_UNSPECIFIED", + "LICENSE_INCLUDED", + "BRING_YOUR_OWN_LICENSE" + ], + "enumDescriptions": [ + "Unspecified.", + "Default is license included.", + "Bring your own license." + ], + "type": "string" + }, + "lifecycleState": { + "description": "Output only. State of the cluster.", + "enum": [ + "EXADB_VM_CLUSTER_LIFECYCLE_STATE_UNSPECIFIED", + "PROVISIONING", + "AVAILABLE", + "UPDATING", + "TERMINATING", + "TERMINATED", + "FAILED", + "MAINTENANCE_IN_PROGRESS" + ], + "enumDescriptions": [ + "Default unspecified value.", + "Indicates that the resource is in provisioning state.", + "Indicates that the resource is in available state.", + "Indicates that the resource is in updating state.", + "Indicates that the resource is in terminating state.", + "Indicates that the resource is in terminated state.", + "Indicates that the resource is in failed state.", + "Indicates that the resource is in maintenance in progress state." + ], + "readOnly": true, + "type": "string" + }, + "memorySizeGb": { + "description": "Output only. Memory per VM (GB) (Read-only): Shows the amount of memory allocated to each VM. Memory is calculated based on 2.75 GB per Total ECPUs.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "nodeCount": { + "description": "Required. The number of nodes/VMs in the ExadbVmCluster.", + "format": "int32", + "type": "integer" + }, + "ociUri": { + "description": "Output only. Deep link to the OCI console to view this resource.", + "readOnly": true, + "type": "string" + }, + "scanListenerPortTcp": { + "description": "Optional. Immutable. SCAN listener port - TCP", + "format": "int32", + "type": "integer" + }, + "shapeAttribute": { + "description": "Required. Immutable. The shape attribute of the VM cluster. The type of Exascale storage used for Exadata VM cluster. The default is SMART_STORAGE which supports Oracle Database 23ai and later", + "enum": [ + "SHAPE_ATTRIBUTE_UNSPECIFIED", + "SMART_STORAGE", + "BLOCK_STORAGE" + ], + "enumDescriptions": [ + "Default unspecified value.", + "Indicates that the resource is in smart storage.", + "Indicates that the resource is in block storage." + ], + "type": "string" + }, + "sshPublicKeys": { + "description": "Required. Immutable. The SSH public keys for the ExadbVmCluster.", + "items": { + "type": "string" + }, + "type": "array" + }, + "timeZone": { + "$ref": "TimeZone", + "description": "Optional. Immutable. The time zone of the ExadbVmCluster." + }, + "vmFileSystemStorage": { + "$ref": "ExadbVmClusterStorageDetails", + "description": "Required. Immutable. Total storage details for the ExadbVmCluster." + } + }, + "type": "object" + }, + "ExadbVmClusterStorageDetails": { + "description": "The storage allocation for the exadbvmcluster, in gigabytes (GB).", + "id": "ExadbVmClusterStorageDetails", + "properties": { + "sizeInGbsPerNode": { + "description": "Required. The storage allocation for the exadbvmcluster per node, in gigabytes (GB). This field is used to calculate the total storage allocation for the exadbvmcluster.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "ExascaleDbStorageDetails": { + "description": "The storage details of the ExascaleDbStorageVault.", + "id": "ExascaleDbStorageDetails", + "properties": { + "availableSizeGbs": { + "description": "Output only. The available storage capacity for the ExascaleDbStorageVault, in gigabytes (GB).", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "totalSizeGbs": { + "description": "Required. The total storage allocation for the ExascaleDbStorageVault, in gigabytes (GB).", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "ExascaleDbStorageVault": { + "description": "ExascaleDbStorageVault represents a storage vault exadb vm cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/", + "id": "ExascaleDbStorageVault", + "properties": { + "createTime": { + "description": "Output only. The date and time when the ExascaleDbStorageVault was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Required. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters.", + "type": "string" + }, + "entitlementId": { + "description": "Output only. The ID of the subscription entitlement associated with the ExascaleDbStorageVault.", + "readOnly": true, + "type": "string" + }, + "gcpOracleZone": { + "description": "Optional. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels or tags associated with the ExascaleDbStorageVault.", + "type": "object" + }, + "name": { + "description": "Identifier. The resource name of the ExascaleDbStorageVault. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}", + "type": "string" + }, + "properties": { + "$ref": "ExascaleDbStorageVaultProperties", + "description": "Required. The properties of the ExascaleDbStorageVault." + } + }, + "type": "object" + }, + "ExascaleDbStorageVaultProperties": { + "description": "The properties of the ExascaleDbStorageVault. next ID: 12", + "id": "ExascaleDbStorageVaultProperties", + "properties": { + "additionalFlashCachePercent": { + "description": "Optional. The size of additional flash cache in percentage of high capacity database storage.", + "format": "int32", + "type": "integer" + }, + "attachedShapeAttributes": { + "description": "Output only. The shape attributes of the VM clusters attached to the ExascaleDbStorageVault.", + "items": { + "enum": [ + "SHAPE_ATTRIBUTE_UNSPECIFIED", + "SMART_STORAGE", + "BLOCK_STORAGE" + ], + "enumDescriptions": [ + "Default unspecified value.", + "Indicates that the resource is in smart storage.", + "Indicates that the resource is in block storage." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "availableShapeAttributes": { + "description": "Output only. The shape attributes available for the VM clusters to be attached to the ExascaleDbStorageVault.", + "items": { + "enum": [ + "SHAPE_ATTRIBUTE_UNSPECIFIED", + "SMART_STORAGE", + "BLOCK_STORAGE" + ], + "enumDescriptions": [ + "Default unspecified value.", + "Indicates that the resource is in smart storage.", + "Indicates that the resource is in block storage." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "description": { + "description": "Optional. The description of the ExascaleDbStorageVault.", + "type": "string" + }, + "exascaleDbStorageDetails": { + "$ref": "ExascaleDbStorageDetails", + "description": "Required. The storage details of the ExascaleDbStorageVault." + }, + "ociUri": { + "description": "Output only. Deep link to the OCI console to view this resource.", + "readOnly": true, + "type": "string" + }, + "ocid": { + "description": "Output only. The OCID for the ExascaleDbStorageVault.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The state of the ExascaleDbStorageVault.", + "enum": [ + "STATE_UNSPECIFIED", + "PROVISIONING", + "AVAILABLE", + "UPDATING", + "TERMINATING", + "TERMINATED", + "FAILED" + ], + "enumDescriptions": [ + "The state of the ExascaleDbStorageVault is unspecified.", + "The ExascaleDbStorageVault is being provisioned.", + "The ExascaleDbStorageVault is available.", + "The ExascaleDbStorageVault is being updated.", + "The ExascaleDbStorageVault is being deleted.", + "The ExascaleDbStorageVault has been deleted.", + "The ExascaleDbStorageVault has failed." + ], + "readOnly": true, + "type": "string" + }, + "timeZone": { + "$ref": "TimeZone", + "description": "Output only. The time zone of the ExascaleDbStorageVault.", + "readOnly": true + }, + "vmClusterCount": { + "description": "Output only. The number of VM clusters associated with the ExascaleDbStorageVault.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "vmClusterIds": { + "description": "Output only. The list of VM cluster OCIDs associated with the ExascaleDbStorageVault.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "FailoverAutonomousDatabaseRequest": { + "description": "The request for `OracleDatabase.FailoverAutonomousDatabase`.", + "id": "FailoverAutonomousDatabaseRequest", + "properties": { + "peerAutonomousDatabase": { + "description": "Required. The peer database name to fail over to.", + "type": "string" + } + }, + "type": "object" + }, "GenerateAutonomousDatabaseWalletRequest": { "description": "The request for `AutonomousDatabase.GenerateWallet`.", "id": "GenerateAutonomousDatabaseWalletRequest", @@ -5170,6 +5997,42 @@ }, "type": "object" }, + "ListExadbVmClustersResponse": { + "description": "The response for `ExadbVmCluster.List`.", + "id": "ListExadbVmClustersResponse", + "properties": { + "exadbVmClusters": { + "description": "The list of ExadbVmClusters.", + "items": { + "$ref": "ExadbVmCluster" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + } + }, + "type": "object" + }, + "ListExascaleDbStorageVaultsResponse": { + "description": "The response for `ExascaleDbStorageVault.List`.", + "id": "ListExascaleDbStorageVaultsResponse", + "properties": { + "exascaleDbStorageVaults": { + "description": "The ExascaleDbStorageVaults.", + "items": { + "$ref": "ExascaleDbStorageVault" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return. If present, the next page token can be provided to a subsequent ListExascaleDbStorageVaults call to list the next page. If empty, there are no more pages.", + "type": "string" + } + }, + "type": "object" + }, "ListGiVersionsResponse": { "description": "The response for `GiVersion.List`.", "id": "ListGiVersionsResponse", @@ -5206,6 +6069,24 @@ }, "type": "object" }, + "ListMinorVersionsResponse": { + "description": "The response for `MinorVersion.List`.", + "id": "ListMinorVersionsResponse", + "properties": { + "minorVersions": { + "description": "The list of MinorVersions.", + "items": { + "$ref": "MinorVersion" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + } + }, + "type": "object" + }, "ListOdbNetworksResponse": { "description": "The response for `OdbNetwork.List`.", "id": "ListOdbNetworksResponse", @@ -5470,6 +6351,25 @@ }, "type": "object" }, + "MinorVersion": { + "description": "MinorVersion represents a minor version of a GI. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/GiMinorVersionSummary/", + "id": "MinorVersion", + "properties": { + "gridImageId": { + "description": "Optional. The ID of the Grid Image.", + "type": "string" + }, + "name": { + "description": "Identifier. The name of the MinorVersion resource with the format: projects/{project}/locations/{region}/giVersions/{gi_version}/minorVersions/{minor_version}", + "type": "string" + }, + "version": { + "description": "Optional. The valid Oracle grid infrastructure software version.", + "type": "string" + } + }, + "type": "object" + }, "OdbNetwork": { "description": "Represents OdbNetwork resource.", "id": "OdbNetwork", @@ -5876,6 +6776,24 @@ }, "type": "object" }, + "RemoveVirtualMachineExadbVmClusterRequest": { + "description": "The request for `ExadbVmCluster.RemoveVirtualMachine`.", + "id": "RemoveVirtualMachineExadbVmClusterRequest", + "properties": { + "hostnames": { + "description": "Required. The list of host names of db nodes to be removed from the ExadbVmCluster.", + "items": { + "type": "string" + }, + "type": "array" + }, + "requestId": { + "description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server ignores the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "type": "string" + } + }, + "type": "object" + }, "RestartAutonomousDatabaseRequest": { "description": "The request for `AutonomousDatabase.Restart`.", "id": "RestartAutonomousDatabaseRequest", diff --git a/oracledatabase/v1/oracledatabase-gen.go b/oracledatabase/v1/oracledatabase-gen.go index 045a67fe89b..c7bbf2b9ad8 100644 --- a/oracledatabase/v1/oracledatabase-gen.go +++ b/oracledatabase/v1/oracledatabase-gen.go @@ -181,6 +181,8 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.DbSystems = NewProjectsLocationsDbSystemsService(s) rs.DbVersions = NewProjectsLocationsDbVersionsService(s) rs.Entitlements = NewProjectsLocationsEntitlementsService(s) + rs.ExadbVmClusters = NewProjectsLocationsExadbVmClustersService(s) + rs.ExascaleDbStorageVaults = NewProjectsLocationsExascaleDbStorageVaultsService(s) rs.GiVersions = NewProjectsLocationsGiVersionsService(s) rs.OdbNetworks = NewProjectsLocationsOdbNetworksService(s) rs.Operations = NewProjectsLocationsOperationsService(s) @@ -217,6 +219,10 @@ type ProjectsLocationsService struct { Entitlements *ProjectsLocationsEntitlementsService + ExadbVmClusters *ProjectsLocationsExadbVmClustersService + + ExascaleDbStorageVaults *ProjectsLocationsExascaleDbStorageVaultsService + GiVersions *ProjectsLocationsGiVersionsService OdbNetworks *ProjectsLocationsOdbNetworksService @@ -367,13 +373,43 @@ type ProjectsLocationsEntitlementsService struct { s *Service } +func NewProjectsLocationsExadbVmClustersService(s *Service) *ProjectsLocationsExadbVmClustersService { + rs := &ProjectsLocationsExadbVmClustersService{s: s} + return rs +} + +type ProjectsLocationsExadbVmClustersService struct { + s *Service +} + +func NewProjectsLocationsExascaleDbStorageVaultsService(s *Service) *ProjectsLocationsExascaleDbStorageVaultsService { + rs := &ProjectsLocationsExascaleDbStorageVaultsService{s: s} + return rs +} + +type ProjectsLocationsExascaleDbStorageVaultsService struct { + s *Service +} + func NewProjectsLocationsGiVersionsService(s *Service) *ProjectsLocationsGiVersionsService { rs := &ProjectsLocationsGiVersionsService{s: s} + rs.MinorVersions = NewProjectsLocationsGiVersionsMinorVersionsService(s) return rs } type ProjectsLocationsGiVersionsService struct { s *Service + + MinorVersions *ProjectsLocationsGiVersionsMinorVersionsService +} + +func NewProjectsLocationsGiVersionsMinorVersionsService(s *Service) *ProjectsLocationsGiVersionsMinorVersionsService { + rs := &ProjectsLocationsGiVersionsMinorVersionsService{s: s} + return rs +} + +type ProjectsLocationsGiVersionsMinorVersionsService struct { + s *Service } func NewProjectsLocationsOdbNetworksService(s *Service) *ProjectsLocationsOdbNetworksService { @@ -1782,6 +1818,36 @@ func (s DataCollectionOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// DataCollectionOptionsCommon: Data collection options for diagnostics. +// https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/datatypes/DataCollectionOptions +type DataCollectionOptionsCommon struct { + // IsDiagnosticsEventsEnabled: Optional. Indicates whether to enable data + // collection for diagnostics. + IsDiagnosticsEventsEnabled bool `json:"isDiagnosticsEventsEnabled,omitempty"` + // IsHealthMonitoringEnabled: Optional. Indicates whether to enable health + // monitoring. + IsHealthMonitoringEnabled bool `json:"isHealthMonitoringEnabled,omitempty"` + // IsIncidentLogsEnabled: Optional. Indicates whether to enable incident logs + // and trace collection. + IsIncidentLogsEnabled bool `json:"isIncidentLogsEnabled,omitempty"` + // ForceSendFields is a list of field names (e.g. "IsDiagnosticsEventsEnabled") + // 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. "IsDiagnosticsEventsEnabled") 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 DataCollectionOptionsCommon) MarshalJSON() ([]byte, error) { + type NoMethod DataCollectionOptionsCommon + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // DataCollectionOptionsDbSystem: Data collection options for DbSystem. type DataCollectionOptionsDbSystem struct { // IsDiagnosticsEventsEnabled: Optional. Indicates whether to enable data @@ -2781,6 +2847,359 @@ func (s Entitlement) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ExadbVmCluster: ExadbVmCluster represents a cluster of VMs that are used to +// run Exadata workloads. +// https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExadbVmCluster/ +type ExadbVmCluster struct { + // BackupOdbSubnet: Required. Immutable. The name of the backup OdbSubnet + // associated with the ExadbVmCluster. Format: + // projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/ + // {odb_subnet} + BackupOdbSubnet string `json:"backupOdbSubnet,omitempty"` + // CreateTime: Output only. The date and time that the ExadbVmCluster was + // created. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Required. Immutable. The display name for the ExadbVmCluster. + // The name does not have to be unique within your project. The name must be + // 1-255 characters long and can only contain alphanumeric characters. + DisplayName string `json:"displayName,omitempty"` + // EntitlementId: Output only. The ID of the subscription entitlement + // associated with the ExadbVmCluster. + EntitlementId string `json:"entitlementId,omitempty"` + // GcpOracleZone: Output only. Immutable. The GCP Oracle zone where Oracle + // ExadbVmCluster is hosted. Example: us-east4-b-r2. During creation, the + // system will pick the zone assigned to the ExascaleDbStorageVault. + GcpOracleZone string `json:"gcpOracleZone,omitempty"` + // Labels: Optional. The labels or tags associated with the ExadbVmCluster. + Labels map[string]string `json:"labels,omitempty"` + // Name: Identifier. The name of the ExadbVmCluster resource in the following + // format: + // projects/{project}/locations/{region}/exadbVmClusters/{exadb_vm_cluster} + Name string `json:"name,omitempty"` + // OdbNetwork: Optional. Immutable. The name of the OdbNetwork associated with + // the ExadbVmCluster. Format: + // projects/{project}/locations/{location}/odbNetworks/{odb_network} It is + // optional but if specified, this should match the parent ODBNetwork of the + // OdbSubnet. + OdbNetwork string `json:"odbNetwork,omitempty"` + // OdbSubnet: Required. Immutable. The name of the OdbSubnet associated with + // the ExadbVmCluster for IP allocation. Format: + // projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/ + // {odb_subnet} + OdbSubnet string `json:"odbSubnet,omitempty"` + // Properties: Required. The properties of the ExadbVmCluster. + Properties *ExadbVmClusterProperties `json:"properties,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "BackupOdbSubnet") 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. "BackupOdbSubnet") 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 ExadbVmCluster) MarshalJSON() ([]byte, error) { + type NoMethod ExadbVmCluster + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExadbVmClusterProperties: The properties of an ExadbVmCluster. +type ExadbVmClusterProperties struct { + // AdditionalEcpuCountPerNode: Optional. Immutable. The number of additional + // ECPUs per node for an Exadata VM cluster on exascale infrastructure. + AdditionalEcpuCountPerNode int64 `json:"additionalEcpuCountPerNode,omitempty"` + // ClusterName: Optional. Immutable. The cluster name for Exascale vm cluster. + // The cluster name must begin with an alphabetic character and may contain + // hyphens(-) but can not contain underscores(_). It should be not more than 11 + // characters and is not case sensitive. OCI Cluster name. + ClusterName string `json:"clusterName,omitempty"` + // DataCollectionOptions: Optional. Immutable. Indicates user preference for + // data collection options. + DataCollectionOptions *DataCollectionOptionsCommon `json:"dataCollectionOptions,omitempty"` + // EnabledEcpuCountPerNode: Required. Immutable. The number of ECPUs enabled + // per node for an exadata vm cluster on exascale infrastructure. + EnabledEcpuCountPerNode int64 `json:"enabledEcpuCountPerNode,omitempty"` + // ExascaleDbStorageVault: Required. Immutable. The name of + // ExascaleDbStorageVault associated with the ExadbVmCluster. It can refer to + // an existing ExascaleDbStorageVault. Or a new one can be created during the + // ExadbVmCluster creation (requires storage_vault_properties to be set). + // Format: + // projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_ + // storage_vault} + ExascaleDbStorageVault string `json:"exascaleDbStorageVault,omitempty"` + // GiVersion: Output only. The Oracle Grid Infrastructure (GI) software + // version. + GiVersion string `json:"giVersion,omitempty"` + // GridImageId: Required. Immutable. Grid Infrastructure Version. + GridImageId string `json:"gridImageId,omitempty"` + // Hostname: Output only. The hostname of the ExadbVmCluster. + Hostname string `json:"hostname,omitempty"` + // HostnamePrefix: Required. Immutable. Prefix for VM cluster host names. + HostnamePrefix string `json:"hostnamePrefix,omitempty"` + // LicenseModel: Optional. Immutable. The license type of the ExadbVmCluster. + // + // Possible values: + // "LICENSE_MODEL_UNSPECIFIED" - Unspecified. + // "LICENSE_INCLUDED" - Default is license included. + // "BRING_YOUR_OWN_LICENSE" - Bring your own license. + LicenseModel string `json:"licenseModel,omitempty"` + // LifecycleState: Output only. State of the cluster. + // + // Possible values: + // "EXADB_VM_CLUSTER_LIFECYCLE_STATE_UNSPECIFIED" - Default unspecified + // value. + // "PROVISIONING" - Indicates that the resource is in provisioning state. + // "AVAILABLE" - Indicates that the resource is in available state. + // "UPDATING" - Indicates that the resource is in updating state. + // "TERMINATING" - Indicates that the resource is in terminating state. + // "TERMINATED" - Indicates that the resource is in terminated state. + // "FAILED" - Indicates that the resource is in failed state. + // "MAINTENANCE_IN_PROGRESS" - Indicates that the resource is in maintenance + // in progress state. + LifecycleState string `json:"lifecycleState,omitempty"` + // MemorySizeGb: Output only. Memory per VM (GB) (Read-only): Shows the amount + // of memory allocated to each VM. Memory is calculated based on 2.75 GB per + // Total ECPUs. + MemorySizeGb int64 `json:"memorySizeGb,omitempty"` + // NodeCount: Required. The number of nodes/VMs in the ExadbVmCluster. + NodeCount int64 `json:"nodeCount,omitempty"` + // OciUri: Output only. Deep link to the OCI console to view this resource. + OciUri string `json:"ociUri,omitempty"` + // ScanListenerPortTcp: Optional. Immutable. SCAN listener port - TCP + ScanListenerPortTcp int64 `json:"scanListenerPortTcp,omitempty"` + // ShapeAttribute: Required. Immutable. The shape attribute of the VM cluster. + // The type of Exascale storage used for Exadata VM cluster. The default is + // SMART_STORAGE which supports Oracle Database 23ai and later + // + // Possible values: + // "SHAPE_ATTRIBUTE_UNSPECIFIED" - Default unspecified value. + // "SMART_STORAGE" - Indicates that the resource is in smart storage. + // "BLOCK_STORAGE" - Indicates that the resource is in block storage. + ShapeAttribute string `json:"shapeAttribute,omitempty"` + // SshPublicKeys: Required. Immutable. The SSH public keys for the + // ExadbVmCluster. + SshPublicKeys []string `json:"sshPublicKeys,omitempty"` + // TimeZone: Optional. Immutable. The time zone of the ExadbVmCluster. + TimeZone *TimeZone `json:"timeZone,omitempty"` + // VmFileSystemStorage: Required. Immutable. Total storage details for the + // ExadbVmCluster. + VmFileSystemStorage *ExadbVmClusterStorageDetails `json:"vmFileSystemStorage,omitempty"` + // ForceSendFields is a list of field names (e.g. "AdditionalEcpuCountPerNode") + // 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. "AdditionalEcpuCountPerNode") 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 ExadbVmClusterProperties) MarshalJSON() ([]byte, error) { + type NoMethod ExadbVmClusterProperties + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExadbVmClusterStorageDetails: The storage allocation for the exadbvmcluster, +// in gigabytes (GB). +type ExadbVmClusterStorageDetails struct { + // SizeInGbsPerNode: Required. The storage allocation for the exadbvmcluster + // per node, in gigabytes (GB). This field is used to calculate the total + // storage allocation for the exadbvmcluster. + SizeInGbsPerNode int64 `json:"sizeInGbsPerNode,omitempty"` + // ForceSendFields is a list of field names (e.g. "SizeInGbsPerNode") 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. "SizeInGbsPerNode") 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 ExadbVmClusterStorageDetails) MarshalJSON() ([]byte, error) { + type NoMethod ExadbVmClusterStorageDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExascaleDbStorageDetails: The storage details of the ExascaleDbStorageVault. +type ExascaleDbStorageDetails struct { + // AvailableSizeGbs: Output only. The available storage capacity for the + // ExascaleDbStorageVault, in gigabytes (GB). + AvailableSizeGbs int64 `json:"availableSizeGbs,omitempty"` + // TotalSizeGbs: Required. The total storage allocation for the + // ExascaleDbStorageVault, in gigabytes (GB). + TotalSizeGbs int64 `json:"totalSizeGbs,omitempty"` + // ForceSendFields is a list of field names (e.g. "AvailableSizeGbs") 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. "AvailableSizeGbs") 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 ExascaleDbStorageDetails) MarshalJSON() ([]byte, error) { + type NoMethod ExascaleDbStorageDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExascaleDbStorageVault: ExascaleDbStorageVault represents a storage vault +// exadb vm cluster resource. +// https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/ +type ExascaleDbStorageVault struct { + // CreateTime: Output only. The date and time when the ExascaleDbStorageVault + // was created. + CreateTime string `json:"createTime,omitempty"` + // DisplayName: Required. The display name for the ExascaleDbStorageVault. The + // name does not have to be unique within your project. The name must be 1-255 + // characters long and can only contain alphanumeric characters. + DisplayName string `json:"displayName,omitempty"` + // EntitlementId: Output only. The ID of the subscription entitlement + // associated with the ExascaleDbStorageVault. + EntitlementId string `json:"entitlementId,omitempty"` + // GcpOracleZone: Optional. The GCP Oracle zone where Oracle + // ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, + // the system will pick a zone based on availability. + GcpOracleZone string `json:"gcpOracleZone,omitempty"` + // Labels: Optional. The labels or tags associated with the + // ExascaleDbStorageVault. + Labels map[string]string `json:"labels,omitempty"` + // Name: Identifier. The resource name of the ExascaleDbStorageVault. Format: + // projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_ + // storage_vault} + Name string `json:"name,omitempty"` + // Properties: Required. The properties of the ExascaleDbStorageVault. + Properties *ExascaleDbStorageVaultProperties `json:"properties,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 ExascaleDbStorageVault) MarshalJSON() ([]byte, error) { + type NoMethod ExascaleDbStorageVault + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ExascaleDbStorageVaultProperties: The properties of the +// ExascaleDbStorageVault. next ID: 12 +type ExascaleDbStorageVaultProperties struct { + // AdditionalFlashCachePercent: Optional. The size of additional flash cache in + // percentage of high capacity database storage. + AdditionalFlashCachePercent int64 `json:"additionalFlashCachePercent,omitempty"` + // AttachedShapeAttributes: Output only. The shape attributes of the VM + // clusters attached to the ExascaleDbStorageVault. + // + // Possible values: + // "SHAPE_ATTRIBUTE_UNSPECIFIED" - Default unspecified value. + // "SMART_STORAGE" - Indicates that the resource is in smart storage. + // "BLOCK_STORAGE" - Indicates that the resource is in block storage. + AttachedShapeAttributes []string `json:"attachedShapeAttributes,omitempty"` + // AvailableShapeAttributes: Output only. The shape attributes available for + // the VM clusters to be attached to the ExascaleDbStorageVault. + // + // Possible values: + // "SHAPE_ATTRIBUTE_UNSPECIFIED" - Default unspecified value. + // "SMART_STORAGE" - Indicates that the resource is in smart storage. + // "BLOCK_STORAGE" - Indicates that the resource is in block storage. + AvailableShapeAttributes []string `json:"availableShapeAttributes,omitempty"` + // Description: Optional. The description of the ExascaleDbStorageVault. + Description string `json:"description,omitempty"` + // ExascaleDbStorageDetails: Required. The storage details of the + // ExascaleDbStorageVault. + ExascaleDbStorageDetails *ExascaleDbStorageDetails `json:"exascaleDbStorageDetails,omitempty"` + // OciUri: Output only. Deep link to the OCI console to view this resource. + OciUri string `json:"ociUri,omitempty"` + // Ocid: Output only. The OCID for the ExascaleDbStorageVault. + Ocid string `json:"ocid,omitempty"` + // State: Output only. The state of the ExascaleDbStorageVault. + // + // Possible values: + // "STATE_UNSPECIFIED" - The state of the ExascaleDbStorageVault is + // unspecified. + // "PROVISIONING" - The ExascaleDbStorageVault is being provisioned. + // "AVAILABLE" - The ExascaleDbStorageVault is available. + // "UPDATING" - The ExascaleDbStorageVault is being updated. + // "TERMINATING" - The ExascaleDbStorageVault is being deleted. + // "TERMINATED" - The ExascaleDbStorageVault has been deleted. + // "FAILED" - The ExascaleDbStorageVault has failed. + State string `json:"state,omitempty"` + // TimeZone: Output only. The time zone of the ExascaleDbStorageVault. + TimeZone *TimeZone `json:"timeZone,omitempty"` + // VmClusterCount: Output only. The number of VM clusters associated with the + // ExascaleDbStorageVault. + VmClusterCount int64 `json:"vmClusterCount,omitempty"` + // VmClusterIds: Output only. The list of VM cluster OCIDs associated with the + // ExascaleDbStorageVault. + VmClusterIds []string `json:"vmClusterIds,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "AdditionalFlashCachePercent") 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. "AdditionalFlashCachePercent") 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 ExascaleDbStorageVaultProperties) MarshalJSON() ([]byte, error) { + type NoMethod ExascaleDbStorageVaultProperties + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// FailoverAutonomousDatabaseRequest: The request for +// `OracleDatabase.FailoverAutonomousDatabase`. +type FailoverAutonomousDatabaseRequest struct { + // PeerAutonomousDatabase: Required. The peer database name to fail over to. + PeerAutonomousDatabase string `json:"peerAutonomousDatabase,omitempty"` + // ForceSendFields is a list of field names (e.g. "PeerAutonomousDatabase") 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. "PeerAutonomousDatabase") 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 FailoverAutonomousDatabaseRequest) MarshalJSON() ([]byte, error) { + type NoMethod FailoverAutonomousDatabaseRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GenerateAutonomousDatabaseWalletRequest: The request for // `AutonomousDatabase.GenerateWallet`. type GenerateAutonomousDatabaseWalletRequest struct { @@ -3330,6 +3749,65 @@ func (s ListEntitlementsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ListExadbVmClustersResponse: The response for `ExadbVmCluster.List`. +type ListExadbVmClustersResponse struct { + // ExadbVmClusters: The list of ExadbVmClusters. + ExadbVmClusters []*ExadbVmCluster `json:"exadbVmClusters,omitempty"` + // NextPageToken: A token identifying a page of results the server should + // return. + 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. "ExadbVmClusters") 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. "ExadbVmClusters") 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 ListExadbVmClustersResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListExadbVmClustersResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListExascaleDbStorageVaultsResponse: The response for +// `ExascaleDbStorageVault.List`. +type ListExascaleDbStorageVaultsResponse struct { + // ExascaleDbStorageVaults: The ExascaleDbStorageVaults. + ExascaleDbStorageVaults []*ExascaleDbStorageVault `json:"exascaleDbStorageVaults,omitempty"` + // NextPageToken: A token identifying a page of results the server should + // return. If present, the next page token can be provided to a subsequent + // ListExascaleDbStorageVaults call to list the next page. If empty, there are + // no more pages. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the server. + googleapi.ServerResponse `json:"-"` + // ForceSendFields is a list of field names (e.g. "ExascaleDbStorageVaults") 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. "ExascaleDbStorageVaults") 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 ListExascaleDbStorageVaultsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListExascaleDbStorageVaultsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ListGiVersionsResponse: The response for `GiVersion.List`. type ListGiVersionsResponse struct { // GiVersions: The list of Oracle Grid Infrastructure (GI) versions. @@ -3386,7 +3864,35 @@ func (s ListLocationsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// ListOdbNetworksResponse: The response for `OdbNetwork.List`. +// ListMinorVersionsResponse: The response for `MinorVersion.List`. +type ListMinorVersionsResponse struct { + // MinorVersions: The list of MinorVersions. + MinorVersions []*MinorVersion `json:"minorVersions,omitempty"` + // NextPageToken: A token identifying a page of results the server should + // return. + 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. "MinorVersions") 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. "MinorVersions") 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 ListMinorVersionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListMinorVersionsResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ListOdbNetworksResponse: The response for `OdbNetwork.List`. type ListOdbNetworksResponse struct { // NextPageToken: A token identifying a page of results the server should // return. @@ -3660,6 +4166,35 @@ func (s MaintenanceWindow) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// MinorVersion: MinorVersion represents a minor version of a GI. +// https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/GiMinorVersionSummary/ +type MinorVersion struct { + // GridImageId: Optional. The ID of the Grid Image. + GridImageId string `json:"gridImageId,omitempty"` + // Name: Identifier. The name of the MinorVersion resource with the format: + // projects/{project}/locations/{region}/giVersions/{gi_version}/minorVersions/{ + // minor_version} + Name string `json:"name,omitempty"` + // Version: Optional. The valid Oracle grid infrastructure software version. + Version string `json:"version,omitempty"` + // ForceSendFields is a list of field names (e.g. "GridImageId") 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. "GridImageId") 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 MinorVersion) MarshalJSON() ([]byte, error) { + type NoMethod MinorVersion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // OdbNetwork: Represents OdbNetwork resource. type OdbNetwork struct { // CreateTime: Output only. The date and time that the OdbNetwork was created. @@ -4041,6 +4576,38 @@ func (s PluggableDatabaseProperties) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// RemoveVirtualMachineExadbVmClusterRequest: The request for +// `ExadbVmCluster.RemoveVirtualMachine`. +type RemoveVirtualMachineExadbVmClusterRequest struct { + // Hostnames: Required. The list of host names of db nodes to be removed from + // the ExadbVmCluster. + Hostnames []string `json:"hostnames,omitempty"` + // RequestId: Optional. An optional ID to identify the request. This value is + // used to identify duplicate requests. If you make a request with the same + // request ID and the original request is still in progress or completed, the + // server ignores the second request. This prevents clients from accidentally + // creating duplicate commitments. The request ID must be a valid UUID with the + // exception that zero UUID is not supported + // (00000000-0000-0000-0000-000000000000). + RequestId string `json:"requestId,omitempty"` + // ForceSendFields is a list of field names (e.g. "Hostnames") 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. "Hostnames") 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 RemoveVirtualMachineExadbVmClusterRequest) MarshalJSON() ([]byte, error) { + type NoMethod RemoveVirtualMachineExadbVmClusterRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // RestartAutonomousDatabaseRequest: The request for // `AutonomousDatabase.Restart`. type RestartAutonomousDatabaseRequest struct { @@ -5115,6 +5682,112 @@ func (c *ProjectsLocationsAutonomousDatabasesDeleteCall) Do(opts ...googleapi.Ca return ret, nil } +type ProjectsLocationsAutonomousDatabasesFailoverCall struct { + s *Service + name string + failoverautonomousdatabaserequest *FailoverAutonomousDatabaseRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Failover: Initiates a failover to target autonomous database from the +// associated primary database. +// +// - name: The name of the Autonomous Database in the following format: +// projects/{project}/locations/{location}/autonomousDatabases/{autonomous_dat +// abase}. +func (r *ProjectsLocationsAutonomousDatabasesService) Failover(name string, failoverautonomousdatabaserequest *FailoverAutonomousDatabaseRequest) *ProjectsLocationsAutonomousDatabasesFailoverCall { + c := &ProjectsLocationsAutonomousDatabasesFailoverCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.failoverautonomousdatabaserequest = failoverautonomousdatabaserequest + 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 *ProjectsLocationsAutonomousDatabasesFailoverCall) Fields(s ...googleapi.Field) *ProjectsLocationsAutonomousDatabasesFailoverCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsAutonomousDatabasesFailoverCall) Context(ctx context.Context) *ProjectsLocationsAutonomousDatabasesFailoverCall { + 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 *ProjectsLocationsAutonomousDatabasesFailoverCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsAutonomousDatabasesFailoverCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.failoverautonomousdatabaserequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:failover") + 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.failover", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.autonomousDatabases.failover" 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 *ProjectsLocationsAutonomousDatabasesFailoverCall) 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.failover", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type ProjectsLocationsAutonomousDatabasesGenerateWalletCall struct { s *Service name string @@ -9045,91 +9718,86 @@ func (c *ProjectsLocationsEntitlementsListCall) Pages(ctx context.Context, f fun } } -type ProjectsLocationsGiVersionsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header +type ProjectsLocationsExadbVmClustersCreateCall struct { + s *Service + parent string + exadbvmcluster *ExadbVmCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header } -// List: Lists all the valid Oracle Grid Infrastructure (GI) versions for the -// given project and location. +// Create: Creates a new Exadb (Exascale) VM Cluster resource. // -// - parent: The parent value for Grid Infrastructure Version in the following -// format: Format: projects/{project}/locations/{location}. -func (r *ProjectsLocationsGiVersionsService) List(parent string) *ProjectsLocationsGiVersionsListCall { - c := &ProjectsLocationsGiVersionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - parent: The value for parent of the ExadbVmCluster in the following +// format: projects/{project}/locations/{location}. +func (r *ProjectsLocationsExadbVmClustersService) Create(parent string, exadbvmcluster *ExadbVmCluster) *ProjectsLocationsExadbVmClustersCreateCall { + c := &ProjectsLocationsExadbVmClustersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent + c.exadbvmcluster = exadbvmcluster return c } -// Filter sets the optional parameter "filter": An expression for filtering the -// results of the request. Only the shape, gcp_oracle_zone and gi_version -// fields are supported in this format: `shape="{shape}". -func (c *ProjectsLocationsGiVersionsListCall) Filter(filter string) *ProjectsLocationsGiVersionsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": The maximum number of items -// to return. If unspecified, a maximum of 50 Oracle Grid Infrastructure (GI) -// versions will be returned. The maximum value is 1000; values above 1000 will -// be reset to 1000. -func (c *ProjectsLocationsGiVersionsListCall) PageSize(pageSize int64) *ProjectsLocationsGiVersionsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) +// ExadbVmClusterId sets the optional parameter "exadbVmClusterId": Required. +// The ID of the ExadbVmCluster to create. This value is restricted to (^a-z +// ([a-z0-9-]{0,61}[a-z0-9])?$) and must be a maximum of 63 characters in +// length. The value must start with a letter and end with a letter or a +// number. +func (c *ProjectsLocationsExadbVmClustersCreateCall) ExadbVmClusterId(exadbVmClusterId string) *ProjectsLocationsExadbVmClustersCreateCall { + c.urlParams_.Set("exadbVmClusterId", exadbVmClusterId) return c } -// PageToken sets the optional parameter "pageToken": A token identifying a -// page of results the server should return. -func (c *ProjectsLocationsGiVersionsListCall) PageToken(pageToken string) *ProjectsLocationsGiVersionsListCall { - c.urlParams_.Set("pageToken", pageToken) +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes since +// the first request. For example, consider a situation where you make an +// initial request and the request times out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsExadbVmClustersCreateCall) RequestId(requestId string) *ProjectsLocationsExadbVmClustersCreateCall { + 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 *ProjectsLocationsGiVersionsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGiVersionsListCall { +func (c *ProjectsLocationsExadbVmClustersCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsExadbVmClustersCreateCall { 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 *ProjectsLocationsGiVersionsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGiVersionsListCall { - c.ifNoneMatch_ = entityTag - return c -} - // Context sets the context to be used in this call's Do method. -func (c *ProjectsLocationsGiVersionsListCall) Context(ctx context.Context) *ProjectsLocationsGiVersionsListCall { +func (c *ProjectsLocationsExadbVmClustersCreateCall) Context(ctx context.Context) *ProjectsLocationsExadbVmClustersCreateCall { 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 *ProjectsLocationsGiVersionsListCall) Header() http.Header { +func (c *ProjectsLocationsExadbVmClustersCreateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *ProjectsLocationsGiVersionsListCall) 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 *ProjectsLocationsExadbVmClustersCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.exadbvmcluster) + if err != nil { + return nil, err } c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/giVersions") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/exadbVmClusters") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("GET", urls, nil) + req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } @@ -9137,17 +9805,16 @@ func (c *ProjectsLocationsGiVersionsListCall) doRequest(alt string) (*http.Respo googleapi.Expand(req.URL, map[string]string{ "parent": c.parent, }) - c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.giVersions.list", "request", internallog.HTTPRequest(req, nil)) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.exadbVmClusters.create", "request", internallog.HTTPRequest(req, body.Bytes())) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "oracledatabase.projects.locations.giVersions.list" call. +// Do executes the "oracledatabase.projects.locations.exadbVmClusters.create" call. // Any non-2xx status code is an error. Response headers are in either -// *ListGiVersionsResponse.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 *ProjectsLocationsGiVersionsListCall) Do(opts ...googleapi.CallOption) (*ListGiVersionsResponse, error) { +// *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 *ProjectsLocationsExadbVmClustersCreateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -9166,7 +9833,7 @@ func (c *ProjectsLocationsGiVersionsListCall) Do(opts ...googleapi.CallOption) ( if err := googleapi.CheckResponse(res); err != nil { return nil, gensupport.WrapError(err) } - ret := &ListGiVersionsResponse{ + ret := &Operation{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -9177,14 +9844,1440 @@ func (c *ProjectsLocationsGiVersionsListCall) Do(opts ...googleapi.CallOption) ( if err != nil { return nil, err } - c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.giVersions.list", "response", internallog.HTTPResponse(res, b)) + c.s.logger.DebugContext(c.ctx_, "api response", "serviceName", apiName, "rpcName", "oracledatabase.projects.locations.exadbVmClusters.create", "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 *ProjectsLocationsGiVersionsListCall) Pages(ctx context.Context, f func(*ListGiVersionsResponse) error) error { +type ProjectsLocationsExadbVmClustersDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single Exadb (Exascale) VM Cluster. +// +// - name: The name of the ExadbVmCluster in the following format: +// projects/{project}/locations/{location}/exadbVmClusters/{exadb_vm_cluster}. +func (r *ProjectsLocationsExadbVmClustersService) Delete(name string) *ProjectsLocationsExadbVmClustersDeleteCall { + c := &ProjectsLocationsExadbVmClustersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// RequestId sets the optional parameter "requestId": An optional ID to +// identify the request. This value is used to identify duplicate requests. If +// you make a request with the same request ID and the original request is +// still in progress or completed, the server ignores the second request. This +// prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsExadbVmClustersDeleteCall) RequestId(requestId string) *ProjectsLocationsExadbVmClustersDeleteCall { + 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 *ProjectsLocationsExadbVmClustersDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsExadbVmClustersDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExadbVmClustersDeleteCall) Context(ctx context.Context) *ProjectsLocationsExadbVmClustersDeleteCall { + 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 *ProjectsLocationsExadbVmClustersDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExadbVmClustersDeleteCall) 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", "oracledatabase.projects.locations.exadbVmClusters.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exadbVmClusters.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 *ProjectsLocationsExadbVmClustersDeleteCall) 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.exadbVmClusters.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsExadbVmClustersGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single Exadb (Exascale) VM Cluster. +// +// - name: The name of the ExadbVmCluster in the following format: +// projects/{project}/locations/{location}/exadbVmClusters/{exadb_vm_cluster}. +func (r *ProjectsLocationsExadbVmClustersService) Get(name string) *ProjectsLocationsExadbVmClustersGetCall { + c := &ProjectsLocationsExadbVmClustersGetCall{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 *ProjectsLocationsExadbVmClustersGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsExadbVmClustersGetCall { + 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 *ProjectsLocationsExadbVmClustersGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsExadbVmClustersGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExadbVmClustersGetCall) Context(ctx context.Context) *ProjectsLocationsExadbVmClustersGetCall { + 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 *ProjectsLocationsExadbVmClustersGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExadbVmClustersGetCall) 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", "oracledatabase.projects.locations.exadbVmClusters.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exadbVmClusters.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *ExadbVmCluster.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 *ProjectsLocationsExadbVmClustersGetCall) Do(opts ...googleapi.CallOption) (*ExadbVmCluster, 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 := &ExadbVmCluster{ + 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.exadbVmClusters.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsExadbVmClustersListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all the Exadb (Exascale) VM Clusters for the given project and +// location. +// +// - parent: The parent value for ExadbVmClusters in the following format: +// projects/{project}/locations/{location}. +func (r *ProjectsLocationsExadbVmClustersService) List(parent string) *ProjectsLocationsExadbVmClustersListCall { + c := &ProjectsLocationsExadbVmClustersListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": An expression for filtering the +// results of the request. +func (c *ProjectsLocationsExadbVmClustersListCall) Filter(filter string) *ProjectsLocationsExadbVmClustersListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": An expression for ordering +// the results of the request. +func (c *ProjectsLocationsExadbVmClustersListCall) OrderBy(orderBy string) *ProjectsLocationsExadbVmClustersListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of items +// to return. If unspecified, at most 50 ExadbVmClusters will be returned. The +// maximum value is 1000; values above 1000 will be coerced to 1000. +func (c *ProjectsLocationsExadbVmClustersListCall) PageSize(pageSize int64) *ProjectsLocationsExadbVmClustersListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token identifying a +// page of results the server should return. +func (c *ProjectsLocationsExadbVmClustersListCall) PageToken(pageToken string) *ProjectsLocationsExadbVmClustersListCall { + 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 *ProjectsLocationsExadbVmClustersListCall) Fields(s ...googleapi.Field) *ProjectsLocationsExadbVmClustersListCall { + 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 *ProjectsLocationsExadbVmClustersListCall) IfNoneMatch(entityTag string) *ProjectsLocationsExadbVmClustersListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExadbVmClustersListCall) Context(ctx context.Context) *ProjectsLocationsExadbVmClustersListCall { + 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 *ProjectsLocationsExadbVmClustersListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExadbVmClustersListCall) 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}/exadbVmClusters") + 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", "oracledatabase.projects.locations.exadbVmClusters.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exadbVmClusters.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListExadbVmClustersResponse.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 *ProjectsLocationsExadbVmClustersListCall) Do(opts ...googleapi.CallOption) (*ListExadbVmClustersResponse, 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 := &ListExadbVmClustersResponse{ + 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.exadbVmClusters.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 *ProjectsLocationsExadbVmClustersListCall) Pages(ctx context.Context, f func(*ListExadbVmClustersResponse) 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 ProjectsLocationsExadbVmClustersPatchCall struct { + s *Service + name string + exadbvmcluster *ExadbVmCluster + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a single Exadb (Exascale) VM Cluster. To add virtual machines +// to existing exadb vm cluster, only pass the node count. +// +// - name: Identifier. The name of the ExadbVmCluster resource in the following +// format: +// projects/{project}/locations/{region}/exadbVmClusters/{exadb_vm_cluster}. +func (r *ProjectsLocationsExadbVmClustersService) Patch(name string, exadbvmcluster *ExadbVmCluster) *ProjectsLocationsExadbVmClustersPatchCall { + c := &ProjectsLocationsExadbVmClustersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.exadbvmcluster = exadbvmcluster + return c +} + +// RequestId sets the optional parameter "requestId": An optional ID to +// identify the request. This value is used to identify duplicate requests. If +// you make a request with the same request ID and the original request is +// still in progress or completed, the server ignores the second request. This +// prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsExadbVmClustersPatchCall) RequestId(requestId string) *ProjectsLocationsExadbVmClustersPatchCall { + c.urlParams_.Set("requestId", requestId) + return c +} + +// UpdateMask sets the optional parameter "updateMask": A mask specifying which +// fields in th VM Cluster should be updated. A field specified in the mask is +// overwritten. If a mask isn't provided then all the fields in the VM Cluster +// are overwritten. +func (c *ProjectsLocationsExadbVmClustersPatchCall) UpdateMask(updateMask string) *ProjectsLocationsExadbVmClustersPatchCall { + 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 *ProjectsLocationsExadbVmClustersPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsExadbVmClustersPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExadbVmClustersPatchCall) Context(ctx context.Context) *ProjectsLocationsExadbVmClustersPatchCall { + 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 *ProjectsLocationsExadbVmClustersPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExadbVmClustersPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.exadbvmcluster) + 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", "oracledatabase.projects.locations.exadbVmClusters.patch", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exadbVmClusters.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 *ProjectsLocationsExadbVmClustersPatchCall) 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.exadbVmClusters.patch", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall struct { + s *Service + name string + removevirtualmachineexadbvmclusterrequest *RemoveVirtualMachineExadbVmClusterRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RemoveVirtualMachine: Removes virtual machines from an existing exadb vm +// cluster. +// +// - name: The name of the ExadbVmCluster in the following format: +// projects/{project}/locations/{location}/exadbVmClusters/{exadb_vm_cluster}. +func (r *ProjectsLocationsExadbVmClustersService) RemoveVirtualMachine(name string, removevirtualmachineexadbvmclusterrequest *RemoveVirtualMachineExadbVmClusterRequest) *ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall { + c := &ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.removevirtualmachineexadbvmclusterrequest = removevirtualmachineexadbvmclusterrequest + 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 *ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall) Fields(s ...googleapi.Field) *ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall) Context(ctx context.Context) *ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall { + 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 *ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.removevirtualmachineexadbvmclusterrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:removeVirtualMachine") + 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.exadbVmClusters.removeVirtualMachine", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exadbVmClusters.removeVirtualMachine" 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 *ProjectsLocationsExadbVmClustersRemoveVirtualMachineCall) 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.exadbVmClusters.removeVirtualMachine", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsExascaleDbStorageVaultsCreateCall struct { + s *Service + parent string + exascaledbstoragevault *ExascaleDbStorageVault + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new ExascaleDB Storage Vault resource. +// +// - parent: The value for parent of the ExascaleDbStorageVault in the +// following format: projects/{project}/locations/{location}. +func (r *ProjectsLocationsExascaleDbStorageVaultsService) Create(parent string, exascaledbstoragevault *ExascaleDbStorageVault) *ProjectsLocationsExascaleDbStorageVaultsCreateCall { + c := &ProjectsLocationsExascaleDbStorageVaultsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.exascaledbstoragevault = exascaledbstoragevault + return c +} + +// ExascaleDbStorageVaultId sets the optional parameter +// "exascaleDbStorageVaultId": Required. The ID of the ExascaleDbStorageVault +// to create. This value is restricted to (^a-z ([a-z0-9-]{0,61}[a-z0-9])?$) +// and must be a maximum of 63 characters in length. The value must start with +// a letter and end with a letter or a number. +func (c *ProjectsLocationsExascaleDbStorageVaultsCreateCall) ExascaleDbStorageVaultId(exascaleDbStorageVaultId string) *ProjectsLocationsExascaleDbStorageVaultsCreateCall { + c.urlParams_.Set("exascaleDbStorageVaultId", exascaleDbStorageVaultId) + return c +} + +// RequestId sets the optional parameter "requestId": An optional request ID to +// identify requests. Specify a unique request ID so that if you must retry +// your request, the server will know to ignore the request if it has already +// been completed. The server will guarantee that for at least 60 minutes since +// the first request. For example, consider a situation where you make an +// initial request and the request times out. If you make the request again +// with the same request ID, the server can check if original operation with +// the same request ID was received, and if so, will ignore the second request. +// This prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsExascaleDbStorageVaultsCreateCall) RequestId(requestId string) *ProjectsLocationsExascaleDbStorageVaultsCreateCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsExascaleDbStorageVaultsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExascaleDbStorageVaultsCreateCall) Context(ctx context.Context) *ProjectsLocationsExascaleDbStorageVaultsCreateCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExascaleDbStorageVaultsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.exascaledbstoragevault) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/exascaleDbStorageVaults") + 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", "oracledatabase.projects.locations.exascaleDbStorageVaults.create", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exascaleDbStorageVaults.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 *ProjectsLocationsExascaleDbStorageVaultsCreateCall) 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.exascaleDbStorageVaults.create", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsExascaleDbStorageVaultsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a single ExascaleDB Storage Vault. +// +// - name: The name of the ExascaleDbStorageVault in the following format: +// projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_d +// b_storage_vault}. +func (r *ProjectsLocationsExascaleDbStorageVaultsService) Delete(name string) *ProjectsLocationsExascaleDbStorageVaultsDeleteCall { + c := &ProjectsLocationsExascaleDbStorageVaultsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// RequestId sets the optional parameter "requestId": An optional ID to +// identify the request. This value is used to identify duplicate requests. If +// you make a request with the same request ID and the original request is +// still in progress or completed, the server ignores the second request. This +// prevents clients from accidentally creating duplicate commitments. The +// request ID must be a valid UUID with the exception that zero UUID is not +// supported (00000000-0000-0000-0000-000000000000). +func (c *ProjectsLocationsExascaleDbStorageVaultsDeleteCall) RequestId(requestId string) *ProjectsLocationsExascaleDbStorageVaultsDeleteCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsExascaleDbStorageVaultsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExascaleDbStorageVaultsDeleteCall) Context(ctx context.Context) *ProjectsLocationsExascaleDbStorageVaultsDeleteCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExascaleDbStorageVaultsDeleteCall) 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", "oracledatabase.projects.locations.exascaleDbStorageVaults.delete", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exascaleDbStorageVaults.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 *ProjectsLocationsExascaleDbStorageVaultsDeleteCall) 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.exascaleDbStorageVaults.delete", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsExascaleDbStorageVaultsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets details of a single ExascaleDB Storage Vault. +// +// - name: The name of the ExascaleDbStorageVault in the following format: +// projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_d +// b_storage_vault}. +func (r *ProjectsLocationsExascaleDbStorageVaultsService) Get(name string) *ProjectsLocationsExascaleDbStorageVaultsGetCall { + c := &ProjectsLocationsExascaleDbStorageVaultsGetCall{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 *ProjectsLocationsExascaleDbStorageVaultsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsExascaleDbStorageVaultsGetCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsExascaleDbStorageVaultsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExascaleDbStorageVaultsGetCall) Context(ctx context.Context) *ProjectsLocationsExascaleDbStorageVaultsGetCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExascaleDbStorageVaultsGetCall) 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", "oracledatabase.projects.locations.exascaleDbStorageVaults.get", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exascaleDbStorageVaults.get" call. +// Any non-2xx status code is an error. Response headers are in either +// *ExascaleDbStorageVault.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 *ProjectsLocationsExascaleDbStorageVaultsGetCall) Do(opts ...googleapi.CallOption) (*ExascaleDbStorageVault, 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 := &ExascaleDbStorageVault{ + 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.exascaleDbStorageVaults.get", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + +type ProjectsLocationsExascaleDbStorageVaultsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all the ExascaleDB Storage Vaults for the given project and +// location. +// +// - parent: The parent value for ExascaleDbStorageVault in the following +// format: projects/{project}/locations/{location}. +func (r *ProjectsLocationsExascaleDbStorageVaultsService) List(parent string) *ProjectsLocationsExascaleDbStorageVaultsListCall { + c := &ProjectsLocationsExascaleDbStorageVaultsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": An expression for filtering the +// results of the request. Filter the list as specified in +// https://google.aip.dev/160. +func (c *ProjectsLocationsExascaleDbStorageVaultsListCall) Filter(filter string) *ProjectsLocationsExascaleDbStorageVaultsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": An expression for ordering +// the results of the request. Order results as specified in +// https://google.aip.dev/132. +func (c *ProjectsLocationsExascaleDbStorageVaultsListCall) OrderBy(orderBy string) *ProjectsLocationsExascaleDbStorageVaultsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of items +// to return. If unspecified, at most 50 ExascaleDbStorageVaults will be +// returned. The maximum value is 1000; values above 1000 will be coerced to +// 1000. +func (c *ProjectsLocationsExascaleDbStorageVaultsListCall) PageSize(pageSize int64) *ProjectsLocationsExascaleDbStorageVaultsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token identifying a +// page of results the server should return. +func (c *ProjectsLocationsExascaleDbStorageVaultsListCall) PageToken(pageToken string) *ProjectsLocationsExascaleDbStorageVaultsListCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsExascaleDbStorageVaultsListCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsExascaleDbStorageVaultsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsExascaleDbStorageVaultsListCall) Context(ctx context.Context) *ProjectsLocationsExascaleDbStorageVaultsListCall { + 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 *ProjectsLocationsExascaleDbStorageVaultsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsExascaleDbStorageVaultsListCall) 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}/exascaleDbStorageVaults") + 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", "oracledatabase.projects.locations.exascaleDbStorageVaults.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.exascaleDbStorageVaults.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListExascaleDbStorageVaultsResponse.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 *ProjectsLocationsExascaleDbStorageVaultsListCall) Do(opts ...googleapi.CallOption) (*ListExascaleDbStorageVaultsResponse, 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 := &ListExascaleDbStorageVaultsResponse{ + 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.exascaleDbStorageVaults.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 *ProjectsLocationsExascaleDbStorageVaultsListCall) Pages(ctx context.Context, f func(*ListExascaleDbStorageVaultsResponse) 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 ProjectsLocationsGiVersionsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all the valid Oracle Grid Infrastructure (GI) versions for the +// given project and location. +// +// - parent: The parent value for Grid Infrastructure Version in the following +// format: Format: projects/{project}/locations/{location}. +func (r *ProjectsLocationsGiVersionsService) List(parent string) *ProjectsLocationsGiVersionsListCall { + c := &ProjectsLocationsGiVersionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": An expression for filtering the +// results of the request. Only the shape, gcp_oracle_zone and gi_version +// fields are supported in this format: `shape="{shape}". +func (c *ProjectsLocationsGiVersionsListCall) Filter(filter string) *ProjectsLocationsGiVersionsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of items +// to return. If unspecified, a maximum of 50 Oracle Grid Infrastructure (GI) +// versions will be returned. The maximum value is 1000; values above 1000 will +// be reset to 1000. +func (c *ProjectsLocationsGiVersionsListCall) PageSize(pageSize int64) *ProjectsLocationsGiVersionsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token identifying a +// page of results the server should return. +func (c *ProjectsLocationsGiVersionsListCall) PageToken(pageToken string) *ProjectsLocationsGiVersionsListCall { + 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 *ProjectsLocationsGiVersionsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGiVersionsListCall { + 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 *ProjectsLocationsGiVersionsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGiVersionsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGiVersionsListCall) Context(ctx context.Context) *ProjectsLocationsGiVersionsListCall { + 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 *ProjectsLocationsGiVersionsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGiVersionsListCall) 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}/giVersions") + 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", "oracledatabase.projects.locations.giVersions.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.giVersions.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListGiVersionsResponse.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 *ProjectsLocationsGiVersionsListCall) Do(opts ...googleapi.CallOption) (*ListGiVersionsResponse, 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 := &ListGiVersionsResponse{ + 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.giVersions.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 *ProjectsLocationsGiVersionsListCall) Pages(ctx context.Context, f func(*ListGiVersionsResponse) 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 ProjectsLocationsGiVersionsMinorVersionsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists all the valid minor versions for the given project, location, gi +// version and shape family. +// +// - parent: The parent value for the MinorVersion resource with the format: +// projects/{project}/locations/{location}/giVersions/{gi_version}. +func (r *ProjectsLocationsGiVersionsMinorVersionsService) List(parent string) *ProjectsLocationsGiVersionsMinorVersionsListCall { + c := &ProjectsLocationsGiVersionsMinorVersionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": An expression for filtering the +// results of the request. Only shapeFamily and gcp_oracle_zone_id are +// supported in this format: `shape_family="{shapeFamily}" AND +// gcp_oracle_zone_id="{gcp_oracle_zone_id}". +func (c *ProjectsLocationsGiVersionsMinorVersionsListCall) Filter(filter string) *ProjectsLocationsGiVersionsMinorVersionsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number of items +// to return. If unspecified, a maximum of 50 System Versions will be returned. +// The maximum value is 1000; values above 1000 will be reset to 1000. +func (c *ProjectsLocationsGiVersionsMinorVersionsListCall) PageSize(pageSize int64) *ProjectsLocationsGiVersionsMinorVersionsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A token identifying the +// requested page of results to return. All fields except the filter should +// remain the same as in the request that provided this page token. +func (c *ProjectsLocationsGiVersionsMinorVersionsListCall) PageToken(pageToken string) *ProjectsLocationsGiVersionsMinorVersionsListCall { + 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 *ProjectsLocationsGiVersionsMinorVersionsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGiVersionsMinorVersionsListCall { + 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 *ProjectsLocationsGiVersionsMinorVersionsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGiVersionsMinorVersionsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *ProjectsLocationsGiVersionsMinorVersionsListCall) Context(ctx context.Context) *ProjectsLocationsGiVersionsMinorVersionsListCall { + 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 *ProjectsLocationsGiVersionsMinorVersionsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGiVersionsMinorVersionsListCall) 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}/minorVersions") + 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", "oracledatabase.projects.locations.giVersions.minorVersions.list", "request", internallog.HTTPRequest(req, nil)) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "oracledatabase.projects.locations.giVersions.minorVersions.list" call. +// Any non-2xx status code is an error. Response headers are in either +// *ListMinorVersionsResponse.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 *ProjectsLocationsGiVersionsMinorVersionsListCall) Do(opts ...googleapi.CallOption) (*ListMinorVersionsResponse, 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 := &ListMinorVersionsResponse{ + 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.giVersions.minorVersions.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 *ProjectsLocationsGiVersionsMinorVersionsListCall) Pages(ctx context.Context, f func(*ListMinorVersionsResponse) error) error { c.ctx_ = ctx defer c.PageToken(c.urlParams_.Get("pageToken")) for { diff --git a/parallelstore/v1/parallelstore-api.json b/parallelstore/v1/parallelstore-api.json index 35a58dc6da6..871ce2ce76b 100644 --- a/parallelstore/v1/parallelstore-api.json +++ b/parallelstore/v1/parallelstore-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -549,7 +549,7 @@ } } }, - "revision": "20250820", + "revision": "20250908", "rootUrl": "https://parallelstore.googleapis.com/", "schemas": { "CancelOperationRequest": { diff --git a/parallelstore/v1/parallelstore-gen.go b/parallelstore/v1/parallelstore-gen.go index 202ee2fd45b..1a772968777 100644 --- a/parallelstore/v1/parallelstore-gen.go +++ b/parallelstore/v1/parallelstore-gen.go @@ -959,9 +959,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/parallelstore/v1beta/parallelstore-api.json b/parallelstore/v1beta/parallelstore-api.json index b72f7780394..36f88515d9c 100644 --- a/parallelstore/v1beta/parallelstore-api.json +++ b/parallelstore/v1beta/parallelstore-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -546,7 +546,7 @@ } } }, - "revision": "20250820", + "revision": "20250908", "rootUrl": "https://parallelstore.googleapis.com/", "schemas": { "DestinationGcsBucket": { diff --git a/parallelstore/v1beta/parallelstore-gen.go b/parallelstore/v1beta/parallelstore-gen.go index 1040399c5ee..6425f42e346 100644 --- a/parallelstore/v1beta/parallelstore-gen.go +++ b/parallelstore/v1beta/parallelstore-gen.go @@ -955,9 +955,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/parametermanager/v1/parametermanager-api.json b/parametermanager/v1/parametermanager-api.json index 1dea116d6b6..c62e451d5b2 100644 --- a/parametermanager/v1/parametermanager-api.json +++ b/parametermanager/v1/parametermanager-api.json @@ -140,6 +140,96 @@ "description": "Regional Endpoint", "endpointUrl": "https://parametermanager.northamerica-northeast2.rep.googleapis.com/", "location": "northamerica-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.europe-west12.rep.googleapis.com/", + "location": "europe-west12" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.africa-south1.rep.googleapis.com/", + "location": "africa-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.asia-southeast1.rep.googleapis.com/", + "location": "asia-southeast1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.asia-southeast2.rep.googleapis.com/", + "location": "asia-southeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.me-central1.rep.googleapis.com/", + "location": "me-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.southamerica-east1.rep.googleapis.com/", + "location": "southamerica-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.asia-south1.rep.googleapis.com/", + "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.europe-west10.rep.googleapis.com/", + "location": "europe-west10" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.europe-north1.rep.googleapis.com/", + "location": "europe-north1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.europe-central2.rep.googleapis.com/", + "location": "europe-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.europe-southwest1.rep.googleapis.com/", + "location": "europe-southwest1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.asia-south2.rep.googleapis.com/", + "location": "asia-south2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.asia-east1.rep.googleapis.com/", + "location": "asia-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.asia-east2.rep.googleapis.com/", + "location": "asia-east2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.asia-northeast2.rep.googleapis.com/", + "location": "asia-northeast2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.asia-northeast3.rep.googleapis.com/", + "location": "asia-northeast3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.northamerica-south1.rep.googleapis.com/", + "location": "northamerica-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://parametermanager.southamerica-west1.rep.googleapis.com/", + "location": "southamerica-west1" } ], "fullyEncodeReservedExpansion": true, @@ -271,7 +361,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -721,7 +811,7 @@ } } }, - "revision": "20250813", + "revision": "20250917", "rootUrl": "https://parametermanager.googleapis.com/", "schemas": { "Empty": { diff --git a/parametermanager/v1/parametermanager-gen.go b/parametermanager/v1/parametermanager-gen.go index a0ed077c1e9..b9d2c9b05f8 100644 --- a/parametermanager/v1/parametermanager-gen.go +++ b/parametermanager/v1/parametermanager-gen.go @@ -650,9 +650,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/places/v1/places-api.json b/places/v1/places-api.json index 63115514820..d0db24aa0b4 100644 --- a/places/v1/places-api.json +++ b/places/v1/places-api.json @@ -280,7 +280,7 @@ } } }, - "revision": "20250810", + "revision": "20250921", "rootUrl": "https://places.googleapis.com/", "schemas": { "GoogleGeoTypeViewport": { @@ -1056,6 +1056,10 @@ ], "type": "string" }, + "consumerAlert": { + "$ref": "GoogleMapsPlacesV1PlaceConsumerAlert", + "description": "The consumer alert message for the place when we detect suspicious review activity on a business or a business violates our policies." + }, "containingPlaces": { "description": "List of places in which the current place is located.", "items": { @@ -1423,6 +1427,59 @@ }, "type": "object" }, + "GoogleMapsPlacesV1PlaceConsumerAlert": { + "description": "The consumer alert message for the place when we detect suspicious review activity on a business or a business violates our policies.", + "id": "GoogleMapsPlacesV1PlaceConsumerAlert", + "properties": { + "details": { + "$ref": "GoogleMapsPlacesV1PlaceConsumerAlertDetails", + "description": "The details of the consumer alert message.ƒ" + }, + "languageCode": { + "description": "The language code of the consumer alert message. This is a BCP 47 language code.", + "type": "string" + }, + "overview": { + "description": "The overview of the consumer alert message.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceConsumerAlertDetails": { + "description": "The details of the consumer alert message.", + "id": "GoogleMapsPlacesV1PlaceConsumerAlertDetails", + "properties": { + "aboutLink": { + "$ref": "GoogleMapsPlacesV1PlaceConsumerAlertDetailsLink", + "description": "The link to show together with the description to provide more information." + }, + "description": { + "description": "The description of the consumer alert message.", + "type": "string" + }, + "title": { + "description": "The title to show together with the description.", + "type": "string" + } + }, + "type": "object" + }, + "GoogleMapsPlacesV1PlaceConsumerAlertDetailsLink": { + "description": "The link to show together with the description to provide more information.", + "id": "GoogleMapsPlacesV1PlaceConsumerAlertDetailsLink", + "properties": { + "title": { + "description": "The title to show for the link.", + "type": "string" + }, + "uri": { + "description": "The uri of the link.", + "type": "string" + } + }, + "type": "object" + }, "GoogleMapsPlacesV1PlaceContainingPlace": { "description": "Info about the place in which this place is located.", "id": "GoogleMapsPlacesV1PlaceContainingPlace", @@ -1850,6 +1907,10 @@ "text": { "$ref": "GoogleTypeLocalizedText", "description": "The localized text of the review." + }, + "visitDate": { + "$ref": "GoogleTypeDate", + "description": "The date when the author visited the place. This is trucated to the year and month of the visit." } }, "type": "object" diff --git a/places/v1/places-gen.go b/places/v1/places-gen.go index 00c9bb22477..50f5c795bc4 100644 --- a/places/v1/places-gen.go +++ b/places/v1/places-gen.go @@ -1325,6 +1325,10 @@ type GoogleMapsPlacesV1Place struct { // "CLOSED_TEMPORARILY" - The establishment is temporarily closed. // "CLOSED_PERMANENTLY" - The establishment is permanently closed. BusinessStatus string `json:"businessStatus,omitempty"` + // ConsumerAlert: The consumer alert message for the place when we detect + // suspicious review activity on a business or a business violates our + // policies. + ConsumerAlert *GoogleMapsPlacesV1PlaceConsumerAlert `json:"consumerAlert,omitempty"` // ContainingPlaces: List of places in which the current place is located. ContainingPlaces []*GoogleMapsPlacesV1PlaceContainingPlace `json:"containingPlaces,omitempty"` // CurbsidePickup: Specifies if the business supports curbside pickup. @@ -1655,6 +1659,88 @@ func (s GoogleMapsPlacesV1PlaceAttribution) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleMapsPlacesV1PlaceConsumerAlert: The consumer alert message for the +// place when we detect suspicious review activity on a business or a business +// violates our policies. +type GoogleMapsPlacesV1PlaceConsumerAlert struct { + // Details: The details of the consumer alert message.ƒ + Details *GoogleMapsPlacesV1PlaceConsumerAlertDetails `json:"details,omitempty"` + // LanguageCode: The language code of the consumer alert message. This is a BCP + // 47 language code. + LanguageCode string `json:"languageCode,omitempty"` + // Overview: The overview of the consumer alert message. + Overview string `json:"overview,omitempty"` + // ForceSendFields is a list of field names (e.g. "Details") 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. "Details") 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 GoogleMapsPlacesV1PlaceConsumerAlert) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceConsumerAlert + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlaceConsumerAlertDetails: The details of the consumer +// alert message. +type GoogleMapsPlacesV1PlaceConsumerAlertDetails struct { + // AboutLink: The link to show together with the description to provide more + // information. + AboutLink *GoogleMapsPlacesV1PlaceConsumerAlertDetailsLink `json:"aboutLink,omitempty"` + // Description: The description of the consumer alert message. + Description string `json:"description,omitempty"` + // Title: The title to show together with the description. + Title string `json:"title,omitempty"` + // ForceSendFields is a list of field names (e.g. "AboutLink") 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. "AboutLink") 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 GoogleMapsPlacesV1PlaceConsumerAlertDetails) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceConsumerAlertDetails + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleMapsPlacesV1PlaceConsumerAlertDetailsLink: The link to show together +// with the description to provide more information. +type GoogleMapsPlacesV1PlaceConsumerAlertDetailsLink struct { + // Title: The title to show for the link. + Title string `json:"title,omitempty"` + // Uri: The uri of the link. + Uri string `json:"uri,omitempty"` + // ForceSendFields is a list of field names (e.g. "Title") 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 + // 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 GoogleMapsPlacesV1PlaceConsumerAlertDetailsLink) MarshalJSON() ([]byte, error) { + type NoMethod GoogleMapsPlacesV1PlaceConsumerAlertDetailsLink + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleMapsPlacesV1PlaceContainingPlace: Info about the place in which this // place is located. type GoogleMapsPlacesV1PlaceContainingPlace struct { @@ -2218,6 +2304,9 @@ type GoogleMapsPlacesV1Review struct { RelativePublishTimeDescription string `json:"relativePublishTimeDescription,omitempty"` // Text: The localized text of the review. Text *GoogleTypeLocalizedText `json:"text,omitempty"` + // VisitDate: The date when the author visited the place. This is trucated to + // the year and month of the visit. + VisitDate *GoogleTypeDate `json:"visitDate,omitempty"` // ForceSendFields is a list of field names (e.g. "AuthorAttribution") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See diff --git a/privateca/v1/privateca-api.json b/privateca/v1/privateca-api.json index 6c510b39dc0..0a602764962 100644 --- a/privateca/v1/privateca-api.json +++ b/privateca/v1/privateca-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1611,7 +1611,7 @@ } } }, - "revision": "20250901", + "revision": "20250910", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AccessUrls": { diff --git a/privateca/v1/privateca-gen.go b/privateca/v1/privateca-gen.go index 431b845894c..3c97e58225d 100644 --- a/privateca/v1/privateca-gen.go +++ b/privateca/v1/privateca-gen.go @@ -3132,9 +3132,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/privateca/v1beta1/privateca-api.json b/privateca/v1beta1/privateca-api.json index 3f4a46251b7..d265ffdc86b 100644 --- a/privateca/v1beta1/privateca-api.json +++ b/privateca/v1beta1/privateca-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -586,7 +586,7 @@ } } }, - "revision": "20250901", + "revision": "20250910", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/privateca/v1beta1/privateca-gen.go b/privateca/v1beta1/privateca-gen.go index b6dd07dfdc2..638017671c3 100644 --- a/privateca/v1beta1/privateca-gen.go +++ b/privateca/v1beta1/privateca-gen.go @@ -934,9 +934,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/recaptchaenterprise/v1/recaptchaenterprise-api.json b/recaptchaenterprise/v1/recaptchaenterprise-api.json index 874104a68e5..e5f5d49d255 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-api.json +++ b/recaptchaenterprise/v1/recaptchaenterprise-api.json @@ -786,7 +786,7 @@ } } }, - "revision": "20250706", + "revision": "20250917", "rootUrl": "https://recaptchaenterprise.googleapis.com/", "schemas": { "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": { @@ -947,6 +947,10 @@ "format": "byte", "type": "string" }, + "phoneAuthenticationEvent": { + "$ref": "GoogleCloudRecaptchaenterpriseV1PhoneAuthenticationEvent", + "description": "Optional. If using an external multi-factor authentication provider, provide phone authentication details for fraud detection purposes." + }, "reasons": { "description": "Optional. Reasons for the annotation that are assigned to the event.", "items": { @@ -1793,6 +1797,22 @@ }, "type": "object" }, + "GoogleCloudRecaptchaenterpriseV1PhoneAuthenticationEvent": { + "description": "Details on a phone authentication event", + "id": "GoogleCloudRecaptchaenterpriseV1PhoneAuthenticationEvent", + "properties": { + "eventTime": { + "description": "Optional. The time at which the multi-factor authentication event (challenge or verification) occurred.", + "format": "google-datetime", + "type": "string" + }, + "phoneNumber": { + "description": "Required. Phone number in E.164 format for which a multi-factor authentication challenge was initiated, succeeded, or failed.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment": { "description": "Assessment for Phone Fraud", "id": "GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment", diff --git a/recaptchaenterprise/v1/recaptchaenterprise-gen.go b/recaptchaenterprise/v1/recaptchaenterprise-gen.go index 191218f134e..7c2bb52b96e 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-gen.go +++ b/recaptchaenterprise/v1/recaptchaenterprise-gen.go @@ -417,6 +417,10 @@ type GoogleCloudRecaptchaenterpriseV1AnnotateAssessmentRequest struct { // `CreateAssessment`, for example when a stable account identifier is not yet // known in the initial request. HashedAccountId string `json:"hashedAccountId,omitempty"` + // PhoneAuthenticationEvent: Optional. If using an external multi-factor + // authentication provider, provide phone authentication details for fraud + // detection purposes. + PhoneAuthenticationEvent *GoogleCloudRecaptchaenterpriseV1PhoneAuthenticationEvent `json:"phoneAuthenticationEvent,omitempty"` // Reasons: Optional. Reasons for the annotation that are assigned to the // event. // @@ -1628,6 +1632,33 @@ func (s GoogleCloudRecaptchaenterpriseV1MigrateKeyRequest) MarshalJSON() ([]byte return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRecaptchaenterpriseV1PhoneAuthenticationEvent: Details on a phone +// authentication event +type GoogleCloudRecaptchaenterpriseV1PhoneAuthenticationEvent struct { + // EventTime: Optional. The time at which the multi-factor authentication event + // (challenge or verification) occurred. + EventTime string `json:"eventTime,omitempty"` + // PhoneNumber: Required. Phone number in E.164 format for which a multi-factor + // authentication challenge was initiated, succeeded, or failed. + PhoneNumber string `json:"phoneNumber,omitempty"` + // ForceSendFields is a list of field names (e.g. "EventTime") 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. "EventTime") 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 GoogleCloudRecaptchaenterpriseV1PhoneAuthenticationEvent) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecaptchaenterpriseV1PhoneAuthenticationEvent + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment: Assessment for Phone // Fraud type GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment struct { diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index a90a8c48e9d..c0801490976 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -1659,6 +1659,34 @@ }, "placements": { "methods": { + "conversationalSearch": { + "description": "Performs a conversational search. This feature is only available for users who have Conversational Search enabled.", + "flatPath": "v2/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": "v2/{+placement}:conversationalSearch", + "request": { + "$ref": "GoogleCloudRetailV2ConversationalSearchRequest" + }, + "response": { + "$ref": "GoogleCloudRetailV2ConversationalSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "predict": { "description": "Makes a recommendation prediction.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:predict", @@ -1747,6 +1775,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": "v2/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": "v2/{+placement}:conversationalSearch", + "request": { + "$ref": "GoogleCloudRetailV2ConversationalSearchRequest" + }, + "response": { + "$ref": "GoogleCloudRetailV2ConversationalSearchResponse" + }, + "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": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs", @@ -2282,7 +2338,7 @@ } } }, - "revision": "20250717", + "revision": "20250911", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -3251,6 +3307,261 @@ }, "type": "object" }, + "GoogleCloudRetailV2ConversationalSearchRequest": { + "description": "Request message for ConversationalSearchService.ConversationalSearch method.", + "id": "GoogleCloudRetailV2ConversationalSearchRequest", + "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": "GoogleCloudRetailV2ConversationalSearchRequestConversationalFilteringSpec", + "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" + }, + "safetySettings": { + "description": "Optional. The safety settings to be applied to the generated content.", + "items": { + "$ref": "GoogleCloudRetailV2SafetySetting" + }, + "type": "array" + }, + "searchParams": { + "$ref": "GoogleCloudRetailV2ConversationalSearchRequestSearchParams", + "description": "Optional. Search parameters." + }, + "userInfo": { + "$ref": "GoogleCloudRetailV2UserInfo", + "description": "Optional. User information." + }, + "userLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The user labels applied to a resource must meet the following requirements: * Each resource can have multiple labels, up to a maximum of 64. * Each label must be a key-value pair. * Keys have a minimum length of 1 character and a maximum length of 63 characters and cannot be empty. Values can be empty and have a maximum length of 63 characters. * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. * The key portion of a label must be unique. However, you can use the same key with multiple resources. * Keys must start with a lowercase letter or international character. See [Google Cloud Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) for more details.", + "type": "object" + }, + "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" + }, + "GoogleCloudRetailV2ConversationalSearchRequestConversationalFilteringSpec": { + "description": "This field specifies all conversational filtering related parameters addition to conversational retail search.", + "id": "GoogleCloudRetailV2ConversationalSearchRequestConversationalFilteringSpec", + "properties": { + "conversationalFilteringMode": { + "description": "Optional. Mode to control Conversational Filtering. Defaults to Mode.DISABLED if it's unset.", + "enum": [ + "MODE_UNSPECIFIED", + "DISABLED", + "ENABLED", + "CONVERSATIONAL_FILTER_ONLY" + ], + "enumDescriptions": [ + "Default value.", + "Disables Conversational Filtering when using Conversational Search.", + "Enables Conversational Filtering when using Conversational Search.", + "Enables Conversational Filtering without Conversational Search." + ], + "type": "string" + }, + "enableConversationalFiltering": { + "deprecated": true, + "description": "Optional. This field is deprecated. Please use ConversationalFilteringSpec.conversational_filtering_mode instead.", + "type": "boolean" + }, + "userAnswer": { + "$ref": "GoogleCloudRetailV2ConversationalSearchRequestUserAnswer", + "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" + }, + "GoogleCloudRetailV2ConversationalSearchRequestSearchParams": { + "description": "Search parameters.", + "id": "GoogleCloudRetailV2ConversationalSearchRequestSearchParams", + "properties": { + "boostSpec": { + "$ref": "GoogleCloudRetailV2SearchRequestBoostSpec", + "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" + }, + "GoogleCloudRetailV2ConversationalSearchRequestUserAnswer": { + "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": "GoogleCloudRetailV2ConversationalSearchRequestUserAnswer", + "properties": { + "selectedAnswer": { + "$ref": "GoogleCloudRetailV2ConversationalSearchRequestUserAnswerSelectedAnswer", + "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" + }, + "GoogleCloudRetailV2ConversationalSearchRequestUserAnswerSelectedAnswer": { + "description": "This field specifies the selected answers during the conversational search.", + "id": "GoogleCloudRetailV2ConversationalSearchRequestUserAnswerSelectedAnswer", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2ProductAttributeValue", + "description": "Optional. This field specifies the selected answer which is a attribute key-value." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2ConversationalSearchResponse": { + "description": "Response message for ConversationalSearchService.ConversationalSearch method.", + "id": "GoogleCloudRetailV2ConversationalSearchResponse", + "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": "GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResult", + "description": "This field specifies all related information that is needed on client side for UI rendering of conversational filtering search." + }, + "conversationalTextResponse": { + "description": "The conversational answer-based text response generated by the Server.", + "type": "string" + }, + "followupQuestion": { + "$ref": "GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion", + "description": "The conversational followup question generated for Intent refinement." + }, + "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": "GoogleCloudRetailV2ConversationalSearchResponseRefinedSearch" + }, + "type": "array" + }, + "state": { + "description": "Output only. The state of the response generation.", + "enum": [ + "STATE_UNSPECIFIED", + "STREAMING", + "SUCCEEDED" + ], + "enumDescriptions": [ + "Unknown.", + "Response generation is being streamed.", + "Response generation has succeeded." + ], + "readOnly": true, + "type": "string" + }, + "userQueryTypes": { + "description": "The types Retail classifies the search query as. Supported values are: - \"ORDER_SUPPORT\" - \"SIMPLE_PRODUCT_SEARCH\" - \"INTENT_REFINEMENT\" - \"PRODUCT_DETAILS\" - \"PRODUCT_COMPARISON\" - \"DEALS_AND_COUPONS\" - \"STORE_RELEVANT\" - \"BLOCKLISTED\" - \"BEST_PRODUCT\" - \"RETAIL_SUPPORT\" - \"DISABLED\"", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResult": { + "description": "This field specifies all related information that is needed on client side for UI rendering of conversational filtering search.", + "id": "GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResult", + "properties": { + "additionalFilter": { + "$ref": "GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResultAdditionalFilter", + "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": "GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion", + "description": "The conversational filtering question." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResultAdditionalFilter": { + "description": "Additional filter that client side need to apply.", + "id": "GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResultAdditionalFilter", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2ProductAttributeValue", + "description": "Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion": { + "description": "The conversational followup question generated for Intent refinement.", + "id": "GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion", + "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": "GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestionSuggestedAnswer" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestionSuggestedAnswer": { + "description": "Suggested answers to the follow-up question. If it's numerical attribute, only ProductAttributeInterval will be set. If it's textual attribute, only productAttributeValue will be set.", + "id": "GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestionSuggestedAnswer", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2ProductAttributeValue", + "description": "Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2ConversationalSearchResponseRefinedSearch": { + "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": "GoogleCloudRetailV2ConversationalSearchResponseRefinedSearch", + "properties": { + "query": { + "description": "The query to be used for search.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRetailV2CreateModelMetadata": { "description": "Metadata associated with a create operation.", "id": "GoogleCloudRetailV2CreateModelMetadata", @@ -5347,6 +5658,67 @@ }, "type": "object" }, + "GoogleCloudRetailV2SafetySetting": { + "description": "Safety settings.", + "id": "GoogleCloudRetailV2SafetySetting", + "properties": { + "category": { + "description": "Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "type": "string" + }, + "method": { + "description": "Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score.", + "enum": [ + "HARM_BLOCK_METHOD_UNSPECIFIED", + "SEVERITY", + "PROBABILITY" + ], + "enumDescriptions": [ + "The harm block method is unspecified.", + "The harm block method uses both probability and severity scores.", + "The harm block method uses the probability score." + ], + "type": "string" + }, + "threshold": { + "description": "The harm block threshold.", + "enum": [ + "HARM_BLOCK_THRESHOLD_UNSPECIFIED", + "BLOCK_LOW_AND_ABOVE", + "BLOCK_MEDIUM_AND_ABOVE", + "BLOCK_ONLY_HIGH", + "BLOCK_NONE", + "OFF" + ], + "enumDescriptions": [ + "Unspecified harm block threshold.", + "Block low threshold and above (i.e. block more).", + "Block medium threshold and above.", + "Block only high threshold (i.e. block less).", + "Block none.", + "Turn off the safety filter." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRetailV2SearchRequest": { "description": "Request message for SearchService.Search method.", "id": "GoogleCloudRetailV2SearchRequest", diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index d41dd96a1c9..f8bb15136a7 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -1812,6 +1812,401 @@ func (s GoogleCloudRetailV2ConversationalSearchCustomizationConfig) MarshalJSON( return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2ConversationalSearchRequest: Request message for +// ConversationalSearchService.ConversationalSearch method. +type GoogleCloudRetailV2ConversationalSearchRequest 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 *GoogleCloudRetailV2ConversationalSearchRequestConversationalFilteringSpec `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"` + // SafetySettings: Optional. The safety settings to be applied to the generated + // content. + SafetySettings []*GoogleCloudRetailV2SafetySetting `json:"safetySettings,omitempty"` + // SearchParams: Optional. Search parameters. + SearchParams *GoogleCloudRetailV2ConversationalSearchRequestSearchParams `json:"searchParams,omitempty"` + // UserInfo: Optional. User information. + UserInfo *GoogleCloudRetailV2UserInfo `json:"userInfo,omitempty"` + // UserLabels: Optional. The user labels applied to a resource must meet the + // following requirements: * Each resource can have multiple labels, up to a + // maximum of 64. * Each label must be a key-value pair. * Keys have a minimum + // length of 1 character and a maximum length of 63 characters and cannot be + // empty. Values can be empty and have a maximum length of 63 characters. * + // Keys and values can contain only lowercase letters, numeric characters, + // underscores, and dashes. All characters must use UTF-8 encoding, and + // international characters are allowed. * The key portion of a label must be + // unique. However, you can use the same key with multiple resources. * Keys + // must start with a lowercase letter or international character. See Google + // Cloud Document + // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) + // for more details. + UserLabels map[string]string `json:"userLabels,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 GoogleCloudRetailV2ConversationalSearchRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchRequestConversationalFilteringSpec: +// This field specifies all conversational filtering related parameters +// addition to conversational retail search. +type GoogleCloudRetailV2ConversationalSearchRequestConversationalFilteringSpec struct { + // ConversationalFilteringMode: Optional. Mode to control Conversational + // Filtering. Defaults to Mode.DISABLED if it's unset. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. + // "DISABLED" - Disables Conversational Filtering when using Conversational + // Search. + // "ENABLED" - Enables Conversational Filtering when using Conversational + // Search. + // "CONVERSATIONAL_FILTER_ONLY" - Enables Conversational Filtering without + // 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 *GoogleCloudRetailV2ConversationalSearchRequestUserAnswer `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 GoogleCloudRetailV2ConversationalSearchRequestConversationalFilteringSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchRequestConversationalFilteringSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchRequestSearchParams: Search +// parameters. +type GoogleCloudRetailV2ConversationalSearchRequestSearchParams 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 *GoogleCloudRetailV2SearchRequestBoostSpec `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 GoogleCloudRetailV2ConversationalSearchRequestSearchParams) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchRequestSearchParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchRequestUserAnswer: 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 GoogleCloudRetailV2ConversationalSearchRequestUserAnswer 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 *GoogleCloudRetailV2ConversationalSearchRequestUserAnswerSelectedAnswer `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 GoogleCloudRetailV2ConversationalSearchRequestUserAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchRequestUserAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchRequestUserAnswerSelectedAnswer: This +// field specifies the selected answers during the conversational search. +type GoogleCloudRetailV2ConversationalSearchRequestUserAnswerSelectedAnswer struct { + // ProductAttributeValue: Optional. This field specifies the selected answer + // which is a attribute key-value. + ProductAttributeValue *GoogleCloudRetailV2ProductAttributeValue `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 GoogleCloudRetailV2ConversationalSearchRequestUserAnswerSelectedAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchRequestUserAnswerSelectedAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchResponse: Response message for +// ConversationalSearchService.ConversationalSearch method. +type GoogleCloudRetailV2ConversationalSearchResponse 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 *GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResult `json:"conversationalFilteringResult,omitempty"` + // ConversationalTextResponse: The conversational answer-based text response + // generated by the Server. + ConversationalTextResponse string `json:"conversationalTextResponse,omitempty"` + // FollowupQuestion: The conversational followup question generated for Intent + // refinement. + FollowupQuestion *GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion `json:"followupQuestion,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 []*GoogleCloudRetailV2ConversationalSearchResponseRefinedSearch `json:"refinedSearch,omitempty"` + // State: Output only. The state of the response generation. + // + // Possible values: + // "STATE_UNSPECIFIED" - Unknown. + // "STREAMING" - Response generation is being streamed. + // "SUCCEEDED" - Response generation has succeeded. + State string `json:"state,omitempty"` + // UserQueryTypes: The types Retail classifies the search query as. Supported + // values are: - "ORDER_SUPPORT" - "SIMPLE_PRODUCT_SEARCH" - + // "INTENT_REFINEMENT" - "PRODUCT_DETAILS" - "PRODUCT_COMPARISON" - + // "DEALS_AND_COUPONS" - "STORE_RELEVANT" - "BLOCKLISTED" - "BEST_PRODUCT" - + // "RETAIL_SUPPORT" - "DISABLED" + UserQueryTypes []string `json:"userQueryTypes,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 GoogleCloudRetailV2ConversationalSearchResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResult: +// +// This field specifies all related information that is needed on client side +// +// for UI rendering of conversational filtering search. +type GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResult 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 *GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResultAdditionalFilter `json:"additionalFilter,omitempty"` + // FollowupQuestion: The conversational filtering question. + FollowupQuestion *GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion `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 GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResultA +// dditionalFilter: Additional filter that client side need to apply. +type GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResultAdditionalFilter struct { + // ProductAttributeValue: Product attribute value, including an attribute key + // and an attribute value. Other types can be added here in the future. + ProductAttributeValue *GoogleCloudRetailV2ProductAttributeValue `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 GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResultAdditionalFilter) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchResponseConversationalFilteringResultAdditionalFilter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion: The +// conversational followup question generated for Intent refinement. +type GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion 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 []*GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestionSuggestedAnswer `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 GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestionSuggestedAnswe +// r: Suggested answers to the follow-up question. If it's numerical attribute, +// only ProductAttributeInterval will be set. If it's textual attribute, only +// productAttributeValue will be set. +type GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestionSuggestedAnswer struct { + // ProductAttributeValue: Product attribute value, including an attribute key + // and an attribute value. Other types can be added here in the future. + ProductAttributeValue *GoogleCloudRetailV2ProductAttributeValue `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 GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestionSuggestedAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchResponseFollowupQuestionSuggestedAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2ConversationalSearchResponseRefinedSearch: 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 GoogleCloudRetailV2ConversationalSearchResponseRefinedSearch 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 GoogleCloudRetailV2ConversationalSearchResponseRefinedSearch) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2ConversationalSearchResponseRefinedSearch + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2CreateModelMetadata: Metadata associated with a create // operation. type GoogleCloudRetailV2CreateModelMetadata struct { @@ -5191,6 +5586,58 @@ func (s GoogleCloudRetailV2RuleTwowaySynonymsAction) MarshalJSON() ([]byte, erro return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2SafetySetting: Safety settings. +type GoogleCloudRetailV2SafetySetting struct { + // Category: Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Method: Optional. Specify if the threshold is used for probability or + // severity score. If not specified, the threshold is used for probability + // score. + // + // Possible values: + // "HARM_BLOCK_METHOD_UNSPECIFIED" - The harm block method is unspecified. + // "SEVERITY" - The harm block method uses both probability and severity + // scores. + // "PROBABILITY" - The harm block method uses the probability score. + Method string `json:"method,omitempty"` + // Threshold: The harm block threshold. + // + // Possible values: + // "HARM_BLOCK_THRESHOLD_UNSPECIFIED" - Unspecified harm block threshold. + // "BLOCK_LOW_AND_ABOVE" - Block low threshold and above (i.e. block more). + // "BLOCK_MEDIUM_AND_ABOVE" - Block medium threshold and above. + // "BLOCK_ONLY_HIGH" - Block only high threshold (i.e. block less). + // "BLOCK_NONE" - Block none. + // "OFF" - Turn off the safety filter. + Threshold string `json:"threshold,omitempty"` + // ForceSendFields is a list of field names (e.g. "Category") 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. "Category") 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 GoogleCloudRetailV2SafetySetting) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2SafetySetting + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2SearchRequest: Request message for SearchService.Search // method. type GoogleCloudRetailV2SearchRequest struct { @@ -14992,6 +15439,116 @@ func (c *ProjectsLocationsCatalogsOperationsListCall) Pages(ctx context.Context, } } +type ProjectsLocationsCatalogsPlacementsConversationalSearchCall struct { + s *Service + placement string + googlecloudretailv2conversationalsearchrequest *GoogleCloudRetailV2ConversationalSearchRequest + 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, googlecloudretailv2conversationalsearchrequest *GoogleCloudRetailV2ConversationalSearchRequest) *ProjectsLocationsCatalogsPlacementsConversationalSearchCall { + c := &ProjectsLocationsCatalogsPlacementsConversationalSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.placement = placement + c.googlecloudretailv2conversationalsearchrequest = googlecloudretailv2conversationalsearchrequest + 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.googlecloudretailv2conversationalsearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+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 +// *GoogleCloudRetailV2ConversationalSearchResponse.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) (*GoogleCloudRetailV2ConversationalSearchResponse, 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 := &GoogleCloudRetailV2ConversationalSearchResponse{ + 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 @@ -15351,6 +15908,116 @@ func (c *ProjectsLocationsCatalogsServingConfigsAddControlCall) Do(opts ...googl return ret, nil } +type ProjectsLocationsCatalogsServingConfigsConversationalSearchCall struct { + s *Service + placement string + googlecloudretailv2conversationalsearchrequest *GoogleCloudRetailV2ConversationalSearchRequest + 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, googlecloudretailv2conversationalsearchrequest *GoogleCloudRetailV2ConversationalSearchRequest) *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall { + c := &ProjectsLocationsCatalogsServingConfigsConversationalSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.placement = placement + c.googlecloudretailv2conversationalsearchrequest = googlecloudretailv2conversationalsearchrequest + 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.googlecloudretailv2conversationalsearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+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 +// *GoogleCloudRetailV2ConversationalSearchResponse.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) (*GoogleCloudRetailV2ConversationalSearchResponse, 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 := &GoogleCloudRetailV2ConversationalSearchResponse{ + 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/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 2305e92909a..12f2ecd7d22 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -2859,7 +2859,7 @@ } } }, - "revision": "20250828", + "revision": "20250911", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4810,7 +4810,7 @@ "type": "string" }, "userQueryTypes": { - "description": "LINT.IfChange(query_types_proto) The types Retail classifies the search query as. Supported values are: - \"ADVERSARIAL\" - \"CHITCHAT\" - \"JAILBREAK\" - \"ORDER_SUPPORT\" - \"SIMPLE_PRODUCT_SEARCH\" - \"INTENT_REFINEMENT\" - \"PRODUCT_DETAILS\" - \"PRODUCT_COMPARISON\" - \"DEALS_AND_COUPONS\" - \"STORE_RELEVANT\" - \"BLOCKLISTED\" - \"BEST_PRODUCT\" - \"RETAIL_SUPPORT\" - \"DISABLED\" LINT.ThenChange(//depot/google3/cloud/console/web/ai/retail/service/conversational_search_customization_config.ts:intent_types_ts)", + "description": "The types Retail classifies the search query as. Supported values are: - \"ORDER_SUPPORT\" - \"SIMPLE_PRODUCT_SEARCH\" - \"INTENT_REFINEMENT\" - \"PRODUCT_DETAILS\" - \"PRODUCT_COMPARISON\" - \"DEALS_AND_COUPONS\" - \"STORE_RELEVANT\" - \"BLOCKLISTED\" - \"BEST_PRODUCT\" - \"RETAIL_SUPPORT\" - \"DISABLED\"", "items": { "type": "string" }, diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index 15e5112a7e6..fc489c72b0c 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -3226,14 +3226,11 @@ type GoogleCloudRetailV2alphaConversationalSearchResponse struct { // "STREAMING" - Response generation is being streamed. // "SUCCEEDED" - Response generation has succeeded. State string `json:"state,omitempty"` - // UserQueryTypes: LINT.IfChange(query_types_proto) The types Retail classifies - // the search query as. Supported values are: - "ADVERSARIAL" - "CHITCHAT" - - // "JAILBREAK" - "ORDER_SUPPORT" - "SIMPLE_PRODUCT_SEARCH" - + // UserQueryTypes: The types Retail classifies the search query as. Supported + // values are: - "ORDER_SUPPORT" - "SIMPLE_PRODUCT_SEARCH" - // "INTENT_REFINEMENT" - "PRODUCT_DETAILS" - "PRODUCT_COMPARISON" - // "DEALS_AND_COUPONS" - "STORE_RELEVANT" - "BLOCKLISTED" - "BEST_PRODUCT" - // "RETAIL_SUPPORT" - "DISABLED" - // LINT.ThenChange(//depot/google3/cloud/console/web/ai/retail/service/conversat - // ional_search_customization_config.ts:intent_types_ts) UserQueryTypes []string `json:"userQueryTypes,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index 7c9aadf00ab..ab1ad597dcf 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -1776,6 +1776,34 @@ }, "placements": { "methods": { + "conversationalSearch": { + "description": "Performs a conversational search. This feature is only available for users who have Conversational Search enabled.", + "flatPath": "v2beta/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": "v2beta/{+placement}:conversationalSearch", + "request": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchRequest" + }, + "response": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "predict": { "description": "Makes a recommendation prediction.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:predict", @@ -1864,6 +1892,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": "v2beta/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": "v2beta/{+placement}:conversationalSearch", + "request": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchRequest" + }, + "response": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchResponse" + }, + "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": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs", @@ -2427,7 +2483,7 @@ } } }, - "revision": "20250807", + "revision": "20250911", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4911,6 +4967,261 @@ }, "type": "object" }, + "GoogleCloudRetailV2betaConversationalSearchRequest": { + "description": "Request message for ConversationalSearchService.ConversationalSearch method.", + "id": "GoogleCloudRetailV2betaConversationalSearchRequest", + "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": "GoogleCloudRetailV2betaConversationalSearchRequestConversationalFilteringSpec", + "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" + }, + "safetySettings": { + "description": "Optional. The safety settings to be applied to the generated content.", + "items": { + "$ref": "GoogleCloudRetailV2betaSafetySetting" + }, + "type": "array" + }, + "searchParams": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchRequestSearchParams", + "description": "Optional. Search parameters." + }, + "userInfo": { + "$ref": "GoogleCloudRetailV2betaUserInfo", + "description": "Optional. User information." + }, + "userLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The user labels applied to a resource must meet the following requirements: * Each resource can have multiple labels, up to a maximum of 64. * Each label must be a key-value pair. * Keys have a minimum length of 1 character and a maximum length of 63 characters and cannot be empty. Values can be empty and have a maximum length of 63 characters. * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. * The key portion of a label must be unique. However, you can use the same key with multiple resources. * Keys must start with a lowercase letter or international character. See [Google Cloud Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) for more details.", + "type": "object" + }, + "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" + }, + "GoogleCloudRetailV2betaConversationalSearchRequestConversationalFilteringSpec": { + "description": "This field specifies all conversational filtering related parameters addition to conversational retail search.", + "id": "GoogleCloudRetailV2betaConversationalSearchRequestConversationalFilteringSpec", + "properties": { + "conversationalFilteringMode": { + "description": "Optional. Mode to control Conversational Filtering. Defaults to Mode.DISABLED if it's unset.", + "enum": [ + "MODE_UNSPECIFIED", + "DISABLED", + "ENABLED", + "CONVERSATIONAL_FILTER_ONLY" + ], + "enumDescriptions": [ + "Default value.", + "Disables Conversational Filtering when using Conversational Search.", + "Enables Conversational Filtering when using Conversational Search.", + "Enables Conversational Filtering without Conversational Search." + ], + "type": "string" + }, + "enableConversationalFiltering": { + "deprecated": true, + "description": "Optional. This field is deprecated. Please use ConversationalFilteringSpec.conversational_filtering_mode instead.", + "type": "boolean" + }, + "userAnswer": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchRequestUserAnswer", + "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" + }, + "GoogleCloudRetailV2betaConversationalSearchRequestSearchParams": { + "description": "Search parameters.", + "id": "GoogleCloudRetailV2betaConversationalSearchRequestSearchParams", + "properties": { + "boostSpec": { + "$ref": "GoogleCloudRetailV2betaSearchRequestBoostSpec", + "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" + }, + "GoogleCloudRetailV2betaConversationalSearchRequestUserAnswer": { + "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": "GoogleCloudRetailV2betaConversationalSearchRequestUserAnswer", + "properties": { + "selectedAnswer": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchRequestUserAnswerSelectedAnswer", + "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" + }, + "GoogleCloudRetailV2betaConversationalSearchRequestUserAnswerSelectedAnswer": { + "description": "This field specifies the selected answers during the conversational search.", + "id": "GoogleCloudRetailV2betaConversationalSearchRequestUserAnswerSelectedAnswer", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2betaProductAttributeValue", + "description": "Optional. This field specifies the selected answer which is a attribute key-value." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaConversationalSearchResponse": { + "description": "Response message for ConversationalSearchService.ConversationalSearch method.", + "id": "GoogleCloudRetailV2betaConversationalSearchResponse", + "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": "GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResult", + "description": "This field specifies all related information that is needed on client side for UI rendering of conversational filtering search." + }, + "conversationalTextResponse": { + "description": "The conversational answer-based text response generated by the Server.", + "type": "string" + }, + "followupQuestion": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion", + "description": "The conversational followup question generated for Intent refinement." + }, + "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": "GoogleCloudRetailV2betaConversationalSearchResponseRefinedSearch" + }, + "type": "array" + }, + "state": { + "description": "Output only. The state of the response generation.", + "enum": [ + "STATE_UNSPECIFIED", + "STREAMING", + "SUCCEEDED" + ], + "enumDescriptions": [ + "Unknown.", + "Response generation is being streamed.", + "Response generation has succeeded." + ], + "readOnly": true, + "type": "string" + }, + "userQueryTypes": { + "description": "The types Retail classifies the search query as. Supported values are: - \"ORDER_SUPPORT\" - \"SIMPLE_PRODUCT_SEARCH\" - \"INTENT_REFINEMENT\" - \"PRODUCT_DETAILS\" - \"PRODUCT_COMPARISON\" - \"DEALS_AND_COUPONS\" - \"STORE_RELEVANT\" - \"BLOCKLISTED\" - \"BEST_PRODUCT\" - \"RETAIL_SUPPORT\" - \"DISABLED\"", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResult": { + "description": "This field specifies all related information that is needed on client side for UI rendering of conversational filtering search.", + "id": "GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResult", + "properties": { + "additionalFilter": { + "$ref": "GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResultAdditionalFilter", + "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": "GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion", + "description": "The conversational filtering question." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResultAdditionalFilter": { + "description": "Additional filter that client side need to apply.", + "id": "GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResultAdditionalFilter", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2betaProductAttributeValue", + "description": "Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion": { + "description": "The conversational followup question generated for Intent refinement.", + "id": "GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion", + "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": "GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestionSuggestedAnswer" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestionSuggestedAnswer": { + "description": "Suggested answers to the follow-up question. If it's numerical attribute, only ProductAttributeInterval will be set. If it's textual attribute, only productAttributeValue will be set.", + "id": "GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestionSuggestedAnswer", + "properties": { + "productAttributeValue": { + "$ref": "GoogleCloudRetailV2betaProductAttributeValue", + "description": "Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future." + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaConversationalSearchResponseRefinedSearch": { + "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": "GoogleCloudRetailV2betaConversationalSearchResponseRefinedSearch", + "properties": { + "query": { + "description": "The query to be used for search.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaCreateModelMetadata": { "description": "Metadata associated with a create operation.", "id": "GoogleCloudRetailV2betaCreateModelMetadata", @@ -7155,6 +7466,67 @@ }, "type": "object" }, + "GoogleCloudRetailV2betaSafetySetting": { + "description": "Safety settings.", + "id": "GoogleCloudRetailV2betaSafetySetting", + "properties": { + "category": { + "description": "Harm category.", + "enum": [ + "HARM_CATEGORY_UNSPECIFIED", + "HARM_CATEGORY_HATE_SPEECH", + "HARM_CATEGORY_DANGEROUS_CONTENT", + "HARM_CATEGORY_HARASSMENT", + "HARM_CATEGORY_SEXUALLY_EXPLICIT", + "HARM_CATEGORY_CIVIC_INTEGRITY" + ], + "enumDescriptions": [ + "The harm category is unspecified.", + "The harm category is hate speech.", + "The harm category is dangerous content.", + "The harm category is harassment.", + "The harm category is sexually explicit content.", + "The harm category is civic integrity." + ], + "type": "string" + }, + "method": { + "description": "Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score.", + "enum": [ + "HARM_BLOCK_METHOD_UNSPECIFIED", + "SEVERITY", + "PROBABILITY" + ], + "enumDescriptions": [ + "The harm block method is unspecified.", + "The harm block method uses both probability and severity scores.", + "The harm block method uses the probability score." + ], + "type": "string" + }, + "threshold": { + "description": "The harm block threshold.", + "enum": [ + "HARM_BLOCK_THRESHOLD_UNSPECIFIED", + "BLOCK_LOW_AND_ABOVE", + "BLOCK_MEDIUM_AND_ABOVE", + "BLOCK_ONLY_HIGH", + "BLOCK_NONE", + "OFF" + ], + "enumDescriptions": [ + "Unspecified harm block threshold.", + "Block low threshold and above (i.e. block more).", + "Block medium threshold and above.", + "Block only high threshold (i.e. block less).", + "Block none.", + "Turn off the safety filter." + ], + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaSearchRequest": { "description": "Request message for SearchService.Search method.", "id": "GoogleCloudRetailV2betaSearchRequest", diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 25bea85b391..9f6975e8100 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -3953,6 +3953,399 @@ func (s GoogleCloudRetailV2betaConversationalSearchCustomizationConfig) MarshalJ return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2betaConversationalSearchRequest: Request message for +// ConversationalSearchService.ConversationalSearch method. +type GoogleCloudRetailV2betaConversationalSearchRequest 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 *GoogleCloudRetailV2betaConversationalSearchRequestConversationalFilteringSpec `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"` + // SafetySettings: Optional. The safety settings to be applied to the generated + // content. + SafetySettings []*GoogleCloudRetailV2betaSafetySetting `json:"safetySettings,omitempty"` + // SearchParams: Optional. Search parameters. + SearchParams *GoogleCloudRetailV2betaConversationalSearchRequestSearchParams `json:"searchParams,omitempty"` + // UserInfo: Optional. User information. + UserInfo *GoogleCloudRetailV2betaUserInfo `json:"userInfo,omitempty"` + // UserLabels: Optional. The user labels applied to a resource must meet the + // following requirements: * Each resource can have multiple labels, up to a + // maximum of 64. * Each label must be a key-value pair. * Keys have a minimum + // length of 1 character and a maximum length of 63 characters and cannot be + // empty. Values can be empty and have a maximum length of 63 characters. * + // Keys and values can contain only lowercase letters, numeric characters, + // underscores, and dashes. All characters must use UTF-8 encoding, and + // international characters are allowed. * The key portion of a label must be + // unique. However, you can use the same key with multiple resources. * Keys + // must start with a lowercase letter or international character. See Google + // Cloud Document + // (https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) + // for more details. + UserLabels map[string]string `json:"userLabels,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 GoogleCloudRetailV2betaConversationalSearchRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchRequestConversationalFilteringSpec +// : This field specifies all conversational filtering related parameters +// addition to conversational retail search. +type GoogleCloudRetailV2betaConversationalSearchRequestConversationalFilteringSpec struct { + // ConversationalFilteringMode: Optional. Mode to control Conversational + // Filtering. Defaults to Mode.DISABLED if it's unset. + // + // Possible values: + // "MODE_UNSPECIFIED" - Default value. + // "DISABLED" - Disables Conversational Filtering when using Conversational + // Search. + // "ENABLED" - Enables Conversational Filtering when using Conversational + // Search. + // "CONVERSATIONAL_FILTER_ONLY" - Enables Conversational Filtering without + // 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 *GoogleCloudRetailV2betaConversationalSearchRequestUserAnswer `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 GoogleCloudRetailV2betaConversationalSearchRequestConversationalFilteringSpec) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchRequestConversationalFilteringSpec + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchRequestSearchParams: Search +// parameters. +type GoogleCloudRetailV2betaConversationalSearchRequestSearchParams 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 *GoogleCloudRetailV2betaSearchRequestBoostSpec `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 GoogleCloudRetailV2betaConversationalSearchRequestSearchParams) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchRequestSearchParams + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchRequestUserAnswer: 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 GoogleCloudRetailV2betaConversationalSearchRequestUserAnswer 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 *GoogleCloudRetailV2betaConversationalSearchRequestUserAnswerSelectedAnswer `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 GoogleCloudRetailV2betaConversationalSearchRequestUserAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchRequestUserAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchRequestUserAnswerSelectedAnswer: +// This field specifies the selected answers during the conversational search. +type GoogleCloudRetailV2betaConversationalSearchRequestUserAnswerSelectedAnswer struct { + // ProductAttributeValue: Optional. This field specifies the selected answer + // which is a attribute key-value. + ProductAttributeValue *GoogleCloudRetailV2betaProductAttributeValue `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 GoogleCloudRetailV2betaConversationalSearchRequestUserAnswerSelectedAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchRequestUserAnswerSelectedAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchResponse: Response message for +// ConversationalSearchService.ConversationalSearch method. +type GoogleCloudRetailV2betaConversationalSearchResponse 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 *GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResult `json:"conversationalFilteringResult,omitempty"` + // ConversationalTextResponse: The conversational answer-based text response + // generated by the Server. + ConversationalTextResponse string `json:"conversationalTextResponse,omitempty"` + // FollowupQuestion: The conversational followup question generated for Intent + // refinement. + FollowupQuestion *GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion `json:"followupQuestion,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 []*GoogleCloudRetailV2betaConversationalSearchResponseRefinedSearch `json:"refinedSearch,omitempty"` + // State: Output only. The state of the response generation. + // + // Possible values: + // "STATE_UNSPECIFIED" - Unknown. + // "STREAMING" - Response generation is being streamed. + // "SUCCEEDED" - Response generation has succeeded. + State string `json:"state,omitempty"` + // UserQueryTypes: The types Retail classifies the search query as. Supported + // values are: - "ORDER_SUPPORT" - "SIMPLE_PRODUCT_SEARCH" - + // "INTENT_REFINEMENT" - "PRODUCT_DETAILS" - "PRODUCT_COMPARISON" - + // "DEALS_AND_COUPONS" - "STORE_RELEVANT" - "BLOCKLISTED" - "BEST_PRODUCT" - + // "RETAIL_SUPPORT" - "DISABLED" + UserQueryTypes []string `json:"userQueryTypes,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 GoogleCloudRetailV2betaConversationalSearchResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchResponse + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringRes +// ult: This field specifies all related information that is needed on client +// side for UI rendering of conversational filtering search. +type GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResult 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 *GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResultAdditionalFilter `json:"additionalFilter,omitempty"` + // FollowupQuestion: The conversational filtering question. + FollowupQuestion *GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion `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 GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResult) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResult + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringRes +// ultAdditionalFilter: Additional filter that client side need to apply. +type GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResultAdditionalFilter struct { + // ProductAttributeValue: Product attribute value, including an attribute key + // and an attribute value. Other types can be added here in the future. + ProductAttributeValue *GoogleCloudRetailV2betaProductAttributeValue `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 GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResultAdditionalFilter) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchResponseConversationalFilteringResultAdditionalFilter + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion: The +// conversational followup question generated for Intent refinement. +type GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion 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 []*GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestionSuggestedAnswer `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 GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestion + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestionSuggestedA +// nswer: Suggested answers to the follow-up question. If it's numerical +// attribute, only ProductAttributeInterval will be set. If it's textual +// attribute, only productAttributeValue will be set. +type GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestionSuggestedAnswer struct { + // ProductAttributeValue: Product attribute value, including an attribute key + // and an attribute value. Other types can be added here in the future. + ProductAttributeValue *GoogleCloudRetailV2betaProductAttributeValue `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 GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestionSuggestedAnswer) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchResponseFollowupQuestionSuggestedAnswer + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaConversationalSearchResponseRefinedSearch: 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 GoogleCloudRetailV2betaConversationalSearchResponseRefinedSearch 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 GoogleCloudRetailV2betaConversationalSearchResponseRefinedSearch) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaConversationalSearchResponseRefinedSearch + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaCreateModelMetadata: Metadata associated with a // create operation. type GoogleCloudRetailV2betaCreateModelMetadata struct { @@ -7599,6 +7992,58 @@ func (s GoogleCloudRetailV2betaRuleTwowaySynonymsAction) MarshalJSON() ([]byte, return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2betaSafetySetting: Safety settings. +type GoogleCloudRetailV2betaSafetySetting struct { + // Category: Harm category. + // + // Possible values: + // "HARM_CATEGORY_UNSPECIFIED" - The harm category is unspecified. + // "HARM_CATEGORY_HATE_SPEECH" - The harm category is hate speech. + // "HARM_CATEGORY_DANGEROUS_CONTENT" - The harm category is dangerous + // content. + // "HARM_CATEGORY_HARASSMENT" - The harm category is harassment. + // "HARM_CATEGORY_SEXUALLY_EXPLICIT" - The harm category is sexually explicit + // content. + // "HARM_CATEGORY_CIVIC_INTEGRITY" - The harm category is civic integrity. + Category string `json:"category,omitempty"` + // Method: Optional. Specify if the threshold is used for probability or + // severity score. If not specified, the threshold is used for probability + // score. + // + // Possible values: + // "HARM_BLOCK_METHOD_UNSPECIFIED" - The harm block method is unspecified. + // "SEVERITY" - The harm block method uses both probability and severity + // scores. + // "PROBABILITY" - The harm block method uses the probability score. + Method string `json:"method,omitempty"` + // Threshold: The harm block threshold. + // + // Possible values: + // "HARM_BLOCK_THRESHOLD_UNSPECIFIED" - Unspecified harm block threshold. + // "BLOCK_LOW_AND_ABOVE" - Block low threshold and above (i.e. block more). + // "BLOCK_MEDIUM_AND_ABOVE" - Block medium threshold and above. + // "BLOCK_ONLY_HIGH" - Block only high threshold (i.e. block less). + // "BLOCK_NONE" - Block none. + // "OFF" - Turn off the safety filter. + Threshold string `json:"threshold,omitempty"` + // ForceSendFields is a list of field names (e.g. "Category") 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. "Category") 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 GoogleCloudRetailV2betaSafetySetting) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaSafetySetting + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaSearchRequest: Request message for // SearchService.Search method. type GoogleCloudRetailV2betaSearchRequest struct { @@ -15803,6 +16248,116 @@ func (c *ProjectsLocationsCatalogsOperationsListCall) Pages(ctx context.Context, } } +type ProjectsLocationsCatalogsPlacementsConversationalSearchCall struct { + s *Service + placement string + googlecloudretailv2betaconversationalsearchrequest *GoogleCloudRetailV2betaConversationalSearchRequest + 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, googlecloudretailv2betaconversationalsearchrequest *GoogleCloudRetailV2betaConversationalSearchRequest) *ProjectsLocationsCatalogsPlacementsConversationalSearchCall { + c := &ProjectsLocationsCatalogsPlacementsConversationalSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.placement = placement + c.googlecloudretailv2betaconversationalsearchrequest = googlecloudretailv2betaconversationalsearchrequest + 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.googlecloudretailv2betaconversationalsearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+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 +// *GoogleCloudRetailV2betaConversationalSearchResponse.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) (*GoogleCloudRetailV2betaConversationalSearchResponse, 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 := &GoogleCloudRetailV2betaConversationalSearchResponse{ + 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 @@ -16162,6 +16717,116 @@ func (c *ProjectsLocationsCatalogsServingConfigsAddControlCall) Do(opts ...googl return ret, nil } +type ProjectsLocationsCatalogsServingConfigsConversationalSearchCall struct { + s *Service + placement string + googlecloudretailv2betaconversationalsearchrequest *GoogleCloudRetailV2betaConversationalSearchRequest + 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, googlecloudretailv2betaconversationalsearchrequest *GoogleCloudRetailV2betaConversationalSearchRequest) *ProjectsLocationsCatalogsServingConfigsConversationalSearchCall { + c := &ProjectsLocationsCatalogsServingConfigsConversationalSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.placement = placement + c.googlecloudretailv2betaconversationalsearchrequest = googlecloudretailv2betaconversationalsearchrequest + 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.googlecloudretailv2betaconversationalsearchrequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+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 +// *GoogleCloudRetailV2betaConversationalSearchResponse.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) (*GoogleCloudRetailV2betaConversationalSearchResponse, 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 := &GoogleCloudRetailV2betaConversationalSearchResponse{ + 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/run/v1/run-api.json b/run/v1/run-api.json index 0c4504cce88..9a64e264893 100644 --- a/run/v1/run-api.json +++ b/run/v1/run-api.json @@ -870,7 +870,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the job to retrieve. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", + "description": "Required. The name of the job to retrieve. It takes the form namespaces/{namespace}/jobs/{job_name} and the `endpoint` must be regional. Replace {namespace} with the project ID or number.", "location": "path", "pattern": "^namespaces/[^/]+/jobs/[^/]+$", "required": true, @@ -2902,7 +2902,7 @@ } } }, - "revision": "20250905", + "revision": "20250912", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go index a387d6cc322..0d9f09492e9 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -7462,9 +7462,9 @@ type NamespacesJobsGetCall struct { // Get: Get information about a job. // -// - name: The name of the job to retrieve. Replace {namespace} with the -// project ID or number. It takes the form namespaces/{namespace}. For -// example: namespaces/PROJECT_ID. +// - name: The name of the job to retrieve. It takes the form +// namespaces/{namespace}/jobs/{job_name} and the `endpoint` must be +// regional. Replace {namespace} with the project ID or number. func (r *NamespacesJobsService) Get(name string) *NamespacesJobsGetCall { c := &NamespacesJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/saasservicemgmt/v1beta1/saasservicemgmt-api.json b/saasservicemgmt/v1beta1/saasservicemgmt-api.json index 34535de33a8..0d5a306aa93 100644 --- a/saasservicemgmt/v1beta1/saasservicemgmt-api.json +++ b/saasservicemgmt/v1beta1/saasservicemgmt-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1804,7 +1804,7 @@ } } }, - "revision": "20250903", + "revision": "20250910", "rootUrl": "https://saasservicemgmt.googleapis.com/", "schemas": { "Aggregate": { diff --git a/saasservicemgmt/v1beta1/saasservicemgmt-gen.go b/saasservicemgmt/v1beta1/saasservicemgmt-gen.go index 3dc979d2410..f368b276590 100644 --- a/saasservicemgmt/v1beta1/saasservicemgmt-gen.go +++ b/saasservicemgmt/v1beta1/saasservicemgmt-gen.go @@ -2043,9 +2043,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/secretmanager/v1/secretmanager-api.json b/secretmanager/v1/secretmanager-api.json index 061532979b2..ab2f5dd88fe 100644 --- a/secretmanager/v1/secretmanager-api.json +++ b/secretmanager/v1/secretmanager-api.json @@ -326,7 +326,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1296,7 +1296,7 @@ } } }, - "revision": "20250902", + "revision": "20250910", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/secretmanager/v1/secretmanager-gen.go b/secretmanager/v1/secretmanager-gen.go index 673bd1e01fc..4b3a59a4a70 100644 --- a/secretmanager/v1/secretmanager-gen.go +++ b/secretmanager/v1/secretmanager-gen.go @@ -1526,9 +1526,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/secretmanager/v1beta1/secretmanager-api.json b/secretmanager/v1beta1/secretmanager-api.json index 9531b111891..d9e49b4820e 100644 --- a/secretmanager/v1beta1/secretmanager-api.json +++ b/secretmanager/v1beta1/secretmanager-api.json @@ -326,7 +326,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -816,7 +816,7 @@ } } }, - "revision": "20250902", + "revision": "20250910", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/secretmanager/v1beta1/secretmanager-gen.go b/secretmanager/v1beta1/secretmanager-gen.go index afa6c2681c6..a4e7446c8ee 100644 --- a/secretmanager/v1beta1/secretmanager-gen.go +++ b/secretmanager/v1beta1/secretmanager-gen.go @@ -1116,9 +1116,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/secretmanager/v1beta2/secretmanager-api.json b/secretmanager/v1beta2/secretmanager-api.json index 47e58e497eb..3ca52a0585d 100644 --- a/secretmanager/v1beta2/secretmanager-api.json +++ b/secretmanager/v1beta2/secretmanager-api.json @@ -326,7 +326,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1296,7 +1296,7 @@ } } }, - "revision": "20250902", + "revision": "20250910", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { diff --git a/secretmanager/v1beta2/secretmanager-gen.go b/secretmanager/v1beta2/secretmanager-gen.go index f4bd879a9a3..9b0aac850b4 100644 --- a/secretmanager/v1beta2/secretmanager-gen.go +++ b/secretmanager/v1beta2/secretmanager-gen.go @@ -1526,9 +1526,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index 44e074f167a..4a86af11431 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -5938,7 +5938,7 @@ } } }, - "revision": "20250905", + "revision": "20250915", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -6063,12 +6063,16 @@ "enum": [ "DEPLOYMENT_PLATFORM_UNSPECIFIED", "VERTEX_AI", - "GKE" + "GKE", + "GCE", + "FINE_TUNED_MODEL" ], "enumDescriptions": [ "Unspecified deployment platform.", "Vertex AI.", - "Google Kubernetes Engine." + "Google Kubernetes Engine.", + "Google Compute Engine.", + "Fine tuned model." ], "type": "string" }, @@ -7454,11 +7458,15 @@ "description": "Type of the DRD event.", "enum": [ "EVENT_TYPE_UNSPECIFIED", - "EVENT_TYPE_MAX_TTL_EXCEEDED" + "EVENT_TYPE_MAX_TTL_EXCEEDED", + "EVENT_TYPE_MAX_TTL_FROM_CREATION", + "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" ], "enumDescriptions": [ "Unspecified event type.", - "The maximum retention time has been exceeded." + "The maximum retention time has been exceeded.", + "Max TTL from the asset's creation time.", + "Max TTL from the asset's last modification time." ], "type": "string" }, @@ -9459,12 +9467,16 @@ "enum": [ "DEPLOYMENT_PLATFORM_UNSPECIFIED", "VERTEX_AI", - "GKE" + "GKE", + "GCE", + "FINE_TUNED_MODEL" ], "enumDescriptions": [ "Unspecified deployment platform.", "Vertex AI.", - "Google Kubernetes Engine." + "Google Kubernetes Engine.", + "Google Compute Engine.", + "Fine tuned model." ], "type": "string" }, @@ -10542,11 +10554,15 @@ "description": "Type of the DRD event.", "enum": [ "EVENT_TYPE_UNSPECIFIED", - "EVENT_TYPE_MAX_TTL_EXCEEDED" + "EVENT_TYPE_MAX_TTL_EXCEEDED", + "EVENT_TYPE_MAX_TTL_FROM_CREATION", + "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" ], "enumDescriptions": [ "Unspecified event type.", - "The maximum retention time has been exceeded." + "The maximum retention time has been exceeded.", + "Max TTL from the asset's creation time.", + "Max TTL from the asset's last modification time." ], "type": "string" }, diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index 6b04ce9178a..3e262f4a6d5 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -1079,6 +1079,8 @@ type AiModel struct { // "DEPLOYMENT_PLATFORM_UNSPECIFIED" - Unspecified deployment platform. // "VERTEX_AI" - Vertex AI. // "GKE" - Google Kubernetes Engine. + // "GCE" - Google Compute Engine. + // "FINE_TUNED_MODEL" - Fine tuned model. DeploymentPlatform string `json:"deploymentPlatform,omitempty"` // DisplayName: The user defined display name of model. Ex. // baseline-classification-model @@ -2898,6 +2900,10 @@ type DataRetentionDeletionEvent struct { // "EVENT_TYPE_UNSPECIFIED" - Unspecified event type. // "EVENT_TYPE_MAX_TTL_EXCEEDED" - The maximum retention time has been // exceeded. + // "EVENT_TYPE_MAX_TTL_FROM_CREATION" - Max TTL from the asset's creation + // time. + // "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" - Max TTL from the asset's + // last modification time. EventType string `json:"eventType,omitempty"` // MaxRetentionAllowed: Maximum duration of retention allowed from the DRD // control. This comes from the DRD control where users set a max TTL for their @@ -5245,6 +5251,8 @@ type GoogleCloudSecuritycenterV2AiModel struct { // "DEPLOYMENT_PLATFORM_UNSPECIFIED" - Unspecified deployment platform. // "VERTEX_AI" - Vertex AI. // "GKE" - Google Kubernetes Engine. + // "GCE" - Google Compute Engine. + // "FINE_TUNED_MODEL" - Fine tuned model. DeploymentPlatform string `json:"deploymentPlatform,omitempty"` // DisplayName: The user defined display name of model. Ex. // baseline-classification-model @@ -6591,6 +6599,10 @@ type GoogleCloudSecuritycenterV2DataRetentionDeletionEvent struct { // "EVENT_TYPE_UNSPECIFIED" - Unspecified event type. // "EVENT_TYPE_MAX_TTL_EXCEEDED" - The maximum retention time has been // exceeded. + // "EVENT_TYPE_MAX_TTL_FROM_CREATION" - Max TTL from the asset's creation + // time. + // "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" - Max TTL from the asset's + // last modification time. EventType string `json:"eventType,omitempty"` // MaxRetentionAllowed: Maximum duration of retention allowed from the DRD // control. This comes from the DRD control where users set a max TTL for their diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index f779fbd821e..7a34c9a478e 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -913,7 +913,7 @@ } } }, - "revision": "20250905", + "revision": "20250915", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -1038,12 +1038,16 @@ "enum": [ "DEPLOYMENT_PLATFORM_UNSPECIFIED", "VERTEX_AI", - "GKE" + "GKE", + "GCE", + "FINE_TUNED_MODEL" ], "enumDescriptions": [ "Unspecified deployment platform.", "Vertex AI.", - "Google Kubernetes Engine." + "Google Kubernetes Engine.", + "Google Compute Engine.", + "Fine tuned model." ], "type": "string" }, @@ -2189,11 +2193,15 @@ "description": "Type of the DRD event.", "enum": [ "EVENT_TYPE_UNSPECIFIED", - "EVENT_TYPE_MAX_TTL_EXCEEDED" + "EVENT_TYPE_MAX_TTL_EXCEEDED", + "EVENT_TYPE_MAX_TTL_FROM_CREATION", + "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" ], "enumDescriptions": [ "Unspecified event type.", - "The maximum retention time has been exceeded." + "The maximum retention time has been exceeded.", + "Max TTL from the asset's creation time.", + "Max TTL from the asset's last modification time." ], "type": "string" }, @@ -4129,12 +4137,16 @@ "enum": [ "DEPLOYMENT_PLATFORM_UNSPECIFIED", "VERTEX_AI", - "GKE" + "GKE", + "GCE", + "FINE_TUNED_MODEL" ], "enumDescriptions": [ "Unspecified deployment platform.", "Vertex AI.", - "Google Kubernetes Engine." + "Google Kubernetes Engine.", + "Google Compute Engine.", + "Fine tuned model." ], "type": "string" }, @@ -5212,11 +5224,15 @@ "description": "Type of the DRD event.", "enum": [ "EVENT_TYPE_UNSPECIFIED", - "EVENT_TYPE_MAX_TTL_EXCEEDED" + "EVENT_TYPE_MAX_TTL_EXCEEDED", + "EVENT_TYPE_MAX_TTL_FROM_CREATION", + "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" ], "enumDescriptions": [ "Unspecified event type.", - "The maximum retention time has been exceeded." + "The maximum retention time has been exceeded.", + "Max TTL from the asset's creation time.", + "Max TTL from the asset's last modification time." ], "type": "string" }, diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index 3475cb076e2..2be754a0cfa 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -395,6 +395,8 @@ type AiModel struct { // "DEPLOYMENT_PLATFORM_UNSPECIFIED" - Unspecified deployment platform. // "VERTEX_AI" - Vertex AI. // "GKE" - Google Kubernetes Engine. + // "GCE" - Google Compute Engine. + // "FINE_TUNED_MODEL" - Fine tuned model. DeploymentPlatform string `json:"deploymentPlatform,omitempty"` // DisplayName: The user defined display name of model. Ex. // baseline-classification-model @@ -1898,6 +1900,10 @@ type DataRetentionDeletionEvent struct { // "EVENT_TYPE_UNSPECIFIED" - Unspecified event type. // "EVENT_TYPE_MAX_TTL_EXCEEDED" - The maximum retention time has been // exceeded. + // "EVENT_TYPE_MAX_TTL_FROM_CREATION" - Max TTL from the asset's creation + // time. + // "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" - Max TTL from the asset's + // last modification time. EventType string `json:"eventType,omitempty"` // MaxRetentionAllowed: Maximum duration of retention allowed from the DRD // control. This comes from the DRD control where users set a max TTL for their @@ -4206,6 +4212,8 @@ type GoogleCloudSecuritycenterV2AiModel struct { // "DEPLOYMENT_PLATFORM_UNSPECIFIED" - Unspecified deployment platform. // "VERTEX_AI" - Vertex AI. // "GKE" - Google Kubernetes Engine. + // "GCE" - Google Compute Engine. + // "FINE_TUNED_MODEL" - Fine tuned model. DeploymentPlatform string `json:"deploymentPlatform,omitempty"` // DisplayName: The user defined display name of model. Ex. // baseline-classification-model @@ -5552,6 +5560,10 @@ type GoogleCloudSecuritycenterV2DataRetentionDeletionEvent struct { // "EVENT_TYPE_UNSPECIFIED" - Unspecified event type. // "EVENT_TYPE_MAX_TTL_EXCEEDED" - The maximum retention time has been // exceeded. + // "EVENT_TYPE_MAX_TTL_FROM_CREATION" - Max TTL from the asset's creation + // time. + // "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" - Max TTL from the asset's + // last modification time. EventType string `json:"eventType,omitempty"` // MaxRetentionAllowed: Maximum duration of retention allowed from the DRD // control. This comes from the DRD control where users set a max TTL for their diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index 091d7124b9d..3124a493d8e 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -2003,7 +2003,7 @@ } } }, - "revision": "20250905", + "revision": "20250915", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -2128,12 +2128,16 @@ "enum": [ "DEPLOYMENT_PLATFORM_UNSPECIFIED", "VERTEX_AI", - "GKE" + "GKE", + "GCE", + "FINE_TUNED_MODEL" ], "enumDescriptions": [ "Unspecified deployment platform.", "Vertex AI.", - "Google Kubernetes Engine." + "Google Kubernetes Engine.", + "Google Compute Engine.", + "Fine tuned model." ], "type": "string" }, @@ -3215,11 +3219,15 @@ "description": "Type of the DRD event.", "enum": [ "EVENT_TYPE_UNSPECIFIED", - "EVENT_TYPE_MAX_TTL_EXCEEDED" + "EVENT_TYPE_MAX_TTL_EXCEEDED", + "EVENT_TYPE_MAX_TTL_FROM_CREATION", + "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" ], "enumDescriptions": [ "Unspecified event type.", - "The maximum retention time has been exceeded." + "The maximum retention time has been exceeded.", + "Max TTL from the asset's creation time.", + "Max TTL from the asset's last modification time." ], "type": "string" }, @@ -5122,12 +5130,16 @@ "enum": [ "DEPLOYMENT_PLATFORM_UNSPECIFIED", "VERTEX_AI", - "GKE" + "GKE", + "GCE", + "FINE_TUNED_MODEL" ], "enumDescriptions": [ "Unspecified deployment platform.", "Vertex AI.", - "Google Kubernetes Engine." + "Google Kubernetes Engine.", + "Google Compute Engine.", + "Fine tuned model." ], "type": "string" }, @@ -6205,11 +6217,15 @@ "description": "Type of the DRD event.", "enum": [ "EVENT_TYPE_UNSPECIFIED", - "EVENT_TYPE_MAX_TTL_EXCEEDED" + "EVENT_TYPE_MAX_TTL_EXCEEDED", + "EVENT_TYPE_MAX_TTL_FROM_CREATION", + "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" ], "enumDescriptions": [ "Unspecified event type.", - "The maximum retention time has been exceeded." + "The maximum retention time has been exceeded.", + "Max TTL from the asset's creation time.", + "Max TTL from the asset's last modification time." ], "type": "string" }, diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index b46d8dda328..6871d5d683f 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -623,6 +623,8 @@ type AiModel struct { // "DEPLOYMENT_PLATFORM_UNSPECIFIED" - Unspecified deployment platform. // "VERTEX_AI" - Vertex AI. // "GKE" - Google Kubernetes Engine. + // "GCE" - Google Compute Engine. + // "FINE_TUNED_MODEL" - Fine tuned model. DeploymentPlatform string `json:"deploymentPlatform,omitempty"` // DisplayName: The user defined display name of model. Ex. // baseline-classification-model @@ -1952,6 +1954,10 @@ type DataRetentionDeletionEvent struct { // "EVENT_TYPE_UNSPECIFIED" - Unspecified event type. // "EVENT_TYPE_MAX_TTL_EXCEEDED" - The maximum retention time has been // exceeded. + // "EVENT_TYPE_MAX_TTL_FROM_CREATION" - Max TTL from the asset's creation + // time. + // "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" - Max TTL from the asset's + // last modification time. EventType string `json:"eventType,omitempty"` // MaxRetentionAllowed: Maximum duration of retention allowed from the DRD // control. This comes from the DRD control where users set a max TTL for their @@ -4157,6 +4163,8 @@ type GoogleCloudSecuritycenterV2AiModel struct { // "DEPLOYMENT_PLATFORM_UNSPECIFIED" - Unspecified deployment platform. // "VERTEX_AI" - Vertex AI. // "GKE" - Google Kubernetes Engine. + // "GCE" - Google Compute Engine. + // "FINE_TUNED_MODEL" - Fine tuned model. DeploymentPlatform string `json:"deploymentPlatform,omitempty"` // DisplayName: The user defined display name of model. Ex. // baseline-classification-model @@ -5503,6 +5511,10 @@ type GoogleCloudSecuritycenterV2DataRetentionDeletionEvent struct { // "EVENT_TYPE_UNSPECIFIED" - Unspecified event type. // "EVENT_TYPE_MAX_TTL_EXCEEDED" - The maximum retention time has been // exceeded. + // "EVENT_TYPE_MAX_TTL_FROM_CREATION" - Max TTL from the asset's creation + // time. + // "EVENT_TYPE_MAX_TTL_FROM_LAST_MODIFICATION" - Max TTL from the asset's + // last modification time. EventType string `json:"eventType,omitempty"` // MaxRetentionAllowed: Maximum duration of retention allowed from the DRD // control. This comes from the DRD control where users set a max TTL for their diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json index c5af9e9b89b..89b5a97db4a 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json @@ -542,7 +542,7 @@ } } }, - "revision": "20250619", + "revision": "20250919", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "AddTenantProjectRequest": { @@ -561,9 +561,13 @@ "type": "object" }, "Api": { - "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.", + "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology. New usages of this message as an alternative to ServiceDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Api", "properties": { + "edition": { + "description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS.", + "type": "string" + }, "methods": { "description": "The methods of this interface, in unspecified order.", "items": { @@ -821,6 +825,7 @@ "type": "object" }, "pathTranslation": { + "description": "no-lint", "enum": [ "PATH_TRANSLATION_UNSPECIFIED", "CONSTANT_ADDRESS", @@ -1397,7 +1402,7 @@ "type": "object" }, "Enum": { - "description": "Enum type definition.", + "description": "Enum type definition. New usages of this message as an alternative to EnumDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Enum", "properties": { "edition": { @@ -1444,7 +1449,7 @@ "type": "object" }, "EnumValue": { - "description": "Enum value definition.", + "description": "Enum value definition. New usages of this message as an alternative to EnumValueDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "EnumValue", "properties": { "name": { @@ -1486,7 +1491,7 @@ "type": "object" }, "Field": { - "description": "A single field of a message type.", + "description": "A single field of a message type. New usages of this message as an alternative to FieldDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Field", "properties": { "cardinality": { @@ -1622,7 +1627,7 @@ "additionalProperties": { "type": "string" }, - "description": "Map of service names to renamed services. Keys are the package relative service names and values are the name to be used for the service client and call options. publishing: go_settings: renamed_services: Publisher: TopicAdmin", + "description": "Map of service names to renamed services. Keys are the package relative service names and values are the name to be used for the service client and call options. Example: publishing: go_settings: renamed_services: Publisher: TopicAdmin", "type": "object" } }, @@ -1899,9 +1904,14 @@ "type": "object" }, "Method": { - "description": "Method represents a method of an API interface.", + "description": "Method represents a method of an API interface. New usages of this message as an alternative to MethodDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Method", "properties": { + "edition": { + "deprecated": true, + "description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS. This field should be ignored, instead the edition should be inherited from Api. This is similar to Field and EnumValue.", + "type": "string" + }, "name": { "description": "The simple name of this method.", "type": "string" @@ -1930,7 +1940,8 @@ "type": "string" }, "syntax": { - "description": "The source syntax of this method.", + "deprecated": true, + "description": "The source syntax of this method. This field should be ignored, instead the syntax should be inherited from Api. This is similar to Field and EnumValue.", "enum": [ "SYNTAX_PROTO2", "SYNTAX_PROTO3", @@ -2343,7 +2354,7 @@ "type": "object" }, "Option": { - "description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc.", + "description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc. New usages of this message as an alternative to FileOptions, MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, ServiceOptions, or MethodOptions are strongly discouraged.", "id": "Option", "properties": { "name": { @@ -3042,7 +3053,7 @@ "type": "object" }, "Type": { - "description": "A protocol buffer message type.", + "description": "A protocol buffer message type. New usages of this message as an alternative to DescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Type", "properties": { "edition": { diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index ea4a9ca79f0..27acde17af1 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -221,8 +221,15 @@ func (s AddTenantProjectRequest) MarshalJSON() ([]byte, error) { // opposed to simply a description of methods and bindings. They are also // sometimes simply referred to as "APIs" in other contexts, such as the name // of this message itself. See https://cloud.google.com/apis/design/glossary -// for detailed terminology. +// for detailed terminology. New usages of this message as an alternative to +// ServiceDescriptorProto are strongly discouraged. This message does not +// reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Api struct { + // Edition: The source edition string, only valid when syntax is + // SYNTAX_EDITIONS. + Edition string `json:"edition,omitempty"` // Methods: The methods of this interface, in unspecified order. Methods []*Method `json:"methods,omitempty"` // Mixins: Included interfaces. See Mixin. @@ -257,13 +264,13 @@ type Api struct { // be omitted. Zero major versions must only be used for experimental, non-GA // interfaces. Version string `json:"version,omitempty"` - // ForceSendFields is a list of field names (e.g. "Methods") to unconditionally + // ForceSendFields is a list of field names (e.g. "Edition") 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. "Methods") to include in API + // NullFields is a list of field names (e.g. "Edition") 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. @@ -591,6 +598,8 @@ type BackendRule struct { // OverridesByRequestProtocol: The map between request protocol and the backend // address. OverridesByRequestProtocol map[string]BackendRule `json:"overridesByRequestProtocol,omitempty"` + // PathTranslation: no-lint + // // Possible values: // "PATH_TRANSLATION_UNSPECIFIED" // "CONSTANT_ADDRESS" - Use the backend address as-is, with no modification @@ -1461,7 +1470,11 @@ func (s Endpoint) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Enum: Enum type definition. +// Enum: Enum type definition. New usages of this message as an alternative to +// EnumDescriptorProto are strongly discouraged. This message does not +// reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Enum struct { // Edition: The source edition string, only valid when syntax is // SYNTAX_EDITIONS. @@ -1499,7 +1512,11 @@ func (s Enum) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// EnumValue: Enum value definition. +// EnumValue: Enum value definition. New usages of this message as an +// alternative to EnumValueDescriptorProto are strongly discouraged. This +// message does not reliability preserve all information necessary to model the +// schema and preserve semantics. Instead make use of FileDescriptorSet which +// preserves the necessary information. type EnumValue struct { // Name: Enum value name. Name string `json:"name,omitempty"` @@ -1562,7 +1579,11 @@ func (s ExperimentalFeatures) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Field: A single field of a message type. +// Field: A single field of a message type. New usages of this message as an +// alternative to FieldDescriptorProto are strongly discouraged. This message +// does not reliability preserve all information necessary to model the schema +// and preserve semantics. Instead make use of FileDescriptorSet which +// preserves the necessary information. type Field struct { // Cardinality: The field cardinality. // @@ -1680,8 +1701,8 @@ type GoSettings struct { Common *CommonLanguageSettings `json:"common,omitempty"` // RenamedServices: Map of service names to renamed services. Keys are the // package relative service names and values are the name to be used for the - // service client and call options. publishing: go_settings: renamed_services: - // Publisher: TopicAdmin + // service client and call options. Example: publishing: go_settings: + // renamed_services: Publisher: TopicAdmin RenamedServices map[string]string `json:"renamedServices,omitempty"` // ForceSendFields is a list of field names (e.g. "Common") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -2234,8 +2255,16 @@ func (s *LongRunning) UnmarshalJSON(data []byte) error { return nil } -// Method: Method represents a method of an API interface. +// Method: Method represents a method of an API interface. New usages of this +// message as an alternative to MethodDescriptorProto are strongly discouraged. +// This message does not reliability preserve all information necessary to +// model the schema and preserve semantics. Instead make use of +// FileDescriptorSet which preserves the necessary information. type Method struct { + // Edition: The source edition string, only valid when syntax is + // SYNTAX_EDITIONS. This field should be ignored, instead the edition should be + // inherited from Api. This is similar to Field and EnumValue. + Edition string `json:"edition,omitempty"` // Name: The simple name of this method. Name string `json:"name,omitempty"` // Options: Any metadata attached to the method. @@ -2248,22 +2277,24 @@ type Method struct { ResponseStreaming bool `json:"responseStreaming,omitempty"` // ResponseTypeUrl: The URL of the output message type. ResponseTypeUrl string `json:"responseTypeUrl,omitempty"` - // Syntax: The source syntax of this method. + // Syntax: The source syntax of this method. This field should be ignored, + // instead the syntax should be inherited from Api. This is similar to Field + // and EnumValue. // // Possible values: // "SYNTAX_PROTO2" - Syntax `proto2`. // "SYNTAX_PROTO3" - Syntax `proto3`. // "SYNTAX_EDITIONS" - Syntax `editions`. Syntax string `json:"syntax,omitempty"` - // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // ForceSendFields is a list of field names (e.g. "Edition") 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 + // NullFields is a list of field names (e.g. "Edition") 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:"-"` } @@ -2953,7 +2984,9 @@ func (s Operation) MarshalJSON() ([]byte, error) { } // Option: A protocol buffer option, which can be attached to a message, field, -// enumeration, etc. +// enumeration, etc. New usages of this message as an alternative to +// FileOptions, MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, +// ServiceOptions, or MethodOptions are strongly discouraged. type Option struct { // Name: The option's name. For protobuf built-in options (options defined in // descriptor.proto), this is the short name. For example, "map_entry". For @@ -3868,7 +3901,11 @@ func (s TenantResource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Type: A protocol buffer message type. +// Type: A protocol buffer message type. New usages of this message as an +// alternative to DescriptorProto are strongly discouraged. This message does +// not reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Type struct { // Edition: The source edition string, only valid when syntax is // SYNTAX_EDITIONS. diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json index ea991ee4823..76efe95f42e 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json @@ -724,13 +724,17 @@ } } }, - "revision": "20250619", + "revision": "20250919", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { - "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.", + "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology. New usages of this message as an alternative to ServiceDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Api", "properties": { + "edition": { + "description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS.", + "type": "string" + }, "methods": { "description": "The methods of this interface, in unspecified order.", "items": { @@ -954,6 +958,7 @@ "type": "object" }, "pathTranslation": { + "description": "no-lint", "enum": [ "PATH_TRANSLATION_UNSPECIFIED", "CONSTANT_ADDRESS", @@ -1491,7 +1496,7 @@ "type": "object" }, "Enum": { - "description": "Enum type definition.", + "description": "Enum type definition. New usages of this message as an alternative to EnumDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Enum", "properties": { "edition": { @@ -1538,7 +1543,7 @@ "type": "object" }, "EnumValue": { - "description": "Enum value definition.", + "description": "Enum value definition. New usages of this message as an alternative to EnumValueDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "EnumValue", "properties": { "name": { @@ -1580,7 +1585,7 @@ "type": "object" }, "Field": { - "description": "A single field of a message type.", + "description": "A single field of a message type. New usages of this message as an alternative to FieldDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Field", "properties": { "cardinality": { @@ -1716,7 +1721,7 @@ "additionalProperties": { "type": "string" }, - "description": "Map of service names to renamed services. Keys are the package relative service names and values are the name to be used for the service client and call options. publishing: go_settings: renamed_services: Publisher: TopicAdmin", + "description": "Map of service names to renamed services. Keys are the package relative service names and values are the name to be used for the service client and call options. Example: publishing: go_settings: renamed_services: Publisher: TopicAdmin", "type": "object" } }, @@ -1957,9 +1962,14 @@ "type": "object" }, "Method": { - "description": "Method represents a method of an API interface.", + "description": "Method represents a method of an API interface. New usages of this message as an alternative to MethodDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Method", "properties": { + "edition": { + "deprecated": true, + "description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS. This field should be ignored, instead the edition should be inherited from Api. This is similar to Field and EnumValue.", + "type": "string" + }, "name": { "description": "The simple name of this method.", "type": "string" @@ -1988,7 +1998,8 @@ "type": "string" }, "syntax": { - "description": "The source syntax of this method.", + "deprecated": true, + "description": "The source syntax of this method. This field should be ignored, instead the syntax should be inherited from Api. This is similar to Field and EnumValue.", "enum": [ "SYNTAX_PROTO2", "SYNTAX_PROTO3", @@ -2401,7 +2412,7 @@ "type": "object" }, "Option": { - "description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc.", + "description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc. New usages of this message as an alternative to FileOptions, MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, ServiceOptions, or MethodOptions are strongly discouraged.", "id": "Option", "properties": { "name": { @@ -2914,7 +2925,7 @@ "type": "object" }, "Type": { - "description": "A protocol buffer message type.", + "description": "A protocol buffer message type. New usages of this message as an alternative to DescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Type", "properties": { "edition": { diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index 8c1de807689..42768c0a40b 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -230,8 +230,15 @@ type ServicesConsumerQuotaMetricsLimitsProducerQuotaPoliciesService struct { // opposed to simply a description of methods and bindings. They are also // sometimes simply referred to as "APIs" in other contexts, such as the name // of this message itself. See https://cloud.google.com/apis/design/glossary -// for detailed terminology. +// for detailed terminology. New usages of this message as an alternative to +// ServiceDescriptorProto are strongly discouraged. This message does not +// reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Api struct { + // Edition: The source edition string, only valid when syntax is + // SYNTAX_EDITIONS. + Edition string `json:"edition,omitempty"` // Methods: The methods of this interface, in unspecified order. Methods []*Method `json:"methods,omitempty"` // Mixins: Included interfaces. See Mixin. @@ -266,13 +273,13 @@ type Api struct { // be omitted. Zero major versions must only be used for experimental, non-GA // interfaces. Version string `json:"version,omitempty"` - // ForceSendFields is a list of field names (e.g. "Methods") to unconditionally + // ForceSendFields is a list of field names (e.g. "Edition") 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. "Methods") to include in API + // NullFields is a list of field names (e.g. "Edition") 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. @@ -541,6 +548,8 @@ type BackendRule struct { // OverridesByRequestProtocol: The map between request protocol and the backend // address. OverridesByRequestProtocol map[string]BackendRule `json:"overridesByRequestProtocol,omitempty"` + // PathTranslation: no-lint + // // Possible values: // "PATH_TRANSLATION_UNSPECIFIED" // "CONSTANT_ADDRESS" - Use the backend address as-is, with no modification @@ -1330,7 +1339,11 @@ func (s Endpoint) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Enum: Enum type definition. +// Enum: Enum type definition. New usages of this message as an alternative to +// EnumDescriptorProto are strongly discouraged. This message does not +// reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Enum struct { // Edition: The source edition string, only valid when syntax is // SYNTAX_EDITIONS. @@ -1368,7 +1381,11 @@ func (s Enum) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// EnumValue: Enum value definition. +// EnumValue: Enum value definition. New usages of this message as an +// alternative to EnumValueDescriptorProto are strongly discouraged. This +// message does not reliability preserve all information necessary to model the +// schema and preserve semantics. Instead make use of FileDescriptorSet which +// preserves the necessary information. type EnumValue struct { // Name: Enum value name. Name string `json:"name,omitempty"` @@ -1431,7 +1448,11 @@ func (s ExperimentalFeatures) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Field: A single field of a message type. +// Field: A single field of a message type. New usages of this message as an +// alternative to FieldDescriptorProto are strongly discouraged. This message +// does not reliability preserve all information necessary to model the schema +// and preserve semantics. Instead make use of FileDescriptorSet which +// preserves the necessary information. type Field struct { // Cardinality: The field cardinality. // @@ -1549,8 +1570,8 @@ type GoSettings struct { Common *CommonLanguageSettings `json:"common,omitempty"` // RenamedServices: Map of service names to renamed services. Keys are the // package relative service names and values are the name to be used for the - // service client and call options. publishing: go_settings: renamed_services: - // Publisher: TopicAdmin + // service client and call options. Example: publishing: go_settings: + // renamed_services: Publisher: TopicAdmin RenamedServices map[string]string `json:"renamedServices,omitempty"` // ForceSendFields is a list of field names (e.g. "Common") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -2048,8 +2069,16 @@ func (s *LongRunning) UnmarshalJSON(data []byte) error { return nil } -// Method: Method represents a method of an API interface. +// Method: Method represents a method of an API interface. New usages of this +// message as an alternative to MethodDescriptorProto are strongly discouraged. +// This message does not reliability preserve all information necessary to +// model the schema and preserve semantics. Instead make use of +// FileDescriptorSet which preserves the necessary information. type Method struct { + // Edition: The source edition string, only valid when syntax is + // SYNTAX_EDITIONS. This field should be ignored, instead the edition should be + // inherited from Api. This is similar to Field and EnumValue. + Edition string `json:"edition,omitempty"` // Name: The simple name of this method. Name string `json:"name,omitempty"` // Options: Any metadata attached to the method. @@ -2062,22 +2091,24 @@ type Method struct { ResponseStreaming bool `json:"responseStreaming,omitempty"` // ResponseTypeUrl: The URL of the output message type. ResponseTypeUrl string `json:"responseTypeUrl,omitempty"` - // Syntax: The source syntax of this method. + // Syntax: The source syntax of this method. This field should be ignored, + // instead the syntax should be inherited from Api. This is similar to Field + // and EnumValue. // // Possible values: // "SYNTAX_PROTO2" - Syntax `proto2`. // "SYNTAX_PROTO3" - Syntax `proto3`. // "SYNTAX_EDITIONS" - Syntax `editions`. Syntax string `json:"syntax,omitempty"` - // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // ForceSendFields is a list of field names (e.g. "Edition") 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 + // NullFields is a list of field names (e.g. "Edition") 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:"-"` } @@ -2767,7 +2798,9 @@ func (s Operation) MarshalJSON() ([]byte, error) { } // Option: A protocol buffer option, which can be attached to a message, field, -// enumeration, etc. +// enumeration, etc. New usages of this message as an alternative to +// FileOptions, MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, +// ServiceOptions, or MethodOptions are strongly discouraged. type Option struct { // Name: The option's name. For protobuf built-in options (options defined in // descriptor.proto), this is the short name. For example, "map_entry". For @@ -3430,7 +3463,11 @@ func (s SystemParameters) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Type: A protocol buffer message type. +// Type: A protocol buffer message type. New usages of this message as an +// alternative to DescriptorProto are strongly discouraged. This message does +// not reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Type struct { // Edition: The source edition string, only valid when syntax is // SYNTAX_EDITIONS. diff --git a/servicedirectory/v1/servicedirectory-api.json b/servicedirectory/v1/servicedirectory-api.json index 127e6914390..38ce57a8c60 100644 --- a/servicedirectory/v1/servicedirectory-api.json +++ b/servicedirectory/v1/servicedirectory-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -889,7 +889,7 @@ } } }, - "revision": "20250822", + "revision": "20250906", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { diff --git a/servicedirectory/v1/servicedirectory-gen.go b/servicedirectory/v1/servicedirectory-gen.go index 66a7de77a77..aae5f5980b9 100644 --- a/servicedirectory/v1/servicedirectory-gen.go +++ b/servicedirectory/v1/servicedirectory-gen.go @@ -1083,9 +1083,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/servicedirectory/v1beta1/servicedirectory-api.json b/servicedirectory/v1beta1/servicedirectory-api.json index 73d44188db5..709bd6fb41b 100644 --- a/servicedirectory/v1beta1/servicedirectory-api.json +++ b/servicedirectory/v1beta1/servicedirectory-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -977,7 +977,7 @@ } } }, - "revision": "20250822", + "revision": "20250906", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { diff --git a/servicedirectory/v1beta1/servicedirectory-gen.go b/servicedirectory/v1beta1/servicedirectory-gen.go index f75b5f9e31c..180ff4a9742 100644 --- a/servicedirectory/v1beta1/servicedirectory-gen.go +++ b/servicedirectory/v1beta1/servicedirectory-gen.go @@ -1107,9 +1107,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index 8cec9f1a9f1..7b2c27c0e6c 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -964,7 +964,7 @@ } } }, - "revision": "20250619", + "revision": "20250919", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1106,9 +1106,13 @@ "type": "object" }, "Api": { - "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.", + "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology. New usages of this message as an alternative to ServiceDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Api", "properties": { + "edition": { + "description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS.", + "type": "string" + }, "methods": { "description": "The methods of this interface, in unspecified order.", "items": { @@ -1332,6 +1336,7 @@ "type": "object" }, "pathTranslation": { + "description": "no-lint", "enum": [ "PATH_TRANSLATION_UNSPECIFIED", "CONSTANT_ADDRESS", @@ -1762,6 +1767,31 @@ }, "type": "object" }, + "ContentSecurity": { + "description": "ContentSecurity defines the content security related fields of a MCP policy.", + "id": "ContentSecurity", + "properties": { + "contentSecurityProviders": { + "description": "List of content security providers that are enabled for content scanning.", + "items": { + "$ref": "ContentSecurityProvider" + }, + "type": "array" + } + }, + "type": "object" + }, + "ContentSecurityProvider": { + "description": "ContentSecurityProvider contains the name of content security provider.", + "id": "ContentSecurityProvider", + "properties": { + "name": { + "description": "Name of security service for content scanning, such as Google Cloud Model Armor or supported third-party ISV solutions. If it is Google 1P service, the name should be prefixed with `services/`. If it is a 3P service, the format needs to be documented. The currently supported values are: - `services/modelarmor.googleapis.com` for Google Cloud Model Armor.", + "type": "string" + } + }, + "type": "object" + }, "Context": { "description": "`Context` defines which contexts an API requests. Example: context: rules: - selector: \"*\" requested: - google.rpc.context.ProjectContext - google.rpc.context.OriginContext The above specifies that all methods in the API request `google.rpc.context.ProjectContext` and `google.rpc.context.OriginContext`. Available context types are defined in package `google.rpc.context`. This also provides mechanism to allowlist any protobuf message extension that can be sent in grpc metadata using “x-goog-ext--bin” and “x-goog-ext--jspb” format. For example, list any service specific protobuf types that can appear in grpc metadata as follows in your yaml file: Example: context: rules: - selector: \"google.example.library.v1.LibraryService.CreateBook\" allowed_request_extensions: - google.foo.v1.NewExtension allowed_response_extensions: - google.foo.v1.NewExtension You can also specify extension ID instead of fully qualified extension name here.", "id": "Context", @@ -2152,7 +2182,7 @@ "type": "object" }, "Enum": { - "description": "Enum type definition.", + "description": "Enum type definition. New usages of this message as an alternative to EnumDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Enum", "properties": { "edition": { @@ -2199,7 +2229,7 @@ "type": "object" }, "EnumValue": { - "description": "Enum value definition.", + "description": "Enum value definition. New usages of this message as an alternative to EnumValueDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "EnumValue", "properties": { "name": { @@ -2241,7 +2271,7 @@ "type": "object" }, "Field": { - "description": "A single field of a message type.", + "description": "A single field of a message type. New usages of this message as an alternative to FieldDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Field", "properties": { "cardinality": { @@ -2406,7 +2436,7 @@ "additionalProperties": { "type": "string" }, - "description": "Map of service names to renamed services. Keys are the package relative service names and values are the name to be used for the service client and call options. publishing: go_settings: renamed_services: Publisher: TopicAdmin", + "description": "Map of service names to renamed services. Keys are the package relative service names and values are the name to be used for the service client and call options. Example: publishing: go_settings: renamed_services: Publisher: TopicAdmin", "type": "object" } }, @@ -2869,8 +2899,7 @@ "type": "array" }, "etag": { - "description": "Output only. An opaque tag indicating the current version of the policy, used for concurrency control.", - "readOnly": true, + "description": "An opaque tag indicating the current version of the policy, used for concurrency control.", "type": "string" }, "name": { @@ -2922,6 +2951,11 @@ ], "readOnly": true, "type": "string" + }, + "missingDependency": { + "description": "Output only. This field will be populated only for the `DEPENDENCY_MISSING_DEPENDENCIES` impact type. Example: `services/compute.googleapis.com`. Impact.detail will be in format : `missing service dependency: {missing_dependency}.`", + "readOnly": true, + "type": "string" } }, "type": "object" @@ -3411,10 +3445,79 @@ }, "type": "object" }, + "McpEnableRule": { + "description": "McpEnableRule contains MCP enablement related rules.", + "id": "McpEnableRule", + "properties": { + "mcpServices": { + "description": "List of enabled MCP services.", + "items": { + "$ref": "McpService" + }, + "type": "array" + } + }, + "type": "object" + }, + "McpPolicy": { + "description": "MCP Consumer Policy is a set of rules that define MCP related policy for a cloud resource hierarchy.", + "id": "McpPolicy", + "properties": { + "contentSecurity": { + "$ref": "ContentSecurity", + "description": "ContentSecurity contains the content security related fields of a MCP policy." + }, + "createTime": { + "description": "Output only. The time the policy was created. For singleton policies (such as the `default` policy), this is the first touch of the policy.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "etag": { + "description": "An opaque tag indicating the current version of the policy, used for concurrency control.", + "type": "string" + }, + "mcpEnableRules": { + "description": "McpEnableRules contains MCP enablement related rules.", + "items": { + "$ref": "McpEnableRule" + }, + "type": "array" + }, + "name": { + "description": "Output only. The resource name of the policy. Only the `default` policy is supported. We allow the following formats: `projects/{PROJECT_NUMBER}/mcpPolicies/default`, `projects/{PROJECT_ID}/mcpPolicies/default`, `folders/{FOLDER_ID}/mcpPolicies/default`, `organizations/{ORG_ID}/mcpPolicies/default`.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. The time the policy was last updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "McpService": { + "description": "McpService contains the service names that are enabled for MCP.", + "id": "McpService", + "properties": { + "service": { + "description": "The names of the services that are enabled for MCP. Example: `services/library-example.googleapis.com`", + "type": "string" + } + }, + "type": "object" + }, "Method": { - "description": "Method represents a method of an API interface.", + "description": "Method represents a method of an API interface. New usages of this message as an alternative to MethodDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Method", "properties": { + "edition": { + "deprecated": true, + "description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS. This field should be ignored, instead the edition should be inherited from Api. This is similar to Field and EnumValue.", + "type": "string" + }, "name": { "description": "The simple name of this method.", "type": "string" @@ -3443,7 +3546,8 @@ "type": "string" }, "syntax": { - "description": "The source syntax of this method.", + "deprecated": true, + "description": "The source syntax of this method. This field should be ignored, instead the syntax should be inherited from Api. This is similar to Field and EnumValue.", "enum": [ "SYNTAX_PROTO2", "SYNTAX_PROTO3", @@ -3870,7 +3974,7 @@ "type": "object" }, "Option": { - "description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc.", + "description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc. New usages of this message as an alternative to FileOptions, MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, ServiceOptions, or MethodOptions are strongly discouraged.", "id": "Option", "properties": { "name": { @@ -4500,7 +4604,7 @@ "type": "object" }, "Type": { - "description": "A protocol buffer message type.", + "description": "A protocol buffer message type. New usages of this message as an alternative to DescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.", "id": "Type", "properties": { "edition": { @@ -4565,6 +4669,12 @@ "properties": {}, "type": "object" }, + "UpdateMcpPolicyMetadata": { + "description": "Metadata for the `UpdateMcpPolicy` method.", + "id": "UpdateMcpPolicyMetadata", + "properties": {}, + "type": "object" + }, "Usage": { "description": "Configuration controlling usage of a service.", "id": "Usage", diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index d86812d3481..62d63250910 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -419,8 +419,15 @@ func (s AnalyzeConsumerPolicyResponse) MarshalJSON() ([]byte, error) { // opposed to simply a description of methods and bindings. They are also // sometimes simply referred to as "APIs" in other contexts, such as the name // of this message itself. See https://cloud.google.com/apis/design/glossary -// for detailed terminology. +// for detailed terminology. New usages of this message as an alternative to +// ServiceDescriptorProto are strongly discouraged. This message does not +// reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Api struct { + // Edition: The source edition string, only valid when syntax is + // SYNTAX_EDITIONS. + Edition string `json:"edition,omitempty"` // Methods: The methods of this interface, in unspecified order. Methods []*Method `json:"methods,omitempty"` // Mixins: Included interfaces. See Mixin. @@ -455,13 +462,13 @@ type Api struct { // be omitted. Zero major versions must only be used for experimental, non-GA // interfaces. Version string `json:"version,omitempty"` - // ForceSendFields is a list of field names (e.g. "Methods") to unconditionally + // ForceSendFields is a list of field names (e.g. "Edition") 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. "Methods") to include in API + // NullFields is a list of field names (e.g. "Edition") 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. @@ -730,6 +737,8 @@ type BackendRule struct { // OverridesByRequestProtocol: The map between request protocol and the backend // address. OverridesByRequestProtocol map[string]BackendRule `json:"overridesByRequestProtocol,omitempty"` + // PathTranslation: no-lint + // // Possible values: // "PATH_TRANSLATION_UNSPECIFIED" // "CONSTANT_ADDRESS" - Use the backend address as-is, with no modification @@ -1335,6 +1344,57 @@ func (s ConsumerQuotaMetric) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ContentSecurity: ContentSecurity defines the content security related fields +// of a MCP policy. +type ContentSecurity struct { + // ContentSecurityProviders: List of content security providers that are + // enabled for content scanning. + ContentSecurityProviders []*ContentSecurityProvider `json:"contentSecurityProviders,omitempty"` + // ForceSendFields is a list of field names (e.g. "ContentSecurityProviders") + // 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. "ContentSecurityProviders") 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 ContentSecurity) MarshalJSON() ([]byte, error) { + type NoMethod ContentSecurity + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// ContentSecurityProvider: ContentSecurityProvider contains the name of +// content security provider. +type ContentSecurityProvider struct { + // Name: Name of security service for content scanning, such as Google Cloud + // Model Armor or supported third-party ISV solutions. If it is Google 1P + // service, the name should be prefixed with `services/`. If it is a 3P + // service, the format needs to be documented. The currently supported values + // are: - `services/modelarmor.googleapis.com` for Google Cloud Model Armor. + Name string `json:"name,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 ContentSecurityProvider) MarshalJSON() ([]byte, error) { + type NoMethod ContentSecurityProvider + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Context: `Context` defines which contexts an API requests. Example: context: // rules: - selector: "*" requested: - google.rpc.context.ProjectContext - // google.rpc.context.OriginContext The above specifies that all methods in the @@ -1894,7 +1954,11 @@ func (s Endpoint) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Enum: Enum type definition. +// Enum: Enum type definition. New usages of this message as an alternative to +// EnumDescriptorProto are strongly discouraged. This message does not +// reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Enum struct { // Edition: The source edition string, only valid when syntax is // SYNTAX_EDITIONS. @@ -1932,7 +1996,11 @@ func (s Enum) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// EnumValue: Enum value definition. +// EnumValue: Enum value definition. New usages of this message as an +// alternative to EnumValueDescriptorProto are strongly discouraged. This +// message does not reliability preserve all information necessary to model the +// schema and preserve semantics. Instead make use of FileDescriptorSet which +// preserves the necessary information. type EnumValue struct { // Name: Enum value name. Name string `json:"name,omitempty"` @@ -1995,7 +2063,11 @@ func (s ExperimentalFeatures) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Field: A single field of a message type. +// Field: A single field of a message type. New usages of this message as an +// alternative to FieldDescriptorProto are strongly discouraged. This message +// does not reliability preserve all information necessary to model the schema +// and preserve semantics. Instead make use of FileDescriptorSet which +// preserves the necessary information. type Field struct { // Cardinality: The field cardinality. // @@ -2148,8 +2220,8 @@ type GoSettings struct { Common *CommonLanguageSettings `json:"common,omitempty"` // RenamedServices: Map of service names to renamed services. Keys are the // package relative service names and values are the name to be used for the - // service client and call options. publishing: go_settings: renamed_services: - // Publisher: TopicAdmin + // service client and call options. Example: publishing: go_settings: + // renamed_services: Publisher: TopicAdmin RenamedServices map[string]string `json:"renamedServices,omitempty"` // ForceSendFields is a list of field names (e.g. "Common") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -2653,8 +2725,8 @@ type GoogleApiServiceusageV2betaConsumerPolicy struct { // There can currently be at most one `EnableRule`. This restriction will be // lifted in later releases. EnableRules []*GoogleApiServiceusageV2betaEnableRule `json:"enableRules,omitempty"` - // Etag: Output only. An opaque tag indicating the current version of the - // policy, used for concurrency control. + // Etag: An opaque tag indicating the current version of the policy, used for + // concurrency control. Etag string `json:"etag,omitempty"` // Name: Output only. The resource name of the policy. Only the `default` // policy is supported: `projects/12345/consumerPolicies/default`, @@ -2720,6 +2792,11 @@ type GoogleApiServiceusageV2betaImpact struct { // "DEPENDENCY_MISSING_DEPENDENCIES" - Block 1 - Impact Type of // ANALYSIS_TYPE_DEPENDENCY ImpactType string `json:"impactType,omitempty"` + // MissingDependency: Output only. This field will be populated only for the + // `DEPENDENCY_MISSING_DEPENDENCIES` impact type. Example: + // `services/compute.googleapis.com`. Impact.detail will be in format : + // `missing service dependency: {missing_dependency}.` + MissingDependency string `json:"missingDependency,omitempty"` // ForceSendFields is a list of field names (e.g. "Detail") to unconditionally // include in API requests. By default, fields with empty or default values are // omitted from API requests. See @@ -3582,8 +3659,103 @@ func (s *LongRunning) UnmarshalJSON(data []byte) error { return nil } -// Method: Method represents a method of an API interface. +// McpEnableRule: McpEnableRule contains MCP enablement related rules. +type McpEnableRule struct { + // McpServices: List of enabled MCP services. + McpServices []*McpService `json:"mcpServices,omitempty"` + // ForceSendFields is a list of field names (e.g. "McpServices") 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. "McpServices") 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 McpEnableRule) MarshalJSON() ([]byte, error) { + type NoMethod McpEnableRule + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// McpPolicy: MCP Consumer Policy is a set of rules that define MCP related +// policy for a cloud resource hierarchy. +type McpPolicy struct { + // ContentSecurity: ContentSecurity contains the content security related + // fields of a MCP policy. + ContentSecurity *ContentSecurity `json:"contentSecurity,omitempty"` + // CreateTime: Output only. The time the policy was created. For singleton + // policies (such as the `default` policy), this is the first touch of the + // policy. + CreateTime string `json:"createTime,omitempty"` + // Etag: An opaque tag indicating the current version of the policy, used for + // concurrency control. + Etag string `json:"etag,omitempty"` + // McpEnableRules: McpEnableRules contains MCP enablement related rules. + McpEnableRules []*McpEnableRule `json:"mcpEnableRules,omitempty"` + // Name: Output only. The resource name of the policy. Only the `default` + // policy is supported. We allow the following formats: + // `projects/{PROJECT_NUMBER}/mcpPolicies/default`, + // `projects/{PROJECT_ID}/mcpPolicies/default`, + // `folders/{FOLDER_ID}/mcpPolicies/default`, + // `organizations/{ORG_ID}/mcpPolicies/default`. + Name string `json:"name,omitempty"` + // UpdateTime: Output only. The time the policy was last updated. + UpdateTime string `json:"updateTime,omitempty"` + // ForceSendFields is a list of field names (e.g. "ContentSecurity") 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. "ContentSecurity") 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 McpPolicy) MarshalJSON() ([]byte, error) { + type NoMethod McpPolicy + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// McpService: McpService contains the service names that are enabled for MCP. +type McpService struct { + // Service: The names of the services that are enabled for MCP. Example: + // `services/library-example.googleapis.com` + Service string `json:"service,omitempty"` + // ForceSendFields is a list of field names (e.g. "Service") 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. "Service") 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 McpService) MarshalJSON() ([]byte, error) { + type NoMethod McpService + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// Method: Method represents a method of an API interface. New usages of this +// message as an alternative to MethodDescriptorProto are strongly discouraged. +// This message does not reliability preserve all information necessary to +// model the schema and preserve semantics. Instead make use of +// FileDescriptorSet which preserves the necessary information. type Method struct { + // Edition: The source edition string, only valid when syntax is + // SYNTAX_EDITIONS. This field should be ignored, instead the edition should be + // inherited from Api. This is similar to Field and EnumValue. + Edition string `json:"edition,omitempty"` // Name: The simple name of this method. Name string `json:"name,omitempty"` // Options: Any metadata attached to the method. @@ -3596,22 +3768,24 @@ type Method struct { ResponseStreaming bool `json:"responseStreaming,omitempty"` // ResponseTypeUrl: The URL of the output message type. ResponseTypeUrl string `json:"responseTypeUrl,omitempty"` - // Syntax: The source syntax of this method. + // Syntax: The source syntax of this method. This field should be ignored, + // instead the syntax should be inherited from Api. This is similar to Field + // and EnumValue. // // Possible values: // "SYNTAX_PROTO2" - Syntax `proto2`. // "SYNTAX_PROTO3" - Syntax `proto3`. // "SYNTAX_EDITIONS" - Syntax `editions`. Syntax string `json:"syntax,omitempty"` - // ForceSendFields is a list of field names (e.g. "Name") to unconditionally + // ForceSendFields is a list of field names (e.g. "Edition") 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 + // NullFields is a list of field names (e.g. "Edition") 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:"-"` } @@ -4325,7 +4499,9 @@ func (s OperationMetadata) MarshalJSON() ([]byte, error) { } // Option: A protocol buffer option, which can be attached to a message, field, -// enumeration, etc. +// enumeration, etc. New usages of this message as an alternative to +// FileOptions, MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, +// ServiceOptions, or MethodOptions are strongly discouraged. type Option struct { // Name: The option's name. For protobuf built-in options (options defined in // descriptor.proto), this is the short name. For example, "map_entry". For @@ -5226,7 +5402,11 @@ func (s SystemParameters) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Type: A protocol buffer message type. +// Type: A protocol buffer message type. New usages of this message as an +// alternative to DescriptorProto are strongly discouraged. This message does +// not reliability preserve all information necessary to model the schema and +// preserve semantics. Instead make use of FileDescriptorSet which preserves +// the necessary information. type Type struct { // Edition: The source edition string, only valid when syntax is // SYNTAX_EDITIONS. @@ -5277,6 +5457,10 @@ type UpdateAdminQuotaPolicyMetadata struct { type UpdateConsumerPolicyMetadata struct { } +// UpdateMcpPolicyMetadata: Metadata for the `UpdateMcpPolicy` method. +type UpdateMcpPolicyMetadata struct { +} + // Usage: Configuration controlling usage of a service. type Usage struct { // ProducerNotificationChannel: The full resource name of a channel used for diff --git a/sqladmin/v1/sqladmin-api.json b/sqladmin/v1/sqladmin-api.json index f816df03bed..3ebc03069bb 100644 --- a/sqladmin/v1/sqladmin-api.json +++ b/sqladmin/v1/sqladmin-api.json @@ -17,7 +17,7 @@ "canonicalName": "SQL Admin", "description": "API for Cloud SQL database instance management", "discoveryVersion": "v1", - "documentationLink": "https://developers.google.com/cloud-sql/", + "documentationLink": "https://cloud.google.com/sql/docs", "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -1445,6 +1445,41 @@ "https://www.googleapis.com/auth/sqlservice.admin" ] }, + "preCheckMajorVersionUpgrade": { + "description": "Execute MVU Pre-checks", + "flatPath": "v1/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade", + "httpMethod": "POST", + "id": "sql.instances.preCheckMajorVersionUpgrade", + "parameterOrder": [ + "project", + "instance" + ], + "parameters": { + "instance": { + "description": "Required. Cloud SQL instance ID. This does not include the project ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Required. Project ID of the project that contains the instance.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "v1/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade", + "request": { + "$ref": "InstancesPreCheckMajorVersionUpgradeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sqlservice.admin" + ] + }, "promoteReplica": { "description": "Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.", "flatPath": "v1/projects/{project}/instances/{instance}/promoteReplica", @@ -1565,6 +1600,21 @@ "required": true, "type": "string" }, + "mode": { + "description": "Optional. Reset SSL mode to use.", + "enum": [ + "RESET_SSL_MODE_UNSPECIFIED", + "ALL", + "SYNC_FROM_PRIMARY" + ], + "enumDescriptions": [ + "Reset SSL mode is not specified.", + "Refresh all TLS configs. This is the default behaviour.", + "Refreshes the replication-related TLS configuration settings provided by the primary instance. Not applicable to on-premises replication instances." + ], + "location": "query", + "type": "string" + }, "project": { "description": "Project ID of the project that contains the instance.", "location": "path", @@ -2635,7 +2685,7 @@ } } }, - "revision": "20250823", + "revision": "20250915", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2751,7 +2801,7 @@ "type": "object" }, "Backup": { - "description": "A backup resource. Next ID: 30", + "description": "A backup resource.", "id": "Backup", "properties": { "backupInterval": { @@ -5755,6 +5805,17 @@ }, "type": "object" }, + "InstancesPreCheckMajorVersionUpgradeRequest": { + "description": "Request for Pre-checks for MVU", + "id": "InstancesPreCheckMajorVersionUpgradeRequest", + "properties": { + "preCheckMajorVersionUpgradeContext": { + "$ref": "PreCheckMajorVersionUpgradeContext", + "description": "Required. Contains details about the pre-check major version upgrade operation." + } + }, + "type": "object" + }, "InstancesReencryptRequest": { "description": "Database Instance reencrypt request.", "id": "InstancesReencryptRequest", @@ -6047,6 +6108,21 @@ }, "type": "object" }, + "Message": { + "description": "Represents a notice or warning message from the database.", + "id": "Message", + "properties": { + "message": { + "description": "The full message string. For PostgreSQL, this is a formatted string that may include severity, code, and the notice/warning message. For MySQL, this contains the warning message.", + "type": "string" + }, + "severity": { + "description": "The severity of the message (e.g., \"NOTICE\" for PostgreSQL, \"WARNING\" for MySQL).", + "type": "string" + } + }, + "type": "object" + }, "Metadata": { "description": "The additional metadata information regarding the execution of the SQL statements.", "id": "Metadata", @@ -6404,6 +6480,10 @@ ], "type": "string" }, + "preCheckMajorVersionUpgradeContext": { + "$ref": "PreCheckMajorVersionUpgradeContext", + "description": "This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found)." + }, "selfLink": { "description": "The URI of this resource.", "type": "string" @@ -6741,6 +6821,216 @@ }, "type": "object" }, + "PreCheckMajorVersionUpgradeContext": { + "description": "Pre-check major version upgrade context.", + "id": "PreCheckMajorVersionUpgradeContext", + "properties": { + "kind": { + "description": "Optional. This is always `sql#preCheckMajorVersionUpgradeContext`.", + "type": "string" + }, + "preCheckResponse": { + "description": "Output only. The responses from the precheck operation.", + "items": { + "$ref": "PreCheckResponse" + }, + "readOnly": true, + "type": "array" + }, + "targetDatabaseVersion": { + "description": "Required. The target database version to upgrade to.", + "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_39", + "MYSQL_8_0_40", + "MYSQL_8_0_41", + "MYSQL_8_0_42", + "MYSQL_8_0_43", + "MYSQL_8_0_44", + "MYSQL_8_0_45", + "MYSQL_8_0_46", + "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, + 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 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 major version is MySQL 8.0 and the minor version is 43.", + "The database major version is MySQL 8.0 and the minor version is 44.", + "The database major version is MySQL 8.0 and the minor version is 45.", + "The database major version is MySQL 8.0 and the minor version is 46.", + "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." + ], + "type": "string" + } + }, + "type": "object" + }, + "PreCheckResponse": { + "description": "Structured PreCheckResponse containing message, type, and required actions.", + "id": "PreCheckResponse", + "properties": { + "actionsRequired": { + "description": "The actions that the user needs to take. Use repeated for multiple actions.", + "items": { + "type": "string" + }, + "type": "array" + }, + "message": { + "description": "The message to be displayed to the user.", + "type": "string" + }, + "messageType": { + "description": "The type of message whether it is an info, warning, or error.", + "enum": [ + "MESSAGE_TYPE_UNSPECIFIED", + "INFO", + "WARNING", + "ERROR" + ], + "enumDescriptions": [ + "Default unspecified value to prevent unintended behavior changes.", + "General informational messages that don't require action.", + "Warnings that might impact the upgrade but don't block it.", + "Errors that a user must resolve before proceeding with the upgrade." + ], + "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", @@ -6826,6 +7116,48 @@ }, "type": "object" }, + "ReadPoolAutoScaleConfig": { + "description": "The read pool auto-scale configuration.", + "id": "ReadPoolAutoScaleConfig", + "properties": { + "disableScaleIn": { + "description": "Indicates whether read pool auto scaling supports scale in operations (removing nodes).", + "type": "boolean" + }, + "enabled": { + "description": "Indicates whether read pool auto scaling is enabled.", + "type": "boolean" + }, + "maxNodeCount": { + "description": "Maximum number of read pool nodes to be maintained.", + "format": "int32", + "type": "integer" + }, + "minNodeCount": { + "description": "Minimum number of read pool nodes to be maintained.", + "format": "int32", + "type": "integer" + }, + "scaleInCooldownSeconds": { + "description": "The cooldown period for scale-in operations.", + "format": "int32", + "type": "integer" + }, + "scaleOutCooldownSeconds": { + "description": "The cooldown period for scale-out operations.", + "format": "int32", + "type": "integer" + }, + "targetMetrics": { + "description": "Optional. Target metrics for read pool auto scaling.", + "items": { + "$ref": "TargetMetric" + }, + "type": "array" + } + }, + "type": "object" + }, "ReplicaConfiguration": { "description": "Read-replica configuration for connecting to the primary instance.", "id": "ReplicaConfiguration", @@ -7193,6 +7525,10 @@ ], "type": "string" }, + "readPoolAutoScaleConfig": { + "$ref": "ReadPoolAutoScaleConfig", + "description": "Optional. The read pool auto-scale configuration for the instance." + }, "replicationLagMaxSeconds": { "description": "Optional. Configuration value for recreation of replica after certain replication lag", "format": "int32", @@ -7369,7 +7705,8 @@ "PSC_ONLY_INSTANCE_WITH_NO_NETWORK_ATTACHMENT_URI", "SELECTED_OBJECTS_REFERENCE_UNSELECTED_OBJECTS", "PROMPT_DELETE_EXISTING", - "WILL_DELETE_EXISTING" + "WILL_DELETE_EXISTING", + "PG_DDL_REPLICATION_INSUFFICIENT_PRIVILEGE" ], "enumDescriptions": [ "", @@ -7429,7 +7766,8 @@ "PSC only destination instance does not have a network attachment URI.", "Selected objects reference unselected objects. Based on their object type (foreign key constraint or view), selected objects will fail during migration.", "The migration will delete existing data in the replica; set replica_overwrite_enabled in the request to acknowledge this. This is an error. MySQL only.", - "The migration will delete existing data in the replica; replica_overwrite_enabled was set in the request acknowledging this. This is a warning rather than an error. MySQL only." + "The migration will delete existing data in the replica; replica_overwrite_enabled was set in the request acknowledging this. This is a warning rather than an error. MySQL only.", + "The replication user is missing specific privileges to setup DDL replication. (e.g. CREATE EVENT TRIGGER, CREATE SCHEMA) for PostgreSQL." ], "type": "string" } @@ -7451,6 +7789,13 @@ "description": "Execute SQL statements response.", "id": "SqlInstancesExecuteSqlResponse", "properties": { + "messages": { + "description": "A list of notices and warnings generated during query execution. For PostgreSQL, this includes all notices and warnings. For MySQL, this includes warnings generated by the last executed statement. To retrieve all warnings for a multi-statement query, `SHOW WARNINGS` must be executed after each statement.", + "items": { + "$ref": "Message" + }, + "type": "array" + }, "metadata": { "$ref": "Metadata", "description": "The additional metadata information regarding the execution of the SQL statements." @@ -7969,6 +8314,22 @@ }, "type": "object" }, + "TargetMetric": { + "description": "Target metric for read pool auto scaling.", + "id": "TargetMetric", + "properties": { + "metric": { + "description": "The metric name to be used for auto scaling.", + "type": "string" + }, + "targetValue": { + "description": "The target value for the metric.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "Tier": { "description": "A Google Cloud SQL service tier resource.", "id": "Tier", @@ -8062,6 +8423,20 @@ "description": "Optional. The host from which the user can connect. For `insert` operations, host defaults to an empty string. For `update` operations, host is specified as part of the request URL. The host name cannot be updated after insertion. For a MySQL instance, it's required; for a PostgreSQL or SQL Server instance, it's optional.", "type": "string" }, + "iamStatus": { + "description": "Indicates if a group is active or inactive for IAM database authentication.", + "enum": [ + "IAM_STATUS_UNSPECIFIED", + "INACTIVE", + "ACTIVE" + ], + "enumDescriptions": [ + "The default value for users that are not of type CLOUD_IAM_GROUP. Only CLOUD_IAM_GROUP users will be inactive or active. Users with an IamStatus of IAM_STATUS_UNSPECIFIED will not display whether they are active or inactive as that is not applicable to them.", + "INACTIVE indicates a group is not available for IAM database authentication.", + "ACTIVE indicates a group is available for IAM database authentication." + ], + "type": "string" + }, "instance": { "description": "The name of the Cloud SQL instance. This does not include the project ID. Can be omitted for `update` because it is already specified on the URL.", "type": "string" diff --git a/sqladmin/v1/sqladmin-gen.go b/sqladmin/v1/sqladmin-gen.go index 4db268e61a5..48baedcc873 100644 --- a/sqladmin/v1/sqladmin-gen.go +++ b/sqladmin/v1/sqladmin-gen.go @@ -6,7 +6,7 @@ // Package sqladmin provides access to the Cloud SQL Admin API. // -// For product documentation, see: https://developers.google.com/cloud-sql/ +// For product documentation, see: https://cloud.google.com/sql/docs // // # Library status // @@ -454,7 +454,7 @@ func (s AvailableDatabaseVersion) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Backup: A backup resource. Next ID: 30 +// Backup: A backup resource. type Backup struct { // BackupInterval: Output only. This output contains the following values: // start_time: All database writes up to this time are available. end_time: Any @@ -3344,6 +3344,31 @@ func (s InstancesListServerCertificatesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InstancesPreCheckMajorVersionUpgradeRequest: Request for Pre-checks for MVU +type InstancesPreCheckMajorVersionUpgradeRequest struct { + // PreCheckMajorVersionUpgradeContext: Required. Contains details about the + // pre-check major version upgrade operation. + PreCheckMajorVersionUpgradeContext *PreCheckMajorVersionUpgradeContext `json:"preCheckMajorVersionUpgradeContext,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "PreCheckMajorVersionUpgradeContext") 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. + // "PreCheckMajorVersionUpgradeContext") 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 InstancesPreCheckMajorVersionUpgradeRequest) MarshalJSON() ([]byte, error) { + type NoMethod InstancesPreCheckMajorVersionUpgradeRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // InstancesReencryptRequest: Database Instance reencrypt request. type InstancesReencryptRequest struct { // BackupReencryptionConfig: Configuration specific to backup re-encryption @@ -3776,6 +3801,33 @@ func (s MaintenanceWindow) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Message: Represents a notice or warning message from the database. +type Message struct { + // Message: The full message string. For PostgreSQL, this is a formatted string + // that may include severity, code, and the notice/warning message. For MySQL, + // this contains the warning message. + Message string `json:"message,omitempty"` + // Severity: The severity of the message (e.g., "NOTICE" for PostgreSQL, + // "WARNING" for MySQL). + Severity string `json:"severity,omitempty"` + // ForceSendFields is a list of field names (e.g. "Message") 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. "Message") 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 Message) MarshalJSON() ([]byte, error) { + type NoMethod Message + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Metadata: The additional metadata information regarding the execution of the // SQL statements. type Metadata struct { @@ -4045,6 +4097,12 @@ type Operation struct { // in the read pool. // "CREATE_READ_POOL" - Creates a Cloud SQL read pool instance. OperationType string `json:"operationType,omitempty"` + // PreCheckMajorVersionUpgradeContext: This field is only populated when the + // operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The + // PreCheckMajorVersionUpgradeContext message itself contains the details for + // that pre-check, such as the target database version for the upgrade and the + // results of the check (including any warnings or errors found). + PreCheckMajorVersionUpgradeContext *PreCheckMajorVersionUpgradeContext `json:"preCheckMajorVersionUpgradeContext,omitempty"` // SelfLink: The URI of this resource. SelfLink string `json:"selfLink,omitempty"` // StartTime: The time this operation actually started in UTC timezone in RFC @@ -4398,6 +4456,149 @@ func (s PoolNodeConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PreCheckMajorVersionUpgradeContext: Pre-check major version upgrade context. +type PreCheckMajorVersionUpgradeContext struct { + // Kind: Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + Kind string `json:"kind,omitempty"` + // PreCheckResponse: Output only. The responses from the precheck operation. + PreCheckResponse []*PreCheckResponse `json:"preCheckResponse,omitempty"` + // TargetDatabaseVersion: Required. The target database version to upgrade to. + // + // 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_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_0_43" - The database major version is MySQL 8.0 and the minor + // version is 43. + // "MYSQL_8_0_44" - The database major version is MySQL 8.0 and the minor + // version is 44. + // "MYSQL_8_0_45" - The database major version is MySQL 8.0 and the minor + // version is 45. + // "MYSQL_8_0_46" - The database major version is MySQL 8.0 and the minor + // version is 46. + // "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. + TargetDatabaseVersion string `json:"targetDatabaseVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "Kind") 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. "Kind") 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 PreCheckMajorVersionUpgradeContext) MarshalJSON() ([]byte, error) { + type NoMethod PreCheckMajorVersionUpgradeContext + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// PreCheckResponse: Structured PreCheckResponse containing message, type, and +// required actions. +type PreCheckResponse struct { + // ActionsRequired: The actions that the user needs to take. Use repeated for + // multiple actions. + ActionsRequired []string `json:"actionsRequired,omitempty"` + // Message: The message to be displayed to the user. + Message string `json:"message,omitempty"` + // MessageType: The type of message whether it is an info, warning, or error. + // + // Possible values: + // "MESSAGE_TYPE_UNSPECIFIED" - Default unspecified value to prevent + // unintended behavior changes. + // "INFO" - General informational messages that don't require action. + // "WARNING" - Warnings that might impact the upgrade but don't block it. + // "ERROR" - Errors that a user must resolve before proceeding with the + // upgrade. + MessageType string `json:"messageType,omitempty"` + // ForceSendFields is a list of field names (e.g. "ActionsRequired") 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. "ActionsRequired") 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 PreCheckResponse) MarshalJSON() ([]byte, error) { + type NoMethod PreCheckResponse + 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 { @@ -4503,6 +4704,41 @@ func (s QueryResult) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ReadPoolAutoScaleConfig: The read pool auto-scale configuration. +type ReadPoolAutoScaleConfig struct { + // DisableScaleIn: Indicates whether read pool auto scaling supports scale in + // operations (removing nodes). + DisableScaleIn bool `json:"disableScaleIn,omitempty"` + // Enabled: Indicates whether read pool auto scaling is enabled. + Enabled bool `json:"enabled,omitempty"` + // MaxNodeCount: Maximum number of read pool nodes to be maintained. + MaxNodeCount int64 `json:"maxNodeCount,omitempty"` + // MinNodeCount: Minimum number of read pool nodes to be maintained. + MinNodeCount int64 `json:"minNodeCount,omitempty"` + // ScaleInCooldownSeconds: The cooldown period for scale-in operations. + ScaleInCooldownSeconds int64 `json:"scaleInCooldownSeconds,omitempty"` + // ScaleOutCooldownSeconds: The cooldown period for scale-out operations. + ScaleOutCooldownSeconds int64 `json:"scaleOutCooldownSeconds,omitempty"` + // TargetMetrics: Optional. Target metrics for read pool auto scaling. + TargetMetrics []*TargetMetric `json:"targetMetrics,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisableScaleIn") 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. "DisableScaleIn") 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 ReadPoolAutoScaleConfig) MarshalJSON() ([]byte, error) { + type NoMethod ReadPoolAutoScaleConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ReplicaConfiguration: Read-replica configuration for connecting to the // primary instance. type ReplicaConfiguration struct { @@ -4893,6 +5129,9 @@ type Settings struct { // "PACKAGE" - The instance is billed at a monthly flat rate. // "PER_USE" - The instance is billed per usage. PricingPlan string `json:"pricingPlan,omitempty"` + // ReadPoolAutoScaleConfig: Optional. The read pool auto-scale configuration + // for the instance. + ReadPoolAutoScaleConfig *ReadPoolAutoScaleConfig `json:"readPoolAutoScaleConfig,omitempty"` // ReplicationLagMaxSeconds: Optional. Configuration value for recreation of // replica after certain replication lag ReplicationLagMaxSeconds int64 `json:"replicationLagMaxSeconds,omitempty"` @@ -5134,6 +5373,9 @@ type SqlExternalSyncSettingError struct { // "WILL_DELETE_EXISTING" - The migration will delete existing data in the // replica; replica_overwrite_enabled was set in the request acknowledging // this. This is a warning rather than an error. MySQL only. + // "PG_DDL_REPLICATION_INSUFFICIENT_PRIVILEGE" - The replication user is + // missing specific privileges to setup DDL replication. (e.g. CREATE EVENT + // TRIGGER, CREATE SCHEMA) for PostgreSQL. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Detail") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -5181,6 +5423,12 @@ func (s SqlInstancesAcquireSsrsLeaseResponse) MarshalJSON() ([]byte, error) { // SqlInstancesExecuteSqlResponse: Execute SQL statements response. type SqlInstancesExecuteSqlResponse struct { + // Messages: A list of notices and warnings generated during query execution. + // For PostgreSQL, this includes all notices and warnings. For MySQL, this + // includes warnings generated by the last executed statement. To retrieve all + // warnings for a multi-statement query, `SHOW WARNINGS` must be executed after + // each statement. + Messages []*Message `json:"messages,omitempty"` // Metadata: The additional metadata information regarding the execution of the // SQL statements. Metadata *Metadata `json:"metadata,omitempty"` @@ -5189,13 +5437,13 @@ type SqlInstancesExecuteSqlResponse struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Metadata") to + // ForceSendFields is a list of field names (e.g. "Messages") 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 + // NullFields is a list of field names (e.g. "Messages") 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. @@ -5863,6 +6111,44 @@ func (s SyncFlags) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// TargetMetric: Target metric for read pool auto scaling. +type TargetMetric struct { + // Metric: The metric name to be used for auto scaling. + Metric string `json:"metric,omitempty"` + // TargetValue: The target value for the metric. + TargetValue float64 `json:"targetValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "Metric") 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. "Metric") 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 TargetMetric) MarshalJSON() ([]byte, error) { + type NoMethod TargetMetric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *TargetMetric) UnmarshalJSON(data []byte) error { + type NoMethod TargetMetric + var s1 struct { + TargetValue gensupport.JSONFloat64 `json:"targetValue"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.TargetValue = float64(s1.TargetValue) + return nil +} + // Tier: A Google Cloud SQL service tier resource. type Tier struct { // DiskQuota: The maximum disk size of this tier in bytes. @@ -5966,6 +6252,19 @@ type User struct { // after insertion. For a MySQL instance, it's required; for a PostgreSQL or // SQL Server instance, it's optional. Host string `json:"host,omitempty"` + // IamStatus: Indicates if a group is active or inactive for IAM database + // authentication. + // + // Possible values: + // "IAM_STATUS_UNSPECIFIED" - The default value for users that are not of + // type CLOUD_IAM_GROUP. Only CLOUD_IAM_GROUP users will be inactive or active. + // Users with an IamStatus of IAM_STATUS_UNSPECIFIED will not display whether + // they are active or inactive as that is not applicable to them. + // "INACTIVE" - INACTIVE indicates a group is not available for IAM database + // authentication. + // "ACTIVE" - ACTIVE indicates a group is available for IAM database + // authentication. + IamStatus string `json:"iamStatus,omitempty"` // Instance: The name of the Cloud SQL instance. This does not include the // project ID. Can be omitted for `update` because it is already specified on // the URL. @@ -10363,6 +10662,113 @@ func (c *InstancesPointInTimeRestoreCall) Do(opts ...googleapi.CallOption) (*Ope return ret, nil } +type InstancesPreCheckMajorVersionUpgradeCall struct { + s *Service + project string + instance string + instancesprecheckmajorversionupgraderequest *InstancesPreCheckMajorVersionUpgradeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// PreCheckMajorVersionUpgrade: Execute MVU Pre-checks +// +// - instance: Cloud SQL instance ID. This does not include the project ID. +// - project: Project ID of the project that contains the instance. +func (r *InstancesService) PreCheckMajorVersionUpgrade(project string, instance string, instancesprecheckmajorversionupgraderequest *InstancesPreCheckMajorVersionUpgradeRequest) *InstancesPreCheckMajorVersionUpgradeCall { + c := &InstancesPreCheckMajorVersionUpgradeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.instance = instance + c.instancesprecheckmajorversionupgraderequest = instancesprecheckmajorversionupgraderequest + 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 *InstancesPreCheckMajorVersionUpgradeCall) Fields(s ...googleapi.Field) *InstancesPreCheckMajorVersionUpgradeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *InstancesPreCheckMajorVersionUpgradeCall) Context(ctx context.Context) *InstancesPreCheckMajorVersionUpgradeCall { + 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 *InstancesPreCheckMajorVersionUpgradeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InstancesPreCheckMajorVersionUpgradeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.instancesprecheckmajorversionupgraderequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "instance": c.instance, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "sql.instances.preCheckMajorVersionUpgrade", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "sql.instances.preCheckMajorVersionUpgrade" 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 *InstancesPreCheckMajorVersionUpgradeCall) 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", "sql.instances.preCheckMajorVersionUpgrade", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type InstancesPromoteReplicaCall struct { s *Service project string @@ -10711,6 +11117,21 @@ func (r *InstancesService) ResetSslConfig(project string, instance string) *Inst return c } +// Mode sets the optional parameter "mode": Reset SSL mode to use. +// +// Possible values: +// +// "RESET_SSL_MODE_UNSPECIFIED" - Reset SSL mode is not specified. +// "ALL" - Refresh all TLS configs. This is the default behaviour. +// "SYNC_FROM_PRIMARY" - Refreshes the replication-related TLS configuration +// +// settings provided by the primary instance. Not applicable to on-premises +// replication instances. +func (c *InstancesResetSslConfigCall) Mode(mode string) *InstancesResetSslConfigCall { + c.urlParams_.Set("mode", mode) + 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 11e6503655b..b3f50426ec8 100644 --- a/sqladmin/v1beta4/sqladmin-api.json +++ b/sqladmin/v1beta4/sqladmin-api.json @@ -17,7 +17,7 @@ "canonicalName": "SQL Admin", "description": "API for Cloud SQL database instance management", "discoveryVersion": "v1", - "documentationLink": "https://developers.google.com/cloud-sql/", + "documentationLink": "https://cloud.google.com/sql/docs", "fullyEncodeReservedExpansion": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", @@ -1445,6 +1445,41 @@ "https://www.googleapis.com/auth/sqlservice.admin" ] }, + "preCheckMajorVersionUpgrade": { + "description": "Execute MVU Pre-checks", + "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade", + "httpMethod": "POST", + "id": "sql.instances.preCheckMajorVersionUpgrade", + "parameterOrder": [ + "project", + "instance" + ], + "parameters": { + "instance": { + "description": "Required. Cloud SQL instance ID. This does not include the project ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Required. Project ID of the project that contains the instance.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "sql/v1beta4/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade", + "request": { + "$ref": "InstancesPreCheckMajorVersionUpgradeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sqlservice.admin" + ] + }, "promoteReplica": { "description": "Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.", "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/promoteReplica", @@ -1565,6 +1600,21 @@ "required": true, "type": "string" }, + "mode": { + "description": "Optional. Reset SSL mode to use.", + "enum": [ + "RESET_SSL_MODE_UNSPECIFIED", + "ALL", + "SYNC_FROM_PRIMARY" + ], + "enumDescriptions": [ + "Reset SSL mode is not specified.", + "Refresh all TLS configs. This is the default behaviour.", + "Refreshes the replication-related TLS configuration settings provided by the primary instance. Not applicable to on-premises replication instances." + ], + "location": "query", + "type": "string" + }, "project": { "description": "Project ID of the project that contains the instance.", "location": "path", @@ -1860,7 +1910,7 @@ "operations": { "methods": { "cancel": { - "description": "Cancels an instance operation that has been performed on an instance.", + "description": "Cancels an instance operation that has been performed on an instance. Ordinarily, this method name should be `CancelSqlOperation`.", "flatPath": "sql/v1beta4/projects/{project}/operations/{operation}/cancel", "httpMethod": "POST", "id": "sql.operations.cancel", @@ -2635,7 +2685,7 @@ } } }, - "revision": "20250823", + "revision": "20250915", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2751,7 +2801,7 @@ "type": "object" }, "Backup": { - "description": "A backup resource. Next ID: 30", + "description": "A backup resource.", "id": "Backup", "properties": { "backupInterval": { @@ -5756,6 +5806,17 @@ }, "type": "object" }, + "InstancesPreCheckMajorVersionUpgradeRequest": { + "description": "Request for Pre-checks for MVU", + "id": "InstancesPreCheckMajorVersionUpgradeRequest", + "properties": { + "preCheckMajorVersionUpgradeContext": { + "$ref": "PreCheckMajorVersionUpgradeContext", + "description": "Required. Contains details about the pre-check major version upgrade operation." + } + }, + "type": "object" + }, "InstancesReencryptRequest": { "description": "Database Instance reencrypt request.", "id": "InstancesReencryptRequest", @@ -6048,6 +6109,21 @@ }, "type": "object" }, + "Message": { + "description": "Represents a notice or warning message from the database.", + "id": "Message", + "properties": { + "message": { + "description": "The full message string. For PostgreSQL, this is a formatted string that may include severity, code, and the notice/warning message. For MySQL, this contains the warning message.", + "type": "string" + }, + "severity": { + "description": "The severity of the message (e.g., \"NOTICE\" for PostgreSQL, \"WARNING\" for MySQL).", + "type": "string" + } + }, + "type": "object" + }, "Metadata": { "description": "The additional metadata information regarding the execution of the SQL statements.", "id": "Metadata", @@ -6405,6 +6481,10 @@ ], "type": "string" }, + "preCheckMajorVersionUpgradeContext": { + "$ref": "PreCheckMajorVersionUpgradeContext", + "description": "The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found)." + }, "selfLink": { "description": "The URI of this resource.", "type": "string" @@ -6742,6 +6822,216 @@ }, "type": "object" }, + "PreCheckMajorVersionUpgradeContext": { + "description": "Pre-check major version upgrade context.", + "id": "PreCheckMajorVersionUpgradeContext", + "properties": { + "kind": { + "description": "Optional. This is always `sql#preCheckMajorVersionUpgradeContext`.", + "type": "string" + }, + "preCheckResponse": { + "description": "Output only. The responses from the precheck operation.", + "items": { + "$ref": "PreCheckResponse" + }, + "readOnly": true, + "type": "array" + }, + "targetDatabaseVersion": { + "description": "Required. The target database version to upgrade to.", + "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_39", + "MYSQL_8_0_40", + "MYSQL_8_0_41", + "MYSQL_8_0_42", + "MYSQL_8_0_43", + "MYSQL_8_0_44", + "MYSQL_8_0_45", + "MYSQL_8_0_46", + "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, + 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 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 major version is MySQL 8.0 and the minor version is 43.", + "The database major version is MySQL 8.0 and the minor version is 44.", + "The database major version is MySQL 8.0 and the minor version is 45.", + "The database major version is MySQL 8.0 and the minor version is 46.", + "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." + ], + "type": "string" + } + }, + "type": "object" + }, + "PreCheckResponse": { + "description": "Structured PreCheckResponse containing message, type, and required actions.", + "id": "PreCheckResponse", + "properties": { + "actionsRequired": { + "description": "The actions that the user needs to take. Use repeated for multiple actions.", + "items": { + "type": "string" + }, + "type": "array" + }, + "message": { + "description": "The message to be displayed to the user.", + "type": "string" + }, + "messageType": { + "description": "The type of message whether it is an info, warning, or error.", + "enum": [ + "MESSAGE_TYPE_UNSPECIFIED", + "INFO", + "WARNING", + "ERROR" + ], + "enumDescriptions": [ + "Default unspecified value to prevent unintended behavior changes.", + "General informational messages that don't require action.", + "Warnings that might impact the upgrade but don't block it.", + "Errors that a user must resolve before proceeding with the upgrade." + ], + "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", @@ -6827,6 +7117,48 @@ }, "type": "object" }, + "ReadPoolAutoScaleConfig": { + "description": "The read pool auto-scale configuration.", + "id": "ReadPoolAutoScaleConfig", + "properties": { + "disableScaleIn": { + "description": "Indicates whether read pool auto scaling supports scale in operations (removing nodes).", + "type": "boolean" + }, + "enabled": { + "description": "Indicates whether read pool auto scaling is enabled.", + "type": "boolean" + }, + "maxNodeCount": { + "description": "Maximum number of read pool nodes to be maintained.", + "format": "int32", + "type": "integer" + }, + "minNodeCount": { + "description": "Minimum number of read pool nodes to be maintained.", + "format": "int32", + "type": "integer" + }, + "scaleInCooldownSeconds": { + "description": "The cooldown period for scale in operations.", + "format": "int32", + "type": "integer" + }, + "scaleOutCooldownSeconds": { + "description": "The cooldown period for scale out operations.", + "format": "int32", + "type": "integer" + }, + "targetMetrics": { + "description": "Optional. Target metrics for read pool auto scaling.", + "items": { + "$ref": "TargetMetric" + }, + "type": "array" + } + }, + "type": "object" + }, "ReplicaConfiguration": { "description": "Read-replica configuration for connecting to the primary instance.", "id": "ReplicaConfiguration", @@ -7194,6 +7526,10 @@ ], "type": "string" }, + "readPoolAutoScaleConfig": { + "$ref": "ReadPoolAutoScaleConfig", + "description": "Optional. The read pool auto-scale configuration for the instance." + }, "replicationLagMaxSeconds": { "description": "Optional. Configuration value for recreation of replica after certain replication lag.", "format": "int32", @@ -7370,7 +7706,8 @@ "PSC_ONLY_INSTANCE_WITH_NO_NETWORK_ATTACHMENT_URI", "SELECTED_OBJECTS_REFERENCE_UNSELECTED_OBJECTS", "PROMPT_DELETE_EXISTING", - "WILL_DELETE_EXISTING" + "WILL_DELETE_EXISTING", + "PG_DDL_REPLICATION_INSUFFICIENT_PRIVILEGE" ], "enumDescriptions": [ "", @@ -7430,7 +7767,8 @@ "PSC only destination instance does not have a network attachment URI.", "Selected objects reference unselected objects. Based on their object type (foreign key constraint or view), selected objects will fail during migration.", "The migration will delete existing data in the replica; set replica_overwrite_enabled in the request to acknowledge this. This is an error. MySQL only.", - "The migration will delete existing data in the replica; replica_overwrite_enabled was set in the request acknowledging this. This is a warning rather than an error. MySQL only." + "The migration will delete existing data in the replica; replica_overwrite_enabled was set in the request acknowledging this. This is a warning rather than an error. MySQL only.", + "The replication user is missing specific privileges to setup DDL replication. (e.g. CREATE EVENT TRIGGER, CREATE SCHEMA) for PostgreSQL." ], "type": "string" } @@ -7452,6 +7790,13 @@ "description": "Execute SQL statements response.", "id": "SqlInstancesExecuteSqlResponse", "properties": { + "messages": { + "description": "A list of notices and warnings generated during query execution. For PostgreSQL, this includes all notices and warnings. For MySQL, this includes warnings generated by the last executed statement. To retrieve all warnings for a multi-statement query, `SHOW WARNINGS` must be executed after each statement.", + "items": { + "$ref": "Message" + }, + "type": "array" + }, "metadata": { "$ref": "Metadata", "description": "The additional metadata information regarding the execution of the SQL statements." @@ -7968,6 +8313,22 @@ }, "type": "object" }, + "TargetMetric": { + "description": "Target metric for read pool auto scaling.", + "id": "TargetMetric", + "properties": { + "metric": { + "description": "The metric name to be used for auto scaling.", + "type": "string" + }, + "targetValue": { + "description": "The target value for the metric.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "Tier": { "description": "A Google Cloud SQL service tier resource.", "id": "Tier", @@ -8061,6 +8422,20 @@ "description": "Optional. The host from which the user can connect. For `insert` operations, host defaults to an empty string. For `update` operations, host is specified as part of the request URL. The host name cannot be updated after insertion. For a MySQL instance, it's required; for a PostgreSQL or SQL Server instance, it's optional.", "type": "string" }, + "iamStatus": { + "description": "Indicates if a group is active or inactive for IAM database authentication.", + "enum": [ + "IAM_STATUS_UNSPECIFIED", + "INACTIVE", + "ACTIVE" + ], + "enumDescriptions": [ + "The default value for users that are not of type CLOUD_IAM_GROUP. Only CLOUD_IAM_GROUP users will be inactive or active. Users with an IamStatus of IAM_STATUS_UNSPECIFIED will not display whether they are active or inactive as that is not applicable to them.", + "INACTIVE indicates a group is not available for IAM database authentication.", + "ACTIVE indicates a group is available for IAM database authentication." + ], + "type": "string" + }, "instance": { "description": "The name of the Cloud SQL instance. This does not include the project ID. Can be omitted for *update* because it is already specified on the URL.", "type": "string" diff --git a/sqladmin/v1beta4/sqladmin-gen.go b/sqladmin/v1beta4/sqladmin-gen.go index 72ed326dba4..a8053081bba 100644 --- a/sqladmin/v1beta4/sqladmin-gen.go +++ b/sqladmin/v1beta4/sqladmin-gen.go @@ -6,7 +6,7 @@ // Package sqladmin provides access to the Cloud SQL Admin API. // -// For product documentation, see: https://developers.google.com/cloud-sql/ +// For product documentation, see: https://cloud.google.com/sql/docs // // # Library status // @@ -454,7 +454,7 @@ func (s AvailableDatabaseVersion) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } -// Backup: A backup resource. Next ID: 30 +// Backup: A backup resource. type Backup struct { // BackupInterval: Output only. This output contains the following values: // start_time: All database writes up to this time are available. end_time: Any @@ -3351,6 +3351,31 @@ func (s InstancesListServerCertificatesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// InstancesPreCheckMajorVersionUpgradeRequest: Request for Pre-checks for MVU +type InstancesPreCheckMajorVersionUpgradeRequest struct { + // PreCheckMajorVersionUpgradeContext: Required. Contains details about the + // pre-check major version upgrade operation. + PreCheckMajorVersionUpgradeContext *PreCheckMajorVersionUpgradeContext `json:"preCheckMajorVersionUpgradeContext,omitempty"` + // ForceSendFields is a list of field names (e.g. + // "PreCheckMajorVersionUpgradeContext") 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. + // "PreCheckMajorVersionUpgradeContext") 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 InstancesPreCheckMajorVersionUpgradeRequest) MarshalJSON() ([]byte, error) { + type NoMethod InstancesPreCheckMajorVersionUpgradeRequest + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // InstancesReencryptRequest: Database Instance reencrypt request. type InstancesReencryptRequest struct { // BackupReencryptionConfig: Configuration specific to backup re-encryption @@ -3783,6 +3808,33 @@ func (s MaintenanceWindow) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// Message: Represents a notice or warning message from the database. +type Message struct { + // Message: The full message string. For PostgreSQL, this is a formatted string + // that may include severity, code, and the notice/warning message. For MySQL, + // this contains the warning message. + Message string `json:"message,omitempty"` + // Severity: The severity of the message (e.g., "NOTICE" for PostgreSQL, + // "WARNING" for MySQL). + Severity string `json:"severity,omitempty"` + // ForceSendFields is a list of field names (e.g. "Message") 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. "Message") 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 Message) MarshalJSON() ([]byte, error) { + type NoMethod Message + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // Metadata: The additional metadata information regarding the execution of the // SQL statements. type Metadata struct { @@ -4052,6 +4104,13 @@ type Operation struct { // in the read pool. // "CREATE_READ_POOL" - Creates a Cloud SQL read pool instance. OperationType string `json:"operationType,omitempty"` + // PreCheckMajorVersionUpgradeContext: The context for pre-check major version + // upgrade operation, if applicable. This field is only populated when the + // operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The + // PreCheckMajorVersionUpgradeContext message itself contains the details for + // that pre-check, such as the target database version for the upgrade and the + // results of the check (including any warnings or errors found). + PreCheckMajorVersionUpgradeContext *PreCheckMajorVersionUpgradeContext `json:"preCheckMajorVersionUpgradeContext,omitempty"` // SelfLink: The URI of this resource. SelfLink string `json:"selfLink,omitempty"` // StartTime: The time this operation actually started in UTC timezone in RFC @@ -4405,6 +4464,149 @@ func (s PoolNodeConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// PreCheckMajorVersionUpgradeContext: Pre-check major version upgrade context. +type PreCheckMajorVersionUpgradeContext struct { + // Kind: Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + Kind string `json:"kind,omitempty"` + // PreCheckResponse: Output only. The responses from the precheck operation. + PreCheckResponse []*PreCheckResponse `json:"preCheckResponse,omitempty"` + // TargetDatabaseVersion: Required. The target database version to upgrade to. + // + // 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_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_0_43" - The database major version is MySQL 8.0 and the minor + // version is 43. + // "MYSQL_8_0_44" - The database major version is MySQL 8.0 and the minor + // version is 44. + // "MYSQL_8_0_45" - The database major version is MySQL 8.0 and the minor + // version is 45. + // "MYSQL_8_0_46" - The database major version is MySQL 8.0 and the minor + // version is 46. + // "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. + TargetDatabaseVersion string `json:"targetDatabaseVersion,omitempty"` + // ForceSendFields is a list of field names (e.g. "Kind") 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. "Kind") 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 PreCheckMajorVersionUpgradeContext) MarshalJSON() ([]byte, error) { + type NoMethod PreCheckMajorVersionUpgradeContext + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +// PreCheckResponse: Structured PreCheckResponse containing message, type, and +// required actions. +type PreCheckResponse struct { + // ActionsRequired: The actions that the user needs to take. Use repeated for + // multiple actions. + ActionsRequired []string `json:"actionsRequired,omitempty"` + // Message: The message to be displayed to the user. + Message string `json:"message,omitempty"` + // MessageType: The type of message whether it is an info, warning, or error. + // + // Possible values: + // "MESSAGE_TYPE_UNSPECIFIED" - Default unspecified value to prevent + // unintended behavior changes. + // "INFO" - General informational messages that don't require action. + // "WARNING" - Warnings that might impact the upgrade but don't block it. + // "ERROR" - Errors that a user must resolve before proceeding with the + // upgrade. + MessageType string `json:"messageType,omitempty"` + // ForceSendFields is a list of field names (e.g. "ActionsRequired") 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. "ActionsRequired") 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 PreCheckResponse) MarshalJSON() ([]byte, error) { + type NoMethod PreCheckResponse + 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 { @@ -4510,6 +4712,41 @@ func (s QueryResult) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// ReadPoolAutoScaleConfig: The read pool auto-scale configuration. +type ReadPoolAutoScaleConfig struct { + // DisableScaleIn: Indicates whether read pool auto scaling supports scale in + // operations (removing nodes). + DisableScaleIn bool `json:"disableScaleIn,omitempty"` + // Enabled: Indicates whether read pool auto scaling is enabled. + Enabled bool `json:"enabled,omitempty"` + // MaxNodeCount: Maximum number of read pool nodes to be maintained. + MaxNodeCount int64 `json:"maxNodeCount,omitempty"` + // MinNodeCount: Minimum number of read pool nodes to be maintained. + MinNodeCount int64 `json:"minNodeCount,omitempty"` + // ScaleInCooldownSeconds: The cooldown period for scale in operations. + ScaleInCooldownSeconds int64 `json:"scaleInCooldownSeconds,omitempty"` + // ScaleOutCooldownSeconds: The cooldown period for scale out operations. + ScaleOutCooldownSeconds int64 `json:"scaleOutCooldownSeconds,omitempty"` + // TargetMetrics: Optional. Target metrics for read pool auto scaling. + TargetMetrics []*TargetMetric `json:"targetMetrics,omitempty"` + // ForceSendFields is a list of field names (e.g. "DisableScaleIn") 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. "DisableScaleIn") 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 ReadPoolAutoScaleConfig) MarshalJSON() ([]byte, error) { + type NoMethod ReadPoolAutoScaleConfig + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + // ReplicaConfiguration: Read-replica configuration for connecting to the // primary instance. type ReplicaConfiguration struct { @@ -4900,6 +5137,9 @@ type Settings struct { // "PACKAGE" - The instance is billed at a monthly flat rate. // "PER_USE" - The instance is billed per usage. PricingPlan string `json:"pricingPlan,omitempty"` + // ReadPoolAutoScaleConfig: Optional. The read pool auto-scale configuration + // for the instance. + ReadPoolAutoScaleConfig *ReadPoolAutoScaleConfig `json:"readPoolAutoScaleConfig,omitempty"` // ReplicationLagMaxSeconds: Optional. Configuration value for recreation of // replica after certain replication lag. ReplicationLagMaxSeconds int64 `json:"replicationLagMaxSeconds,omitempty"` @@ -5140,6 +5380,9 @@ type SqlExternalSyncSettingError struct { // "WILL_DELETE_EXISTING" - The migration will delete existing data in the // replica; replica_overwrite_enabled was set in the request acknowledging // this. This is a warning rather than an error. MySQL only. + // "PG_DDL_REPLICATION_INSUFFICIENT_PRIVILEGE" - The replication user is + // missing specific privileges to setup DDL replication. (e.g. CREATE EVENT + // TRIGGER, CREATE SCHEMA) for PostgreSQL. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Detail") to unconditionally // include in API requests. By default, fields with empty or default values are @@ -5186,6 +5429,12 @@ func (s SqlInstancesAcquireSsrsLeaseResponse) MarshalJSON() ([]byte, error) { // SqlInstancesExecuteSqlResponse: Execute SQL statements response. type SqlInstancesExecuteSqlResponse struct { + // Messages: A list of notices and warnings generated during query execution. + // For PostgreSQL, this includes all notices and warnings. For MySQL, this + // includes warnings generated by the last executed statement. To retrieve all + // warnings for a multi-statement query, `SHOW WARNINGS` must be executed after + // each statement. + Messages []*Message `json:"messages,omitempty"` // Metadata: The additional metadata information regarding the execution of the // SQL statements. Metadata *Metadata `json:"metadata,omitempty"` @@ -5194,13 +5443,13 @@ type SqlInstancesExecuteSqlResponse struct { // ServerResponse contains the HTTP response code and headers from the server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Metadata") to + // ForceSendFields is a list of field names (e.g. "Messages") 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 + // NullFields is a list of field names (e.g. "Messages") 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. @@ -5865,6 +6114,44 @@ func (s SyncFlags) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// TargetMetric: Target metric for read pool auto scaling. +type TargetMetric struct { + // Metric: The metric name to be used for auto scaling. + Metric string `json:"metric,omitempty"` + // TargetValue: The target value for the metric. + TargetValue float64 `json:"targetValue,omitempty"` + // ForceSendFields is a list of field names (e.g. "Metric") 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. "Metric") 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 TargetMetric) MarshalJSON() ([]byte, error) { + type NoMethod TargetMetric + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *TargetMetric) UnmarshalJSON(data []byte) error { + type NoMethod TargetMetric + var s1 struct { + TargetValue gensupport.JSONFloat64 `json:"targetValue"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.TargetValue = float64(s1.TargetValue) + return nil +} + // Tier: A Google Cloud SQL service tier resource. type Tier struct { // DiskQuota: The maximum disk size of this tier in bytes. @@ -5968,6 +6255,19 @@ type User struct { // after insertion. For a MySQL instance, it's required; for a PostgreSQL or // SQL Server instance, it's optional. Host string `json:"host,omitempty"` + // IamStatus: Indicates if a group is active or inactive for IAM database + // authentication. + // + // Possible values: + // "IAM_STATUS_UNSPECIFIED" - The default value for users that are not of + // type CLOUD_IAM_GROUP. Only CLOUD_IAM_GROUP users will be inactive or active. + // Users with an IamStatus of IAM_STATUS_UNSPECIFIED will not display whether + // they are active or inactive as that is not applicable to them. + // "INACTIVE" - INACTIVE indicates a group is not available for IAM database + // authentication. + // "ACTIVE" - ACTIVE indicates a group is available for IAM database + // authentication. + IamStatus string `json:"iamStatus,omitempty"` // Instance: The name of the Cloud SQL instance. This does not include the // project ID. Can be omitted for *update* because it is already specified on // the URL. @@ -10365,6 +10665,113 @@ func (c *InstancesPointInTimeRestoreCall) Do(opts ...googleapi.CallOption) (*Ope return ret, nil } +type InstancesPreCheckMajorVersionUpgradeCall struct { + s *Service + project string + instance string + instancesprecheckmajorversionupgraderequest *InstancesPreCheckMajorVersionUpgradeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// PreCheckMajorVersionUpgrade: Execute MVU Pre-checks +// +// - instance: Cloud SQL instance ID. This does not include the project ID. +// - project: Project ID of the project that contains the instance. +func (r *InstancesService) PreCheckMajorVersionUpgrade(project string, instance string, instancesprecheckmajorversionupgraderequest *InstancesPreCheckMajorVersionUpgradeRequest) *InstancesPreCheckMajorVersionUpgradeCall { + c := &InstancesPreCheckMajorVersionUpgradeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.project = project + c.instance = instance + c.instancesprecheckmajorversionupgraderequest = instancesprecheckmajorversionupgraderequest + 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 *InstancesPreCheckMajorVersionUpgradeCall) Fields(s ...googleapi.Field) *InstancesPreCheckMajorVersionUpgradeCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. +func (c *InstancesPreCheckMajorVersionUpgradeCall) Context(ctx context.Context) *InstancesPreCheckMajorVersionUpgradeCall { + 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 *InstancesPreCheckMajorVersionUpgradeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *InstancesPreCheckMajorVersionUpgradeCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := gensupport.SetHeaders(c.s.userAgent(), "application/json", c.header_) + body, err := googleapi.WithoutDataWrapper.JSONBuffer(c.instancesprecheckmajorversionupgraderequest) + if err != nil { + return nil, err + } + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "sql/v1beta4/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "project": c.project, + "instance": c.instance, + }) + c.s.logger.DebugContext(c.ctx_, "api request", "serviceName", apiName, "rpcName", "sql.instances.preCheckMajorVersionUpgrade", "request", internallog.HTTPRequest(req, body.Bytes())) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "sql.instances.preCheckMajorVersionUpgrade" 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 *InstancesPreCheckMajorVersionUpgradeCall) 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", "sql.instances.preCheckMajorVersionUpgrade", "response", internallog.HTTPResponse(res, b)) + return ret, nil +} + type InstancesPromoteReplicaCall struct { s *Service project string @@ -10714,6 +11121,21 @@ func (r *InstancesService) ResetSslConfig(project string, instance string) *Inst return c } +// Mode sets the optional parameter "mode": Reset SSL mode to use. +// +// Possible values: +// +// "RESET_SSL_MODE_UNSPECIFIED" - Reset SSL mode is not specified. +// "ALL" - Refresh all TLS configs. This is the default behaviour. +// "SYNC_FROM_PRIMARY" - Refreshes the replication-related TLS configuration +// +// settings provided by the primary instance. Not applicable to on-premises +// replication instances. +func (c *InstancesResetSslConfigCall) Mode(mode string) *InstancesResetSslConfigCall { + c.urlParams_.Set("mode", mode) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more // details. @@ -11654,7 +12076,7 @@ type OperationsCancelCall struct { } // Cancel: Cancels an instance operation that has been performed on an -// instance. +// instance. Ordinarily, this method name should be `CancelSqlOperation`. // // - operation: Instance operation ID. // - project: Project ID of the project that contains the instance. diff --git a/storagebatchoperations/v1/storagebatchoperations-api.json b/storagebatchoperations/v1/storagebatchoperations-api.json index 5ec58e95e62..053524e29d6 100644 --- a/storagebatchoperations/v1/storagebatchoperations-api.json +++ b/storagebatchoperations/v1/storagebatchoperations-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -482,7 +482,7 @@ } } }, - "revision": "20250813", + "revision": "20250910", "rootUrl": "https://storagebatchoperations.googleapis.com/", "schemas": { "Bucket": { diff --git a/storagebatchoperations/v1/storagebatchoperations-gen.go b/storagebatchoperations/v1/storagebatchoperations-gen.go index 9dbb6249199..acd10734763 100644 --- a/storagebatchoperations/v1/storagebatchoperations-gen.go +++ b/storagebatchoperations/v1/storagebatchoperations-gen.go @@ -1138,9 +1138,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/texttospeech/v1/texttospeech-api.json b/texttospeech/v1/texttospeech-api.json index 278fd577d16..b724243e548 100644 --- a/texttospeech/v1/texttospeech-api.json +++ b/texttospeech/v1/texttospeech-api.json @@ -318,7 +318,7 @@ } } }, - "revision": "20250903", + "revision": "20250912", "rootUrl": "https://texttospeech.googleapis.com/", "schemas": { "AdvancedVoiceOptions": { @@ -623,7 +623,7 @@ "description": "The multi-speaker input to be synthesized. Only applicable for multi-speaker synthesis." }, "prompt": { - "description": "This is system instruction supported only for controllable voice models. If used, we will pass text to Flash TTS as is. Can only used with Flash TTS. What AI Studio calls Style Instructions.", + "description": "This system instruction is supported only for controllable/promptable voice models. If this system instruction is used, we pass the unedited text to Gemini-TTS. Otherwise, a default system instruction is used. AI Studio calls this system instruction, Style Instructions.", "type": "string" }, "ssml": { diff --git a/texttospeech/v1/texttospeech-gen.go b/texttospeech/v1/texttospeech-gen.go index 946fe57b489..e5d6e96b711 100644 --- a/texttospeech/v1/texttospeech-gen.go +++ b/texttospeech/v1/texttospeech-gen.go @@ -676,9 +676,11 @@ type SynthesisInput struct { // MultiSpeakerMarkup: The multi-speaker input to be synthesized. Only // applicable for multi-speaker synthesis. MultiSpeakerMarkup *MultiSpeakerMarkup `json:"multiSpeakerMarkup,omitempty"` - // Prompt: This is system instruction supported only for controllable voice - // models. If used, we will pass text to Flash TTS as is. Can only used with - // Flash TTS. What AI Studio calls Style Instructions. + // Prompt: This system instruction is supported only for + // controllable/promptable voice models. If this system instruction is used, we + // pass the unedited text to Gemini-TTS. Otherwise, a default system + // instruction is used. AI Studio calls this system instruction, Style + // Instructions. Prompt string `json:"prompt,omitempty"` // Ssml: The SSML document to be synthesized. The SSML document must be valid // and well-formed. Otherwise the RPC will fail and return diff --git a/texttospeech/v1beta1/texttospeech-api.json b/texttospeech/v1beta1/texttospeech-api.json index ca2e9545e79..43891d89ca5 100644 --- a/texttospeech/v1beta1/texttospeech-api.json +++ b/texttospeech/v1beta1/texttospeech-api.json @@ -261,7 +261,7 @@ } } }, - "revision": "20250903", + "revision": "20250912", "rootUrl": "https://texttospeech.googleapis.com/", "schemas": { "AdvancedVoiceOptions": { @@ -556,7 +556,7 @@ "description": "The multi-speaker input to be synthesized. Only applicable for multi-speaker synthesis." }, "prompt": { - "description": "This is system instruction supported only for controllable voice models. If used, we will pass text to Flash TTS as is. Can only used with Flash TTS. What AI Studio calls Style Instructions.", + "description": "This system instruction is supported only for controllable/promptable voice models. If this system instruction is used, we pass the unedited text to Gemini-TTS. Otherwise, a default system instruction is used. AI Studio calls this system instruction, Style Instructions.", "type": "string" }, "ssml": { diff --git a/texttospeech/v1beta1/texttospeech-gen.go b/texttospeech/v1beta1/texttospeech-gen.go index 0fa626ce766..f2cef31a3ae 100644 --- a/texttospeech/v1beta1/texttospeech-gen.go +++ b/texttospeech/v1beta1/texttospeech-gen.go @@ -652,9 +652,11 @@ type SynthesisInput struct { // MultiSpeakerMarkup: The multi-speaker input to be synthesized. Only // applicable for multi-speaker synthesis. MultiSpeakerMarkup *MultiSpeakerMarkup `json:"multiSpeakerMarkup,omitempty"` - // Prompt: This is system instruction supported only for controllable voice - // models. If used, we will pass text to Flash TTS as is. Can only used with - // Flash TTS. What AI Studio calls Style Instructions. + // Prompt: This system instruction is supported only for + // controllable/promptable voice models. If this system instruction is used, we + // pass the unedited text to Gemini-TTS. Otherwise, a default system + // instruction is used. AI Studio calls this system instruction, Style + // Instructions. Prompt string `json:"prompt,omitempty"` // Ssml: The SSML document to be synthesized. The SSML document must be valid // and well-formed. Otherwise the RPC will fail and return diff --git a/vpcaccess/v1/vpcaccess-api.json b/vpcaccess/v1/vpcaccess-api.json index 9c989ed5a55..e7fabfdd5f3 100644 --- a/vpcaccess/v1/vpcaccess-api.json +++ b/vpcaccess/v1/vpcaccess-api.json @@ -119,7 +119,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -390,7 +390,7 @@ } } }, - "revision": "20250817", + "revision": "20250916", "rootUrl": "https://vpcaccess.googleapis.com/", "schemas": { "Connector": { diff --git a/vpcaccess/v1/vpcaccess-gen.go b/vpcaccess/v1/vpcaccess-gen.go index 62f03642e19..b105cf39678 100644 --- a/vpcaccess/v1/vpcaccess-gen.go +++ b/vpcaccess/v1/vpcaccess-gen.go @@ -603,9 +603,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/vpcaccess/v1beta1/vpcaccess-api.json b/vpcaccess/v1beta1/vpcaccess-api.json index 2ced83e8a59..4b7533022d0 100644 --- a/vpcaccess/v1beta1/vpcaccess-api.json +++ b/vpcaccess/v1beta1/vpcaccess-api.json @@ -119,7 +119,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -390,7 +390,7 @@ } } }, - "revision": "20250817", + "revision": "20250916", "rootUrl": "https://vpcaccess.googleapis.com/", "schemas": { "Connector": { diff --git a/vpcaccess/v1beta1/vpcaccess-gen.go b/vpcaccess/v1beta1/vpcaccess-gen.go index 55b2065fae0..81b7b0bd103 100644 --- a/vpcaccess/v1beta1/vpcaccess-gen.go +++ b/vpcaccess/v1beta1/vpcaccess-gen.go @@ -607,9 +607,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/webfonts/v1/webfonts-api.json b/webfonts/v1/webfonts-api.json index daa3cec7d0f..7f9b1de7749 100644 --- a/webfonts/v1/webfonts-api.json +++ b/webfonts/v1/webfonts-api.json @@ -109,12 +109,14 @@ "enum": [ "CAPABILITY_UNSPECIFIED", "WOFF2", - "VF" + "VF", + "FAMILY_TAGS" ], "enumDescriptions": [ "Default means static ttf fonts.", "Use WOFF2(Compressed)instead of ttf.", - "Prefer variable font files instead of static fonts instantiated at standard weights." + "Prefer variable font files instead of static fonts instantiated at standard weights.", + "Include tags that apply to the entire family in the response." ], "location": "query", "repeated": true, @@ -166,7 +168,7 @@ } } }, - "revision": "20250121", + "revision": "20250917", "rootUrl": "https://webfonts.googleapis.com/", "schemas": { "Axis": { @@ -190,6 +192,22 @@ }, "type": "object" }, + "Tag": { + "description": "Metadata for a tag.", + "id": "Tag", + "properties": { + "name": { + "description": "The name of the tag.", + "type": "string" + }, + "weight": { + "description": "The weight of the tag.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "Webfont": { "description": "Metadata describing a family of fonts.", "id": "Webfont", @@ -242,6 +260,13 @@ }, "type": "array" }, + "tags": { + "description": "The tags that apply to this family.", + "items": { + "$ref": "Tag" + }, + "type": "array" + }, "variants": { "description": "The available variants for the font.", "items": { diff --git a/webfonts/v1/webfonts-gen.go b/webfonts/v1/webfonts-gen.go index 3e0d16f591b..3c52b413532 100644 --- a/webfonts/v1/webfonts-gen.go +++ b/webfonts/v1/webfonts-gen.go @@ -193,6 +193,44 @@ func (s *Axis) UnmarshalJSON(data []byte) error { return nil } +// Tag: Metadata for a tag. +type Tag struct { + // Name: The name of the tag. + Name string `json:"name,omitempty"` + // Weight: The weight of the tag. + Weight float64 `json:"weight,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 Tag) MarshalJSON() ([]byte, error) { + type NoMethod Tag + return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) +} + +func (s *Tag) UnmarshalJSON(data []byte) error { + type NoMethod Tag + var s1 struct { + Weight gensupport.JSONFloat64 `json:"weight"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Weight = float64(s1.Weight) + return nil +} + // Webfont: Metadata describing a family of fonts. type Webfont struct { // Axes: Axis for variable fonts. @@ -216,6 +254,8 @@ type Webfont struct { Menu string `json:"menu,omitempty"` // Subsets: The scripts supported by the font. Subsets []string `json:"subsets,omitempty"` + // Tags: The tags that apply to this family. + Tags []*Tag `json:"tags,omitempty"` // Variants: The available variants for the font. Variants []string `json:"variants,omitempty"` // Version: The font version. @@ -292,6 +332,10 @@ func (r *WebfontsService) List() *WebfontsListCall { // "VF" - Prefer variable font files instead of static fonts instantiated at // // standard weights. +// +// "FAMILY_TAGS" - Include tags that apply to the entire family in the +// +// response. func (c *WebfontsListCall) Capability(capability ...string) *WebfontsListCall { c.urlParams_.SetMulti("capability", append([]string{}, capability...)) return c diff --git a/workflows/v1beta/workflows-api.json b/workflows/v1beta/workflows-api.json index c7330fadbf7..5ef8a6c5e4d 100644 --- a/workflows/v1beta/workflows-api.json +++ b/workflows/v1beta/workflows-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -450,7 +450,7 @@ } } }, - "revision": "20250814", + "revision": "20250916", "rootUrl": "https://workflows.googleapis.com/", "schemas": { "Empty": { diff --git a/workflows/v1beta/workflows-gen.go b/workflows/v1beta/workflows-gen.go index 82db551cb6a..62ce49ad04a 100644 --- a/workflows/v1beta/workflows-gen.go +++ b/workflows/v1beta/workflows-gen.go @@ -636,9 +636,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c diff --git a/workloadmanager/v1/workloadmanager-api.json b/workloadmanager/v1/workloadmanager-api.json index 2d0ee04fe73..5bd1199f9ae 100644 --- a/workloadmanager/v1/workloadmanager-api.json +++ b/workloadmanager/v1/workloadmanager-api.json @@ -879,7 +879,7 @@ } } }, - "revision": "20250903", + "revision": "20250910", "rootUrl": "https://workloadmanager.googleapis.com/", "schemas": { "AgentCommand": { @@ -1690,6 +1690,10 @@ "description": "Optional. The instance id where the insight is generated from", "type": "string" }, + "openShiftValidation": { + "$ref": "OpenShiftValidation", + "description": "The insights data for the OpenShift workload validation." + }, "sapDiscovery": { "$ref": "SapDiscovery", "description": "The insights data for SAP system discovery. This is a copy of SAP System proto and should get updated whenever that one changes." @@ -1978,6 +1982,12 @@ }, "type": "object" }, + "OpenShiftValidation": { + "description": "A presentation of OpenShift workload insight. The schema of OpenShift workloads validation related data.", + "id": "OpenShiftValidation", + "properties": {}, + "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/workloadmanager/v1/workloadmanager-gen.go b/workloadmanager/v1/workloadmanager-gen.go index c8d665fcf1e..c07659c6ef6 100644 --- a/workloadmanager/v1/workloadmanager-gen.go +++ b/workloadmanager/v1/workloadmanager-gen.go @@ -997,6 +997,9 @@ type Insight struct { AgentStatus *AgentStatus `json:"agentStatus,omitempty"` // InstanceId: Optional. The instance id where the insight is generated from InstanceId string `json:"instanceId,omitempty"` + // OpenShiftValidation: The insights data for the OpenShift workload + // validation. + OpenShiftValidation *OpenShiftValidation `json:"openShiftValidation,omitempty"` // SapDiscovery: The insights data for SAP system discovery. This is a copy of // SAP System proto and should get updated whenever that one changes. SapDiscovery *SapDiscovery `json:"sapDiscovery,omitempty"` @@ -1359,6 +1362,11 @@ func (s Notice) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(s), s.ForceSendFields, s.NullFields) } +// OpenShiftValidation: A presentation of OpenShift workload insight. The +// schema of OpenShift workloads validation related data. +type OpenShiftValidation struct { +} + // Operation: This resource represents a long-running operation that is the // result of a network API call. type Operation struct { diff --git a/workspaceevents/v1/workspaceevents-api.json b/workspaceevents/v1/workspaceevents-api.json index 6efe3ae72d4..caefa50f73b 100644 --- a/workspaceevents/v1/workspaceevents-api.json +++ b/workspaceevents/v1/workspaceevents-api.json @@ -203,7 +203,7 @@ "subscriptions": { "methods": { "create": { - "description": "Creates a Google Workspace subscription. To learn how to use this method, see [Create a Google Workspace subscription](https://developers.google.com/workspace/events/guides/create-subscription). ", + "description": "Creates a Google Workspace subscription. To learn how to use this method, see [Create a Google Workspace subscription](https://developers.google.com/workspace/events/guides/create-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can create a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` and getting one-time administrator approval ([Developer Preview](https://developers.google.com/workspace/preview)). To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "flatPath": "v1/subscriptions", "httpMethod": "POST", "id": "workspaceevents.subscriptions.create", @@ -385,7 +385,7 @@ ] }, "patch": { - "description": "Updates or renews a Google Workspace subscription. To learn how to use this method, see [Update or renew a Google Workspace subscription](https://developers.google.com/workspace/events/guides/update-subscription).", + "description": "Updates or renews a Google Workspace subscription. To learn how to use this method, see [Update or renew a Google Workspace subscription](https://developers.google.com/workspace/events/guides/update-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can update a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` andgetting one-time administrator approval ([Developer Preview](https://developers.google.com/workspace/preview)). To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "flatPath": "v1/subscriptions/{subscriptionsId}", "httpMethod": "PATCH", "id": "workspaceevents.subscriptions.patch", @@ -440,7 +440,7 @@ ] }, "reactivate": { - "description": "Reactivates a suspended Google Workspace subscription. This method resets your subscription's `State` field to `ACTIVE`. Before you use this method, you must fix the error that suspended the subscription. This method will ignore or reject any subscription that isn't currently in a suspended state. To learn how to use this method, see [Reactivate a Google Workspace subscription](https://developers.google.com/workspace/events/guides/reactivate-subscription).", + "description": "Reactivates a suspended Google Workspace subscription. This method resets your subscription's `State` field to `ACTIVE`. Before you use this method, you must fix the error that suspended the subscription. This method will ignore or reject any subscription that isn't currently in a suspended state. To learn how to use this method, see [Reactivate a Google Workspace subscription](https://developers.google.com/workspace/events/guides/reactivate-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can reactivate a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` andgetting one-time administrator approval ([Developer Preview](https://developers.google.com/workspace/preview)). To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).", "flatPath": "v1/subscriptions/{subscriptionsId}:reactivate", "httpMethod": "POST", "id": "workspaceevents.subscriptions.reactivate", @@ -486,7 +486,7 @@ } } }, - "revision": "20250708", + "revision": "20250921", "rootUrl": "https://workspaceevents.googleapis.com/", "schemas": { "ListSubscriptionsResponse": { @@ -607,7 +607,7 @@ "id": "Subscription", "properties": { "authority": { - "description": "Output only. The user who authorized the creation of the subscription. Format: `users/{user}` For Google Workspace users, the `{user}` value is the [`user.id`](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users#User.FIELDS.ids) field from the Directory API.", + "description": "Output only. The user who authorized the creation of the subscription. When a user authorizes the subscription, this field and the `user_authority` field have the same value and the format is: Format: `users/{user}` For Google Workspace users, the `{user}` value is the [`user.id`](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users#User.FIELDS.ids) field from the Directory API. When a Chat app authorizes the subscription, only `service_account_authority` field populates and this field is empty.", "readOnly": true, "type": "string" }, diff --git a/workspaceevents/v1/workspaceevents-gen.go b/workspaceevents/v1/workspaceevents-gen.go index 94efd6ffaed..7f9a05a32b5 100644 --- a/workspaceevents/v1/workspaceevents-gen.go +++ b/workspaceevents/v1/workspaceevents-gen.go @@ -444,10 +444,13 @@ func (s Status) MarshalJSON() ([]byte, error) { // API overview (https://developers.google.com/workspace/events). type Subscription struct { // Authority: Output only. The user who authorized the creation of the - // subscription. Format: `users/{user}` For Google Workspace users, the - // `{user}` value is the `user.id` + // subscription. When a user authorizes the subscription, this field and the + // `user_authority` field have the same value and the format is: Format: + // `users/{user}` For Google Workspace users, the `{user}` value is the + // `user.id` // (https://developers.google.com/admin-sdk/directory/reference/rest/v1/users#User.FIELDS.ids) - // field from the Directory API. + // field from the Directory API. When a Chat app authorizes the subscription, + // only `service_account_authority` field populates and this field is empty. Authority string `json:"authority,omitempty"` // CreateTime: Output only. The time when the subscription is created. CreateTime string `json:"createTime,omitempty"` @@ -678,6 +681,16 @@ type SubscriptionsCreateCall struct { // Create: Creates a Google Workspace subscription. To learn how to use this // method, see Create a Google Workspace subscription // (https://developers.google.com/workspace/events/guides/create-subscription). +// For a subscription on a Chat target resource +// (https://developers.google.com/workspace/events/guides/events-chat), you can +// create a subscription as: - A Chat app by specifying an authorization scope +// that begins with `chat.app` and getting one-time administrator approval +// (Developer Preview (https://developers.google.com/workspace/preview)). To +// learn more, see Authorize as a Chat app with administrator approval +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). +// - A user by specifying an authorization scope that doesn't include `app` in +// its name. To learn more, see Authorize as a Chat user +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). func (r *SubscriptionsService) Create(subscription *Subscription) *SubscriptionsCreateCall { c := &SubscriptionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.subscription = subscription @@ -1185,6 +1198,16 @@ type SubscriptionsPatchCall struct { // Patch: Updates or renews a Google Workspace subscription. To learn how to // use this method, see Update or renew a Google Workspace subscription // (https://developers.google.com/workspace/events/guides/update-subscription). +// For a subscription on a Chat target resource +// (https://developers.google.com/workspace/events/guides/events-chat), you can +// update a subscription as: - A Chat app by specifying an authorization scope +// that begins with `chat.app` andgetting one-time administrator approval +// (Developer Preview (https://developers.google.com/workspace/preview)). To +// learn more, see Authorize as a Chat app with administrator approval +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). +// - A user by specifying an authorization scope that doesn't include `app` in +// its name. To learn more, see Authorize as a Chat user +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). // // - name: Identifier. Resource name of the subscription. Format: // `subscriptions/{subscription}`. @@ -1314,6 +1337,16 @@ type SubscriptionsReactivateCall struct { // suspended state. To learn how to use this method, see Reactivate a Google // Workspace subscription // (https://developers.google.com/workspace/events/guides/reactivate-subscription). +// For a subscription on a Chat target resource +// (https://developers.google.com/workspace/events/guides/events-chat), you can +// reactivate a subscription as: - A Chat app by specifying an authorization +// scope that begins with `chat.app` andgetting one-time administrator approval +// (Developer Preview (https://developers.google.com/workspace/preview)). To +// learn more, see Authorize as a Chat app with administrator approval +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). +// - A user by specifying an authorization scope that doesn't include `app` in +// its name. To learn more, see Authorize as a Chat user +// (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). // // - name: Resource name of the subscription. Format: // `subscriptions/{subscription}`. diff --git a/workstations/v1/workstations-api.json b/workstations/v1/workstations-api.json index 2a99b3608b2..156718e24bd 100644 --- a/workstations/v1/workstations-api.json +++ b/workstations/v1/workstations-api.json @@ -144,7 +144,7 @@ ], "parameters": { "extraLocationTypes": { - "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", + "description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.", "location": "query", "repeated": true, "type": "string" @@ -1216,7 +1216,7 @@ } } }, - "revision": "20250814", + "revision": "20250915", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { diff --git a/workstations/v1/workstations-gen.go b/workstations/v1/workstations-gen.go index 56b587732a1..59dade94054 100644 --- a/workstations/v1/workstations-gen.go +++ b/workstations/v1/workstations-gen.go @@ -2262,9 +2262,9 @@ func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall return c } -// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Do not -// use this field. It is unsupported and is ignored unless explicitly -// documented otherwise. This is primarily for internal usage. +// ExtraLocationTypes sets the optional parameter "extraLocationTypes": Unless +// explicitly documented otherwise, don't use this unsupported field which is +// primarily intended for internal usage. func (c *ProjectsLocationsListCall) ExtraLocationTypes(extraLocationTypes ...string) *ProjectsLocationsListCall { c.urlParams_.SetMulti("extraLocationTypes", append([]string{}, extraLocationTypes...)) return c