diff --git a/discovery/admob-v1.json b/discovery/admob-v1.json index 6ba6518926..35eea48a94 100644 --- a/discovery/admob-v1.json +++ b/discovery/admob-v1.json @@ -321,7 +321,7 @@ } } }, - "revision": "20260610", + "revision": "20261008", "rootUrl": "https://admob.googleapis.com/", "schemas": { "AdUnit": { @@ -674,7 +674,8 @@ "IMPRESSION_CTR", "MATCHED_REQUESTS", "MATCH_RATE", - "OBSERVED_ECPM" + "OBSERVED_ECPM", + "AD_LOAD_LATENCY" ], "enumDescriptions": [ "Default value for an unset field. Do not use.", @@ -685,7 +686,8 @@ "The ratio of clicks over impressions. The value is a double precision (approximate) decimal value.", "The number of times ads are returned in response to a request. The value is an integer.", "The ratio of matched ad requests over the total ad requests. The value is a double precision (approximate) decimal value.", - "The third-party ad network's estimated average eCPM. The currency unit (USD, EUR, or other) of the earning metrics are determined by the localization setting for currency. The amount is in micros. For example, $2.30 would be represented as 2300000. The estimated average eCPM per mediation group and per ad source instance level is supported dating back to October 20, 2019. Third-party estimated average eCPM will show 0 for dates prior to October 20, 2019." + "The third-party ad network's estimated average eCPM. The currency unit (USD, EUR, or other) of the earning metrics are determined by the localization setting for currency. The amount is in micros. For example, $2.30 would be represented as 2300000. The estimated average eCPM per mediation group and per ad source instance level is supported dating back to October 20, 2019. Third-party estimated average eCPM will show 0 for dates prior to October 20, 2019.", + "The ad load latency is the total time it takes for an ad to load measured in seconds. It starts when the ad is requested and ends when a response is received. See https://support.google.com/admob/answer/12571120 for additional information." ], "type": "string" }, @@ -811,7 +813,8 @@ "IMPRESSION_CTR", "MATCHED_REQUESTS", "MATCH_RATE", - "OBSERVED_ECPM" + "OBSERVED_ECPM", + "AD_LOAD_LATENCY" ], "enumDescriptions": [ "Default value for an unset field. Do not use.", @@ -822,7 +825,8 @@ "The ratio of clicks over impressions. The value is a double precision (approximate) decimal value.", "The number of times ads are returned in response to a request. The value is an integer.", "The ratio of matched ad requests over the total ad requests. The value is a double precision (approximate) decimal value.", - "The third-party ad network's estimated average eCPM. The currency unit (USD, EUR, or other) of the earning metrics are determined by the localization setting for currency. The amount is in micros. For example, $2.30 would be represented as 2300000. The estimated average eCPM per mediation group and per ad source instance level is supported dating back to October 20, 2019. Third-party estimated average eCPM will show 0 for dates prior to October 20, 2019." + "The third-party ad network's estimated average eCPM. The currency unit (USD, EUR, or other) of the earning metrics are determined by the localization setting for currency. The amount is in micros. For example, $2.30 would be represented as 2300000. The estimated average eCPM per mediation group and per ad source instance level is supported dating back to October 20, 2019. Third-party estimated average eCPM will show 0 for dates prior to October 20, 2019.", + "The ad load latency is the total time it takes for an ad to load measured in seconds. It starts when the ad is requested and ends when a response is received. See https://support.google.com/admob/answer/12571120 for additional information." ], "type": "string" }, diff --git a/discovery/admob-v1beta.json b/discovery/admob-v1beta.json index 4bdcdbf5b7..02e39281f3 100644 --- a/discovery/admob-v1beta.json +++ b/discovery/admob-v1beta.json @@ -758,7 +758,7 @@ } } }, - "revision": "20260610", + "revision": "20261008", "rootUrl": "https://admob.googleapis.com/", "schemas": { "AdSource": { @@ -1789,7 +1789,8 @@ "IMPRESSION_CTR", "MATCHED_REQUESTS", "MATCH_RATE", - "OBSERVED_ECPM" + "OBSERVED_ECPM", + "AD_LOAD_LATENCY" ], "enumDescriptions": [ "Default value for an unset field. Do not use.", @@ -1800,7 +1801,8 @@ "The ratio of clicks over impressions. The value is a double precision (approximate) decimal value.", "The number of times ads are returned in response to a request. The value is an integer.", "The ratio of matched ad requests over the total ad requests. The value is a double precision (approximate) decimal value.", - "The third-party ad network's estimated average eCPM. The currency unit (USD, EUR, or other) of the earning metrics are determined by the localization setting for currency. The amount is in micros. For example, $2.30 would be represented as 2300000. The estimated average eCPM per mediation group and per ad source instance level is supported dating back to October 20, 2019. Third-party estimated average eCPM will show 0 for dates prior to October 20, 2019." + "The third-party ad network's estimated average eCPM. The currency unit (USD, EUR, or other) of the earning metrics are determined by the localization setting for currency. The amount is in micros. For example, $2.30 would be represented as 2300000. The estimated average eCPM per mediation group and per ad source instance level is supported dating back to October 20, 2019. Third-party estimated average eCPM will show 0 for dates prior to October 20, 2019.", + "The ad load latency is the total time it takes for an ad to load measured in seconds. It starts when the ad is requested and ends when a response is received. See https://support.google.com/admob/answer/12571120 for additional information." ], "type": "string" }, @@ -1926,7 +1928,8 @@ "IMPRESSION_CTR", "MATCHED_REQUESTS", "MATCH_RATE", - "OBSERVED_ECPM" + "OBSERVED_ECPM", + "AD_LOAD_LATENCY" ], "enumDescriptions": [ "Default value for an unset field. Do not use.", @@ -1937,7 +1940,8 @@ "The ratio of clicks over impressions. The value is a double precision (approximate) decimal value.", "The number of times ads are returned in response to a request. The value is an integer.", "The ratio of matched ad requests over the total ad requests. The value is a double precision (approximate) decimal value.", - "The third-party ad network's estimated average eCPM. The currency unit (USD, EUR, or other) of the earning metrics are determined by the localization setting for currency. The amount is in micros. For example, $2.30 would be represented as 2300000. The estimated average eCPM per mediation group and per ad source instance level is supported dating back to October 20, 2019. Third-party estimated average eCPM will show 0 for dates prior to October 20, 2019." + "The third-party ad network's estimated average eCPM. The currency unit (USD, EUR, or other) of the earning metrics are determined by the localization setting for currency. The amount is in micros. For example, $2.30 would be represented as 2300000. The estimated average eCPM per mediation group and per ad source instance level is supported dating back to October 20, 2019. Third-party estimated average eCPM will show 0 for dates prior to October 20, 2019.", + "The ad load latency is the total time it takes for an ad to load measured in seconds. It starts when the ad is requested and ends when a response is received. See https://support.google.com/admob/answer/12571120 for additional information." ], "type": "string" }, diff --git a/discovery/agentregistry-v1.json b/discovery/agentregistry-v1.json index f8c5b3313d..89865ca028 100644 --- a/discovery/agentregistry-v1.json +++ b/discovery/agentregistry-v1.json @@ -312,6 +312,34 @@ }, "aiApplications": { "methods": { + "get": { + "description": "Gets details of a single AI Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Target AI Application resource name. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "AiApplication" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, "getIamPolicy": { "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}:getIamPolicy", @@ -346,6 +374,55 @@ "https://www.googleapis.com/auth/cloud-platform.read-only" ] }, + "list": { + "description": "Lists AI Applications in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filtering results.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Hint for how to order the results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "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. Parent project and location to query. Format: `projects/{project}/locations/{location}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/aiApplications", + "response": { + "$ref": "ListAiApplicationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}:setIamPolicy", @@ -406,6 +483,221 @@ "https://www.googleapis.com/auth/cloud-platform.read-only" ] } + }, + "resources": { + "agents": { + "methods": { + "get": { + "description": "Gets details of a single Agent under an AI Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/agents/{agentsId}", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.agents.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}/agents/{agent}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Agent" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, + "list": { + "description": "Lists Agents under an AI Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/agents", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.agents.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "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. Parent value (AI Application) for ListAiApplicationAgentsRequest. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/agents", + "response": { + "$ref": "ListAiApplicationAgentsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + }, + "endpoints": { + "methods": { + "get": { + "description": "Gets details of a single Endpoint under an AI Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/endpoints/{endpointsId}", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.endpoints.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}/endpoints/{endpoint}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+/endpoints/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Endpoint" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, + "list": { + "description": "Lists Endpoints under an AI Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/endpoints", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.endpoints.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "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. Parent value (AI Application) for ListAiApplicationEndpointsRequest. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/endpoints", + "response": { + "$ref": "ListAiApplicationEndpointsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + }, + "mcpServers": { + "methods": { + "get": { + "description": "Gets details of a single McpServer under an AI Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/mcpServers/{mcpServersId}", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.mcpServers.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}/mcpServers/{mcp_server}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+/mcpServers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "McpServer" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, + "list": { + "description": "Lists McpServers under an AI Application.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/mcpServers", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.mcpServers.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "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. Parent value (AI Application) for ListAiApplicationMcpServersRequest. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/mcpServers", + "response": { + "$ref": "ListAiApplicationMcpServersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + } } }, "bindings": { @@ -1175,7 +1467,7 @@ } } }, - "revision": "20260904", + "revision": "20261003", "rootUrl": "https://agentregistry.googleapis.com/", "schemas": { "A2ASkill": { @@ -1315,7 +1607,7 @@ "type": "object" }, "type": { - "description": "Required. The type of the agent spec content.", + "description": "Required. Immutable. The type of the agent spec content.", "enum": [ "TYPE_UNSPECIFIED", "NO_SPEC", @@ -1331,6 +1623,68 @@ }, "type": "object" }, + "AiApplication": { + "description": "Represents an AI Application.", + "id": "AiApplication", + "properties": { + "applicationProperties": { + "$ref": "ApplicationProperties", + "description": "Output only. Properties of an underlying cloud resource that can comprise an AI Application.", + "readOnly": true + }, + "attributes": { + "$ref": "Attributes", + "description": "Optional. Consumer provided attributes." + }, + "createTime": { + "description": "Output only. Creation time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. User-defined description of the AI Application.", + "type": "string" + }, + "displayName": { + "description": "Optional. User-defined name for the AI Application.", + "type": "string" + }, + "name": { + "description": "Identifier. Resource name of the AI Application. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "type": "string" + }, + "state": { + "description": "Output only. The current state of the AI Application.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "DELETING" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "The resource is being provisioned or created.", + "The resource is active and ready for use.", + "The resource is in the process of being deleted." + ], + "readOnly": true, + "type": "string" + }, + "uid": { + "description": "Output only. Universally unique identifier (UUID4) for the AI Application.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. Last update time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "Annotations": { "description": "Annotations describing the characteristics and behavior of a tool or operation.", "id": "Annotations", @@ -1363,6 +1717,57 @@ }, "type": "object" }, + "ApplicationProperties": { + "description": "Additional system properties of an Application.", + "id": "ApplicationProperties", + "properties": { + "extendedMetadata": { + "additionalProperties": { + "$ref": "ExtendedMetadata" + }, + "description": "Output only. Additional metadata specific to the App Hub application. The key is a string that identifies the type of metadata and the value is the metadata contents specific to that type. Key format: `apphub.googleapis.com/{metadataType}`", + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, + "Attributes": { + "description": "Consumer provided attributes.", + "id": "Attributes", + "properties": { + "businessOwners": { + "description": "Optional. Business team that ensures user needs are met and value is delivered", + "items": { + "$ref": "ContactInfo" + }, + "type": "array" + }, + "criticality": { + "$ref": "Criticality", + "description": "Optional. User-defined criticality information." + }, + "developerOwners": { + "description": "Optional. Developer team that owns development and coding.", + "items": { + "$ref": "ContactInfo" + }, + "type": "array" + }, + "environment": { + "$ref": "Environment", + "description": "Optional. User-defined environment information." + }, + "operatorOwners": { + "description": "Optional. Operator team that ensures runtime and operations.", + "items": { + "$ref": "ContactInfo" + }, + "type": "array" + } + }, + "type": "object" + }, "AuthProviderBinding": { "description": "The AuthProvider of the Binding.", "id": "AuthProviderBinding", @@ -1413,7 +1818,7 @@ }, "source": { "$ref": "Source", - "description": "Required. The target Agent of the Binding." + "description": "Optional. The source Agent of the Binding." }, "target": { "$ref": "Target", @@ -1463,6 +1868,46 @@ }, "type": "object" }, + "ContactInfo": { + "description": "Contact information of stakeholders.", + "id": "ContactInfo", + "properties": { + "displayName": { + "description": "Optional. Contact's name. Can have a maximum length of 63 characters.", + "type": "string" + }, + "email": { + "description": "Required. Email address of the contacts.", + "type": "string" + } + }, + "type": "object" + }, + "Criticality": { + "description": "Criticality of the Application, Service, or Workload", + "id": "Criticality", + "properties": { + "type": { + "description": "Required. Criticality Type.", + "enum": [ + "TYPE_UNSPECIFIED", + "MISSION_CRITICAL", + "HIGH", + "MEDIUM", + "LOW" + ], + "enumDescriptions": [ + "Unspecified type.", + "Mission critical service, application or workload.", + "High impact.", + "Medium impact.", + "Low impact." + ], + "type": "string" + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -1539,7 +1984,7 @@ "type": "object" }, "type": { - "description": "Required. The type of the endpoint spec content.", + "description": "Required. Immutable. The type of the endpoint spec content.", "enum": [ "TYPE_UNSPECIFIED", "NO_SPEC" @@ -1553,6 +1998,31 @@ }, "type": "object" }, + "Environment": { + "description": "Environment of the Application, Service, or Workload", + "id": "Environment", + "properties": { + "type": { + "description": "Required. Environment Type.", + "enum": [ + "TYPE_UNSPECIFIED", + "PRODUCTION", + "STAGING", + "TEST", + "DEVELOPMENT" + ], + "enumDescriptions": [ + "Unspecified type.", + "Production environment.", + "Staging environment.", + "Test environment.", + "Development environment." + ], + "type": "string" + } + }, + "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() < 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.", "id": "Expr", @@ -1576,6 +2046,22 @@ }, "type": "object" }, + "ExtendedMetadata": { + "description": "Additional metadata for a Service or Workload.", + "id": "ExtendedMetadata", + "properties": { + "metadataStruct": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Output only. The metadata contents.", + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, "FetchAvailableBindingsResponse": { "description": "Message for response to fetching available Bindings.", "id": "FetchAvailableBindingsResponse", @@ -1784,6 +2270,85 @@ }, "type": "object" }, + "ListAiApplicationAgentsResponse": { + "description": "Message for response to listing Agents under an AI Application.", + "id": "ListAiApplicationAgentsResponse", + "properties": { + "agents": { + "description": "The list of Agents.", + "items": { + "$ref": "Agent" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + } + }, + "type": "object" + }, + "ListAiApplicationEndpointsResponse": { + "description": "Message for response to listing Endpoints under an AI Application.", + "id": "ListAiApplicationEndpointsResponse", + "properties": { + "endpoints": { + "description": "The list of Endpoints.", + "items": { + "$ref": "Endpoint" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + } + }, + "type": "object" + }, + "ListAiApplicationMcpServersResponse": { + "description": "Message for response to listing McpServers under an AI Application.", + "id": "ListAiApplicationMcpServersResponse", + "properties": { + "mcpServers": { + "description": "The list of McpServers.", + "items": { + "$ref": "McpServer" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + } + }, + "type": "object" + }, + "ListAiApplicationsResponse": { + "description": "Message for response to listing AiApplications.", + "id": "ListAiApplicationsResponse", + "properties": { + "aiApplications": { + "description": "The list of AiApplications.", + "items": { + "$ref": "AiApplication" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + }, + "unreachable": { + "description": "Unordered list. Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListBindingsResponse": { "description": "Message for response to listing Bindings", "id": "ListBindingsResponse", @@ -2012,7 +2577,7 @@ "type": "object" }, "type": { - "description": "Required. The type of the MCP Server spec content.", + "description": "Required. Immutable. The type of the MCP Server spec content.", "enum": [ "TYPE_UNSPECIFIED", "NO_SPEC", @@ -2156,7 +2721,7 @@ "type": "string" }, "searchString": { - "description": "Optional. Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |--------------------|-----|-----|-----|----------------| | agentId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | skills | No | Yes | No | Included | | skills.id | No | Yes | No | Included | | skills.name | No | Yes | No | Included | | skills.description | No | Yes | No | Included | | skills.tags | No | Yes | No | Included | | skills.examples | No | Yes | No | Included | Examples: * `agentId=\"urn:agent:projects-123:projects:123:locations:us-central1:reasoningEngines:1234\"` to find the agent with the specified agent ID. * `name:important` to find agents whose name contains `important` as a word. * `displayName:works*` to find agents whose display name contains words that start with `works`. * `skills.tags:test` to find agents whose skills tags contain `test`. * `planner OR booking` to find agents whose metadata contains the words `planner` or `booking`.", + "description": "Optional. Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |--------------------|-----|-----|-----|----------------| | agentId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | skills | No | Yes | No | Included | | skills.id | No | Yes | No | Included | | skills.name | No | Yes | No | Included | | skills.description | No | Yes | No | Included | | skills.tags | No | Yes | No | Included | | skills.examples | No | Yes | No | Included | Examples: * `agentId=\"urn:agent:projects-123:projects:123:locations:us-central1:aiplatform:reasoningEngines:1234\"` to find the agent with the specified agent ID. * `name:important` to find agents whose name contains `important` as a word. * `displayName:works*` to find agents whose display name contains words that start with `works`. * `skills.tags:test` to find agents whose skills tags contain `test`. * `planner OR booking` to find agents whose metadata contains the words `planner` or `booking`.", "type": "string" } }, diff --git a/discovery/agentregistry-v1alpha.json b/discovery/agentregistry-v1alpha.json index 2bb3fde888..e8bc403e95 100644 --- a/discovery/agentregistry-v1alpha.json +++ b/discovery/agentregistry-v1alpha.json @@ -312,6 +312,34 @@ }, "aiApplications": { "methods": { + "get": { + "description": "Gets details of a single AI Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Target AI Application resource name. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "AiApplication" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, "getIamPolicy": { "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}:getIamPolicy", @@ -346,6 +374,55 @@ "https://www.googleapis.com/auth/cloud-platform.read-only" ] }, + "list": { + "description": "Lists AI Applications in a given project and location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filtering results.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. Hint for how to order the results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "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. Parent project and location to query. Format: `projects/{project}/locations/{location}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/aiApplications", + "response": { + "$ref": "ListAiApplicationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}:setIamPolicy", @@ -406,6 +483,221 @@ "https://www.googleapis.com/auth/cloud-platform.read-only" ] } + }, + "resources": { + "agents": { + "methods": { + "get": { + "description": "Gets details of a single Agent under an AI Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/agents/{agentsId}", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.agents.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}/agents/{agent}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+/agents/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Agent" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, + "list": { + "description": "Lists Agents under an AI Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/agents", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.agents.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "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. Parent value (AI Application) for ListAiApplicationAgentsRequest. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/agents", + "response": { + "$ref": "ListAiApplicationAgentsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + }, + "endpoints": { + "methods": { + "get": { + "description": "Gets details of a single Endpoint under an AI Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/endpoints/{endpointsId}", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.endpoints.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}/endpoints/{endpoint}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+/endpoints/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Endpoint" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, + "list": { + "description": "Lists Endpoints under an AI Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/endpoints", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.endpoints.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "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. Parent value (AI Application) for ListAiApplicationEndpointsRequest. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/endpoints", + "response": { + "$ref": "ListAiApplicationEndpointsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + }, + "mcpServers": { + "methods": { + "get": { + "description": "Gets details of a single McpServer under an AI Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/mcpServers/{mcpServersId}", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.mcpServers.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}/mcpServers/{mcp_server}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+/mcpServers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "McpServer" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + }, + "list": { + "description": "Lists McpServers under an AI Application.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/aiApplications/{aiApplicationsId}/mcpServers", + "httpMethod": "GET", + "id": "agentregistry.projects.locations.aiApplications.mcpServers.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", + "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. Parent value (AI Application) for ListAiApplicationMcpServersRequest. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/aiApplications/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/mcpServers", + "response": { + "$ref": "ListAiApplicationMcpServersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/agentregistry.read-only", + "https://www.googleapis.com/auth/agentregistry.read-write", + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + } } }, "bindings": { @@ -1757,7 +2049,7 @@ } } }, - "revision": "20260904", + "revision": "20261003", "rootUrl": "https://agentregistry.googleapis.com/", "schemas": { "A2ASkill": { @@ -1897,7 +2189,7 @@ "type": "object" }, "type": { - "description": "Required. The type of the agent spec content.", + "description": "Required. Immutable. The type of the agent spec content.", "enum": [ "TYPE_UNSPECIFIED", "NO_SPEC", @@ -1913,6 +2205,68 @@ }, "type": "object" }, + "AiApplication": { + "description": "Represents an AI Application.", + "id": "AiApplication", + "properties": { + "applicationProperties": { + "$ref": "ApplicationProperties", + "description": "Output only. Properties of an underlying cloud resource that can comprise an AI Application.", + "readOnly": true + }, + "attributes": { + "$ref": "Attributes", + "description": "Optional. Consumer provided attributes." + }, + "createTime": { + "description": "Output only. Creation time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. User-defined description of the AI Application.", + "type": "string" + }, + "displayName": { + "description": "Optional. User-defined name for the AI Application.", + "type": "string" + }, + "name": { + "description": "Identifier. Resource name of the AI Application. Format: `projects/{project}/locations/{location}/aiApplications/{ai_application}`", + "type": "string" + }, + "state": { + "description": "Output only. The current state of the AI Application.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "DELETING" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "The resource is being provisioned or created.", + "The resource is active and ready for use.", + "The resource is in the process of being deleted." + ], + "readOnly": true, + "type": "string" + }, + "uid": { + "description": "Output only. Universally unique identifier (UUID4) for the AI Application.", + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. Last update time.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "Annotations": { "description": "Annotations describing the characteristics and behavior of a tool or operation.", "id": "Annotations", @@ -1945,6 +2299,21 @@ }, "type": "object" }, + "ApplicationProperties": { + "description": "Additional system properties of an Application.", + "id": "ApplicationProperties", + "properties": { + "extendedMetadata": { + "additionalProperties": { + "$ref": "ExtendedMetadata" + }, + "description": "Output only. Additional metadata specific to the App Hub application. The key is a string that identifies the type of metadata and the value is the metadata contents specific to that type. Key format: `apphub.googleapis.com/{metadataType}`", + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, "ArchiveUploadSource": { "description": "Direct write-only raw archive payload upload.", "id": "ArchiveUploadSource", @@ -1957,6 +2326,42 @@ }, "type": "object" }, + "Attributes": { + "description": "Consumer provided attributes.", + "id": "Attributes", + "properties": { + "businessOwners": { + "description": "Optional. Business team that ensures user needs are met and value is delivered", + "items": { + "$ref": "ContactInfo" + }, + "type": "array" + }, + "criticality": { + "$ref": "Criticality", + "description": "Optional. User-defined criticality information." + }, + "developerOwners": { + "description": "Optional. Developer team that owns development and coding.", + "items": { + "$ref": "ContactInfo" + }, + "type": "array" + }, + "environment": { + "$ref": "Environment", + "description": "Optional. User-defined environment information." + }, + "operatorOwners": { + "description": "Optional. Operator team that ensures runtime and operations.", + "items": { + "$ref": "ContactInfo" + }, + "type": "array" + } + }, + "type": "object" + }, "AuthProviderBinding": { "description": "The AuthProvider of the Binding.", "id": "AuthProviderBinding", @@ -2007,7 +2412,7 @@ }, "source": { "$ref": "Source", - "description": "Required. The target Agent of the Binding." + "description": "Optional. The source Agent of the Binding." }, "target": { "$ref": "Target", @@ -2057,6 +2462,71 @@ }, "type": "object" }, + "Channel": { + "description": "Separate message to accommodate custom formats across IRC and Slack.", + "id": "Channel", + "properties": { + "uri": { + "description": "Required. URI of the channel.", + "type": "string" + } + }, + "type": "object" + }, + "ContactInfo": { + "description": "Contact information of stakeholders.", + "id": "ContactInfo", + "properties": { + "channel": { + "$ref": "Channel", + "description": "Optional. Communication channel of the contacts." + }, + "displayName": { + "description": "Optional. Contact's name. Can have a maximum length of 63 characters.", + "type": "string" + }, + "email": { + "description": "Required. Email address of the contacts.", + "type": "string" + } + }, + "type": "object" + }, + "Criticality": { + "description": "Criticality of the Application, Service, or Workload", + "id": "Criticality", + "properties": { + "level": { + "deprecated": true, + "description": "Optional. Criticality level. Can contain only lowercase letters, numeric characters, underscores, and dashes. Can have a maximum length of 63 characters. Deprecated: Please refer to type instead.", + "type": "string" + }, + "missionCritical": { + "deprecated": true, + "description": "Optional. Indicates mission-critical Application, Service, or Workload. Deprecated: Please refer to type instead.", + "type": "boolean" + }, + "type": { + "description": "Required. Criticality Type.", + "enum": [ + "TYPE_UNSPECIFIED", + "MISSION_CRITICAL", + "HIGH", + "MEDIUM", + "LOW" + ], + "enumDescriptions": [ + "Unspecified type.", + "Mission critical service, application or workload.", + "High impact.", + "Medium impact.", + "Low impact." + ], + "type": "string" + } + }, + "type": "object" + }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -2133,7 +2603,7 @@ "type": "object" }, "type": { - "description": "Required. The type of the endpoint spec content.", + "description": "Required. Immutable. The type of the endpoint spec content.", "enum": [ "TYPE_UNSPECIFIED", "NO_SPEC" @@ -2147,6 +2617,36 @@ }, "type": "object" }, + "Environment": { + "description": "Environment of the Application, Service, or Workload", + "id": "Environment", + "properties": { + "environment": { + "deprecated": true, + "description": "Optional. Environment name. Can contain only lowercase letters, numeric characters, underscores, and dashes. Can have a maximum length of 63 characters. Deprecated: Please refer to type instead.", + "type": "string" + }, + "type": { + "description": "Required. Environment Type.", + "enum": [ + "TYPE_UNSPECIFIED", + "PRODUCTION", + "STAGING", + "TEST", + "DEVELOPMENT" + ], + "enumDescriptions": [ + "Unspecified type.", + "Production environment.", + "Staging environment.", + "Test environment.", + "Development environment." + ], + "type": "string" + } + }, + "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() < 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.", "id": "Expr", @@ -2170,6 +2670,22 @@ }, "type": "object" }, + "ExtendedMetadata": { + "description": "Additional metadata for a Service or Workload.", + "id": "ExtendedMetadata", + "properties": { + "metadataStruct": { + "additionalProperties": { + "description": "Properties of the object.", + "type": "any" + }, + "description": "Output only. The metadata contents.", + "readOnly": true, + "type": "object" + } + }, + "type": "object" + }, "FetchAvailableBindingsResponse": { "description": "Message for response to fetching available Bindings.", "id": "FetchAvailableBindingsResponse", @@ -2424,6 +2940,85 @@ }, "type": "object" }, + "ListAiApplicationAgentsResponse": { + "description": "Message for response to listing Agents under an AI Application.", + "id": "ListAiApplicationAgentsResponse", + "properties": { + "agents": { + "description": "The list of Agents.", + "items": { + "$ref": "Agent" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + } + }, + "type": "object" + }, + "ListAiApplicationEndpointsResponse": { + "description": "Message for response to listing Endpoints under an AI Application.", + "id": "ListAiApplicationEndpointsResponse", + "properties": { + "endpoints": { + "description": "The list of Endpoints.", + "items": { + "$ref": "Endpoint" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + } + }, + "type": "object" + }, + "ListAiApplicationMcpServersResponse": { + "description": "Message for response to listing McpServers under an AI Application.", + "id": "ListAiApplicationMcpServersResponse", + "properties": { + "mcpServers": { + "description": "The list of McpServers.", + "items": { + "$ref": "McpServer" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + } + }, + "type": "object" + }, + "ListAiApplicationsResponse": { + "description": "Message for response to listing AiApplications.", + "id": "ListAiApplicationsResponse", + "properties": { + "aiApplications": { + "description": "The list of AiApplications.", + "items": { + "$ref": "AiApplication" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + }, + "unreachable": { + "description": "Unordered list. Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListBindingsResponse": { "description": "Message for response to listing Bindings", "id": "ListBindingsResponse", @@ -2713,7 +3308,7 @@ "type": "object" }, "type": { - "description": "Required. The type of the MCP Server spec content.", + "description": "Required. Immutable. The type of the MCP Server spec content.", "enum": [ "TYPE_UNSPECIFIED", "NO_SPEC", @@ -2901,7 +3496,7 @@ "type": "string" }, "searchString": { - "description": "Optional. Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |--------------------|-----|-----|-----|----------------| | agentId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | skills | No | Yes | No | Included | | skills.id | No | Yes | No | Included | | skills.name | No | Yes | No | Included | | skills.description | No | Yes | No | Included | | skills.tags | No | Yes | No | Included | | skills.examples | No | Yes | No | Included | Examples: * `agentId=\"urn:agent:projects-123:projects:123:locations:us-central1:reasoningEngines:1234\"` to find the agent with the specified agent ID. * `name:important` to find agents whose name contains `important` as a word. * `displayName:works*` to find agents whose display name contains words that start with `works`. * `skills.tags:test` to find agents whose skills tags contain `test`. * `planner OR booking` to find agents whose metadata contains the words `planner` or `booking`.", + "description": "Optional. Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |--------------------|-----|-----|-----|----------------| | agentId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | skills | No | Yes | No | Included | | skills.id | No | Yes | No | Included | | skills.name | No | Yes | No | Included | | skills.description | No | Yes | No | Included | | skills.tags | No | Yes | No | Included | | skills.examples | No | Yes | No | Included | Examples: * `agentId=\"urn:agent:projects-123:projects:123:locations:us-central1:aiplatform:reasoningEngines:1234\"` to find the agent with the specified agent ID. * `name:important` to find agents whose name contains `important` as a word. * `displayName:works*` to find agents whose display name contains words that start with `works`. * `skills.tags:test` to find agents whose skills tags contain `test`. * `planner OR booking` to find agents whose metadata contains the words `planner` or `booking`.", "type": "string" } }, diff --git a/discovery/alloydb-v1.json b/discovery/alloydb-v1.json index 266401f909..1d6d9d527d 100644 --- a/discovery/alloydb-v1.json +++ b/discovery/alloydb-v1.json @@ -1879,7 +1879,7 @@ } } }, - "revision": "20260924", + "revision": "20261006", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -1893,6 +1893,24 @@ }, "type": "object" }, + "AutoScalingConfig": { + "description": "Configuration for autoscaling.", + "id": "AutoScalingConfig", + "properties": { + "policy": { + "$ref": "Policy", + "description": "Policy for the MIG autoscaler." + }, + "schedules": { + "description": "Optional list of schedules for the MIG autoscaler. If not set, no schedules are created.", + "items": { + "$ref": "Schedule" + }, + "type": "array" + } + }, + "type": "object" + }, "AutomatedBackupPolicy": { "description": "Message describing the user-specified automated backup policy. All fields in the automated backup policy are optional. Defaults for each field are provided if they are not set.", "id": "AutomatedBackupPolicy", @@ -2848,6 +2866,18 @@ }, "type": "object" }, + "CpuUtilization": { + "description": "CPU utilization policy for the autoscaler.", + "id": "CpuUtilization", + "properties": { + "utilizationTarget": { + "description": "Target CPU utilization as a float between 0 and 1.", + "format": "float", + "type": "number" + } + }, + "type": "object" + }, "CsvExportOptions": { "description": "Options for exporting data in CSV format.", "id": "CsvExportOptions", @@ -3411,7 +3441,7 @@ "readOnly": true }, "publicIpAddress": { - "description": "Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application.", + "description": "Output only. The public IP address for the Instance. This is available ONLY when `enable_public_ip` is set or when you have upgraded from an Express Instance that has public DNS enabled. This field is not available for Express Instances. This is the connection endpoint for an end-user application.", "readOnly": true, "type": "string" }, @@ -4068,6 +4098,31 @@ }, "type": "object" }, + "Policy": { + "description": "Policy for the autoscaler.", + "id": "Policy", + "properties": { + "coolDownPeriodSec": { + "description": "The period of time in seconds after a new node is created before the autoscaler will incorporate its resource usage (e.g. CPU utilization) into the autoscaling recommendation algorithm.", + "format": "int64", + "type": "string" + }, + "cpuUtilization": { + "$ref": "CpuUtilization", + "description": "CPU utilization policy for the autoscaler." + }, + "enabled": { + "description": "If true, autoscaling is enabled for the instance. If not set, the default value is false.", + "type": "boolean" + }, + "maxNodeCount": { + "description": "Maximum number of nodes for the autoscaler.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "PrimaryConfig": { "description": "Configuration for the primary cluster. It has the list of clusters that are replicating from this cluster. This should be set if and only if the cluster is of type PRIMARY.", "id": "PrimaryConfig", @@ -4368,6 +4423,10 @@ "description": "Configuration for a read pool instance.", "id": "ReadPoolConfig", "properties": { + "autoScalingConfig": { + "$ref": "AutoScalingConfig", + "description": "Optional. Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled." + }, "nodeCount": { "description": "Read capacity, i.e. number of nodes in a read pool instance.", "format": "int32", @@ -4466,6 +4525,43 @@ }, "type": "object" }, + "Schedule": { + "description": "A schedule for the autoscaler.", + "id": "Schedule", + "properties": { + "cronExpression": { + "description": "Cron expression for the triggering the schedule. See https://cloud.google.com/compute/docs/autoscaler/scaling-schedules#cron_expressions for the syntax.", + "type": "string" + }, + "description": { + "description": "Description of the schedule.", + "type": "string" + }, + "disabled": { + "description": "If true, the schedule is disabled.", + "type": "boolean" + }, + "durationSec": { + "description": "Duration of the schedule.", + "format": "int64", + "type": "string" + }, + "minNodeCount": { + "description": "Minimum number of nodes in while the schedule is active.", + "format": "int64", + "type": "string" + }, + "name": { + "description": "Name of the schedule.", + "type": "string" + }, + "timeZone": { + "description": "The location-based IANA time zone for interpreting the schedule's start time. If no time zone is provided, UTC is used by default.", + "type": "string" + } + }, + "type": "object" + }, "SecondaryConfig": { "description": "Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY.", "id": "SecondaryConfig", diff --git a/discovery/alloydb-v1alpha.json b/discovery/alloydb-v1alpha.json index ead17ca7a6..5b5a356f0e 100644 --- a/discovery/alloydb-v1alpha.json +++ b/discovery/alloydb-v1alpha.json @@ -2086,7 +2086,7 @@ } } }, - "revision": "20260924", + "revision": "20261006", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -2248,16 +2248,22 @@ "type": "string" }, "edition": { - "description": "Output only. The edition of the cluster this backup was created from. Any restored cluster created from this backup will have the same edition.", + "deprecated": true, + "description": "Output only. Deprecated: Use `express_config` instead. Output only. The edition of the cluster this backup was created from. Any restored cluster created from this backup will have the same edition.", "enum": [ "EDITION_UNSPECIFIED", "EDITION_ALLOYDB", "EDITION_ALLOYDB_DEVELOPER" ], + "enumDeprecated": [ + true, + true, + true + ], "enumDescriptions": [ - "An unknown Edition type.", - "Standard AlloyDB cluster.", - "Developer edition cluster." + "Deprecated: Use `ExpressConfig` instead. An unknown Edition type.", + "Deprecated: Use `ExpressConfig` instead. Standard AlloyDB cluster.", + "Deprecated: Use `ExpressConfig` instead. Developer edition cluster." ], "readOnly": true, "type": "string" @@ -2286,6 +2292,11 @@ "readOnly": true, "type": "string" }, + "expressConfig": { + "$ref": "ExpressConfig", + "description": "Output only. The Express configuration of the cluster this backup was created from. Any restored cluster created from this backup will have the same Express configuration.", + "readOnly": true + }, "labels": { "additionalProperties": { "type": "string" @@ -2670,16 +2681,22 @@ "type": "string" }, "edition": { - "description": "Optional. Edition of the cluster. If left unspecified, the cluster behaves as `EDITION_ALLOYDB`.", + "deprecated": true, + "description": "Optional. Deprecated: Use `express_config` instead. Edition of the cluster. If left unspecified, the cluster behaves as `EDITION_ALLOYDB`.", "enum": [ "EDITION_UNSPECIFIED", "EDITION_ALLOYDB", "EDITION_ALLOYDB_DEVELOPER" ], + "enumDeprecated": [ + true, + true, + true + ], "enumDescriptions": [ - "An unknown Edition type.", - "Standard AlloyDB cluster.", - "Developer edition cluster." + "Deprecated: Use `ExpressConfig` instead. An unknown Edition type.", + "Deprecated: Use `ExpressConfig` instead. Standard AlloyDB cluster.", + "Deprecated: Use `ExpressConfig` instead. Developer edition cluster." ], "type": "string" }, @@ -3903,7 +3920,7 @@ "readOnly": true }, "publicIpAddress": { - "description": "Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application.", + "description": "Output only. The public IP address for the Instance. This is available ONLY when `enable_public_ip` is set or when you have upgraded from an Express Instance that has public DNS enabled. This field is not available for Express Instances. This is the connection endpoint for an end-user application.", "readOnly": true, "type": "string" }, @@ -4954,7 +4971,7 @@ "properties": { "autoScalingConfig": { "$ref": "AutoScalingConfig", - "description": "Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled." + "description": "Optional. Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled." }, "nodeCount": { "description": "Read capacity, i.e. number of nodes in a read pool instance.", diff --git a/discovery/alloydb-v1beta.json b/discovery/alloydb-v1beta.json index ad4e003aea..73cd2cfdd7 100644 --- a/discovery/alloydb-v1beta.json +++ b/discovery/alloydb-v1beta.json @@ -2083,7 +2083,7 @@ } } }, - "revision": "20260924", + "revision": "20261006", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -2245,16 +2245,22 @@ "type": "string" }, "edition": { - "description": "Output only. The edition of the cluster this backup was created from. Any restored cluster created from this backup will have the same edition.", + "deprecated": true, + "description": "Output only. Deprecated: Use `express_config` instead. Output only. The edition of the cluster this backup was created from. Any restored cluster created from this backup will have the same edition.", "enum": [ "EDITION_UNSPECIFIED", "EDITION_ALLOYDB", "EDITION_ALLOYDB_DEVELOPER" ], + "enumDeprecated": [ + true, + true, + true + ], "enumDescriptions": [ - "An unknown Edition type.", - "Standard AlloyDB cluster.", - "Developer edition cluster." + "Deprecated: Use `ExpressConfig` instead. An unknown Edition type.", + "Deprecated: Use `ExpressConfig` instead. Standard AlloyDB cluster.", + "Deprecated: Use `ExpressConfig` instead. Developer edition cluster." ], "readOnly": true, "type": "string" @@ -2283,6 +2289,11 @@ "readOnly": true, "type": "string" }, + "expressConfig": { + "$ref": "ExpressConfig", + "description": "Output only. The Express configuration of the cluster this backup was created from. Any restored cluster created from this backup will have the same Express configuration.", + "readOnly": true + }, "labels": { "additionalProperties": { "type": "string" @@ -2656,16 +2667,22 @@ "type": "string" }, "edition": { - "description": "Optional. Edition of the cluster. If left unspecified, the cluster behaves as `EDITION_ALLOYDB`.", + "deprecated": true, + "description": "Optional. Deprecated: Use `express_config` instead. Edition of the cluster. If left unspecified, the cluster behaves as `EDITION_ALLOYDB`.", "enum": [ "EDITION_UNSPECIFIED", "EDITION_ALLOYDB", "EDITION_ALLOYDB_DEVELOPER" ], + "enumDeprecated": [ + true, + true, + true + ], "enumDescriptions": [ - "An unknown Edition type.", - "Standard AlloyDB cluster.", - "Developer edition cluster." + "Deprecated: Use `ExpressConfig` instead. An unknown Edition type.", + "Deprecated: Use `ExpressConfig` instead. Standard AlloyDB cluster.", + "Deprecated: Use `ExpressConfig` instead. Developer edition cluster." ], "type": "string" }, @@ -3884,7 +3901,7 @@ "readOnly": true }, "publicIpAddress": { - "description": "Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application.", + "description": "Output only. The public IP address for the Instance. This is available ONLY when `enable_public_ip` is set or when you have upgraded from an Express Instance that has public DNS enabled. This field is not available for Express Instances. This is the connection endpoint for an end-user application.", "readOnly": true, "type": "string" }, @@ -4930,7 +4947,7 @@ "properties": { "autoScalingConfig": { "$ref": "AutoScalingConfig", - "description": "Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled." + "description": "Optional. Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled." }, "nodeCount": { "description": "Read capacity, i.e. number of nodes in a read pool instance.", diff --git a/discovery/analyticsdata-v1beta.json b/discovery/analyticsdata-v1beta.json index d128281ddd..b9e4183681 100644 --- a/discovery/analyticsdata-v1beta.json +++ b/discovery/analyticsdata-v1beta.json @@ -440,7 +440,7 @@ } } }, - "revision": "20260909", + "revision": "20261006", "rootUrl": "https://analyticsdata.googleapis.com/", "schemas": { "ActiveMetricRestriction": { @@ -1075,7 +1075,7 @@ "type": "object" }, "EmptyFilter": { - "description": "Filter for empty values.", + "description": "Filter for empty values. Matches dimension values that are `\"\"` or `(not set)` values. Use this filter to match rows with missing or unpopulated dimension values, or combine it with `not_expression` to exclude them from a report without filtering for both `\"\"` and `(not set)` separately.", "id": "EmptyFilter", "properties": {}, "type": "object" @@ -1090,7 +1090,7 @@ }, "emptyFilter": { "$ref": "EmptyFilter", - "description": "A filter for empty values such as \"(not set)\" and \"\" values." + "description": "A filter for empty values such as `(not set)` and `\"\"` values." }, "fieldName": { "description": "The dimension name or metric name. In most methods, dimensions & metrics can be used for the first time in this field. However in a RunPivotReportRequest, this field must be additionally specified by name in the RunPivotReportRequest's dimensions or metrics.", diff --git a/discovery/androidmanagement-v1.json b/discovery/androidmanagement-v1.json index 698efd274c..55913d8be1 100644 --- a/discovery/androidmanagement-v1.json +++ b/discovery/androidmanagement-v1.json @@ -1265,7 +1265,7 @@ } } }, - "revision": "20261006", + "revision": "20261008", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdbShellCommandEvent": { @@ -4859,7 +4859,7 @@ "type": "object" }, "KioskCustomization": { - "description": "Settings controlling the behavior of a device in kiosk mode. To enable kiosk mode, set kioskCustomLauncherEnabled to true or specify an app in the policy with installType KIOSK.", + "description": "Settings controlling the behavior of a device in kiosk mode. To enable kiosk mode, set kioskCustomLauncherEnabled to true or specify an app in the policy with the KIOSK role.", "id": "KioskCustomization", "properties": { "deviceSettings": { @@ -6505,7 +6505,7 @@ }, "kioskCustomization": { "$ref": "KioskCustomization", - "description": "Optional. Settings controlling the behavior of a device in kiosk mode. To enable kiosk mode, set kioskCustomLauncherEnabled to true or specify an app in the policy with installType KIOSK." + "description": "Optional. Settings controlling the behavior of a device in kiosk mode. To enable kiosk mode, set kioskCustomLauncherEnabled to true or specify an app in the policy with the KIOSK role." }, "locationMode": { "description": "The degree of location detection enabled.", diff --git a/discovery/assuredworkloads-v1.json b/discovery/assuredworkloads-v1.json index 361ed4a7d6..0eb3d651bf 100644 --- a/discovery/assuredworkloads-v1.json +++ b/discovery/assuredworkloads-v1.json @@ -105,46 +105,6 @@ }, "protocol": "rest", "resources": { - "assuredworkloads": { - "methods": { - "archiveResourceEvents": { - "description": "Finds orphan ResourceEvents matching the criteria and moves them to the ArchivedResourceEvents table.", - "flatPath": "v1/assuredworkloads:archiveResourceEvents", - "httpMethod": "POST", - "id": "assuredworkloads.assuredworkloads.archiveResourceEvents", - "parameterOrder": [], - "parameters": {}, - "path": "v1/assuredworkloads:archiveResourceEvents", - "request": { - "$ref": "GoogleCloudAssuredworkloadsV1ArchiveResourceEventsRequest" - }, - "response": { - "$ref": "GoogleCloudAssuredworkloadsV1ArchiveResourceEventsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "revertArchivedResourceEvents": { - "description": "Finds matching ArchivedResourceEvents and moves them back to the ResourceEvents table.", - "flatPath": "v1/assuredworkloads:revertArchivedResourceEvents", - "httpMethod": "POST", - "id": "assuredworkloads.assuredworkloads.revertArchivedResourceEvents", - "parameterOrder": [], - "parameters": {}, - "path": "v1/assuredworkloads:revertArchivedResourceEvents", - "request": { - "$ref": "GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsRequest" - }, - "response": { - "$ref": "GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - }, "folders": { "resources": { "locations": { @@ -1482,7 +1442,7 @@ } } }, - "revision": "20260928", + "revision": "20261006", "rootUrl": "https://assuredworkloads.googleapis.com/", "schemas": { "GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest": { @@ -1642,54 +1602,6 @@ }, "type": "object" }, - "GoogleCloudAssuredworkloadsV1ArchiveResourceEventsRequest": { - "description": "Request for archiving resource events.", - "id": "GoogleCloudAssuredworkloadsV1ArchiveResourceEventsRequest", - "properties": { - "archiveTime": { - "description": "Optional. Time to set as ArchiveTime in the archive table. If not provided, the current time is used.", - "format": "google-datetime", - "type": "string" - }, - "batchSize": { - "description": "Required. The number of events to process in a single transaction batch.", - "format": "int32", - "type": "integer" - }, - "eventCutoffTime": { - "description": "Required. Only events with EventTime earlier than this cutoff will be archived.", - "format": "google-datetime", - "type": "string" - }, - "maxEventsMove": { - "description": "Required. The maximum total number of events to move in this request.", - "format": "int32", - "type": "integer" - }, - "organizationId": { - "description": "Required. The organization ID for which to archive events.", - "format": "int64", - "type": "string" - }, - "region": { - "description": "Required. The region of the workload(s) whose events should be archived. This is used to filter workloads based on AssurantWorkloadData.region.", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudAssuredworkloadsV1ArchiveResourceEventsResponse": { - "description": "Response for archiving resource events.", - "id": "GoogleCloudAssuredworkloadsV1ArchiveResourceEventsResponse", - "properties": { - "movedEventsCount": { - "description": "The total number of events successfully moved to the archive table.", - "format": "int32", - "type": "integer" - } - }, - "type": "object" - }, "GoogleCloudAssuredworkloadsV1AssetMoveAnalysis": { "description": "Represents move analysis results for an asset.", "id": "GoogleCloudAssuredworkloadsV1AssetMoveAnalysis", @@ -2847,54 +2759,6 @@ "properties": {}, "type": "object" }, - "GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsRequest": { - "description": "Request for reverting archived resource events.", - "id": "GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsRequest", - "properties": { - "archiveEndTime": { - "description": "Required. Only events within this time range will be reverted. This helps prevent reverting everything when something goes wrong.", - "format": "google-datetime", - "type": "string" - }, - "archiveStartTime": { - "description": "Required. Only events within this time range will be reverted. This helps prevent reverting everything when something goes wrong.", - "format": "google-datetime", - "type": "string" - }, - "batchSize": { - "description": "Required. The number of events to process in a single transaction batch.", - "format": "int32", - "type": "integer" - }, - "maxEventsMove": { - "description": "Required. The maximum total number of events to move in this request.", - "format": "int32", - "type": "integer" - }, - "organizationId": { - "description": "Required. The organization ID for which to revert events.", - "format": "int64", - "type": "string" - }, - "region": { - "description": "Required. The region of the workload(s) whose events should be reverted. This is used to filter workloads based on AssurantWorkloadData.region.", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsResponse": { - "description": "Response for reverting archived resource events.", - "id": "GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsResponse", - "properties": { - "movedEventsCount": { - "description": "The total number of events successfully moved to the original table.", - "format": "int32", - "type": "integer" - } - }, - "type": "object" - }, "GoogleCloudAssuredworkloadsV1Rule": { "description": "A rule in the cloud control.", "id": "GoogleCloudAssuredworkloadsV1Rule", diff --git a/discovery/assuredworkloads-v1beta1.json b/discovery/assuredworkloads-v1beta1.json index 11809e6033..fb326706ec 100644 --- a/discovery/assuredworkloads-v1beta1.json +++ b/discovery/assuredworkloads-v1beta1.json @@ -105,46 +105,6 @@ }, "protocol": "rest", "resources": { - "assuredworkloads": { - "methods": { - "archiveResourceEvents": { - "description": "Finds orphan ResourceEvents matching the criteria and moves them to the ArchivedResourceEvents table.", - "flatPath": "v1beta1/assuredworkloads:archiveResourceEvents", - "httpMethod": "POST", - "id": "assuredworkloads.assuredworkloads.archiveResourceEvents", - "parameterOrder": [], - "parameters": {}, - "path": "v1beta1/assuredworkloads:archiveResourceEvents", - "request": { - "$ref": "GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsRequest" - }, - "response": { - "$ref": "GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "revertArchivedResourceEvents": { - "description": "Finds matching ArchivedResourceEvents and moves them back to the ResourceEvents table.", - "flatPath": "v1beta1/assuredworkloads:revertArchivedResourceEvents", - "httpMethod": "POST", - "id": "assuredworkloads.assuredworkloads.revertArchivedResourceEvents", - "parameterOrder": [], - "parameters": {}, - "path": "v1beta1/assuredworkloads:revertArchivedResourceEvents", - "request": { - "$ref": "GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsRequest" - }, - "response": { - "$ref": "GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - } - }, "folders": { "resources": { "locations": { @@ -1454,7 +1414,7 @@ } } }, - "revision": "20260928", + "revision": "20261006", "rootUrl": "https://assuredworkloads.googleapis.com/", "schemas": { "GoogleCloudAssuredworkloadsV1beta1AcknowledgeViolationRequest": { @@ -1614,54 +1574,6 @@ }, "type": "object" }, - "GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsRequest": { - "description": "Request for archiving resource events.", - "id": "GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsRequest", - "properties": { - "archiveTime": { - "description": "Optional. Time to set as ArchiveTime in the archive table. If not provided, the current time is used.", - "format": "google-datetime", - "type": "string" - }, - "batchSize": { - "description": "Required. The number of events to process in a single transaction batch.", - "format": "int32", - "type": "integer" - }, - "eventCutoffTime": { - "description": "Required. Only events with EventTime earlier than this cutoff will be archived.", - "format": "google-datetime", - "type": "string" - }, - "maxEventsMove": { - "description": "Required. The maximum total number of events to move in this request.", - "format": "int32", - "type": "integer" - }, - "organizationId": { - "description": "Required. The organization ID for which to archive events.", - "format": "int64", - "type": "string" - }, - "region": { - "description": "Required. The region of the workload(s) whose events should be archived. This is used to filter workloads based on AssurantWorkloadData.region.", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsResponse": { - "description": "Response for archiving resource events.", - "id": "GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsResponse", - "properties": { - "movedEventsCount": { - "description": "The total number of events successfully moved to the archive table.", - "format": "int32", - "type": "integer" - } - }, - "type": "object" - }, "GoogleCloudAssuredworkloadsV1beta1AssetMoveAnalysis": { "description": "Represents move analysis results for an asset.", "id": "GoogleCloudAssuredworkloadsV1beta1AssetMoveAnalysis", @@ -2806,54 +2718,6 @@ "properties": {}, "type": "object" }, - "GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsRequest": { - "description": "Request for reverting archived resource events.", - "id": "GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsRequest", - "properties": { - "archiveEndTime": { - "description": "Required. Only events within this time range will be reverted. This helps prevent reverting everything when something goes wrong.", - "format": "google-datetime", - "type": "string" - }, - "archiveStartTime": { - "description": "Required. Only events within this time range will be reverted. This helps prevent reverting everything when something goes wrong.", - "format": "google-datetime", - "type": "string" - }, - "batchSize": { - "description": "Required. The number of events to process in a single transaction batch.", - "format": "int32", - "type": "integer" - }, - "maxEventsMove": { - "description": "Required. The maximum total number of events to move in this request.", - "format": "int32", - "type": "integer" - }, - "organizationId": { - "description": "Required. The organization ID for which to revert events.", - "format": "int64", - "type": "string" - }, - "region": { - "description": "Required. The region of the workload(s) whose events should be reverted. This is used to filter workloads based on AssurantWorkloadData.region.", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsResponse": { - "description": "Response for reverting archived resource events.", - "id": "GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsResponse", - "properties": { - "movedEventsCount": { - "description": "The total number of events successfully moved to the original table.", - "format": "int32", - "type": "integer" - } - }, - "type": "object" - }, "GoogleCloudAssuredworkloadsV1beta1Rule": { "description": "A rule in the cloud control.", "id": "GoogleCloudAssuredworkloadsV1beta1Rule", diff --git a/discovery/auditmanager-v1.json b/discovery/auditmanager-v1.json index 833b1adf61..8c3350f4cf 100644 --- a/discovery/auditmanager-v1.json +++ b/discovery/auditmanager-v1.json @@ -33,6 +33,11 @@ "description": "Regional Endpoint", "endpointUrl": "https://auditmanager.asia-south1.rep.googleapis.com/", "location": "asia-south1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://auditmanager.me-central2.rep.googleapis.com/", + "location": "me-central2" } ], "fullyEncodeReservedExpansion": true, @@ -1885,7 +1890,7 @@ } } }, - "revision": "20260908", + "revision": "20261007", "rootUrl": "https://auditmanager.googleapis.com/", "schemas": { "AuditReport": { diff --git a/discovery/backupdr-v1.json b/discovery/backupdr-v1.json index de6963a7f9..b619f0f78e 100644 --- a/discovery/backupdr-v1.json +++ b/discovery/backupdr-v1.json @@ -2725,7 +2725,7 @@ } } }, - "revision": "20260918", + "revision": "20261002", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -3906,7 +3906,8 @@ "ACTIVE", "DELETING", "INACTIVE", - "UPDATING" + "UPDATING", + "PAUSED" ], "enumDescriptions": [ "State not set.", @@ -3914,7 +3915,8 @@ "The resource has been created and is fully usable.", "The resource is being deleted.", "The resource has been created but is not usable.", - "The resource is being updated." + "The resource is being updated.", + "The resource has been created but backups are paused." ], "readOnly": true, "type": "string" @@ -4686,12 +4688,14 @@ "enum": [ "BACKUP_CONFIG_STATE_UNSPECIFIED", "ACTIVE", - "PASSIVE" + "PASSIVE", + "PAUSED" ], "enumDescriptions": [ "The possible states of backup configuration. Status not set.", "The data source is actively protected (i.e. there is a BackupPlanAssociation or Appliance SLA pointing to it)", - "The data source is no longer protected (but may have backups under it)" + "The data source is no longer protected (but may have backups under it)", + "The data source has been created but backups are paused" ], "readOnly": true, "type": "string" @@ -4934,12 +4938,14 @@ "enum": [ "BACKUP_CONFIG_STATE_UNSPECIFIED", "ACTIVE", - "PASSIVE" + "PASSIVE", + "PAUSED" ], "enumDescriptions": [ "The possible states of backup configuration. Status not set.", "The data source is actively protected (i.e. there is a BackupPlanAssociation or Appliance SLA pointing to it)", - "The data source is no longer protected (but may have backups under it)" + "The data source is no longer protected (but may have backups under it)", + "The data source has been created but backups are paused" ], "readOnly": true, "type": "string" @@ -6995,12 +7001,14 @@ "enum": [ "BACKUP_CONFIG_STATE_UNSPECIFIED", "ACTIVE", - "PASSIVE" + "PASSIVE", + "PAUSED" ], "enumDescriptions": [ "The possible states of backup configuration. Status not set.", "The data source is actively protected (i.e. there is a BackupPlanAssociation or Appliance SLA pointing to it)", - "The data source is no longer protected (but may have backups under it)" + "The data source is no longer protected (but may have backups under it)", + "The data source has been created but backups are paused" ], "readOnly": true, "type": "string" diff --git a/discovery/backupdr-v1beta.json b/discovery/backupdr-v1beta.json index 2183dbbe81..ed57b7f2d9 100644 --- a/discovery/backupdr-v1beta.json +++ b/discovery/backupdr-v1beta.json @@ -3179,7 +3179,7 @@ } } }, - "revision": "20260918", + "revision": "20261002", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -5450,12 +5450,14 @@ "enum": [ "BACKUP_CONFIG_STATE_UNSPECIFIED", "ACTIVE", - "PASSIVE" + "PASSIVE", + "PAUSED" ], "enumDescriptions": [ "The possible states of backup configuration. Status not set.", "The data source is actively protected (i.e. there is a BackupPlanAssociation or Appliance SLA pointing to it)", - "The data source is no longer protected (but may have backups under it)" + "The data source is no longer protected (but may have backups under it)", + "The data source has been created but backups are paused" ], "readOnly": true, "type": "string" @@ -5698,12 +5700,14 @@ "enum": [ "BACKUP_CONFIG_STATE_UNSPECIFIED", "ACTIVE", - "PASSIVE" + "PASSIVE", + "PAUSED" ], "enumDescriptions": [ "The possible states of backup configuration. Status not set.", "The data source is actively protected (i.e. there is a BackupPlanAssociation or Appliance SLA pointing to it)", - "The data source is no longer protected (but may have backups under it)" + "The data source is no longer protected (but may have backups under it)", + "The data source has been created but backups are paused" ], "readOnly": true, "type": "string" @@ -7889,12 +7893,14 @@ "enum": [ "BACKUP_CONFIG_STATE_UNSPECIFIED", "ACTIVE", - "PASSIVE" + "PASSIVE", + "PAUSED" ], "enumDescriptions": [ "The possible states of backup configuration. Status not set.", "The data source is actively protected (i.e. there is a BackupPlanAssociation or Appliance SLA pointing to it)", - "The data source is no longer protected (but may have backups under it)" + "The data source is no longer protected (but may have backups under it)", + "The data source has been created but backups are paused" ], "readOnly": true, "type": "string" diff --git a/discovery/biglake-v1.json b/discovery/biglake-v1.json index e06c9e5525..cc5747b1a0 100644 --- a/discovery/biglake-v1.json +++ b/discovery/biglake-v1.json @@ -513,6 +513,100 @@ ] } } + }, + "views": { + "methods": { + "getIamPolicy": { + "description": "Gets the IAM policy for the specified View.", + "flatPath": "v1/projects/{projectsId}/catalogs/{catalogsId}/namespaces/{namespacesId}/views/{viewsId}:getIamPolicy", + "httpMethod": "GET", + "id": "biglake.projects.catalogs.namespaces.views.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/[^/]+/catalogs/[^/]+/namespaces/[^/]+/views/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/bigquery", + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the IAM policy for the specified view.", + "flatPath": "v1/projects/{projectsId}/catalogs/{catalogsId}/namespaces/{namespacesId}/views/{viewsId}:setIamPolicy", + "httpMethod": "POST", + "id": "biglake.projects.catalogs.namespaces.views.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/[^/]+/catalogs/[^/]+/namespaces/[^/]+/views/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/bigquery", + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Tests the IAM permissions for the specified view.", + "flatPath": "v1/projects/{projectsId}/catalogs/{catalogsId}/namespaces/{namespacesId}/views/{viewsId}:testIamPermissions", + "httpMethod": "POST", + "id": "biglake.projects.catalogs.namespaces.views.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/[^/]+/catalogs/[^/]+/namespaces/[^/]+/views/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/bigquery", + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } } @@ -1024,7 +1118,7 @@ } } }, - "revision": "20261002", + "revision": "20261007", "rootUrl": "https://biglake.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/discovery/chromemanagement-v1.json b/discovery/chromemanagement-v1.json index 3dbc451bb9..73f7c37eba 100644 --- a/discovery/chromemanagement-v1.json +++ b/discovery/chromemanagement-v1.json @@ -510,6 +510,153 @@ } } }, + "chromeBrowsers": { + "methods": { + "delete": { + "description": "Deletes the data collected from a Chrome browser profile.", + "flatPath": "v1/customers/{customersId}/chromeBrowsers/{chromeBrowsersId}", + "httpMethod": "DELETE", + "id": "chromemanagement.customers.chromeBrowsers.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Format: customers/{customer_id}/chromeBrowsers/{browser_permanent_id}", + "location": "path", + "pattern": "^customers/[^/]+/chromeBrowsers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleProtobufEmpty" + } + }, + "get": { + "description": "Retrieves a single Chrome Browser identified by its customer ID and resource ID.", + "flatPath": "v1/customers/{customersId}/chromeBrowsers/{chromeBrowsersId}", + "httpMethod": "GET", + "id": "chromemanagement.customers.chromeBrowsers.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Format: customers/{customer_id}/chromeBrowsers/{browser_permanent_id}", + "location": "path", + "pattern": "^customers/[^/]+/chromeBrowsers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleChromeManagementVersionsV1ChromeBrowser" + } + }, + "list": { + "description": "Retrieves all Chrome Browsers of a customer (paginated).", + "flatPath": "v1/customers/{customersId}/chromeBrowsers", + "httpMethod": "GET", + "id": "chromemanagement.customers.chromeBrowsers.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. The filter used to filter browsers. The following fields can be used in the filter: * `browser_permanent_id` * `last_policy_fetch_time` * `os_platform` * `os_architecture` * `os_version` * `machine_name` * `annotated_location` * `annotated_user` * `annotated_asset_id` * `annotated_note` * `org_unit_path` * `org_unit_id` * `last_registration_time` * `os_platform_version` * `browser_version` * `last_status_report_time` * `extension_count` * `policy_count` * `last_device_user` * `last_activity_time` * `device_id_collision` The following functions can be used in the filter: * `in_group(string)`: Filters browsers that belong to the specified Cloud Identity group resource name (e.g. `in_group(\"groups/{group_id}\")`). Any of the above fields or functions can be used to specify a filter, and filtering by multiple fields or functions is supported with AND operator. String type, Integer type fields and enum type fields support `=` and `:` operators. The timestamp type fields support `=`, `<=` and `>=` operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard `*` is only supported for `machine_name`, `annotated_asset_id`, and `browser_version`. In addition, global string literal filtering without a field name is supported: a single term (e.g., `ABC`) matches if any indexed string field contains `ABC`, and multiple terms joined by `AND` or whitespace (e.g., `machine AND 73` or `machine 73`) match browsers where every term appears in at least one indexed string field (whereas a single quoted phrase like `\"machine 73\"` matches the contiguous phrase within a single field).", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Optional. The fields used to specify the ordering of the results. The supported fields are: * `browser_permanent_id` * `last_sync` * `annotated_user` * `annotated_location` * `annotated_asset_id` * `annotated_notes` * `org_unit_path` * `os_version` * `enrollment_date` * `extension_count` * `policy_count` * `last_signed_in_user` * `machine_name` * `browser_version_channel` * `os_platform_version` * `last_activity_time` * `browser_version` By default, sorting is in ascending order, to specify descending order for a field, a suffix ` desc` should be added to the field name. The default ordering is the descending order of `last_status_report_time`.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Maximum number of results to return. Maximum and default are 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Token to specify next page in the list.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Format: customers/{customer_id}", + "location": "path", + "pattern": "^customers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/chromeBrowsers", + "response": { + "$ref": "GoogleChromeManagementVersionsV1ListChromeBrowsersResponse" + } + }, + "move": { + "description": "Moves managed Chrome Browsers to a new Organizational Unit (OU). If there is an error while moving any of the browsers, none of the browsers will be moved.", + "flatPath": "v1/customers/{customersId}/chromeBrowsers:move", + "httpMethod": "POST", + "id": "chromemanagement.customers.chromeBrowsers.move", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Format: customers/{customer_id}", + "location": "path", + "pattern": "^customers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/chromeBrowsers:move", + "request": { + "$ref": "GoogleChromeManagementVersionsV1MoveChromeBrowsersRequest" + }, + "response": { + "$ref": "GoogleChromeManagementVersionsV1MoveChromeBrowsersResponse" + } + }, + "patch": { + "description": "Updates annotation information for a Chrome Browser.", + "flatPath": "v1/customers/{customersId}/chromeBrowsers/{chromeBrowsersId}", + "httpMethod": "PATCH", + "id": "chromemanagement.customers.chromeBrowsers.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Format: customers/{customer_id}/chromeBrowsers/{browser_permanent_id}", + "location": "path", + "pattern": "^customers/[^/]+/chromeBrowsers/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The update mask that can be used to specify which fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "GoogleChromeManagementVersionsV1ChromeBrowser" + }, + "response": { + "$ref": "GoogleChromeManagementVersionsV1ChromeBrowser" + } + } + } + }, "connectorConfigs": { "methods": { "create": { @@ -652,6 +799,125 @@ } } }, + "enrollmentTokens": { + "methods": { + "create": { + "description": "Creates a new enrollment token for a browser device. Creation fails if there is already an active token for this customer under the same org unit.", + "flatPath": "v1/customers/{customersId}/enrollmentTokens", + "httpMethod": "POST", + "id": "chromemanagement.customers.enrollmentTokens.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "enrollmentTokenId": { + "description": "Optional. The ID to use for the enrollment token, which will become the final component of the enrollment token's resource name. This value must be local-unique under the customer and is optional. If not provided, it will be auto-generated. If provided, it must be 1-63 characters long and match the regular expression `[a-zA-Z0-9._-]+`.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource where this enrollment token will be created. Format: customers/{customer}", + "location": "path", + "pattern": "^customers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/enrollmentTokens", + "request": { + "$ref": "GoogleChromeManagementVersionsV1EnrollmentToken" + }, + "response": { + "$ref": "GoogleChromeManagementVersionsV1EnrollmentToken" + } + }, + "get": { + "description": "Gets a browser device enrollment token.", + "flatPath": "v1/customers/{customersId}/enrollmentTokens/{enrollmentTokensId}", + "httpMethod": "GET", + "id": "chromemanagement.customers.enrollmentTokens.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the enrollment token to retrieve. Format: customers/{customer}/enrollmentTokens/{token_permanent_id}", + "location": "path", + "pattern": "^customers/[^/]+/enrollmentTokens/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleChromeManagementVersionsV1EnrollmentToken" + } + }, + "list": { + "description": "Lists all browser device enrollment tokens.", + "flatPath": "v1/customers/{customersId}/enrollmentTokens", + "httpMethod": "GET", + "id": "chromemanagement.customers.enrollmentTokens.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Filter to apply to list results. The following fields can be used in the filter: * device_type (currently only 'CHROME_BROWSER' is supported) * token_state (supported values: 'ACTIVE', 'EXPIRED', 'REVOKED') * org_unit_path The full path of the org unit, such as /Montreal/Sales. * org_unit_id The obfuscated id of the org unit, not the full path.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. Maximum number of results to return. Maximum and default are 100.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Token to specify next page in the list.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource where this enrollment token will be created. Format: customers/{customer}", + "location": "path", + "pattern": "^customers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/enrollmentTokens", + "response": { + "$ref": "GoogleChromeManagementVersionsV1ListEnrollmentTokensResponse" + } + }, + "revoke": { + "description": "Revokes a browser device enrollment token.", + "flatPath": "v1/customers/{customersId}/enrollmentTokens/{enrollmentTokensId}:revoke", + "httpMethod": "POST", + "id": "chromemanagement.customers.enrollmentTokens.revoke", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the enrollment token to revoke. Format: customers/{customer}/enrollmentTokens/{token_permanent_id}", + "location": "path", + "pattern": "^customers/[^/]+/enrollmentTokens/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:revoke", + "request": { + "$ref": "GoogleChromeManagementVersionsV1RevokeEnrollmentTokenRequest" + }, + "response": { + "$ref": "GoogleChromeManagementVersionsV1EnrollmentToken" + } + } + } + }, "enterprise": { "resources": { "securityInsights": { @@ -2557,7 +2823,7 @@ } } }, - "revision": "20260930", + "revision": "20261008", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -6941,6 +7207,93 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1Browser": { + "description": "A specific installation of Chrome on a device with managed Chrome browsers.", + "id": "GoogleChromeManagementVersionsV1Browser", + "properties": { + "browserVersion": { + "description": "Output only. Browser version installed.", + "readOnly": true, + "type": "string" + }, + "channel": { + "description": "Output only. The channel of the browser installed.", + "enum": [ + "CHANNEL_UNSPECIFIED", + "CHANNEL_STABLE", + "CHANNEL_BETA", + "CHANNEL_DEV", + "CHANNEL_CANARY" + ], + "enumDescriptions": [ + "Represents an unspecified channel.", + "Represents a stable channel.", + "Represents a beta channel.", + "Represents a dev channel.", + "Represents a canary channel." + ], + "readOnly": true, + "type": "string" + }, + "executablePath": { + "description": "Output only. The path to the Chrome.exe executable for this browser.", + "readOnly": true, + "type": "string" + }, + "lastPolicyFetchTime": { + "description": "Output only. The time when the last request to fetch policies succeeded on this Chrome browser.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "lastStatusReportTime": { + "description": "Output only. The time when the last report was received from this Chrome browser.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "pendingInstallVersion": { + "description": "Output only. Pending version of a browser is installed. This field is only set when the current active browser has a different version as in \"browser_version\".", + "readOnly": true, + "type": "string" + }, + "plugins": { + "description": "Output only. List of all plugins installed on this Chrome browser.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1Plugin" + }, + "readOnly": true, + "type": "array" + }, + "profiles": { + "description": "Output only. The list of profiles for this browser.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1Profile" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1BrowserUser": { + "description": "A Chrome browser user.", + "id": "GoogleChromeManagementVersionsV1BrowserUser", + "properties": { + "lastStatusReportTime": { + "description": "Output only. The time when this user info last reported a status.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "userName": { + "description": "Output only. The user name of the user that signed into chrome.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleChromeManagementVersionsV1CertificateProvisioningProcess": { "description": "A certificate provisioning process.", "id": "GoogleChromeManagementVersionsV1CertificateProvisioningProcess", @@ -7057,6 +7410,175 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1ChromeBrowser": { + "description": "A device with managed Chrome Browsers.", + "id": "GoogleChromeManagementVersionsV1ChromeBrowser", + "properties": { + "annotatedAssetId": { + "description": "Optional. Asset identifier as annotated by the administrator or specified during enrollment.", + "type": "string" + }, + "annotatedLocation": { + "description": "Optional. Address or location of the device as annotated by the administrator.", + "type": "string" + }, + "annotatedNotes": { + "description": "Optional. Notes about this device as annotated by the administrator.", + "type": "string" + }, + "annotatedUser": { + "description": "Optional. User of the device as annotated by the administrator.", + "type": "string" + }, + "attestationCredential": { + "$ref": "GoogleChromeManagementVersionsV1AttestationCredential", + "description": "Output only. The attestation credential used for Device Trust Connector.", + "readOnly": true + }, + "browserPermanentId": { + "description": "Output only. Unique identifier of Chrome Browser.", + "readOnly": true, + "type": "string" + }, + "browserVersions": { + "description": "Output only. List of all browser versions installed on this device.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "browsers": { + "description": "Output only. List of Chrome browsers installed on this device.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1Browser" + }, + "readOnly": true, + "type": "array" + }, + "deviceIdentifiersHistory": { + "$ref": "GoogleChromeManagementVersionsV1DeviceIdentifiersHistory", + "description": "Output only. The history of identifiers reported to this device.", + "readOnly": true + }, + "extensionCount": { + "description": "Output only. The number of distinct extensions installed on all the Chrome browsers of this device.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "lastActivityTime": { + "description": "Output only. The time of the last activity on the device device either from reporting, policy fetching or registration.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "lastDeviceUser": { + "description": "Output only. The last user who logged into a Chrome browser on this device.", + "readOnly": true, + "type": "string" + }, + "lastDeviceUsers": { + "description": "Output only. List of recent browser users, in descending order by last report time.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1BrowserUser" + }, + "readOnly": true, + "type": "array" + }, + "lastPolicyFetchTime": { + "description": "Output only. The time the last policy fetch succeeded on this device.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "lastRegistrationTime": { + "description": "Output only. The time the device last tried to register.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "lastStatusReportTime": { + "description": "Output only. The time the device last sent a status report.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "machineExtensionPolicies": { + "description": "Output only. The list of all device level policies set for extensions installed in Chrome on this device.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1ExtensionPolicy" + }, + "readOnly": true, + "type": "array" + }, + "machineName": { + "description": "Output only. Machine name.", + "readOnly": true, + "type": "string" + }, + "machinePolicies": { + "description": "Output only. The list of all device level policies set for Chrome browsers on this device.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1Policy" + }, + "readOnly": true, + "type": "array" + }, + "name": { + "description": "Identifier. Format: customers/{customer_id}/chromeBrowsers/{browser_permanent_id}", + "type": "string" + }, + "omahaRecentFetchTime": { + "description": "Output only. Recent policy fetch activity by Omaha. Not necessarily the last fetch since this field is only updated daily.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "orgUnitId": { + "description": "Output only. The obfuscated organizational unit ID of the browser.", + "readOnly": true, + "type": "string" + }, + "osArchitecture": { + "description": "Output only. Device CPU architecture.", + "readOnly": true, + "type": "string" + }, + "osPlatform": { + "description": "Output only. Device Os platform.", + "readOnly": true, + "type": "string" + }, + "osPlatformVersion": { + "description": "Output only. Device Os platform and version combined.", + "readOnly": true, + "type": "string" + }, + "osVersion": { + "description": "Output only. Device Os Version.", + "readOnly": true, + "type": "string" + }, + "policyCount": { + "description": "Output only. The number of distinct policies set on all the Chrome browsers of this device.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "serialNumber": { + "description": "Output only. The device's serial number.", + "readOnly": true, + "type": "string" + }, + "virtualDeviceId": { + "description": "Output only. The initial device id sent by the first Chrome browser that enrolled this device.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleChromeManagementVersionsV1ChromeBrowserProfile": { "description": "A representation of a Chrome browser profile.", "id": "GoogleChromeManagementVersionsV1ChromeBrowserProfile", @@ -7630,6 +8152,78 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1DeviceIdentifiers": { + "description": "Collection of device identifiers.", + "id": "GoogleChromeManagementVersionsV1DeviceIdentifiers", + "properties": { + "hostName": { + "description": "Output only. The device's host name.", + "readOnly": true, + "type": "string" + }, + "machineName": { + "description": "Output only. The name of the machine associated with the device.", + "readOnly": true, + "type": "string" + }, + "serialNumber": { + "description": "Output only. The device's serial number.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1DeviceIdentifiersHistory": { + "description": "History of device identifiers reported from a device.", + "id": "GoogleChromeManagementVersionsV1DeviceIdentifiersHistory", + "properties": { + "deviceIdCollision": { + "description": "Output only. The device id is potentially being used by multiple devices.", + "readOnly": true, + "type": "boolean" + }, + "lastDeviceIdCollisionDetectionTime": { + "description": "Output only. The last time we detected the device id collision.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "records": { + "description": "Output only. List of device identifiers sent by this device. In descending order by last_activity_time.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1DeviceIdentifiersRecord" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1DeviceIdentifiersRecord": { + "description": "Record of the device identifiers and when they were reported.", + "id": "GoogleChromeManagementVersionsV1DeviceIdentifiersRecord", + "properties": { + "firstRecordTime": { + "description": "Output only. The first time these identifiers were reported.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "identifiers": { + "$ref": "GoogleChromeManagementVersionsV1DeviceIdentifiers", + "description": "Output only. Device identifiers.", + "readOnly": true + }, + "lastActivityTime": { + "description": "Output only. The time of the last activity of these identifiers either from reporting, policy fetching or registration.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleChromeManagementVersionsV1DeviceInfo": { "description": "Information of a device that runs a Chrome browser profile.", "id": "GoogleChromeManagementVersionsV1DeviceInfo", @@ -7790,6 +8384,248 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1EnrollmentToken": { + "description": "Enrollment token for a chrome device.", + "id": "GoogleChromeManagementVersionsV1EnrollmentToken", + "properties": { + "createTime": { + "description": "Output only. The creation time of the token.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "creatorId": { + "description": "Output only. The id of the user who created the token.", + "readOnly": true, + "type": "string" + }, + "customerId": { + "description": "Output only. The obfuscated ID of the customer to whom this token is associated.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Identifier. The resource name of the enrollment token. Format: customers/{customer}/enrollmentTokens/{token_permanent_id}", + "type": "string" + }, + "orgUnitId": { + "description": "Optional. Obfuscated ID of the organization unit this token is associated with. If not set, the token is created for the root organization unit.", + "type": "string" + }, + "revokeTime": { + "description": "Output only. The revocation time of the token, null if the token is not revoked.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "revokerId": { + "description": "Output only. The id of the user who revoked the token, null if the token is not revoked.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The state of the token.", + "enum": [ + "ENROLLMENT_TOKEN_STATE_UNSPECIFIED", + "ENROLLMENT_TOKEN_STATE_ACTIVE", + "ENROLLMENT_TOKEN_STATE_EXPIRED", + "ENROLLMENT_TOKEN_STATE_REVOKED" + ], + "enumDescriptions": [ + "Unknown token state.", + "The token is still active and valid.", + "The token has expired.", + "The token has been revoked by user." + ], + "readOnly": true, + "type": "string" + }, + "token": { + "description": "Output only. The value of the token stored on the device and used to identify it to the management service handling the enrollment request.", + "readOnly": true, + "type": "string" + }, + "tokenPermanentId": { + "description": "Output only. Unique identifier of the enrollment token used to access information on tokens.", + "readOnly": true, + "type": "string" + }, + "tokenType": { + "description": "Optional. The device type this token is used for. If not set, defaults to `ENROLLMENT_TOKEN_TYPE_CHROME_BROWSER`.", + "enum": [ + "ENROLLMENT_TOKEN_TYPE_UNSPECIFIED", + "ENROLLMENT_TOKEN_TYPE_CHROME_BROWSER" + ], + "enumDescriptions": [ + "Unknown token device type.", + "The token is used to enroll a Chrome Browser device." + ], + "type": "string" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1Extension": { + "description": "Information about extensions installed on profile reported on an installed Chrome on a device with managed chrome browsers.", + "id": "GoogleChromeManagementVersionsV1Extension", + "properties": { + "appType": { + "description": "Output only. The type of the extension.", + "enum": [ + "EXTENSION_TYPE_UNSPECIFIED", + "EXTENSION", + "APP", + "THEME", + "HOSTED_APP" + ], + "enumDescriptions": [ + "Represents an unspecified extension type.", + "Represents an extension.", + "Represents an app.", + "Represents a theme.", + "Represents a hosted app." + ], + "readOnly": true, + "type": "string" + }, + "configuredAppPolicy": { + "description": "Output only. If the extension is controlled by a browser policy.", + "enum": [ + "CONFIGURED_APP_POLICY_UNSPECIFIED", + "CONFIGURED_APP_POLICY_NONE", + "CONFIGURED_APP_POLICY_SHOULD_FORCE", + "CONFIGURED_APP_POLICY_SHOULD_BLOCK" + ], + "enumDescriptions": [ + "Represents an unspecified configured app policy.", + "Represents no configured app policy.", + "Represents an extension that should be forced.", + "Represents an extension that should be blocked." + ], + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Output only. The localized description of this extension.", + "readOnly": true, + "type": "string" + }, + "disabled": { + "description": "Output only. Whether the extension is disabled.", + "readOnly": true, + "type": "boolean" + }, + "extensionId": { + "description": "Output only. The id of the extension.", + "readOnly": true, + "type": "string" + }, + "extensionName": { + "description": "Output only. The localized name of this extension as reported by Chrome.", + "readOnly": true, + "type": "string" + }, + "homepageUri": { + "description": "Output only. The URL of the homepage for this extension.", + "readOnly": true, + "type": "string" + }, + "icons": { + "description": "Output only. The list of icons available for this extension.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1ExtensionIcon" + }, + "readOnly": true, + "type": "array" + }, + "installType": { + "description": "Output only. The way the extension was installed.", + "enum": [ + "INSTALLATION_TYPE_UNSPECIFIED", + "MULTIPLE", + "NORMAL", + "ADMIN", + "DEVELOPMENT", + "SIDELOAD", + "OTHER" + ], + "enumDescriptions": [ + "Represents an unspecified installation type.", + "Represents instances of the extension having mixed installation types.", + "Represents a normal installation type.", + "Represents an installation by admin.", + "Represents a development installation type.", + "Represents a sideload installation type.", + "Represents an installation type that is not covered in the other options." + ], + "readOnly": true, + "type": "string" + }, + "manifestVersion": { + "description": "Output only. The manifest version of this extension.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "permissions": { + "description": "Output only. The list of permissions required for this extension.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "version": { + "description": "Output only. The version of the extension.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1ExtensionIcon": { + "description": "An icon of a Chrome browser extension.", + "id": "GoogleChromeManagementVersionsV1ExtensionIcon", + "properties": { + "size": { + "description": "Output only. The size of the extension icon.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "uri": { + "description": "Output only. The URL to the extension icon.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1ExtensionPolicy": { + "description": "The reported policies applied to an extension installed on a Chrome profile.", + "id": "GoogleChromeManagementVersionsV1ExtensionPolicy", + "properties": { + "extensionId": { + "description": "Output only. The id of the extension the policies are applied to.", + "readOnly": true, + "type": "string" + }, + "extensionName": { + "description": "Output only. The name of the extension the policies are applied to.", + "readOnly": true, + "type": "string" + }, + "policies": { + "description": "Output only. List of policies applied to this extension.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1Policy" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "GoogleChromeManagementVersionsV1GenericCaConnection": { "description": "Describes a generic Certificate Authority Connection.", "id": "GoogleChromeManagementVersionsV1GenericCaConnection", @@ -7879,6 +8715,24 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1ListChromeBrowsersResponse": { + "description": "Response to ListChromeBrowsers method.", + "id": "GoogleChromeManagementVersionsV1ListChromeBrowsersResponse", + "properties": { + "chromeBrowsers": { + "description": "List of Chrome Browser device objects.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1ChromeBrowser" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Token used to access next page of this result.", + "type": "string" + } + }, + "type": "object" + }, "GoogleChromeManagementVersionsV1ListConnectorConfigsResponse": { "description": "Response to ListConnectorConfigs method.", "id": "GoogleChromeManagementVersionsV1ListConnectorConfigsResponse", @@ -7897,6 +8751,24 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1ListEnrollmentTokensResponse": { + "description": "Response that contains a list of tokens.", + "id": "GoogleChromeManagementVersionsV1ListEnrollmentTokensResponse", + "properties": { + "enrollmentTokens": { + "description": "List of Chrome device enrollment tokens.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1EnrollmentToken" + }, + "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" + }, "GoogleChromeManagementVersionsV1MipLabelConfig": { "description": "MIP label connector config.", "id": "GoogleChromeManagementVersionsV1MipLabelConfig", @@ -7915,6 +8787,30 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1MoveChromeBrowsersRequest": { + "description": "Request to MoveChromeBrowsers method.", + "id": "GoogleChromeManagementVersionsV1MoveChromeBrowsersRequest", + "properties": { + "destinationOrgUnitId": { + "description": "Required. ID of the destination organizational unit.", + "type": "string" + }, + "resourceIds": { + "description": "Required. List of resource IDs of Chrome Browser Devices to move. A maximum of 600 browsers may be moved per request.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1MoveChromeBrowsersResponse": { + "description": "Response to MoveChromeBrowsers method.", + "id": "GoogleChromeManagementVersionsV1MoveChromeBrowsersResponse", + "properties": {}, + "type": "object" + }, "GoogleChromeManagementVersionsV1MoveThirdPartyProfileUserRequest": { "description": "Request to MoveThirdPartyProfileUser method.", "id": "GoogleChromeManagementVersionsV1MoveThirdPartyProfileUserRequest", @@ -7957,6 +8853,147 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1Plugin": { + "description": "Information about a Chrome browser plugin installed on a reported Chrome installation on a device with managed Chrome browsers.", + "id": "GoogleChromeManagementVersionsV1Plugin", + "properties": { + "description": { + "description": "Output only. The description of the installed plugin.", + "readOnly": true, + "type": "string" + }, + "filename": { + "description": "Output only. The filename of the installed plugin.", + "readOnly": true, + "type": "string" + }, + "pluginName": { + "description": "Output only. The name of the installed plugin.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1Policy": { + "description": "The applied policy reported by a managed Chrome browser. The policy can be applied at various scopes (machine, profile, extension).", + "id": "GoogleChromeManagementVersionsV1Policy", + "properties": { + "error": { + "description": "Output only. A localized string with all the errors reported when trying to apply this policy, if any.", + "readOnly": true, + "type": "string" + }, + "policyName": { + "description": "Output only. The name of the policy.", + "readOnly": true, + "type": "string" + }, + "source": { + "description": "Output only. The source of the policy.", + "enum": [ + "POLICY_SOURCE_UNSPECIFIED", + "MACHINE_PLATFORM", + "USER_PLATFORM", + "MACHINE_LEVEL_USER_CLOUD", + "USER_CLOUD", + "MACHINE_MERGED" + ], + "enumDescriptions": [ + "Represents an unspecified policy source.", + "Represents a machine level platform policy.", + "Represents a user level platform policy.", + "Represents a machine level user cloud policy.", + "Represents a user level cloud policy.", + "Represents a machine level merged policy." + ], + "readOnly": true, + "type": "string" + }, + "value": { + "description": "Output only. The value of the policy.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "GoogleChromeManagementVersionsV1Profile": { + "description": "A profile reported on an installation of Chrome on a device with managed chrome browsers.", + "id": "GoogleChromeManagementVersionsV1Profile", + "properties": { + "chromeSignedInUserEmail": { + "description": "Output only. The email of the user signed in to this profile, if any.", + "readOnly": true, + "type": "string" + }, + "extensionPolicies": { + "description": "Output only. The list of extensions with applied extension policies.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1ExtensionPolicy" + }, + "readOnly": true, + "type": "array" + }, + "extensions": { + "description": "Output only. The list of extensions installed for this profile.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1Extension" + }, + "readOnly": true, + "type": "array" + }, + "id": { + "description": "Output only. A unique ID for this profile.", + "readOnly": true, + "type": "string" + }, + "lastPolicyFetchTime": { + "description": "Output only. The time when the last request to fetch policies succeeded for this profile.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "lastStatusReportTime": { + "description": "Output only. The time when the last report was received from this profile.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "profileName": { + "description": "Output only. The name given to this profile.", + "readOnly": true, + "type": "string" + }, + "safeBrowsingWarnings": { + "description": "Output only. The number of safe browsing warnings that were shown on this profile.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "safeBrowsingWarningsClickThroughs": { + "description": "Output only. The number of safe browsing warnings that were clicked through on this profile.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "safeBrowsingWarningsResetTime": { + "description": "Output only. The last time the safe browsing warning info was reset to 0.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "userPolicies": { + "description": "Output only. The list of Chrome browser policies applied to this profile.", + "items": { + "$ref": "GoogleChromeManagementVersionsV1Policy" + }, + "readOnly": true, + "type": "array" + } + }, + "type": "object" + }, "GoogleChromeManagementVersionsV1PubSubConfig": { "description": "Pub/Sub connector config.", "id": "GoogleChromeManagementVersionsV1PubSubConfig", @@ -8391,6 +9428,12 @@ }, "type": "object" }, + "GoogleChromeManagementVersionsV1RevokeEnrollmentTokenRequest": { + "description": "Request to revoke a token.", + "id": "GoogleChromeManagementVersionsV1RevokeEnrollmentTokenRequest", + "properties": {}, + "type": "object" + }, "GoogleChromeManagementVersionsV1ScepCaConnection": { "description": "Describes a SCEP Certificate Authority Connection.", "id": "GoogleChromeManagementVersionsV1ScepCaConnection", diff --git a/discovery/cloudscheduler-v1.json b/discovery/cloudscheduler-v1.json index c435d27a08..bd4c8a9fb9 100644 --- a/discovery/cloudscheduler-v1.json +++ b/discovery/cloudscheduler-v1.json @@ -16,11 +16,36 @@ "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/scheduler/", "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-central2.rep.googleapis.com/", + "location": "us-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-east1.rep.googleapis.com/", + "location": "us-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-east4.rep.googleapis.com/", + "location": "us-east4" + }, { "description": "Regional Endpoint", "endpointUrl": "https://cloudscheduler.us-east7.rep.googleapis.com/", "location": "us-east7" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-south1.rep.googleapis.com/", + "location": "us-south1" + }, { "description": "Regional Endpoint", "endpointUrl": "https://cloudscheduler.us-west1.rep.googleapis.com/", @@ -35,6 +60,11 @@ "description": "Regional Endpoint", "endpointUrl": "https://cloudscheduler.us-west3.rep.googleapis.com/", "location": "us-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-west4.rep.googleapis.com/", + "location": "us-west4" } ], "fullyEncodeReservedExpansion": true, @@ -633,7 +663,7 @@ } } }, - "revision": "20260922", + "revision": "20261004", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { diff --git a/discovery/cloudscheduler-v1beta1.json b/discovery/cloudscheduler-v1beta1.json index 3c258c9973..4a536c7d08 100644 --- a/discovery/cloudscheduler-v1beta1.json +++ b/discovery/cloudscheduler-v1beta1.json @@ -16,11 +16,36 @@ "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/scheduler/", "endpoints": [ + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-central1.rep.googleapis.com/", + "location": "us-central1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-central2.rep.googleapis.com/", + "location": "us-central2" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-east1.rep.googleapis.com/", + "location": "us-east1" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-east4.rep.googleapis.com/", + "location": "us-east4" + }, { "description": "Regional Endpoint", "endpointUrl": "https://cloudscheduler.us-east7.rep.googleapis.com/", "location": "us-east7" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-south1.rep.googleapis.com/", + "location": "us-south1" + }, { "description": "Regional Endpoint", "endpointUrl": "https://cloudscheduler.us-west1.rep.googleapis.com/", @@ -35,6 +60,11 @@ "description": "Regional Endpoint", "endpointUrl": "https://cloudscheduler.us-west3.rep.googleapis.com/", "location": "us-west3" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://cloudscheduler.us-west4.rep.googleapis.com/", + "location": "us-west4" } ], "fullyEncodeReservedExpansion": true, @@ -589,7 +619,7 @@ } } }, - "revision": "20260922", + "revision": "20261004", "rootUrl": "https://cloudscheduler.googleapis.com/", "schemas": { "AppEngineHttpTarget": { diff --git a/discovery/compute-alpha.json b/discovery/compute-alpha.json index b8edc6be91..b88b841282 100644 --- a/discovery/compute-alpha.json +++ b/discovery/compute-alpha.json @@ -26182,56 +26182,6 @@ } } }, - "orgVmExtensionPolicies": { - "methods": { - "delete": { - "description": "Deletes a specified zone VM extension policy within an organization.", - "flatPath": "organizations/{organizationsId}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", - "httpMethod": "DELETE", - "id": "compute.orgVmExtensionPolicies.delete", - "parameterOrder": [ - "organization", - "zone", - "vmExtensionPolicy" - ], - "parameters": { - "organization": { - "description": "Organization ID for this request.", - "location": "path", - "pattern": "organizations/[0-9]{0,20}", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "vmExtensionPolicy": { - "description": "Name of the zone VM extension policy to delete.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "location": "path", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "required": true, - "type": "string" - } - }, - "path": "{+organization}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ] - } - } - }, "organizationGlobalVmExtensionPolicies": { "methods": { "aggregatedList": { @@ -27723,6 +27673,52 @@ }, "organizationZoneVmExtensionPolicies": { "methods": { + "delete": { + "description": "Deletes a specified zone VM extension policy within an organization.", + "flatPath": "organizations/{organizationsId}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", + "httpMethod": "DELETE", + "id": "compute.organizationZoneVmExtensionPolicies.delete", + "parameterOrder": [ + "organization", + "zone", + "vmExtensionPolicy" + ], + "parameters": { + "organization": { + "description": "Organization ID for this request.", + "location": "path", + "pattern": "organizations/[0-9]{0,20}", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.\n\nFor example, consider a situation where you make an initial request and\nthe request times out. If you make the request again with the same\nrequest ID, the server can check if original operation with the same\nrequest ID was received, and if so, will ignore the second request. This\nprevents clients from accidentally creating duplicate commitments.\n\nThe request ID must be\na valid UUID with the exception that zero UUID is not supported\n(00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "vmExtensionPolicy": { + "description": "Name of the zone VM extension policy to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "{+organization}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, "get": { "description": "Retrieves details of a specific zone VM extension policy within an\norganization.", "flatPath": "organizations/{organizationsId}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}", @@ -58444,7 +58440,7 @@ } } }, - "revision": "20260922", + "revision": "20261007", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -81104,11 +81100,13 @@ "localSsdEncryptionMode": { "description": "Specifies which method should be used for encrypting the\nLocal SSDs attached to the VM.", "enum": [ + "CMEK_ENCRYPTION", "EPHEMERAL_KEY_ENCRYPTION", "LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", "STANDARD_ENCRYPTION" ], "enumDescriptions": [ + "The given VM will use customer-managed encryption keys for\nencryption of Local SSDs.", "The given VM will opt-in for using ephemeral key for\nencryption of Local SSDs.\nThe Local SSDs will not be able to recover data in case of VM\ncrash.", "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted.", "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted." @@ -85687,11 +85685,13 @@ "localSsdEncryptionMode": { "description": "Specifies which method should be used for encrypting the\nLocal SSDs attached to the VM.", "enum": [ + "CMEK_ENCRYPTION", "EPHEMERAL_KEY_ENCRYPTION", "LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", "STANDARD_ENCRYPTION" ], "enumDescriptions": [ + "The given VM will use customer-managed encryption keys for\nencryption of Local SSDs.", "The given VM will opt-in for using ephemeral key for\nencryption of Local SSDs.\nThe Local SSDs will not be able to recover data in case of VM\ncrash.", "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted.", "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted." diff --git a/discovery/compute-beta.json b/discovery/compute-beta.json index e31908d44b..260b362d6d 100644 --- a/discovery/compute-beta.json +++ b/discovery/compute-beta.json @@ -54393,7 +54393,7 @@ } } }, - "revision": "20260922", + "revision": "20261007", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -61360,6 +61360,7 @@ "STORAGE_OPTIMIZED_Z4D4T", "STORAGE_OPTIMIZED_Z4DH", "STORAGE_OPTIMIZED_Z4DS", + "STORAGE_OPTIMIZED_Z4M", "TYPE_UNSPECIFIED" ], "enumDescriptions": [ @@ -61409,6 +61410,7 @@ "CUD bucket for Z4D-4T machines.", "CUD bucket for Z4DH machines.", "CUD bucket for Z4DS machines.", + "CUD bucket for Z4M (bare metal) machines.", "Note for internal users: When adding a new enum Type for v1, make sure\nto also add it in the comment for the `optional Type type` definition.\nThis ensures that the public documentation displays the new enum Type." ], "type": "string" @@ -74418,11 +74420,13 @@ "localSsdEncryptionMode": { "description": "Specifies which method should be used for encrypting the\nLocal SSDs attached to the VM.", "enum": [ + "CMEK_ENCRYPTION", "EPHEMERAL_KEY_ENCRYPTION", "LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", "STANDARD_ENCRYPTION" ], "enumDescriptions": [ + "The given VM will use customer-managed encryption keys for\nencryption of Local SSDs.", "The given VM will opt-in for using ephemeral key for\nencryption of Local SSDs.\nThe Local SSDs will not be able to recover data in case of VM\ncrash.", "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted.", "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted." @@ -78752,11 +78756,13 @@ "localSsdEncryptionMode": { "description": "Specifies which method should be used for encrypting the\nLocal SSDs attached to the VM.", "enum": [ + "CMEK_ENCRYPTION", "EPHEMERAL_KEY_ENCRYPTION", "LOCAL_SSD_ENCRYPTION_MODE_UNSPECIFIED", "STANDARD_ENCRYPTION" ], "enumDescriptions": [ + "The given VM will use customer-managed encryption keys for\nencryption of Local SSDs.", "The given VM will opt-in for using ephemeral key for\nencryption of Local SSDs.\nThe Local SSDs will not be able to recover data in case of VM\ncrash.", "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted.", "The given VM will be encrypted using keys managed by the cloud\ninfrastructure and the keys will be deleted when the VM is\ndeleted." diff --git a/discovery/compute-preview.json b/discovery/compute-preview.json index 8fad50dd2c..db63f2b75b 100644 --- a/discovery/compute-preview.json +++ b/discovery/compute-preview.json @@ -1357,6 +1357,204 @@ } } }, + "aliasNetworkEndpoints": { + "methods": { + "delete": { + "apiVersion": "2026-10-01-preview", + "description": "Deletes the specified AliasNetworkEndpoint.", + "flatPath": "projects/{project}/zones/{zone}/aliasNetworkEndpoints/{aliasNetworkEndpoint}", + "httpMethod": "DELETE", + "id": "compute.aliasNetworkEndpoints.delete", + "parameterOrder": [ + "project", + "zone", + "aliasNetworkEndpoint" + ], + "parameters": { + "aliasNetworkEndpoint": { + "description": "Required. Name of the AliasNetworkEndpoint resource to delete.", + "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": "Required. 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Required. Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/aliasNetworkEndpoints/{aliasNetworkEndpoint}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "get": { + "apiVersion": "2026-10-01-preview", + "description": "Returns the specified AliasNetworkEndpoint resource.", + "flatPath": "projects/{project}/zones/{zone}/aliasNetworkEndpoints/{aliasNetworkEndpoint}", + "httpMethod": "GET", + "id": "compute.aliasNetworkEndpoints.get", + "parameterOrder": [ + "project", + "zone", + "aliasNetworkEndpoint" + ], + "parameters": { + "aliasNetworkEndpoint": { + "description": "Required. Name of the AliasNetworkEndpoint resource to return.", + "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": "Required. 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" + }, + "zone": { + "description": "Required. Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/aliasNetworkEndpoints/{aliasNetworkEndpoint}", + "response": { + "$ref": "AliasNetworkEndpoint" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + }, + "insert": { + "apiVersion": "2026-10-01-preview", + "description": "Creates an AliasNetworkEndpoint in the specified project and zone\nusing the data included in the request.", + "flatPath": "projects/{project}/zones/{zone}/aliasNetworkEndpoints", + "httpMethod": "POST", + "id": "compute.aliasNetworkEndpoints.insert", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "project": { + "description": "Required. 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\nthat if you must retry your request, the server will know to ignore the\nrequest if it has already been completed.", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Required. Name of the zone scoping this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/aliasNetworkEndpoints", + "request": { + "$ref": "AliasNetworkEndpoint" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ] + }, + "list": { + "apiVersion": "2026-10-01-preview", + "description": "Retrieves a list of AliasNetworkEndpoints available to the specified\nproject.", + "flatPath": "projects/{project}/zones/{zone}/aliasNetworkEndpoints", + "httpMethod": "GET", + "id": "compute.aliasNetworkEndpoints.list", + "parameterOrder": [ + "project", + "zone" + ], + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most\nCompute resources support two types of filter expressions:\nexpressions that support regular expressions and expressions that follow\nAPI improvement proposal AIP-160.\nThese two types of filter expressions cannot be mixed in one request.\n\nIf you want to use AIP-160, your expression must specify the field name, an\noperator, and the value that you want to use for filtering. The value\nmust be a string, a number, or a boolean. The operator\nmust be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.\n\nFor example, if you are filtering Compute Engine instances, you can\nexclude instances named `example-instance` by specifying\n`name != example-instance`.\n\nThe `:*` comparison can be used to test whether a key has been defined.\nFor example, to find all objects with `owner` label use:\n```\nlabels.owner:*\n```\n\nYou can also filter nested fields. For example, you could specify\n`scheduling.automaticRestart = false` to include instances only\nif they are not scheduled for automatic restarts. You can use filtering\non nested fields to filter based onresource labels.\n\nTo filter on multiple expressions, provide each separate expression within\nparentheses. For example:\n```\n(scheduling.automaticRestart = true)\n(cpuPlatform = \"Intel Skylake\")\n```\nBy default, each expression is an `AND` expression. However, you\ncan include `AND` and `OR` expressions explicitly.\nFor example:\n```\n(cpuPlatform = \"Intel Skylake\") OR\n(cpuPlatform = \"Intel Broadwell\") AND\n(scheduling.automaticRestart = true)\n```\n\nIf you want to use a regular expression, use the `eq` (equal) or `ne`\n(not equal) operator against a single un-parenthesized expression with or\nwithout quotes or against multiple parenthesized expressions. Examples:\n\n`fieldname eq unquoted literal`\n`fieldname eq 'single quoted literal'`\n`fieldname eq \"double quoted literal\"`\n`(fieldname1 eq literal) (fieldname2 ne \"literal\")`\n\nThe literal value is interpreted as a regular expression using GoogleRE2 library syntax.\nThe literal value must match the entire field.\n\nFor example, to filter for instances that do not end with name \"instance\",\nyou would use `name ne .*instance`.\n\nYou cannot combine constraints on multiple fields using regular\nexpressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "default": "500", + "description": "The maximum number of results per page that should be returned.\nIf the number of available results is larger than `maxResults`,\nCompute Engine returns a `nextPageToken` that can be used to get\nthe next page of results in subsequent list requests. Acceptable values are\n`0` to `500`, inclusive. (Default: `500`)", + "format": "uint32", + "location": "query", + "minimum": "0", + "type": "integer" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results\nare returned in alphanumerical order based on the resource name.\n\nYou can also sort results in descending order based on the creation\ntimestamp using `orderBy=\"creationTimestamp desc\"`. This sorts\nresults based on the `creationTimestamp` field in\nreverse chronological order (newest result first). Use this to sort\nresources like operations so that the newest operation is returned first.\n\nCurrently, only sorting by `name` or\n`creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the\n`nextPageToken` returned by a previous list request to get\nthe next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Required. 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" + }, + "zone": { + "description": "Required. Name of the zone of this request.", + "location": "path", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "required": true, + "type": "string" + } + }, + "path": "projects/{project}/zones/{zone}/aliasNetworkEndpoints", + "response": { + "$ref": "AliasNetworkEndpointList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ] + } + } + }, "autoscalers": { "methods": { "aggregatedList": { @@ -50023,7 +50221,7 @@ } } }, - "revision": "20260922", + "revision": "20261007", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -50923,6 +51121,10 @@ "format": "int32", "type": "integer" }, + "ipCollection": { + "description": "Reference to the source of external IPv4 addresses,\nlike a PublicDelegatedPrefix (PDP) for BYOIP.\nThe PDP must support enhanced IPv4 allocations.\n\nUse one of the following formats to specify a PDP when allocating an\nexternal IPv4 address using BYOIP.\n \n - \n Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name\n - \n Partial URL, as in\n \n \n - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name\n - regions/region/publicDelegatedPrefixes/pdp-name", + "type": "string" + }, "kind": { "default": "compute#accessConfig", "description": "Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.", @@ -51079,6 +51281,10 @@ "description": "The URL of the network in which to reserve the address. This field can\nonly be used with INTERNAL type with theVPC_PEERING purpose.", "type": "string" }, + "networkAttachment": { + "description": "Optional. The URL of the network attachment that this address comes from in the\nfollowing format:\nprojects/{project}/regions/{region_name}/networkAttachments/{network_attachment_name}.", + "type": "string" + }, "networkTier": { "description": "This signifies the networking tier used for configuring this address and\ncan only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier;\nglobal external IP addresses are always Premium Tier; regional external IP\naddresses can be either Standard or Premium Tier.\n\nIf this field is not specified, it is assumed to be PREMIUM.", "enum": [ @@ -51133,6 +51339,10 @@ "description": "[Output Only] Server-defined URL for the resource.", "type": "string" }, + "serviceClassId": { + "description": "Optional. Producer Service's Service class ID for the region of this address. Can\nonly be used with network_attachment. It is not possible to use on its own;\nhowever, network_attachment can be used without service_class_id.", + "type": "string" + }, "status": { "description": "Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE.\nAn address that is RESERVING is currently in the process of\nbeing reserved. A RESERVED address is currently reserved and\navailable to use. An IN_USE address is currently being used\nby another resource and is not available.", "enum": [ @@ -51681,6 +51891,334 @@ }, "type": "object" }, + "AliasNetworkEndpoint": { + "description": "Represents an Alias Network Endpoint resource.\nTo be used for GKE pod-native endpoints in Andromeda.", + "id": "AliasNetworkEndpoint", + "properties": { + "aliases": { + "additionalProperties": { + "$ref": "AliasNetworkEndpointAlias" + }, + "description": "Required. The map of network aliases allocated for the AliasNetworkEndpoint.\nThis map is keyed with user-provided alias names.", + "type": "object" + }, + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The annotations map for the AliasNetworkEndpoint.\nKeys and values must follow Kubernetes limits.\nKeys must be a maximum of 253 characters. Keys should be dot-namespaced,\nfollowing the Kubernetes annotation key format:\n`([DNS subdomain]/)?[RFC 1123 name]`.\nValues must be a maximum of 256 characters.", + "type": "object" + }, + "creationTimestamp": { + "description": "Output only. [Output Only] Creation timestamp in RFC3339 text format.", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. An optional description of this resource. Provide this field when you\ncreate the resource.", + "type": "string" + }, + "host": { + "$ref": "AliasNetworkEndpointHost", + "description": "Required. The host that the alias network endpoint is bound to." + }, + "id": { + "description": "Output only. [Output Only] The unique identifier for the resource. This identifier is\ndefined by the server.", + "format": "uint64", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. The labels map for the AliasNetworkEndpoint.", + "type": "object" + }, + "name": { + "description": "Identifier. Name of the resource. Provided by the client when the resource is created.\nThe name must be 1-63 characters long, and comply with RFC1035.", + "type": "string" + }, + "securityTagInheritance": { + "description": "Optional. The security tag inheritance setting for the AliasNetworkEndpoint.", + "enum": [ + "INHERITED", + "NOT_INHERITED", + "SECURITY_TAG_INHERITANCE_UNSPECIFIED" + ], + "enumDescriptions": [ + "Security tags are inherited directly from the host instance.", + "Security tags are not inherited from the host instance. Firewall rules\ntargeting the host instance's tags will not apply to this resource.", + "Unspecified inheritance." + ], + "type": "string" + }, + "selfLink": { + "description": "Output only. [Output Only] Server-defined URL for the resource.", + "readOnly": true, + "type": "string" + }, + "status": { + "$ref": "AliasNetworkEndpointStatus", + "description": "Output only. [Output Only] Current status of the alias network endpoint.", + "readOnly": true + }, + "subnetwork": { + "description": "Required. The URL of the subnetwork that this alias network endpoint belongs to.", + "type": "string" + }, + "updateTime": { + "description": "Output only. [Output Only] Update timestamp in RFC3339 text format.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "AliasNetworkEndpointAlias": { + "description": "Configuration for an IP alias.", + "id": "AliasNetworkEndpointAlias", + "properties": { + "effectiveIpAddress": { + "description": "Output only. [Output Only] The actual IP address allocated by the system.", + "readOnly": true, + "type": "string" + }, + "effectiveSubnetworkRangeName": { + "description": "Output only. [Output Only] The actual secondary range used for allocation.", + "readOnly": true, + "type": "string" + }, + "ipAddress": { + "description": "Input only. The IP address of the network endpoint. If specified, the server performs\na validation check for uniqueness. If the field is omitted, the system\nautomatically allocates an IP and populates the effective_ip_address\nfield.", + "type": "string" + }, + "ipVersion": { + "description": "Required. The IP version of the IP. It is IPv4 or IPv6.", + "enum": [ + "IPV4", + "IPV6", + "IP_VERSION_UNSPECIFIED" + ], + "enumDescriptions": [ + "IPv4 address.", + "IPv6 address.", + "Unspecified IP version." + ], + "type": "string" + }, + "subnetworkRangeNames": { + "description": "Input only. Defines candidate secondary ranges for allocating the alias IPs. If it is\nempty, the IP would be allocated from the primary range of the\nsubnetwork.\nThis field is INPUT_ONLY and used only during resource creation,\nhence a repeated field is acceptable as per AIP-2825. It is not mutable.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "AliasNetworkEndpointHost": { + "description": "Information about the host instance.", + "id": "AliasNetworkEndpointHost", + "properties": { + "instance": { + "description": "Required. The URL to the instance that this alias network endpoint is bound to.", + "type": "string" + } + }, + "type": "object" + }, + "AliasNetworkEndpointList": { + "description": "Response message for AliasNetworkEndpoints.List.", + "id": "AliasNetworkEndpointList", + "properties": { + "etag": { + "description": "ETag of the resource list.", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of AliasNetworkEndpoint resources.", + "items": { + "$ref": "AliasNetworkEndpoint" + }, + "type": "array" + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for\nlist requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for\nthe query parameter pageToken in the next list request.\nSubsequent list requests will have their own nextPageToken to\ncontinue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "Output only. [Output Only] Unreachable resources.", + "items": { + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute\nEngine returns NO_RESULTS_ON_PAGE if there\nare no results in the response.", + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "QUOTA_INFO_UNAVAILABLE", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ], + "enumDeprecated": [ + 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 + ], + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed\noperation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as\ndeprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as\nexperimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden.\nDeprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is\nnot of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed\nwhich captures the amount of resources filtered out by\nuser-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the\nnetwork.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an\nipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the\nsame network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite\nthe mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "Quota information is not available to client requests (e.g:\nregions.list).", + "The user attempted to use a resource that requires a TOS they have not\naccepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted\nbecause they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but\nits application does not make a lot of sense, because it allows only\nsingle instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n {\n \"key\": \"scope\",\n \"value\": \"zones/us-east1-d\"\n }]", + "items": { + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being\nreturned. For example, for warnings where there are no results in a list\nrequest for a particular zone, this key might be scope and\nthe key value might be the zone name. Other examples might be a key\nindicating a deprecated resource and a suggested replacement, or a\nwarning about invalid network settings (for example, if an instance\nattempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + } + }, + "type": "object" + } + }, + "type": "object" + }, + "AliasNetworkEndpointStatus": { + "description": "Represents the current status of the AliasNetworkEndpoint.", + "id": "AliasNetworkEndpointStatus", + "properties": { + "network": { + "description": "Output only. [Output Only] The URL of the network that this alias network endpoint\nbelongs to.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. [Output Only] The state of the alias network endpoint.", + "enum": [ + "ACTIVE", + "CREATING", + "DELETING", + "STATE_UNSPECIFIED" + ], + "enumDescriptions": [ + "The endpoint is active and ready to process traffic.", + "The endpoint is being created.", + "The endpoint is being deleted.", + "Unspecified state." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "AllocationAggregateReservation": { "description": "This reservation type is specified by total resource amounts (e.g. total\ncount of CPUs) and can account for multiple instance SKUs. In other words,\none can create instances of varying shapes against this reservation.", "id": "AllocationAggregateReservation", @@ -57074,6 +57612,12 @@ "MEMORY_OPTIMIZED_X4_480_8T", "MEMORY_OPTIMIZED_X4_960_12T", "MEMORY_OPTIMIZED_X4_960_16T", + "MEMORY_OPTIMIZED_X5_1376_24T", + "MEMORY_OPTIMIZED_X5_1376_32T", + "MEMORY_OPTIMIZED_X5_2064_48T", + "MEMORY_OPTIMIZED_X5_2752_64T", + "MEMORY_OPTIMIZED_X5_688_12T", + "MEMORY_OPTIMIZED_X5_688_16T", "NETWORK_OPTIMIZED_C4N", "NETWORK_OPTIMIZED_U4C", "NETWORK_OPTIMIZED_U4P", @@ -57125,6 +57669,12 @@ "CUD bucket for X4 machine with 480 vCPUs and 8TB of memory.", "CUD bucket for X4 machine with 960 vCPUs and 12TB of memory.", "CUD bucket for X4 machine with 960 vCPUs and 16TB of memory.", + "CUD bucket for X5 machine with 1376 vCPUs and 24TB of memory.", + "CUD bucket for X5 machine with 1376 vCPUs and 32TB of memory.", + "CUD bucket for X5 machine with 2064 vCPUs and 48TB of memory.", + "CUD bucket for X5 machine with 2752 vCPUs and 64TB of memory.", + "CUD bucket for X5 machine with 688 vCPUs and 12TB of memory.", + "CUD bucket for X5 machine with 688 vCPUs and 16TB of memory.", "CUD bucket for C4N (dual Diorite) machines.", "CUD bucket for NETWORK_OPTIMIZED_U4C machines.", "CUD bucket for NETWORK_OPTIMIZED_U4P machines.", @@ -65207,6 +65757,10 @@ "$ref": "HaControllerNetworkingAutoConfiguration", "description": "Basic networking configuration. Required backend services and forwarding\nrules will be automatically created with default parameters." }, + "params": { + "$ref": "HaControllerParams", + "description": "Input only. Additional parameters passed with the request, but not persisted as part\nof the resource. Both `params: null` and `params: {}` are treated\nidentically as a no-op." + }, "region": { "description": "Output only. [Output Only] URL of the region where the resource resides.\nYou must specify this field as part of the HTTP request URL.\nIt is not settable as a field in the request body.", "readOnly": true, @@ -65270,6 +65824,21 @@ }, "type": "object" }, + "HaControllerInstanceNetworkInterface": { + "description": "The network interface configuration of the VM instance.", + "id": "HaControllerInstanceNetworkInterface", + "properties": { + "ipv6Address": { + "description": "Optional. Optional IPv6 address to assign to the instance's network interface.\nIf omitted, an ephemeral IP may be assigned depending on the instance's\nnetwork interface stack type.", + "type": "string" + }, + "networkIP": { + "description": "Optional. Optional IPv4 address to assign to the instance's network interface.\nIf omitted, an ephemeral IP may be assigned depending on the instance's\nnetwork interface stack type.", + "type": "string" + } + }, + "type": "object" + }, "HaControllerNetworkingAutoConfiguration": { "description": "Basic networking configuration. Required backend services and forwarding\nrules will be automatically created with default parameters.", "id": "HaControllerNetworkingAutoConfiguration", @@ -65309,6 +65878,17 @@ }, "type": "object" }, + "HaControllerParams": { + "description": "Additional HA Controller params.", + "id": "HaControllerParams", + "properties": { + "migrateDisksToRegional": { + "description": "Specifies whether to automatically migrate all disks of an instance from\nzonal to regional before attempting to create the HaController.", + "type": "boolean" + } + }, + "type": "object" + }, "HaControllerStatus": { "description": "Contains information about current status of the HaController.", "id": "HaControllerStatus", @@ -65560,6 +66140,13 @@ "description": "Config for a zone that the HaController may use for running the VM\ninstance.", "id": "HaControllerZoneConfiguration", "properties": { + "instanceNetworkInterfaces": { + "additionalProperties": { + "$ref": "HaControllerInstanceNetworkInterface" + }, + "description": "Optional. The network interface configuration of a VM instance in this zone,\nkeyed by the name of the network interface. A VM network interface\nuses the nicN naming format, where N is a\nvalue between 0 and 7. The default interface\nis nic0. Use this field to choose the internal IP\naddresses of the VM instance in this zone instead of letting Compute\nEngine assign them automatically.\n \n \n - Each key must be a name of a network interface that exists on\n the VM instance. Otherwise, the request fails.\n - Network interfaces that are omitted are assigned an ephemeral\n internal IP address.\n - Every zone must configure the same network interfaces and the\n same IP address families.\n - For the zone that currently holds the VM instance, this field\n is populated automatically, and any addresses you specify must\n match the instance's current addresses.\n - Only internal IP addresses are supported, and this field can\n only be set when the HA Controller is created.", + "type": "object" + }, "nodeAffinities": { "description": "A set of node affinity configurations. Refer toConfiguring node\naffinity for more information.\nOverrides reservationAffinity.", "items": { @@ -83794,6 +84381,10 @@ "description": "The URL of the network to which all network endpoints in the NEG belong.\nFor networkEndpointType GCE_VM_IP_PORT,GCE_VM_IP_PORTMAP or NON_GCP_PRIVATE_IP_PORT,\nif this field is not specified, a default network will be used.\nThis field cannot be set for NEGs with networkEndpointType set toSERVERLESS or PRIVATE_SERVICE_CONNECT and for\nglobal NEGs.\nFor all other network endpoint types, this field is required.", "type": "string" }, + "networkAttachment": { + "description": "Optional. The URL of the network attachment that this resource\nbelongs to.projects/{project}/regions/{region_name}/networkAttachments/{network_attachment_name}.", + "type": "string" + }, "networkEndpointType": { "description": "Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.", "enum": [ @@ -83838,6 +84429,10 @@ "readOnly": true, "type": "string" }, + "serviceClassId": { + "description": "Optional. The service class ID associated with this resource.\nCan only be used with network_attachment. It is not possible to\nuse on its own; however, network_attachment can be used without\nservice_class_id.", + "type": "string" + }, "size": { "description": "Output only. [Output only] Number of network endpoints in the network endpoint group.", "format": "int32", @@ -98024,6 +98619,21 @@ "readOnly": true, "type": "string" }, + "protectionTier": { + "description": "Output only. Protection tier for the workload which specifies the workload\nexpectations in the event of infrastructure failures at data center\n(e.g. power and/or cooling failures).", + "enum": [ + "PROTECTION_TIER_CAPACITY_OPTIMIZED", + "PROTECTION_TIER_STANDARD", + "PROTECTION_TIER_UNSPECIFIED" + ], + "enumDescriptions": [ + "CAPACITY_OPTIMIZED capacity leverages redundancies (e.g. power,\ncooling) at the data center during normal operating conditions. In the\nevent of infrastructure failures at data center (e.g. power and/or\ncooling failures), this workload may be disrupted. As a consequence, it\nhas a weaker availability SLO than STANDARD.", + "STANDARD protection for workload that should be protected by\nredundancies (e.g. power, cooling) at the data center level. In the\nevent of infrastructure failures at data center (e.g. power and/or\ncooling failures), this workload is expected to continue as normal\nusing the redundancies.", + "Unspecified protection tier." + ], + "readOnly": true, + "type": "string" + }, "terminationTimestamp": { "description": "Time in future when the instance will be terminated inRFC3339 text format.", "type": "string" @@ -101988,6 +102598,20 @@ "$ref": "Duration", "description": "Specifies the Metadata Service preemption notice duration before the GCE ACPI G2\nSoft Off signal is triggered for Spot VMs only. If not specified,\nthere will be no wait before the G2 Soft Off signal is triggered." }, + "protectionTier": { + "description": "Protection tier for the workload which specifies the workload\nexpectations in the event of infrastructure failures at data center\n(e.g. power and/or cooling failures).", + "enum": [ + "PROTECTION_TIER_CAPACITY_OPTIMIZED", + "PROTECTION_TIER_STANDARD", + "PROTECTION_TIER_UNSPECIFIED" + ], + "enumDescriptions": [ + "CAPACITY_OPTIMIZED capacity leverages redundancies (e.g. power,\ncooling) at the data center during normal operating conditions. In the\nevent of infrastructure failures at data center (e.g. power and/or\ncooling failures), this workload may be disrupted. As a consequence, it\nhas a weaker availability SLO than STANDARD.", + "STANDARD protection for workload that should be protected by\nredundancies (e.g. power, cooling) at the data center level. In the\nevent of infrastructure failures at data center (e.g. power and/or\ncooling failures), this workload is expected to continue as normal\nusing the redundancies.", + "Unspecified protection tier." + ], + "type": "string" + }, "provisioningModel": { "description": "Specifies the provisioning model of the instance.", "enum": [ @@ -113183,6 +113807,7 @@ "description": "The reasons for the maintenance. Only valid for vms.", "items": { "enum": [ + "FAILURE_CUSTOMER_REPORTED", "FAILURE_DISK", "FAILURE_GPU", "FAILURE_GPU_MULTIPLE_FAULTY_HOSTS_CUSTOMER_REPORTED", @@ -113202,6 +113827,7 @@ "PLANNED_UPDATE" ], "enumDescriptions": [ + "Maintenance due to a fault reported by the customer via the R&R\n(Report-and-Replace) API.", "Maintenance due to disk errors.", "Maintenance due to GPU errors.", "Maintenance due to customer reported multiple faulty hosts via R&R\nSubblock API.", @@ -117000,13 +117626,11 @@ "description": "The flow management configuration for the wire.", "enum": [ "DYNAMIC_PATH", - "FIXED_PATH", - "FLOW_MANAGEMENT_UNSPECIFIED" + "FIXED_PATH" ], "enumDescriptions": [ "The wire uses dynamic paths.", - "The wire uses fixed paths.", - "" + "The wire uses fixed paths." ], "type": "string" } diff --git a/discovery/containeranalysis-v1.json b/discovery/containeranalysis-v1.json index 6ffcee83a7..3fa6c25f7c 100644 --- a/discovery/containeranalysis-v1.json +++ b/discovery/containeranalysis-v1.json @@ -1715,7 +1715,7 @@ } } }, - "revision": "20260929", + "revision": "20261002", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AISkillAnalysisNote": { @@ -3675,11 +3675,13 @@ "description": "Requested verifiability options.", "enum": [ "NOT_VERIFIED", - "VERIFIED" + "VERIFIED", + "BEST_EFFORT" ], "enumDescriptions": [ "Not a verifiable build (the default).", - "Build must be verified." + "Build must be verified.", + "Build verification is best effort. If provenance generation fails, the build will still succeed." ], "type": "string" }, diff --git a/discovery/containeranalysis-v1alpha1.json b/discovery/containeranalysis-v1alpha1.json index ae41f2c008..fdfbfed3bf 100644 --- a/discovery/containeranalysis-v1alpha1.json +++ b/discovery/containeranalysis-v1alpha1.json @@ -1454,7 +1454,7 @@ } } }, - "revision": "20260929", + "revision": "20261002", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AISkillAnalysisNote": { @@ -3213,11 +3213,13 @@ "description": "Requested verifiability options.", "enum": [ "NOT_VERIFIED", - "VERIFIED" + "VERIFIED", + "BEST_EFFORT" ], "enumDescriptions": [ "Not a verifiable build (the default).", - "Build must be verified." + "Build must be verified.", + "Build verification is best effort. If provenance generation fails, the build will still succeed." ], "type": "string" }, diff --git a/discovery/containeranalysis-v1beta1.json b/discovery/containeranalysis-v1beta1.json index c3b0989282..5dd3b9cad3 100644 --- a/discovery/containeranalysis-v1beta1.json +++ b/discovery/containeranalysis-v1beta1.json @@ -1771,7 +1771,7 @@ } } }, - "revision": "20260929", + "revision": "20261002", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AISkillAnalysisNote": { @@ -3589,11 +3589,13 @@ "description": "Requested verifiability options.", "enum": [ "NOT_VERIFIED", - "VERIFIED" + "VERIFIED", + "BEST_EFFORT" ], "enumDescriptions": [ "Not a verifiable build (the default).", - "Build must be verified." + "Build must be verified.", + "Build verification is best effort. If provenance generation fails, the build will still succeed." ], "type": "string" }, diff --git a/discovery/datamanager-v1.json b/discovery/datamanager-v1.json index 9daaa8342c..a1e016706a 100644 --- a/discovery/datamanager-v1.json +++ b/discovery/datamanager-v1.json @@ -860,7 +860,7 @@ } } }, - "revision": "20260924", + "revision": "20261007", "rootUrl": "https://datamanager.googleapis.com/", "schemas": { "AdEvent": { @@ -1634,7 +1634,9 @@ "PROCESSING_ERROR_REASON_INVALID_CLICK", "PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK", "PROCESSING_ERROR_REASON_CLICK_NOT_FOUND", - "PROCESSING_ERROR_REASON_EXTERNAL_ATTRIBUTION_DATA_MISSING" + "PROCESSING_ERROR_REASON_EXTERNAL_ATTRIBUTION_DATA_MISSING", + "PROCESSING_ERROR_REASON_DESTINATION_TOO_RECENTLY_CREATED", + "PROCESSING_ERROR_REASON_EXPIRED_CLICK" ], "enumDescriptions": [ "", @@ -1681,6 +1683,8 @@ "", "", "", + "", + "", "" ], "type": "string" diff --git a/discovery/dataplex-v1.json b/discovery/dataplex-v1.json index 85a08d4ac9..77fa41f3dc 100644 --- a/discovery/dataplex-v1.json +++ b/discovery/dataplex-v1.json @@ -7576,7 +7576,7 @@ } } }, - "revision": "20260929", + "revision": "20261005", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "Empty": { @@ -9085,10 +9085,6 @@ "jsonOptions": { "$ref": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions", "description": "Optional. Configuration for JSON data." - }, - "unstructuredDataOptions": { - "$ref": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigUnstructuredDataOptions", - "description": "Optional. Specifies configuration for unstructured data discovery." } }, "type": "object" @@ -9136,21 +9132,6 @@ }, "type": "object" }, - "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigUnstructuredDataOptions": { - "description": "Describes options for unstructured data discovery.", - "id": "GoogleCloudDataplexV1DataDiscoverySpecStorageConfigUnstructuredDataOptions", - "properties": { - "globalEndpointEnabled": { - "description": "Optional. Whether to use the global model endpoint.", - "type": "boolean" - }, - "semanticInferenceEnabled": { - "description": "Optional. Specifies whether deeper semantic inference over the objects' contents using GenAI is enabled.", - "type": "boolean" - } - }, - "type": "object" - }, "GoogleCloudDataplexV1DataDocumentationResult": { "description": "The output of a DataDocumentation scan.", "id": "GoogleCloudDataplexV1DataDocumentationResult", @@ -11092,16 +11073,14 @@ "DATA_QUALITY", "DATA_PROFILE", "DATA_DISCOVERY", - "DATA_DOCUMENTATION", - "UNSTRUCTURED_DATA_PROFILE" + "DATA_DOCUMENTATION" ], "enumDescriptions": [ "The data scan type is unspecified.", "Data quality scan.", "Data profile scan.", "Data discovery scan.", - "Data documentation scan.", - "Unstructured data profile scan." + "Data documentation scan." ], "readOnly": true, "type": "string" @@ -11111,15 +11090,6 @@ "readOnly": true, "type": "string" }, - "unstructuredDataProfileResult": { - "$ref": "GoogleCloudDataplexV1UnstructuredDataProfileResult", - "description": "Output only. The result of an unstructured data profile scan.", - "readOnly": true - }, - "unstructuredDataProfileSpec": { - "$ref": "GoogleCloudDataplexV1UnstructuredDataProfileSpec", - "description": "Optional. Settings for an unstructured data profile scan." - }, "updateTime": { "description": "Output only. The time when the scan was last updated.", "format": "google-datetime", @@ -11624,16 +11594,14 @@ "DATA_QUALITY", "DATA_PROFILE", "DATA_DISCOVERY", - "DATA_DOCUMENTATION", - "UNSTRUCTURED_DATA_PROFILE" + "DATA_DOCUMENTATION" ], "enumDescriptions": [ "The data scan type is unspecified.", "Data quality scan.", "Data profile scan.", "Data discovery scan.", - "Data documentation scan.", - "Unstructured data profile scan." + "Data documentation scan." ], "readOnly": true, "type": "string" @@ -11642,16 +11610,6 @@ "description": "Output only. System generated globally unique ID for the DataScanJob.", "readOnly": true, "type": "string" - }, - "unstructuredDataProfileResult": { - "$ref": "GoogleCloudDataplexV1UnstructuredDataProfileResult", - "description": "Output only. The result of an unstructured data profile scan.", - "readOnly": true - }, - "unstructuredDataProfileSpec": { - "$ref": "GoogleCloudDataplexV1UnstructuredDataProfileSpec", - "description": "Output only. Settings for an unstructured data profile scan.", - "readOnly": true } }, "type": "object" @@ -12862,284 +12820,6 @@ }, "type": "object" }, - "GoogleCloudDataplexV1GraphProfile": { - "description": "Contains the strict structure for graph-profile for semantic inference scan result.", - "id": "GoogleCloudDataplexV1GraphProfile", - "properties": { - "edgeTypes": { - "description": "Output only. Edge types.", - "items": { - "$ref": "GoogleCloudDataplexV1GraphProfileEdgeType" - }, - "readOnly": true, - "type": "array" - }, - "nodeTypes": { - "description": "Output only. Node types.", - "items": { - "$ref": "GoogleCloudDataplexV1GraphProfileNodeType" - }, - "readOnly": true, - "type": "array" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1GraphProfileEdgeType": { - "description": "Represents a type of edge (relationship) in the graph.", - "id": "GoogleCloudDataplexV1GraphProfileEdgeType", - "properties": { - "description": { - "description": "Output only. Description of the edge type.", - "readOnly": true, - "type": "string" - }, - "extractionHints": { - "$ref": "GoogleCloudDataplexV1GraphProfileEdgeTypeExtractionHints", - "description": "Output only. Extraction hints for the edge.", - "readOnly": true - }, - "fields": { - "description": "Output only. Fields of the edge type.", - "items": { - "$ref": "GoogleCloudDataplexV1GraphProfileField" - }, - "readOnly": true, - "type": "array" - }, - "foreignKeys": { - "description": "Output only. Defines the Foreign Key constraints for the edge.", - "items": { - "$ref": "GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKey" - }, - "readOnly": true, - "type": "array" - }, - "name": { - "description": "Output only. Name of the edge type.", - "readOnly": true, - "type": "string" - }, - "sourceNodeType": { - "description": "Output only. Source node type.", - "readOnly": true, - "type": "string" - }, - "targetNodeType": { - "description": "Output only. Target node type.", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1GraphProfileEdgeTypeExtractionHints": { - "description": "Extraction hints (edge-level).", - "id": "GoogleCloudDataplexV1GraphProfileEdgeTypeExtractionHints", - "properties": { - "cardinality": { - "description": "Output only. Expected connectivity topology and bounds of this relationship. Format: \"Topology - Description\" Example: \"1:N - One company can have multiple financial reports.\"", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKey": { - "description": "Represents a foreign key constraint.", - "id": "GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKey", - "properties": { - "description": { - "description": "Output only. Description of the foreign key.", - "readOnly": true, - "type": "string" - }, - "fieldMappings": { - "description": "Output only. Field Mappings. Mappings between local fields and the fields they reference in the referenced node type.", - "items": { - "$ref": "GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKeyFieldMapping" - }, - "readOnly": true, - "type": "array" - }, - "name": { - "description": "Output only. Name of the foreign key constraint.", - "readOnly": true, - "type": "string" - }, - "referencedNodeType": { - "description": "Output only. The node type this constraint references.", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKeyFieldMapping": { - "description": "Maps a local field to a referenced field.", - "id": "GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKeyFieldMapping", - "properties": { - "field": { - "description": "Output only. Local field name forming part of the foreign key.", - "readOnly": true, - "type": "string" - }, - "referencedField": { - "description": "Output only. Field name in the referenced node type.", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1GraphProfileField": { - "description": "Represents a field in a node or edge type.", - "id": "GoogleCloudDataplexV1GraphProfileField", - "properties": { - "dataType": { - "description": "Output only. The data type of the field, e.g., STRING, INTEGER, DATE.", - "readOnly": true, - "type": "string" - }, - "description": { - "description": "Output only. Description of the field.", - "readOnly": true, - "type": "string" - }, - "extractionHints": { - "$ref": "GoogleCloudDataplexV1GraphProfileFieldExtractionHints", - "description": "Output only. Extraction hints for the field.", - "readOnly": true - }, - "fields": { - "description": "Output only. Sub-fields of this field (for STRUCT types).", - "items": { - "$ref": "GoogleCloudDataplexV1GraphProfileField" - }, - "readOnly": true, - "type": "array" - }, - "metadataType": { - "description": "Output only. The mapped metadata type.", - "enum": [ - "METADATA_TYPE_UNSPECIFIED", - "BOOLEAN", - "NUMBER", - "STRING", - "BYTES", - "DATETIME", - "TIMESTAMP", - "GEOSPATIAL", - "STRUCT", - "OTHER" - ], - "enumDescriptions": [ - "Unspecified metadata type.", - "Boolean type.", - "Numeric type.", - "String type.", - "Bytes type.", - "Date and time type.", - "Timestamp type.", - "Geospatial type.", - "Struct (record) type.", - "Other types not covered above." - ], - "readOnly": true, - "type": "string" - }, - "mode": { - "description": "Output only. The mode of the field.", - "enum": [ - "MODE_UNSPECIFIED", - "NULLABLE", - "REPEATED", - "REQUIRED" - ], - "enumDescriptions": [ - "Unspecified mode.", - "Field can be null.", - "Field can be repeated.", - "Field is required." - ], - "readOnly": true, - "type": "string" - }, - "name": { - "description": "Output only. Name of the field.", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1GraphProfileFieldExtractionHints": { - "description": "Extraction hints (field-level).", - "id": "GoogleCloudDataplexV1GraphProfileFieldExtractionHints", - "properties": { - "normalization": { - "description": "Output only. Standardizes extracted data (e.g., to ISO 3166-1 alpha-2).", - "readOnly": true, - "type": "string" - }, - "synthesis": { - "description": "Output only. Generates value from other data instead of direct extraction (e.g., hashing).", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1GraphProfileNodeType": { - "description": "Represents a type of node in the graph.", - "id": "GoogleCloudDataplexV1GraphProfileNodeType", - "properties": { - "description": { - "description": "Output only. Description of the node type.", - "readOnly": true, - "type": "string" - }, - "extractionHints": { - "$ref": "GoogleCloudDataplexV1GraphProfileNodeTypeExtractionHints", - "description": "Output only. Extraction hints for the node.", - "readOnly": true - }, - "fields": { - "description": "Output only. Fields of the node type.", - "items": { - "$ref": "GoogleCloudDataplexV1GraphProfileField" - }, - "readOnly": true, - "type": "array" - }, - "name": { - "description": "Output only. Name of the node type.", - "readOnly": true, - "type": "string" - }, - "primaryKeys": { - "description": "Output only. Field names forming the primary keys. The order in this array defines the key's ordinal positions for composite keys.", - "items": { - "type": "string" - }, - "readOnly": true, - "type": "array" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1GraphProfileNodeTypeExtractionHints": { - "description": "Extraction hints (node-level).", - "id": "GoogleCloudDataplexV1GraphProfileNodeTypeExtractionHints", - "properties": { - "cardinality": { - "description": "Output only. Expected occurrence frequency of this node type within a document. Format: \"Bounds - Description\" Example: \"0:N - A document may contain multiple people names.\"", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudDataplexV1ImportItem": { "description": "An object that describes the values that you want to set for an entry and its attached aspects when you import metadata. Used when you run a metadata import job. See CreateMetadataJob.You provide a collection of import items in a metadata import file. For more information about how to create a metadata import file, see Metadata import file (https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).", "id": "GoogleCloudDataplexV1ImportItem", @@ -15649,47 +15329,6 @@ }, "type": "object" }, - "GoogleCloudDataplexV1UnstructuredDataProfileResult": { - "description": "Contains the result of an unstructured data profile scan.", - "id": "GoogleCloudDataplexV1UnstructuredDataProfileResult", - "properties": { - "description": { - "description": "Output only. The inferred description.", - "readOnly": true, - "type": "string" - }, - "graphProfile": { - "$ref": "GoogleCloudDataplexV1GraphProfile", - "description": "Output only. The inferred graph profile.", - "readOnly": true - }, - "partialFailureMessage": { - "description": "Output only. Optional message for partial failures (e.g. node type extraction failed).", - "readOnly": true, - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudDataplexV1UnstructuredDataProfileSpec": { - "description": "Contains the specification for an unstructured data profile scan.", - "id": "GoogleCloudDataplexV1UnstructuredDataProfileSpec", - "properties": { - "customizedPrompt": { - "description": "Optional. Customized prompt for unstructured data profile. The field will be used as part of the prompt, could be some instruction, specifying skill, or specific area to focus.", - "type": "string" - }, - "globalEndpointEnabled": { - "description": "Optional. Whether to use the global model.", - "type": "boolean" - }, - "graphProfilePublishingEnabled": { - "description": "Optional. Whether to publish graph-profile as aspect on the catalog entry.", - "type": "boolean" - } - }, - "type": "object" - }, "GoogleCloudDataplexV1UpdateEntryRequest": { "description": "Update Entry request.", "id": "GoogleCloudDataplexV1UpdateEntryRequest", diff --git a/discovery/developerconnect-v1.json b/discovery/developerconnect-v1.json index ba02e5db46..17021eafe8 100644 --- a/discovery/developerconnect-v1.json +++ b/discovery/developerconnect-v1.json @@ -61,6 +61,11 @@ "endpointUrl": "https://developerconnect.asia-southeast2.rep.googleapis.com/", "location": "asia-southeast2" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://developerconnect.asia-southeast3.rep.googleapis.com/", + "location": "asia-southeast3" + }, { "description": "Regional Endpoint", "endpointUrl": "https://developerconnect.australia-southeast1.rep.googleapis.com/", @@ -81,6 +86,11 @@ "endpointUrl": "https://developerconnect.europe-north1.rep.googleapis.com/", "location": "europe-north1" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://developerconnect.europe-north2.rep.googleapis.com/", + "location": "europe-north2" + }, { "description": "Regional Endpoint", "endpointUrl": "https://developerconnect.europe-southwest1.rep.googleapis.com/", @@ -1955,7 +1965,7 @@ } } }, - "revision": "20260914", + "revision": "20261002", "rootUrl": "https://developerconnect.googleapis.com/", "schemas": { "AccountConnector": { diff --git a/discovery/devicerun-v1alpha.json b/discovery/devicerun-v1alpha.json index 540989efdd..c4a3238baf 100644 --- a/discovery/devicerun-v1alpha.json +++ b/discovery/devicerun-v1alpha.json @@ -383,6 +383,37 @@ }, "sessions": { "methods": { + "batchGet": { + "description": "Retrieves multiple automation sessions in a single batch request. Sessions are returned in the same order as the `names` in the request. If any of the requested sessions does not exist, the whole request fails with `NOT_FOUND` and no sessions are returned. When calling this method over HTTP/REST with a large number of `names`, the request URL may exceed the maximum URL length (about 16 KB) and be rejected. In that case, send a `POST` request to the same URL with the `X-HTTP-Method-Override: GET` header and pass the request parameters in a JSON (`application/json`) or form-encoded (`application/x-www-form-urlencoded`) body. See https://cloud.google.com/apis/docs/http#long_request_urls.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/sessions:batchGet", + "httpMethod": "GET", + "id": "devicerun.projects.locations.sessions.batchGet", + "parameterOrder": [ + "parent" + ], + "parameters": { + "names": { + "description": "Required. The names of the sessions to retrieve. A maximum of 500 sessions can be retrieved in a batch. Format: `projects/{project}/locations/{location}/sessions/{session}`.", + "location": "query", + "repeated": true, + "type": "string" + }, + "parent": { + "description": "Required. The parent resource shared by all sessions being retrieved. Format: `projects/{project}/locations/{location}`. The `parent` field in the `BatchGetSessionsRequest` message must match the `parent` of all `Session` resource names in `names`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+parent}/sessions:batchGet", + "response": { + "$ref": "BatchGetSessionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "cancel": { "description": "Cancels an in-progress automation session. This RPC returns immediately and cancellation proceeds asynchronously. If the session is already finished, this RPC will have no effect.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/sessions/{sessionsId}:cancel", @@ -657,7 +688,7 @@ } } }, - "revision": "20261001", + "revision": "20261006", "rootUrl": "https://devicerun.googleapis.com/", "schemas": { "AllocationConfig": { @@ -949,6 +980,20 @@ }, "type": "object" }, + "BatchGetSessionsResponse": { + "description": "Response including the requested sessions.", + "id": "BatchGetSessionsResponse", + "properties": { + "sessions": { + "description": "The requested sessions, in the same order as the `names` in the request.", + "items": { + "$ref": "Session" + }, + "type": "array" + } + }, + "type": "object" + }, "CancelSessionRequest": { "description": "Request to cancel a session.", "id": "CancelSessionRequest", diff --git a/discovery/discoveryengine-v1.json b/discovery/discoveryengine-v1.json index ddeafc70fc..cfc6627572 100644 --- a/discovery/discoveryengine-v1.json +++ b/discovery/discoveryengine-v1.json @@ -28,45 +28,10 @@ "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/", "endpoints": [ - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.asia-northeast1.rep.googleapis.com/", - "location": "asia-northeast1" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.europe-west2.rep.googleapis.com/", - "location": "europe-west2" - }, { "description": "Regional Endpoint", "endpointUrl": "https://discoveryengine.us.rep.googleapis.com/", "location": "us" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/", - "location": "eu" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.in.rep.googleapis.com/", - "location": "in" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.asia-southeast1.rep.googleapis.com/", - "location": "asia-southeast1" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.europe-west3.rep.googleapis.com/", - "location": "europe-west3" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.ca.rep.googleapis.com/", - "location": "ca" } ], "fullyEncodeReservedExpansion": true, @@ -9937,7 +9902,7 @@ } } }, - "revision": "20260924", + "revision": "20261004", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "A2aV1APIKeySecurityScheme": { @@ -17563,6 +17528,10 @@ "session": { "description": "Name of the newly generated or continued session.", "type": "string" + }, + "taskName": { + "description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}", + "type": "string" } }, "type": "object" @@ -23587,6 +23556,11 @@ "description": "The resolved, server-side view of model selector configuration for the end-user. The backend computes this per-request by applying, in order: Mendel flag evaluation, regional availability rules based on the engine's location, and admin-panel overrides from `model_configs`. The backend is the single source of truth for this configuration; clients should render `resolved_models` directly in the model selector dropdown, in the order provided, without applying their own filtering, ordering, or localization.", "id": "GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsModelConfigInfo", "properties": { + "autoModelId": { + "description": "Output only. The `model_id` a client must send when the end-user picks the \"Auto\" entry (the empty `model_id`). Populated only for surfaces known to have no true \"Auto\" mode, where leaving the model unset would fall back to a platform default rather than a backend-chosen model. Empty on every other surface, where \"Auto\" is resolved server-side, and when none of the surface's ranked models is available. When set, it is always one of the non-empty `model_id`s present in `resolved_models`.", + "readOnly": true, + "type": "string" + }, "defaultModelId": { "description": "Output only. The `model_id` of the model that should be selected by default in the model selector when the end-user has not made an explicit choice. The value is always one of the `model_id`s present in `resolved_models`.", "readOnly": true, diff --git a/discovery/discoveryengine-v1alpha.json b/discovery/discoveryengine-v1alpha.json index 29b72fb21b..e2c5bae73a 100644 --- a/discovery/discoveryengine-v1alpha.json +++ b/discovery/discoveryengine-v1alpha.json @@ -28,45 +28,10 @@ "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/", "endpoints": [ - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.asia-northeast1.rep.googleapis.com/", - "location": "asia-northeast1" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.europe-west2.rep.googleapis.com/", - "location": "europe-west2" - }, { "description": "Regional Endpoint", "endpointUrl": "https://discoveryengine.us.rep.googleapis.com/", "location": "us" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/", - "location": "eu" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.in.rep.googleapis.com/", - "location": "in" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.asia-southeast1.rep.googleapis.com/", - "location": "asia-southeast1" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.europe-west3.rep.googleapis.com/", - "location": "europe-west3" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.ca.rep.googleapis.com/", - "location": "ca" } ], "fullyEncodeReservedExpansion": true, @@ -6437,6 +6402,41 @@ ] } } + }, + "toolCalls": { + "resources": { + "operations": { + "methods": { + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/toolCalls/{toolCallsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "discoveryengine.projects.locations.collections.engines.assistants.agents.toolCalls.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+/toolCalls/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/discoveryengine.readwrite", + "https://www.googleapis.com/auth/discoveryengine.serving.readwrite" + ] + } + } + } + } } } }, @@ -13692,7 +13692,7 @@ } } }, - "revision": "20260924", + "revision": "20261004", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -27223,6 +27223,10 @@ "session": { "description": "Name of the newly generated or continued session.", "type": "string" + }, + "taskName": { + "description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}", + "type": "string" } }, "type": "object" @@ -35993,6 +35997,11 @@ "description": "The resolved, server-side view of model selector configuration for the end-user. The backend computes this per-request by applying, in order: Mendel flag evaluation, regional availability rules based on the engine's location, and admin-panel overrides from `model_configs`. The backend is the single source of truth for this configuration; clients should render `resolved_models` directly in the model selector dropdown, in the order provided, without applying their own filtering, ordering, or localization.", "id": "GoogleCloudDiscoveryengineV1alphaWidgetConfigUiSettingsModelConfigInfo", "properties": { + "autoModelId": { + "description": "Output only. The `model_id` a client must send when the end-user picks the \"Auto\" entry (the empty `model_id`). Populated only for surfaces known to have no true \"Auto\" mode, where leaving the model unset would fall back to a platform default rather than a backend-chosen model. Empty on every other surface, where \"Auto\" is resolved server-side, and when none of the surface's ranked models is available. When set, it is always one of the non-empty `model_id`s present in `resolved_models`.", + "readOnly": true, + "type": "string" + }, "defaultModelId": { "description": "Output only. The `model_id` of the model that should be selected by default in the model selector when the end-user has not made an explicit choice. The value is always one of the `model_id`s present in `resolved_models`.", "readOnly": true, diff --git a/discovery/discoveryengine-v1beta.json b/discovery/discoveryengine-v1beta.json index b80a148543..a3082a531e 100644 --- a/discovery/discoveryengine-v1beta.json +++ b/discovery/discoveryengine-v1beta.json @@ -28,45 +28,10 @@ "discoveryVersion": "v1", "documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/", "endpoints": [ - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.asia-northeast1.rep.googleapis.com/", - "location": "asia-northeast1" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.europe-west2.rep.googleapis.com/", - "location": "europe-west2" - }, { "description": "Regional Endpoint", "endpointUrl": "https://discoveryengine.us.rep.googleapis.com/", "location": "us" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/", - "location": "eu" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.in.rep.googleapis.com/", - "location": "in" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.asia-southeast1.rep.googleapis.com/", - "location": "asia-southeast1" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.europe-west3.rep.googleapis.com/", - "location": "europe-west3" - }, - { - "description": "Regional Endpoint", - "endpointUrl": "https://discoveryengine.ca.rep.googleapis.com/", - "location": "ca" } ], "fullyEncodeReservedExpansion": true, @@ -9680,7 +9645,7 @@ } } }, - "revision": "20260924", + "revision": "20261004", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -28897,6 +28862,10 @@ "session": { "description": "Name of the newly generated or continued session.", "type": "string" + }, + "taskName": { + "description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}", + "type": "string" } }, "type": "object" diff --git a/discovery/dns-v1beta2.json b/discovery/dns-v1beta2.json index 077091dd82..fbe0cb1ab0 100644 --- a/discovery/dns-v1beta2.json +++ b/discovery/dns-v1beta2.json @@ -371,6 +371,88 @@ } } }, + "locations": { + "methods": { + "get": { + "description": "Gets information about a location.", + "flatPath": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}", + "httpMethod": "GET", + "id": "dns.locations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Resource name for the location.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "dns/v1beta2/{+name}", + "response": { + "$ref": "Location" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/ndev.clouddns.readonly", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + }, + "list": { + "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.", + "flatPath": "dns/v1beta2/projects/{projectsId}/locations", + "httpMethod": "GET", + "id": "dns.locations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "extraLocationTypes": { + "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily 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", + "type": "string" + }, + "name": { + "description": "The resource that owns the locations collection, if applicable.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The maximum number of results to return. If not set, the service selects a default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", + "location": "query", + "type": "string" + } + }, + "path": "dns/v1beta2/{+name}/locations", + "response": { + "$ref": "ListLocationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/ndev.clouddns.readonly", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + } + } + }, "managedZoneOperations": { "methods": { "get": { @@ -804,6 +886,340 @@ } } }, + "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": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "dns.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": "dns/v1beta2/{+name}:cancel", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + }, + "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": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "dns.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": "dns/v1beta2/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + }, + "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": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "dns.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "dns/v1beta2/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "dns.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" + }, + "returnPartialSuccess": { + "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", + "location": "query", + "type": "boolean" + } + }, + "path": "dns/v1beta2/{+name}/operations", + "response": { + "$ref": "GoogleLongrunningListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + } + } + }, + "outboundEndpoints": { + "methods": { + "create": { + "description": "Creates a new Outbound Endpoint.", + "flatPath": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/outboundEndpoints", + "httpMethod": "POST", + "id": "dns.outboundEndpoints.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "clientOperationId": { + "description": "For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.", + "location": "query", + "type": "string" + }, + "outboundEndpointId": { + "description": "Required. The ID to use for the OutboundEndpoint, which will become the final component of the OutboundEndpoint's resource name.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent project and location where this OutboundEndpoint will be created. Format: projects/{project}/locations/{location}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests.", + "location": "query", + "type": "string" + } + }, + "path": "dns/v1beta2/{+parent}/outboundEndpoints", + "request": { + "$ref": "OutboundEndpoint" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + }, + "delete": { + "description": "Deletes a previously created Outbound Endpoint.", + "flatPath": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/outboundEndpoints/{outboundEndpointsId}", + "httpMethod": "DELETE", + "id": "dns.outboundEndpoints.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "clientOperationId": { + "description": "For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the OutboundEndpoint to delete. Format: projects/{project}/locations/{location}/outboundEndpoints/{outboundEndpoint}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/outboundEndpoints/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests.", + "location": "query", + "type": "string" + } + }, + "path": "dns/v1beta2/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + }, + "get": { + "description": "Fetches the representation of an existing Outbound Endpoint.", + "flatPath": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/outboundEndpoints/{outboundEndpointsId}", + "httpMethod": "GET", + "id": "dns.outboundEndpoints.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "clientOperationId": { + "description": "For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the OutboundEndpoint to retrieve. Format: projects/{project}/locations/{location}/outboundEndpoints/{outboundEndpoint}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/outboundEndpoints/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "dns/v1beta2/{+name}", + "response": { + "$ref": "OutboundEndpoint" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/ndev.clouddns.readonly", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + }, + "list": { + "description": "Enumerates all Outbound Endpoints associated with a project.", + "flatPath": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/outboundEndpoints", + "httpMethod": "GET", + "id": "dns.outboundEndpoints.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "clientOperationId": { + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of results to return.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A page token received from a previous List call.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent project and location from which to list resources. Format: projects/{project}/locations/{location}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "dns/v1beta2/{+parent}/outboundEndpoints", + "response": { + "$ref": "ListOutboundEndpointsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/ndev.clouddns.readonly", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + }, + "patch": { + "description": "Updates an existing Outbound Endpoint.", + "flatPath": "dns/v1beta2/projects/{projectsId}/locations/{locationsId}/outboundEndpoints/{outboundEndpointsId}", + "httpMethod": "PATCH", + "id": "dns.outboundEndpoints.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "clientOperationId": { + "description": "For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Identifier. The resource name of the OutboundEndpoint. Format: `projects/{project}/locations/{location}/outboundEndpoints/{outboundEndpoint}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/outboundEndpoints/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests.", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Required. The list of fields to be updated.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "dns/v1beta2/{+name}", + "request": { + "$ref": "OutboundEndpoint" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/ndev.clouddns.readwrite" + ] + } + } + }, "policies": { "methods": { "create": { @@ -1821,7 +2237,7 @@ } } }, - "revision": "20260915", + "revision": "20261002", "rootUrl": "https://dns.googleapis.com/", "schemas": { "Change": { @@ -2072,6 +2488,12 @@ }, "type": "object" }, + "Empty": { + "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", + "id": "Empty", + "properties": {}, + "type": "object" + }, "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() < 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.", "id": "Expr", @@ -2263,6 +2685,31 @@ }, "type": "object" }, + "GoogleLongrunningListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "GoogleLongrunningListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "GoogleLongrunningOperation" + }, + "type": "array" + }, + "unreachable": { + "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleLongrunningOperation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "GoogleLongrunningOperation", @@ -2300,6 +2747,84 @@ }, "type": "object" }, + "ListLocationsResponse": { + "description": "The response message for Locations.ListLocations.", + "id": "ListLocationsResponse", + "properties": { + "locations": { + "description": "A list of locations that matches the specified filter in the request.", + "items": { + "$ref": "Location" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + } + }, + "type": "object" + }, + "ListOutboundEndpointsResponse": { + "description": "Response message for OutboundEndpointsService.ListOutboundEndpoints", + "id": "ListOutboundEndpointsResponse", + "properties": { + "nextPageToken": { + "description": "A token to retrieve the next page of results. Set to empty if there are no remaining results.", + "type": "string" + }, + "outboundEndpoints": { + "description": "The list of OutboundEndpoints.", + "items": { + "$ref": "OutboundEndpoint" + }, + "type": "array" + }, + "unreachable": { + "description": "Unordered list. The resource names of the unreachable locations. Format: `projects/{project}/locations/{location}`", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "A resource that represents a Google Cloud location.", + "id": "Location", + "properties": { + "displayName": { + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", + "type": "object" + }, + "locationId": { + "description": "The canonical id for this location. For example: `\"us-east1\"`.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata. For example the available capacity at the given location.", + "format": "google.protobuf.Any", + "type": "object" + }, + "name": { + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", + "type": "string" + } + }, + "type": "object" + }, "ManagedZone": { "description": "A zone is a subtree of the DNS namespace under one administrative responsibility. A ManagedZone is a resource that represents a DNS zone hosted by the Cloud DNS service.", "id": "ManagedZone", @@ -2458,6 +2983,13 @@ "readOnly": true, "type": "string" }, + "outboundEndpoints": { + "description": "The list of outbound endpoints to use for queries.", + "items": { + "$ref": "ManagedZoneForwardingConfigOutboundEndpoint" + }, + "type": "array" + }, "targetNameServers": { "description": "List of target name servers to forward to. Cloud DNS selects the best available name server if more than one target is given.", "items": { @@ -2503,6 +3035,21 @@ }, "type": "object" }, + "ManagedZoneForwardingConfigOutboundEndpoint": { + "id": "ManagedZoneForwardingConfigOutboundEndpoint", + "properties": { + "kind": { + "default": "dns#managedZoneForwardingConfigOutboundEndpoint", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Specified as a resource path including project and region. This should be formatted like projects/{project}/locations/{location}/outboundEndpoints/{endpoint}", + "type": "string" + } + }, + "type": "object" + }, "ManagedZoneOperationsListResponse": { "id": "ManagedZoneOperationsListResponse", "properties": { @@ -2760,6 +3307,110 @@ }, "type": "object" }, + "OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "OutboundEndpoint": { + "description": "An OutboundEndpoint is a regional resource to enable outbound forwarding from a private IP range in VPCs to on-premise or other networks.", + "id": "OutboundEndpoint", + "properties": { + "annotations": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Annotations as key value pairs", + "type": "object" + }, + "createTime": { + "description": "Output only. [Output only] Create time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. User provided description.", + "type": "string" + }, + "endpointIp": { + "description": "Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs", + "type": "object" + }, + "name": { + "description": "Identifier. The resource name of the OutboundEndpoint. Format: `projects/{project}/locations/{location}/outboundEndpoints/{outboundEndpoint}`", + "type": "string" + }, + "network": { + "description": "Required. Immutable. The VPC network containing the outbound endpoint, specified as full path.", + "type": "string" + }, + "subnetwork": { + "description": "Required. Immutable. The subnetwork holding the endpoint_ip, specified as full path.", + "type": "string" + }, + "tags": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Tag bindings as key value pairs", + "type": "object" + }, + "updateTime": { + "description": "Output only. [Output only] Update time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "PoliciesListResponse": { "id": "PoliciesListResponse", "properties": { @@ -2857,6 +3508,13 @@ "readOnly": true, "type": "string" }, + "outboundEndpoints": { + "description": "The list of outbound endpoints to use for queries.", + "items": { + "$ref": "PolicyAlternativeNameServerConfigOutboundEndpoint" + }, + "type": "array" + }, "targetNameServers": { "description": "Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.", "items": { @@ -2867,6 +3525,21 @@ }, "type": "object" }, + "PolicyAlternativeNameServerConfigOutboundEndpoint": { + "id": "PolicyAlternativeNameServerConfigOutboundEndpoint", + "properties": { + "kind": { + "default": "dns#policyAlternativeNameServerConfigOutboundEndpoint", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Specified as a resource path including project and region. This should be formatted like projects/{project}/locations/{location}/outboundEndpoints/{endpoint}", + "type": "string" + } + }, + "type": "object" + }, "PolicyAlternativeNameServerConfigTargetNameServer": { "id": "PolicyAlternativeNameServerConfigTargetNameServer", "properties": { @@ -3042,6 +3715,16 @@ "format": "int32", "type": "integer" }, + "outboundEndpointsPerManagedZone": { + "description": "Maximum allowed number of outbound endpoints per managed zone.", + "format": "int32", + "type": "integer" + }, + "outboundEndpointsPerPolicy": { + "description": "Maximum allowed number of outbound endpoints per policy.", + "format": "int32", + "type": "integer" + }, "peeringZonesPerTargetNetwork": { "description": "Maximum allowed number of consumer peering zones per target network owned by this producer project", "format": "int32", diff --git a/discovery/docs-v1.json b/discovery/docs-v1.json index ec5c1d068e..c3f77a21ac 100644 --- a/discovery/docs-v1.json +++ b/discovery/docs-v1.json @@ -178,7 +178,7 @@ ], "parameters": { "commentsViewMode": { - "description": "The comments view mode to apply to the document. This allows viewing the document with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED is used. If you set comments_view_mode to any value, you must also set include_tabs_content to `true` or use a field mask that references the Document.tabs field (or any subfield). If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED, you must also explicitly set suggestions_view_mode to SUGGESTIONS_INLINE. If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED or COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, you may not set suggestions_view_mode to PREVIEW_WITHOUT_SUGGESTIONS or PREVIEW_SUGGESTIONS_ACCEPTED. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "The comments view mode to apply to the document. This allows viewing the document with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED is used. If you set comments_view_mode to any value, you must also set include_tabs_content to `true` or use a field mask that references the Document.tabs field (or any subfield). If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED, you must also explicitly set suggestions_view_mode to SUGGESTIONS_INLINE. If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED or COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, you may not set suggestions_view_mode to PREVIEW_WITHOUT_SUGGESTIONS or PREVIEW_SUGGESTIONS_ACCEPTED.", "enum": [ "COMMENTS_VIEW_MODE_UNSPECIFIED", "COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS", @@ -238,11 +238,11 @@ } } }, - "revision": "20260928", + "revision": "20261006", "rootUrl": "https://docs.googleapis.com/", "schemas": { "AcceptSuggestionRequest": { - "description": "Accepts a suggestion. Returns a 403 forbidden error if the requesting user does not have edit access to the document. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Accepts a suggestion. Returns a 403 forbidden error if the requesting user does not have edit access to the document.", "id": "AcceptSuggestionRequest", "properties": { "suggestionId": { @@ -253,7 +253,7 @@ "type": "object" }, "AddCommentReplyRequest": { - "description": "Inserts a reply Post into a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Inserts a reply Post into a CommentThread or SuggestionThread.", "id": "AddCommentReplyRequest", "properties": { "commentId": { @@ -272,7 +272,7 @@ "type": "object" }, "AddCommentReplyResponse": { - "description": "Response message for adding a reply. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Response message for adding a reply.", "id": "AddCommentReplyResponse", "properties": { "post": { @@ -395,7 +395,7 @@ "id": "BatchUpdateDocumentResponse", "properties": { "commentUpdateState": { - "description": "Whether comment updates were applied in the batch request. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Whether comment updates were applied in the batch request.", "enum": [ "COMMENT_UPDATE_STATE_UNSPECIFIED", "NO_UPDATES_REQUESTED", @@ -422,7 +422,7 @@ "type": "array" }, "suggestionResponses": { - "description": "The suggestions which were affected by each update. This maps 1:1 with the updates. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "The suggestions which were affected by each update. This maps 1:1 with the updates.", "items": { "$ref": "SuggestionResponse" }, @@ -547,7 +547,7 @@ "type": "object" }, "CommentAnchor": { - "description": "One or more locations in the document that are tied to CommentThreads with the same anchorId. Note: Multiple anchors may refer to the same location. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "One or more locations in the document that are tied to CommentThreads with the same anchorId. Note: Multiple anchors may refer to the same location.", "id": "CommentAnchor", "properties": { "anchorId": { @@ -565,7 +565,7 @@ "type": "object" }, "CommentThread": { - "description": "Represents a single comment thread. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Represents a single comment thread.", "id": "CommentThread", "properties": { "anchorId": { @@ -1000,7 +1000,7 @@ "type": "object" }, "DeleteCommentReplyRequest": { - "description": "Deletes a reply Post from a CommentThread or SuggestionThread. Returns a 400 bad request error if: - The requesting user is not the author of the post. - The reply post contains an action. - The reply post contains an assignee. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Deletes a reply Post from a CommentThread or SuggestionThread. Returns a 400 bad request error if: - The requesting user is not the author of the post. - The reply post contains an action. - The reply post contains an assignee.", "id": "DeleteCommentReplyRequest", "properties": { "commentId": { @@ -1019,7 +1019,7 @@ "type": "object" }, "DeleteCommentRequest": { - "description": "Deletes a CommentThread. Returns a 400 bad request error if the requesting user is not the author of the headPost. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Deletes a CommentThread. Returns a 400 bad request error if the requesting user is not the author of the headPost.", "id": "DeleteCommentRequest", "properties": { "commentId": { @@ -1131,7 +1131,7 @@ "type": "object" }, "DeleteSuggestionRequest": { - "description": "Deletes a suggestion. Returns a 403 forbidden error if the requesting user is not the author of the suggestion. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Deletes a suggestion. Returns a 403 forbidden error if the requesting user is not the author of the suggestion.", "id": "DeleteSuggestionRequest", "properties": { "suggestionId": { @@ -1207,14 +1207,14 @@ "description": "Output only. The main body of the document. Legacy field: Instead, use Document.tabs.documentTab.body, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document." }, "comments": { - "description": "Output only. The comments associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Output only. The comments associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`).", "items": { "$ref": "CommentThread" }, "type": "array" }, "commentsViewMode": { - "description": "Output only. The comments view mode applied to the document. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Output only. The comments view mode applied to the document.", "enum": [ "COMMENTS_VIEW_MODE_UNSPECIFIED", "COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS", @@ -1309,7 +1309,7 @@ "type": "object" }, "suggestions": { - "description": "Output only. The suggestions associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Output only. The suggestions associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`).", "items": { "$ref": "SuggestionThread" }, @@ -1549,7 +1549,7 @@ "additionalProperties": { "$ref": "CommentAnchor" }, - "description": "The comment anchors in a document tab, keyed by anchor ID. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "The comment anchors in a document tab, keyed by anchor ID. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`).", "type": "object" }, "documentStyle": { @@ -2315,7 +2315,7 @@ "type": "object" }, "InsertCommentRequest": { - "description": "Inserts a CommentThread into the document. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Inserts a CommentThread into the document.", "id": "InsertCommentRequest", "properties": { "assigneeEmailAddress": { @@ -2334,7 +2334,7 @@ "type": "object" }, "InsertCommentResponse": { - "description": "Response message for inserting a comment. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Response message for inserting a comment.", "id": "InsertCommentResponse", "properties": { "commentThread": { @@ -3652,7 +3652,7 @@ "type": "object" }, "Post": { - "description": "Represents a single post in a comment or suggestion thread. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Represents a single post in a comment or suggestion thread.", "id": "Post", "properties": { "assigneeEmail": { @@ -3737,7 +3737,7 @@ "type": "object" }, "PostAuthor": { - "description": "Represents a user who authored a comment or suggestion post. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Represents a user who authored a comment or suggestion post.", "id": "PostAuthor", "properties": { "anonymous": { @@ -3785,7 +3785,7 @@ "type": "object" }, "RejectSuggestionRequest": { - "description": "Rejects a suggestion. Returns a 403 forbidden error if the requesting user does not have edit access to the document and is not the author of the suggestion. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Rejects a suggestion. Returns a 403 forbidden error if the requesting user does not have edit access to the document and is not the author of the suggestion.", "id": "RejectSuggestionRequest", "properties": { "suggestionId": { @@ -3886,11 +3886,11 @@ "properties": { "acceptSuggestion": { "$ref": "AcceptSuggestionRequest", - "description": "Accepts a suggestion. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "Accepts a suggestion." }, "addCommentReply": { "$ref": "AddCommentReplyRequest", - "description": "Adds a reply to a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "Adds a reply to a CommentThread or SuggestionThread." }, "addDocumentTab": { "$ref": "AddDocumentTabRequest", @@ -3922,11 +3922,11 @@ }, "deleteComment": { "$ref": "DeleteCommentRequest", - "description": "Deletes a CommentThread. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "Deletes a CommentThread." }, "deleteCommentReply": { "$ref": "DeleteCommentReplyRequest", - "description": "Deletes a reply Post from a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "Deletes a reply Post from a CommentThread or SuggestionThread." }, "deleteContentRange": { "$ref": "DeleteContentRangeRequest", @@ -3958,7 +3958,7 @@ }, "deleteSuggestion": { "$ref": "DeleteSuggestionRequest", - "description": "Deletes a suggestion. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "Deletes a suggestion." }, "deleteTab": { "$ref": "DeleteTabRequest", @@ -3974,7 +3974,7 @@ }, "insertComment": { "$ref": "InsertCommentRequest", - "description": "Inserts a CommentThread into the document. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "Inserts a CommentThread into the document." }, "insertDate": { "$ref": "InsertDateRequest", @@ -4030,7 +4030,7 @@ }, "rejectSuggestion": { "$ref": "RejectSuggestionRequest", - "description": "Rejects a suggestion. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "Rejects a suggestion." }, "replaceAllText": { "$ref": "ReplaceAllTextRequest", @@ -4050,7 +4050,7 @@ }, "updateCommentPost": { "$ref": "UpdateCommentPostRequest", - "description": "Updates an existing post (head post or reply) of a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "Updates an existing post (head post or reply) of a CommentThread or SuggestionThread." }, "updateDocumentStyle": { "$ref": "UpdateDocumentStyleRequest", @@ -4105,7 +4105,7 @@ "properties": { "addCommentReply": { "$ref": "AddCommentReplyResponse", - "description": "The result of adding a reply to a comment or suggestion. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "The result of adding a reply to a comment or suggestion." }, "addDocumentTab": { "$ref": "AddDocumentTabResponse", @@ -4133,7 +4133,7 @@ }, "insertComment": { "$ref": "InsertCommentResponse", - "description": "The result of inserting a comment. [Developer Preview](https://developers.google.com/workspace/preview)." + "description": "The result of inserting a comment." }, "insertDropdown": { "$ref": "InsertDropdownResponse", @@ -4725,7 +4725,7 @@ "type": "object" }, "SuggestionResponse": { - "description": "The suggestions which were affected by a given update. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "The suggestions which were affected by a given update.", "id": "SuggestionResponse", "properties": { "acceptedSuggestionIds": { @@ -4767,7 +4767,7 @@ "type": "object" }, "SuggestionThread": { - "description": "Represents a single suggestion thread. Suggestion threads are created as a byproduct of saving changes to the document while in suggestion mode, and cannot be created directly. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Represents a single suggestion thread. Suggestion threads are created as a byproduct of saving changes to the document while in suggestion mode, and cannot be created directly.", "id": "SuggestionThread", "properties": { "headPost": { @@ -5506,7 +5506,7 @@ "type": "object" }, "UpdateCommentPostRequest": { - "description": "Updates a Post in a CommentThread or SuggestionThread. Returns a 400 bad request error if: - The post is the headPost of a SuggestionThread. - The requesting user is not the author of the post. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "Updates a Post in a CommentThread or SuggestionThread. Returns a 400 bad request error if: - The post is the headPost of a SuggestionThread. - The requesting user is not the author of the post.", "id": "UpdateCommentPostRequest", "properties": { "commentId": { @@ -5808,7 +5808,7 @@ "type": "string" }, "writeMode": { - "description": "How the request updates should be applied to the document. If unspecified, the request updates will be applied as normal edits. [Developer Preview](https://developers.google.com/workspace/preview).", + "description": "How the request updates should be applied to the document. If unspecified, the request updates will be applied as normal edits.", "enum": [ "WRITE_MODE_UNSPECIFIED", "EDIT", @@ -5817,7 +5817,7 @@ "enumDescriptions": [ "The write mode is unspecified. Defaults to EDIT behavior.", "Apply all updates as normal edits.", - "Apply all updates as suggestions. [Developer Preview](https://developers.google.com/workspace/preview)." + "Apply all updates as suggestions." ], "type": "string" } diff --git a/discovery/eventarc-v1.json b/discovery/eventarc-v1.json index b46997cdc5..810c9d67b3 100644 --- a/discovery/eventarc-v1.json +++ b/discovery/eventarc-v1.json @@ -2527,7 +2527,7 @@ } } }, - "revision": "20260612", + "revision": "20261002", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { @@ -4128,7 +4128,7 @@ "type": "string" }, "eventFilters": { - "description": "Required. Unordered list. The list of filters that applies to event attributes. Only events that match all the provided filters are sent to the destination.", + "description": "Optional. Unordered list. The list of filters that applies to event attributes. Only events that match all the provided filters are sent to the destination.", "items": { "$ref": "EventFilter" }, diff --git a/discovery/file-v1beta1.json b/discovery/file-v1beta1.json index aef760ff4a..98a07556d1 100644 --- a/discovery/file-v1beta1.json +++ b/discovery/file-v1beta1.json @@ -1630,6 +1630,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "createFromSource": { + "description": "Creates a volume in a volume pool from an existing data source (such as a Filestore backup).", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/volumePools/{volumePoolsId}/volumes:createFromSource", + "httpMethod": "POST", + "id": "file.projects.locations.volumePools.volumes.createFromSource", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource where this volume will be created. Format: projects/{project}/locations/{location}/volumePools/{volume_pool}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumePools/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}/volumes:createFromSource", + "request": { + "$ref": "CreateFromSourceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "delete": { "description": "Deletes a volume.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/volumePools/{volumePoolsId}/volumes/{volumesId}", @@ -1655,6 +1683,67 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "directCreate": { + "description": "Creates a volume directly on the CLH, bypassing CCFE. This is a temporary PoC that will be used for testing and removed.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/volumePools/{volumePoolsId}/volumes:directCreate", + "httpMethod": "POST", + "id": "file.projects.locations.volumePools.volumes.directCreate", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent volume pool path, in the format `projects/{project}/locations/{location}/volumePools/{volume_pool}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumePools/[^/]+$", + "required": true, + "type": "string" + }, + "volumeId": { + "description": "Required. The ID to use for the volume. The ID must be unique within the specified volume pool.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+parent}/volumes:directCreate", + "request": { + "$ref": "Volume" + }, + "response": { + "$ref": "Volume" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "directDelete": { + "description": "Deletes a volume directly on the CLH, bypassing CCFE. This is a temporary PoC that will be used for testing and removed.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/volumePools/{volumePoolsId}/volumes/{volumesId}:directDelete", + "httpMethod": "POST", + "id": "file.projects.locations.volumePools.volumes.directDelete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The volume resource name, in the format `projects/{project}/locations/{location}/volumePools/{volume_pool}/volumes/{volume}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumePools/[^/]+/volumes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:directDelete", + "request": { + "$ref": "DeleteVolumeRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "get": { "description": "Gets the details of a specific volume.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/volumePools/{volumePoolsId}/volumes/{volumesId}", @@ -1725,6 +1814,68 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "patch": { + "description": "Updates the settings of a specific volume.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/volumePools/{volumePoolsId}/volumes/{volumesId}", + "httpMethod": "PATCH", + "id": "file.projects.locations.volumePools.volumes.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The resource name of the volume, in the format `projects/{project}/locations/{location}/volumePools/{volume_pool}/volumes/{volume}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumePools/[^/]+/volumes/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. Mask of fields to update. At least one path must be supplied in this field.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "request": { + "$ref": "Volume" + }, + "response": { + "$ref": "Volume" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "unfreeze": { + "description": "Unfreezes a volume.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/volumePools/{volumePoolsId}/volumes/{volumesId}:unfreeze", + "httpMethod": "POST", + "id": "file.projects.locations.volumePools.volumes.unfreeze", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the volume to unfreeze. Format: `projects/{project}/locations/{location}/volumePools/{volume_pool}/volumes/{volume}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumePools/[^/]+/volumes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:unfreeze", + "request": { + "$ref": "UnfreezeVolumeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -1735,7 +1886,7 @@ } } }, - "revision": "20260827", + "revision": "20260927", "rootUrl": "https://file.googleapis.com/", "schemas": { "AcquireShareRequest": { @@ -1918,6 +2069,33 @@ "properties": {}, "type": "object" }, + "CreateFromSourceRequest": { + "description": "Request for creating a volume from an existing data source (such as a backup).", + "id": "CreateFromSourceRequest", + "properties": { + "backup": { + "description": "The resource name of the backup to create from. Format: projects/{project}/locations/{location}/backups/{backup}", + "type": "string" + }, + "ipAcls": { + "description": "Optional. IP ACLs defining permissions/ACLs to apply to the newly created volume.", + "items": { + "$ref": "NfsExportOptions" + }, + "type": "array" + }, + "quota": { + "description": "Optional. The limit for how much data can be written to this volume, in MiB.", + "format": "int64", + "type": "string" + }, + "volumeId": { + "description": "Required. Unique identifier for the volume which also appears in the volumes resource name.", + "type": "string" + } + }, + "type": "object" + }, "DailyCycle": { "description": "Time window specified for daily operations.", "id": "DailyCycle", @@ -1956,6 +2134,12 @@ }, "type": "object" }, + "DeleteVolumeRequest": { + "description": "DeleteVolumeRequest deletes a volume.", + "id": "DeleteVolumeRequest", + "properties": {}, + "type": "object" + }, "DenyMaintenancePeriod": { "description": "DenyMaintenancePeriod definition. Maintenance is forbidden within the deny period. The start_date must be less than the end_date.", "id": "DenyMaintenancePeriod", @@ -3615,6 +3799,25 @@ }, "type": "object" }, + "UnfreezeVolumeRequest": { + "description": "Request for unfreezing a volume.", + "id": "UnfreezeVolumeRequest", + "properties": { + "ipAcls": { + "description": "Optional. IP ACLs defining permissions/ACLs to apply to the unfrozen volume", + "items": { + "$ref": "NfsExportOptions" + }, + "type": "array" + }, + "quota": { + "description": "Optional. The limit for how much data can be written to this volume, in MiB.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "UpdatePolicy": { "description": "Maintenance policy applicable to instance updates.", "id": "UpdatePolicy", @@ -3667,6 +3870,13 @@ "description": "Optional. A description of the volume with 2048 characters or less. Requests with longer descriptions will be rejected.", "type": "string" }, + "ipAcls": { + "description": "Optional. User-defined permissions protecting mount points.", + "items": { + "$ref": "NfsExportOptions" + }, + "type": "array" + }, "labels": { "additionalProperties": { "type": "string" @@ -3682,6 +3892,29 @@ "name": { "description": "Identifier. The resource name of the volume, in the format `projects/{project}/locations/{location}/volumePools/{volume_pool}/volumes/{volume}`.", "type": "string" + }, + "quotaMib": { + "description": "Optional. The maximum size of the volume in mebibytes (MiB).", + "format": "int64", + "type": "string" + }, + "state": { + "description": "Optional. The state of the volume. This field is caller-settable via `UpdateVolume` to transition a volume from `HOT` to `COLD` (freezing the volume). In `CreateVolume`, this field is output-only and initialized to `HOT`.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "HOT", + "WARM", + "COLD" + ], + "enumDescriptions": [ + "The state of the volume is unknown.", + "The volume is being created.", + "The volume is hot and bound to a physical share.", + "The volume is warm - volume is unmountable and doesn't count as an active share, but is on hot storage.", + "The volume is cold and released from its physical share." + ], + "type": "string" } }, "type": "object" @@ -3690,6 +3923,11 @@ "description": "VolumePool representation of a Cloud Filestore volume pool.", "id": "VolumePool", "properties": { + "activeVolumeCount": { + "description": "Optional. The number of active volumes. Default: 100.", + "format": "int32", + "type": "integer" + }, "activeVolumeIops": { "description": "Optional. The number of IOPs provisioned per active volume.", "format": "int32", @@ -3702,7 +3940,7 @@ "type": "string" }, "defaultVolumeQuotaMib": { - "description": "Optional. The default quota per volume in MiB. Default: 1024 MiB.", + "description": "Optional. The default quota per volume in MiB. Must be between 100 MiB and 102400 MiB (100 GiB). Default: 1024 MiB.", "format": "int32", "type": "integer" }, @@ -3725,6 +3963,23 @@ "description": "Required. The VPC network to which the VolumePool should be attached. Only Private Service Connect (PSC) is supported.", "type": "string" }, + "state": { + "description": "Output only. The state of the volume pool.", + "enum": [ + "STATE_UNSPECIFIED", + "READY", + "DELETING", + "INVALID" + ], + "enumDescriptions": [ + "State is not specified.", + "Volume pool is available for use.", + "Volume pool is being deleted.", + "Volume pool is in an invalid state." + ], + "readOnly": true, + "type": "string" + }, "uid": { "description": "Output only. System-assigned unique identifier for the volume pool.", "readOnly": true, diff --git a/discovery/firebasecrashlytics-v1alpha.json b/discovery/firebasecrashlytics-v1alpha.json index 5d5f8ba17a..387a9a88d1 100644 --- a/discovery/firebasecrashlytics-v1alpha.json +++ b/discovery/firebasecrashlytics-v1alpha.json @@ -739,7 +739,7 @@ "type": "string" }, "pageSize": { - "description": "Optional. The maximum number of result groups to return. If omitted, defaults to 25.", + "description": "Optional. The maximum number of result groups to return. The maximum value is 100; values above 100 will be coerced to 100. If omitted, defaults to 25.", "format": "int32", "location": "query", "type": "integer" @@ -852,7 +852,7 @@ } } }, - "revision": "20261005", + "revision": "20261008", "rootUrl": "https://firebasecrashlytics.googleapis.com/", "schemas": { "BatchGetEventsResponse": { diff --git a/discovery/firebasedataconnect-v1.json b/discovery/firebasedataconnect-v1.json index 9b7d5eed14..f15b314a02 100644 --- a/discovery/firebasedataconnect-v1.json +++ b/discovery/firebasedataconnect-v1.json @@ -997,6 +997,259 @@ } } }, + "postgrest": { + "methods": { + "postgrestDelete": { + "description": "Executes a dynamic DELETE mutation on rows matching the URL filters.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "DELETE", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestDelete", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to delete from.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestInsert": { + "description": "Executes a dynamic INSERT (create) or UPSERT mutation on a target table.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "POST", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestInsert", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to insert into.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "request": { + "$ref": "HttpBody" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestSelect": { + "description": "Executes a dynamic SELECT (read) query on a target PostgreSQL table. Projections, filters, sorting, and embeddings are mapped from the HTTP URL query parameters.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "GET", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestSelect", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to select from.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestUpdate": { + "description": "Executes a dynamic UPDATE (modify) mutation on rows matching the URL filters.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "PATCH", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestUpdate", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to update.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "request": { + "$ref": "HttpBody" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestUpsert": { + "description": "Executes a dynamic UPSERT (replace or create) mutation on a target table identified by primary key filters.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "PUT", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestUpsert", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to upsert into.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "request": { + "$ref": "HttpBody" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "rpc": { + "methods": { + "postgrestCallFunction": { + "description": "Executes a PostgreSQL database function.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/rpc/{rpcId}", + "httpMethod": "POST", + "id": "firebasedataconnect.projects.locations.services.postgrest.rpc.postgrestCallFunction", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectFunction" + ], + "parameters": { + "firebasedataconnectFunction": { + "description": "Required. The name of the database function.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + }, + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+firebasedataconnectService}/postgrest/rpc/{+firebasedataconnectFunction}", + "request": { + "$ref": "HttpBody" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestQueryFunction": { + "description": "Executes a read-only PostgreSQL database function.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/rpc/{rpcId}", + "httpMethod": "GET", + "id": "firebasedataconnect.projects.locations.services.postgrest.rpc.postgrestQueryFunction", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectFunction" + ], + "parameters": { + "firebasedataconnectFunction": { + "description": "Required. The name of the database function.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + }, + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+firebasedataconnectService}/postgrest/rpc/{+firebasedataconnectFunction}", + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, "schemas": { "methods": { "create": { @@ -1249,7 +1502,7 @@ } } }, - "revision": "20260927", + "revision": "20261004", "rootUrl": "https://firebasedataconnect.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -1813,6 +2066,33 @@ }, "type": "object" }, + "HttpBody": { + "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", + "id": "HttpBody", + "properties": { + "contentType": { + "description": "The HTTP Content-Type header value specifying the content type of the body.", + "type": "string" + }, + "data": { + "description": "The HTTP request/response body as raw binary.", + "format": "byte", + "type": "string" + }, + "extensions": { + "description": "Application specific response metadata. Must be set in the first response for streaming APIs.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + } + }, + "type": "object" + }, "HttpGraphql": { "description": "Settings for HTTP GraphQL server webhook.", "id": "HttpGraphql", diff --git a/discovery/firebasedataconnect-v1beta.json b/discovery/firebasedataconnect-v1beta.json index fd5658dbd2..25115050ac 100644 --- a/discovery/firebasedataconnect-v1beta.json +++ b/discovery/firebasedataconnect-v1beta.json @@ -997,6 +997,259 @@ } } }, + "postgrest": { + "methods": { + "postgrestDelete": { + "description": "Executes a dynamic DELETE mutation on rows matching the URL filters.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "DELETE", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestDelete", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to delete from.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestInsert": { + "description": "Executes a dynamic INSERT (create) or UPSERT mutation on a target table.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "POST", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestInsert", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to insert into.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "request": { + "$ref": "HttpBody" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestSelect": { + "description": "Executes a dynamic SELECT (read) query on a target PostgreSQL table. Projections, filters, sorting, and embeddings are mapped from the HTTP URL query parameters.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "GET", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestSelect", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to select from.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestUpdate": { + "description": "Executes a dynamic UPDATE (modify) mutation on rows matching the URL filters.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "PATCH", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestUpdate", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to update.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "request": { + "$ref": "HttpBody" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestUpsert": { + "description": "Executes a dynamic UPSERT (replace or create) mutation on a target table identified by primary key filters.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/{postgrestId}", + "httpMethod": "PUT", + "id": "firebasedataconnect.projects.locations.services.postgrest.postgrestUpsert", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectTable" + ], + "parameters": { + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + }, + "firebasedataconnectTable": { + "description": "Required. The name of the table to upsert into.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}", + "request": { + "$ref": "HttpBody" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "rpc": { + "methods": { + "postgrestCallFunction": { + "description": "Executes a PostgreSQL database function.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/rpc/{rpcId}", + "httpMethod": "POST", + "id": "firebasedataconnect.projects.locations.services.postgrest.rpc.postgrestCallFunction", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectFunction" + ], + "parameters": { + "firebasedataconnectFunction": { + "description": "Required. The name of the database function.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + }, + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+firebasedataconnectService}/postgrest/rpc/{+firebasedataconnectFunction}", + "request": { + "$ref": "HttpBody" + }, + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "postgrestQueryFunction": { + "description": "Executes a read-only PostgreSQL database function.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/services/{servicesId}/postgrest/rpc/{rpcId}", + "httpMethod": "GET", + "id": "firebasedataconnect.projects.locations.services.postgrest.rpc.postgrestQueryFunction", + "parameterOrder": [ + "firebasedataconnectService", + "firebasedataconnectFunction" + ], + "parameters": { + "firebasedataconnectFunction": { + "description": "Required. The name of the database function.", + "location": "path", + "pattern": "^.*$", + "required": true, + "type": "string" + }, + "firebasedataconnectService": { + "description": "Required. The resource name of the service, in the format: `projects/{project}/locations/{location}/services/{service}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+firebasedataconnectService}/postgrest/rpc/{+firebasedataconnectFunction}", + "response": { + "$ref": "HttpBody" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + }, "schemas": { "methods": { "create": { @@ -1249,7 +1502,7 @@ } } }, - "revision": "20260927", + "revision": "20261004", "rootUrl": "https://firebasedataconnect.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -1813,6 +2066,33 @@ }, "type": "object" }, + "HttpBody": { + "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", + "id": "HttpBody", + "properties": { + "contentType": { + "description": "The HTTP Content-Type header value specifying the content type of the body.", + "type": "string" + }, + "data": { + "description": "The HTTP request/response body as raw binary.", + "format": "byte", + "type": "string" + }, + "extensions": { + "description": "Application specific response metadata. Must be set in the first response for streaming APIs.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + } + }, + "type": "object" + }, "HttpGraphql": { "description": "Settings for HTTP GraphQL server webhook.", "id": "HttpGraphql", diff --git a/discovery/gmail-v1.json b/discovery/gmail-v1.json index b90bd4a796..4d3cf6ea14 100644 --- a/discovery/gmail-v1.json +++ b/discovery/gmail-v1.json @@ -3091,7 +3091,7 @@ } } }, - "revision": "20260727", + "revision": "20261005", "rootUrl": "https://gmail.googleapis.com/", "schemas": { "AutoForwarding": { @@ -3300,7 +3300,7 @@ }, "kaclsKeyMetadata": { "$ref": "KaclsKeyMetadata", - "description": "Metadata for a private key instance managed by an external key access control list service." + "description": "Metadata for a private key instance managed by an external key access control list service. The maximum size of the KACLS data field is 8 KiB." }, "privateKeyMetadataId": { "description": "Output only. The immutable ID for the private key metadata instance.", @@ -3639,15 +3639,15 @@ "type": "object" }, "KaclsKeyMetadata": { - "description": "Metadata for private keys managed by an external key access control list service. For details about managing key access, see [Google Workspace CSE API Reference](https://developers.google.com/workspace/cse/reference).", + "description": "Metadata for a cryptographic key managed by an external key access control list service. For details about managing key access, see [Google Workspace CSE API Reference](https://developers.google.com/workspace/cse/reference).", "id": "KaclsKeyMetadata", "properties": { "kaclsData": { - "description": "Opaque data generated and used by the key access control list service. Maximum size: 8 KiB.", + "description": "Opaque data generated and used by the key access control list service.", "type": "string" }, "kaclsUri": { - "description": "The URI of the key access control list service that manages the private key.", + "description": "The URI of the key access control list service that manages the key.", "type": "string" } }, diff --git a/discovery/health-v4.json b/discovery/health-v4.json index f980f8d3a3..28a097e8a8 100644 --- a/discovery/health-v4.json +++ b/discovery/health-v4.json @@ -704,7 +704,7 @@ ], "parameters": { "parent": { - "description": "Optional. Parent (data type) for the Data Point collection Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/-` For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field.", + "description": "Optional. Parent (data type) for the Data Point collection Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/-` - `users/1234567890/dataTypes/-` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -738,7 +738,7 @@ ], "parameters": { "parent": { - "description": "Required. The parent resource name where the data point will be created. Format: `users/{user}/dataTypes/{data_type}`", + "description": "Required. The parent resource name where the data point will be created. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity).", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -772,7 +772,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the DailyRollupDataPoint value union field.", + "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DailyRollupDataPoint value union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -806,7 +806,7 @@ ] }, "exportExerciseTcx": { - "description": "Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. Example: `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed.", + "description": "Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. ## Examples: ## `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` `https://health.googleapis.com/v4/users/1234567890/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed.", "flatPath": "v4/users/{usersId}/dataTypes/{dataTypesId}/dataPoints/{dataPointsId}:exportExerciseTcx", "httpMethod": "GET", "id": "health.users.dataTypes.dataPoints.exportExerciseTcx", @@ -815,7 +815,7 @@ ], "parameters": { "name": { - "description": "Required. The resource name of the exercise data point to export. Format: `users/{user}/dataTypes/exercise/dataPoints/{data_point}` Example: `users/me/dataTypes/exercise/dataPoints/2026443605080188808` The `{user}` is the alias `\"me\"` currently. Future versions may support user IDs. The `{data_point}` ID maps to the exercise ID, which is a long integer.", + "description": "Required. The resource name of the exercise data point to export. Format: `users/{user}/dataTypes/exercise/dataPoints/{data_point}` Examples: - `users/me/dataTypes/exercise/dataPoints/2026443605080188808` - `users/1234567890/dataTypes/exercise/dataPoints/2026443605080188808` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). The `{data_point}` ID maps to the exercise ID, which is a long integer.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$", "required": true, @@ -848,7 +848,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the data point to retrieve. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` See DataPoint.name for examples and possible values.", + "description": "Required. The name of the data point to retrieve. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$", "required": true, @@ -888,7 +888,7 @@ ], "parameters": { "dataSourceFamily": { - "description": "Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead.", + "description": "Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/{user}/dataSourceFamilies/{data_source_family}` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead.", "location": "query", "type": "string" }, @@ -909,7 +909,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/weight` For a list of the supported data types see the DataPoint data union field.", + "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/weight` - `users/1234567890/dataTypes/weight` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -949,7 +949,7 @@ ], "parameters": { "name": { - "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", + "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$", "required": true, @@ -983,7 +983,7 @@ ], "parameters": { "dataSourceFamily": { - "description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", + "description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/{user}/dataSourceFamilies/{data_source_family}` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "location": "query", "type": "string" }, @@ -1004,7 +1004,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field.", + "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/heart-rate` - `users/1234567890/dataTypes/heart-rate` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -1044,7 +1044,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the RollupDataPoint value union field.", + "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the RollupDataPoint value union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -1149,7 +1149,7 @@ } } }, - "revision": "20261002", + "revision": "20261007", "rootUrl": "https://health.googleapis.com/", "schemas": { "ActiveEnergyBurned": { @@ -2004,7 +2004,7 @@ "id": "DailyRollUpDataPointsRequest", "properties": { "dataSourceFamily": { - "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", + "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/{user}/dataSourceFamilies/{data_source_family}` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "type": "string" }, "pageSize": { @@ -2351,7 +2351,7 @@ "description": "Optional. Data for points in the `moods` sample data type collection." }, "name": { - "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", + "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "type": "string" }, "nutritionLog": { @@ -3459,7 +3459,7 @@ "id": "GoogleDevicesandservicesHealthV4DataType", "properties": { "name": { - "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}` See DataPoint.name for examples and possible values.", + "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values.", "type": "string" } }, @@ -3492,7 +3492,7 @@ "id": "GoogleDevicesandservicesHealthV4betaDataType", "properties": { "name": { - "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}` See DataPoint.name for examples and possible values.", + "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values.", "type": "string" } }, @@ -5005,7 +5005,7 @@ "description": "Data for points in the `daily-vo2-max` daily data type collection." }, "dataPointName": { - "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", + "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "type": "string" }, "distance": { @@ -5154,7 +5154,7 @@ "id": "RollUpDataPointsRequest", "properties": { "dataSourceFamily": { - "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", + "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/{user}/dataSourceFamilies/{data_source_family}` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "type": "string" }, "pageSize": { diff --git a/discovery/health-v4beta.json b/discovery/health-v4beta.json index d3f7635f63..f0d05b4083 100644 --- a/discovery/health-v4beta.json +++ b/discovery/health-v4beta.json @@ -704,7 +704,7 @@ ], "parameters": { "parent": { - "description": "Optional. Parent (data type) for the Data Point collection Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/-` For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field.", + "description": "Optional. Parent (data type) for the Data Point collection Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/-` - `users/1234567890/dataTypes/-` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -738,7 +738,7 @@ ], "parameters": { "parent": { - "description": "Required. The parent resource name where the data point will be created. Format: `users/{user}/dataTypes/{data_type}`", + "description": "Required. The parent resource name where the data point will be created. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity).", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -772,7 +772,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the DailyRollupDataPoint value union field.", + "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DailyRollupDataPoint value union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -806,7 +806,7 @@ ] }, "exportExerciseTcx": { - "description": "Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. Example: `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed.", + "description": "Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. ## Examples: ## `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` `https://health.googleapis.com/v4/users/1234567890/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed.", "flatPath": "v4beta/users/{usersId}/dataTypes/{dataTypesId}/dataPoints/{dataPointsId}:exportExerciseTcx", "httpMethod": "GET", "id": "health.users.dataTypes.dataPoints.exportExerciseTcx", @@ -815,7 +815,7 @@ ], "parameters": { "name": { - "description": "Required. The resource name of the exercise data point to export. Format: `users/{user}/dataTypes/exercise/dataPoints/{data_point}` Example: `users/me/dataTypes/exercise/dataPoints/2026443605080188808` The `{user}` is the alias `\"me\"` currently. Future versions may support user IDs. The `{data_point}` ID maps to the exercise ID, which is a long integer.", + "description": "Required. The resource name of the exercise data point to export. Format: `users/{user}/dataTypes/exercise/dataPoints/{data_point}` Examples: - `users/me/dataTypes/exercise/dataPoints/2026443605080188808` - `users/1234567890/dataTypes/exercise/dataPoints/2026443605080188808` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). The `{data_point}` ID maps to the exercise ID, which is a long integer.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$", "required": true, @@ -848,7 +848,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the data point to retrieve. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` See DataPoint.name for examples and possible values.", + "description": "Required. The name of the data point to retrieve. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$", "required": true, @@ -888,7 +888,7 @@ ], "parameters": { "dataSourceFamily": { - "description": "Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead.", + "description": "Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/{user}/dataSourceFamilies/{data_source_family}` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead.", "location": "query", "type": "string" }, @@ -909,7 +909,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/weight` For a list of the supported data types see the DataPoint data union field.", + "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/weight` - `users/1234567890/dataTypes/weight` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -949,7 +949,7 @@ ], "parameters": { "name": { - "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", + "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+/dataPoints/[^/]+$", "required": true, @@ -983,7 +983,7 @@ ], "parameters": { "dataSourceFamily": { - "description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", + "description": "Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/{user}/dataSourceFamilies/{data_source_family}` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "location": "query", "type": "string" }, @@ -1004,7 +1004,7 @@ "type": "string" }, "parent": { - "description": "Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field.", + "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/heart-rate` - `users/1234567890/dataTypes/heart-rate` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -1044,7 +1044,7 @@ ], "parameters": { "parent": { - "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the RollupDataPoint value union field.", + "description": "Required. Parent data type of the Data Point collection. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the RollupDataPoint value union field.", "location": "path", "pattern": "^users/[^/]+/dataTypes/[^/]+$", "required": true, @@ -1149,7 +1149,7 @@ } } }, - "revision": "20261002", + "revision": "20261007", "rootUrl": "https://health.googleapis.com/", "schemas": { "ActiveEnergyBurned": { @@ -2004,7 +2004,7 @@ "id": "DailyRollUpDataPointsRequest", "properties": { "dataSourceFamily": { - "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", + "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/{user}/dataSourceFamilies/{data_source_family}` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "type": "string" }, "pageSize": { @@ -2355,7 +2355,7 @@ "description": "Optional. Data for points in the `moods` sample data type collection." }, "name": { - "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", + "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "type": "string" }, "nutritionLog": { @@ -3471,7 +3471,7 @@ "id": "GoogleDevicesandservicesHealthV4DataType", "properties": { "name": { - "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}` See DataPoint.name for examples and possible values.", + "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values.", "type": "string" } }, @@ -3504,7 +3504,7 @@ "id": "GoogleDevicesandservicesHealthV4betaDataType", "properties": { "name": { - "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}` See DataPoint.name for examples and possible values.", + "description": "Identifier. The resource name of the data type. Format: `users/{user}/dataTypes/{data_type}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values.", "type": "string" } }, @@ -5017,7 +5017,7 @@ "description": "Data for points in the `daily-vo2-max` daily data type collection." }, "dataPointName": { - "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", + "description": "Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user}/dataTypes/{data_type}/dataPoints/{data_point}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens.", "type": "string" }, "distance": { @@ -5174,7 +5174,7 @@ "id": "RollUpDataPointsRequest", "properties": { "dataSourceFamily": { - "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", + "description": "Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/{user}/dataSourceFamilies/{data_source_family}` The `{user}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error.", "type": "string" }, "pageSize": { @@ -5679,7 +5679,7 @@ "type": "object" }, "SkinTemperature": { - "description": "////////////////////////////////////////////////////////////////////////// SkinTemperature ////////////////////////////////////////////////////////////////////////// Skin temperature measurement.", + "description": "Skin temperature measurement.", "id": "SkinTemperature", "properties": { "baselineTemperatureCelsius": { diff --git a/discovery/integrations-v2.json b/discovery/integrations-v2.json index b849713cbf..dee81a2bd5 100644 --- a/discovery/integrations-v2.json +++ b/discovery/integrations-v2.json @@ -459,7 +459,7 @@ } } }, - "revision": "20260927", + "revision": "20261004", "rootUrl": "https://integrations.googleapis.com/", "schemas": { "EnterpriseCrmEventbusAuthconfigAuthConfigTaskParam": { @@ -3508,7 +3508,7 @@ "type": "object" }, "GoogleInternalCloudCrmEventbusV3PostToQueueWithTriggerIdRequest": { - "description": "LINT.IfChange Use this request to post all workflows associated with a given trigger id. Next available id: 13", + "description": "LINT.IfChange Use this request to post all workflows associated with a given trigger id. Next available id: 14", "id": "GoogleInternalCloudCrmEventbusV3PostToQueueWithTriggerIdRequest", "properties": { "clientId": { @@ -3571,6 +3571,10 @@ "description": "This is a unique id provided by the method caller. If provided this will be used as the execution_id when a new execution info is created. This is a string representation of a UUID. Must have no more than 36 characters and contain only alphanumeric characters and hyphens.", "type": "string" }, + "workflowId": { + "description": "Optional. Pins the enqueue to this exact version rather than the ACTIVE one on the trigger, so an unpublished draft can be tested. Requires client_id, and the version is validated before it is enqueued; see integrationplatform/api/executionsservice/README.md.", + "type": "string" + }, "workflowName": { "description": "Optional. If provided, the workflow_name is used to filter all the matched workflows having same trigger_id+client_id. A combination of trigger_id, client_id and workflow_name identifies a unique workflow.", "type": "string" diff --git a/discovery/networkservices-v1.json b/discovery/networkservices-v1.json index 0701fcca80..1abffaf8c4 100644 --- a/discovery/networkservices-v1.json +++ b/discovery/networkservices-v1.json @@ -4209,7 +4209,7 @@ } } }, - "revision": "20260921", + "revision": "20261004", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AgentConnectivityTemplate": { @@ -4253,13 +4253,15 @@ "AGENT_COMPUTE_UNSPECIFIED", "GKE", "CLOUD_RUN", - "BORG" + "BORG", + "GCE_VM" ], "enumDescriptions": [ "Unspecified compute type.", "Google Kubernetes Engine.", "Google Cloud Run.", - "Google Borg (for 1P producers)." + "Google Borg (for 1P producers).", + "Google Compute Engine VM." ], "type": "string" }, @@ -4954,7 +4956,7 @@ "type": "object" }, "matchConditions": { - "description": "Optional. A list of match conditions to match against the incoming request. The extension will be invoked if at least one condition matches the request, or if no match conditions are specified. Limited to 5 conditions.", + "description": "Optional. A list of match conditions to evaluate against the incoming request. The extension is invoked if the request matches at least one condition, or if no match conditions are specified. A request matches a condition only if it matches every field that is set in that condition. Limited to 5 conditions.", "items": { "$ref": "ExtensionBindingMatchCondition" }, @@ -4965,24 +4967,24 @@ "type": "string" }, "priority": { - "description": "Optional. Priority of the extension binding. Lower numbers indicate higher priority. Priority of extension bindings are used to determine the order in which extension bindings are applied to a request.", + "description": "Optional. Priority of the extension binding. Lower numbers indicate higher priority. The priority determines the order in which extension bindings are applied to a request.", "format": "int32", "type": "integer" }, "producerExtension": { - "description": "Required. The name of the extension that this binding should attach to target resources. Format: For Google-provided extensions, specify the service endpoint (see [Model Armor integration](https://docs.cloud.google.com/model-armor/integrations))", + "description": "Required. The name of the extension that this binding should attach to target resources. Format: For Google-provided extensions, specify the service endpoint, for example `modelarmor.us-central1.rep.googleapis.com`.", "type": "string" }, "producerMetadata": { "additionalProperties": { "type": "string" }, - "description": "Optional. Additional metadata that should be passed to the attached extension with each request.", + "description": "Optional. Additional metadata that should be passed to the attached extension with each request. This field is subject to the following limitations: * The total size of the metadata must be less than 1 KiB. * The total number of keys must be less than 16. * The length of each key must be less than 64 characters. * The length of each value must be less than 1024 characters.", "type": "object" }, "target": { "$ref": "ExtensionBindingTarget", - "description": "Required. Specifies a target to which this `ExtensionBinding` should be attached. The target can be either a single resource or a scope of resources." + "description": "Required. Specifies a target to which this `ExtensionBinding` should be attached." }, "updateTime": { "description": "Output only. The timestamp when the resource was updated.", @@ -5024,23 +5026,23 @@ "id": "ExtensionBindingMatchConditionStringMatch", "properties": { "contains": { - "description": "Optional. The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``", + "description": "Optional. The input string must contain the substring specified here. An empty substring is not allowed. Examples: * `abc` matches the value `xyz.abc.def`.", "type": "string" }, "exact": { - "description": "Optional. The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.", + "description": "Optional. The input string must match exactly the string specified here. Examples: * `abc` only matches the value `abc`.", "type": "string" }, "ignoreCase": { - "description": "Optional. If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.", + "description": "Optional. If true, the `exact`, `prefix`, `suffix`, or `contains` match is case insensitive. For example, the matcher `data` matches both `Data` and `data` when set to true.", "type": "boolean" }, "prefix": { - "description": "Optional. The input string must have the prefix specified here. Note: empty prefix is not allowed. Examples: * ``abc`` matches the value ``abc.xyz``", + "description": "Optional. The input string must have the prefix specified here. An empty prefix is not allowed. Examples: * `abc` matches the value `abc.xyz`.", "type": "string" }, "suffix": { - "description": "Optional. The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``", + "description": "Optional. The input string must have the suffix specified here. An empty suffix is not allowed. Examples: * `abc` matches the value `xyz.abc`.", "type": "string" } }, @@ -5052,7 +5054,7 @@ "properties": { "destination": { "$ref": "ExtensionBindingMatchConditionToDestination", - "description": "Optional. Describes properties of destination of a request. Within a destination, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches. At least one of destination or not_destination must be specified." + "description": "Optional. Describes properties of the destination of a request. A request matches the destination only if it matches every field that is set. Fields that are not set are always considered a match. For example, if only `hosts` and `paths` are set, a request matches when any host matches and any path matches. At least one of `destination` or `not_destination` must be specified." }, "notDestination": { "$ref": "ExtensionBindingMatchConditionToDestination", @@ -5098,7 +5100,7 @@ "id": "ExtensionBindingMatchConditionToDestinationHeaderSet", "properties": { "headers": { - "description": "Required. A list of headers to match against in http header. If multiple header matches are provided, they will be evaluated as an AND, i.e. all header matches must match for the request to match.", + "description": "Required. A list of HTTP headers to match against. If multiple header matches are provided, they are evaluated as an AND, meaning that all header matches must match for the request to match. Limited to 10 headers.", "items": { "$ref": "ExtensionBindingMatchConditionHeaderMatch" }, @@ -5112,7 +5114,7 @@ "id": "ExtensionBindingTarget", "properties": { "resources": { - "description": "Optional. The reference to the target resource, to which this binding should attach. Exactly one of `resources` or `scope` must be set.", + "description": "Optional. The references to the target resources to which this binding should attach. Exactly one of `resources` or `scope` must be set. For AI Application resources, specify the full resource name in the format: `projects/{project}/locations/{location}/applications/{application}`. Limited to 1 resource.", "items": { "type": "string" }, @@ -5130,11 +5132,11 @@ "id": "ExtensionBindingTargetScope", "properties": { "parent": { - "description": "Required. Parent resource name specification, in the format: `projects/{project_number}`.", + "description": "Required. The parent resource that defines the scope, in the format `projects/{project_number}`. When the scope is a project, the binding applies to the resources that meet all of the following conditions: * The resource belongs to the specified project. * The resource is in the same location as the `ExtensionBinding`. * The resource type is listed in `resource_types`.", "type": "string" }, "resourceTypes": { - "description": "Required. Type of the resource to which the binding should attach. Limited to 1 resource type.", + "description": "Required. The types of resources to which the binding should attach. Limited to 1 resource type.", "items": { "enum": [ "RESOURCE_TYPE_UNSPECIFIED", diff --git a/discovery/networkservices-v1beta1.json b/discovery/networkservices-v1beta1.json index 75ac4570b9..cacd074105 100644 --- a/discovery/networkservices-v1beta1.json +++ b/discovery/networkservices-v1beta1.json @@ -3936,7 +3936,7 @@ } } }, - "revision": "20260921", + "revision": "20261004", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AgentConnectivityTemplate": { @@ -3980,13 +3980,15 @@ "AGENT_COMPUTE_UNSPECIFIED", "GKE", "CLOUD_RUN", - "BORG" + "BORG", + "GCE_VM" ], "enumDescriptions": [ "Unspecified compute type.", "Google Kubernetes Engine.", "Google Cloud Run.", - "Google Borg (for 1P producers)." + "Google Borg (for 1P producers).", + "Google Compute Engine VM." ], "type": "string" }, @@ -4608,7 +4610,7 @@ "type": "object" }, "matchConditions": { - "description": "Optional. A list of match conditions to match against the incoming request. The extension will be invoked if at least one condition matches the request, or if no match conditions are specified. Limited to 5 conditions.", + "description": "Optional. A list of match conditions to evaluate against the incoming request. The extension is invoked if the request matches at least one condition, or if no match conditions are specified. A request matches a condition only if it matches every field that is set in that condition. Limited to 5 conditions.", "items": { "$ref": "ExtensionBindingMatchCondition" }, @@ -4619,24 +4621,24 @@ "type": "string" }, "priority": { - "description": "Optional. Priority of the extension binding. Lower numbers indicate higher priority. Priority of extension bindings are used to determine the order in which extension bindings are applied to a request.", + "description": "Optional. Priority of the extension binding. Lower numbers indicate higher priority. The priority determines the order in which extension bindings are applied to a request.", "format": "int32", "type": "integer" }, "producerExtension": { - "description": "Required. The name of the extension that this binding should attach to target resources. Format: For Google-provided extensions, specify the service endpoint (see [Model Armor integration](https://docs.cloud.google.com/model-armor/integrations))", + "description": "Required. The name of the extension that this binding should attach to target resources. Format: For Google-provided extensions, specify the service endpoint, for example `modelarmor.us-central1.rep.googleapis.com`.", "type": "string" }, "producerMetadata": { "additionalProperties": { "type": "string" }, - "description": "Optional. Additional metadata that should be passed to the attached extension with each request.", + "description": "Optional. Additional metadata that should be passed to the attached extension with each request. This field is subject to the following limitations: * The total size of the metadata must be less than 1 KiB. * The total number of keys must be less than 16. * The length of each key must be less than 64 characters. * The length of each value must be less than 1024 characters.", "type": "object" }, "target": { "$ref": "ExtensionBindingTarget", - "description": "Required. Specifies a target to which this `ExtensionBinding` should be attached. The target can be either a single resource or a scope of resources." + "description": "Required. Specifies a target to which this `ExtensionBinding` should be attached." }, "updateTime": { "description": "Output only. The timestamp when the resource was updated.", @@ -4678,23 +4680,23 @@ "id": "ExtensionBindingMatchConditionStringMatch", "properties": { "contains": { - "description": "Optional. The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``", + "description": "Optional. The input string must contain the substring specified here. An empty substring is not allowed. Examples: * `abc` matches the value `xyz.abc.def`.", "type": "string" }, "exact": { - "description": "Optional. The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.", + "description": "Optional. The input string must match exactly the string specified here. Examples: * `abc` only matches the value `abc`.", "type": "string" }, "ignoreCase": { - "description": "Optional. If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.", + "description": "Optional. If true, the `exact`, `prefix`, `suffix`, or `contains` match is case insensitive. For example, the matcher `data` matches both `Data` and `data` when set to true.", "type": "boolean" }, "prefix": { - "description": "Optional. The input string must have the prefix specified here. Note: empty prefix is not allowed. Examples: * ``abc`` matches the value ``abc.xyz``", + "description": "Optional. The input string must have the prefix specified here. An empty prefix is not allowed. Examples: * `abc` matches the value `abc.xyz`.", "type": "string" }, "suffix": { - "description": "Optional. The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``", + "description": "Optional. The input string must have the suffix specified here. An empty suffix is not allowed. Examples: * `abc` matches the value `xyz.abc`.", "type": "string" } }, @@ -4706,7 +4708,7 @@ "properties": { "destination": { "$ref": "ExtensionBindingMatchConditionToDestination", - "description": "Optional. Describes properties of destination of a request. Within a destination, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches. At least one of destination or not_destination must be specified." + "description": "Optional. Describes properties of the destination of a request. A request matches the destination only if it matches every field that is set. Fields that are not set are always considered a match. For example, if only `hosts` and `paths` are set, a request matches when any host matches and any path matches. At least one of `destination` or `not_destination` must be specified." }, "notDestination": { "$ref": "ExtensionBindingMatchConditionToDestination", @@ -4752,7 +4754,7 @@ "id": "ExtensionBindingMatchConditionToDestinationHeaderSet", "properties": { "headers": { - "description": "Required. A list of headers to match against in http header. If multiple header matches are provided, they will be evaluated as an AND, i.e. all header matches must match for the request to match.", + "description": "Required. A list of HTTP headers to match against. If multiple header matches are provided, they are evaluated as an AND, meaning that all header matches must match for the request to match. Limited to 10 headers.", "items": { "$ref": "ExtensionBindingMatchConditionHeaderMatch" }, @@ -4766,7 +4768,7 @@ "id": "ExtensionBindingTarget", "properties": { "resources": { - "description": "Optional. The reference to the target resource, to which this binding should attach. Exactly one of `resources` or `scope` must be set.", + "description": "Optional. The references to the target resources to which this binding should attach. Exactly one of `resources` or `scope` must be set. For AI Application resources, specify the full resource name in the format: `projects/{project}/locations/{location}/applications/{application}`. Limited to 1 resource.", "items": { "type": "string" }, @@ -4784,11 +4786,11 @@ "id": "ExtensionBindingTargetScope", "properties": { "parent": { - "description": "Required. Parent resource name specification, in the format: `projects/{project_number}`.", + "description": "Required. The parent resource that defines the scope, in the format `projects/{project_number}`. When the scope is a project, the binding applies to the resources that meet all of the following conditions: * The resource belongs to the specified project. * The resource is in the same location as the `ExtensionBinding`. * The resource type is listed in `resource_types`.", "type": "string" }, "resourceTypes": { - "description": "Required. Type of the resource to which the binding should attach. Limited to 1 resource type.", + "description": "Required. The types of resources to which the binding should attach. Limited to 1 resource type.", "items": { "enum": [ "RESOURCE_TYPE_UNSPECIFIED", diff --git a/discovery/run-v1.json b/discovery/run-v1.json index b0e8062411..14818775a0 100644 --- a/discovery/run-v1.json +++ b/discovery/run-v1.json @@ -3652,7 +3652,7 @@ } } }, - "revision": "20260925", + "revision": "20261002", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { @@ -4990,11 +4990,13 @@ "description": "Requested verifiability options.", "enum": [ "NOT_VERIFIED", - "VERIFIED" + "VERIFIED", + "BEST_EFFORT" ], "enumDescriptions": [ "Not a verifiable build (the default).", - "Build must be verified." + "Build must be verified.", + "Build verification is best effort. If provenance generation fails, the build will still succeed." ], "type": "string" }, @@ -5064,6 +5066,43 @@ }, "type": "object" }, + "GoogleDevtoolsCloudbuildV1BuildResourceUsage": { + "description": "Aggregated/summary metrics over the entire build lifecycle.", + "id": "GoogleDevtoolsCloudbuildV1BuildResourceUsage", + "properties": { + "averageCpuUtilization": { + "description": "Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", + "format": "float", + "readOnly": true, + "type": "number" + }, + "averageMemoryUtilization": { + "description": "Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", + "format": "float", + "readOnly": true, + "type": "number" + }, + "peakCpuUtilization": { + "description": "Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", + "format": "float", + "readOnly": true, + "type": "number" + }, + "peakMemoryUtilization": { + "description": "Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", + "format": "float", + "readOnly": true, + "type": "number" + }, + "totalCpuDuration": { + "description": "Output only. Total CPU execution time consumed across all cores during build execution.", + "format": "google-duration", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleDevtoolsCloudbuildV1BuildStep": { "description": "A step in the build pipeline.", "id": "GoogleDevtoolsCloudbuildV1BuildStep", @@ -5377,7 +5416,7 @@ "id": "GoogleDevtoolsCloudbuildV1GenericArtifactDependency", "properties": { "destPath": { - "description": "Required. Where the artifact files should be placed on the worker.", + "description": "Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`.", "type": "string" }, "resource": { @@ -5787,6 +5826,11 @@ "$ref": "GoogleDevtoolsCloudbuildV1UploadedPythonPackage" }, "type": "array" + }, + "resourceUsage": { + "$ref": "GoogleDevtoolsCloudbuildV1BuildResourceUsage", + "description": "Output only. Aggregated metrics for the build.", + "readOnly": true } }, "type": "object" diff --git a/discovery/run-v2.json b/discovery/run-v2.json index 075de59c4e..ec7b73c4e5 100644 --- a/discovery/run-v2.json +++ b/discovery/run-v2.json @@ -2669,7 +2669,7 @@ } } }, - "revision": "20260917", + "revision": "20261002", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -6784,11 +6784,13 @@ "description": "Requested verifiability options.", "enum": [ "NOT_VERIFIED", - "VERIFIED" + "VERIFIED", + "BEST_EFFORT" ], "enumDescriptions": [ "Not a verifiable build (the default).", - "Build must be verified." + "Build must be verified.", + "Build verification is best effort. If provenance generation fails, the build will still succeed." ], "type": "string" }, @@ -6858,6 +6860,43 @@ }, "type": "object" }, + "GoogleDevtoolsCloudbuildV1BuildResourceUsage": { + "description": "Aggregated/summary metrics over the entire build lifecycle.", + "id": "GoogleDevtoolsCloudbuildV1BuildResourceUsage", + "properties": { + "averageCpuUtilization": { + "description": "Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", + "format": "float", + "readOnly": true, + "type": "number" + }, + "averageMemoryUtilization": { + "description": "Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", + "format": "float", + "readOnly": true, + "type": "number" + }, + "peakCpuUtilization": { + "description": "Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", + "format": "float", + "readOnly": true, + "type": "number" + }, + "peakMemoryUtilization": { + "description": "Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", + "format": "float", + "readOnly": true, + "type": "number" + }, + "totalCpuDuration": { + "description": "Output only. Total CPU execution time consumed across all cores during build execution.", + "format": "google-duration", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleDevtoolsCloudbuildV1BuildStep": { "description": "A step in the build pipeline.", "id": "GoogleDevtoolsCloudbuildV1BuildStep", @@ -7171,7 +7210,7 @@ "id": "GoogleDevtoolsCloudbuildV1GenericArtifactDependency", "properties": { "destPath": { - "description": "Required. Where the artifact files should be placed on the worker.", + "description": "Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`.", "type": "string" }, "resource": { @@ -7581,6 +7620,11 @@ "$ref": "GoogleDevtoolsCloudbuildV1UploadedPythonPackage" }, "type": "array" + }, + "resourceUsage": { + "$ref": "GoogleDevtoolsCloudbuildV1BuildResourceUsage", + "description": "Output only. Aggregated metrics for the build.", + "readOnly": true } }, "type": "object" diff --git a/discovery/saasservicemgmt-v1.json b/discovery/saasservicemgmt-v1.json index 2b748f8759..e05b032aaa 100644 --- a/discovery/saasservicemgmt-v1.json +++ b/discovery/saasservicemgmt-v1.json @@ -1866,7 +1866,7 @@ } } }, - "revision": "20260914", + "revision": "20260928", "rootUrl": "https://saasservicemgmt.googleapis.com/", "schemas": { "Aggregate": { @@ -1886,11 +1886,11 @@ "type": "object" }, "Blueprint": { - "description": "Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (e.g. terraform, helm etc) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev).", + "description": "Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev).", "id": "Blueprint", "properties": { "engine": { - "description": "Output only. Type of the engine used to actuate the blueprint. e.g. terraform, helm etc.", + "description": "Output only. Type of the engine used to actuate the blueprint. (Terraform, for example)", "readOnly": true, "type": "string" }, @@ -2281,7 +2281,7 @@ "type": "object" }, "Release": { - "description": "A new version to be propagated and deployed to units. This includes pointers to packaged blueprints for actuation (e.g Helm or Terraform configuration packages) via artifact registry.", + "description": "A new version to be propagated and deployed to units. This includes pointers to packaged blueprints for actuation via Artifact Registry.", "id": "Release", "properties": { "annotations": { @@ -2599,7 +2599,7 @@ "type": "string" }, "unitFilter": { - "description": "Optional. CEL(https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout.", + "description": "Optional. [CEL](https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout.", "type": "string" }, "unitKind": { @@ -2922,7 +2922,7 @@ "type": "object" }, "Unit": { - "description": "A unit of deployment that has its lifecycle via a CRUD API using an actuation engine under the hood (e.g. based on Terraform, Helm or a custom implementation provided by a service producer). A building block of a SaaS Tenant.", + "description": "A unit of deployment that has its lifecycle via a CRUD API using an actuation engine under the hood (e.g. based on Terraform, or a custom implementation provided by a service producer). A building block of a SaaS Tenant.", "id": "Unit", "properties": { "annotations": { @@ -3021,7 +3021,7 @@ "type": "array" }, "outputVariables": { - "description": "Optional. Output only. Set of key/value pairs corresponding to output variables from execution of actuation templates. The variables are declared in actuation configs (e.g in helm chart or terraform) and the values are fetched and returned by the actuation engine upon completion of execution.", + "description": "Optional. Output only. Set of key/value pairs corresponding to output variables from execution of actuation templates. The variables are declared in actuation configs (in Terraform for example) and the values are fetched and returned by the actuation engine upon completion of execution.", "items": { "$ref": "UnitVariable" }, @@ -3247,6 +3247,12 @@ "description": "Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation.", "type": "string" }, + "deleteTime": { + "description": "Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation).", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, "dependencies": { "description": "Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10.", "items": { diff --git a/discovery/saasservicemgmt-v1beta1.json b/discovery/saasservicemgmt-v1beta1.json index 1cca04f523..505fc4116a 100644 --- a/discovery/saasservicemgmt-v1beta1.json +++ b/discovery/saasservicemgmt-v1beta1.json @@ -3323,7 +3323,7 @@ } } }, - "revision": "20260914", + "revision": "20260928", "rootUrl": "https://saasservicemgmt.googleapis.com/", "schemas": { "Aggregate": { @@ -3400,11 +3400,11 @@ "type": "object" }, "Blueprint": { - "description": "Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (e.g. terraform, helm etc) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev).", + "description": "Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev).", "id": "Blueprint", "properties": { "engine": { - "description": "Output only. Type of the engine used to actuate the blueprint. e.g. terraform, helm etc.", + "description": "Output only. Type of the engine used to actuate the blueprint. (Terraform, for example)", "readOnly": true, "type": "string" }, @@ -4540,7 +4540,7 @@ "type": "object" }, "Release": { - "description": "A new version to be propagated and deployed to units. This includes pointers to packaged blueprints for actuation (e.g Helm or Terraform configuration packages) via artifact registry.", + "description": "A new version to be propagated and deployed to units. This includes pointers to packaged blueprints for actuation via Artifact Registry.", "id": "Release", "properties": { "annotations": { @@ -4738,7 +4738,8 @@ "ROLLOUT_STATE_WAITING", "ROLLOUT_STATE_CANCELLING", "ROLLOUT_STATE_RESUMING", - "ROLLOUT_STATE_PAUSING" + "ROLLOUT_STATE_PAUSING", + "ROLLOUT_STATE_AWAITING_APPROVAL" ], "enumDescriptions": [ "Unspecified state.", @@ -4750,7 +4751,8 @@ "Rollout is waiting for some condition to be met before starting.", "Rollout is being canceled.", "Rollout is being resumed.", - "Rollout is being paused." + "Rollout is being paused.", + "Rollout is awaiting manual approval." ], "readOnly": true, "type": "string" @@ -4863,7 +4865,7 @@ "type": "string" }, "unitFilter": { - "description": "Optional. CEL(https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout.", + "description": "Optional. [CEL](https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout.", "type": "string" }, "unitKind": { @@ -5263,7 +5265,7 @@ "type": "object" }, "Unit": { - "description": "A unit of deployment that has its lifecycle via a CRUD API using an actuation engine under the hood (e.g. based on Terraform, Helm or a custom implementation provided by a service producer). A building block of a SaaS Tenant.", + "description": "A unit of deployment that has its lifecycle via a CRUD API using an actuation engine under the hood (e.g. based on Terraform, or a custom implementation provided by a service producer). A building block of a SaaS Tenant.", "id": "Unit", "properties": { "annotations": { @@ -5371,7 +5373,7 @@ "type": "array" }, "outputVariables": { - "description": "Optional. Output only. Set of key/value pairs corresponding to output variables from execution of actuation templates. The variables are declared in actuation configs (e.g in helm chart or terraform) and the values are fetched and returned by the actuation engine upon completion of execution.", + "description": "Optional. Output only. Set of key/value pairs corresponding to output variables from execution of actuation templates. The variables are declared in actuation configs (in Terraform for example) and the values are fetched and returned by the actuation engine upon completion of execution.", "items": { "$ref": "UnitVariable" }, @@ -5710,6 +5712,12 @@ "description": "Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation.", "type": "string" }, + "deleteTime": { + "description": "Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation).", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, "dependencies": { "description": "Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10.", "items": { diff --git a/discovery/securitycenter-v1.json b/discovery/securitycenter-v1.json index ec513a4eb7..be50339696 100644 --- a/discovery/securitycenter-v1.json +++ b/discovery/securitycenter-v1.json @@ -5766,7 +5766,7 @@ } } }, - "revision": "20260724", + "revision": "20261005", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -8246,6 +8246,9 @@ "dataset": { "type": "string" }, + "deletionNotificationsEnabled": { + "type": "boolean" + }, "description": { "type": "string" }, @@ -8517,6 +8520,9 @@ "GoogleCloudSecuritycenterV1NotificationMessage": { "id": "GoogleCloudSecuritycenterV1NotificationMessage", "properties": { + "deletedFinding": { + "type": "boolean" + }, "finding": { "$ref": "Finding" }, @@ -9675,6 +9681,9 @@ "dataset": { "type": "string" }, + "deletionNotificationsEnabled": { + "type": "boolean" + }, "description": { "type": "string" }, @@ -12781,6 +12790,9 @@ "GoogleCloudSecuritycenterV2NotificationMessage": { "id": "GoogleCloudSecuritycenterV2NotificationMessage", "properties": { + "deletedFinding": { + "type": "boolean" + }, "finding": { "$ref": "GoogleCloudSecuritycenterV2Finding" }, @@ -15233,6 +15245,9 @@ "NotificationConfig": { "id": "NotificationConfig", "properties": { + "deletionNotificationsEnabled": { + "type": "boolean" + }, "description": { "type": "string" }, diff --git a/discovery/securitycenter-v1beta1.json b/discovery/securitycenter-v1beta1.json index dbd5188fca..dad1925263 100644 --- a/discovery/securitycenter-v1beta1.json +++ b/discovery/securitycenter-v1beta1.json @@ -895,7 +895,7 @@ } } }, - "revision": "20260724", + "revision": "20261005", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -3048,6 +3048,9 @@ "dataset": { "type": "string" }, + "deletionNotificationsEnabled": { + "type": "boolean" + }, "description": { "type": "string" }, @@ -3319,6 +3322,9 @@ "GoogleCloudSecuritycenterV1NotificationMessage": { "id": "GoogleCloudSecuritycenterV1NotificationMessage", "properties": { + "deletedFinding": { + "type": "boolean" + }, "finding": { "$ref": "Finding" }, @@ -4544,6 +4550,9 @@ "dataset": { "type": "string" }, + "deletionNotificationsEnabled": { + "type": "boolean" + }, "description": { "type": "string" }, @@ -7650,6 +7659,9 @@ "GoogleCloudSecuritycenterV2NotificationMessage": { "id": "GoogleCloudSecuritycenterV2NotificationMessage", "properties": { + "deletedFinding": { + "type": "boolean" + }, "finding": { "$ref": "GoogleCloudSecuritycenterV2Finding" }, diff --git a/discovery/securitycenter-v1beta2.json b/discovery/securitycenter-v1beta2.json index f4bb9abe61..0844f32bed 100644 --- a/discovery/securitycenter-v1beta2.json +++ b/discovery/securitycenter-v1beta2.json @@ -1971,7 +1971,7 @@ } } }, - "revision": "20260724", + "revision": "20261005", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -4122,6 +4122,9 @@ "dataset": { "type": "string" }, + "deletionNotificationsEnabled": { + "type": "boolean" + }, "description": { "type": "string" }, @@ -4393,6 +4396,9 @@ "GoogleCloudSecuritycenterV1NotificationMessage": { "id": "GoogleCloudSecuritycenterV1NotificationMessage", "properties": { + "deletedFinding": { + "type": "boolean" + }, "finding": { "$ref": "Finding" }, @@ -5551,6 +5557,9 @@ "dataset": { "type": "string" }, + "deletionNotificationsEnabled": { + "type": "boolean" + }, "description": { "type": "string" }, @@ -8657,6 +8666,9 @@ "GoogleCloudSecuritycenterV2NotificationMessage": { "id": "GoogleCloudSecuritycenterV2NotificationMessage", "properties": { + "deletedFinding": { + "type": "boolean" + }, "finding": { "$ref": "GoogleCloudSecuritycenterV2Finding" }, diff --git a/discovery/servicecontrol-v1.json b/discovery/servicecontrol-v1.json index 9c1cce85aa..cc369c2951 100644 --- a/discovery/servicecontrol-v1.json +++ b/discovery/servicecontrol-v1.json @@ -197,7 +197,7 @@ } } }, - "revision": "20260914", + "revision": "20261002", "rootUrl": "https://servicecontrol.googleapis.com/", "schemas": { "AllocateInfo": { @@ -319,6 +319,10 @@ }, "type": "array" }, + "callerAgent": { + "$ref": "CallerAgent", + "description": "Information set when the caller is an agent." + }, "metadata": { "additionalProperties": { "description": "Properties of the object.", @@ -558,6 +562,27 @@ }, "type": "object" }, + "CallerAgent": { + "description": "Information set when the caller is an agent.", + "id": "CallerAgent", + "properties": { + "authority": { + "description": "The type of authority for the caller agent.", + "enum": [ + "AUTHORITY_TYPE_UNSPECIFIED", + "SELF", + "ON_BEHALF_OF" + ], + "enumDescriptions": [ + "Default value. Should not be used.", + "Acts under its own authority.", + "Acts on behalf of another authority." + ], + "type": "string" + } + }, + "type": "object" + }, "CheckError": { "description": "Defines the errors to be returned in google.api.servicecontrol.v1.CheckResponse.check_errors.", "id": "CheckError", diff --git a/discovery/servicecontrol-v2.json b/discovery/servicecontrol-v2.json index a35d1f5004..9c35d26364 100644 --- a/discovery/servicecontrol-v2.json +++ b/discovery/servicecontrol-v2.json @@ -169,7 +169,7 @@ } } }, - "revision": "20260914", + "revision": "20261002", "rootUrl": "https://servicecontrol.googleapis.com/", "schemas": { "Api": { @@ -260,6 +260,10 @@ }, "type": "array" }, + "callerAgent": { + "$ref": "CallerAgent", + "description": "Information set when the caller is an agent." + }, "metadata": { "additionalProperties": { "description": "Properties of the object.", @@ -499,6 +503,27 @@ }, "type": "object" }, + "CallerAgent": { + "description": "Information set when the caller is an agent.", + "id": "CallerAgent", + "properties": { + "authority": { + "description": "The type of authority for the caller agent.", + "enum": [ + "AUTHORITY_TYPE_UNSPECIFIED", + "SELF", + "ON_BEHALF_OF" + ], + "enumDescriptions": [ + "Default value. Should not be used.", + "Acts under its own authority.", + "Acts on behalf of another authority." + ], + "type": "string" + } + }, + "type": "object" + }, "CheckRequest": { "description": "Request message for the Check method.", "id": "CheckRequest", diff --git a/discovery/spanner-v1.json b/discovery/spanner-v1.json index 249b36d9f6..76f8903089 100644 --- a/discovery/spanner-v1.json +++ b/discovery/spanner-v1.json @@ -27,6 +27,11 @@ "endpointUrl": "https://spanner.europe-west8.rep.googleapis.com/", "location": "europe-west8" }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://spanner.europe-southwest1.rep.googleapis.com/", + "location": "europe-southwest1" + }, { "description": "Regional Endpoint", "endpointUrl": "https://spanner.me-central2.rep.googleapis.com/", @@ -91,6 +96,11 @@ "description": "Regional Endpoint", "endpointUrl": "https://spanner.us-east7.rep.googleapis.com/", "location": "us-east7" + }, + { + "description": "Regional Endpoint", + "endpointUrl": "https://spanner.us.rep.googleapis.com/", + "location": "us" } ], "fullyEncodeReservedExpansion": true, @@ -3436,7 +3446,7 @@ } } }, - "revision": "20260622", + "revision": "20260928", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "Ack": { diff --git a/discovery/workstations-v1beta.json b/discovery/workstations-v1beta.json index 90df0736dc..2fbfffe55e 100644 --- a/discovery/workstations-v1beta.json +++ b/discovery/workstations-v1beta.json @@ -1245,7 +1245,7 @@ } } }, - "revision": "20260923", + "revision": "20261006", "rootUrl": "https://workstations.googleapis.com/", "schemas": { "Accelerator": { @@ -1350,6 +1350,10 @@ "format": "int32", "type": "integer" }, + "enableAutomaticFailover": { + "description": "Optional. Indicates if this boost config is eligible for automatic failover when the service cannot provision the default VM type. Defaults to `false`.", + "type": "boolean" + }, "enableNestedVirtualization": { "description": "Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series.", "type": "boolean" diff --git a/src/apis/agentregistry/v1.ts b/src/apis/agentregistry/v1.ts index 52a3536014..75d1d25a79 100644 --- a/src/apis/agentregistry/v1.ts +++ b/src/apis/agentregistry/v1.ts @@ -215,10 +215,51 @@ export namespace agentregistry_v1 { */ content?: {[key: string]: any} | null; /** - * Required. The type of the agent spec content. + * Required. Immutable. The type of the agent spec content. */ type?: string | null; } + /** + * Represents an AI Application. + */ + export interface Schema$AiApplication { + /** + * Output only. Properties of an underlying cloud resource that can comprise an AI Application. + */ + applicationProperties?: Schema$ApplicationProperties; + /** + * Optional. Consumer provided attributes. + */ + attributes?: Schema$Attributes; + /** + * Output only. Creation time. + */ + createTime?: string | null; + /** + * Optional. User-defined description of the AI Application. + */ + description?: string | null; + /** + * Optional. User-defined name for the AI Application. + */ + displayName?: string | null; + /** + * Identifier. Resource name of the AI Application. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + */ + name?: string | null; + /** + * Output only. The current state of the AI Application. + */ + state?: string | null; + /** + * Output only. Universally unique identifier (UUID4) for the AI Application. + */ + uid?: string | null; + /** + * Output only. Last update time. + */ + updateTime?: string | null; + } /** * Annotations describing the characteristics and behavior of a tool or operation. */ @@ -244,6 +285,40 @@ export namespace agentregistry_v1 { */ title?: string | null; } + /** + * Additional system properties of an Application. + */ + export interface Schema$ApplicationProperties { + /** + * Output only. Additional metadata specific to the App Hub application. The key is a string that identifies the type of metadata and the value is the metadata contents specific to that type. Key format: `apphub.googleapis.com/{metadataType\}` + */ + extendedMetadata?: {[key: string]: Schema$ExtendedMetadata} | null; + } + /** + * Consumer provided attributes. + */ + export interface Schema$Attributes { + /** + * Optional. Business team that ensures user needs are met and value is delivered + */ + businessOwners?: Schema$ContactInfo[]; + /** + * Optional. User-defined criticality information. + */ + criticality?: Schema$Criticality; + /** + * Optional. Developer team that owns development and coding. + */ + developerOwners?: Schema$ContactInfo[]; + /** + * Optional. User-defined environment information. + */ + environment?: Schema$Environment; + /** + * Optional. Operator team that ensures runtime and operations. + */ + operatorOwners?: Schema$ContactInfo[]; + } /** * The AuthProvider of the Binding. */ @@ -286,7 +361,7 @@ export namespace agentregistry_v1 { */ name?: string | null; /** - * Required. The target Agent of the Binding. + * Optional. The source Agent of the Binding. */ source?: Schema$Source; /** @@ -315,6 +390,28 @@ export namespace agentregistry_v1 { */ type?: string | null; } + /** + * Contact information of stakeholders. + */ + export interface Schema$ContactInfo { + /** + * Optional. Contact's name. Can have a maximum length of 63 characters. + */ + displayName?: string | null; + /** + * Required. Email address of the contacts. + */ + email?: string | null; + } + /** + * Criticality of the Application, Service, or Workload + */ + export interface Schema$Criticality { + /** + * Required. Criticality Type. + */ + type?: string | null; + } /** * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \} */ @@ -365,7 +462,16 @@ export namespace agentregistry_v1 { */ content?: {[key: string]: any} | null; /** - * Required. The type of the endpoint spec content. + * Required. Immutable. The type of the endpoint spec content. + */ + type?: string | null; + } + /** + * Environment of the Application, Service, or Workload + */ + export interface Schema$Environment { + /** + * Required. Environment Type. */ type?: string | null; } @@ -390,6 +496,15 @@ export namespace agentregistry_v1 { */ title?: string | null; } + /** + * Additional metadata for a Service or Workload. + */ + export interface Schema$ExtendedMetadata { + /** + * Output only. The metadata contents. + */ + metadataStruct?: {[key: string]: any} | null; + } /** * Message for response to fetching available Bindings. */ @@ -524,6 +639,62 @@ export namespace agentregistry_v1 { */ nextPageToken?: string | null; } + /** + * Message for response to listing Agents under an AI Application. + */ + export interface Schema$ListAiApplicationAgentsResponse { + /** + * The list of Agents. + */ + agents?: Schema$Agent[]; + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + } + /** + * Message for response to listing Endpoints under an AI Application. + */ + export interface Schema$ListAiApplicationEndpointsResponse { + /** + * The list of Endpoints. + */ + endpoints?: Schema$Endpoint[]; + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + } + /** + * Message for response to listing McpServers under an AI Application. + */ + export interface Schema$ListAiApplicationMcpServersResponse { + /** + * The list of McpServers. + */ + mcpServers?: Schema$McpServer[]; + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + } + /** + * Message for response to listing AiApplications. + */ + export interface Schema$ListAiApplicationsResponse { + /** + * The list of AiApplications. + */ + aiApplications?: Schema$AiApplication[]; + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + /** + * Unordered list. Locations that could not be reached. + */ + unreachable?: string[] | null; + } /** * Message for response to listing Bindings */ @@ -681,7 +852,7 @@ export namespace agentregistry_v1 { */ content?: {[key: string]: any} | null; /** - * Required. The type of the MCP Server spec content. + * Required. Immutable. The type of the MCP Server spec content. */ type?: string | null; } @@ -773,7 +944,7 @@ export namespace agentregistry_v1 { */ pageToken?: string | null; /** - * Optional. Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |--------------------|-----|-----|-----|----------------| | agentId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | skills | No | Yes | No | Included | | skills.id | No | Yes | No | Included | | skills.name | No | Yes | No | Included | | skills.description | No | Yes | No | Included | | skills.tags | No | Yes | No | Included | | skills.examples | No | Yes | No | Included | Examples: * `agentId="urn:agent:projects-123:projects:123:locations:us-central1:reasoningEngines:1234"` to find the agent with the specified agent ID. * `name:important` to find agents whose name contains `important` as a word. * `displayName:works*` to find agents whose display name contains words that start with `works`. * `skills.tags:test` to find agents whose skills tags contain `test`. * `planner OR booking` to find agents whose metadata contains the words `planner` or `booking`. + * Optional. Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |--------------------|-----|-----|-----|----------------| | agentId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | skills | No | Yes | No | Included | | skills.id | No | Yes | No | Included | | skills.name | No | Yes | No | Included | | skills.description | No | Yes | No | Included | | skills.tags | No | Yes | No | Included | | skills.examples | No | Yes | No | Included | Examples: * `agentId="urn:agent:projects-123:projects:123:locations:us-central1:aiplatform:reasoningEngines:1234"` to find the agent with the specified agent ID. * `name:important` to find agents whose name contains `important` as a word. * `displayName:works*` to find agents whose display name contains words that start with `works`. * `skills.tags:test` to find agents whose skills tags contain `test`. * `planner OR booking` to find agents whose metadata contains the words `planner` or `booking`. */ searchString?: string | null; } @@ -1786,12 +1957,23 @@ export namespace agentregistry_v1 { export class Resource$Projects$Locations$Aiapplications { context: APIRequestContext; + agents: Resource$Projects$Locations$Aiapplications$Agents; + endpoints: Resource$Projects$Locations$Aiapplications$Endpoints; + mcpServers: Resource$Projects$Locations$Aiapplications$Mcpservers; constructor(context: APIRequestContext) { this.context = context; + this.agents = new Resource$Projects$Locations$Aiapplications$Agents( + this.context + ); + this.endpoints = new Resource$Projects$Locations$Aiapplications$Endpoints( + this.context + ); + this.mcpServers = + new Resource$Projects$Locations$Aiapplications$Mcpservers(this.context); } /** - * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set. + * Gets details of a single AI Application. * @example * ```js * // Before running the sample: @@ -1825,22 +2007,23 @@ export namespace agentregistry_v1 { * google.options({auth: authClient}); * * // Do the magic - * const res = - * await agentregistry.projects.locations.aiApplications.getIamPolicy({ - * // 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). - * 'options.requestedPolicyVersion': 'placeholder-value', - * // 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. - * resource: - * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', - * }); + * const res = await agentregistry.projects.locations.aiApplications.get({ + * // Required. Target AI Application resource name. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + * name: 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * }); * console.log(res.data); * * // Example response * // { - * // "auditConfigs": [], - * // "bindings": [], - * // "etag": "my_etag", - * // "version": 0 + * // "applicationProperties": {}, + * // "attributes": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "state": "my_state", + * // "uid": "my_uid", + * // "updateTime": "my_updateTime" * // } * } * @@ -1856,56 +2039,53 @@ export namespace agentregistry_v1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - getIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, + get( + params: Params$Resource$Projects$Locations$Aiapplications$Get, options: StreamMethodOptions ): Promise>; - getIamPolicy( - params?: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, + get( + params?: Params$Resource$Projects$Locations$Aiapplications$Get, options?: MethodOptions - ): Promise>; - getIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - getIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - getIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, - callback: BodyResponseCallback + get( + params: Params$Resource$Projects$Locations$Aiapplications$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - getIamPolicy( - callback: BodyResponseCallback + get( + params: Params$Resource$Projects$Locations$Aiapplications$Get, + callback: BodyResponseCallback ): void; - getIamPolicy( + get(callback: BodyResponseCallback): void; + get( paramsOrCallback?: - | Params$Resource$Projects$Locations$Aiapplications$Getiampolicy - | BodyResponseCallback + | Params$Resource$Projects$Locations$Aiapplications$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Aiapplications$Getiampolicy; + {}) as Params$Resource$Projects$Locations$Aiapplications$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = - {} as Params$Resource$Projects$Locations$Aiapplications$Getiampolicy; + params = {} as Params$Resource$Projects$Locations$Aiapplications$Get; options = {}; } @@ -1919,32 +2099,29 @@ export namespace agentregistry_v1 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1/{+resource}:getIamPolicy').replace( - /([^:]\/)\/+/g, - '$1' - ), + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['resource'], - pathParams: ['resource'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set. * @example * ```js * // Before running the sample: @@ -1966,8 +2143,10 @@ export namespace agentregistry_v1 { * const auth = new google.auth.GoogleAuth({ * // Scopes can be specified either as an array or as a single, space-delimited string. * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', * 'https://www.googleapis.com/auth/agentregistry.read-write', * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', * ], * }); * @@ -1977,19 +2156,12 @@ export namespace agentregistry_v1 { * * // Do the magic * const res = - * await agentregistry.projects.locations.aiApplications.setIamPolicy({ - * // 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. + * await agentregistry.projects.locations.aiApplications.getIamPolicy({ + * // 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). + * 'options.requestedPolicyVersion': 'placeholder-value', + * // 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. * resource: * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', - * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "policy": {}, - * // "updateMask": "my_updateMask" - * // } - * }, * }); * console.log(res.data); * @@ -2014,34 +2186,34 @@ export namespace agentregistry_v1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - setIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: StreamMethodOptions ): Promise>; - setIamPolicy( - params?: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params?: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options?: MethodOptions ): Promise>; - setIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - setIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - setIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, callback: BodyResponseCallback ): void; - setIamPolicy( + getIamPolicy( callback: BodyResponseCallback ): void; - setIamPolicy( + getIamPolicy( paramsOrCallback?: - | Params$Resource$Projects$Locations$Aiapplications$Setiampolicy + | Params$Resource$Projects$Locations$Aiapplications$Getiampolicy | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: @@ -2057,13 +2229,13 @@ export namespace agentregistry_v1 { | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Aiapplications$Setiampolicy; + {}) as Params$Resource$Projects$Locations$Aiapplications$Getiampolicy; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Projects$Locations$Aiapplications$Setiampolicy; + {} as Params$Resource$Projects$Locations$Aiapplications$Getiampolicy; options = {}; } @@ -2077,11 +2249,11 @@ export namespace agentregistry_v1 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1/{+resource}:setIamPolicy').replace( + url: (rootUrl + '/v1/{+resource}:getIamPolicy').replace( /([^:]\/)\/+/g, '$1' ), - method: 'POST', + method: 'GET', apiVersion: '', }, options @@ -2102,7 +2274,7 @@ export namespace agentregistry_v1 { } /** - * 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. + * Lists AI Applications in a given project and location. * @example * ```js * // Before running the sample: @@ -2136,25 +2308,1245 @@ export namespace agentregistry_v1 { * google.options({auth: authClient}); * * // Do the magic - * const res = - * await agentregistry.projects.locations.aiApplications.testIamPermissions({ - * // 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. - * resource: - * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * const res = await agentregistry.projects.locations.aiApplications.list({ + * // Optional. Filtering results. + * filter: 'placeholder-value', + * // Optional. Hint for how to order the results. + * orderBy: 'placeholder-value', + * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the server should return. + * pageToken: 'placeholder-value', + * // Required. Parent project and location to query. Format: `projects/{project\}/locations/{location\}` + * parent: 'projects/my-project/locations/my-location', + * }); + * console.log(res.data); * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "permissions": [] - * // } + * // Example response + * // { + * // "aiApplications": [], + * // "nextPageToken": "my_nextPageToken", + * // "unreachable": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Aiapplications$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Aiapplications$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Aiapplications$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$List, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Aiapplications$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/aiApplications').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.setIamPolicy({ + * // 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. + * resource: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "policy": {}, + * // "updateMask": "my_updateMask" + * // } * }, * }); * console.log(res.data); * * // Example response * // { - * // "permissions": [] + * // "auditConfigs": [], + * // "bindings": [], + * // "etag": "my_etag", + * // "version": 0 + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + setIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + options: StreamMethodOptions + ): Promise>; + setIamPolicy( + params?: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + options?: MethodOptions + ): Promise>; + setIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + setIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + setIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + callback: BodyResponseCallback + ): void; + setIamPolicy( + callback: BodyResponseCallback + ): void; + setIamPolicy( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Setiampolicy + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Setiampolicy; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Setiampolicy; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+resource}:setIamPolicy').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * 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. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.testIamPermissions({ + * // 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. + * resource: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "permissions": [] + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "permissions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + testIamPermissions( + params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + options: StreamMethodOptions + ): Promise>; + testIamPermissions( + params?: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + testIamPermissions( + params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + testIamPermissions( + params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + testIamPermissions( + params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + callback: BodyResponseCallback + ): void; + testIamPermissions( + callback: BodyResponseCallback + ): void; + testIamPermissions( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Testiampermissions + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Testiampermissions; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Testiampermissions; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+resource}:testIamPermissions').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Aiapplications$Get extends StandardParameters { + /** + * Required. Target AI Application resource name. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Getiampolicy extends StandardParameters { + /** + * 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). + */ + 'options.requestedPolicyVersion'?: number; + /** + * 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. + */ + resource?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$List extends StandardParameters { + /** + * Optional. Filtering results. + */ + filter?: string; + /** + * Optional. Hint for how to order the results. + */ + orderBy?: string; + /** + * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + */ + pageSize?: number; + /** + * Optional. A token identifying a page of results the server should return. + */ + pageToken?: string; + /** + * Required. Parent project and location to query. Format: `projects/{project\}/locations/{location\}` + */ + parent?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Setiampolicy extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleIamV1SetIamPolicyRequest; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Testiampermissions extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleIamV1TestIamPermissionsRequest; + } + + export class Resource$Projects$Locations$Aiapplications$Agents { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Gets details of a single Agent under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await agentregistry.projects.locations.aiApplications.agents.get({ + * // Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/agents/{agent\}` + * name: 'projects/my-project/locations/my-location/aiApplications/my-aiApplication/agents/my-agent', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "agentId": "my_agentId", + * // "attributes": {}, + * // "card": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "displayName": "my_displayName", + * // "location": "my_location", + * // "name": "my_name", + * // "protocols": [], + * // "skills": [], + * // "uid": "my_uid", + * // "updateTime": "my_updateTime", + * // "version": "my_version" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Agents$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Agents$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Agents$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Lists Agents under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await agentregistry.projects.locations.aiApplications.agents.list( + * { + * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the server should return. + * pageToken: 'placeholder-value', + * // Required. Parent value (AI Application) for ListAiApplicationAgentsRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + * parent: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "agents": [], + * // "nextPageToken": "my_nextPageToken" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Agents$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Agents$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Agents$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/agents').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Aiapplications$Agents$Get extends StandardParameters { + /** + * Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/agents/{agent\}` + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Agents$List extends StandardParameters { + /** + * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + */ + pageSize?: number; + /** + * Optional. A token identifying a page of results the server should return. + */ + pageToken?: string; + /** + * Required. Parent value (AI Application) for ListAiApplicationAgentsRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + */ + parent?: string; + } + + export class Resource$Projects$Locations$Aiapplications$Endpoints { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Gets details of a single Endpoint under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.endpoints.get({ + * // Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/endpoints/{endpoint\}` + * name: 'projects/my-project/locations/my-location/aiApplications/my-aiApplication/endpoints/my-endpoint', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "attributes": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "displayName": "my_displayName", + * // "endpointId": "my_endpointId", + * // "interfaces": [], + * // "name": "my_name", + * // "updateTime": "my_updateTime" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Lists Endpoints under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.endpoints.list({ + * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the server should return. + * pageToken: 'placeholder-value', + * // Required. Parent value (AI Application) for ListAiApplicationEndpointsRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + * parent: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "endpoints": [], + * // "nextPageToken": "my_nextPageToken" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Endpoints$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Endpoints$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Endpoints$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/endpoints').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get extends StandardParameters { + /** + * Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/endpoints/{endpoint\}` + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Endpoints$List extends StandardParameters { + /** + * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + */ + pageSize?: number; + /** + * Optional. A token identifying a page of results the server should return. + */ + pageToken?: string; + /** + * Required. Parent value (AI Application) for ListAiApplicationEndpointsRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + */ + parent?: string; + } + + export class Resource$Projects$Locations$Aiapplications$Mcpservers { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Gets details of a single McpServer under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.mcpServers.get({ + * // Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/mcpServers/{mcp_server\}` + * name: 'projects/my-project/locations/my-location/aiApplications/my-aiApplication/mcpServers/my-mcpServer', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "attributes": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "displayName": "my_displayName", + * // "interfaces": [], + * // "mcpServerId": "my_mcpServerId", + * // "name": "my_name", + * // "tools": [], + * // "updateTime": "my_updateTime" * // } * } * @@ -2170,62 +3562,209 @@ export namespace agentregistry_v1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - testIamPermissions( - params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + get( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, options: StreamMethodOptions ): Promise>; - testIamPermissions( - params?: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + get( + params?: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Lists McpServers under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.mcpServers.list({ + * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the server should return. + * pageToken: 'placeholder-value', + * // Required. Parent value (AI Application) for ListAiApplicationMcpServersRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + * parent: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "mcpServers": [], + * // "nextPageToken": "my_nextPageToken" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, options?: MethodOptions ): Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 >; - testIamPermissions( - params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + list( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - testIamPermissions( - params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + list( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - testIamPermissions( - params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, - callback: BodyResponseCallback + list( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, + callback: BodyResponseCallback ): void; - testIamPermissions( - callback: BodyResponseCallback + list( + callback: BodyResponseCallback ): void; - testIamPermissions( + list( paramsOrCallback?: - | Params$Resource$Projects$Locations$Aiapplications$Testiampermissions - | BodyResponseCallback + | Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void | Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 > | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Aiapplications$Testiampermissions; + {}) as Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Projects$Locations$Aiapplications$Testiampermissions; + {} as Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List; options = {}; } @@ -2239,64 +3778,52 @@ export namespace agentregistry_v1 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1/{+resource}:testIamPermissions').replace( + url: (rootUrl + '/v1/{+parent}/mcpServers').replace( /([^:]\/)\/+/g, '$1' ), - method: 'POST', + method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['resource'], - pathParams: ['resource'], + requiredParams: ['parent'], + pathParams: ['parent'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } } - export interface Params$Resource$Projects$Locations$Aiapplications$Getiampolicy extends StandardParameters { - /** - * 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). - */ - 'options.requestedPolicyVersion'?: number; + export interface Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get extends StandardParameters { /** - * 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. + * Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/mcpServers/{mcp_server\}` */ - resource?: string; + name?: string; } - export interface Params$Resource$Projects$Locations$Aiapplications$Setiampolicy extends StandardParameters { - /** - * 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. - */ - resource?: string; - + export interface Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List extends StandardParameters { /** - * Request body metadata + * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */ - requestBody?: Schema$GoogleIamV1SetIamPolicyRequest; - } - export interface Params$Resource$Projects$Locations$Aiapplications$Testiampermissions extends StandardParameters { + pageSize?: number; /** - * 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. + * Optional. A token identifying a page of results the server should return. */ - resource?: string; - + pageToken?: string; /** - * Request body metadata + * Required. Parent value (AI Application) for ListAiApplicationMcpServersRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` */ - requestBody?: Schema$GoogleIamV1TestIamPermissionsRequest; + parent?: string; } export class Resource$Projects$Locations$Bindings { diff --git a/src/apis/agentregistry/v1alpha.ts b/src/apis/agentregistry/v1alpha.ts index 3d5c13eba2..0dd8cfd3cc 100644 --- a/src/apis/agentregistry/v1alpha.ts +++ b/src/apis/agentregistry/v1alpha.ts @@ -215,10 +215,51 @@ export namespace agentregistry_v1alpha { */ content?: {[key: string]: any} | null; /** - * Required. The type of the agent spec content. + * Required. Immutable. The type of the agent spec content. */ type?: string | null; } + /** + * Represents an AI Application. + */ + export interface Schema$AiApplication { + /** + * Output only. Properties of an underlying cloud resource that can comprise an AI Application. + */ + applicationProperties?: Schema$ApplicationProperties; + /** + * Optional. Consumer provided attributes. + */ + attributes?: Schema$Attributes; + /** + * Output only. Creation time. + */ + createTime?: string | null; + /** + * Optional. User-defined description of the AI Application. + */ + description?: string | null; + /** + * Optional. User-defined name for the AI Application. + */ + displayName?: string | null; + /** + * Identifier. Resource name of the AI Application. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + */ + name?: string | null; + /** + * Output only. The current state of the AI Application. + */ + state?: string | null; + /** + * Output only. Universally unique identifier (UUID4) for the AI Application. + */ + uid?: string | null; + /** + * Output only. Last update time. + */ + updateTime?: string | null; + } /** * Annotations describing the characteristics and behavior of a tool or operation. */ @@ -244,6 +285,15 @@ export namespace agentregistry_v1alpha { */ title?: string | null; } + /** + * Additional system properties of an Application. + */ + export interface Schema$ApplicationProperties { + /** + * Output only. Additional metadata specific to the App Hub application. The key is a string that identifies the type of metadata and the value is the metadata contents specific to that type. Key format: `apphub.googleapis.com/{metadataType\}` + */ + extendedMetadata?: {[key: string]: Schema$ExtendedMetadata} | null; + } /** * Direct write-only raw archive payload upload. */ @@ -253,6 +303,31 @@ export namespace agentregistry_v1alpha { */ archiveContent?: string | null; } + /** + * Consumer provided attributes. + */ + export interface Schema$Attributes { + /** + * Optional. Business team that ensures user needs are met and value is delivered + */ + businessOwners?: Schema$ContactInfo[]; + /** + * Optional. User-defined criticality information. + */ + criticality?: Schema$Criticality; + /** + * Optional. Developer team that owns development and coding. + */ + developerOwners?: Schema$ContactInfo[]; + /** + * Optional. User-defined environment information. + */ + environment?: Schema$Environment; + /** + * Optional. Operator team that ensures runtime and operations. + */ + operatorOwners?: Schema$ContactInfo[]; + } /** * The AuthProvider of the Binding. */ @@ -295,7 +370,7 @@ export namespace agentregistry_v1alpha { */ name?: string | null; /** - * Required. The target Agent of the Binding. + * Optional. The source Agent of the Binding. */ source?: Schema$Source; /** @@ -324,6 +399,49 @@ export namespace agentregistry_v1alpha { */ type?: string | null; } + /** + * Separate message to accommodate custom formats across IRC and Slack. + */ + export interface Schema$Channel { + /** + * Required. URI of the channel. + */ + uri?: string | null; + } + /** + * Contact information of stakeholders. + */ + export interface Schema$ContactInfo { + /** + * Optional. Communication channel of the contacts. + */ + channel?: Schema$Channel; + /** + * Optional. Contact's name. Can have a maximum length of 63 characters. + */ + displayName?: string | null; + /** + * Required. Email address of the contacts. + */ + email?: string | null; + } + /** + * Criticality of the Application, Service, or Workload + */ + export interface Schema$Criticality { + /** + * Optional. Criticality level. Can contain only lowercase letters, numeric characters, underscores, and dashes. Can have a maximum length of 63 characters. Deprecated: Please refer to type instead. + */ + level?: string | null; + /** + * Optional. Indicates mission-critical Application, Service, or Workload. Deprecated: Please refer to type instead. + */ + missionCritical?: boolean | null; + /** + * Required. Criticality Type. + */ + type?: string | null; + } /** * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \} */ @@ -374,7 +492,20 @@ export namespace agentregistry_v1alpha { */ content?: {[key: string]: any} | null; /** - * Required. The type of the endpoint spec content. + * Required. Immutable. The type of the endpoint spec content. + */ + type?: string | null; + } + /** + * Environment of the Application, Service, or Workload + */ + export interface Schema$Environment { + /** + * Optional. Environment name. Can contain only lowercase letters, numeric characters, underscores, and dashes. Can have a maximum length of 63 characters. Deprecated: Please refer to type instead. + */ + environment?: string | null; + /** + * Required. Environment Type. */ type?: string | null; } @@ -399,6 +530,15 @@ export namespace agentregistry_v1alpha { */ title?: string | null; } + /** + * Additional metadata for a Service or Workload. + */ + export interface Schema$ExtendedMetadata { + /** + * Output only. The metadata contents. + */ + metadataStruct?: {[key: string]: any} | null; + } /** * Message for response to fetching available Bindings. */ @@ -571,6 +711,62 @@ export namespace agentregistry_v1alpha { */ nextPageToken?: string | null; } + /** + * Message for response to listing Agents under an AI Application. + */ + export interface Schema$ListAiApplicationAgentsResponse { + /** + * The list of Agents. + */ + agents?: Schema$Agent[]; + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + } + /** + * Message for response to listing Endpoints under an AI Application. + */ + export interface Schema$ListAiApplicationEndpointsResponse { + /** + * The list of Endpoints. + */ + endpoints?: Schema$Endpoint[]; + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + } + /** + * Message for response to listing McpServers under an AI Application. + */ + export interface Schema$ListAiApplicationMcpServersResponse { + /** + * The list of McpServers. + */ + mcpServers?: Schema$McpServer[]; + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + } + /** + * Message for response to listing AiApplications. + */ + export interface Schema$ListAiApplicationsResponse { + /** + * The list of AiApplications. + */ + aiApplications?: Schema$AiApplication[]; + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + /** + * Unordered list. Locations that could not be reached. + */ + unreachable?: string[] | null; + } /** * Message for response to listing Bindings */ @@ -771,7 +967,7 @@ export namespace agentregistry_v1alpha { */ content?: {[key: string]: any} | null; /** - * Required. The type of the MCP Server spec content. + * Required. Immutable. The type of the MCP Server spec content. */ type?: string | null; } @@ -892,7 +1088,7 @@ export namespace agentregistry_v1alpha { */ pageToken?: string | null; /** - * Optional. Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |--------------------|-----|-----|-----|----------------| | agentId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | skills | No | Yes | No | Included | | skills.id | No | Yes | No | Included | | skills.name | No | Yes | No | Included | | skills.description | No | Yes | No | Included | | skills.tags | No | Yes | No | Included | | skills.examples | No | Yes | No | Included | Examples: * `agentId="urn:agent:projects-123:projects:123:locations:us-central1:reasoningEngines:1234"` to find the agent with the specified agent ID. * `name:important` to find agents whose name contains `important` as a word. * `displayName:works*` to find agents whose display name contains words that start with `works`. * `skills.tags:test` to find agents whose skills tags contain `test`. * `planner OR booking` to find agents whose metadata contains the words `planner` or `booking`. + * Optional. Search criteria used to select the Agents to return. If no search criteria is specified then all accessible Agents will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |--------------------|-----|-----|-----|----------------| | agentId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | skills | No | Yes | No | Included | | skills.id | No | Yes | No | Included | | skills.name | No | Yes | No | Included | | skills.description | No | Yes | No | Included | | skills.tags | No | Yes | No | Included | | skills.examples | No | Yes | No | Included | Examples: * `agentId="urn:agent:projects-123:projects:123:locations:us-central1:aiplatform:reasoningEngines:1234"` to find the agent with the specified agent ID. * `name:important` to find agents whose name contains `important` as a word. * `displayName:works*` to find agents whose display name contains words that start with `works`. * `skills.tags:test` to find agents whose skills tags contain `test`. * `planner OR booking` to find agents whose metadata contains the words `planner` or `booking`. */ searchString?: string | null; } @@ -2026,12 +2222,23 @@ export namespace agentregistry_v1alpha { export class Resource$Projects$Locations$Aiapplications { context: APIRequestContext; + agents: Resource$Projects$Locations$Aiapplications$Agents; + endpoints: Resource$Projects$Locations$Aiapplications$Endpoints; + mcpServers: Resource$Projects$Locations$Aiapplications$Mcpservers; constructor(context: APIRequestContext) { this.context = context; + this.agents = new Resource$Projects$Locations$Aiapplications$Agents( + this.context + ); + this.endpoints = new Resource$Projects$Locations$Aiapplications$Endpoints( + this.context + ); + this.mcpServers = + new Resource$Projects$Locations$Aiapplications$Mcpservers(this.context); } /** - * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set. + * Gets details of a single AI Application. * @example * ```js * // Before running the sample: @@ -2065,22 +2272,23 @@ export namespace agentregistry_v1alpha { * google.options({auth: authClient}); * * // Do the magic - * const res = - * await agentregistry.projects.locations.aiApplications.getIamPolicy({ - * // 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). - * 'options.requestedPolicyVersion': 'placeholder-value', - * // 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. - * resource: - * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', - * }); + * const res = await agentregistry.projects.locations.aiApplications.get({ + * // Required. Target AI Application resource name. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + * name: 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * }); * console.log(res.data); * * // Example response * // { - * // "auditConfigs": [], - * // "bindings": [], - * // "etag": "my_etag", - * // "version": 0 + * // "applicationProperties": {}, + * // "attributes": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "state": "my_state", + * // "uid": "my_uid", + * // "updateTime": "my_updateTime" * // } * } * @@ -2096,56 +2304,53 @@ export namespace agentregistry_v1alpha { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - getIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, + get( + params: Params$Resource$Projects$Locations$Aiapplications$Get, options: StreamMethodOptions ): Promise>; - getIamPolicy( - params?: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, + get( + params?: Params$Resource$Projects$Locations$Aiapplications$Get, options?: MethodOptions - ): Promise>; - getIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - getIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - getIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, - callback: BodyResponseCallback + get( + params: Params$Resource$Projects$Locations$Aiapplications$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - getIamPolicy( - callback: BodyResponseCallback + get( + params: Params$Resource$Projects$Locations$Aiapplications$Get, + callback: BodyResponseCallback ): void; - getIamPolicy( + get(callback: BodyResponseCallback): void; + get( paramsOrCallback?: - | Params$Resource$Projects$Locations$Aiapplications$Getiampolicy - | BodyResponseCallback + | Params$Resource$Projects$Locations$Aiapplications$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Aiapplications$Getiampolicy; + {}) as Params$Resource$Projects$Locations$Aiapplications$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = - {} as Params$Resource$Projects$Locations$Aiapplications$Getiampolicy; + params = {} as Params$Resource$Projects$Locations$Aiapplications$Get; options = {}; } @@ -2159,32 +2364,29 @@ export namespace agentregistry_v1alpha { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1alpha/{+resource}:getIamPolicy').replace( - /([^:]\/)\/+/g, - '$1' - ), + url: (rootUrl + '/v1alpha/{+name}').replace(/([^:]\/)\/+/g, '$1'), method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['resource'], - pathParams: ['resource'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set. * @example * ```js * // Before running the sample: @@ -2206,8 +2408,10 @@ export namespace agentregistry_v1alpha { * const auth = new google.auth.GoogleAuth({ * // Scopes can be specified either as an array or as a single, space-delimited string. * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', * 'https://www.googleapis.com/auth/agentregistry.read-write', * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', * ], * }); * @@ -2217,19 +2421,12 @@ export namespace agentregistry_v1alpha { * * // Do the magic * const res = - * await agentregistry.projects.locations.aiApplications.setIamPolicy({ - * // 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. + * await agentregistry.projects.locations.aiApplications.getIamPolicy({ + * // 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). + * 'options.requestedPolicyVersion': 'placeholder-value', + * // 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. * resource: * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', - * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "policy": {}, - * // "updateMask": "my_updateMask" - * // } - * }, * }); * console.log(res.data); * @@ -2254,34 +2451,34 @@ export namespace agentregistry_v1alpha { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - setIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: StreamMethodOptions ): Promise>; - setIamPolicy( - params?: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params?: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options?: MethodOptions ): Promise>; - setIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - setIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, options: MethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - setIamPolicy( - params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + getIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Getiampolicy, callback: BodyResponseCallback ): void; - setIamPolicy( + getIamPolicy( callback: BodyResponseCallback ): void; - setIamPolicy( + getIamPolicy( paramsOrCallback?: - | Params$Resource$Projects$Locations$Aiapplications$Setiampolicy + | Params$Resource$Projects$Locations$Aiapplications$Getiampolicy | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: @@ -2297,13 +2494,13 @@ export namespace agentregistry_v1alpha { | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Aiapplications$Setiampolicy; + {}) as Params$Resource$Projects$Locations$Aiapplications$Getiampolicy; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Projects$Locations$Aiapplications$Setiampolicy; + {} as Params$Resource$Projects$Locations$Aiapplications$Getiampolicy; options = {}; } @@ -2317,11 +2514,11 @@ export namespace agentregistry_v1alpha { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1alpha/{+resource}:setIamPolicy').replace( + url: (rootUrl + '/v1alpha/{+resource}:getIamPolicy').replace( /([^:]\/)\/+/g, '$1' ), - method: 'POST', + method: 'GET', apiVersion: '', }, options @@ -2342,7 +2539,7 @@ export namespace agentregistry_v1alpha { } /** - * 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. + * Lists AI Applications in a given project and location. * @example * ```js * // Before running the sample: @@ -2376,25 +2573,1245 @@ export namespace agentregistry_v1alpha { * google.options({auth: authClient}); * * // Do the magic - * const res = - * await agentregistry.projects.locations.aiApplications.testIamPermissions({ - * // 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. - * resource: + * const res = await agentregistry.projects.locations.aiApplications.list({ + * // Optional. Filtering results. + * filter: 'placeholder-value', + * // Optional. Hint for how to order the results. + * orderBy: 'placeholder-value', + * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the server should return. + * pageToken: 'placeholder-value', + * // Required. Parent project and location to query. Format: `projects/{project\}/locations/{location\}` + * parent: 'projects/my-project/locations/my-location', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "aiApplications": [], + * // "nextPageToken": "my_nextPageToken", + * // "unreachable": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Aiapplications$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Aiapplications$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Aiapplications$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$List, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Aiapplications$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+parent}/aiApplications').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.setIamPolicy({ + * // 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. + * resource: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "policy": {}, + * // "updateMask": "my_updateMask" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "auditConfigs": [], + * // "bindings": [], + * // "etag": "my_etag", + * // "version": 0 + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + setIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + options: StreamMethodOptions + ): Promise>; + setIamPolicy( + params?: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + options?: MethodOptions + ): Promise>; + setIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + setIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + setIamPolicy( + params: Params$Resource$Projects$Locations$Aiapplications$Setiampolicy, + callback: BodyResponseCallback + ): void; + setIamPolicy( + callback: BodyResponseCallback + ): void; + setIamPolicy( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Setiampolicy + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Setiampolicy; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Setiampolicy; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+resource}:setIamPolicy').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * 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. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.testIamPermissions({ + * // 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. + * resource: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "permissions": [] + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "permissions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + testIamPermissions( + params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + options: StreamMethodOptions + ): Promise>; + testIamPermissions( + params?: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + testIamPermissions( + params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + testIamPermissions( + params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + testIamPermissions( + params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + callback: BodyResponseCallback + ): void; + testIamPermissions( + callback: BodyResponseCallback + ): void; + testIamPermissions( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Testiampermissions + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Testiampermissions; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Testiampermissions; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+resource}:testIamPermissions').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Aiapplications$Get extends StandardParameters { + /** + * Required. Target AI Application resource name. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Getiampolicy extends StandardParameters { + /** + * 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). + */ + 'options.requestedPolicyVersion'?: number; + /** + * 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. + */ + resource?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$List extends StandardParameters { + /** + * Optional. Filtering results. + */ + filter?: string; + /** + * Optional. Hint for how to order the results. + */ + orderBy?: string; + /** + * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + */ + pageSize?: number; + /** + * Optional. A token identifying a page of results the server should return. + */ + pageToken?: string; + /** + * Required. Parent project and location to query. Format: `projects/{project\}/locations/{location\}` + */ + parent?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Setiampolicy extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleIamV1SetIamPolicyRequest; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Testiampermissions extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleIamV1TestIamPermissionsRequest; + } + + export class Resource$Projects$Locations$Aiapplications$Agents { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Gets details of a single Agent under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await agentregistry.projects.locations.aiApplications.agents.get({ + * // Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/agents/{agent\}` + * name: 'projects/my-project/locations/my-location/aiApplications/my-aiApplication/agents/my-agent', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "agentId": "my_agentId", + * // "attributes": {}, + * // "card": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "displayName": "my_displayName", + * // "location": "my_location", + * // "name": "my_name", + * // "protocols": [], + * // "skills": [], + * // "uid": "my_uid", + * // "updateTime": "my_updateTime", + * // "version": "my_version" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Agents$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Agents$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Agents$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Lists Agents under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await agentregistry.projects.locations.aiApplications.agents.list( + * { + * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the server should return. + * pageToken: 'placeholder-value', + * // Required. Parent value (AI Application) for ListAiApplicationAgentsRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + * parent: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "agents": [], + * // "nextPageToken": "my_nextPageToken" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Agents$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Agents$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Agents$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Agents$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+parent}/agents').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Aiapplications$Agents$Get extends StandardParameters { + /** + * Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/agents/{agent\}` + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Agents$List extends StandardParameters { + /** + * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + */ + pageSize?: number; + /** + * Optional. A token identifying a page of results the server should return. + */ + pageToken?: string; + /** + * Required. Parent value (AI Application) for ListAiApplicationAgentsRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + */ + parent?: string; + } + + export class Resource$Projects$Locations$Aiapplications$Endpoints { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Gets details of a single Endpoint under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.endpoints.get({ + * // Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/endpoints/{endpoint\}` + * name: 'projects/my-project/locations/my-location/aiApplications/my-aiApplication/endpoints/my-endpoint', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "attributes": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "displayName": "my_displayName", + * // "endpointId": "my_endpointId", + * // "interfaces": [], + * // "name": "my_name", + * // "updateTime": "my_updateTime" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Lists Endpoints under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.endpoints.list({ + * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the server should return. + * pageToken: 'placeholder-value', + * // Required. Parent value (AI Application) for ListAiApplicationEndpointsRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + * parent: * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "endpoints": [], + * // "nextPageToken": "my_nextPageToken" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Aiapplications$Endpoints$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Endpoints$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Endpoints$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Endpoints$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+parent}/endpoints').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Projects$Locations$Aiapplications$Endpoints$Get extends StandardParameters { + /** + * Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/endpoints/{endpoint\}` + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Aiapplications$Endpoints$List extends StandardParameters { + /** + * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + */ + pageSize?: number; + /** + * Optional. A token identifying a page of results the server should return. + */ + pageToken?: string; + /** + * Required. Parent value (AI Application) for ListAiApplicationEndpointsRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + */ + parent?: string; + } + + export class Resource$Projects$Locations$Aiapplications$Mcpservers { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Gets details of a single McpServer under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "permissions": [] - * // } - * }, + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.mcpServers.get({ + * // Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/mcpServers/{mcp_server\}` + * name: 'projects/my-project/locations/my-location/aiApplications/my-aiApplication/mcpServers/my-mcpServer', * }); * console.log(res.data); * * // Example response * // { - * // "permissions": [] + * // "attributes": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "displayName": "my_displayName", + * // "interfaces": [], + * // "mcpServerId": "my_mcpServerId", + * // "name": "my_name", + * // "tools": [], + * // "updateTime": "my_updateTime" * // } * } * @@ -2410,62 +3827,209 @@ export namespace agentregistry_v1alpha { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - testIamPermissions( - params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + get( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, options: StreamMethodOptions ): Promise>; - testIamPermissions( - params?: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + get( + params?: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://agentregistry.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Lists McpServers under an AI Application. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/agentregistry.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const agentregistry = google.agentregistry('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/agentregistry.read-only', + * 'https://www.googleapis.com/auth/agentregistry.read-write', + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await agentregistry.projects.locations.aiApplications.mcpServers.list({ + * // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the server should return. + * pageToken: 'placeholder-value', + * // Required. Parent value (AI Application) for ListAiApplicationMcpServersRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` + * parent: + * 'projects/my-project/locations/my-location/aiApplications/my-aiApplication', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "mcpServers": [], + * // "nextPageToken": "my_nextPageToken" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, options?: MethodOptions ): Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 >; - testIamPermissions( - params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + list( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - testIamPermissions( - params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, + list( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - testIamPermissions( - params: Params$Resource$Projects$Locations$Aiapplications$Testiampermissions, - callback: BodyResponseCallback + list( + params: Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List, + callback: BodyResponseCallback ): void; - testIamPermissions( - callback: BodyResponseCallback + list( + callback: BodyResponseCallback ): void; - testIamPermissions( + list( paramsOrCallback?: - | Params$Resource$Projects$Locations$Aiapplications$Testiampermissions - | BodyResponseCallback + | Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void | Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 > | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Aiapplications$Testiampermissions; + {}) as Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Projects$Locations$Aiapplications$Testiampermissions; + {} as Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List; options = {}; } @@ -2479,64 +4043,52 @@ export namespace agentregistry_v1alpha { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1alpha/{+resource}:testIamPermissions').replace( + url: (rootUrl + '/v1alpha/{+parent}/mcpServers').replace( /([^:]\/)\/+/g, '$1' ), - method: 'POST', + method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['resource'], - pathParams: ['resource'], + requiredParams: ['parent'], + pathParams: ['parent'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } } - export interface Params$Resource$Projects$Locations$Aiapplications$Getiampolicy extends StandardParameters { - /** - * 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). - */ - 'options.requestedPolicyVersion'?: number; + export interface Params$Resource$Projects$Locations$Aiapplications$Mcpservers$Get extends StandardParameters { /** - * 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. + * Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}/mcpServers/{mcp_server\}` */ - resource?: string; + name?: string; } - export interface Params$Resource$Projects$Locations$Aiapplications$Setiampolicy extends StandardParameters { - /** - * 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. - */ - resource?: string; - + export interface Params$Resource$Projects$Locations$Aiapplications$Mcpservers$List extends StandardParameters { /** - * Request body metadata + * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. */ - requestBody?: Schema$GoogleIamV1SetIamPolicyRequest; - } - export interface Params$Resource$Projects$Locations$Aiapplications$Testiampermissions extends StandardParameters { + pageSize?: number; /** - * 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. + * Optional. A token identifying a page of results the server should return. */ - resource?: string; - + pageToken?: string; /** - * Request body metadata + * Required. Parent value (AI Application) for ListAiApplicationMcpServersRequest. Format: `projects/{project\}/locations/{location\}/aiApplications/{ai_application\}` */ - requestBody?: Schema$GoogleIamV1TestIamPermissionsRequest; + parent?: string; } export class Resource$Projects$Locations$Bindings { diff --git a/src/apis/alloydb/v1.ts b/src/apis/alloydb/v1.ts index 5f045d8816..7d1e274945 100644 --- a/src/apis/alloydb/v1.ts +++ b/src/apis/alloydb/v1.ts @@ -170,6 +170,19 @@ export namespace alloydb_v1 { */ weeklySchedule?: Schema$WeeklySchedule; } + /** + * Configuration for autoscaling. + */ + export interface Schema$AutoScalingConfig { + /** + * Policy for the MIG autoscaler. + */ + policy?: Schema$Policy; + /** + * Optional list of schedules for the MIG autoscaler. If not set, no schedules are created. + */ + schedules?: Schema$Schedule[]; + } /** * Message describing Backup object */ @@ -694,6 +707,15 @@ export namespace alloydb_v1 { */ pointInTime?: string | null; } + /** + * CPU utilization policy for the autoscaler. + */ + export interface Schema$CpuUtilization { + /** + * Target CPU utilization as a float between 0 and 1. + */ + utilizationTarget?: number | null; + } /** * Options for exporting data in CSV format. */ @@ -1089,7 +1111,7 @@ export namespace alloydb_v1 { */ pscInstanceInfo?: Schema$PscInstanceInfo; /** - * Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application. + * Output only. The public IP address for the Instance. This is available ONLY when `enable_public_ip` is set or when you have upgraded from an Express Instance that has public DNS enabled. This field is not available for Express Instances. This is the connection endpoint for an end-user application. */ publicIpAddress?: string | null; /** @@ -1518,6 +1540,27 @@ export namespace alloydb_v1 { */ verb?: string | null; } + /** + * Policy for the autoscaler. + */ + export interface Schema$Policy { + /** + * The period of time in seconds after a new node is created before the autoscaler will incorporate its resource usage (e.g. CPU utilization) into the autoscaling recommendation algorithm. + */ + coolDownPeriodSec?: string | null; + /** + * CPU utilization policy for the autoscaler. + */ + cpuUtilization?: Schema$CpuUtilization; + /** + * If true, autoscaling is enabled for the instance. If not set, the default value is false. + */ + enabled?: boolean | null; + /** + * Maximum number of nodes for the autoscaler. + */ + maxNodeCount?: string | null; + } /** * Configuration for the primary cluster. It has the list of clusters that are replicating from this cluster. This should be set if and only if the cluster is of type PRIMARY. */ @@ -1729,6 +1772,10 @@ export namespace alloydb_v1 { * Configuration for a read pool instance. */ export interface Schema$ReadPoolConfig { + /** + * Optional. Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled. + */ + autoScalingConfig?: Schema$AutoScalingConfig; /** * Read capacity, i.e. number of nodes in a read pool instance. */ @@ -1811,6 +1858,39 @@ export namespace alloydb_v1 { */ clusterId?: string | null; } + /** + * A schedule for the autoscaler. + */ + export interface Schema$Schedule { + /** + * Cron expression for the triggering the schedule. See https://cloud.google.com/compute/docs/autoscaler/scaling-schedules#cron_expressions for the syntax. + */ + cronExpression?: string | null; + /** + * Description of the schedule. + */ + description?: string | null; + /** + * If true, the schedule is disabled. + */ + disabled?: boolean | null; + /** + * Duration of the schedule. + */ + durationSec?: string | null; + /** + * Minimum number of nodes in while the schedule is active. + */ + minNodeCount?: string | null; + /** + * Name of the schedule. + */ + name?: string | null; + /** + * The location-based IANA time zone for interpreting the schedule's start time. If no time zone is provided, UTC is used by default. + */ + timeZone?: string | null; + } /** * Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY. */ diff --git a/src/apis/alloydb/v1alpha.ts b/src/apis/alloydb/v1alpha.ts index 5b72297849..b4a6ec8da4 100644 --- a/src/apis/alloydb/v1alpha.ts +++ b/src/apis/alloydb/v1alpha.ts @@ -228,7 +228,7 @@ export namespace alloydb_v1alpha { */ displayName?: string | null; /** - * Output only. The edition of the cluster this backup was created from. Any restored cluster created from this backup will have the same edition. + * Output only. Deprecated: Use `express_config` instead. Output only. The edition of the cluster this backup was created from. Any restored cluster created from this backup will have the same edition. */ edition?: string | null; /** @@ -251,6 +251,10 @@ export namespace alloydb_v1alpha { * Output only. The time at which after the backup is eligible to be garbage collected. It is the duration specified by the backup's retention policy, added to the backup's create_time. */ expiryTime?: string | null; + /** + * Output only. The Express configuration of the cluster this backup was created from. Any restored cluster created from this backup will have the same Express configuration. + */ + expressConfig?: Schema$ExpressConfig; /** * Labels as key value pairs */ @@ -493,7 +497,7 @@ export namespace alloydb_v1alpha { */ displayName?: string | null; /** - * Optional. Edition of the cluster. If left unspecified, the cluster behaves as `EDITION_ALLOYDB`. + * Optional. Deprecated: Use `express_config` instead. Edition of the cluster. If left unspecified, the cluster behaves as `EDITION_ALLOYDB`. */ edition?: string | null; /** @@ -1255,7 +1259,7 @@ export namespace alloydb_v1alpha { */ pscInstanceInfo?: Schema$PscInstanceInfo; /** - * Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application. + * Output only. The public IP address for the Instance. This is available ONLY when `enable_public_ip` is set or when you have upgraded from an Express Instance that has public DNS enabled. This field is not available for Express Instances. This is the connection endpoint for an end-user application. */ publicIpAddress?: string | null; /** @@ -1970,7 +1974,7 @@ export namespace alloydb_v1alpha { */ export interface Schema$ReadPoolConfig { /** - * Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled. + * Optional. Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled. */ autoScalingConfig?: Schema$AutoScalingConfig; /** @@ -3679,6 +3683,7 @@ export namespace alloydb_v1alpha { * // "etag": "my_etag", * // "expiryQuantity": {}, * // "expiryTime": "my_expiryTime", + * // "expressConfig": {}, * // "labels": {}, * // "name": "my_name", * // "reconciling": false, @@ -3998,6 +4003,7 @@ export namespace alloydb_v1alpha { * // "etag": "my_etag", * // "expiryQuantity": {}, * // "expiryTime": "my_expiryTime", + * // "expressConfig": {}, * // "labels": {}, * // "name": "my_name", * // "reconciling": false, @@ -4314,6 +4320,7 @@ export namespace alloydb_v1alpha { * // "etag": "my_etag", * // "expiryQuantity": {}, * // "expiryTime": "my_expiryTime", + * // "expressConfig": {}, * // "labels": {}, * // "name": "my_name", * // "reconciling": false, diff --git a/src/apis/alloydb/v1beta.ts b/src/apis/alloydb/v1beta.ts index c0b5926e8a..0899f23d61 100644 --- a/src/apis/alloydb/v1beta.ts +++ b/src/apis/alloydb/v1beta.ts @@ -228,7 +228,7 @@ export namespace alloydb_v1beta { */ displayName?: string | null; /** - * Output only. The edition of the cluster this backup was created from. Any restored cluster created from this backup will have the same edition. + * Output only. Deprecated: Use `express_config` instead. Output only. The edition of the cluster this backup was created from. Any restored cluster created from this backup will have the same edition. */ edition?: string | null; /** @@ -251,6 +251,10 @@ export namespace alloydb_v1beta { * Output only. The time at which after the backup is eligible to be garbage collected. It is the duration specified by the backup's retention policy, added to the backup's create_time. */ expiryTime?: string | null; + /** + * Output only. The Express configuration of the cluster this backup was created from. Any restored cluster created from this backup will have the same Express configuration. + */ + expressConfig?: Schema$ExpressConfig; /** * Labels as key value pairs */ @@ -485,7 +489,7 @@ export namespace alloydb_v1beta { */ displayName?: string | null; /** - * Optional. Edition of the cluster. If left unspecified, the cluster behaves as `EDITION_ALLOYDB`. + * Optional. Deprecated: Use `express_config` instead. Edition of the cluster. If left unspecified, the cluster behaves as `EDITION_ALLOYDB`. */ edition?: string | null; /** @@ -1243,7 +1247,7 @@ export namespace alloydb_v1beta { */ pscInstanceInfo?: Schema$PscInstanceInfo; /** - * Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application. + * Output only. The public IP address for the Instance. This is available ONLY when `enable_public_ip` is set or when you have upgraded from an Express Instance that has public DNS enabled. This field is not available for Express Instances. This is the connection endpoint for an end-user application. */ publicIpAddress?: string | null; /** @@ -1954,7 +1958,7 @@ export namespace alloydb_v1beta { */ export interface Schema$ReadPoolConfig { /** - * Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled. + * Optional. Autoscaling configuration for the read pool instance. If not set, the read pool instance will not be autoscaled. */ autoScalingConfig?: Schema$AutoScalingConfig; /** @@ -3663,6 +3667,7 @@ export namespace alloydb_v1beta { * // "etag": "my_etag", * // "expiryQuantity": {}, * // "expiryTime": "my_expiryTime", + * // "expressConfig": {}, * // "labels": {}, * // "name": "my_name", * // "reconciling": false, @@ -3981,6 +3986,7 @@ export namespace alloydb_v1beta { * // "etag": "my_etag", * // "expiryQuantity": {}, * // "expiryTime": "my_expiryTime", + * // "expressConfig": {}, * // "labels": {}, * // "name": "my_name", * // "reconciling": false, @@ -4296,6 +4302,7 @@ export namespace alloydb_v1beta { * // "etag": "my_etag", * // "expiryQuantity": {}, * // "expiryTime": "my_expiryTime", + * // "expressConfig": {}, * // "labels": {}, * // "name": "my_name", * // "reconciling": false, diff --git a/src/apis/analyticsdata/v1beta.ts b/src/apis/analyticsdata/v1beta.ts index 963080c4d0..e99ea42a02 100644 --- a/src/apis/analyticsdata/v1beta.ts +++ b/src/apis/analyticsdata/v1beta.ts @@ -552,7 +552,7 @@ export namespace analyticsdata_v1beta { value?: string | null; } /** - * Filter for empty values. + * Filter for empty values. Matches dimension values that are `""` or `(not set)` values. Use this filter to match rows with missing or unpopulated dimension values, or combine it with `not_expression` to exclude them from a report without filtering for both `""` and `(not set)` separately. */ export interface Schema$EmptyFilter {} /** @@ -564,7 +564,7 @@ export namespace analyticsdata_v1beta { */ betweenFilter?: Schema$BetweenFilter; /** - * A filter for empty values such as "(not set)" and "" values. + * A filter for empty values such as `(not set)` and `""` values. */ emptyFilter?: Schema$EmptyFilter; /** diff --git a/src/apis/androidmanagement/v1.ts b/src/apis/androidmanagement/v1.ts index 846756f710..b6ccbb4d16 100644 --- a/src/apis/androidmanagement/v1.ts +++ b/src/apis/androidmanagement/v1.ts @@ -2036,7 +2036,7 @@ export namespace androidmanagement_v1 { keyAlias?: string | null; } /** - * Settings controlling the behavior of a device in kiosk mode. To enable kiosk mode, set kioskCustomLauncherEnabled to true or specify an app in the policy with installType KIOSK. + * Settings controlling the behavior of a device in kiosk mode. To enable kiosk mode, set kioskCustomLauncherEnabled to true or specify an app in the policy with the KIOSK role. */ export interface Schema$KioskCustomization { /** @@ -2901,7 +2901,7 @@ export namespace androidmanagement_v1 { */ keyguardDisabledFeatures?: string[] | null; /** - * Optional. Settings controlling the behavior of a device in kiosk mode. To enable kiosk mode, set kioskCustomLauncherEnabled to true or specify an app in the policy with installType KIOSK. + * Optional. Settings controlling the behavior of a device in kiosk mode. To enable kiosk mode, set kioskCustomLauncherEnabled to true or specify an app in the policy with the KIOSK role. */ kioskCustomization?: Schema$KioskCustomization; /** diff --git a/src/apis/assuredworkloads/v1.ts b/src/apis/assuredworkloads/v1.ts index 2fe557f646..ba109f640d 100644 --- a/src/apis/assuredworkloads/v1.ts +++ b/src/apis/assuredworkloads/v1.ts @@ -112,7 +112,6 @@ export namespace assuredworkloads_v1 { */ export class Assuredworkloads { context: APIRequestContext; - assuredworkloads: Resource$Assuredworkloads; folders: Resource$Folders; organizations: Resource$Organizations; projects: Resource$Projects; @@ -123,7 +122,6 @@ export namespace assuredworkloads_v1 { google, }; - this.assuredworkloads = new Resource$Assuredworkloads(this.context); this.folders = new Resource$Folders(this.context); this.organizations = new Resource$Organizations(this.context); this.projects = new Resource$Projects(this.context); @@ -225,44 +223,6 @@ export namespace assuredworkloads_v1 { */ appliedUpdate?: Schema$GoogleCloudAssuredworkloadsV1WorkloadUpdate; } - /** - * Request for archiving resource events. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1ArchiveResourceEventsRequest { - /** - * Optional. Time to set as ArchiveTime in the archive table. If not provided, the current time is used. - */ - archiveTime?: string | null; - /** - * Required. The number of events to process in a single transaction batch. - */ - batchSize?: number | null; - /** - * Required. Only events with EventTime earlier than this cutoff will be archived. - */ - eventCutoffTime?: string | null; - /** - * Required. The maximum total number of events to move in this request. - */ - maxEventsMove?: number | null; - /** - * Required. The organization ID for which to archive events. - */ - organizationId?: string | null; - /** - * Required. The region of the workload(s) whose events should be archived. This is used to filter workloads based on AssurantWorkloadData.region. - */ - region?: string | null; - } - /** - * Response for archiving resource events. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1ArchiveResourceEventsResponse { - /** - * The total number of events successfully moved to the archive table. - */ - movedEventsCount?: number | null; - } /** * Represents move analysis results for an asset. */ @@ -885,44 +845,6 @@ export namespace assuredworkloads_v1 { * Response for restricting the list of allowed resources. */ export interface Schema$GoogleCloudAssuredworkloadsV1RestrictAllowedResourcesResponse {} - /** - * Request for reverting archived resource events. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsRequest { - /** - * Required. Only events within this time range will be reverted. This helps prevent reverting everything when something goes wrong. - */ - archiveEndTime?: string | null; - /** - * Required. Only events within this time range will be reverted. This helps prevent reverting everything when something goes wrong. - */ - archiveStartTime?: string | null; - /** - * Required. The number of events to process in a single transaction batch. - */ - batchSize?: number | null; - /** - * Required. The maximum total number of events to move in this request. - */ - maxEventsMove?: number | null; - /** - * Required. The organization ID for which to revert events. - */ - organizationId?: string | null; - /** - * Required. The region of the workload(s) whose events should be reverted. This is used to filter workloads based on AssurantWorkloadData.region. - */ - region?: string | null; - } - /** - * Response for reverting archived resource events. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsResponse { - /** - * The total number of events successfully moved to the original table. - */ - movedEventsCount?: number | null; - } /** * A rule in the cloud control. */ @@ -1505,342 +1427,6 @@ export namespace assuredworkloads_v1 { message?: string | null; } - export class Resource$Assuredworkloads { - context: APIRequestContext; - constructor(context: APIRequestContext) { - this.context = context; - } - - /** - * Finds orphan ResourceEvents matching the criteria and moves them to the ArchivedResourceEvents table. - * @example - * ```js - * // Before running the sample: - * // - Enable the API at: - * // https://console.developers.google.com/apis/api/assuredworkloads.googleapis.com - * // - Login into gcloud by running: - * // ```sh - * // $ gcloud auth application-default login - * // ``` - * // - Install the npm module by running: - * // ```sh - * // $ npm install googleapis - * // ``` - * - * const {google} = require('googleapis'); - * const assuredworkloads = google.assuredworkloads('v1'); - * - * async function main() { - * const auth = new google.auth.GoogleAuth({ - * // Scopes can be specified either as an array or as a single, space-delimited string. - * scopes: ['https://www.googleapis.com/auth/cloud-platform'], - * }); - * - * // Acquire an auth client, and bind it to all future calls - * const authClient = await auth.getClient(); - * google.options({auth: authClient}); - * - * // Do the magic - * const res = await assuredworkloads.assuredworkloads.archiveResourceEvents({ - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "archiveTime": "my_archiveTime", - * // "batchSize": 0, - * // "eventCutoffTime": "my_eventCutoffTime", - * // "maxEventsMove": 0, - * // "organizationId": "my_organizationId", - * // "region": "my_region" - * // } - * }, - * }); - * console.log(res.data); - * - * // Example response - * // { - * // "movedEventsCount": 0 - * // } - * } - * - * main().catch(e => { - * console.error(e); - * throw e; - * }); - * - * ``` - * - * @param params - Parameters for request - * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. - * @param callback - Optional callback that handles the response. - * @returns A promise if used with async/await, or void if used with a callback. - */ - archiveResourceEvents( - params: Params$Resource$Assuredworkloads$Archiveresourceevents, - options: StreamMethodOptions - ): Promise>; - archiveResourceEvents( - params?: Params$Resource$Assuredworkloads$Archiveresourceevents, - options?: MethodOptions - ): Promise< - GaxiosResponseWithHTTP2 - >; - archiveResourceEvents( - params: Params$Resource$Assuredworkloads$Archiveresourceevents, - options: StreamMethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - archiveResourceEvents( - params: Params$Resource$Assuredworkloads$Archiveresourceevents, - options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - archiveResourceEvents( - params: Params$Resource$Assuredworkloads$Archiveresourceevents, - callback: BodyResponseCallback - ): void; - archiveResourceEvents( - callback: BodyResponseCallback - ): void; - archiveResourceEvents( - paramsOrCallback?: - | Params$Resource$Assuredworkloads$Archiveresourceevents - | BodyResponseCallback - | BodyResponseCallback, - optionsOrCallback?: - | MethodOptions - | StreamMethodOptions - | BodyResponseCallback - | BodyResponseCallback, - callback?: - | BodyResponseCallback - | BodyResponseCallback - ): - | void - | Promise< - GaxiosResponseWithHTTP2 - > - | Promise> { - let params = (paramsOrCallback || - {}) as Params$Resource$Assuredworkloads$Archiveresourceevents; - let options = (optionsOrCallback || {}) as MethodOptions; - - if (typeof paramsOrCallback === 'function') { - callback = paramsOrCallback; - params = {} as Params$Resource$Assuredworkloads$Archiveresourceevents; - options = {}; - } - - if (typeof optionsOrCallback === 'function') { - callback = optionsOrCallback; - options = {}; - } - - const rootUrl = - options.rootUrl || 'https://assuredworkloads.googleapis.com/'; - const parameters = { - options: Object.assign( - { - url: ( - rootUrl + '/v1/assuredworkloads:archiveResourceEvents' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'POST', - apiVersion: '', - }, - options - ), - params, - requiredParams: [], - pathParams: [], - context: this.context, - }; - if (callback) { - createAPIRequest( - parameters, - callback as BodyResponseCallback - ); - } else { - return createAPIRequest( - parameters - ); - } - } - - /** - * Finds matching ArchivedResourceEvents and moves them back to the ResourceEvents table. - * @example - * ```js - * // Before running the sample: - * // - Enable the API at: - * // https://console.developers.google.com/apis/api/assuredworkloads.googleapis.com - * // - Login into gcloud by running: - * // ```sh - * // $ gcloud auth application-default login - * // ``` - * // - Install the npm module by running: - * // ```sh - * // $ npm install googleapis - * // ``` - * - * const {google} = require('googleapis'); - * const assuredworkloads = google.assuredworkloads('v1'); - * - * async function main() { - * const auth = new google.auth.GoogleAuth({ - * // Scopes can be specified either as an array or as a single, space-delimited string. - * scopes: ['https://www.googleapis.com/auth/cloud-platform'], - * }); - * - * // Acquire an auth client, and bind it to all future calls - * const authClient = await auth.getClient(); - * google.options({auth: authClient}); - * - * // Do the magic - * const res = - * await assuredworkloads.assuredworkloads.revertArchivedResourceEvents({ - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "archiveEndTime": "my_archiveEndTime", - * // "archiveStartTime": "my_archiveStartTime", - * // "batchSize": 0, - * // "maxEventsMove": 0, - * // "organizationId": "my_organizationId", - * // "region": "my_region" - * // } - * }, - * }); - * console.log(res.data); - * - * // Example response - * // { - * // "movedEventsCount": 0 - * // } - * } - * - * main().catch(e => { - * console.error(e); - * throw e; - * }); - * - * ``` - * - * @param params - Parameters for request - * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. - * @param callback - Optional callback that handles the response. - * @returns A promise if used with async/await, or void if used with a callback. - */ - revertArchivedResourceEvents( - params: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - options: StreamMethodOptions - ): Promise>; - revertArchivedResourceEvents( - params?: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - options?: MethodOptions - ): Promise< - GaxiosResponseWithHTTP2 - >; - revertArchivedResourceEvents( - params: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - options: StreamMethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - revertArchivedResourceEvents( - params: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - revertArchivedResourceEvents( - params: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - callback: BodyResponseCallback - ): void; - revertArchivedResourceEvents( - callback: BodyResponseCallback - ): void; - revertArchivedResourceEvents( - paramsOrCallback?: - | Params$Resource$Assuredworkloads$Revertarchivedresourceevents - | BodyResponseCallback - | BodyResponseCallback, - optionsOrCallback?: - | MethodOptions - | StreamMethodOptions - | BodyResponseCallback - | BodyResponseCallback, - callback?: - | BodyResponseCallback - | BodyResponseCallback - ): - | void - | Promise< - GaxiosResponseWithHTTP2 - > - | Promise> { - let params = (paramsOrCallback || - {}) as Params$Resource$Assuredworkloads$Revertarchivedresourceevents; - let options = (optionsOrCallback || {}) as MethodOptions; - - if (typeof paramsOrCallback === 'function') { - callback = paramsOrCallback; - params = - {} as Params$Resource$Assuredworkloads$Revertarchivedresourceevents; - options = {}; - } - - if (typeof optionsOrCallback === 'function') { - callback = optionsOrCallback; - options = {}; - } - - const rootUrl = - options.rootUrl || 'https://assuredworkloads.googleapis.com/'; - const parameters = { - options: Object.assign( - { - url: ( - rootUrl + '/v1/assuredworkloads:revertArchivedResourceEvents' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'POST', - apiVersion: '', - }, - options - ), - params, - requiredParams: [], - pathParams: [], - context: this.context, - }; - if (callback) { - createAPIRequest( - parameters, - callback as BodyResponseCallback - ); - } else { - return createAPIRequest( - parameters - ); - } - } - } - - export interface Params$Resource$Assuredworkloads$Archiveresourceevents extends StandardParameters { - /** - * Request body metadata - */ - requestBody?: Schema$GoogleCloudAssuredworkloadsV1ArchiveResourceEventsRequest; - } - export interface Params$Resource$Assuredworkloads$Revertarchivedresourceevents extends StandardParameters { - /** - * Request body metadata - */ - requestBody?: Schema$GoogleCloudAssuredworkloadsV1RevertArchivedResourceEventsRequest; - } - export class Resource$Folders { context: APIRequestContext; locations: Resource$Folders$Locations; diff --git a/src/apis/assuredworkloads/v1beta1.ts b/src/apis/assuredworkloads/v1beta1.ts index f549ba0bb2..daa620223a 100644 --- a/src/apis/assuredworkloads/v1beta1.ts +++ b/src/apis/assuredworkloads/v1beta1.ts @@ -112,7 +112,6 @@ export namespace assuredworkloads_v1beta1 { */ export class Assuredworkloads { context: APIRequestContext; - assuredworkloads: Resource$Assuredworkloads; folders: Resource$Folders; organizations: Resource$Organizations; projects: Resource$Projects; @@ -123,7 +122,6 @@ export namespace assuredworkloads_v1beta1 { google, }; - this.assuredworkloads = new Resource$Assuredworkloads(this.context); this.folders = new Resource$Folders(this.context); this.organizations = new Resource$Organizations(this.context); this.projects = new Resource$Projects(this.context); @@ -225,44 +223,6 @@ export namespace assuredworkloads_v1beta1 { */ appliedUpdate?: Schema$GoogleCloudAssuredworkloadsV1beta1WorkloadUpdate; } - /** - * Request for archiving resource events. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsRequest { - /** - * Optional. Time to set as ArchiveTime in the archive table. If not provided, the current time is used. - */ - archiveTime?: string | null; - /** - * Required. The number of events to process in a single transaction batch. - */ - batchSize?: number | null; - /** - * Required. Only events with EventTime earlier than this cutoff will be archived. - */ - eventCutoffTime?: string | null; - /** - * Required. The maximum total number of events to move in this request. - */ - maxEventsMove?: number | null; - /** - * Required. The organization ID for which to archive events. - */ - organizationId?: string | null; - /** - * Required. The region of the workload(s) whose events should be archived. This is used to filter workloads based on AssurantWorkloadData.region. - */ - region?: string | null; - } - /** - * Response for archiving resource events. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsResponse { - /** - * The total number of events successfully moved to the archive table. - */ - movedEventsCount?: number | null; - } /** * Represents move analysis results for an asset. */ @@ -872,44 +832,6 @@ export namespace assuredworkloads_v1beta1 { * Response for restricting the list of allowed resources. */ export interface Schema$GoogleCloudAssuredworkloadsV1beta1RestrictAllowedResourcesResponse {} - /** - * Request for reverting archived resource events. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsRequest { - /** - * Required. Only events within this time range will be reverted. This helps prevent reverting everything when something goes wrong. - */ - archiveEndTime?: string | null; - /** - * Required. Only events within this time range will be reverted. This helps prevent reverting everything when something goes wrong. - */ - archiveStartTime?: string | null; - /** - * Required. The number of events to process in a single transaction batch. - */ - batchSize?: number | null; - /** - * Required. The maximum total number of events to move in this request. - */ - maxEventsMove?: number | null; - /** - * Required. The organization ID for which to revert events. - */ - organizationId?: string | null; - /** - * Required. The region of the workload(s) whose events should be reverted. This is used to filter workloads based on AssurantWorkloadData.region. - */ - region?: string | null; - } - /** - * Response for reverting archived resource events. - */ - export interface Schema$GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsResponse { - /** - * The total number of events successfully moved to the original table. - */ - movedEventsCount?: number | null; - } /** * A rule in the cloud control. */ @@ -1552,342 +1474,6 @@ export namespace assuredworkloads_v1beta1 { message?: string | null; } - export class Resource$Assuredworkloads { - context: APIRequestContext; - constructor(context: APIRequestContext) { - this.context = context; - } - - /** - * Finds orphan ResourceEvents matching the criteria and moves them to the ArchivedResourceEvents table. - * @example - * ```js - * // Before running the sample: - * // - Enable the API at: - * // https://console.developers.google.com/apis/api/assuredworkloads.googleapis.com - * // - Login into gcloud by running: - * // ```sh - * // $ gcloud auth application-default login - * // ``` - * // - Install the npm module by running: - * // ```sh - * // $ npm install googleapis - * // ``` - * - * const {google} = require('googleapis'); - * const assuredworkloads = google.assuredworkloads('v1beta1'); - * - * async function main() { - * const auth = new google.auth.GoogleAuth({ - * // Scopes can be specified either as an array or as a single, space-delimited string. - * scopes: ['https://www.googleapis.com/auth/cloud-platform'], - * }); - * - * // Acquire an auth client, and bind it to all future calls - * const authClient = await auth.getClient(); - * google.options({auth: authClient}); - * - * // Do the magic - * const res = await assuredworkloads.assuredworkloads.archiveResourceEvents({ - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "archiveTime": "my_archiveTime", - * // "batchSize": 0, - * // "eventCutoffTime": "my_eventCutoffTime", - * // "maxEventsMove": 0, - * // "organizationId": "my_organizationId", - * // "region": "my_region" - * // } - * }, - * }); - * console.log(res.data); - * - * // Example response - * // { - * // "movedEventsCount": 0 - * // } - * } - * - * main().catch(e => { - * console.error(e); - * throw e; - * }); - * - * ``` - * - * @param params - Parameters for request - * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. - * @param callback - Optional callback that handles the response. - * @returns A promise if used with async/await, or void if used with a callback. - */ - archiveResourceEvents( - params: Params$Resource$Assuredworkloads$Archiveresourceevents, - options: StreamMethodOptions - ): Promise>; - archiveResourceEvents( - params?: Params$Resource$Assuredworkloads$Archiveresourceevents, - options?: MethodOptions - ): Promise< - GaxiosResponseWithHTTP2 - >; - archiveResourceEvents( - params: Params$Resource$Assuredworkloads$Archiveresourceevents, - options: StreamMethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - archiveResourceEvents( - params: Params$Resource$Assuredworkloads$Archiveresourceevents, - options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - archiveResourceEvents( - params: Params$Resource$Assuredworkloads$Archiveresourceevents, - callback: BodyResponseCallback - ): void; - archiveResourceEvents( - callback: BodyResponseCallback - ): void; - archiveResourceEvents( - paramsOrCallback?: - | Params$Resource$Assuredworkloads$Archiveresourceevents - | BodyResponseCallback - | BodyResponseCallback, - optionsOrCallback?: - | MethodOptions - | StreamMethodOptions - | BodyResponseCallback - | BodyResponseCallback, - callback?: - | BodyResponseCallback - | BodyResponseCallback - ): - | void - | Promise< - GaxiosResponseWithHTTP2 - > - | Promise> { - let params = (paramsOrCallback || - {}) as Params$Resource$Assuredworkloads$Archiveresourceevents; - let options = (optionsOrCallback || {}) as MethodOptions; - - if (typeof paramsOrCallback === 'function') { - callback = paramsOrCallback; - params = {} as Params$Resource$Assuredworkloads$Archiveresourceevents; - options = {}; - } - - if (typeof optionsOrCallback === 'function') { - callback = optionsOrCallback; - options = {}; - } - - const rootUrl = - options.rootUrl || 'https://assuredworkloads.googleapis.com/'; - const parameters = { - options: Object.assign( - { - url: ( - rootUrl + '/v1beta1/assuredworkloads:archiveResourceEvents' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'POST', - apiVersion: '', - }, - options - ), - params, - requiredParams: [], - pathParams: [], - context: this.context, - }; - if (callback) { - createAPIRequest( - parameters, - callback as BodyResponseCallback - ); - } else { - return createAPIRequest( - parameters - ); - } - } - - /** - * Finds matching ArchivedResourceEvents and moves them back to the ResourceEvents table. - * @example - * ```js - * // Before running the sample: - * // - Enable the API at: - * // https://console.developers.google.com/apis/api/assuredworkloads.googleapis.com - * // - Login into gcloud by running: - * // ```sh - * // $ gcloud auth application-default login - * // ``` - * // - Install the npm module by running: - * // ```sh - * // $ npm install googleapis - * // ``` - * - * const {google} = require('googleapis'); - * const assuredworkloads = google.assuredworkloads('v1beta1'); - * - * async function main() { - * const auth = new google.auth.GoogleAuth({ - * // Scopes can be specified either as an array or as a single, space-delimited string. - * scopes: ['https://www.googleapis.com/auth/cloud-platform'], - * }); - * - * // Acquire an auth client, and bind it to all future calls - * const authClient = await auth.getClient(); - * google.options({auth: authClient}); - * - * // Do the magic - * const res = - * await assuredworkloads.assuredworkloads.revertArchivedResourceEvents({ - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "archiveEndTime": "my_archiveEndTime", - * // "archiveStartTime": "my_archiveStartTime", - * // "batchSize": 0, - * // "maxEventsMove": 0, - * // "organizationId": "my_organizationId", - * // "region": "my_region" - * // } - * }, - * }); - * console.log(res.data); - * - * // Example response - * // { - * // "movedEventsCount": 0 - * // } - * } - * - * main().catch(e => { - * console.error(e); - * throw e; - * }); - * - * ``` - * - * @param params - Parameters for request - * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. - * @param callback - Optional callback that handles the response. - * @returns A promise if used with async/await, or void if used with a callback. - */ - revertArchivedResourceEvents( - params: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - options: StreamMethodOptions - ): Promise>; - revertArchivedResourceEvents( - params?: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - options?: MethodOptions - ): Promise< - GaxiosResponseWithHTTP2 - >; - revertArchivedResourceEvents( - params: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - options: StreamMethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - revertArchivedResourceEvents( - params: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - revertArchivedResourceEvents( - params: Params$Resource$Assuredworkloads$Revertarchivedresourceevents, - callback: BodyResponseCallback - ): void; - revertArchivedResourceEvents( - callback: BodyResponseCallback - ): void; - revertArchivedResourceEvents( - paramsOrCallback?: - | Params$Resource$Assuredworkloads$Revertarchivedresourceevents - | BodyResponseCallback - | BodyResponseCallback, - optionsOrCallback?: - | MethodOptions - | StreamMethodOptions - | BodyResponseCallback - | BodyResponseCallback, - callback?: - | BodyResponseCallback - | BodyResponseCallback - ): - | void - | Promise< - GaxiosResponseWithHTTP2 - > - | Promise> { - let params = (paramsOrCallback || - {}) as Params$Resource$Assuredworkloads$Revertarchivedresourceevents; - let options = (optionsOrCallback || {}) as MethodOptions; - - if (typeof paramsOrCallback === 'function') { - callback = paramsOrCallback; - params = - {} as Params$Resource$Assuredworkloads$Revertarchivedresourceevents; - options = {}; - } - - if (typeof optionsOrCallback === 'function') { - callback = optionsOrCallback; - options = {}; - } - - const rootUrl = - options.rootUrl || 'https://assuredworkloads.googleapis.com/'; - const parameters = { - options: Object.assign( - { - url: ( - rootUrl + '/v1beta1/assuredworkloads:revertArchivedResourceEvents' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'POST', - apiVersion: '', - }, - options - ), - params, - requiredParams: [], - pathParams: [], - context: this.context, - }; - if (callback) { - createAPIRequest( - parameters, - callback as BodyResponseCallback - ); - } else { - return createAPIRequest( - parameters - ); - } - } - } - - export interface Params$Resource$Assuredworkloads$Archiveresourceevents extends StandardParameters { - /** - * Request body metadata - */ - requestBody?: Schema$GoogleCloudAssuredworkloadsV1beta1ArchiveResourceEventsRequest; - } - export interface Params$Resource$Assuredworkloads$Revertarchivedresourceevents extends StandardParameters { - /** - * Request body metadata - */ - requestBody?: Schema$GoogleCloudAssuredworkloadsV1beta1RevertArchivedResourceEventsRequest; - } - export class Resource$Folders { context: APIRequestContext; locations: Resource$Folders$Locations; diff --git a/src/apis/biglake/v1.ts b/src/apis/biglake/v1.ts index 9793a81eca..a2e1b92b2d 100644 --- a/src/apis/biglake/v1.ts +++ b/src/apis/biglake/v1.ts @@ -946,11 +946,15 @@ export namespace biglake_v1 { export class Resource$Projects$Catalogs$Namespaces { context: APIRequestContext; tables: Resource$Projects$Catalogs$Namespaces$Tables; + views: Resource$Projects$Catalogs$Namespaces$Views; constructor(context: APIRequestContext) { this.context = context; this.tables = new Resource$Projects$Catalogs$Namespaces$Tables( this.context ); + this.views = new Resource$Projects$Catalogs$Namespaces$Views( + this.context + ); } /** @@ -1929,6 +1933,499 @@ export namespace biglake_v1 { requestBody?: Schema$TestIamPermissionsRequest; } + export class Resource$Projects$Catalogs$Namespaces$Views { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Gets the IAM policy for the specified View. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/biglake.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const biglake = google.biglake('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/bigquery', + * 'https://www.googleapis.com/auth/cloud-platform', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await biglake.projects.catalogs.namespaces.views.getIamPolicy({ + * // 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). + * 'options.requestedPolicyVersion': 'placeholder-value', + * // 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. + * resource: + * 'projects/my-project/catalogs/my-catalog/namespaces/my-namespace/views/my-view', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "auditConfigs": [], + * // "bindings": [], + * // "etag": "my_etag", + * // "version": 0 + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + getIamPolicy( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy, + options: StreamMethodOptions + ): Promise>; + getIamPolicy( + params?: Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy, + options?: MethodOptions + ): Promise>; + getIamPolicy( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + getIamPolicy( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + getIamPolicy( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy, + callback: BodyResponseCallback + ): void; + getIamPolicy(callback: BodyResponseCallback): void; + getIamPolicy( + paramsOrCallback?: + | Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://biglake.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+resource}:getIamPolicy').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Sets the IAM policy for the specified view. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/biglake.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const biglake = google.biglake('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/bigquery', + * 'https://www.googleapis.com/auth/cloud-platform', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await biglake.projects.catalogs.namespaces.views.setIamPolicy({ + * // 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. + * resource: + * 'projects/my-project/catalogs/my-catalog/namespaces/my-namespace/views/my-view', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "policy": {}, + * // "updateMask": "my_updateMask" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "auditConfigs": [], + * // "bindings": [], + * // "etag": "my_etag", + * // "version": 0 + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + setIamPolicy( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy, + options: StreamMethodOptions + ): Promise>; + setIamPolicy( + params?: Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy, + options?: MethodOptions + ): Promise>; + setIamPolicy( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + setIamPolicy( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + setIamPolicy( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy, + callback: BodyResponseCallback + ): void; + setIamPolicy(callback: BodyResponseCallback): void; + setIamPolicy( + paramsOrCallback?: + | Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://biglake.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+resource}:setIamPolicy').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Tests the IAM permissions for the specified view. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/biglake.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const biglake = google.biglake('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/bigquery', + * 'https://www.googleapis.com/auth/cloud-platform', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await biglake.projects.catalogs.namespaces.views.testIamPermissions({ + * // 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. + * resource: + * 'projects/my-project/catalogs/my-catalog/namespaces/my-namespace/views/my-view', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "permissions": [] + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "permissions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + testIamPermissions( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions, + options: StreamMethodOptions + ): Promise>; + testIamPermissions( + params?: Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions, + options?: MethodOptions + ): Promise>; + testIamPermissions( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + testIamPermissions( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + testIamPermissions( + params: Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions, + callback: BodyResponseCallback + ): void; + testIamPermissions( + callback: BodyResponseCallback + ): void; + testIamPermissions( + paramsOrCallback?: + | Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://biglake.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+resource}:testIamPermissions').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Projects$Catalogs$Namespaces$Views$Getiampolicy extends StandardParameters { + /** + * 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). + */ + 'options.requestedPolicyVersion'?: number; + /** + * 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. + */ + resource?: string; + } + export interface Params$Resource$Projects$Catalogs$Namespaces$Views$Setiampolicy extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$SetIamPolicyRequest; + } + export interface Params$Resource$Projects$Catalogs$Namespaces$Views$Testiampermissions extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$TestIamPermissionsRequest; + } + export class Resource$Projects$Locations { context: APIRequestContext; catalogs: Resource$Projects$Locations$Catalogs; diff --git a/src/apis/chromemanagement/v1.ts b/src/apis/chromemanagement/v1.ts index d19833b0df..1221871b3e 100644 --- a/src/apis/chromemanagement/v1.ts +++ b/src/apis/chromemanagement/v1.ts @@ -2665,6 +2665,56 @@ export namespace chromemanagement_v1 { */ publicKey?: string | null; } + /** + * A specific installation of Chrome on a device with managed Chrome browsers. + */ + export interface Schema$GoogleChromeManagementVersionsV1Browser { + /** + * Output only. Browser version installed. + */ + browserVersion?: string | null; + /** + * Output only. The channel of the browser installed. + */ + channel?: string | null; + /** + * Output only. The path to the Chrome.exe executable for this browser. + */ + executablePath?: string | null; + /** + * Output only. The time when the last request to fetch policies succeeded on this Chrome browser. + */ + lastPolicyFetchTime?: string | null; + /** + * Output only. The time when the last report was received from this Chrome browser. + */ + lastStatusReportTime?: string | null; + /** + * Output only. Pending version of a browser is installed. This field is only set when the current active browser has a different version as in "browser_version". + */ + pendingInstallVersion?: string | null; + /** + * Output only. List of all plugins installed on this Chrome browser. + */ + plugins?: Schema$GoogleChromeManagementVersionsV1Plugin[]; + /** + * Output only. The list of profiles for this browser. + */ + profiles?: Schema$GoogleChromeManagementVersionsV1Profile[]; + } + /** + * A Chrome browser user. + */ + export interface Schema$GoogleChromeManagementVersionsV1BrowserUser { + /** + * Output only. The time when this user info last reported a status. + */ + lastStatusReportTime?: string | null; + /** + * Output only. The user name of the user that signed into chrome. + */ + userName?: string | null; + } /** * A certificate provisioning process. */ @@ -2739,6 +2789,127 @@ export namespace chromemanagement_v1 { */ insightsState?: string | null; } + /** + * A device with managed Chrome Browsers. + */ + export interface Schema$GoogleChromeManagementVersionsV1ChromeBrowser { + /** + * Optional. Asset identifier as annotated by the administrator or specified during enrollment. + */ + annotatedAssetId?: string | null; + /** + * Optional. Address or location of the device as annotated by the administrator. + */ + annotatedLocation?: string | null; + /** + * Optional. Notes about this device as annotated by the administrator. + */ + annotatedNotes?: string | null; + /** + * Optional. User of the device as annotated by the administrator. + */ + annotatedUser?: string | null; + /** + * Output only. The attestation credential used for Device Trust Connector. + */ + attestationCredential?: Schema$GoogleChromeManagementVersionsV1AttestationCredential; + /** + * Output only. Unique identifier of Chrome Browser. + */ + browserPermanentId?: string | null; + /** + * Output only. List of Chrome browsers installed on this device. + */ + browsers?: Schema$GoogleChromeManagementVersionsV1Browser[]; + /** + * Output only. List of all browser versions installed on this device. + */ + browserVersions?: string[] | null; + /** + * Output only. The history of identifiers reported to this device. + */ + deviceIdentifiersHistory?: Schema$GoogleChromeManagementVersionsV1DeviceIdentifiersHistory; + /** + * Output only. The number of distinct extensions installed on all the Chrome browsers of this device. + */ + extensionCount?: string | null; + /** + * Output only. The time of the last activity on the device device either from reporting, policy fetching or registration. + */ + lastActivityTime?: string | null; + /** + * Output only. The last user who logged into a Chrome browser on this device. + */ + lastDeviceUser?: string | null; + /** + * Output only. List of recent browser users, in descending order by last report time. + */ + lastDeviceUsers?: Schema$GoogleChromeManagementVersionsV1BrowserUser[]; + /** + * Output only. The time the last policy fetch succeeded on this device. + */ + lastPolicyFetchTime?: string | null; + /** + * Output only. The time the device last tried to register. + */ + lastRegistrationTime?: string | null; + /** + * Output only. The time the device last sent a status report. + */ + lastStatusReportTime?: string | null; + /** + * Output only. The list of all device level policies set for extensions installed in Chrome on this device. + */ + machineExtensionPolicies?: Schema$GoogleChromeManagementVersionsV1ExtensionPolicy[]; + /** + * Output only. Machine name. + */ + machineName?: string | null; + /** + * Output only. The list of all device level policies set for Chrome browsers on this device. + */ + machinePolicies?: Schema$GoogleChromeManagementVersionsV1Policy[]; + /** + * Identifier. Format: customers/{customer_id\}/chromeBrowsers/{browser_permanent_id\} + */ + name?: string | null; + /** + * Output only. Recent policy fetch activity by Omaha. Not necessarily the last fetch since this field is only updated daily. + */ + omahaRecentFetchTime?: string | null; + /** + * Output only. The obfuscated organizational unit ID of the browser. + */ + orgUnitId?: string | null; + /** + * Output only. Device CPU architecture. + */ + osArchitecture?: string | null; + /** + * Output only. Device Os platform. + */ + osPlatform?: string | null; + /** + * Output only. Device Os platform and version combined. + */ + osPlatformVersion?: string | null; + /** + * Output only. Device Os Version. + */ + osVersion?: string | null; + /** + * Output only. The number of distinct policies set on all the Chrome browsers of this device. + */ + policyCount?: string | null; + /** + * Output only. The device's serial number. + */ + serialNumber?: string | null; + /** + * Output only. The initial device id sent by the first Chrome browser that enrolled this device. + */ + virtualDeviceId?: string | null; + } /** * A representation of a Chrome browser profile. */ @@ -3121,6 +3292,57 @@ export namespace chromemanagement_v1 { */ xdrSettings?: Schema$GoogleChromeManagementVersionsV1XdrSettings; } + /** + * Collection of device identifiers. + */ + export interface Schema$GoogleChromeManagementVersionsV1DeviceIdentifiers { + /** + * Output only. The device's host name. + */ + hostName?: string | null; + /** + * Output only. The name of the machine associated with the device. + */ + machineName?: string | null; + /** + * Output only. The device's serial number. + */ + serialNumber?: string | null; + } + /** + * History of device identifiers reported from a device. + */ + export interface Schema$GoogleChromeManagementVersionsV1DeviceIdentifiersHistory { + /** + * Output only. The device id is potentially being used by multiple devices. + */ + deviceIdCollision?: boolean | null; + /** + * Output only. The last time we detected the device id collision. + */ + lastDeviceIdCollisionDetectionTime?: string | null; + /** + * Output only. List of device identifiers sent by this device. In descending order by last_activity_time. + */ + records?: Schema$GoogleChromeManagementVersionsV1DeviceIdentifiersRecord[]; + } + /** + * Record of the device identifiers and when they were reported. + */ + export interface Schema$GoogleChromeManagementVersionsV1DeviceIdentifiersRecord { + /** + * Output only. The first time these identifiers were reported. + */ + firstRecordTime?: string | null; + /** + * Output only. Device identifiers. + */ + identifiers?: Schema$GoogleChromeManagementVersionsV1DeviceIdentifiers; + /** + * Output only. The time of the last activity of these identifiers either from reporting, policy fetching or registration. + */ + lastActivityTime?: string | null; + } /** * Information of a device that runs a Chrome browser profile. */ @@ -3194,6 +3416,138 @@ export namespace chromemanagement_v1 { */ insightsState?: string | null; } + /** + * Enrollment token for a chrome device. + */ + export interface Schema$GoogleChromeManagementVersionsV1EnrollmentToken { + /** + * Output only. The creation time of the token. + */ + createTime?: string | null; + /** + * Output only. The id of the user who created the token. + */ + creatorId?: string | null; + /** + * Output only. The obfuscated ID of the customer to whom this token is associated. + */ + customerId?: string | null; + /** + * Identifier. The resource name of the enrollment token. Format: customers/{customer\}/enrollmentTokens/{token_permanent_id\} + */ + name?: string | null; + /** + * Optional. Obfuscated ID of the organization unit this token is associated with. If not set, the token is created for the root organization unit. + */ + orgUnitId?: string | null; + /** + * Output only. The id of the user who revoked the token, null if the token is not revoked. + */ + revokerId?: string | null; + /** + * Output only. The revocation time of the token, null if the token is not revoked. + */ + revokeTime?: string | null; + /** + * Output only. The state of the token. + */ + state?: string | null; + /** + * Output only. The value of the token stored on the device and used to identify it to the management service handling the enrollment request. + */ + token?: string | null; + /** + * Output only. Unique identifier of the enrollment token used to access information on tokens. + */ + tokenPermanentId?: string | null; + /** + * Optional. The device type this token is used for. If not set, defaults to `ENROLLMENT_TOKEN_TYPE_CHROME_BROWSER`. + */ + tokenType?: string | null; + } + /** + * Information about extensions installed on profile reported on an installed Chrome on a device with managed chrome browsers. + */ + export interface Schema$GoogleChromeManagementVersionsV1Extension { + /** + * Output only. The type of the extension. + */ + appType?: string | null; + /** + * Output only. If the extension is controlled by a browser policy. + */ + configuredAppPolicy?: string | null; + /** + * Output only. The localized description of this extension. + */ + description?: string | null; + /** + * Output only. Whether the extension is disabled. + */ + disabled?: boolean | null; + /** + * Output only. The id of the extension. + */ + extensionId?: string | null; + /** + * Output only. The localized name of this extension as reported by Chrome. + */ + extensionName?: string | null; + /** + * Output only. The URL of the homepage for this extension. + */ + homepageUri?: string | null; + /** + * Output only. The list of icons available for this extension. + */ + icons?: Schema$GoogleChromeManagementVersionsV1ExtensionIcon[]; + /** + * Output only. The way the extension was installed. + */ + installType?: string | null; + /** + * Output only. The manifest version of this extension. + */ + manifestVersion?: number | null; + /** + * Output only. The list of permissions required for this extension. + */ + permissions?: string[] | null; + /** + * Output only. The version of the extension. + */ + version?: string | null; + } + /** + * An icon of a Chrome browser extension. + */ + export interface Schema$GoogleChromeManagementVersionsV1ExtensionIcon { + /** + * Output only. The size of the extension icon. + */ + size?: number | null; + /** + * Output only. The URL to the extension icon. + */ + uri?: string | null; + } + /** + * The reported policies applied to an extension installed on a Chrome profile. + */ + export interface Schema$GoogleChromeManagementVersionsV1ExtensionPolicy { + /** + * Output only. The id of the extension the policies are applied to. + */ + extensionId?: string | null; + /** + * Output only. The name of the extension the policies are applied to. + */ + extensionName?: string | null; + /** + * Output only. List of policies applied to this extension. + */ + policies?: Schema$GoogleChromeManagementVersionsV1Policy[]; + } /** * Describes a generic Certificate Authority Connection. */ @@ -3263,6 +3617,19 @@ export namespace chromemanagement_v1 { */ totalSize?: string | null; } + /** + * Response to ListChromeBrowsers method. + */ + export interface Schema$GoogleChromeManagementVersionsV1ListChromeBrowsersResponse { + /** + * List of Chrome Browser device objects. + */ + chromeBrowsers?: Schema$GoogleChromeManagementVersionsV1ChromeBrowser[]; + /** + * Token used to access next page of this result. + */ + nextPageToken?: string | null; + } /** * Response to ListConnectorConfigs method. */ @@ -3276,6 +3643,19 @@ export namespace chromemanagement_v1 { */ nextPageToken?: string | null; } + /** + * Response that contains a list of tokens. + */ + export interface Schema$GoogleChromeManagementVersionsV1ListEnrollmentTokensResponse { + /** + * List of Chrome device enrollment tokens. + */ + enrollmentTokens?: Schema$GoogleChromeManagementVersionsV1EnrollmentToken[]; + /** + * Token to retrieve the next page of results, or empty if there are no more results in the list. + */ + nextPageToken?: string | null; + } /** * MIP label connector config. */ @@ -3289,6 +3669,23 @@ export namespace chromemanagement_v1 { */ microsoftTenantId?: string | null; } + /** + * Request to MoveChromeBrowsers method. + */ + export interface Schema$GoogleChromeManagementVersionsV1MoveChromeBrowsersRequest { + /** + * Required. ID of the destination organizational unit. + */ + destinationOrgUnitId?: string | null; + /** + * Required. List of resource IDs of Chrome Browser Devices to move. A maximum of 600 browsers may be moved per request. + */ + resourceIds?: string[] | null; + } + /** + * Response to MoveChromeBrowsers method. + */ + export interface Schema$GoogleChromeManagementVersionsV1MoveChromeBrowsersResponse {} /** * Request to MoveThirdPartyProfileUser method. */ @@ -3325,26 +3722,113 @@ export namespace chromemanagement_v1 { reportingSettings?: Schema$GoogleChromeManagementVersionsV1ReportingSettings; } /** - * Pub/Sub connector config. + * Information about a Chrome browser plugin installed on a reported Chrome installation on a device with managed Chrome browsers. */ - export interface Schema$GoogleChromeManagementVersionsV1PubSubConfig { + export interface Schema$GoogleChromeManagementVersionsV1Plugin { /** - * Required. The reporting settings for the Pub/Sub config. + * Output only. The description of the installed plugin. */ - reportingSettings?: Schema$GoogleChromeManagementVersionsV1ReportingSettings; + description?: string | null; /** - * Required. The full path to the topic to send the event to. Must be at most 1000 characters. + * Output only. The filename of the installed plugin. */ - topicFullPath?: string | null; + filename?: string | null; + /** + * Output only. The name of the installed plugin. + */ + pluginName?: string | null; } /** - * Pub/Sub XDR connector config. + * The applied policy reported by a managed Chrome browser. The policy can be applied at various scopes (machine, profile, extension). */ - export interface Schema$GoogleChromeManagementVersionsV1PubSubXdrConfig { + export interface Schema$GoogleChromeManagementVersionsV1Policy { /** - * Required. The full path to the topic to send the event to. Must be at most 1000 characters. + * Output only. A localized string with all the errors reported when trying to apply this policy, if any. */ - topicFullPath?: string | null; + error?: string | null; + /** + * Output only. The name of the policy. + */ + policyName?: string | null; + /** + * Output only. The source of the policy. + */ + source?: string | null; + /** + * Output only. The value of the policy. + */ + value?: string | null; + } + /** + * A profile reported on an installation of Chrome on a device with managed chrome browsers. + */ + export interface Schema$GoogleChromeManagementVersionsV1Profile { + /** + * Output only. The email of the user signed in to this profile, if any. + */ + chromeSignedInUserEmail?: string | null; + /** + * Output only. The list of extensions with applied extension policies. + */ + extensionPolicies?: Schema$GoogleChromeManagementVersionsV1ExtensionPolicy[]; + /** + * Output only. The list of extensions installed for this profile. + */ + extensions?: Schema$GoogleChromeManagementVersionsV1Extension[]; + /** + * Output only. A unique ID for this profile. + */ + id?: string | null; + /** + * Output only. The time when the last request to fetch policies succeeded for this profile. + */ + lastPolicyFetchTime?: string | null; + /** + * Output only. The time when the last report was received from this profile. + */ + lastStatusReportTime?: string | null; + /** + * Output only. The name given to this profile. + */ + profileName?: string | null; + /** + * Output only. The number of safe browsing warnings that were shown on this profile. + */ + safeBrowsingWarnings?: string | null; + /** + * Output only. The number of safe browsing warnings that were clicked through on this profile. + */ + safeBrowsingWarningsClickThroughs?: string | null; + /** + * Output only. The last time the safe browsing warning info was reset to 0. + */ + safeBrowsingWarningsResetTime?: string | null; + /** + * Output only. The list of Chrome browser policies applied to this profile. + */ + userPolicies?: Schema$GoogleChromeManagementVersionsV1Policy[]; + } + /** + * Pub/Sub connector config. + */ + export interface Schema$GoogleChromeManagementVersionsV1PubSubConfig { + /** + * Required. The reporting settings for the Pub/Sub config. + */ + reportingSettings?: Schema$GoogleChromeManagementVersionsV1ReportingSettings; + /** + * Required. The full path to the topic to send the event to. Must be at most 1000 characters. + */ + topicFullPath?: string | null; + } + /** + * Pub/Sub XDR connector config. + */ + export interface Schema$GoogleChromeManagementVersionsV1PubSubXdrConfig { + /** + * Required. The full path to the topic to send the event to. Must be at most 1000 characters. + */ + topicFullPath?: string | null; /** * Required. The XDR settings for the Pub/Sub XDR config. */ @@ -3540,6 +4024,10 @@ export namespace chromemanagement_v1 { */ enabledOptInEvents?: string[] | null; } + /** + * Request to revoke a token. + */ + export interface Schema$GoogleChromeManagementVersionsV1RevokeEnrollmentTokenRequest {} /** * Describes a SCEP Certificate Authority Connection. */ @@ -3843,7 +4331,9 @@ export namespace chromemanagement_v1 { context: APIRequestContext; apps: Resource$Customers$Apps; certificateProvisioningProcesses: Resource$Customers$Certificateprovisioningprocesses; + chromeBrowsers: Resource$Customers$Chromebrowsers; connectorConfigs: Resource$Customers$Connectorconfigs; + enrollmentTokens: Resource$Customers$Enrollmenttokens; enterprise: Resource$Customers$Enterprise; profiles: Resource$Customers$Profiles; reports: Resource$Customers$Reports; @@ -3854,9 +4344,13 @@ export namespace chromemanagement_v1 { this.apps = new Resource$Customers$Apps(this.context); this.certificateProvisioningProcesses = new Resource$Customers$Certificateprovisioningprocesses(this.context); + this.chromeBrowsers = new Resource$Customers$Chromebrowsers(this.context); this.connectorConfigs = new Resource$Customers$Connectorconfigs( this.context ); + this.enrollmentTokens = new Resource$Customers$Enrollmenttokens( + this.context + ); this.enterprise = new Resource$Customers$Enterprise(this.context); this.profiles = new Resource$Customers$Profiles(this.context); this.reports = new Resource$Customers$Reports(this.context); @@ -5976,14 +6470,14 @@ export namespace chromemanagement_v1 { name?: string; } - export class Resource$Customers$Connectorconfigs { + export class Resource$Customers$Chromebrowsers { context: APIRequestContext; constructor(context: APIRequestContext) { this.context = context; } /** - * Creates a connector config. + * Deletes the data collected from a Chrome browser profile. * @example * ```js * // Before running the sample: @@ -6012,34 +6506,14 @@ export namespace chromemanagement_v1 { * google.options({auth: authClient}); * * // Do the magic - * const res = await chromemanagement.customers.connectorConfigs.create({ - * // Optional. ID to use for the connector config, which becomes the final component of the connector config's resource name. If provided, the ID must be 1-36 characters long, and contain only lowercase letters, digits, and hyphens. It must start with a letter, and end with a letter or number. If not provided, the connector config will be assigned a random UUID. - * connectorConfigId: 'placeholder-value', - * // Required. Format: customers/{customer\} - * parent: 'customers/my-customer', - * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "details": {}, - * // "displayName": "my_displayName", - * // "name": "my_name", - * // "status": {}, - * // "type": "my_type" - * // } - * }, + * const res = await chromemanagement.customers.chromeBrowsers.delete({ + * // Required. Format: customers/{customer_id\}/chromeBrowsers/{browser_permanent_id\} + * name: 'customers/my-customer/chromeBrowsers/my-chromeBrowser', * }); * console.log(res.data); * * // Example response - * // { - * // "details": {}, - * // "displayName": "my_displayName", - * // "name": "my_name", - * // "status": {}, - * // "type": "my_type" - * // } + * // {} * } * * main().catch(e => { @@ -6054,61 +6528,53 @@ export namespace chromemanagement_v1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - create( - params: Params$Resource$Customers$Connectorconfigs$Create, + delete( + params: Params$Resource$Customers$Chromebrowsers$Delete, options: StreamMethodOptions ): Promise>; - create( - params?: Params$Resource$Customers$Connectorconfigs$Create, + delete( + params?: Params$Resource$Customers$Chromebrowsers$Delete, options?: MethodOptions - ): Promise< - GaxiosResponseWithHTTP2 - >; - create( - params: Params$Resource$Customers$Connectorconfigs$Create, + ): Promise>; + delete( + params: Params$Resource$Customers$Chromebrowsers$Delete, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - create( - params: Params$Resource$Customers$Connectorconfigs$Create, - options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - create( - params: Params$Resource$Customers$Connectorconfigs$Create, - callback: BodyResponseCallback + delete( + params: Params$Resource$Customers$Chromebrowsers$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - create( - callback: BodyResponseCallback + delete( + params: Params$Resource$Customers$Chromebrowsers$Delete, + callback: BodyResponseCallback ): void; - create( + delete(callback: BodyResponseCallback): void; + delete( paramsOrCallback?: - | Params$Resource$Customers$Connectorconfigs$Create - | BodyResponseCallback + | Params$Resource$Customers$Chromebrowsers$Delete + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise< - GaxiosResponseWithHTTP2 - > + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Customers$Connectorconfigs$Create; + {}) as Params$Resource$Customers$Chromebrowsers$Delete; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Customers$Connectorconfigs$Create; + params = {} as Params$Resource$Customers$Chromebrowsers$Delete; options = {}; } @@ -6122,34 +6588,29 @@ export namespace chromemanagement_v1 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1/{+parent}/connectorConfigs').replace( - /([^:]\/)\/+/g, - '$1' - ), - method: 'POST', + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', apiVersion: '', }, options ), params, - requiredParams: ['parent'], - pathParams: ['parent'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( - parameters - ); + return createAPIRequest(parameters); } } /** - * Deletes a connector config. + * Retrieves a single Chrome Browser identified by its customer ID and resource ID. * @example * ```js * // Before running the sample: @@ -6178,14 +6639,44 @@ export namespace chromemanagement_v1 { * google.options({auth: authClient}); * * // Do the magic - * const res = await chromemanagement.customers.connectorConfigs.delete({ - * // Required. Format: customers/{customer\}/connectorConfigs/{connector_config\} - * name: 'customers/my-customer/connectorConfigs/my-connectorConfig', + * const res = await chromemanagement.customers.chromeBrowsers.get({ + * // Required. Format: customers/{customer_id\}/chromeBrowsers/{browser_permanent_id\} + * name: 'customers/my-customer/chromeBrowsers/my-chromeBrowser', * }); * console.log(res.data); * * // Example response - * // {} + * // { + * // "annotatedAssetId": "my_annotatedAssetId", + * // "annotatedLocation": "my_annotatedLocation", + * // "annotatedNotes": "my_annotatedNotes", + * // "annotatedUser": "my_annotatedUser", + * // "attestationCredential": {}, + * // "browserPermanentId": "my_browserPermanentId", + * // "browserVersions": [], + * // "browsers": [], + * // "deviceIdentifiersHistory": {}, + * // "extensionCount": "my_extensionCount", + * // "lastActivityTime": "my_lastActivityTime", + * // "lastDeviceUser": "my_lastDeviceUser", + * // "lastDeviceUsers": [], + * // "lastPolicyFetchTime": "my_lastPolicyFetchTime", + * // "lastRegistrationTime": "my_lastRegistrationTime", + * // "lastStatusReportTime": "my_lastStatusReportTime", + * // "machineExtensionPolicies": [], + * // "machineName": "my_machineName", + * // "machinePolicies": [], + * // "name": "my_name", + * // "omahaRecentFetchTime": "my_omahaRecentFetchTime", + * // "orgUnitId": "my_orgUnitId", + * // "osArchitecture": "my_osArchitecture", + * // "osPlatform": "my_osPlatform", + * // "osPlatformVersion": "my_osPlatformVersion", + * // "osVersion": "my_osVersion", + * // "policyCount": "my_policyCount", + * // "serialNumber": "my_serialNumber", + * // "virtualDeviceId": "my_virtualDeviceId" + * // } * } * * main().catch(e => { @@ -6200,53 +6691,61 @@ export namespace chromemanagement_v1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - delete( - params: Params$Resource$Customers$Connectorconfigs$Delete, + get( + params: Params$Resource$Customers$Chromebrowsers$Get, options: StreamMethodOptions ): Promise>; - delete( - params?: Params$Resource$Customers$Connectorconfigs$Delete, + get( + params?: Params$Resource$Customers$Chromebrowsers$Get, options?: MethodOptions - ): Promise>; - delete( - params: Params$Resource$Customers$Connectorconfigs$Delete, + ): Promise< + GaxiosResponseWithHTTP2 + >; + get( + params: Params$Resource$Customers$Chromebrowsers$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - delete( - params: Params$Resource$Customers$Connectorconfigs$Delete, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + get( + params: Params$Resource$Customers$Chromebrowsers$Get, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - delete( - params: Params$Resource$Customers$Connectorconfigs$Delete, - callback: BodyResponseCallback + get( + params: Params$Resource$Customers$Chromebrowsers$Get, + callback: BodyResponseCallback ): void; - delete(callback: BodyResponseCallback): void; - delete( + get( + callback: BodyResponseCallback + ): void; + get( paramsOrCallback?: - | Params$Resource$Customers$Connectorconfigs$Delete - | BodyResponseCallback + | Params$Resource$Customers$Chromebrowsers$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise< + GaxiosResponseWithHTTP2 + > | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Customers$Connectorconfigs$Delete; + {}) as Params$Resource$Customers$Chromebrowsers$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Customers$Connectorconfigs$Delete; + params = {} as Params$Resource$Customers$Chromebrowsers$Get; options = {}; } @@ -6261,7 +6760,7 @@ export namespace chromemanagement_v1 { options: Object.assign( { url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), - method: 'DELETE', + method: 'GET', apiVersion: '', }, options @@ -6272,17 +6771,19 @@ export namespace chromemanagement_v1 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest( + parameters + ); } } /** - * Gets a connector config with customer ID and config ID. + * Retrieves all Chrome Browsers of a customer (paginated). * @example * ```js * // Before running the sample: @@ -6311,19 +6812,24 @@ export namespace chromemanagement_v1 { * google.options({auth: authClient}); * * // Do the magic - * const res = await chromemanagement.customers.connectorConfigs.get({ - * // Required. Format: customers/{customer\}/connectorConfigs/{connector_config\} - * name: 'customers/my-customer/connectorConfigs/my-connectorConfig', + * const res = await chromemanagement.customers.chromeBrowsers.list({ + * // Optional. The filter used to filter browsers. The following fields can be used in the filter: * `browser_permanent_id` * `last_policy_fetch_time` * `os_platform` * `os_architecture` * `os_version` * `machine_name` * `annotated_location` * `annotated_user` * `annotated_asset_id` * `annotated_note` * `org_unit_path` * `org_unit_id` * `last_registration_time` * `os_platform_version` * `browser_version` * `last_status_report_time` * `extension_count` * `policy_count` * `last_device_user` * `last_activity_time` * `device_id_collision` The following functions can be used in the filter: * `in_group(string)`: Filters browsers that belong to the specified Cloud Identity group resource name (e.g. `in_group("groups/{group_id\}")`). Any of the above fields or functions can be used to specify a filter, and filtering by multiple fields or functions is supported with AND operator. String type, Integer type fields and enum type fields support `=` and `:` operators. The timestamp type fields support `=`, `<=` and `\>=` operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard `*` is only supported for `machine_name`, `annotated_asset_id`, and `browser_version`. In addition, global string literal filtering without a field name is supported: a single term (e.g., `ABC`) matches if any indexed string field contains `ABC`, and multiple terms joined by `AND` or whitespace (e.g., `machine AND 73` or `machine 73`) match browsers where every term appears in at least one indexed string field (whereas a single quoted phrase like `"machine 73"` matches the contiguous phrase within a single field). + * filter: 'placeholder-value', + * // Optional. The fields used to specify the ordering of the results. The supported fields are: * `browser_permanent_id` * `last_sync` * `annotated_user` * `annotated_location` * `annotated_asset_id` * `annotated_notes` * `org_unit_path` * `os_version` * `enrollment_date` * `extension_count` * `policy_count` * `last_signed_in_user` * `machine_name` * `browser_version_channel` * `os_platform_version` * `last_activity_time` * `browser_version` By default, sorting is in ascending order, to specify descending order for a field, a suffix ` desc` should be added to the field name. The default ordering is the descending order of `last_status_report_time`. + * orderBy: 'placeholder-value', + * // Optional. Maximum number of results to return. Maximum and default are 100. + * pageSize: 'placeholder-value', + * // Optional. Token to specify next page in the list. + * pageToken: 'placeholder-value', + * // Required. Format: customers/{customer_id\} + * parent: 'customers/my-customer', * }); * console.log(res.data); * * // Example response * // { - * // "details": {}, - * // "displayName": "my_displayName", - * // "name": "my_name", - * // "status": {}, - * // "type": "my_type" + * // "chromeBrowsers": [], + * // "nextPageToken": "my_nextPageToken" * // } * } * @@ -6339,61 +6845,1659 @@ export namespace chromemanagement_v1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - get( - params: Params$Resource$Customers$Connectorconfigs$Get, + list( + params: Params$Resource$Customers$Chromebrowsers$List, options: StreamMethodOptions ): Promise>; - get( - params?: Params$Resource$Customers$Connectorconfigs$Get, + list( + params?: Params$Resource$Customers$Chromebrowsers$List, options?: MethodOptions ): Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 >; - get( - params: Params$Resource$Customers$Connectorconfigs$Get, + list( + params: Params$Resource$Customers$Chromebrowsers$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - get( - params: Params$Resource$Customers$Connectorconfigs$Get, + list( + params: Params$Resource$Customers$Chromebrowsers$List, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - get( - params: Params$Resource$Customers$Connectorconfigs$Get, - callback: BodyResponseCallback + list( + params: Params$Resource$Customers$Chromebrowsers$List, + callback: BodyResponseCallback ): void; - get( - callback: BodyResponseCallback + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Customers$Chromebrowsers$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Chromebrowsers$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Chromebrowsers$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/chromeBrowsers').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Moves managed Chrome Browsers to a new Organizational Unit (OU). If there is an error while moving any of the browsers, none of the browsers will be moved. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.chromeBrowsers.move({ + * // Required. Format: customers/{customer_id\} + * parent: 'customers/my-customer', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "destinationOrgUnitId": "my_destinationOrgUnitId", + * // "resourceIds": [] + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // {} + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + move( + params: Params$Resource$Customers$Chromebrowsers$Move, + options: StreamMethodOptions + ): Promise>; + move( + params?: Params$Resource$Customers$Chromebrowsers$Move, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + move( + params: Params$Resource$Customers$Chromebrowsers$Move, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + move( + params: Params$Resource$Customers$Chromebrowsers$Move, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + move( + params: Params$Resource$Customers$Chromebrowsers$Move, + callback: BodyResponseCallback + ): void; + move( + callback: BodyResponseCallback + ): void; + move( + paramsOrCallback?: + | Params$Resource$Customers$Chromebrowsers$Move + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Chromebrowsers$Move; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Chromebrowsers$Move; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/chromeBrowsers:move').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Updates annotation information for a Chrome Browser. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.chromeBrowsers.patch({ + * // Identifier. Format: customers/{customer_id\}/chromeBrowsers/{browser_permanent_id\} + * name: 'customers/my-customer/chromeBrowsers/my-chromeBrowser', + * // Optional. The update mask that can be used to specify which fields to update. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "annotatedAssetId": "my_annotatedAssetId", + * // "annotatedLocation": "my_annotatedLocation", + * // "annotatedNotes": "my_annotatedNotes", + * // "annotatedUser": "my_annotatedUser", + * // "attestationCredential": {}, + * // "browserPermanentId": "my_browserPermanentId", + * // "browserVersions": [], + * // "browsers": [], + * // "deviceIdentifiersHistory": {}, + * // "extensionCount": "my_extensionCount", + * // "lastActivityTime": "my_lastActivityTime", + * // "lastDeviceUser": "my_lastDeviceUser", + * // "lastDeviceUsers": [], + * // "lastPolicyFetchTime": "my_lastPolicyFetchTime", + * // "lastRegistrationTime": "my_lastRegistrationTime", + * // "lastStatusReportTime": "my_lastStatusReportTime", + * // "machineExtensionPolicies": [], + * // "machineName": "my_machineName", + * // "machinePolicies": [], + * // "name": "my_name", + * // "omahaRecentFetchTime": "my_omahaRecentFetchTime", + * // "orgUnitId": "my_orgUnitId", + * // "osArchitecture": "my_osArchitecture", + * // "osPlatform": "my_osPlatform", + * // "osPlatformVersion": "my_osPlatformVersion", + * // "osVersion": "my_osVersion", + * // "policyCount": "my_policyCount", + * // "serialNumber": "my_serialNumber", + * // "virtualDeviceId": "my_virtualDeviceId" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "annotatedAssetId": "my_annotatedAssetId", + * // "annotatedLocation": "my_annotatedLocation", + * // "annotatedNotes": "my_annotatedNotes", + * // "annotatedUser": "my_annotatedUser", + * // "attestationCredential": {}, + * // "browserPermanentId": "my_browserPermanentId", + * // "browserVersions": [], + * // "browsers": [], + * // "deviceIdentifiersHistory": {}, + * // "extensionCount": "my_extensionCount", + * // "lastActivityTime": "my_lastActivityTime", + * // "lastDeviceUser": "my_lastDeviceUser", + * // "lastDeviceUsers": [], + * // "lastPolicyFetchTime": "my_lastPolicyFetchTime", + * // "lastRegistrationTime": "my_lastRegistrationTime", + * // "lastStatusReportTime": "my_lastStatusReportTime", + * // "machineExtensionPolicies": [], + * // "machineName": "my_machineName", + * // "machinePolicies": [], + * // "name": "my_name", + * // "omahaRecentFetchTime": "my_omahaRecentFetchTime", + * // "orgUnitId": "my_orgUnitId", + * // "osArchitecture": "my_osArchitecture", + * // "osPlatform": "my_osPlatform", + * // "osPlatformVersion": "my_osPlatformVersion", + * // "osVersion": "my_osVersion", + * // "policyCount": "my_policyCount", + * // "serialNumber": "my_serialNumber", + * // "virtualDeviceId": "my_virtualDeviceId" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Customers$Chromebrowsers$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Customers$Chromebrowsers$Patch, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + patch( + params: Params$Resource$Customers$Chromebrowsers$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Customers$Chromebrowsers$Patch, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Customers$Chromebrowsers$Patch, + callback: BodyResponseCallback + ): void; + patch( + callback: BodyResponseCallback + ): void; + patch( + paramsOrCallback?: + | Params$Resource$Customers$Chromebrowsers$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Chromebrowsers$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Chromebrowsers$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Customers$Chromebrowsers$Delete extends StandardParameters { + /** + * Required. Format: customers/{customer_id\}/chromeBrowsers/{browser_permanent_id\} + */ + name?: string; + } + export interface Params$Resource$Customers$Chromebrowsers$Get extends StandardParameters { + /** + * Required. Format: customers/{customer_id\}/chromeBrowsers/{browser_permanent_id\} + */ + name?: string; + } + export interface Params$Resource$Customers$Chromebrowsers$List extends StandardParameters { + /** + * Optional. The filter used to filter browsers. The following fields can be used in the filter: * `browser_permanent_id` * `last_policy_fetch_time` * `os_platform` * `os_architecture` * `os_version` * `machine_name` * `annotated_location` * `annotated_user` * `annotated_asset_id` * `annotated_note` * `org_unit_path` * `org_unit_id` * `last_registration_time` * `os_platform_version` * `browser_version` * `last_status_report_time` * `extension_count` * `policy_count` * `last_device_user` * `last_activity_time` * `device_id_collision` The following functions can be used in the filter: * `in_group(string)`: Filters browsers that belong to the specified Cloud Identity group resource name (e.g. `in_group("groups/{group_id\}")`). Any of the above fields or functions can be used to specify a filter, and filtering by multiple fields or functions is supported with AND operator. String type, Integer type fields and enum type fields support `=` and `:` operators. The timestamp type fields support `=`, `<=` and `\>=` operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard `*` is only supported for `machine_name`, `annotated_asset_id`, and `browser_version`. In addition, global string literal filtering without a field name is supported: a single term (e.g., `ABC`) matches if any indexed string field contains `ABC`, and multiple terms joined by `AND` or whitespace (e.g., `machine AND 73` or `machine 73`) match browsers where every term appears in at least one indexed string field (whereas a single quoted phrase like `"machine 73"` matches the contiguous phrase within a single field). + */ + filter?: string; + /** + * Optional. The fields used to specify the ordering of the results. The supported fields are: * `browser_permanent_id` * `last_sync` * `annotated_user` * `annotated_location` * `annotated_asset_id` * `annotated_notes` * `org_unit_path` * `os_version` * `enrollment_date` * `extension_count` * `policy_count` * `last_signed_in_user` * `machine_name` * `browser_version_channel` * `os_platform_version` * `last_activity_time` * `browser_version` By default, sorting is in ascending order, to specify descending order for a field, a suffix ` desc` should be added to the field name. The default ordering is the descending order of `last_status_report_time`. + */ + orderBy?: string; + /** + * Optional. Maximum number of results to return. Maximum and default are 100. + */ + pageSize?: number; + /** + * Optional. Token to specify next page in the list. + */ + pageToken?: string; + /** + * Required. Format: customers/{customer_id\} + */ + parent?: string; + } + export interface Params$Resource$Customers$Chromebrowsers$Move extends StandardParameters { + /** + * Required. Format: customers/{customer_id\} + */ + parent?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleChromeManagementVersionsV1MoveChromeBrowsersRequest; + } + export interface Params$Resource$Customers$Chromebrowsers$Patch extends StandardParameters { + /** + * Identifier. Format: customers/{customer_id\}/chromeBrowsers/{browser_permanent_id\} + */ + name?: string; + /** + * Optional. The update mask that can be used to specify which fields to update. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleChromeManagementVersionsV1ChromeBrowser; + } + + export class Resource$Customers$Connectorconfigs { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates a connector config. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.connectorConfigs.create({ + * // Optional. ID to use for the connector config, which becomes the final component of the connector config's resource name. If provided, the ID must be 1-36 characters long, and contain only lowercase letters, digits, and hyphens. It must start with a letter, and end with a letter or number. If not provided, the connector config will be assigned a random UUID. + * connectorConfigId: 'placeholder-value', + * // Required. Format: customers/{customer\} + * parent: 'customers/my-customer', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "details": {}, + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "status": {}, + * // "type": "my_type" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "details": {}, + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "status": {}, + * // "type": "my_type" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + create( + params: Params$Resource$Customers$Connectorconfigs$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Customers$Connectorconfigs$Create, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + create( + params: Params$Resource$Customers$Connectorconfigs$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Customers$Connectorconfigs$Create, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Customers$Connectorconfigs$Create, + callback: BodyResponseCallback + ): void; + create( + callback: BodyResponseCallback + ): void; + create( + paramsOrCallback?: + | Params$Resource$Customers$Connectorconfigs$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Connectorconfigs$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Connectorconfigs$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/connectorConfigs').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Deletes a connector config. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.connectorConfigs.delete({ + * // Required. Format: customers/{customer\}/connectorConfigs/{connector_config\} + * name: 'customers/my-customer/connectorConfigs/my-connectorConfig', + * }); + * console.log(res.data); + * + * // Example response + * // {} + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + delete( + params: Params$Resource$Customers$Connectorconfigs$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Customers$Connectorconfigs$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Customers$Connectorconfigs$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Customers$Connectorconfigs$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Customers$Connectorconfigs$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Customers$Connectorconfigs$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Connectorconfigs$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Connectorconfigs$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Gets a connector config with customer ID and config ID. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.connectorConfigs.get({ + * // Required. Format: customers/{customer\}/connectorConfigs/{connector_config\} + * name: 'customers/my-customer/connectorConfigs/my-connectorConfig', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "details": {}, + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "status": {}, + * // "type": "my_type" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Customers$Connectorconfigs$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Customers$Connectorconfigs$Get, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + get( + params: Params$Resource$Customers$Connectorconfigs$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Customers$Connectorconfigs$Get, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Customers$Connectorconfigs$Get, + callback: BodyResponseCallback + ): void; + get( + callback: BodyResponseCallback + ): void; + get( + paramsOrCallback?: + | Params$Resource$Customers$Connectorconfigs$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Connectorconfigs$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Connectorconfigs$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Lists connector configs of a customer. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.connectorConfigs.list({ + * // Optional. The maximum number of connector configs to return. The default page size is 50 if page_size is unspecified, and the maximum page size allowed is 100. Values above 100 will be capped at 100. + * pageSize: 'placeholder-value', + * // Optional. A page token, received from a previous `ListConnectorConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListConnectorConfigs` must match the call that provided the page token. + * pageToken: 'placeholder-value', + * // Required. Format: customers/{customer\} + * parent: 'customers/my-customer', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "connectorConfigs": [], + * // "nextPageToken": "my_nextPageToken" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Customers$Connectorconfigs$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Customers$Connectorconfigs$List, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + list( + params: Params$Resource$Customers$Connectorconfigs$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Customers$Connectorconfigs$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Customers$Connectorconfigs$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Customers$Connectorconfigs$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Connectorconfigs$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Connectorconfigs$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/connectorConfigs').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Updates a connector config. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.connectorConfigs.patch({ + * // Identifier. Format: customers/{customer\}/connectorConfigs/{connector_config\} + * name: 'customers/my-customer/connectorConfigs/my-connectorConfig', + * // Optional. The update mask that can be used to specify which fields to update. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "details": {}, + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "status": {}, + * // "type": "my_type" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "details": {}, + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "status": {}, + * // "type": "my_type" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Customers$Connectorconfigs$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Customers$Connectorconfigs$Patch, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + patch( + params: Params$Resource$Customers$Connectorconfigs$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Customers$Connectorconfigs$Patch, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Customers$Connectorconfigs$Patch, + callback: BodyResponseCallback + ): void; + patch( + callback: BodyResponseCallback + ): void; + patch( + paramsOrCallback?: + | Params$Resource$Customers$Connectorconfigs$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Connectorconfigs$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Connectorconfigs$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Customers$Connectorconfigs$Create extends StandardParameters { + /** + * Optional. ID to use for the connector config, which becomes the final component of the connector config's resource name. If provided, the ID must be 1-36 characters long, and contain only lowercase letters, digits, and hyphens. It must start with a letter, and end with a letter or number. If not provided, the connector config will be assigned a random UUID. + */ + connectorConfigId?: string; + /** + * Required. Format: customers/{customer\} + */ + parent?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleChromeManagementVersionsV1ConnectorConfig; + } + export interface Params$Resource$Customers$Connectorconfigs$Delete extends StandardParameters { + /** + * Required. Format: customers/{customer\}/connectorConfigs/{connector_config\} + */ + name?: string; + } + export interface Params$Resource$Customers$Connectorconfigs$Get extends StandardParameters { + /** + * Required. Format: customers/{customer\}/connectorConfigs/{connector_config\} + */ + name?: string; + } + export interface Params$Resource$Customers$Connectorconfigs$List extends StandardParameters { + /** + * Optional. The maximum number of connector configs to return. The default page size is 50 if page_size is unspecified, and the maximum page size allowed is 100. Values above 100 will be capped at 100. + */ + pageSize?: number; + /** + * Optional. A page token, received from a previous `ListConnectorConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListConnectorConfigs` must match the call that provided the page token. + */ + pageToken?: string; + /** + * Required. Format: customers/{customer\} + */ + parent?: string; + } + export interface Params$Resource$Customers$Connectorconfigs$Patch extends StandardParameters { + /** + * Identifier. Format: customers/{customer\}/connectorConfigs/{connector_config\} + */ + name?: string; + /** + * Optional. The update mask that can be used to specify which fields to update. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleChromeManagementVersionsV1ConnectorConfig; + } + + export class Resource$Customers$Enrollmenttokens { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates a new enrollment token for a browser device. Creation fails if there is already an active token for this customer under the same org unit. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.enrollmentTokens.create({ + * // Optional. The ID to use for the enrollment token, which will become the final component of the enrollment token's resource name. This value must be local-unique under the customer and is optional. If not provided, it will be auto-generated. If provided, it must be 1-63 characters long and match the regular expression `[a-zA-Z0-9._-]+`. + * enrollmentTokenId: 'placeholder-value', + * // Required. The parent resource where this enrollment token will be created. Format: customers/{customer\} + * parent: 'customers/my-customer', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "createTime": "my_createTime", + * // "creatorId": "my_creatorId", + * // "customerId": "my_customerId", + * // "name": "my_name", + * // "orgUnitId": "my_orgUnitId", + * // "revokeTime": "my_revokeTime", + * // "revokerId": "my_revokerId", + * // "state": "my_state", + * // "token": "my_token", + * // "tokenPermanentId": "my_tokenPermanentId", + * // "tokenType": "my_tokenType" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "createTime": "my_createTime", + * // "creatorId": "my_creatorId", + * // "customerId": "my_customerId", + * // "name": "my_name", + * // "orgUnitId": "my_orgUnitId", + * // "revokeTime": "my_revokeTime", + * // "revokerId": "my_revokerId", + * // "state": "my_state", + * // "token": "my_token", + * // "tokenPermanentId": "my_tokenPermanentId", + * // "tokenType": "my_tokenType" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + create( + params: Params$Resource$Customers$Enrollmenttokens$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Customers$Enrollmenttokens$Create, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + create( + params: Params$Resource$Customers$Enrollmenttokens$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Customers$Enrollmenttokens$Create, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Customers$Enrollmenttokens$Create, + callback: BodyResponseCallback + ): void; + create( + callback: BodyResponseCallback + ): void; + create( + paramsOrCallback?: + | Params$Resource$Customers$Enrollmenttokens$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Enrollmenttokens$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Customers$Enrollmenttokens$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/enrollmentTokens').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Gets a browser device enrollment token. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const chromemanagement = google.chromemanagement('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await chromemanagement.customers.enrollmentTokens.get({ + * // Required. The name of the enrollment token to retrieve. Format: customers/{customer\}/enrollmentTokens/{token_permanent_id\} + * name: 'customers/my-customer/enrollmentTokens/my-enrollmentToken', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "createTime": "my_createTime", + * // "creatorId": "my_creatorId", + * // "customerId": "my_customerId", + * // "name": "my_name", + * // "orgUnitId": "my_orgUnitId", + * // "revokeTime": "my_revokeTime", + * // "revokerId": "my_revokerId", + * // "state": "my_state", + * // "token": "my_token", + * // "tokenPermanentId": "my_tokenPermanentId", + * // "tokenType": "my_tokenType" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Customers$Enrollmenttokens$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Customers$Enrollmenttokens$Get, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + get( + params: Params$Resource$Customers$Enrollmenttokens$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Customers$Enrollmenttokens$Get, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Customers$Enrollmenttokens$Get, + callback: BodyResponseCallback + ): void; + get( + callback: BodyResponseCallback ): void; get( paramsOrCallback?: - | Params$Resource$Customers$Connectorconfigs$Get - | BodyResponseCallback + | Params$Resource$Customers$Enrollmenttokens$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void | Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 > | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Customers$Connectorconfigs$Get; + {}) as Params$Resource$Customers$Enrollmenttokens$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Customers$Connectorconfigs$Get; + params = {} as Params$Resource$Customers$Enrollmenttokens$Get; options = {}; } @@ -6419,19 +8523,19 @@ export namespace chromemanagement_v1 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } /** - * Lists connector configs of a customer. + * Lists all browser device enrollment tokens. * @example * ```js * // Before running the sample: @@ -6460,19 +8564,21 @@ export namespace chromemanagement_v1 { * google.options({auth: authClient}); * * // Do the magic - * const res = await chromemanagement.customers.connectorConfigs.list({ - * // Optional. The maximum number of connector configs to return. The default page size is 50 if page_size is unspecified, and the maximum page size allowed is 100. Values above 100 will be capped at 100. + * const res = await chromemanagement.customers.enrollmentTokens.list({ + * // Optional. Filter to apply to list results. The following fields can be used in the filter: * device_type (currently only 'CHROME_BROWSER' is supported) * token_state (supported values: 'ACTIVE', 'EXPIRED', 'REVOKED') * org_unit_path The full path of the org unit, such as /Montreal/Sales. * org_unit_id The obfuscated id of the org unit, not the full path. + * filter: 'placeholder-value', + * // Optional. Maximum number of results to return. Maximum and default are 100. * pageSize: 'placeholder-value', - * // Optional. A page token, received from a previous `ListConnectorConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListConnectorConfigs` must match the call that provided the page token. + * // Optional. Token to specify next page in the list. * pageToken: 'placeholder-value', - * // Required. Format: customers/{customer\} + * // Required. The parent resource where this enrollment token will be created. Format: customers/{customer\} * parent: 'customers/my-customer', * }); * console.log(res.data); * * // Example response * // { - * // "connectorConfigs": [], + * // "enrollmentTokens": [], * // "nextPageToken": "my_nextPageToken" * // } * } @@ -6490,60 +8596,60 @@ export namespace chromemanagement_v1 { * @returns A promise if used with async/await, or void if used with a callback. */ list( - params: Params$Resource$Customers$Connectorconfigs$List, + params: Params$Resource$Customers$Enrollmenttokens$List, options: StreamMethodOptions ): Promise>; list( - params?: Params$Resource$Customers$Connectorconfigs$List, + params?: Params$Resource$Customers$Enrollmenttokens$List, options?: MethodOptions ): Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 >; list( - params: Params$Resource$Customers$Connectorconfigs$List, + params: Params$Resource$Customers$Enrollmenttokens$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; list( - params: Params$Resource$Customers$Connectorconfigs$List, + params: Params$Resource$Customers$Enrollmenttokens$List, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; list( - params: Params$Resource$Customers$Connectorconfigs$List, - callback: BodyResponseCallback + params: Params$Resource$Customers$Enrollmenttokens$List, + callback: BodyResponseCallback ): void; list( - callback: BodyResponseCallback + callback: BodyResponseCallback ): void; list( paramsOrCallback?: - | Params$Resource$Customers$Connectorconfigs$List - | BodyResponseCallback + | Params$Resource$Customers$Enrollmenttokens$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void | Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 > | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Customers$Connectorconfigs$List; + {}) as Params$Resource$Customers$Enrollmenttokens$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Customers$Connectorconfigs$List; + params = {} as Params$Resource$Customers$Enrollmenttokens$List; options = {}; } @@ -6557,7 +8663,7 @@ export namespace chromemanagement_v1 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1/{+parent}/connectorConfigs').replace( + url: (rootUrl + '/v1/{+parent}/enrollmentTokens').replace( /([^:]\/)\/+/g, '$1' ), @@ -6572,19 +8678,19 @@ export namespace chromemanagement_v1 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } /** - * Updates a connector config. + * Revokes a browser device enrollment token. * @example * ```js * // Before running the sample: @@ -6613,33 +8719,31 @@ export namespace chromemanagement_v1 { * google.options({auth: authClient}); * * // Do the magic - * const res = await chromemanagement.customers.connectorConfigs.patch({ - * // Identifier. Format: customers/{customer\}/connectorConfigs/{connector_config\} - * name: 'customers/my-customer/connectorConfigs/my-connectorConfig', - * // Optional. The update mask that can be used to specify which fields to update. - * updateMask: 'placeholder-value', + * const res = await chromemanagement.customers.enrollmentTokens.revoke({ + * // Required. The name of the enrollment token to revoke. Format: customers/{customer\}/enrollmentTokens/{token_permanent_id\} + * name: 'customers/my-customer/enrollmentTokens/my-enrollmentToken', * * // Request body metadata * requestBody: { * // request body parameters - * // { - * // "details": {}, - * // "displayName": "my_displayName", - * // "name": "my_name", - * // "status": {}, - * // "type": "my_type" - * // } + * // {} * }, * }); * console.log(res.data); * * // Example response * // { - * // "details": {}, - * // "displayName": "my_displayName", + * // "createTime": "my_createTime", + * // "creatorId": "my_creatorId", + * // "customerId": "my_customerId", * // "name": "my_name", - * // "status": {}, - * // "type": "my_type" + * // "orgUnitId": "my_orgUnitId", + * // "revokeTime": "my_revokeTime", + * // "revokerId": "my_revokerId", + * // "state": "my_state", + * // "token": "my_token", + * // "tokenPermanentId": "my_tokenPermanentId", + * // "tokenType": "my_tokenType" * // } * } * @@ -6655,61 +8759,61 @@ export namespace chromemanagement_v1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - patch( - params: Params$Resource$Customers$Connectorconfigs$Patch, + revoke( + params: Params$Resource$Customers$Enrollmenttokens$Revoke, options: StreamMethodOptions ): Promise>; - patch( - params?: Params$Resource$Customers$Connectorconfigs$Patch, + revoke( + params?: Params$Resource$Customers$Enrollmenttokens$Revoke, options?: MethodOptions ): Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 >; - patch( - params: Params$Resource$Customers$Connectorconfigs$Patch, + revoke( + params: Params$Resource$Customers$Enrollmenttokens$Revoke, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - patch( - params: Params$Resource$Customers$Connectorconfigs$Patch, + revoke( + params: Params$Resource$Customers$Enrollmenttokens$Revoke, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - patch( - params: Params$Resource$Customers$Connectorconfigs$Patch, - callback: BodyResponseCallback + revoke( + params: Params$Resource$Customers$Enrollmenttokens$Revoke, + callback: BodyResponseCallback ): void; - patch( - callback: BodyResponseCallback + revoke( + callback: BodyResponseCallback ): void; - patch( + revoke( paramsOrCallback?: - | Params$Resource$Customers$Connectorconfigs$Patch - | BodyResponseCallback + | Params$Resource$Customers$Enrollmenttokens$Revoke + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void | Promise< - GaxiosResponseWithHTTP2 + GaxiosResponseWithHTTP2 > | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Customers$Connectorconfigs$Patch; + {}) as Params$Resource$Customers$Enrollmenttokens$Revoke; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Customers$Connectorconfigs$Patch; + params = {} as Params$Resource$Customers$Enrollmenttokens$Revoke; options = {}; } @@ -6723,8 +8827,8 @@ export namespace chromemanagement_v1 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1/{+name}').replace(/([^:]\/)\/+/g, '$1'), - method: 'PATCH', + url: (rootUrl + '/v1/{+name}:revoke').replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', apiVersion: '', }, options @@ -6735,73 +8839,67 @@ export namespace chromemanagement_v1 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } } - export interface Params$Resource$Customers$Connectorconfigs$Create extends StandardParameters { + export interface Params$Resource$Customers$Enrollmenttokens$Create extends StandardParameters { /** - * Optional. ID to use for the connector config, which becomes the final component of the connector config's resource name. If provided, the ID must be 1-36 characters long, and contain only lowercase letters, digits, and hyphens. It must start with a letter, and end with a letter or number. If not provided, the connector config will be assigned a random UUID. + * Optional. The ID to use for the enrollment token, which will become the final component of the enrollment token's resource name. This value must be local-unique under the customer and is optional. If not provided, it will be auto-generated. If provided, it must be 1-63 characters long and match the regular expression `[a-zA-Z0-9._-]+`. */ - connectorConfigId?: string; + enrollmentTokenId?: string; /** - * Required. Format: customers/{customer\} + * Required. The parent resource where this enrollment token will be created. Format: customers/{customer\} */ parent?: string; /** * Request body metadata */ - requestBody?: Schema$GoogleChromeManagementVersionsV1ConnectorConfig; + requestBody?: Schema$GoogleChromeManagementVersionsV1EnrollmentToken; } - export interface Params$Resource$Customers$Connectorconfigs$Delete extends StandardParameters { + export interface Params$Resource$Customers$Enrollmenttokens$Get extends StandardParameters { /** - * Required. Format: customers/{customer\}/connectorConfigs/{connector_config\} + * Required. The name of the enrollment token to retrieve. Format: customers/{customer\}/enrollmentTokens/{token_permanent_id\} */ name?: string; } - export interface Params$Resource$Customers$Connectorconfigs$Get extends StandardParameters { + export interface Params$Resource$Customers$Enrollmenttokens$List extends StandardParameters { /** - * Required. Format: customers/{customer\}/connectorConfigs/{connector_config\} + * Optional. Filter to apply to list results. The following fields can be used in the filter: * device_type (currently only 'CHROME_BROWSER' is supported) * token_state (supported values: 'ACTIVE', 'EXPIRED', 'REVOKED') * org_unit_path The full path of the org unit, such as /Montreal/Sales. * org_unit_id The obfuscated id of the org unit, not the full path. */ - name?: string; - } - export interface Params$Resource$Customers$Connectorconfigs$List extends StandardParameters { + filter?: string; /** - * Optional. The maximum number of connector configs to return. The default page size is 50 if page_size is unspecified, and the maximum page size allowed is 100. Values above 100 will be capped at 100. + * Optional. Maximum number of results to return. Maximum and default are 100. */ pageSize?: number; /** - * Optional. A page token, received from a previous `ListConnectorConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListConnectorConfigs` must match the call that provided the page token. + * Optional. Token to specify next page in the list. */ pageToken?: string; /** - * Required. Format: customers/{customer\} + * Required. The parent resource where this enrollment token will be created. Format: customers/{customer\} */ parent?: string; } - export interface Params$Resource$Customers$Connectorconfigs$Patch extends StandardParameters { + export interface Params$Resource$Customers$Enrollmenttokens$Revoke extends StandardParameters { /** - * Identifier. Format: customers/{customer\}/connectorConfigs/{connector_config\} + * Required. The name of the enrollment token to revoke. Format: customers/{customer\}/enrollmentTokens/{token_permanent_id\} */ name?: string; - /** - * Optional. The update mask that can be used to specify which fields to update. - */ - updateMask?: string; /** * Request body metadata */ - requestBody?: Schema$GoogleChromeManagementVersionsV1ConnectorConfig; + requestBody?: Schema$GoogleChromeManagementVersionsV1RevokeEnrollmentTokenRequest; } export class Resource$Customers$Enterprise { diff --git a/src/apis/compute/alpha.ts b/src/apis/compute/alpha.ts index d196554c1c..dc048cbe43 100644 --- a/src/apis/compute/alpha.ts +++ b/src/apis/compute/alpha.ts @@ -186,7 +186,6 @@ export namespace compute_alpha { organizationSecurityPolicies: Resource$Organizationsecuritypolicies; organizationSnapshotRecycleBinPolicy: Resource$Organizationsnapshotrecyclebinpolicy; organizationZoneVmExtensionPolicies: Resource$Organizationzonevmextensionpolicies; - orgVmExtensionPolicies: Resource$Orgvmextensionpolicies; packetMirrorings: Resource$Packetmirrorings; previewFeatures: Resource$Previewfeatures; projects: Resource$Projects; @@ -388,9 +387,6 @@ export namespace compute_alpha { new Resource$Organizationsnapshotrecyclebinpolicy(this.context); this.organizationZoneVmExtensionPolicies = new Resource$Organizationzonevmextensionpolicies(this.context); - this.orgVmExtensionPolicies = new Resource$Orgvmextensionpolicies( - this.context - ); this.packetMirrorings = new Resource$Packetmirrorings(this.context); this.previewFeatures = new Resource$Previewfeatures(this.context); this.projects = new Resource$Projects(this.context); @@ -183578,6 +183574,193 @@ export namespace compute_alpha { this.context = context; } + /** + * Deletes a specified zone VM extension policy within an organization. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/compute.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const compute = google.compute('alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/compute', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await compute.organizationZoneVmExtensionPolicies.delete({ + * // Organization ID for this request. + * organization: 'organizations/[0-9]{0,20}', + * // 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). + * requestId: 'placeholder-value', + * // Name of the zone VM extension policy to delete. + * vmExtensionPolicy: 'placeholder-value', + * // Name of the zone for this request. + * zone: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "clientOperationId": "my_clientOperationId", + * // "creationTimestamp": "my_creationTimestamp", + * // "description": "my_description", + * // "endTime": "my_endTime", + * // "error": {}, + * // "firewallPolicyRuleOperationMetadata": {}, + * // "getHealthOperationMetadata": {}, + * // "getVersionOperationMetadata": {}, + * // "httpErrorMessage": "my_httpErrorMessage", + * // "httpErrorStatusCode": 0, + * // "id": "my_id", + * // "insertTime": "my_insertTime", + * // "instancesBulkInsertOperationMetadata": {}, + * // "kind": "my_kind", + * // "name": "my_name", + * // "operationGroupId": "my_operationGroupId", + * // "operationType": "my_operationType", + * // "progress": 0, + * // "region": "my_region", + * // "selfLink": "my_selfLink", + * // "selfLinkWithId": "my_selfLinkWithId", + * // "setCommonInstanceMetadataOperationMetadata": {}, + * // "startTime": "my_startTime", + * // "status": "my_status", + * // "statusMessage": "my_statusMessage", + * // "targetId": "my_targetId", + * // "targetLink": "my_targetLink", + * // "user": "my_user", + * // "warnings": [], + * // "zone": "my_zone" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + delete( + params: Params$Resource$Organizationzonevmextensionpolicies$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Organizationzonevmextensionpolicies$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Organizationzonevmextensionpolicies$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Organizationzonevmextensionpolicies$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Organizationzonevmextensionpolicies$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Organizationzonevmextensionpolicies$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Organizationzonevmextensionpolicies$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Organizationzonevmextensionpolicies$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/alpha/{+organization}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['organization', 'zone', 'vmExtensionPolicy'], + pathParams: ['organization', 'vmExtensionPolicy', 'zone'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Retrieves details of a specific zone VM extension policy within an * organization. @@ -184782,6 +184965,36 @@ export namespace compute_alpha { } } + export interface Params$Resource$Organizationzonevmextensionpolicies$Delete extends StandardParameters { + /** + * Organization ID for this request. + */ + organization?: string; + /** + * 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). + */ + requestId?: string; + /** + * Name of the zone VM extension policy to delete. + */ + vmExtensionPolicy?: string; + /** + * Name of the zone for this request. + */ + zone?: string; + } export interface Params$Resource$Organizationzonevmextensionpolicies$Get extends StandardParameters { /** * Organization ID for this request. @@ -185093,230 +185306,6 @@ export namespace compute_alpha { requestBody?: Schema$VmExtensionPolicy; } - export class Resource$Orgvmextensionpolicies { - context: APIRequestContext; - constructor(context: APIRequestContext) { - this.context = context; - } - - /** - * Deletes a specified zone VM extension policy within an organization. - * @example - * ```js - * // Before running the sample: - * // - Enable the API at: - * // https://console.developers.google.com/apis/api/compute.googleapis.com - * // - Login into gcloud by running: - * // ```sh - * // $ gcloud auth application-default login - * // ``` - * // - Install the npm module by running: - * // ```sh - * // $ npm install googleapis - * // ``` - * - * const {google} = require('googleapis'); - * const compute = google.compute('alpha'); - * - * async function main() { - * const auth = new google.auth.GoogleAuth({ - * // Scopes can be specified either as an array or as a single, space-delimited string. - * scopes: [ - * 'https://www.googleapis.com/auth/cloud-platform', - * 'https://www.googleapis.com/auth/compute', - * ], - * }); - * - * // Acquire an auth client, and bind it to all future calls - * const authClient = await auth.getClient(); - * google.options({auth: authClient}); - * - * // Do the magic - * const res = await compute.orgVmExtensionPolicies.delete({ - * // Organization ID for this request. - * organization: 'organizations/[0-9]{0,20}', - * // 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). - * requestId: 'placeholder-value', - * // Name of the zone VM extension policy to delete. - * vmExtensionPolicy: 'placeholder-value', - * // Name of the zone for this request. - * zone: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?', - * }); - * console.log(res.data); - * - * // Example response - * // { - * // "clientOperationId": "my_clientOperationId", - * // "creationTimestamp": "my_creationTimestamp", - * // "description": "my_description", - * // "endTime": "my_endTime", - * // "error": {}, - * // "firewallPolicyRuleOperationMetadata": {}, - * // "getHealthOperationMetadata": {}, - * // "getVersionOperationMetadata": {}, - * // "httpErrorMessage": "my_httpErrorMessage", - * // "httpErrorStatusCode": 0, - * // "id": "my_id", - * // "insertTime": "my_insertTime", - * // "instancesBulkInsertOperationMetadata": {}, - * // "kind": "my_kind", - * // "name": "my_name", - * // "operationGroupId": "my_operationGroupId", - * // "operationType": "my_operationType", - * // "progress": 0, - * // "region": "my_region", - * // "selfLink": "my_selfLink", - * // "selfLinkWithId": "my_selfLinkWithId", - * // "setCommonInstanceMetadataOperationMetadata": {}, - * // "startTime": "my_startTime", - * // "status": "my_status", - * // "statusMessage": "my_statusMessage", - * // "targetId": "my_targetId", - * // "targetLink": "my_targetLink", - * // "user": "my_user", - * // "warnings": [], - * // "zone": "my_zone" - * // } - * } - * - * main().catch(e => { - * console.error(e); - * throw e; - * }); - * - * ``` - * - * @param params - Parameters for request - * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. - * @param callback - Optional callback that handles the response. - * @returns A promise if used with async/await, or void if used with a callback. - */ - delete( - params: Params$Resource$Orgvmextensionpolicies$Delete, - options: StreamMethodOptions - ): Promise>; - delete( - params?: Params$Resource$Orgvmextensionpolicies$Delete, - options?: MethodOptions - ): Promise>; - delete( - params: Params$Resource$Orgvmextensionpolicies$Delete, - options: StreamMethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - delete( - params: Params$Resource$Orgvmextensionpolicies$Delete, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - delete( - params: Params$Resource$Orgvmextensionpolicies$Delete, - callback: BodyResponseCallback - ): void; - delete(callback: BodyResponseCallback): void; - delete( - paramsOrCallback?: - | Params$Resource$Orgvmextensionpolicies$Delete - | BodyResponseCallback - | BodyResponseCallback, - optionsOrCallback?: - | MethodOptions - | StreamMethodOptions - | BodyResponseCallback - | BodyResponseCallback, - callback?: - BodyResponseCallback | BodyResponseCallback - ): - | void - | Promise> - | Promise> { - let params = (paramsOrCallback || - {}) as Params$Resource$Orgvmextensionpolicies$Delete; - let options = (optionsOrCallback || {}) as MethodOptions; - - if (typeof paramsOrCallback === 'function') { - callback = paramsOrCallback; - params = {} as Params$Resource$Orgvmextensionpolicies$Delete; - options = {}; - } - - if (typeof optionsOrCallback === 'function') { - callback = optionsOrCallback; - options = {}; - } - - const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; - const parameters = { - options: Object.assign( - { - url: ( - rootUrl + - '/compute/alpha/{+organization}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy}' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'DELETE', - apiVersion: '', - }, - options - ), - params, - requiredParams: ['organization', 'zone', 'vmExtensionPolicy'], - pathParams: ['organization', 'vmExtensionPolicy', 'zone'], - context: this.context, - }; - if (callback) { - createAPIRequest( - parameters, - callback as BodyResponseCallback - ); - } else { - return createAPIRequest(parameters); - } - } - } - - export interface Params$Resource$Orgvmextensionpolicies$Delete extends StandardParameters { - /** - * Organization ID for this request. - */ - organization?: string; - /** - * 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). - */ - requestId?: string; - /** - * Name of the zone VM extension policy to delete. - */ - vmExtensionPolicy?: string; - /** - * Name of the zone for this request. - */ - zone?: string; - } - export class Resource$Packetmirrorings { context: APIRequestContext; constructor(context: APIRequestContext) { diff --git a/src/apis/compute/preview.ts b/src/apis/compute/preview.ts index 81fa4bbb5e..48528db196 100644 --- a/src/apis/compute/preview.ts +++ b/src/apis/compute/preview.ts @@ -121,6 +121,7 @@ export namespace compute_preview { acceleratorTypes: Resource$Acceleratortypes; addresses: Resource$Addresses; advice: Resource$Advice; + aliasNetworkEndpoints: Resource$Aliasnetworkendpoints; autoscalers: Resource$Autoscalers; backendBuckets: Resource$Backendbuckets; backendServices: Resource$Backendservices; @@ -265,6 +266,9 @@ export namespace compute_preview { this.acceleratorTypes = new Resource$Acceleratortypes(this.context); this.addresses = new Resource$Addresses(this.context); this.advice = new Resource$Advice(this.context); + this.aliasNetworkEndpoints = new Resource$Aliasnetworkendpoints( + this.context + ); this.autoscalers = new Resource$Autoscalers(this.context); this.backendBuckets = new Resource$Backendbuckets(this.context); this.backendServices = new Resource$Backendservices(this.context); @@ -851,6 +855,24 @@ export namespace compute_preview { * external IPv6 range. */ externalIpv6PrefixLength?: number | null; + /** + * Reference to the source of external IPv4 addresses, + * like a PublicDelegatedPrefix (PDP) for BYOIP. + * The PDP must support enhanced IPv4 allocations. + * + * Use one of the following formats to specify a PDP when allocating an + * external IPv4 address using BYOIP. + * + * - + * Full resource URL, as inhttps://www.googleapis.com/compute/v1/projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name + * - + * Partial URL, as in + * + * + * - projects/projectId/regions/region/publicDelegatedPrefixes/pdp-name + * - regions/region/publicDelegatedPrefixes/pdp-name + */ + ipCollection?: string | null; /** * Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs. */ @@ -1026,6 +1048,12 @@ export namespace compute_preview { * only be used with INTERNAL type with theVPC_PEERING purpose. */ network?: string | null; + /** + * Optional. The URL of the network attachment that this address comes from in the + * following format: + * projects/{project\}/regions/{region_name\}/networkAttachments/{network_attachment_name\}. + */ + networkAttachment?: string | null; /** * This signifies the networking tier used for configuring this address and * can only take the following values: PREMIUM orSTANDARD. Internal IP addresses are always Premium Tier; @@ -1084,6 +1112,12 @@ export namespace compute_preview { * [Output Only] Server-defined URL for the resource. */ selfLink?: string | null; + /** + * Optional. Producer Service's Service class ID for the region of this address. Can + * only be used with network_attachment. It is not possible to use on its own; + * however, network_attachment can be used without service_class_id. + */ + serviceClassId?: string | null; /** * Output only. [Output Only] The status of the address, which can be one ofRESERVING, RESERVED, or IN_USE. * An address that is RESERVING is currently in the process of @@ -1257,6 +1291,169 @@ export namespace compute_preview { */ subnetworkRangeName?: string | null; } + /** + * Represents an Alias Network Endpoint resource. + * To be used for GKE pod-native endpoints in Andromeda. + */ + export interface Schema$AliasNetworkEndpoint { + /** + * Required. The map of network aliases allocated for the AliasNetworkEndpoint. + * This map is keyed with user-provided alias names. + */ + aliases?: {[key: string]: Schema$AliasNetworkEndpointAlias} | null; + /** + * Optional. The annotations map for the AliasNetworkEndpoint. + * Keys and values must follow Kubernetes limits. + * Keys must be a maximum of 253 characters. Keys should be dot-namespaced, + * following the Kubernetes annotation key format: + * `([DNS subdomain]/)?[RFC 1123 name]`. + * Values must be a maximum of 256 characters. + */ + annotations?: {[key: string]: string} | null; + /** + * Output only. [Output Only] Creation timestamp in RFC3339 text format. + */ + creationTimestamp?: string | null; + /** + * Optional. An optional description of this resource. Provide this field when you + * create the resource. + */ + description?: string | null; + /** + * Required. The host that the alias network endpoint is bound to. + */ + host?: Schema$AliasNetworkEndpointHost; + /** + * Output only. [Output Only] The unique identifier for the resource. This identifier is + * defined by the server. + */ + id?: string | null; + /** + * Optional. The labels map for the AliasNetworkEndpoint. + */ + labels?: {[key: string]: string} | null; + /** + * Identifier. Name of the resource. Provided by the client when the resource is created. + * The name must be 1-63 characters long, and comply with RFC1035. + */ + name?: string | null; + /** + * Optional. The security tag inheritance setting for the AliasNetworkEndpoint. + */ + securityTagInheritance?: string | null; + /** + * Output only. [Output Only] Server-defined URL for the resource. + */ + selfLink?: string | null; + /** + * Output only. [Output Only] Current status of the alias network endpoint. + */ + status?: Schema$AliasNetworkEndpointStatus; + /** + * Required. The URL of the subnetwork that this alias network endpoint belongs to. + */ + subnetwork?: string | null; + /** + * Output only. [Output Only] Update timestamp in RFC3339 text format. + */ + updateTime?: string | null; + } + /** + * Configuration for an IP alias. + */ + export interface Schema$AliasNetworkEndpointAlias { + /** + * Output only. [Output Only] The actual IP address allocated by the system. + */ + effectiveIpAddress?: string | null; + /** + * Output only. [Output Only] The actual secondary range used for allocation. + */ + effectiveSubnetworkRangeName?: string | null; + /** + * Input only. The IP address of the network endpoint. If specified, the server performs + * a validation check for uniqueness. If the field is omitted, the system + * automatically allocates an IP and populates the effective_ip_address + * field. + */ + ipAddress?: string | null; + /** + * Required. The IP version of the IP. It is IPv4 or IPv6. + */ + ipVersion?: string | null; + /** + * Input only. Defines candidate secondary ranges for allocating the alias IPs. If it is + * empty, the IP would be allocated from the primary range of the + * subnetwork. + * This field is INPUT_ONLY and used only during resource creation, + * hence a repeated field is acceptable as per AIP-2825. It is not mutable. + */ + subnetworkRangeNames?: string[] | null; + } + /** + * Information about the host instance. + */ + export interface Schema$AliasNetworkEndpointHost { + /** + * Required. The URL to the instance that this alias network endpoint is bound to. + */ + instance?: string | null; + } + /** + * Response message for AliasNetworkEndpoints.List. + */ + export interface Schema$AliasNetworkEndpointList { + /** + * ETag of the resource list. + */ + etag?: string | null; + /** + * [Output Only] Unique identifier for the resource; defined by the server. + */ + id?: string | null; + /** + * A list of AliasNetworkEndpoint resources. + */ + items?: Schema$AliasNetworkEndpoint[]; + /** + * [Output Only] This token allows you to get the next page of results for + * list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for + * the query parameter pageToken in the next list request. + * Subsequent list requests will have their own nextPageToken to + * continue paging through the results. + */ + nextPageToken?: string | null; + /** + * [Output Only] Server-defined URL for this resource. + */ + selfLink?: string | null; + /** + * Output only. [Output Only] Unreachable resources. + */ + unreachables?: string[] | null; + /** + * [Output Only] Informational warning message. + */ + warning?: { + code?: string; + data?: Array<{key?: string; value?: string}>; + message?: string; + } | null; + } + /** + * Represents the current status of the AliasNetworkEndpoint. + */ + export interface Schema$AliasNetworkEndpointStatus { + /** + * Output only. [Output Only] The URL of the network that this alias network endpoint + * belongs to. + */ + network?: string | null; + /** + * Output only. [Output Only] The state of the alias network endpoint. + */ + state?: string | null; + } /** * This reservation type is specified by total resource amounts (e.g. total * count of CPUs) and can account for multiple instance SKUs. In other words, @@ -10793,6 +10990,12 @@ export namespace compute_preview { * rules will be automatically created with default parameters. */ networkingAutoConfiguration?: Schema$HaControllerNetworkingAutoConfiguration; + /** + * Input only. Additional parameters passed with the request, but not persisted as part + * of the resource. Both `params: null` and `params: {\}` are treated + * identically as a no-op. + */ + params?: Schema$HaControllerParams; /** * Output only. [Output Only] URL of the region where the resource resides. * You must specify this field as part of the HTTP request URL. @@ -10824,6 +11027,23 @@ export namespace compute_preview { [key: string]: Schema$HaControllerZoneConfiguration; } | null; } + /** + * The network interface configuration of the VM instance. + */ + export interface Schema$HaControllerInstanceNetworkInterface { + /** + * Optional. Optional IPv6 address to assign to the instance's network interface. + * If omitted, an ephemeral IP may be assigned depending on the instance's + * network interface stack type. + */ + ipv6Address?: string | null; + /** + * Optional. Optional IPv4 address to assign to the instance's network interface. + * If omitted, an ephemeral IP may be assigned depending on the instance's + * network interface stack type. + */ + networkIP?: string | null; + } /** * Basic networking configuration. Required backend services and forwarding * rules will be automatically created with default parameters. @@ -10850,6 +11070,16 @@ export namespace compute_preview { */ stackType?: string | null; } + /** + * Additional HA Controller params. + */ + export interface Schema$HaControllerParams { + /** + * Specifies whether to automatically migrate all disks of an instance from + * zonal to regional before attempting to create the HaController. + */ + migrateDisksToRegional?: boolean | null; + } export interface Schema$HaControllersAggregatedList { etag?: string | null; /** @@ -11088,6 +11318,31 @@ export namespace compute_preview { * instance. */ export interface Schema$HaControllerZoneConfiguration { + /** + * Optional. The network interface configuration of a VM instance in this zone, + * keyed by the name of the network interface. A VM network interface + * uses the nicN naming format, where N is a + * value between 0 and 7. The default interface + * is nic0. Use this field to choose the internal IP + * addresses of the VM instance in this zone instead of letting Compute + * Engine assign them automatically. + * + * + * - Each key must be a name of a network interface that exists on + * the VM instance. Otherwise, the request fails. + * - Network interfaces that are omitted are assigned an ephemeral + * internal IP address. + * - Every zone must configure the same network interfaces and the + * same IP address families. + * - For the zone that currently holds the VM instance, this field + * is populated automatically, and any addresses you specify must + * match the instance's current addresses. + * - Only internal IP addresses are supported, and this field can + * only be set when the HA Controller is created. + */ + instanceNetworkInterfaces?: { + [key: string]: Schema$HaControllerInstanceNetworkInterface; + } | null; /** * A set of node affinity configurations. Refer toConfiguring node * affinity for more information. @@ -21205,6 +21460,11 @@ export namespace compute_preview { * For all other network endpoint types, this field is required. */ network?: string | null; + /** + * Optional. The URL of the network attachment that this resource + * belongs to.projects/{project\}/regions/{region_name\}/networkAttachments/{network_attachment_name\}. + */ + networkAttachment?: string | null; /** * Type of network endpoints in this network endpoint group. Can be one ofGCE_VM_IP, GCE_VM_IP_PORT,NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT,INTERNET_IP_PORT, SERVERLESS,PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. */ @@ -21230,6 +21490,13 @@ export namespace compute_preview { * Output only. [Output Only] Server-defined URL for the resource. */ selfLink?: string | null; + /** + * Optional. The service class ID associated with this resource. + * Can only be used with network_attachment. It is not possible to + * use on its own; however, network_attachment can be used without + * service_class_id. + */ + serviceClassId?: string | null; /** * Output only. [Output only] Number of network endpoints in the network endpoint group. */ @@ -27750,6 +28017,12 @@ export namespace compute_preview { * process, in RFC3339 text format. */ gracefulShutdownTimestamp?: string | null; + /** + * Output only. Protection tier for the workload which specifies the workload + * expectations in the event of infrastructure failures at data center + * (e.g. power and/or cooling failures). + */ + protectionTier?: string | null; /** * Time in future when the instance will be terminated inRFC3339 text format. */ @@ -30102,6 +30375,12 @@ export namespace compute_preview { * there will be no wait before the G2 Soft Off signal is triggered. */ preemptionNoticeDuration?: Schema$Duration; + /** + * Protection tier for the workload which specifies the workload + * expectations in the event of infrastructure failures at data center + * (e.g. power and/or cooling failures). + */ + protectionTier?: string | null; /** * Specifies the provisioning model of the instance. */ @@ -40860,11 +41139,13 @@ export namespace compute_preview { * // "labels": {}, * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkTier": "my_networkTier", * // "prefixLength": 0, * // "purpose": "my_purpose", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "status": "my_status", * // "subnetwork": "my_subnetwork", * // "users": [] @@ -41036,11 +41317,13 @@ export namespace compute_preview { * // "labels": {}, * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkTier": "my_networkTier", * // "prefixLength": 0, * // "purpose": "my_purpose", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "status": "my_status", * // "subnetwork": "my_subnetwork", * // "users": [] @@ -42682,31 +42965,849 @@ export namespace compute_preview { * google.options({auth: authClient}); * * // Do the magic - * const res = await compute.advice.capacityHistory({ - * // Project ID for this request. + * const res = await compute.advice.capacityHistory({ + * // Project ID for this request. + * project: + * '(?:(?:[-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])?))', + * // Name of the region for this request. + * region: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "instanceProperties": {}, + * // "locationPolicy": {}, + * // "types": [] + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "location": "my_location", + * // "machineType": "my_machineType", + * // "preemptionHistory": [], + * // "priceHistory": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + capacityHistory( + params: Params$Resource$Advice$Capacityhistory, + options: StreamMethodOptions + ): Promise>; + capacityHistory( + params?: Params$Resource$Advice$Capacityhistory, + options?: MethodOptions + ): Promise>; + capacityHistory( + params: Params$Resource$Advice$Capacityhistory, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + capacityHistory( + params: Params$Resource$Advice$Capacityhistory, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + capacityHistory( + params: Params$Resource$Advice$Capacityhistory, + callback: BodyResponseCallback + ): void; + capacityHistory( + callback: BodyResponseCallback + ): void; + capacityHistory( + paramsOrCallback?: + | Params$Resource$Advice$Capacityhistory + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Advice$Capacityhistory; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Advice$Capacityhistory; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/v1/projects/{project}/regions/{region}/advice/capacityHistory' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '2026-10-01-preview', + }, + options + ), + params, + requiredParams: ['project', 'region'], + pathParams: ['project', 'region'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Advice$Calendarmode extends StandardParameters { + /** + * Project ID for this request. + */ + project?: string; + /** + * Name of the region for this request. + */ + region?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$CalendarModeAdviceRequest; + } + export interface Params$Resource$Advice$Capacity extends StandardParameters { + /** + * Project ID for this request. + */ + project?: string; + /** + * Name of the region for this request. + */ + region?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$CapacityAdviceRequest; + } + export interface Params$Resource$Advice$Capacityhistory extends StandardParameters { + /** + * Project ID for this request. + */ + project?: string; + /** + * Name of the region for this request. + */ + region?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$CapacityHistoryRequest; + } + + export class Resource$Aliasnetworkendpoints { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Deletes the specified AliasNetworkEndpoint. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/compute.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const compute = google.compute('preview'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/compute', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await compute.aliasNetworkEndpoints.delete({ + * // Required. Name of the AliasNetworkEndpoint resource to delete. + * aliasNetworkEndpoint: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}', + * // Required. Project ID for this request. + * project: + * '(?:(?:[-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])?))', + * // 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. + * requestId: 'placeholder-value', + * // Required. Name of the zone scoping this request. + * zone: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "clientOperationId": "my_clientOperationId", + * // "creationTimestamp": "my_creationTimestamp", + * // "description": "my_description", + * // "endTime": "my_endTime", + * // "error": {}, + * // "getHealthOperationMetadata": {}, + * // "getVersionOperationMetadata": {}, + * // "httpErrorMessage": "my_httpErrorMessage", + * // "httpErrorStatusCode": 0, + * // "id": "my_id", + * // "insertTime": "my_insertTime", + * // "instancesBulkInsertOperationMetadata": {}, + * // "instancesTroubleshootOperationMetadata": {}, + * // "kind": "my_kind", + * // "name": "my_name", + * // "operationGroupId": "my_operationGroupId", + * // "operationType": "my_operationType", + * // "progress": 0, + * // "region": "my_region", + * // "selfLink": "my_selfLink", + * // "setCommonInstanceMetadataOperationMetadata": {}, + * // "startTime": "my_startTime", + * // "status": "my_status", + * // "statusMessage": "my_statusMessage", + * // "targetId": "my_targetId", + * // "targetLink": "my_targetLink", + * // "user": "my_user", + * // "warnings": [], + * // "zone": "my_zone" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + delete( + params: Params$Resource$Aliasnetworkendpoints$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Aliasnetworkendpoints$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Aliasnetworkendpoints$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Aliasnetworkendpoints$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Aliasnetworkendpoints$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Aliasnetworkendpoints$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Aliasnetworkendpoints$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Aliasnetworkendpoints$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/v1/projects/{project}/zones/{zone}/aliasNetworkEndpoints/{aliasNetworkEndpoint}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '2026-10-01-preview', + }, + options + ), + params, + requiredParams: ['project', 'zone', 'aliasNetworkEndpoint'], + pathParams: ['aliasNetworkEndpoint', 'project', 'zone'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Returns the specified AliasNetworkEndpoint resource. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/compute.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const compute = google.compute('preview'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/compute', + * 'https://www.googleapis.com/auth/compute.readonly', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await compute.aliasNetworkEndpoints.get({ + * // Required. Name of the AliasNetworkEndpoint resource to return. + * aliasNetworkEndpoint: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}', + * // Required. Project ID for this request. + * project: + * '(?:(?:[-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. Name of the zone scoping this request. + * zone: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "aliases": {}, + * // "annotations": {}, + * // "creationTimestamp": "my_creationTimestamp", + * // "description": "my_description", + * // "host": {}, + * // "id": "my_id", + * // "labels": {}, + * // "name": "my_name", + * // "securityTagInheritance": "my_securityTagInheritance", + * // "selfLink": "my_selfLink", + * // "status": {}, + * // "subnetwork": "my_subnetwork", + * // "updateTime": "my_updateTime" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Aliasnetworkendpoints$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Aliasnetworkendpoints$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Aliasnetworkendpoints$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Aliasnetworkendpoints$Get, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Aliasnetworkendpoints$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Aliasnetworkendpoints$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Aliasnetworkendpoints$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Aliasnetworkendpoints$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/v1/projects/{project}/zones/{zone}/aliasNetworkEndpoints/{aliasNetworkEndpoint}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '2026-10-01-preview', + }, + options + ), + params, + requiredParams: ['project', 'zone', 'aliasNetworkEndpoint'], + pathParams: ['aliasNetworkEndpoint', 'project', 'zone'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Creates an AliasNetworkEndpoint in the specified project and zone + * using the data included in the request. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/compute.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const compute = google.compute('preview'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/compute', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await compute.aliasNetworkEndpoints.insert({ + * // Required. Project ID for this request. + * project: + * '(?:(?:[-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])?))', + * // 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. + * requestId: 'placeholder-value', + * // Required. Name of the zone scoping this request. + * zone: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "aliases": {}, + * // "annotations": {}, + * // "creationTimestamp": "my_creationTimestamp", + * // "description": "my_description", + * // "host": {}, + * // "id": "my_id", + * // "labels": {}, + * // "name": "my_name", + * // "securityTagInheritance": "my_securityTagInheritance", + * // "selfLink": "my_selfLink", + * // "status": {}, + * // "subnetwork": "my_subnetwork", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "clientOperationId": "my_clientOperationId", + * // "creationTimestamp": "my_creationTimestamp", + * // "description": "my_description", + * // "endTime": "my_endTime", + * // "error": {}, + * // "getHealthOperationMetadata": {}, + * // "getVersionOperationMetadata": {}, + * // "httpErrorMessage": "my_httpErrorMessage", + * // "httpErrorStatusCode": 0, + * // "id": "my_id", + * // "insertTime": "my_insertTime", + * // "instancesBulkInsertOperationMetadata": {}, + * // "instancesTroubleshootOperationMetadata": {}, + * // "kind": "my_kind", + * // "name": "my_name", + * // "operationGroupId": "my_operationGroupId", + * // "operationType": "my_operationType", + * // "progress": 0, + * // "region": "my_region", + * // "selfLink": "my_selfLink", + * // "setCommonInstanceMetadataOperationMetadata": {}, + * // "startTime": "my_startTime", + * // "status": "my_status", + * // "statusMessage": "my_statusMessage", + * // "targetId": "my_targetId", + * // "targetLink": "my_targetLink", + * // "user": "my_user", + * // "warnings": [], + * // "zone": "my_zone" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + insert( + params: Params$Resource$Aliasnetworkendpoints$Insert, + options: StreamMethodOptions + ): Promise>; + insert( + params?: Params$Resource$Aliasnetworkendpoints$Insert, + options?: MethodOptions + ): Promise>; + insert( + params: Params$Resource$Aliasnetworkendpoints$Insert, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + insert( + params: Params$Resource$Aliasnetworkendpoints$Insert, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + insert( + params: Params$Resource$Aliasnetworkendpoints$Insert, + callback: BodyResponseCallback + ): void; + insert(callback: BodyResponseCallback): void; + insert( + paramsOrCallback?: + | Params$Resource$Aliasnetworkendpoints$Insert + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Aliasnetworkendpoints$Insert; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Aliasnetworkendpoints$Insert; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://compute.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/compute/v1/projects/{project}/zones/{zone}/aliasNetworkEndpoints' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '2026-10-01-preview', + }, + options + ), + params, + requiredParams: ['project', 'zone'], + pathParams: ['project', 'zone'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Retrieves a list of AliasNetworkEndpoints available to the specified + * project. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/compute.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const compute = google.compute('preview'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/compute', + * 'https://www.googleapis.com/auth/compute.readonly', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await compute.aliasNetworkEndpoints.list({ + * // A filter expression that filters resources listed in the response. Most + * // Compute resources support two types of filter expressions: + * // expressions that support regular expressions and expressions that follow + * // API improvement proposal AIP-160. + * // These two types of filter expressions cannot be mixed in one request. + * // + * // If you want to use AIP-160, your expression must specify the field name, an + * // operator, and the value that you want to use for filtering. The value + * // must be a string, a number, or a boolean. The operator + * // must be either `=`, `!=`, `\>`, `<`, `<=`, `\>=` or `:`. + * // + * // For example, if you are filtering Compute Engine instances, you can + * // exclude instances named `example-instance` by specifying + * // `name != example-instance`. + * // + * // The `:*` comparison can be used to test whether a key has been defined. + * // For example, to find all objects with `owner` label use: + * // ``` + * // labels.owner:* + * // ``` + * // + * // You can also filter nested fields. For example, you could specify + * // `scheduling.automaticRestart = false` to include instances only + * // if they are not scheduled for automatic restarts. You can use filtering + * // on nested fields to filter based onresource labels. + * // + * // To filter on multiple expressions, provide each separate expression within + * // parentheses. For example: + * // ``` + * // (scheduling.automaticRestart = true) + * // (cpuPlatform = "Intel Skylake") + * // ``` + * // By default, each expression is an `AND` expression. However, you + * // can include `AND` and `OR` expressions explicitly. + * // For example: + * // ``` + * // (cpuPlatform = "Intel Skylake") OR + * // (cpuPlatform = "Intel Broadwell") AND + * // (scheduling.automaticRestart = true) + * // ``` + * // + * // If you want to use a regular expression, use the `eq` (equal) or `ne` + * // (not equal) operator against a single un-parenthesized expression with or + * // without quotes or against multiple parenthesized expressions. Examples: + * // + * // `fieldname eq unquoted literal` + * // `fieldname eq 'single quoted literal'` + * // `fieldname eq "double quoted literal"` + * // `(fieldname1 eq literal) (fieldname2 ne "literal")` + * // + * // The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * // The literal value must match the entire field. + * // + * // For example, to filter for instances that do not end with name "instance", + * // you would use `name ne .*instance`. + * // + * // You cannot combine constraints on multiple fields using regular + * // expressions. + * filter: 'placeholder-value', + * // The maximum number of results per page that should be returned. + * // If the number of available results is larger than `maxResults`, + * // Compute Engine returns a `nextPageToken` that can be used to get + * // the next page of results in subsequent list requests. Acceptable values are + * // `0` to `500`, inclusive. (Default: `500`) + * maxResults: 'placeholder-value', + * // Sorts list results by a certain order. By default, results + * // are returned in alphanumerical order based on the resource name. + * // + * // You can also sort results in descending order based on the creation + * // timestamp using `orderBy="creationTimestamp desc"`. This sorts + * // results based on the `creationTimestamp` field in + * // reverse chronological order (newest result first). Use this to sort + * // resources like operations so that the newest operation is returned first. + * // + * // Currently, only sorting by `name` or + * // `creationTimestamp desc` is supported. + * orderBy: 'placeholder-value', + * // Specifies a page token to use. Set `pageToken` to the + * // `nextPageToken` returned by a previous list request to get + * // the next page of results. + * pageToken: 'placeholder-value', + * // Required. Project ID for this request. * project: * '(?:(?:[-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])?))', - * // Name of the region for this request. - * region: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?', - * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "instanceProperties": {}, - * // "locationPolicy": {}, - * // "types": [] - * // } - * }, + * // Required. Name of the zone of this request. + * zone: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?', * }); * console.log(res.data); * * // Example response * // { - * // "location": "my_location", - * // "machineType": "my_machineType", - * // "preemptionHistory": [], - * // "priceHistory": [] + * // "etag": "my_etag", + * // "id": "my_id", + * // "items": [], + * // "nextPageToken": "my_nextPageToken", + * // "selfLink": "my_selfLink", + * // "unreachables": [], + * // "warning": {} * // } * } * @@ -42722,56 +43823,54 @@ export namespace compute_preview { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - capacityHistory( - params: Params$Resource$Advice$Capacityhistory, + list( + params: Params$Resource$Aliasnetworkendpoints$List, options: StreamMethodOptions ): Promise>; - capacityHistory( - params?: Params$Resource$Advice$Capacityhistory, + list( + params?: Params$Resource$Aliasnetworkendpoints$List, options?: MethodOptions - ): Promise>; - capacityHistory( - params: Params$Resource$Advice$Capacityhistory, + ): Promise>; + list( + params: Params$Resource$Aliasnetworkendpoints$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - capacityHistory( - params: Params$Resource$Advice$Capacityhistory, + list( + params: Params$Resource$Aliasnetworkendpoints$List, options: - MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - capacityHistory( - params: Params$Resource$Advice$Capacityhistory, - callback: BodyResponseCallback + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - capacityHistory( - callback: BodyResponseCallback + list( + params: Params$Resource$Aliasnetworkendpoints$List, + callback: BodyResponseCallback ): void; - capacityHistory( + list(callback: BodyResponseCallback): void; + list( paramsOrCallback?: - | Params$Resource$Advice$Capacityhistory - | BodyResponseCallback + | Params$Resource$Aliasnetworkendpoints$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Advice$Capacityhistory; + {}) as Params$Resource$Aliasnetworkendpoints$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Advice$Capacityhistory; + params = {} as Params$Resource$Aliasnetworkendpoints$List; options = {}; } @@ -42786,73 +43885,182 @@ export namespace compute_preview { { url: ( rootUrl + - '/compute/v1/projects/{project}/regions/{region}/advice/capacityHistory' + '/compute/v1/projects/{project}/zones/{zone}/aliasNetworkEndpoints' ).replace(/([^:]\/)\/+/g, '$1'), - method: 'POST', + method: 'GET', apiVersion: '2026-10-01-preview', }, options ), params, - requiredParams: ['project', 'region'], - pathParams: ['project', 'region'], + requiredParams: ['project', 'zone'], + pathParams: ['project', 'zone'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } } - export interface Params$Resource$Advice$Calendarmode extends StandardParameters { + export interface Params$Resource$Aliasnetworkendpoints$Delete extends StandardParameters { /** - * Project ID for this request. + * Required. Name of the AliasNetworkEndpoint resource to delete. + */ + aliasNetworkEndpoint?: string; + /** + * Required. Project ID for this request. */ project?: string; /** - * Name of the region for this request. + * 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. */ - region?: string; - + requestId?: string; /** - * Request body metadata + * Required. Name of the zone scoping this request. */ - requestBody?: Schema$CalendarModeAdviceRequest; + zone?: string; } - export interface Params$Resource$Advice$Capacity extends StandardParameters { + export interface Params$Resource$Aliasnetworkendpoints$Get extends StandardParameters { /** - * Project ID for this request. + * Required. Name of the AliasNetworkEndpoint resource to return. */ - project?: string; + aliasNetworkEndpoint?: string; /** - * Name of the region for this request. + * Required. Project ID for this request. */ - region?: string; - + project?: string; /** - * Request body metadata + * Required. Name of the zone scoping this request. */ - requestBody?: Schema$CapacityAdviceRequest; + zone?: string; } - export interface Params$Resource$Advice$Capacityhistory extends StandardParameters { + export interface Params$Resource$Aliasnetworkendpoints$Insert extends StandardParameters { /** - * Project ID for this request. + * Required. Project ID for this request. */ project?: string; /** - * Name of the region for this request. + * 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. */ - region?: string; + requestId?: string; + /** + * Required. Name of the zone scoping this request. + */ + zone?: string; /** * Request body metadata */ - requestBody?: Schema$CapacityHistoryRequest; + requestBody?: Schema$AliasNetworkEndpoint; + } + export interface Params$Resource$Aliasnetworkendpoints$List extends StandardParameters { + /** + * A filter expression that filters resources listed in the response. Most + * Compute resources support two types of filter expressions: + * expressions that support regular expressions and expressions that follow + * API improvement proposal AIP-160. + * These two types of filter expressions cannot be mixed in one request. + * + * If you want to use AIP-160, your expression must specify the field name, an + * operator, and the value that you want to use for filtering. The value + * must be a string, a number, or a boolean. The operator + * must be either `=`, `!=`, `\>`, `<`, `<=`, `\>=` or `:`. + * + * For example, if you are filtering Compute Engine instances, you can + * exclude instances named `example-instance` by specifying + * `name != example-instance`. + * + * The `:*` comparison can be used to test whether a key has been defined. + * For example, to find all objects with `owner` label use: + * ``` + * labels.owner:* + * ``` + * + * You can also filter nested fields. For example, you could specify + * `scheduling.automaticRestart = false` to include instances only + * if they are not scheduled for automatic restarts. You can use filtering + * on nested fields to filter based onresource labels. + * + * To filter on multiple expressions, provide each separate expression within + * parentheses. For example: + * ``` + * (scheduling.automaticRestart = true) + * (cpuPlatform = "Intel Skylake") + * ``` + * By default, each expression is an `AND` expression. However, you + * can include `AND` and `OR` expressions explicitly. + * For example: + * ``` + * (cpuPlatform = "Intel Skylake") OR + * (cpuPlatform = "Intel Broadwell") AND + * (scheduling.automaticRestart = true) + * ``` + * + * If you want to use a regular expression, use the `eq` (equal) or `ne` + * (not equal) operator against a single un-parenthesized expression with or + * without quotes or against multiple parenthesized expressions. Examples: + * + * `fieldname eq unquoted literal` + * `fieldname eq 'single quoted literal'` + * `fieldname eq "double quoted literal"` + * `(fieldname1 eq literal) (fieldname2 ne "literal")` + * + * The literal value is interpreted as a regular expression using GoogleRE2 library syntax. + * The literal value must match the entire field. + * + * For example, to filter for instances that do not end with name "instance", + * you would use `name ne .*instance`. + * + * You cannot combine constraints on multiple fields using regular + * expressions. + */ + filter?: string; + /** + * The maximum number of results per page that should be returned. + * If the number of available results is larger than `maxResults`, + * Compute Engine returns a `nextPageToken` that can be used to get + * the next page of results in subsequent list requests. Acceptable values are + * `0` to `500`, inclusive. (Default: `500`) + */ + maxResults?: number; + /** + * Sorts list results by a certain order. By default, results + * are returned in alphanumerical order based on the resource name. + * + * You can also sort results in descending order based on the creation + * timestamp using `orderBy="creationTimestamp desc"`. This sorts + * results based on the `creationTimestamp` field in + * reverse chronological order (newest result first). Use this to sort + * resources like operations so that the newest operation is returned first. + * + * Currently, only sorting by `name` or + * `creationTimestamp desc` is supported. + */ + orderBy?: string; + /** + * Specifies a page token to use. Set `pageToken` to the + * `nextPageToken` returned by a previous list request to get + * the next page of results. + */ + pageToken?: string; + /** + * Required. Project ID for this request. + */ + project?: string; + /** + * Required. Name of the zone of this request. + */ + zone?: string; } export class Resource$Autoscalers { @@ -69725,11 +70933,13 @@ export namespace compute_preview { * // "labels": {}, * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkTier": "my_networkTier", * // "prefixLength": 0, * // "purpose": "my_purpose", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "status": "my_status", * // "subnetwork": "my_subnetwork", * // "users": [] @@ -69900,11 +71110,13 @@ export namespace compute_preview { * // "labels": {}, * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkTier": "my_networkTier", * // "prefixLength": 0, * // "purpose": "my_purpose", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "status": "my_status", * // "subnetwork": "my_subnetwork", * // "users": [] @@ -73685,11 +74897,13 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkEndpointType": "my_networkEndpointType", * // "pscData": {}, * // "pscTargetService": "my_pscTargetService", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "size": 0, * // "subnetwork": "my_subnetwork", * // "zone": "my_zone" @@ -73874,11 +75088,13 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkEndpointType": "my_networkEndpointType", * // "pscData": {}, * // "pscTargetService": "my_pscTargetService", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "size": 0, * // "subnetwork": "my_subnetwork", * // "zone": "my_zone" @@ -80117,6 +81333,7 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "networkingAutoConfiguration": {}, + * // "params": {}, * // "region": "my_region", * // "selfLink": "my_selfLink", * // "selfLinkWithId": "my_selfLinkWithId", @@ -80278,6 +81495,7 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "networkingAutoConfiguration": {}, + * // "params": {}, * // "region": "my_region", * // "selfLink": "my_selfLink", * // "selfLinkWithId": "my_selfLinkWithId", @@ -80709,6 +81927,7 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "networkingAutoConfiguration": {}, + * // "params": {}, * // "region": "my_region", * // "selfLink": "my_selfLink", * // "selfLinkWithId": "my_selfLinkWithId", @@ -100370,6 +101589,7 @@ export namespace compute_preview { * // { * // "externalIpv6": "my_externalIpv6", * // "externalIpv6PrefixLength": 0, + * // "ipCollection": "my_ipCollection", * // "kind": "my_kind", * // "name": "my_name", * // "natIP": "my_natIP", @@ -107104,6 +108324,7 @@ export namespace compute_preview { * // "onInstanceStopAction": {}, * // "preemptible": false, * // "preemptionNoticeDuration": {}, + * // "protectionTier": "my_protectionTier", * // "provisioningModel": "my_provisioningModel", * // "skipGuestOsShutdown": false, * // "terminationTime": "my_terminationTime" @@ -109677,6 +110898,7 @@ export namespace compute_preview { * // { * // "externalIpv6": "my_externalIpv6", * // "externalIpv6PrefixLength": 0, + * // "ipCollection": "my_ipCollection", * // "kind": "my_kind", * // "name": "my_name", * // "natIP": "my_natIP", @@ -136749,11 +137971,13 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkEndpointType": "my_networkEndpointType", * // "pscData": {}, * // "pscTargetService": "my_pscTargetService", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "size": 0, * // "subnetwork": "my_subnetwork", * // "zone": "my_zone" @@ -136942,11 +138166,13 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkEndpointType": "my_networkEndpointType", * // "pscData": {}, * // "pscTargetService": "my_pscTargetService", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "size": 0, * // "subnetwork": "my_subnetwork", * // "zone": "my_zone" @@ -200974,11 +202200,13 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkEndpointType": "my_networkEndpointType", * // "pscData": {}, * // "pscTargetService": "my_pscTargetService", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "size": 0, * // "subnetwork": "my_subnetwork", * // "zone": "my_zone" @@ -201167,11 +202395,13 @@ export namespace compute_preview { * // "kind": "my_kind", * // "name": "my_name", * // "network": "my_network", + * // "networkAttachment": "my_networkAttachment", * // "networkEndpointType": "my_networkEndpointType", * // "pscData": {}, * // "pscTargetService": "my_pscTargetService", * // "region": "my_region", * // "selfLink": "my_selfLink", + * // "serviceClassId": "my_serviceClassId", * // "size": 0, * // "subnetwork": "my_subnetwork", * // "zone": "my_zone" diff --git a/src/apis/dataplex/v1.ts b/src/apis/dataplex/v1.ts index 894ed56b6b..57f551fe2b 100644 --- a/src/apis/dataplex/v1.ts +++ b/src/apis/dataplex/v1.ts @@ -1184,10 +1184,6 @@ export namespace dataplex_v1 { * Optional. Configuration for JSON data. */ jsonOptions?: Schema$GoogleCloudDataplexV1DataDiscoverySpecStorageConfigJsonOptions; - /** - * Optional. Specifies configuration for unstructured data discovery. - */ - unstructuredDataOptions?: Schema$GoogleCloudDataplexV1DataDiscoverySpecStorageConfigUnstructuredDataOptions; } /** * Describes CSV and similar semi-structured data formats. @@ -1227,19 +1223,6 @@ export namespace dataplex_v1 { */ typeInferenceDisabled?: boolean | null; } - /** - * Describes options for unstructured data discovery. - */ - export interface Schema$GoogleCloudDataplexV1DataDiscoverySpecStorageConfigUnstructuredDataOptions { - /** - * Optional. Whether to use the global model endpoint. - */ - globalEndpointEnabled?: boolean | null; - /** - * Optional. Specifies whether deeper semantic inference over the objects' contents using GenAI is enabled. - */ - semanticInferenceEnabled?: boolean | null; - } /** * The output of a DataDocumentation scan. */ @@ -2616,14 +2599,6 @@ export namespace dataplex_v1 { * Output only. System generated globally unique ID for the scan. This ID will be different if the scan is deleted and re-created with the same name. */ uid?: string | null; - /** - * Output only. The result of an unstructured data profile scan. - */ - unstructuredDataProfileResult?: Schema$GoogleCloudDataplexV1UnstructuredDataProfileResult; - /** - * Optional. Settings for an unstructured data profile scan. - */ - unstructuredDataProfileSpec?: Schema$GoogleCloudDataplexV1UnstructuredDataProfileSpec; /** * Output only. The time when the scan was last updated. */ @@ -2957,14 +2932,6 @@ export namespace dataplex_v1 { * Output only. System generated globally unique ID for the DataScanJob. */ uid?: string | null; - /** - * Output only. The result of an unstructured data profile scan. - */ - unstructuredDataProfileResult?: Schema$GoogleCloudDataplexV1UnstructuredDataProfileResult; - /** - * Output only. Settings for an unstructured data profile scan. - */ - unstructuredDataProfileSpec?: Schema$GoogleCloudDataplexV1UnstructuredDataProfileSpec; } /** * The data source for DataScan. @@ -3787,175 +3754,6 @@ export namespace dataplex_v1 { */ entityType?: string | null; } - /** - * Contains the strict structure for graph-profile for semantic inference scan result. - */ - export interface Schema$GoogleCloudDataplexV1GraphProfile { - /** - * Output only. Edge types. - */ - edgeTypes?: Schema$GoogleCloudDataplexV1GraphProfileEdgeType[]; - /** - * Output only. Node types. - */ - nodeTypes?: Schema$GoogleCloudDataplexV1GraphProfileNodeType[]; - } - /** - * Represents a type of edge (relationship) in the graph. - */ - export interface Schema$GoogleCloudDataplexV1GraphProfileEdgeType { - /** - * Output only. Description of the edge type. - */ - description?: string | null; - /** - * Output only. Extraction hints for the edge. - */ - extractionHints?: Schema$GoogleCloudDataplexV1GraphProfileEdgeTypeExtractionHints; - /** - * Output only. Fields of the edge type. - */ - fields?: Schema$GoogleCloudDataplexV1GraphProfileField[]; - /** - * Output only. Defines the Foreign Key constraints for the edge. - */ - foreignKeys?: Schema$GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKey[]; - /** - * Output only. Name of the edge type. - */ - name?: string | null; - /** - * Output only. Source node type. - */ - sourceNodeType?: string | null; - /** - * Output only. Target node type. - */ - targetNodeType?: string | null; - } - /** - * Extraction hints (edge-level). - */ - export interface Schema$GoogleCloudDataplexV1GraphProfileEdgeTypeExtractionHints { - /** - * Output only. Expected connectivity topology and bounds of this relationship. Format: "Topology - Description" Example: "1:N - One company can have multiple financial reports." - */ - cardinality?: string | null; - } - /** - * Represents a foreign key constraint. - */ - export interface Schema$GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKey { - /** - * Output only. Description of the foreign key. - */ - description?: string | null; - /** - * Output only. Field Mappings. Mappings between local fields and the fields they reference in the referenced node type. - */ - fieldMappings?: Schema$GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKeyFieldMapping[]; - /** - * Output only. Name of the foreign key constraint. - */ - name?: string | null; - /** - * Output only. The node type this constraint references. - */ - referencedNodeType?: string | null; - } - /** - * Maps a local field to a referenced field. - */ - export interface Schema$GoogleCloudDataplexV1GraphProfileEdgeTypeForeignKeyFieldMapping { - /** - * Output only. Local field name forming part of the foreign key. - */ - field?: string | null; - /** - * Output only. Field name in the referenced node type. - */ - referencedField?: string | null; - } - /** - * Represents a field in a node or edge type. - */ - export interface Schema$GoogleCloudDataplexV1GraphProfileField { - /** - * Output only. The data type of the field, e.g., STRING, INTEGER, DATE. - */ - dataType?: string | null; - /** - * Output only. Description of the field. - */ - description?: string | null; - /** - * Output only. Extraction hints for the field. - */ - extractionHints?: Schema$GoogleCloudDataplexV1GraphProfileFieldExtractionHints; - /** - * Output only. Sub-fields of this field (for STRUCT types). - */ - fields?: Schema$GoogleCloudDataplexV1GraphProfileField[]; - /** - * Output only. The mapped metadata type. - */ - metadataType?: string | null; - /** - * Output only. The mode of the field. - */ - mode?: string | null; - /** - * Output only. Name of the field. - */ - name?: string | null; - } - /** - * Extraction hints (field-level). - */ - export interface Schema$GoogleCloudDataplexV1GraphProfileFieldExtractionHints { - /** - * Output only. Standardizes extracted data (e.g., to ISO 3166-1 alpha-2). - */ - normalization?: string | null; - /** - * Output only. Generates value from other data instead of direct extraction (e.g., hashing). - */ - synthesis?: string | null; - } - /** - * Represents a type of node in the graph. - */ - export interface Schema$GoogleCloudDataplexV1GraphProfileNodeType { - /** - * Output only. Description of the node type. - */ - description?: string | null; - /** - * Output only. Extraction hints for the node. - */ - extractionHints?: Schema$GoogleCloudDataplexV1GraphProfileNodeTypeExtractionHints; - /** - * Output only. Fields of the node type. - */ - fields?: Schema$GoogleCloudDataplexV1GraphProfileField[]; - /** - * Output only. Name of the node type. - */ - name?: string | null; - /** - * Output only. Field names forming the primary keys. The order in this array defines the key's ordinal positions for composite keys. - */ - primaryKeys?: string[] | null; - } - /** - * Extraction hints (node-level). - */ - export interface Schema$GoogleCloudDataplexV1GraphProfileNodeTypeExtractionHints { - /** - * Output only. Expected occurrence frequency of this node type within a document. Format: "Bounds - Description" Example: "0:N - A document may contain multiple people names." - */ - cardinality?: string | null; - } /** * An object that describes the values that you want to set for an entry and its attached aspects when you import metadata. Used when you run a metadata import job. See CreateMetadataJob.You provide a collection of import items in a metadata import file. For more information about how to create a metadata import file, see Metadata import file (https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file). */ @@ -5558,40 +5356,6 @@ export namespace dataplex_v1 { */ cron?: string | null; } - /** - * Contains the result of an unstructured data profile scan. - */ - export interface Schema$GoogleCloudDataplexV1UnstructuredDataProfileResult { - /** - * Output only. The inferred description. - */ - description?: string | null; - /** - * Output only. The inferred graph profile. - */ - graphProfile?: Schema$GoogleCloudDataplexV1GraphProfile; - /** - * Output only. Optional message for partial failures (e.g. node type extraction failed). - */ - partialFailureMessage?: string | null; - } - /** - * Contains the specification for an unstructured data profile scan. - */ - export interface Schema$GoogleCloudDataplexV1UnstructuredDataProfileSpec { - /** - * Optional. Customized prompt for unstructured data profile. The field will be used as part of the prompt, could be some instruction, specifying skill, or specific area to focus. - */ - customizedPrompt?: string | null; - /** - * Optional. Whether to use the global model. - */ - globalEndpointEnabled?: boolean | null; - /** - * Optional. Whether to publish graph-profile as aspect on the catalog entry. - */ - graphProfilePublishingEnabled?: boolean | null; - } /** * Update Entry request. */ @@ -17982,8 +17746,6 @@ export namespace dataplex_v1 { * // "state": "my_state", * // "type": "my_type", * // "uid": "my_uid", - * // "unstructuredDataProfileResult": {}, - * // "unstructuredDataProfileSpec": {}, * // "updateTime": "my_updateTime" * // } * }, @@ -18467,8 +18229,6 @@ export namespace dataplex_v1 { * // "state": "my_state", * // "type": "my_type", * // "uid": "my_uid", - * // "unstructuredDataProfileResult": {}, - * // "unstructuredDataProfileSpec": {}, * // "updateTime": "my_updateTime" * // } * } @@ -18946,8 +18706,6 @@ export namespace dataplex_v1 { * // "state": "my_state", * // "type": "my_type", * // "uid": "my_uid", - * // "unstructuredDataProfileResult": {}, - * // "unstructuredDataProfileSpec": {}, * // "updateTime": "my_updateTime" * // } * }, @@ -20038,9 +19796,7 @@ export namespace dataplex_v1 { * // "startTime": "my_startTime", * // "state": "my_state", * // "type": "my_type", - * // "uid": "my_uid", - * // "unstructuredDataProfileResult": {}, - * // "unstructuredDataProfileSpec": {} + * // "uid": "my_uid" * // } * } * diff --git a/src/apis/devicerun/v1alpha.ts b/src/apis/devicerun/v1alpha.ts index a0168d1f40..ec27727ebe 100644 --- a/src/apis/devicerun/v1alpha.ts +++ b/src/apis/devicerun/v1alpha.ts @@ -340,6 +340,15 @@ export namespace devicerun_v1alpha { */ localeCode?: string | null; } + /** + * Response including the requested sessions. + */ + export interface Schema$BatchGetSessionsResponse { + /** + * The requested sessions, in the same order as the `names` in the request. + */ + sessions?: Schema$Session[]; + } /** * Request to cancel a session. */ @@ -2612,6 +2621,148 @@ export namespace devicerun_v1alpha { this.context = context; } + /** + * Retrieves multiple automation sessions in a single batch request. Sessions are returned in the same order as the `names` in the request. If any of the requested sessions does not exist, the whole request fails with `NOT_FOUND` and no sessions are returned. When calling this method over HTTP/REST with a large number of `names`, the request URL may exceed the maximum URL length (about 16 KB) and be rejected. In that case, send a `POST` request to the same URL with the `X-HTTP-Method-Override: GET` header and pass the request parameters in a JSON (`application/json`) or form-encoded (`application/x-www-form-urlencoded`) body. See https://cloud.google.com/apis/docs/http#long_request_urls. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/devicerun.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const devicerun = google.devicerun('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await devicerun.projects.locations.sessions.batchGet({ + * // Required. The names of the sessions to retrieve. A maximum of 500 sessions can be retrieved in a batch. Format: `projects/{project\}/locations/{location\}/sessions/{session\}`. + * names: 'placeholder-value', + * // Required. The parent resource shared by all sessions being retrieved. Format: `projects/{project\}/locations/{location\}`. The `parent` field in the `BatchGetSessionsRequest` message must match the `parent` of all `Session` resource names in `names`. + * parent: 'projects/my-project/locations/my-location', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "sessions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + batchGet( + params: Params$Resource$Projects$Locations$Sessions$Batchget, + options: StreamMethodOptions + ): Promise>; + batchGet( + params?: Params$Resource$Projects$Locations$Sessions$Batchget, + options?: MethodOptions + ): Promise>; + batchGet( + params: Params$Resource$Projects$Locations$Sessions$Batchget, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + batchGet( + params: Params$Resource$Projects$Locations$Sessions$Batchget, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + batchGet( + params: Params$Resource$Projects$Locations$Sessions$Batchget, + callback: BodyResponseCallback + ): void; + batchGet( + callback: BodyResponseCallback + ): void; + batchGet( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Sessions$Batchget + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Sessions$Batchget; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Sessions$Batchget; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://devicerun.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+parent}/sessions:batchGet').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + /** * Cancels an in-progress automation session. This RPC returns immediately and cancellation proceeds asynchronously. If the session is already finished, this RPC will have no effect. * @example @@ -3345,6 +3496,16 @@ export namespace devicerun_v1alpha { } } + export interface Params$Resource$Projects$Locations$Sessions$Batchget extends StandardParameters { + /** + * Required. The names of the sessions to retrieve. A maximum of 500 sessions can be retrieved in a batch. Format: `projects/{project\}/locations/{location\}/sessions/{session\}`. + */ + names?: string[]; + /** + * Required. The parent resource shared by all sessions being retrieved. Format: `projects/{project\}/locations/{location\}`. The `parent` field in the `BatchGetSessionsRequest` message must match the `parent` of all `Session` resource names in `names`. + */ + parent?: string; + } export interface Params$Resource$Projects$Locations$Sessions$Cancel extends StandardParameters { /** * Required. The name of the session. Format: "projects/{project\}/locations/{location\}/sessions/{session\}" diff --git a/src/apis/discoveryengine/v1.ts b/src/apis/discoveryengine/v1.ts index 08fe6ddf90..291ca31cb8 100644 --- a/src/apis/discoveryengine/v1.ts +++ b/src/apis/discoveryengine/v1.ts @@ -14068,6 +14068,10 @@ export namespace discoveryengine_v1 { * Name of the newly generated or continued session. */ session?: string | null; + /** + * Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project\}/locations/{location\}/tasks/{task_id\} + */ + taskName?: string | null; } /** * Response message for SiteSearchEngineService.FetchDomainVerificationStatus method. @@ -18328,6 +18332,10 @@ export namespace discoveryengine_v1 { * The resolved, server-side view of model selector configuration for the end-user. The backend computes this per-request by applying, in order: Mendel flag evaluation, regional availability rules based on the engine's location, and admin-panel overrides from `model_configs`. The backend is the single source of truth for this configuration; clients should render `resolved_models` directly in the model selector dropdown, in the order provided, without applying their own filtering, ordering, or localization. */ export interface Schema$GoogleCloudDiscoveryengineV1WidgetConfigUiSettingsModelConfigInfo { + /** + * Output only. The `model_id` a client must send when the end-user picks the "Auto" entry (the empty `model_id`). Populated only for surfaces known to have no true "Auto" mode, where leaving the model unset would fall back to a platform default rather than a backend-chosen model. Empty on every other surface, where "Auto" is resolved server-side, and when none of the surface's ranked models is available. When set, it is always one of the non-empty `model_id`s present in `resolved_models`. + */ + autoModelId?: string | null; /** * Output only. The `model_id` of the model that should be selected by default in the model selector when the end-user has not made an explicit choice. The value is always one of the `model_id`s present in `resolved_models`. */ diff --git a/src/apis/discoveryengine/v1alpha.ts b/src/apis/discoveryengine/v1alpha.ts index 66061f959d..9dec4dcf95 100644 --- a/src/apis/discoveryengine/v1alpha.ts +++ b/src/apis/discoveryengine/v1alpha.ts @@ -6344,6 +6344,10 @@ export namespace discoveryengine_v1alpha { * Name of the newly generated or continued session. */ session?: string | null; + /** + * Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project\}/locations/{location\}/tasks/{task_id\} + */ + taskName?: string | null; } /** * Response message for SiteSearchEngineService.FetchDomainVerificationStatus method. @@ -12478,6 +12482,10 @@ export namespace discoveryengine_v1alpha { * The resolved, server-side view of model selector configuration for the end-user. The backend computes this per-request by applying, in order: Mendel flag evaluation, regional availability rules based on the engine's location, and admin-panel overrides from `model_configs`. The backend is the single source of truth for this configuration; clients should render `resolved_models` directly in the model selector dropdown, in the order provided, without applying their own filtering, ordering, or localization. */ export interface Schema$GoogleCloudDiscoveryengineV1alphaWidgetConfigUiSettingsModelConfigInfo { + /** + * Output only. The `model_id` a client must send when the end-user picks the "Auto" entry (the empty `model_id`). Populated only for surfaces known to have no true "Auto" mode, where leaving the model unset would fall back to a platform default rather than a backend-chosen model. Empty on every other surface, where "Auto" is resolved server-side, and when none of the surface's ranked models is available. When set, it is always one of the non-empty `model_id`s present in `resolved_models`. + */ + autoModelId?: string | null; /** * Output only. The `model_id` of the model that should be selected by default in the model selector when the end-user has not made an explicit choice. The value is always one of the `model_id`s present in `resolved_models`. */ @@ -51026,6 +51034,7 @@ export namespace discoveryengine_v1alpha { context: APIRequestContext; files: Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Files; operations: Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Operations; + toolCalls: Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls; constructor(context: APIRequestContext) { this.context = context; this.files = @@ -51036,6 +51045,10 @@ export namespace discoveryengine_v1alpha { new Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Operations( this.context ); + this.toolCalls = + new Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls( + this.context + ); } /** @@ -52352,6 +52365,182 @@ export namespace discoveryengine_v1alpha { name?: string; } + export class Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls { + context: APIRequestContext; + operations: Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations; + constructor(context: APIRequestContext) { + this.context = context; + this.operations = + new Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations( + this.context + ); + } + } + + export class Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * 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. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/discoveryengine.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const discoveryengine = google.discoveryengine('v1alpha'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/discoveryengine.readwrite', + * 'https://www.googleapis.com/auth/discoveryengine.serving.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await discoveryengine.projects.locations.collections.engines.assistants.agents.toolCalls.operations.get( + * { + * // The name of the operation resource. + * name: 'projects/my-project/locations/my-location/collections/my-collection/engines/my-engine/assistants/my-assistant/agents/my-agent/toolCalls/my-toolCall/operations/my-operation', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "done": false, + * // "error": {}, + * // "metadata": {}, + * // "name": "my_name", + * // "response": {} + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get, + callback: BodyResponseCallback + ): void; + get( + callback: BodyResponseCallback + ): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://discoveryengine.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Projects$Locations$Collections$Engines$Assistants$Agents$Toolcalls$Operations$Get extends StandardParameters { + /** + * The name of the operation resource. + */ + name?: string; + } + export class Resource$Projects$Locations$Collections$Engines$Assistants$Cannedqueries { context: APIRequestContext; constructor(context: APIRequestContext) { diff --git a/src/apis/discoveryengine/v1beta.ts b/src/apis/discoveryengine/v1beta.ts index 91d10bc820..030b8f98f7 100644 --- a/src/apis/discoveryengine/v1beta.ts +++ b/src/apis/discoveryengine/v1beta.ts @@ -10376,6 +10376,10 @@ export namespace discoveryengine_v1beta { * Name of the newly generated or continued session. */ session?: string | null; + /** + * Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project\}/locations/{location\}/tasks/{task_id\} + */ + taskName?: string | null; } /** * Response message for SiteSearchEngineService.FetchDomainVerificationStatus method. diff --git a/src/apis/dns/v1beta2.ts b/src/apis/dns/v1beta2.ts index 13a239d53d..9f22bd471c 100644 --- a/src/apis/dns/v1beta2.ts +++ b/src/apis/dns/v1beta2.ts @@ -114,8 +114,11 @@ export namespace dns_v1beta2 { context: APIRequestContext; changes: Resource$Changes; dnsKeys: Resource$Dnskeys; + locations: Resource$Locations; managedZoneOperations: Resource$Managedzoneoperations; managedZones: Resource$Managedzones; + operations: Resource$Operations; + outboundEndpoints: Resource$Outboundendpoints; policies: Resource$Policies; projects: Resource$Projects; resourceRecordSets: Resource$Resourcerecordsets; @@ -130,10 +133,13 @@ export namespace dns_v1beta2 { this.changes = new Resource$Changes(this.context); this.dnsKeys = new Resource$Dnskeys(this.context); + this.locations = new Resource$Locations(this.context); this.managedZoneOperations = new Resource$Managedzoneoperations( this.context ); this.managedZones = new Resource$Managedzones(this.context); + this.operations = new Resource$Operations(this.context); + this.outboundEndpoints = new Resource$Outboundendpoints(this.context); this.policies = new Resource$Policies(this.context); this.projects = new Resource$Projects(this.context); this.resourceRecordSets = new Resource$Resourcerecordsets(this.context); @@ -280,6 +286,10 @@ export namespace dns_v1beta2 { keyType?: string | null; kind?: string | null; } + /** + * A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); \} + */ + export interface Schema$Empty {} /** * 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. */ @@ -414,6 +424,23 @@ export namespace dns_v1beta2 { */ permissions?: string[] | null; } + /** + * The response message for Operations.ListOperations. + */ + export interface Schema$GoogleLongrunningListOperationsResponse { + /** + * The standard List next-page token. + */ + nextPageToken?: string | null; + /** + * A list of operations that matches the specified filter in the request. + */ + operations?: Schema$GoogleLongrunningOperation[]; + /** + * Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations. + */ + unreachable?: string[] | null; + } /** * This resource represents a long-running operation that is the result of a network API call. */ @@ -439,6 +466,61 @@ export namespace dns_v1beta2 { */ response?: {[key: string]: any} | null; } + /** + * The response message for Locations.ListLocations. + */ + export interface Schema$ListLocationsResponse { + /** + * A list of locations that matches the specified filter in the request. + */ + locations?: Schema$Location[]; + /** + * The standard List next-page token. + */ + nextPageToken?: string | null; + } + /** + * Response message for OutboundEndpointsService.ListOutboundEndpoints + */ + export interface Schema$ListOutboundEndpointsResponse { + /** + * A token to retrieve the next page of results. Set to empty if there are no remaining results. + */ + nextPageToken?: string | null; + /** + * The list of OutboundEndpoints. + */ + outboundEndpoints?: Schema$OutboundEndpoint[]; + /** + * Unordered list. The resource names of the unreachable locations. Format: `projects/{project\}/locations/{location\}` + */ + unreachable?: string[] | null; + } + /** + * A resource that represents a Google Cloud location. + */ + export interface Schema$Location { + /** + * The friendly name for this location, typically a nearby city name. For example, "Tokyo". + */ + displayName?: string | null; + /** + * Cross-service attributes for the location. For example {"cloud.googleapis.com/region": "us-east1"\} + */ + labels?: {[key: string]: string} | null; + /** + * The canonical id for this location. For example: `"us-east1"`. + */ + locationId?: string | null; + /** + * Service-specific metadata. For example the available capacity at the given location. + */ + metadata?: {[key: string]: any} | null; + /** + * Resource name for the location, which may vary between implementations. For example: `"projects/example-project/locations/us-east1"` + */ + name?: string | null; + } /** * A zone is a subtree of the DNS namespace under one administrative responsibility. A ManagedZone is a resource that represents a DNS zone hosted by the Cloud DNS service. */ @@ -533,6 +615,10 @@ export namespace dns_v1beta2 { } export interface Schema$ManagedZoneForwardingConfig { kind?: string | null; + /** + * The list of outbound endpoints to use for queries. + */ + outboundEndpoints?: Schema$ManagedZoneForwardingConfigOutboundEndpoint[]; /** * List of target name servers to forward to. Cloud DNS selects the best available name server if more than one target is given. */ @@ -557,6 +643,13 @@ export namespace dns_v1beta2 { ipv6Address?: string | null; kind?: string | null; } + export interface Schema$ManagedZoneForwardingConfigOutboundEndpoint { + kind?: string | null; + /** + * Specified as a resource path including project and region. This should be formatted like projects/{project\}/locations/{location\}/outboundEndpoints/{endpoint\} + */ + name?: string | null; + } export interface Schema$ManagedZoneOperationsListResponse { /** * Output only. Type of resource. @@ -706,6 +799,84 @@ export namespace dns_v1beta2 { */ oldValue?: Schema$ManagedZone; } + /** + * Represents the metadata of the long-running operation. + */ + export interface Schema$OperationMetadata { + /** + * Output only. API version used to start the operation. + */ + apiVersion?: string | null; + /** + * Output only. The time the operation was created. + */ + createTime?: string | null; + /** + * Output only. The time the operation finished running. + */ + endTime?: string | null; + /** + * Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + */ + requestedCancellation?: boolean | null; + /** + * Output only. Human-readable status of the operation, if any. + */ + statusMessage?: string | null; + /** + * Output only. Server-defined resource path for the target of the operation. + */ + target?: string | null; + /** + * Output only. Name of the verb executed by the operation. + */ + verb?: string | null; + } + /** + * An OutboundEndpoint is a regional resource to enable outbound forwarding from a private IP range in VPCs to on-premise or other networks. + */ + export interface Schema$OutboundEndpoint { + /** + * Optional. Annotations as key value pairs + */ + annotations?: {[key: string]: string} | null; + /** + * Output only. [Output only] Create time stamp + */ + createTime?: string | null; + /** + * Optional. User provided description. + */ + description?: string | null; + /** + * Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. + */ + endpointIp?: string | null; + /** + * Optional. Labels as key value pairs + */ + labels?: {[key: string]: string} | null; + /** + * Identifier. The resource name of the OutboundEndpoint. Format: `projects/{project\}/locations/{location\}/outboundEndpoints/{outboundEndpoint\}` + */ + name?: string | null; + /** + * Required. Immutable. The VPC network containing the outbound endpoint, specified as full path. + */ + network?: string | null; + /** + * Required. Immutable. The subnetwork holding the endpoint_ip, specified as full path. + */ + subnetwork?: string | null; + /** + * Optional. Tag bindings as key value pairs + */ + tags?: {[key: string]: string} | null; + /** + * Output only. [Output only] Update time stamp + */ + updateTime?: string | null; + } export interface Schema$PoliciesListResponse { /** * Output only. Type of resource. @@ -766,11 +937,22 @@ export namespace dns_v1beta2 { } export interface Schema$PolicyAlternativeNameServerConfig { kind?: string | null; + /** + * The list of outbound endpoints to use for queries. + */ + outboundEndpoints?: Schema$PolicyAlternativeNameServerConfigOutboundEndpoint[]; /** * Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified. */ targetNameServers?: Schema$PolicyAlternativeNameServerConfigTargetNameServer[]; } + export interface Schema$PolicyAlternativeNameServerConfigOutboundEndpoint { + kind?: string | null; + /** + * Specified as a resource path including project and region. This should be formatted like projects/{project\}/locations/{location\}/outboundEndpoints/{endpoint\} + */ + name?: string | null; + } export interface Schema$PolicyAlternativeNameServerConfigTargetNameServer { /** * Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target. @@ -882,6 +1064,14 @@ export namespace dns_v1beta2 { * Maximum allowed number of networks per response policy. */ networksPerResponsePolicy?: number | null; + /** + * Maximum allowed number of outbound endpoints per managed zone. + */ + outboundEndpointsPerManagedZone?: number | null; + /** + * Maximum allowed number of outbound endpoints per policy. + */ + outboundEndpointsPerPolicy?: number | null; /** * Maximum allowed number of consumer peering zones per target network owned by this producer project */ @@ -2132,14 +2322,14 @@ export namespace dns_v1beta2 { project?: string; } - export class Resource$Managedzoneoperations { + export class Resource$Locations { context: APIRequestContext; constructor(context: APIRequestContext) { this.context = context; } /** - * Fetches the representation of an existing Operation. + * Gets information about a location. * @example * ```js * // Before running the sample: @@ -2173,28 +2363,19 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZoneOperations.get({ - * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. - * clientOperationId: 'placeholder-value', - * // Identifies the managed zone addressed by this request. - * managedZone: 'placeholder-value', - * // Identifies the operation addressed by this request (ID of the operation). - * operation: 'placeholder-value', - * // Identifies the project addressed by this request. - * project: 'placeholder-value', + * const res = await dns.locations.get({ + * // Resource name for the location. + * name: 'projects/my-project/locations/my-location', * }); * console.log(res.data); * * // Example response * // { - * // "dnsKeyContext": {}, - * // "id": "my_id", - * // "kind": "my_kind", - * // "startTime": "my_startTime", - * // "status": "my_status", - * // "type": "my_type", - * // "user": "my_user", - * // "zoneContext": {} + * // "displayName": "my_displayName", + * // "labels": {}, + * // "locationId": "my_locationId", + * // "metadata": {}, + * // "name": "my_name" * // } * } * @@ -2211,51 +2392,50 @@ export namespace dns_v1beta2 { * @returns A promise if used with async/await, or void if used with a callback. */ get( - params: Params$Resource$Managedzoneoperations$Get, + params: Params$Resource$Locations$Get, options: StreamMethodOptions ): Promise>; get( - params?: Params$Resource$Managedzoneoperations$Get, + params?: Params$Resource$Locations$Get, options?: MethodOptions - ): Promise>; + ): Promise>; get( - params: Params$Resource$Managedzoneoperations$Get, + params: Params$Resource$Locations$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; get( - params: Params$Resource$Managedzoneoperations$Get, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + params: Params$Resource$Locations$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; get( - params: Params$Resource$Managedzoneoperations$Get, - callback: BodyResponseCallback + params: Params$Resource$Locations$Get, + callback: BodyResponseCallback ): void; - get(callback: BodyResponseCallback): void; + get(callback: BodyResponseCallback): void; get( paramsOrCallback?: - | Params$Resource$Managedzoneoperations$Get - | BodyResponseCallback + | Params$Resource$Locations$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - BodyResponseCallback | BodyResponseCallback + BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { - let params = (paramsOrCallback || - {}) as Params$Resource$Managedzoneoperations$Get; + let params = (paramsOrCallback || {}) as Params$Resource$Locations$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzoneoperations$Get; + params = {} as Params$Resource$Locations$Get; options = {}; } @@ -2268,32 +2448,32 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + - '/dns/v1beta2/projects/{project}/managedZones/{managedZone}/operations/{operation}' - ).replace(/([^:]\/)\/+/g, '$1'), + url: (rootUrl + '/dns/v1beta2/{+name}').replace( + /([^:]\/)\/+/g, + '$1' + ), method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['project', 'managedZone', 'operation'], - pathParams: ['managedZone', 'operation', 'project'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Enumerates Operations for the given ManagedZone. + * Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project\}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version. * @example * ```js * // Before running the sample: @@ -2327,25 +2507,24 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZoneOperations.list({ - * // Identifies the managed zone addressed by this request. - * managedZone: 'placeholder-value', - * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return. - * maxResults: 'placeholder-value', - * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request. + * const res = await dns.locations.list({ + * // Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage. + * extraLocationTypes: 'placeholder-value', + * // 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). + * filter: 'placeholder-value', + * // The resource that owns the locations collection, if applicable. + * name: 'projects/my-project', + * // The maximum number of results to return. If not set, the service selects a default. + * pageSize: 'placeholder-value', + * // A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page. * pageToken: 'placeholder-value', - * // Identifies the project addressed by this request. - * project: 'placeholder-value', - * // Sorting criterion. The only supported values are START_TIME and ID. - * sortBy: 'placeholder-value', * }); * console.log(res.data); * * // Example response * // { - * // "kind": "my_kind", - * // "nextPageToken": "my_nextPageToken", - * // "operations": [] + * // "locations": [], + * // "nextPageToken": "my_nextPageToken" * // } * } * @@ -2362,60 +2541,52 @@ export namespace dns_v1beta2 { * @returns A promise if used with async/await, or void if used with a callback. */ list( - params: Params$Resource$Managedzoneoperations$List, + params: Params$Resource$Locations$List, options: StreamMethodOptions ): Promise>; list( - params?: Params$Resource$Managedzoneoperations$List, + params?: Params$Resource$Locations$List, options?: MethodOptions - ): Promise< - GaxiosResponseWithHTTP2 - >; + ): Promise>; list( - params: Params$Resource$Managedzoneoperations$List, + params: Params$Resource$Locations$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; list( - params: Params$Resource$Managedzoneoperations$List, + params: Params$Resource$Locations$List, options: - | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - list( - params: Params$Resource$Managedzoneoperations$List, - callback: BodyResponseCallback + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; list( - callback: BodyResponseCallback + params: Params$Resource$Locations$List, + callback: BodyResponseCallback ): void; + list(callback: BodyResponseCallback): void; list( paramsOrCallback?: - | Params$Resource$Managedzoneoperations$List - | BodyResponseCallback + | Params$Resource$Locations$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise< - GaxiosResponseWithHTTP2 - > + | Promise> | Promise> { - let params = (paramsOrCallback || - {}) as Params$Resource$Managedzoneoperations$List; + let params = (paramsOrCallback || {}) as Params$Resource$Locations$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzoneoperations$List; + params = {} as Params$Resource$Locations$List; options = {}; } @@ -2428,82 +2599,68 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + - '/dns/v1beta2/projects/{project}/managedZones/{managedZone}/operations' - ).replace(/([^:]\/)\/+/g, '$1'), + url: (rootUrl + '/dns/v1beta2/{+name}/locations').replace( + /([^:]\/)\/+/g, + '$1' + ), method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['project', 'managedZone'], - pathParams: ['managedZone', 'project'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( - parameters - ); + return createAPIRequest(parameters); } } } - export interface Params$Resource$Managedzoneoperations$Get extends StandardParameters { - /** - * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. - */ - clientOperationId?: string; - /** - * Identifies the managed zone addressed by this request. - */ - managedZone?: string; - /** - * Identifies the operation addressed by this request (ID of the operation). - */ - operation?: string; + export interface Params$Resource$Locations$Get extends StandardParameters { /** - * Identifies the project addressed by this request. + * Resource name for the location. */ - project?: string; + name?: string; } - export interface Params$Resource$Managedzoneoperations$List extends StandardParameters { + export interface Params$Resource$Locations$List extends StandardParameters { /** - * Identifies the managed zone addressed by this request. + * Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage. */ - managedZone?: string; + extraLocationTypes?: string[]; /** - * Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return. + * 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). */ - maxResults?: number; + filter?: string; /** - * Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request. + * The resource that owns the locations collection, if applicable. */ - pageToken?: string; + name?: string; /** - * Identifies the project addressed by this request. + * The maximum number of results to return. If not set, the service selects a default. */ - project?: string; + pageSize?: number; /** - * Sorting criterion. The only supported values are START_TIME and ID. + * A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page. */ - sortBy?: string; + pageToken?: string; } - export class Resource$Managedzones { + export class Resource$Managedzoneoperations { context: APIRequestContext; constructor(context: APIRequestContext) { this.context = context; } /** - * Creates a new ManagedZone. Note: While `dns.managedZones.create` is the baseline permission required to invoke this method, additional permissions are required if the managed zone configuration references other resources. + * Fetches the representation of an existing Operation. * @example * ```js * // Before running the sample: @@ -2526,6 +2683,8 @@ export namespace dns_v1beta2 { * // Scopes can be specified either as an array or as a single, space-delimited string. * scopes: [ * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', * ], * }); @@ -2535,14 +2694,1649 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.create({ + * const res = await dns.managedZoneOperations.get({ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. * clientOperationId: 'placeholder-value', + * // Identifies the managed zone addressed by this request. + * managedZone: 'placeholder-value', + * // Identifies the operation addressed by this request (ID of the operation). + * operation: 'placeholder-value', * // Identifies the project addressed by this request. * project: 'placeholder-value', + * }); + * console.log(res.data); * - * // Request body metadata - * requestBody: { + * // Example response + * // { + * // "dnsKeyContext": {}, + * // "id": "my_id", + * // "kind": "my_kind", + * // "startTime": "my_startTime", + * // "status": "my_status", + * // "type": "my_type", + * // "user": "my_user", + * // "zoneContext": {} + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Managedzoneoperations$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Managedzoneoperations$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Managedzoneoperations$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Managedzoneoperations$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Managedzoneoperations$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Managedzoneoperations$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzoneoperations$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzoneoperations$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/dns/v1beta2/projects/{project}/managedZones/{managedZone}/operations/{operation}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'managedZone', 'operation'], + pathParams: ['managedZone', 'operation', 'project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Enumerates Operations for the given ManagedZone. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZoneOperations.list({ + * // Identifies the managed zone addressed by this request. + * managedZone: 'placeholder-value', + * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return. + * maxResults: 'placeholder-value', + * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request. + * pageToken: 'placeholder-value', + * // Identifies the project addressed by this request. + * project: 'placeholder-value', + * // Sorting criterion. The only supported values are START_TIME and ID. + * sortBy: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "kind": "my_kind", + * // "nextPageToken": "my_nextPageToken", + * // "operations": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Managedzoneoperations$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Managedzoneoperations$List, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + list( + params: Params$Resource$Managedzoneoperations$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Managedzoneoperations$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Managedzoneoperations$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Managedzoneoperations$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzoneoperations$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzoneoperations$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/dns/v1beta2/projects/{project}/managedZones/{managedZone}/operations' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'managedZone'], + pathParams: ['managedZone', 'project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + } + + export interface Params$Resource$Managedzoneoperations$Get extends StandardParameters { + /** + * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + */ + clientOperationId?: string; + /** + * Identifies the managed zone addressed by this request. + */ + managedZone?: string; + /** + * Identifies the operation addressed by this request (ID of the operation). + */ + operation?: string; + /** + * Identifies the project addressed by this request. + */ + project?: string; + } + export interface Params$Resource$Managedzoneoperations$List extends StandardParameters { + /** + * Identifies the managed zone addressed by this request. + */ + managedZone?: string; + /** + * Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return. + */ + maxResults?: number; + /** + * Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request. + */ + pageToken?: string; + /** + * Identifies the project addressed by this request. + */ + project?: string; + /** + * Sorting criterion. The only supported values are START_TIME and ID. + */ + sortBy?: string; + } + + export class Resource$Managedzones { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates a new ManagedZone. Note: While `dns.managedZones.create` is the baseline permission required to invoke this method, additional permissions are required if the managed zone configuration references other resources. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.create({ + * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * clientOperationId: 'placeholder-value', + * // Identifies the project addressed by this request. + * project: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "cloudLoggingConfig": {}, + * // "creationTime": "my_creationTime", + * // "description": "my_description", + * // "dnsName": "my_dnsName", + * // "dnssecConfig": {}, + * // "forwardingConfig": {}, + * // "id": "my_id", + * // "kind": "my_kind", + * // "labels": {}, + * // "name": "my_name", + * // "nameServerSet": "my_nameServerSet", + * // "nameServers": [], + * // "peeringConfig": {}, + * // "privateVisibilityConfig": {}, + * // "reverseLookupConfig": {}, + * // "serviceDirectoryConfig": {}, + * // "visibility": "my_visibility" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "cloudLoggingConfig": {}, + * // "creationTime": "my_creationTime", + * // "description": "my_description", + * // "dnsName": "my_dnsName", + * // "dnssecConfig": {}, + * // "forwardingConfig": {}, + * // "id": "my_id", + * // "kind": "my_kind", + * // "labels": {}, + * // "name": "my_name", + * // "nameServerSet": "my_nameServerSet", + * // "nameServers": [], + * // "peeringConfig": {}, + * // "privateVisibilityConfig": {}, + * // "reverseLookupConfig": {}, + * // "serviceDirectoryConfig": {}, + * // "visibility": "my_visibility" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + create( + params: Params$Resource$Managedzones$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Managedzones$Create, + options?: MethodOptions + ): Promise>; + create( + params: Params$Resource$Managedzones$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Managedzones$Create, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Managedzones$Create, + callback: BodyResponseCallback + ): void; + create(callback: BodyResponseCallback): void; + create( + paramsOrCallback?: + | Params$Resource$Managedzones$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzones$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/dns/v1beta2/projects/{project}/managedZones' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project'], + pathParams: ['project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Deletes a previously created ManagedZone. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.delete({ + * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * clientOperationId: 'placeholder-value', + * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + * managedZone: 'placeholder-value', + * // Identifies the project addressed by this request. + * project: 'placeholder-value', + * }); + * console.log(res.data); + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + delete( + params: Params$Resource$Managedzones$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Managedzones$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Managedzones$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Managedzones$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Managedzones$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Managedzones$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzones$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/dns/v1beta2/projects/{project}/managedZones/{managedZone}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'managedZone'], + pathParams: ['managedZone', 'project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Fetches the representation of an existing ManagedZone. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.get({ + * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * clientOperationId: 'placeholder-value', + * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + * managedZone: 'placeholder-value', + * // Identifies the project addressed by this request. + * project: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "cloudLoggingConfig": {}, + * // "creationTime": "my_creationTime", + * // "description": "my_description", + * // "dnsName": "my_dnsName", + * // "dnssecConfig": {}, + * // "forwardingConfig": {}, + * // "id": "my_id", + * // "kind": "my_kind", + * // "labels": {}, + * // "name": "my_name", + * // "nameServerSet": "my_nameServerSet", + * // "nameServers": [], + * // "peeringConfig": {}, + * // "privateVisibilityConfig": {}, + * // "reverseLookupConfig": {}, + * // "serviceDirectoryConfig": {}, + * // "visibility": "my_visibility" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Managedzones$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Managedzones$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Managedzones$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Managedzones$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Managedzones$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Managedzones$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || {}) as Params$Resource$Managedzones$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/dns/v1beta2/projects/{project}/managedZones/{managedZone}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'managedZone'], + pathParams: ['managedZone', 'project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.getIamPolicy({ + * // 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. + * resource: 'projects/my-project/managedZones/my-managedZone', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "options": {} + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "auditConfigs": [], + * // "bindings": [], + * // "etag": "my_etag", + * // "version": 0 + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + getIamPolicy( + params: Params$Resource$Managedzones$Getiampolicy, + options: StreamMethodOptions + ): Promise>; + getIamPolicy( + params?: Params$Resource$Managedzones$Getiampolicy, + options?: MethodOptions + ): Promise>; + getIamPolicy( + params: Params$Resource$Managedzones$Getiampolicy, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + getIamPolicy( + params: Params$Resource$Managedzones$Getiampolicy, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + getIamPolicy( + params: Params$Resource$Managedzones$Getiampolicy, + callback: BodyResponseCallback + ): void; + getIamPolicy( + callback: BodyResponseCallback + ): void; + getIamPolicy( + paramsOrCallback?: + | Params$Resource$Managedzones$Getiampolicy + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzones$Getiampolicy; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$Getiampolicy; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/dns/v1beta2/{+resource}:getIamPolicy').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Enumerates ManagedZones that have been created but not yet deleted. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.list({ + * // Restricts the list to return only zones with this domain name. + * dnsName: 'placeholder-value', + * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return. + * maxResults: 'placeholder-value', + * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request. + * pageToken: 'placeholder-value', + * // Identifies the project addressed by this request. + * project: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "kind": "my_kind", + * // "managedZones": [], + * // "nextPageToken": "my_nextPageToken" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Managedzones$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Managedzones$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Managedzones$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Managedzones$List, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Managedzones$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Managedzones$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzones$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/dns/v1beta2/projects/{project}/managedZones' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project'], + pathParams: ['project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Applies a partial update to an existing ManagedZone. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.patch({ + * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * clientOperationId: 'placeholder-value', + * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + * managedZone: 'placeholder-value', + * // Identifies the project addressed by this request. + * project: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "cloudLoggingConfig": {}, + * // "creationTime": "my_creationTime", + * // "description": "my_description", + * // "dnsName": "my_dnsName", + * // "dnssecConfig": {}, + * // "forwardingConfig": {}, + * // "id": "my_id", + * // "kind": "my_kind", + * // "labels": {}, + * // "name": "my_name", + * // "nameServerSet": "my_nameServerSet", + * // "nameServers": [], + * // "peeringConfig": {}, + * // "privateVisibilityConfig": {}, + * // "reverseLookupConfig": {}, + * // "serviceDirectoryConfig": {}, + * // "visibility": "my_visibility" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "dnsKeyContext": {}, + * // "id": "my_id", + * // "kind": "my_kind", + * // "startTime": "my_startTime", + * // "status": "my_status", + * // "type": "my_type", + * // "user": "my_user", + * // "zoneContext": {} + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Managedzones$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Managedzones$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Managedzones$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Managedzones$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Managedzones$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Managedzones$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzones$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/dns/v1beta2/projects/{project}/managedZones/{managedZone}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'managedZone'], + pathParams: ['managedZone', 'project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.setIamPolicy({ + * // 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. + * resource: 'projects/my-project/managedZones/my-managedZone', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "policy": {}, + * // "updateMask": "my_updateMask" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "auditConfigs": [], + * // "bindings": [], + * // "etag": "my_etag", + * // "version": 0 + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + setIamPolicy( + params: Params$Resource$Managedzones$Setiampolicy, + options: StreamMethodOptions + ): Promise>; + setIamPolicy( + params?: Params$Resource$Managedzones$Setiampolicy, + options?: MethodOptions + ): Promise>; + setIamPolicy( + params: Params$Resource$Managedzones$Setiampolicy, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + setIamPolicy( + params: Params$Resource$Managedzones$Setiampolicy, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + setIamPolicy( + params: Params$Resource$Managedzones$Setiampolicy, + callback: BodyResponseCallback + ): void; + setIamPolicy( + callback: BodyResponseCallback + ): void; + setIamPolicy( + paramsOrCallback?: + | Params$Resource$Managedzones$Setiampolicy + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzones$Setiampolicy; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$Setiampolicy; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/dns/v1beta2/{+resource}:setIamPolicy').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Returns permissions that a caller has on the specified resource. If the resource does not exist, this returns 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. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.testIamPermissions({ + * // 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. + * resource: 'projects/my-project/managedZones/my-managedZone', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "permissions": [] + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "permissions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + testIamPermissions( + params: Params$Resource$Managedzones$Testiampermissions, + options: StreamMethodOptions + ): Promise>; + testIamPermissions( + params?: Params$Resource$Managedzones$Testiampermissions, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + testIamPermissions( + params: Params$Resource$Managedzones$Testiampermissions, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + testIamPermissions( + params: Params$Resource$Managedzones$Testiampermissions, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + testIamPermissions( + params: Params$Resource$Managedzones$Testiampermissions, + callback: BodyResponseCallback + ): void; + testIamPermissions( + callback: BodyResponseCallback + ): void; + testIamPermissions( + paramsOrCallback?: + | Params$Resource$Managedzones$Testiampermissions + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzones$Testiampermissions; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$Testiampermissions; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/dns/v1beta2/{+resource}:testIamPermissions' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['resource'], + pathParams: ['resource'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Updates an existing ManagedZone. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.managedZones.update({ + * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * clientOperationId: 'placeholder-value', + * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + * managedZone: 'placeholder-value', + * // Identifies the project addressed by this request. + * project: 'placeholder-value', + * + * // Request body metadata + * requestBody: { * // request body parameters * // { * // "cloudLoggingConfig": {}, @@ -2568,25 +4362,293 @@ export namespace dns_v1beta2 { * console.log(res.data); * * // Example response - * // { - * // "cloudLoggingConfig": {}, - * // "creationTime": "my_creationTime", - * // "description": "my_description", - * // "dnsName": "my_dnsName", - * // "dnssecConfig": {}, - * // "forwardingConfig": {}, - * // "id": "my_id", - * // "kind": "my_kind", - * // "labels": {}, - * // "name": "my_name", - * // "nameServerSet": "my_nameServerSet", - * // "nameServers": [], - * // "peeringConfig": {}, - * // "privateVisibilityConfig": {}, - * // "reverseLookupConfig": {}, - * // "serviceDirectoryConfig": {}, - * // "visibility": "my_visibility" - * // } + * // { + * // "dnsKeyContext": {}, + * // "id": "my_id", + * // "kind": "my_kind", + * // "startTime": "my_startTime", + * // "status": "my_status", + * // "type": "my_type", + * // "user": "my_user", + * // "zoneContext": {} + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + update( + params: Params$Resource$Managedzones$Update, + options: StreamMethodOptions + ): Promise>; + update( + params?: Params$Resource$Managedzones$Update, + options?: MethodOptions + ): Promise>; + update( + params: Params$Resource$Managedzones$Update, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + update( + params: Params$Resource$Managedzones$Update, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + update( + params: Params$Resource$Managedzones$Update, + callback: BodyResponseCallback + ): void; + update(callback: BodyResponseCallback): void; + update( + paramsOrCallback?: + | Params$Resource$Managedzones$Update + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Managedzones$Update; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Managedzones$Update; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://dns.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/dns/v1beta2/projects/{project}/managedZones/{managedZone}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'PUT', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['project', 'managedZone'], + pathParams: ['managedZone', 'project'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Managedzones$Create extends StandardParameters { + /** + * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + */ + clientOperationId?: string; + /** + * Identifies the project addressed by this request. + */ + project?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$ManagedZone; + } + export interface Params$Resource$Managedzones$Delete extends StandardParameters { + /** + * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + */ + clientOperationId?: string; + /** + * Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + */ + managedZone?: string; + /** + * Identifies the project addressed by this request. + */ + project?: string; + } + export interface Params$Resource$Managedzones$Get extends StandardParameters { + /** + * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + */ + clientOperationId?: string; + /** + * Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + */ + managedZone?: string; + /** + * Identifies the project addressed by this request. + */ + project?: string; + } + export interface Params$Resource$Managedzones$Getiampolicy extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleIamV1GetIamPolicyRequest; + } + export interface Params$Resource$Managedzones$List extends StandardParameters { + /** + * Restricts the list to return only zones with this domain name. + */ + dnsName?: string; + /** + * Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return. + */ + maxResults?: number; + /** + * Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request. + */ + pageToken?: string; + /** + * Identifies the project addressed by this request. + */ + project?: string; + } + export interface Params$Resource$Managedzones$Patch extends StandardParameters { + /** + * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + */ + clientOperationId?: string; + /** + * Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + */ + managedZone?: string; + /** + * Identifies the project addressed by this request. + */ + project?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$ManagedZone; + } + export interface Params$Resource$Managedzones$Setiampolicy extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleIamV1SetIamPolicyRequest; + } + export interface Params$Resource$Managedzones$Testiampermissions extends StandardParameters { + /** + * 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. + */ + resource?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleIamV1TestIamPermissionsRequest; + } + export interface Params$Resource$Managedzones$Update extends StandardParameters { + /** + * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + */ + clientOperationId?: string; + /** + * Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + */ + managedZone?: string; + /** + * Identifies the project addressed by this request. + */ + project?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$ManagedZone; + } + + export class Resource$Operations { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * 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`. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/dns.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const dns = google.dns('v1beta2'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: [ + * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', + * ], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await dns.operations.cancel({ + * // The name of the operation resource to be cancelled. + * name: 'projects/my-project/locations/my-location/operations/my-operation', + * }); + * console.log(res.data); + * + * // Example response + * // {} * } * * main().catch(e => { @@ -2601,53 +4663,52 @@ export namespace dns_v1beta2 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - create( - params: Params$Resource$Managedzones$Create, + cancel( + params: Params$Resource$Operations$Cancel, options: StreamMethodOptions ): Promise>; - create( - params?: Params$Resource$Managedzones$Create, + cancel( + params?: Params$Resource$Operations$Cancel, options?: MethodOptions - ): Promise>; - create( - params: Params$Resource$Managedzones$Create, + ): Promise>; + cancel( + params: Params$Resource$Operations$Cancel, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - create( - params: Params$Resource$Managedzones$Create, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + cancel( + params: Params$Resource$Operations$Cancel, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - create( - params: Params$Resource$Managedzones$Create, - callback: BodyResponseCallback + cancel( + params: Params$Resource$Operations$Cancel, + callback: BodyResponseCallback ): void; - create(callback: BodyResponseCallback): void; - create( + cancel(callback: BodyResponseCallback): void; + cancel( paramsOrCallback?: - | Params$Resource$Managedzones$Create - | BodyResponseCallback + | Params$Resource$Operations$Cancel + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback - | BodyResponseCallback + BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Managedzones$Create; + {}) as Params$Resource$Operations$Cancel; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$Create; + params = {} as Params$Resource$Operations$Cancel; options = {}; } @@ -2660,31 +4721,32 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + '/dns/v1beta2/projects/{project}/managedZones' - ).replace(/([^:]\/)\/+/g, '$1'), + url: (rootUrl + '/dns/v1beta2/{+name}:cancel').replace( + /([^:]\/)\/+/g, + '$1' + ), method: 'POST', apiVersion: '', }, options ), params, - requiredParams: ['project'], - pathParams: ['project'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Deletes a previously created ManagedZone. + * 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`. * @example * ```js * // Before running the sample: @@ -2716,15 +4778,14 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.delete({ - * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. - * clientOperationId: 'placeholder-value', - * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID. - * managedZone: 'placeholder-value', - * // Identifies the project addressed by this request. - * project: 'placeholder-value', + * const res = await dns.operations.delete({ + * // The name of the operation resource to be deleted. + * name: 'projects/my-project/locations/my-location/operations/my-operation', * }); * console.log(res.data); + * + * // Example response + * // {} * } * * main().catch(e => { @@ -2740,50 +4801,51 @@ export namespace dns_v1beta2 { * @returns A promise if used with async/await, or void if used with a callback. */ delete( - params: Params$Resource$Managedzones$Delete, + params: Params$Resource$Operations$Delete, options: StreamMethodOptions ): Promise>; delete( - params?: Params$Resource$Managedzones$Delete, + params?: Params$Resource$Operations$Delete, options?: MethodOptions - ): Promise>; + ): Promise>; delete( - params: Params$Resource$Managedzones$Delete, + params: Params$Resource$Operations$Delete, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; delete( - params: Params$Resource$Managedzones$Delete, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + params: Params$Resource$Operations$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; delete( - params: Params$Resource$Managedzones$Delete, - callback: BodyResponseCallback + params: Params$Resource$Operations$Delete, + callback: BodyResponseCallback ): void; - delete(callback: BodyResponseCallback): void; + delete(callback: BodyResponseCallback): void; delete( paramsOrCallback?: - | Params$Resource$Managedzones$Delete - | BodyResponseCallback + | Params$Resource$Operations$Delete + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, - callback?: BodyResponseCallback | BodyResponseCallback + callback?: + BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Managedzones$Delete; + {}) as Params$Resource$Operations$Delete; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$Delete; + params = {} as Params$Resource$Operations$Delete; options = {}; } @@ -2796,32 +4858,32 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + - '/dns/v1beta2/projects/{project}/managedZones/{managedZone}' - ).replace(/([^:]\/)\/+/g, '$1'), + url: (rootUrl + '/dns/v1beta2/{+name}').replace( + /([^:]\/)\/+/g, + '$1' + ), method: 'DELETE', apiVersion: '', }, options ), params, - requiredParams: ['project', 'managedZone'], - pathParams: ['managedZone', 'project'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Fetches the representation of an existing ManagedZone. + * 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. * @example * ```js * // Before running the sample: @@ -2844,8 +4906,6 @@ export namespace dns_v1beta2 { * // Scopes can be specified either as an array or as a single, space-delimited string. * scopes: [ * 'https://www.googleapis.com/auth/cloud-platform', - * 'https://www.googleapis.com/auth/cloud-platform.read-only', - * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', * ], * }); @@ -2855,35 +4915,19 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.get({ - * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. - * clientOperationId: 'placeholder-value', - * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID. - * managedZone: 'placeholder-value', - * // Identifies the project addressed by this request. - * project: 'placeholder-value', + * const res = await dns.operations.get({ + * // The name of the operation resource. + * name: 'projects/my-project/locations/my-location/operations/my-operation', * }); * console.log(res.data); * * // Example response * // { - * // "cloudLoggingConfig": {}, - * // "creationTime": "my_creationTime", - * // "description": "my_description", - * // "dnsName": "my_dnsName", - * // "dnssecConfig": {}, - * // "forwardingConfig": {}, - * // "id": "my_id", - * // "kind": "my_kind", - * // "labels": {}, + * // "done": false, + * // "error": {}, + * // "metadata": {}, * // "name": "my_name", - * // "nameServerSet": "my_nameServerSet", - * // "nameServers": [], - * // "peeringConfig": {}, - * // "privateVisibilityConfig": {}, - * // "reverseLookupConfig": {}, - * // "serviceDirectoryConfig": {}, - * // "visibility": "my_visibility" + * // "response": {} * // } * } * @@ -2900,51 +4944,54 @@ export namespace dns_v1beta2 { * @returns A promise if used with async/await, or void if used with a callback. */ get( - params: Params$Resource$Managedzones$Get, + params: Params$Resource$Operations$Get, options: StreamMethodOptions ): Promise>; get( - params?: Params$Resource$Managedzones$Get, + params?: Params$Resource$Operations$Get, options?: MethodOptions - ): Promise>; + ): Promise>; get( - params: Params$Resource$Managedzones$Get, + params: Params$Resource$Operations$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; get( - params: Params$Resource$Managedzones$Get, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + params: Params$Resource$Operations$Get, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; get( - params: Params$Resource$Managedzones$Get, - callback: BodyResponseCallback + params: Params$Resource$Operations$Get, + callback: BodyResponseCallback + ): void; + get( + callback: BodyResponseCallback ): void; - get(callback: BodyResponseCallback): void; get( paramsOrCallback?: - | Params$Resource$Managedzones$Get - | BodyResponseCallback + | Params$Resource$Operations$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { - let params = (paramsOrCallback || {}) as Params$Resource$Managedzones$Get; + let params = (paramsOrCallback || {}) as Params$Resource$Operations$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$Get; + params = {} as Params$Resource$Operations$Get; options = {}; } @@ -2957,32 +5004,32 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + - '/dns/v1beta2/projects/{project}/managedZones/{managedZone}' - ).replace(/([^:]\/)\/+/g, '$1'), + url: (rootUrl + '/dns/v1beta2/{+name}').replace( + /([^:]\/)\/+/g, + '$1' + ), method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['project', 'managedZone'], - pathParams: ['managedZone', 'project'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set. + * Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. * @example * ```js * // Before running the sample: @@ -3005,8 +5052,6 @@ export namespace dns_v1beta2 { * // Scopes can be specified either as an array or as a single, space-delimited string. * scopes: [ * 'https://www.googleapis.com/auth/cloud-platform', - * 'https://www.googleapis.com/auth/cloud-platform.read-only', - * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', * ], * }); @@ -3016,26 +5061,25 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.getIamPolicy({ - * // 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. - * resource: 'projects/my-project/managedZones/my-managedZone', - * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "options": {} - * // } - * }, + * const res = await dns.operations.list({ + * // The standard list filter. + * filter: 'placeholder-value', + * // The name of the operation's parent resource. + * name: 'projects/my-project/locations/my-location', + * // The standard list page size. + * pageSize: 'placeholder-value', + * // The standard list page token. + * pageToken: 'placeholder-value', + * // When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation. + * returnPartialSuccess: 'placeholder-value', * }); * console.log(res.data); * * // Example response * // { - * // "auditConfigs": [], - * // "bindings": [], - * // "etag": "my_etag", - * // "version": 0 + * // "nextPageToken": "my_nextPageToken", + * // "operations": [], + * // "unreachable": [] * // } * } * @@ -3051,55 +5095,60 @@ export namespace dns_v1beta2 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - getIamPolicy( - params: Params$Resource$Managedzones$Getiampolicy, + list( + params: Params$Resource$Operations$List, options: StreamMethodOptions ): Promise>; - getIamPolicy( - params?: Params$Resource$Managedzones$Getiampolicy, + list( + params?: Params$Resource$Operations$List, options?: MethodOptions - ): Promise>; - getIamPolicy( - params: Params$Resource$Managedzones$Getiampolicy, - options: StreamMethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - getIamPolicy( - params: Params$Resource$Managedzones$Getiampolicy, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + ): Promise< + GaxiosResponseWithHTTP2 + >; + list( + params: Params$Resource$Operations$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - getIamPolicy( - params: Params$Resource$Managedzones$Getiampolicy, - callback: BodyResponseCallback + list( + params: Params$Resource$Operations$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - getIamPolicy( - callback: BodyResponseCallback + list( + params: Params$Resource$Operations$List, + callback: BodyResponseCallback ): void; - getIamPolicy( + list( + callback: BodyResponseCallback + ): void; + list( paramsOrCallback?: - | Params$Resource$Managedzones$Getiampolicy - | BodyResponseCallback + | Params$Resource$Operations$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise< + GaxiosResponseWithHTTP2 + > | Promise> { - let params = (paramsOrCallback || - {}) as Params$Resource$Managedzones$Getiampolicy; + let params = (paramsOrCallback || {}) as Params$Resource$Operations$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$Getiampolicy; + params = {} as Params$Resource$Operations$List; options = {}; } @@ -3112,32 +5161,82 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: (rootUrl + '/dns/v1beta2/{+resource}:getIamPolicy').replace( + url: (rootUrl + '/dns/v1beta2/{+name}/operations').replace( /([^:]\/)\/+/g, '$1' ), - method: 'POST', + method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['resource'], - pathParams: ['resource'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest( + parameters + ); } } + } + export interface Params$Resource$Operations$Cancel extends StandardParameters { /** - * Enumerates ManagedZones that have been created but not yet deleted. + * The name of the operation resource to be cancelled. + */ + name?: string; + } + export interface Params$Resource$Operations$Delete extends StandardParameters { + /** + * The name of the operation resource to be deleted. + */ + name?: string; + } + export interface Params$Resource$Operations$Get extends StandardParameters { + /** + * The name of the operation resource. + */ + name?: string; + } + export interface Params$Resource$Operations$List extends StandardParameters { + /** + * The standard list filter. + */ + filter?: string; + /** + * The name of the operation's parent resource. + */ + name?: string; + /** + * The standard list page size. + */ + pageSize?: number; + /** + * The standard list page token. + */ + pageToken?: string; + /** + * When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation. + */ + returnPartialSuccess?: boolean; + } + + export class Resource$Outboundendpoints { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates a new Outbound Endpoint. * @example * ```js * // Before running the sample: @@ -3160,8 +5259,6 @@ export namespace dns_v1beta2 { * // Scopes can be specified either as an array or as a single, space-delimited string. * scopes: [ * 'https://www.googleapis.com/auth/cloud-platform', - * 'https://www.googleapis.com/auth/cloud-platform.read-only', - * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', * ], * }); @@ -3171,23 +5268,42 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.list({ - * // Restricts the list to return only zones with this domain name. - * dnsName: 'placeholder-value', - * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return. - * maxResults: 'placeholder-value', - * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request. - * pageToken: 'placeholder-value', - * // Identifies the project addressed by this request. - * project: 'placeholder-value', + * const res = await dns.outboundEndpoints.create({ + * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * clientOperationId: 'placeholder-value', + * // Required. The ID to use for the OutboundEndpoint, which will become the final component of the OutboundEndpoint's resource name. + * outboundEndpointId: 'placeholder-value', + * // Required. The parent project and location where this OutboundEndpoint will be created. Format: projects/{project\}/locations/{location\} + * parent: 'projects/my-project/locations/my-location', + * // Optional. An optional request ID to identify requests. + * requestId: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "annotations": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "endpointIp": "my_endpointIp", + * // "labels": {}, + * // "name": "my_name", + * // "network": "my_network", + * // "subnetwork": "my_subnetwork", + * // "tags": {}, + * // "updateTime": "my_updateTime" + * // } + * }, * }); * console.log(res.data); * * // Example response * // { - * // "kind": "my_kind", - * // "managedZones": [], - * // "nextPageToken": "my_nextPageToken" + * // "done": false, + * // "error": {}, + * // "metadata": {}, + * // "name": "my_name", + * // "response": {} * // } * } * @@ -3203,54 +5319,56 @@ export namespace dns_v1beta2 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - list( - params: Params$Resource$Managedzones$List, + create( + params: Params$Resource$Outboundendpoints$Create, options: StreamMethodOptions ): Promise>; - list( - params?: Params$Resource$Managedzones$List, + create( + params?: Params$Resource$Outboundendpoints$Create, options?: MethodOptions - ): Promise>; - list( - params: Params$Resource$Managedzones$List, + ): Promise>; + create( + params: Params$Resource$Outboundendpoints$Create, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - list( - params: Params$Resource$Managedzones$List, + create( + params: Params$Resource$Outboundendpoints$Create, options: - MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - list( - params: Params$Resource$Managedzones$List, - callback: BodyResponseCallback + create( + params: Params$Resource$Outboundendpoints$Create, + callback: BodyResponseCallback ): void; - list(callback: BodyResponseCallback): void; - list( + create( + callback: BodyResponseCallback + ): void; + create( paramsOrCallback?: - | Params$Resource$Managedzones$List - | BodyResponseCallback + | Params$Resource$Outboundendpoints$Create + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Managedzones$List; + {}) as Params$Resource$Outboundendpoints$Create; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$List; + params = {} as Params$Resource$Outboundendpoints$Create; options = {}; } @@ -3263,31 +5381,32 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + '/dns/v1beta2/projects/{project}/managedZones' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'GET', + url: (rootUrl + '/dns/v1beta2/{+parent}/outboundEndpoints').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', apiVersion: '', }, options ), params, - requiredParams: ['project'], - pathParams: ['project'], + requiredParams: ['parent'], + pathParams: ['parent'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Applies a partial update to an existing ManagedZone. + * Deletes a previously created Outbound Endpoint. * @example * ```js * // Before running the sample: @@ -3319,50 +5438,23 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.patch({ + * const res = await dns.outboundEndpoints.delete({ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. * clientOperationId: 'placeholder-value', - * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID. - * managedZone: 'placeholder-value', - * // Identifies the project addressed by this request. - * project: 'placeholder-value', - * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "cloudLoggingConfig": {}, - * // "creationTime": "my_creationTime", - * // "description": "my_description", - * // "dnsName": "my_dnsName", - * // "dnssecConfig": {}, - * // "forwardingConfig": {}, - * // "id": "my_id", - * // "kind": "my_kind", - * // "labels": {}, - * // "name": "my_name", - * // "nameServerSet": "my_nameServerSet", - * // "nameServers": [], - * // "peeringConfig": {}, - * // "privateVisibilityConfig": {}, - * // "reverseLookupConfig": {}, - * // "serviceDirectoryConfig": {}, - * // "visibility": "my_visibility" - * // } - * }, + * // Required. The name of the OutboundEndpoint to delete. Format: projects/{project\}/locations/{location\}/outboundEndpoints/{outboundEndpoint\} + * name: 'projects/my-project/locations/my-location/outboundEndpoints/my-outboundEndpoint', + * // Optional. An optional request ID to identify requests. + * requestId: 'placeholder-value', * }); * console.log(res.data); * * // Example response * // { - * // "dnsKeyContext": {}, - * // "id": "my_id", - * // "kind": "my_kind", - * // "startTime": "my_startTime", - * // "status": "my_status", - * // "type": "my_type", - * // "user": "my_user", - * // "zoneContext": {} + * // "done": false, + * // "error": {}, + * // "metadata": {}, + * // "name": "my_name", + * // "response": {} * // } * } * @@ -3378,52 +5470,56 @@ export namespace dns_v1beta2 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - patch( - params: Params$Resource$Managedzones$Patch, + delete( + params: Params$Resource$Outboundendpoints$Delete, options: StreamMethodOptions ): Promise>; - patch( - params?: Params$Resource$Managedzones$Patch, + delete( + params?: Params$Resource$Outboundendpoints$Delete, options?: MethodOptions - ): Promise>; - patch( - params: Params$Resource$Managedzones$Patch, + ): Promise>; + delete( + params: Params$Resource$Outboundendpoints$Delete, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - patch( - params: Params$Resource$Managedzones$Patch, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + delete( + params: Params$Resource$Outboundendpoints$Delete, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - patch( - params: Params$Resource$Managedzones$Patch, - callback: BodyResponseCallback + delete( + params: Params$Resource$Outboundendpoints$Delete, + callback: BodyResponseCallback ): void; - patch(callback: BodyResponseCallback): void; - patch( + delete( + callback: BodyResponseCallback + ): void; + delete( paramsOrCallback?: - | Params$Resource$Managedzones$Patch - | BodyResponseCallback + | Params$Resource$Outboundendpoints$Delete + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - BodyResponseCallback | BodyResponseCallback + | BodyResponseCallback + | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Managedzones$Patch; + {}) as Params$Resource$Outboundendpoints$Delete; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$Patch; + params = {} as Params$Resource$Outboundendpoints$Delete; options = {}; } @@ -3436,32 +5532,32 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + - '/dns/v1beta2/projects/{project}/managedZones/{managedZone}' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'PATCH', + url: (rootUrl + '/dns/v1beta2/{+name}').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'DELETE', apiVersion: '', }, options ), params, - requiredParams: ['project', 'managedZone'], - pathParams: ['managedZone', 'project'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Fetches the representation of an existing Outbound Endpoint. * @example * ```js * // Before running the sample: @@ -3484,6 +5580,8 @@ export namespace dns_v1beta2 { * // Scopes can be specified either as an array or as a single, space-delimited string. * scopes: [ * 'https://www.googleapis.com/auth/cloud-platform', + * 'https://www.googleapis.com/auth/cloud-platform.read-only', + * 'https://www.googleapis.com/auth/ndev.clouddns.readonly', * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite', * ], * }); @@ -3493,27 +5591,26 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.setIamPolicy({ - * // 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. - * resource: 'projects/my-project/managedZones/my-managedZone', - * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "policy": {}, - * // "updateMask": "my_updateMask" - * // } - * }, + * const res = await dns.outboundEndpoints.get({ + * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * clientOperationId: 'placeholder-value', + * // Required. The name of the OutboundEndpoint to retrieve. Format: projects/{project\}/locations/{location\}/outboundEndpoints/{outboundEndpoint\} + * name: 'projects/my-project/locations/my-location/outboundEndpoints/my-outboundEndpoint', * }); * console.log(res.data); * * // Example response * // { - * // "auditConfigs": [], - * // "bindings": [], - * // "etag": "my_etag", - * // "version": 0 + * // "annotations": {}, + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "endpointIp": "my_endpointIp", + * // "labels": {}, + * // "name": "my_name", + * // "network": "my_network", + * // "subnetwork": "my_subnetwork", + * // "tags": {}, + * // "updateTime": "my_updateTime" * // } * } * @@ -3529,55 +5626,53 @@ export namespace dns_v1beta2 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - setIamPolicy( - params: Params$Resource$Managedzones$Setiampolicy, + get( + params: Params$Resource$Outboundendpoints$Get, options: StreamMethodOptions ): Promise>; - setIamPolicy( - params?: Params$Resource$Managedzones$Setiampolicy, + get( + params?: Params$Resource$Outboundendpoints$Get, options?: MethodOptions - ): Promise>; - setIamPolicy( - params: Params$Resource$Managedzones$Setiampolicy, + ): Promise>; + get( + params: Params$Resource$Outboundendpoints$Get, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - setIamPolicy( - params: Params$Resource$Managedzones$Setiampolicy, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback - ): void; - setIamPolicy( - params: Params$Resource$Managedzones$Setiampolicy, - callback: BodyResponseCallback + get( + params: Params$Resource$Outboundendpoints$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - setIamPolicy( - callback: BodyResponseCallback + get( + params: Params$Resource$Outboundendpoints$Get, + callback: BodyResponseCallback ): void; - setIamPolicy( + get(callback: BodyResponseCallback): void; + get( paramsOrCallback?: - | Params$Resource$Managedzones$Setiampolicy - | BodyResponseCallback + | Params$Resource$Outboundendpoints$Get + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Managedzones$Setiampolicy; + {}) as Params$Resource$Outboundendpoints$Get; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$Setiampolicy; + params = {} as Params$Resource$Outboundendpoints$Get; options = {}; } @@ -3590,32 +5685,32 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: (rootUrl + '/dns/v1beta2/{+resource}:setIamPolicy').replace( + url: (rootUrl + '/dns/v1beta2/{+name}').replace( /([^:]\/)\/+/g, '$1' ), - method: 'POST', + method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['resource'], - pathParams: ['resource'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Returns permissions that a caller has on the specified resource. If the resource does not exist, this returns 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. + * Enumerates all Outbound Endpoints associated with a project. * @example * ```js * // Before running the sample: @@ -3649,23 +5744,22 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.testIamPermissions({ - * // 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. - * resource: 'projects/my-project/managedZones/my-managedZone', - * - * // Request body metadata - * requestBody: { - * // request body parameters - * // { - * // "permissions": [] - * // } - * }, + * const res = await dns.outboundEndpoints.list({ + * clientOperationId: 'placeholder-value', + * // Optional. The maximum number of results to return. + * pageSize: 'placeholder-value', + * // Optional. A page token received from a previous List call. + * pageToken: 'placeholder-value', + * // Required. The parent project and location from which to list resources. Format: projects/{project\}/locations/{location\} + * parent: 'projects/my-project/locations/my-location', * }); * console.log(res.data); * * // Example response * // { - * // "permissions": [] + * // "nextPageToken": "my_nextPageToken", + * // "outboundEndpoints": [], + * // "unreachable": [] * // } * } * @@ -3681,61 +5775,57 @@ export namespace dns_v1beta2 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - testIamPermissions( - params: Params$Resource$Managedzones$Testiampermissions, + list( + params: Params$Resource$Outboundendpoints$List, options: StreamMethodOptions ): Promise>; - testIamPermissions( - params?: Params$Resource$Managedzones$Testiampermissions, + list( + params?: Params$Resource$Outboundendpoints$List, options?: MethodOptions - ): Promise< - GaxiosResponseWithHTTP2 - >; - testIamPermissions( - params: Params$Resource$Managedzones$Testiampermissions, + ): Promise>; + list( + params: Params$Resource$Outboundendpoints$List, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - testIamPermissions( - params: Params$Resource$Managedzones$Testiampermissions, + list( + params: Params$Resource$Outboundendpoints$List, options: | MethodOptions - | BodyResponseCallback, - callback: BodyResponseCallback + | BodyResponseCallback, + callback: BodyResponseCallback ): void; - testIamPermissions( - params: Params$Resource$Managedzones$Testiampermissions, - callback: BodyResponseCallback + list( + params: Params$Resource$Outboundendpoints$List, + callback: BodyResponseCallback ): void; - testIamPermissions( - callback: BodyResponseCallback + list( + callback: BodyResponseCallback ): void; - testIamPermissions( + list( paramsOrCallback?: - | Params$Resource$Managedzones$Testiampermissions - | BodyResponseCallback + | Params$Resource$Outboundendpoints$List + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback ): | void - | Promise< - GaxiosResponseWithHTTP2 - > + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Managedzones$Testiampermissions; + {}) as Params$Resource$Outboundendpoints$List; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$Testiampermissions; + params = {} as Params$Resource$Outboundendpoints$List; options = {}; } @@ -3748,33 +5838,34 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + '/dns/v1beta2/{+resource}:testIamPermissions' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'POST', + url: (rootUrl + '/dns/v1beta2/{+parent}/outboundEndpoints').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', apiVersion: '', }, options ), params, - requiredParams: ['resource'], - pathParams: ['resource'], + requiredParams: ['parent'], + pathParams: ['parent'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest( + return createAPIRequest( parameters ); } } /** - * Updates an existing ManagedZone. + * Updates an existing Outbound Endpoint. * @example * ```js * // Before running the sample: @@ -3806,35 +5897,30 @@ export namespace dns_v1beta2 { * google.options({auth: authClient}); * * // Do the magic - * const res = await dns.managedZones.update({ + * const res = await dns.outboundEndpoints.patch({ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. * clientOperationId: 'placeholder-value', - * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID. - * managedZone: 'placeholder-value', - * // Identifies the project addressed by this request. - * project: 'placeholder-value', + * // Identifier. The resource name of the OutboundEndpoint. Format: `projects/{project\}/locations/{location\}/outboundEndpoints/{outboundEndpoint\}` + * name: 'projects/my-project/locations/my-location/outboundEndpoints/my-outboundEndpoint', + * // Optional. An optional request ID to identify requests. + * requestId: 'placeholder-value', + * // Required. The list of fields to be updated. + * updateMask: 'placeholder-value', * * // Request body metadata * requestBody: { * // request body parameters * // { - * // "cloudLoggingConfig": {}, - * // "creationTime": "my_creationTime", + * // "annotations": {}, + * // "createTime": "my_createTime", * // "description": "my_description", - * // "dnsName": "my_dnsName", - * // "dnssecConfig": {}, - * // "forwardingConfig": {}, - * // "id": "my_id", - * // "kind": "my_kind", + * // "endpointIp": "my_endpointIp", * // "labels": {}, * // "name": "my_name", - * // "nameServerSet": "my_nameServerSet", - * // "nameServers": [], - * // "peeringConfig": {}, - * // "privateVisibilityConfig": {}, - * // "reverseLookupConfig": {}, - * // "serviceDirectoryConfig": {}, - * // "visibility": "my_visibility" + * // "network": "my_network", + * // "subnetwork": "my_subnetwork", + * // "tags": {}, + * // "updateTime": "my_updateTime" * // } * }, * }); @@ -3842,14 +5928,11 @@ export namespace dns_v1beta2 { * * // Example response * // { - * // "dnsKeyContext": {}, - * // "id": "my_id", - * // "kind": "my_kind", - * // "startTime": "my_startTime", - * // "status": "my_status", - * // "type": "my_type", - * // "user": "my_user", - * // "zoneContext": {} + * // "done": false, + * // "error": {}, + * // "metadata": {}, + * // "name": "my_name", + * // "response": {} * // } * } * @@ -3865,52 +5948,56 @@ export namespace dns_v1beta2 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - update( - params: Params$Resource$Managedzones$Update, + patch( + params: Params$Resource$Outboundendpoints$Patch, options: StreamMethodOptions ): Promise>; - update( - params?: Params$Resource$Managedzones$Update, + patch( + params?: Params$Resource$Outboundendpoints$Patch, options?: MethodOptions - ): Promise>; - update( - params: Params$Resource$Managedzones$Update, + ): Promise>; + patch( + params: Params$Resource$Outboundendpoints$Patch, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - update( - params: Params$Resource$Managedzones$Update, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + patch( + params: Params$Resource$Outboundendpoints$Patch, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - update( - params: Params$Resource$Managedzones$Update, - callback: BodyResponseCallback + patch( + params: Params$Resource$Outboundendpoints$Patch, + callback: BodyResponseCallback ): void; - update(callback: BodyResponseCallback): void; - update( + patch( + callback: BodyResponseCallback + ): void; + patch( paramsOrCallback?: - | Params$Resource$Managedzones$Update - | BodyResponseCallback + | Params$Resource$Outboundendpoints$Patch + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - BodyResponseCallback | BodyResponseCallback + | BodyResponseCallback + | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Managedzones$Update; + {}) as Params$Resource$Outboundendpoints$Patch; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; - params = {} as Params$Resource$Managedzones$Update; + params = {} as Params$Resource$Outboundendpoints$Patch; options = {}; } @@ -3923,162 +6010,118 @@ export namespace dns_v1beta2 { const parameters = { options: Object.assign( { - url: ( - rootUrl + - '/dns/v1beta2/projects/{project}/managedZones/{managedZone}' - ).replace(/([^:]\/)\/+/g, '$1'), - method: 'PUT', + url: (rootUrl + '/dns/v1beta2/{+name}').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'PATCH', apiVersion: '', }, options ), params, - requiredParams: ['project', 'managedZone'], - pathParams: ['managedZone', 'project'], + requiredParams: ['name'], + pathParams: ['name'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } } - export interface Params$Resource$Managedzones$Create extends StandardParameters { + export interface Params$Resource$Outboundendpoints$Create extends StandardParameters { /** * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. */ clientOperationId?: string; /** - * Identifies the project addressed by this request. - */ - project?: string; - - /** - * Request body metadata + * Required. The ID to use for the OutboundEndpoint, which will become the final component of the OutboundEndpoint's resource name. */ - requestBody?: Schema$ManagedZone; - } - export interface Params$Resource$Managedzones$Delete extends StandardParameters { + outboundEndpointId?: string; /** - * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * Required. The parent project and location where this OutboundEndpoint will be created. Format: projects/{project\}/locations/{location\} */ - clientOperationId?: string; + parent?: string; /** - * Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + * Optional. An optional request ID to identify requests. */ - managedZone?: string; + requestId?: string; + /** - * Identifies the project addressed by this request. + * Request body metadata */ - project?: string; + requestBody?: Schema$OutboundEndpoint; } - export interface Params$Resource$Managedzones$Get extends StandardParameters { + export interface Params$Resource$Outboundendpoints$Delete extends StandardParameters { /** * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. */ clientOperationId?: string; /** - * Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + * Required. The name of the OutboundEndpoint to delete. Format: projects/{project\}/locations/{location\}/outboundEndpoints/{outboundEndpoint\} */ - managedZone?: string; + name?: string; /** - * Identifies the project addressed by this request. + * Optional. An optional request ID to identify requests. */ - project?: string; + requestId?: string; } - export interface Params$Resource$Managedzones$Getiampolicy extends StandardParameters { + export interface Params$Resource$Outboundendpoints$Get extends StandardParameters { /** - * 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. + * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. */ - resource?: string; - + clientOperationId?: string; /** - * Request body metadata + * Required. The name of the OutboundEndpoint to retrieve. Format: projects/{project\}/locations/{location\}/outboundEndpoints/{outboundEndpoint\} */ - requestBody?: Schema$GoogleIamV1GetIamPolicyRequest; + name?: string; } - export interface Params$Resource$Managedzones$List extends StandardParameters { + export interface Params$Resource$Outboundendpoints$List extends StandardParameters { /** - * Restricts the list to return only zones with this domain name. + * */ - dnsName?: string; + clientOperationId?: string; /** - * Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return. + * Optional. The maximum number of results to return. */ - maxResults?: number; + pageSize?: number; /** - * Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request. + * Optional. A page token received from a previous List call. */ pageToken?: string; /** - * Identifies the project addressed by this request. + * Required. The parent project and location from which to list resources. Format: projects/{project\}/locations/{location\} */ - project?: string; + parent?: string; } - export interface Params$Resource$Managedzones$Patch extends StandardParameters { + export interface Params$Resource$Outboundendpoints$Patch extends StandardParameters { /** * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. */ clientOperationId?: string; /** - * Identifies the managed zone addressed by this request. Can be the managed zone name or ID. - */ - managedZone?: string; - /** - * Identifies the project addressed by this request. - */ - project?: string; - - /** - * Request body metadata - */ - requestBody?: Schema$ManagedZone; - } - export interface Params$Resource$Managedzones$Setiampolicy extends StandardParameters { - /** - * 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. - */ - resource?: string; - - /** - * Request body metadata - */ - requestBody?: Schema$GoogleIamV1SetIamPolicyRequest; - } - export interface Params$Resource$Managedzones$Testiampermissions extends StandardParameters { - /** - * 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. - */ - resource?: string; - - /** - * Request body metadata - */ - requestBody?: Schema$GoogleIamV1TestIamPermissionsRequest; - } - export interface Params$Resource$Managedzones$Update extends StandardParameters { - /** - * For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection. + * Identifier. The resource name of the OutboundEndpoint. Format: `projects/{project\}/locations/{location\}/outboundEndpoints/{outboundEndpoint\}` */ - clientOperationId?: string; + name?: string; /** - * Identifies the managed zone addressed by this request. Can be the managed zone name or ID. + * Optional. An optional request ID to identify requests. */ - managedZone?: string; + requestId?: string; /** - * Identifies the project addressed by this request. + * Required. The list of fields to be updated. */ - project?: string; + updateMask?: string; /** * Request body metadata */ - requestBody?: Schema$ManagedZone; + requestBody?: Schema$OutboundEndpoint; } export class Resource$Policies { diff --git a/src/apis/docs/v1.ts b/src/apis/docs/v1.ts index feef0e6acf..8faad8e845 100644 --- a/src/apis/docs/v1.ts +++ b/src/apis/docs/v1.ts @@ -125,7 +125,7 @@ export namespace docs_v1 { } /** - * Accepts a suggestion. Returns a 403 forbidden error if the requesting user does not have edit access to the document. [Developer Preview](https://developers.google.com/workspace/preview). + * Accepts a suggestion. Returns a 403 forbidden error if the requesting user does not have edit access to the document. */ export interface Schema$AcceptSuggestionRequest { /** @@ -134,7 +134,7 @@ export namespace docs_v1 { suggestionId?: string | null; } /** - * Inserts a reply Post into a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview). + * Inserts a reply Post into a CommentThread or SuggestionThread. */ export interface Schema$AddCommentReplyRequest { /** @@ -151,7 +151,7 @@ export namespace docs_v1 { suggestionId?: string | null; } /** - * Response message for adding a reply. [Developer Preview](https://developers.google.com/workspace/preview). + * Response message for adding a reply. */ export interface Schema$AddCommentReplyResponse { /** @@ -240,7 +240,7 @@ export namespace docs_v1 { */ export interface Schema$BatchUpdateDocumentResponse { /** - * Whether comment updates were applied in the batch request. [Developer Preview](https://developers.google.com/workspace/preview). + * Whether comment updates were applied in the batch request. */ commentUpdateState?: string | null; /** @@ -252,7 +252,7 @@ export namespace docs_v1 { */ replies?: Schema$Response[]; /** - * The suggestions which were affected by each update. This maps 1:1 with the updates. [Developer Preview](https://developers.google.com/workspace/preview). + * The suggestions which were affected by each update. This maps 1:1 with the updates. */ suggestionResponses?: Schema$SuggestionResponse[]; /** @@ -349,7 +349,7 @@ export namespace docs_v1 { textStyle?: Schema$TextStyle; } /** - * One or more locations in the document that are tied to CommentThreads with the same anchorId. Note: Multiple anchors may refer to the same location. [Developer Preview](https://developers.google.com/workspace/preview). + * One or more locations in the document that are tied to CommentThreads with the same anchorId. Note: Multiple anchors may refer to the same location. */ export interface Schema$CommentAnchor { /** @@ -362,7 +362,7 @@ export namespace docs_v1 { ranges?: Schema$Range[]; } /** - * Represents a single comment thread. [Developer Preview](https://developers.google.com/workspace/preview). + * Represents a single comment thread. */ export interface Schema$CommentThread { /** @@ -655,7 +655,7 @@ export namespace docs_v1 { timeZoneIdSuggested?: boolean | null; } /** - * Deletes a reply Post from a CommentThread or SuggestionThread. Returns a 400 bad request error if: - The requesting user is not the author of the post. - The reply post contains an action. - The reply post contains an assignee. [Developer Preview](https://developers.google.com/workspace/preview). + * Deletes a reply Post from a CommentThread or SuggestionThread. Returns a 400 bad request error if: - The requesting user is not the author of the post. - The reply post contains an action. - The reply post contains an assignee. */ export interface Schema$DeleteCommentReplyRequest { /** @@ -672,7 +672,7 @@ export namespace docs_v1 { suggestionId?: string | null; } /** - * Deletes a CommentThread. Returns a 400 bad request error if the requesting user is not the author of the headPost. [Developer Preview](https://developers.google.com/workspace/preview). + * Deletes a CommentThread. Returns a 400 bad request error if the requesting user is not the author of the headPost. */ export interface Schema$DeleteCommentRequest { /** @@ -768,7 +768,7 @@ export namespace docs_v1 { tabId?: string | null; } /** - * Deletes a suggestion. Returns a 403 forbidden error if the requesting user is not the author of the suggestion. [Developer Preview](https://developers.google.com/workspace/preview). + * Deletes a suggestion. Returns a 403 forbidden error if the requesting user is not the author of the suggestion. */ export interface Schema$DeleteSuggestionRequest { /** @@ -825,11 +825,11 @@ export namespace docs_v1 { */ body?: Schema$Body; /** - * Output only. The comments associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.com/workspace/preview). + * Output only. The comments associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). */ comments?: Schema$CommentThread[]; /** - * Output only. The comments view mode applied to the document. [Developer Preview](https://developers.google.com/workspace/preview). + * Output only. The comments view mode applied to the document. */ commentsViewMode?: string | null; /** @@ -889,7 +889,7 @@ export namespace docs_v1 { [key: string]: Schema$SuggestedNamedStyles; } | null; /** - * Output only. The suggestions associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.com/workspace/preview). + * Output only. The suggestions associated with the document. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). */ suggestions?: Schema$SuggestionThread[]; /** @@ -1089,7 +1089,7 @@ export namespace docs_v1 { */ body?: Schema$Body; /** - * The comment anchors in a document tab, keyed by anchor ID. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.com/workspace/preview). + * The comment anchors in a document tab, keyed by anchor ID. Only populated if the commentsViewMode parameter is set to require comments (such as `COMMENTS_VIEW_MODE_INCLUDED`). */ commentAnchors?: {[key: string]: Schema$CommentAnchor} | null; /** @@ -1697,7 +1697,7 @@ export namespace docs_v1 { embeddedObjectSuggestionState?: Schema$EmbeddedObjectSuggestionState; } /** - * Inserts a CommentThread into the document. [Developer Preview](https://developers.google.com/workspace/preview). + * Inserts a CommentThread into the document. */ export interface Schema$InsertCommentRequest { /** @@ -1714,7 +1714,7 @@ export namespace docs_v1 { range?: Schema$Range; } /** - * Response message for inserting a comment. [Developer Preview](https://developers.google.com/workspace/preview). + * Response message for inserting a comment. */ export interface Schema$InsertCommentResponse { /** @@ -2693,7 +2693,7 @@ export namespace docs_v1 { positioningSuggestionState?: Schema$PositionedObjectPositioningSuggestionState; } /** - * Represents a single post in a comment or suggestion thread. [Developer Preview](https://developers.google.com/workspace/preview). + * Represents a single post in a comment or suggestion thread. */ export interface Schema$Post { /** @@ -2750,7 +2750,7 @@ export namespace docs_v1 { updateTime?: string | null; } /** - * Represents a user who authored a comment or suggestion post. [Developer Preview](https://developers.google.com/workspace/preview). + * Represents a user who authored a comment or suggestion post. */ export interface Schema$PostAuthor { /** @@ -2792,7 +2792,7 @@ export namespace docs_v1 { tabId?: string | null; } /** - * Rejects a suggestion. Returns a 403 forbidden error if the requesting user does not have edit access to the document and is not the author of the suggestion. [Developer Preview](https://developers.google.com/workspace/preview). + * Rejects a suggestion. Returns a 403 forbidden error if the requesting user does not have edit access to the document and is not the author of the suggestion. */ export interface Schema$RejectSuggestionRequest { /** @@ -2873,11 +2873,11 @@ export namespace docs_v1 { */ export interface Schema$Request { /** - * Accepts a suggestion. [Developer Preview](https://developers.google.com/workspace/preview). + * Accepts a suggestion. */ acceptSuggestion?: Schema$AcceptSuggestionRequest; /** - * Adds a reply to a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview). + * Adds a reply to a CommentThread or SuggestionThread. */ addCommentReply?: Schema$AddCommentReplyRequest; /** @@ -2909,11 +2909,11 @@ export namespace docs_v1 { */ createParagraphBullets?: Schema$CreateParagraphBulletsRequest; /** - * Deletes a CommentThread. [Developer Preview](https://developers.google.com/workspace/preview). + * Deletes a CommentThread. */ deleteComment?: Schema$DeleteCommentRequest; /** - * Deletes a reply Post from a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview). + * Deletes a reply Post from a CommentThread or SuggestionThread. */ deleteCommentReply?: Schema$DeleteCommentReplyRequest; /** @@ -2945,7 +2945,7 @@ export namespace docs_v1 { */ deletePositionedObject?: Schema$DeletePositionedObjectRequest; /** - * Deletes a suggestion. [Developer Preview](https://developers.google.com/workspace/preview). + * Deletes a suggestion. */ deleteSuggestion?: Schema$DeleteSuggestionRequest; /** @@ -2961,7 +2961,7 @@ export namespace docs_v1 { */ deleteTableRow?: Schema$DeleteTableRowRequest; /** - * Inserts a CommentThread into the document. [Developer Preview](https://developers.google.com/workspace/preview). + * Inserts a CommentThread into the document. */ insertComment?: Schema$InsertCommentRequest; /** @@ -3017,7 +3017,7 @@ export namespace docs_v1 { */ pinTableHeaderRows?: Schema$PinTableHeaderRowsRequest; /** - * Rejects a suggestion. [Developer Preview](https://developers.google.com/workspace/preview). + * Rejects a suggestion. */ rejectSuggestion?: Schema$RejectSuggestionRequest; /** @@ -3037,7 +3037,7 @@ export namespace docs_v1 { */ unmergeTableCells?: Schema$UnmergeTableCellsRequest; /** - * Updates an existing post (head post or reply) of a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview). + * Updates an existing post (head post or reply) of a CommentThread or SuggestionThread. */ updateCommentPost?: Schema$UpdateCommentPostRequest; /** @@ -3090,7 +3090,7 @@ export namespace docs_v1 { */ export interface Schema$Response { /** - * The result of adding a reply to a comment or suggestion. [Developer Preview](https://developers.google.com/workspace/preview). + * The result of adding a reply to a comment or suggestion. */ addCommentReply?: Schema$AddCommentReplyResponse; /** @@ -3118,7 +3118,7 @@ export namespace docs_v1 { */ createNamedRange?: Schema$CreateNamedRangeResponse; /** - * The result of inserting a comment. [Developer Preview](https://developers.google.com/workspace/preview). + * The result of inserting a comment. */ insertComment?: Schema$InsertCommentResponse; /** @@ -3600,7 +3600,7 @@ export namespace docs_v1 { textStyleSuggestionState?: Schema$TextStyleSuggestionState; } /** - * The suggestions which were affected by a given update. [Developer Preview](https://developers.google.com/workspace/preview). + * The suggestions which were affected by a given update. */ export interface Schema$SuggestionResponse { /** @@ -3625,7 +3625,7 @@ export namespace docs_v1 { updatedSummarySuggestionIds?: string[] | null; } /** - * Represents a single suggestion thread. Suggestion threads are created as a byproduct of saving changes to the document while in suggestion mode, and cannot be created directly. [Developer Preview](https://developers.google.com/workspace/preview). + * Represents a single suggestion thread. Suggestion threads are created as a byproduct of saving changes to the document while in suggestion mode, and cannot be created directly. */ export interface Schema$SuggestionThread { /** @@ -4177,7 +4177,7 @@ export namespace docs_v1 { tableRange?: Schema$TableRange; } /** - * Updates a Post in a CommentThread or SuggestionThread. Returns a 400 bad request error if: - The post is the headPost of a SuggestionThread. - The requesting user is not the author of the post. [Developer Preview](https://developers.google.com/workspace/preview). + * Updates a Post in a CommentThread or SuggestionThread. Returns a 400 bad request error if: - The post is the headPost of a SuggestionThread. - The requesting user is not the author of the post. */ export interface Schema$UpdateCommentPostRequest { /** @@ -4430,7 +4430,7 @@ export namespace docs_v1 { */ targetRevisionId?: string | null; /** - * How the request updates should be applied to the document. If unspecified, the request updates will be applied as normal edits. [Developer Preview](https://developers.google.com/workspace/preview). + * How the request updates should be applied to the document. If unspecified, the request updates will be applied as normal edits. */ writeMode?: string | null; } @@ -4815,7 +4815,7 @@ export namespace docs_v1 { * * // Do the magic * const res = await docs.documents.get({ - * // The comments view mode to apply to the document. This allows viewing the document with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED is used. If you set comments_view_mode to any value, you must also set include_tabs_content to `true` or use a field mask that references the Document.tabs field (or any subfield). If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED, you must also explicitly set suggestions_view_mode to SUGGESTIONS_INLINE. If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED or COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, you may not set suggestions_view_mode to PREVIEW_WITHOUT_SUGGESTIONS or PREVIEW_SUGGESTIONS_ACCEPTED. [Developer Preview](https://developers.google.com/workspace/preview). + * // The comments view mode to apply to the document. This allows viewing the document with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED is used. If you set comments_view_mode to any value, you must also set include_tabs_content to `true` or use a field mask that references the Document.tabs field (or any subfield). If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED, you must also explicitly set suggestions_view_mode to SUGGESTIONS_INLINE. If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED or COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, you may not set suggestions_view_mode to PREVIEW_WITHOUT_SUGGESTIONS or PREVIEW_SUGGESTIONS_ACCEPTED. * commentsViewMode: 'placeholder-value', * // The ID of the document to retrieve. * documentId: 'placeholder-value', @@ -4964,7 +4964,7 @@ export namespace docs_v1 { } export interface Params$Resource$Documents$Get extends StandardParameters { /** - * The comments view mode to apply to the document. This allows viewing the document with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED is used. If you set comments_view_mode to any value, you must also set include_tabs_content to `true` or use a field mask that references the Document.tabs field (or any subfield). If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED, you must also explicitly set suggestions_view_mode to SUGGESTIONS_INLINE. If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED or COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, you may not set suggestions_view_mode to PREVIEW_WITHOUT_SUGGESTIONS or PREVIEW_SUGGESTIONS_ACCEPTED. [Developer Preview](https://developers.google.com/workspace/preview). + * The comments view mode to apply to the document. This allows viewing the document with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED is used. If you set comments_view_mode to any value, you must also set include_tabs_content to `true` or use a field mask that references the Document.tabs field (or any subfield). If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED, you must also explicitly set suggestions_view_mode to SUGGESTIONS_INLINE. If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED or COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, you may not set suggestions_view_mode to PREVIEW_WITHOUT_SUGGESTIONS or PREVIEW_SUGGESTIONS_ACCEPTED. */ commentsViewMode?: string; /** diff --git a/src/apis/eventarc/v1.ts b/src/apis/eventarc/v1.ts index 662ac128b8..bfdc5cbea6 100644 --- a/src/apis/eventarc/v1.ts +++ b/src/apis/eventarc/v1.ts @@ -1283,7 +1283,7 @@ export namespace eventarc_v1 { */ eventDataContentType?: string | null; /** - * Required. Unordered list. The list of filters that applies to event attributes. Only events that match all the provided filters are sent to the destination. + * Optional. Unordered list. The list of filters that applies to event attributes. Only events that match all the provided filters are sent to the destination. */ eventFilters?: Schema$EventFilter[]; /** diff --git a/src/apis/file/v1beta1.ts b/src/apis/file/v1beta1.ts index 4e163231eb..437f9dd569 100644 --- a/src/apis/file/v1beta1.ts +++ b/src/apis/file/v1beta1.ts @@ -227,6 +227,27 @@ export namespace file_v1beta1 { * The request message for Operations.CancelOperation. */ export interface Schema$CancelOperationRequest {} + /** + * Request for creating a volume from an existing data source (such as a backup). + */ + export interface Schema$CreateFromSourceRequest { + /** + * The resource name of the backup to create from. Format: projects/{project\}/locations/{location\}/backups/{backup\} + */ + backup?: string | null; + /** + * Optional. IP ACLs defining permissions/ACLs to apply to the newly created volume. + */ + ipAcls?: Schema$NfsExportOptions[]; + /** + * Optional. The limit for how much data can be written to this volume, in MiB. + */ + quota?: string | null; + /** + * Required. Unique identifier for the volume which also appears in the volumes resource name. + */ + volumeId?: string | null; + } /** * Time window specified for daily operations. */ @@ -257,6 +278,10 @@ export namespace file_v1beta1 { */ year?: number | null; } + /** + * DeleteVolumeRequest deletes a volume. + */ + export interface Schema$DeleteVolumeRequest {} /** * DenyMaintenancePeriod definition. Maintenance is forbidden within the deny period. The start_date must be less than the end_date. */ @@ -1333,6 +1358,19 @@ export namespace file_v1beta1 { */ seconds?: number | null; } + /** + * Request for unfreezing a volume. + */ + export interface Schema$UnfreezeVolumeRequest { + /** + * Optional. IP ACLs defining permissions/ACLs to apply to the unfrozen volume + */ + ipAcls?: Schema$NfsExportOptions[]; + /** + * Optional. The limit for how much data can be written to this volume, in MiB. + */ + quota?: string | null; + } /** * Maintenance policy applicable to instance updates. */ @@ -1362,6 +1400,10 @@ export namespace file_v1beta1 { * Optional. A description of the volume with 2048 characters or less. Requests with longer descriptions will be rejected. */ description?: string | null; + /** + * Optional. User-defined permissions protecting mount points. + */ + ipAcls?: Schema$NfsExportOptions[]; /** * Optional. Resource labels to represent user provided metadata. */ @@ -1374,11 +1416,23 @@ export namespace file_v1beta1 { * Identifier. The resource name of the volume, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. */ name?: string | null; + /** + * Optional. The maximum size of the volume in mebibytes (MiB). + */ + quotaMib?: string | null; + /** + * Optional. The state of the volume. This field is caller-settable via `UpdateVolume` to transition a volume from `HOT` to `COLD` (freezing the volume). In `CreateVolume`, this field is output-only and initialized to `HOT`. + */ + state?: string | null; } /** * VolumePool representation of a Cloud Filestore volume pool. */ export interface Schema$VolumePool { + /** + * Optional. The number of active volumes. Default: 100. + */ + activeVolumeCount?: number | null; /** * Optional. The number of IOPs provisioned per active volume. */ @@ -1388,7 +1442,7 @@ export namespace file_v1beta1 { */ createTime?: string | null; /** - * Optional. The default quota per volume in MiB. Default: 1024 MiB. + * Optional. The default quota per volume in MiB. Must be between 100 MiB and 102400 MiB (100 GiB). Default: 1024 MiB. */ defaultVolumeQuotaMib?: number | null; /** @@ -1407,6 +1461,10 @@ export namespace file_v1beta1 { * Required. The VPC network to which the VolumePool should be attached. Only Private Service Connect (PSC) is supported. */ network?: string | null; + /** + * Output only. The state of the volume pool. + */ + state?: string | null; /** * Output only. System-assigned unique identifier for the volume pool. */ @@ -6905,6 +6963,7 @@ export namespace file_v1beta1 { * requestBody: { * // request body parameters * // { + * // "activeVolumeCount": 0, * // "activeVolumeIops": 0, * // "createTime": "my_createTime", * // "defaultVolumeQuotaMib": 0, @@ -6912,6 +6971,7 @@ export namespace file_v1beta1 { * // "labels": {}, * // "name": "my_name", * // "network": "my_network", + * // "state": "my_state", * // "uid": "my_uid" * // } * }, @@ -7197,6 +7257,7 @@ export namespace file_v1beta1 { * * // Example response * // { + * // "activeVolumeCount": 0, * // "activeVolumeIops": 0, * // "createTime": "my_createTime", * // "defaultVolumeQuotaMib": 0, @@ -7204,6 +7265,7 @@ export namespace file_v1beta1 { * // "labels": {}, * // "name": "my_name", * // "network": "my_network", + * // "state": "my_state", * // "uid": "my_uid" * // } * } @@ -7487,6 +7549,7 @@ export namespace file_v1beta1 { * requestBody: { * // request body parameters * // { + * // "activeVolumeCount": 0, * // "activeVolumeIops": 0, * // "createTime": "my_createTime", * // "defaultVolumeQuotaMib": 0, @@ -7494,6 +7557,7 @@ export namespace file_v1beta1 { * // "labels": {}, * // "name": "my_name", * // "network": "my_network", + * // "state": "my_state", * // "uid": "my_uid" * // } * }, @@ -7716,9 +7780,12 @@ export namespace file_v1beta1 { * // { * // "createTime": "my_createTime", * // "description": "my_description", + * // "ipAcls": [], * // "labels": {}, * // "mountPoint": {}, - * // "name": "my_name" + * // "name": "my_name", + * // "quotaMib": "my_quotaMib", + * // "state": "my_state" * // } * }, * }); @@ -7728,9 +7795,12 @@ export namespace file_v1beta1 { * // { * // "createTime": "my_createTime", * // "description": "my_description", + * // "ipAcls": [], * // "labels": {}, * // "mountPoint": {}, - * // "name": "my_name" + * // "name": "my_name", + * // "quotaMib": "my_quotaMib", + * // "state": "my_state" * // } * } * @@ -7830,7 +7900,7 @@ export namespace file_v1beta1 { } /** - * Deletes a volume. + * Creates a volume in a volume pool from an existing data source (such as a Filestore backup). * @example * ```js * // Before running the sample: @@ -7859,14 +7929,33 @@ export namespace file_v1beta1 { * google.options({auth: authClient}); * * // Do the magic - * const res = await file.projects.locations.volumePools.volumes.delete({ - * // Required. The volume resource name, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. - * name: 'projects/my-project/locations/my-location/volumePools/my-volumePool/volumes/my-volume', - * }); + * const res = + * await file.projects.locations.volumePools.volumes.createFromSource({ + * // Required. The parent resource where this volume will be created. Format: projects/{project\}/locations/{location\}/volumePools/{volume_pool\} + * parent: + * 'projects/my-project/locations/my-location/volumePools/my-volumePool', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "backup": "my_backup", + * // "ipAcls": [], + * // "quota": "my_quota", + * // "volumeId": "my_volumeId" + * // } + * }, + * }); * console.log(res.data); * * // Example response - * // {} + * // { + * // "done": false, + * // "error": {}, + * // "metadata": {}, + * // "name": "my_name", + * // "response": {} + * // } * } * * main().catch(e => { @@ -7881,53 +7970,53 @@ export namespace file_v1beta1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - delete( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, + createFromSource( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource, options: StreamMethodOptions ): Promise>; - delete( - params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, + createFromSource( + params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource, options?: MethodOptions - ): Promise>; - delete( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, + ): Promise>; + createFromSource( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - delete( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + createFromSource( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - delete( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, - callback: BodyResponseCallback + createFromSource( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource, + callback: BodyResponseCallback ): void; - delete(callback: BodyResponseCallback): void; - delete( + createFromSource(callback: BodyResponseCallback): void; + createFromSource( paramsOrCallback?: - | Params$Resource$Projects$Locations$Volumepools$Volumes$Delete - | BodyResponseCallback + | Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - BodyResponseCallback | BodyResponseCallback + BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Delete; + {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Delete; + {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource; options = {}; } @@ -7940,29 +8029,31 @@ export namespace file_v1beta1 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1beta1/{+name}').replace(/([^:]\/)\/+/g, '$1'), - method: 'DELETE', + url: ( + rootUrl + '/v1beta1/{+parent}/volumes:createFromSource' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', apiVersion: '', }, options ), params, - requiredParams: ['name'], - pathParams: ['name'], + requiredParams: ['parent'], + pathParams: ['parent'], context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Gets the details of a specific volume. + * Deletes a volume. * @example * ```js * // Before running the sample: @@ -7991,20 +8082,14 @@ export namespace file_v1beta1 { * google.options({auth: authClient}); * * // Do the magic - * const res = await file.projects.locations.volumePools.volumes.get({ + * const res = await file.projects.locations.volumePools.volumes.delete({ * // Required. The volume resource name, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. * name: 'projects/my-project/locations/my-location/volumePools/my-volumePool/volumes/my-volume', * }); * console.log(res.data); * * // Example response - * // { - * // "createTime": "my_createTime", - * // "description": "my_description", - * // "labels": {}, - * // "mountPoint": {}, - * // "name": "my_name" - * // } + * // {} * } * * main().catch(e => { @@ -8019,53 +8104,53 @@ export namespace file_v1beta1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - get( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, + delete( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, options: StreamMethodOptions ): Promise>; - get( - params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, + delete( + params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, options?: MethodOptions - ): Promise>; - get( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - get( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + delete( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - get( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, - callback: BodyResponseCallback + delete( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Delete, + callback: BodyResponseCallback ): void; - get(callback: BodyResponseCallback): void; - get( + delete(callback: BodyResponseCallback): void; + delete( paramsOrCallback?: - | Params$Resource$Projects$Locations$Volumepools$Volumes$Get - | BodyResponseCallback + | Params$Resource$Projects$Locations$Volumepools$Volumes$Delete + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - BodyResponseCallback | BodyResponseCallback + BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Get; + {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Delete; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Get; + {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Delete; options = {}; } @@ -8079,7 +8164,7 @@ export namespace file_v1beta1 { options: Object.assign( { url: (rootUrl + '/v1beta1/{+name}').replace(/([^:]\/)\/+/g, '$1'), - method: 'GET', + method: 'DELETE', apiVersion: '', }, options @@ -8090,17 +8175,17 @@ export namespace file_v1beta1 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } /** - * Lists all volumes for a specified volume pool. + * Creates a volume directly on the CLH, bypassing CCFE. This is a temporary PoC that will be used for testing and removed. * @example * ```js * // Before running the sample: @@ -8129,26 +8214,40 @@ export namespace file_v1beta1 { * google.options({auth: authClient}); * * // Do the magic - * const res = await file.projects.locations.volumePools.volumes.list({ - * // Optional. List filter. - * filter: 'placeholder-value', - * // Optional. Sort results. Supported values are "name", "name desc" or "" (unsorted). - * orderBy: 'placeholder-value', - * // Optional. The maximum number of items to return. - * pageSize: 'placeholder-value', - * // Optional. The next_page_token value to use if there are additional results to retrieve for this list request. - * pageToken: 'placeholder-value', - * // Required. The volume pool for which to retrieve volume information, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}`. + * const res = await file.projects.locations.volumePools.volumes.directCreate({ + * // Required. The parent volume pool path, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}`. * parent: * 'projects/my-project/locations/my-location/volumePools/my-volumePool', + * // Required. The ID to use for the volume. The ID must be unique within the specified volume pool. + * volumeId: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "ipAcls": [], + * // "labels": {}, + * // "mountPoint": {}, + * // "name": "my_name", + * // "quotaMib": "my_quotaMib", + * // "state": "my_state" + * // } + * }, * }); * console.log(res.data); * * // Example response * // { - * // "nextPageToken": "my_nextPageToken", - * // "unreachable": [], - * // "volumes": [] + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "ipAcls": [], + * // "labels": {}, + * // "mountPoint": {}, + * // "name": "my_name", + * // "quotaMib": "my_quotaMib", + * // "state": "my_state" * // } * } * @@ -8164,54 +8263,53 @@ export namespace file_v1beta1 { * @param callback - Optional callback that handles the response. * @returns A promise if used with async/await, or void if used with a callback. */ - list( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$List, + directCreate( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate, options: StreamMethodOptions ): Promise>; - list( - params?: Params$Resource$Projects$Locations$Volumepools$Volumes$List, + directCreate( + params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate, options?: MethodOptions - ): Promise>; - list( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$List, + ): Promise>; + directCreate( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate, options: StreamMethodOptions | BodyResponseCallback, callback: BodyResponseCallback ): void; - list( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$List, - options: MethodOptions | BodyResponseCallback, - callback: BodyResponseCallback + directCreate( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback ): void; - list( - params: Params$Resource$Projects$Locations$Volumepools$Volumes$List, - callback: BodyResponseCallback + directCreate( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate, + callback: BodyResponseCallback ): void; - list(callback: BodyResponseCallback): void; - list( + directCreate(callback: BodyResponseCallback): void; + directCreate( paramsOrCallback?: - | Params$Resource$Projects$Locations$Volumepools$Volumes$List - | BodyResponseCallback + | Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate + | BodyResponseCallback | BodyResponseCallback, optionsOrCallback?: | MethodOptions | StreamMethodOptions - | BodyResponseCallback + | BodyResponseCallback | BodyResponseCallback, callback?: - | BodyResponseCallback - | BodyResponseCallback + BodyResponseCallback | BodyResponseCallback ): | void - | Promise> + | Promise> | Promise> { let params = (paramsOrCallback || - {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$List; + {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate; let options = (optionsOrCallback || {}) as MethodOptions; if (typeof paramsOrCallback === 'function') { callback = paramsOrCallback; params = - {} as Params$Resource$Projects$Locations$Volumepools$Volumes$List; + {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate; options = {}; } @@ -8224,11 +8322,11 @@ export namespace file_v1beta1 { const parameters = { options: Object.assign( { - url: (rootUrl + '/v1beta1/{+parent}/volumes').replace( + url: (rootUrl + '/v1beta1/{+parent}/volumes:directCreate').replace( /([^:]\/)\/+/g, '$1' ), - method: 'GET', + method: 'POST', apiVersion: '', }, options @@ -8239,37 +8337,813 @@ export namespace file_v1beta1 { context: this.context, }; if (callback) { - createAPIRequest( + createAPIRequest( parameters, callback as BodyResponseCallback ); } else { - return createAPIRequest(parameters); + return createAPIRequest(parameters); } } - } - - export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Create extends StandardParameters { - /** - * Required. The parent volume pool path, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}`. - */ - parent?: string; - /** - * Required. The ID to use for the volume. The ID must be unique within the specified volume pool. - */ - volumeId?: string; /** - * Request body metadata - */ - requestBody?: Schema$Volume; - } - export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Delete extends StandardParameters { - /** - * Required. The volume resource name, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. - */ - name?: string; - } + * Deletes a volume directly on the CLH, bypassing CCFE. This is a temporary PoC that will be used for testing and removed. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/file.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const file = google.file('v1beta1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await file.projects.locations.volumePools.volumes.directDelete({ + * // Required. The volume resource name, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. + * name: 'projects/my-project/locations/my-location/volumePools/my-volumePool/volumes/my-volume', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // {} + * }, + * }); + * console.log(res.data); + * + * // Example response + * // {} + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + directDelete( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete, + options: StreamMethodOptions + ): Promise>; + directDelete( + params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete, + options?: MethodOptions + ): Promise>; + directDelete( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + directDelete( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + directDelete( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete, + callback: BodyResponseCallback + ): void; + directDelete(callback: BodyResponseCallback): void; + directDelete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://file.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta1/{+name}:directDelete').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Gets the details of a specific volume. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/file.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const file = google.file('v1beta1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await file.projects.locations.volumePools.volumes.get({ + * // Required. The volume resource name, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. + * name: 'projects/my-project/locations/my-location/volumePools/my-volumePool/volumes/my-volume', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "ipAcls": [], + * // "labels": {}, + * // "mountPoint": {}, + * // "name": "my_name", + * // "quotaMib": "my_quotaMib", + * // "state": "my_state" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + get( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Volumepools$Volumes$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://file.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Lists all volumes for a specified volume pool. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/file.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const file = google.file('v1beta1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await file.projects.locations.volumePools.volumes.list({ + * // Optional. List filter. + * filter: 'placeholder-value', + * // Optional. Sort results. Supported values are "name", "name desc" or "" (unsorted). + * orderBy: 'placeholder-value', + * // Optional. The maximum number of items to return. + * pageSize: 'placeholder-value', + * // Optional. The next_page_token value to use if there are additional results to retrieve for this list request. + * pageToken: 'placeholder-value', + * // Required. The volume pool for which to retrieve volume information, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}`. + * parent: + * 'projects/my-project/locations/my-location/volumePools/my-volumePool', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "nextPageToken": "my_nextPageToken", + * // "unreachable": [], + * // "volumes": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + list( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Volumepools$Volumes$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$List, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Volumepools$Volumes$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Volumepools$Volumes$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://file.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta1/{+parent}/volumes').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['parent'], + pathParams: ['parent'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Updates the settings of a specific volume. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/file.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const file = google.file('v1beta1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await file.projects.locations.volumePools.volumes.patch({ + * // Identifier. The resource name of the volume, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. + * name: 'projects/my-project/locations/my-location/volumePools/my-volumePool/volumes/my-volume', + * // Required. Mask of fields to update. At least one path must be supplied in this field. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "ipAcls": [], + * // "labels": {}, + * // "mountPoint": {}, + * // "name": "my_name", + * // "quotaMib": "my_quotaMib", + * // "state": "my_state" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "ipAcls": [], + * // "labels": {}, + * // "mountPoint": {}, + * // "name": "my_name", + * // "quotaMib": "my_quotaMib", + * // "state": "my_state" + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + patch( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Volumepools$Volumes$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://file.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta1/{+name}').replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Unfreezes a volume. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/file.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const file = google.file('v1beta1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = await file.projects.locations.volumePools.volumes.unfreeze({ + * // Required. The name of the volume to unfreeze. Format: `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. + * name: 'projects/my-project/locations/my-location/volumePools/my-volumePool/volumes/my-volume', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "ipAcls": [], + * // "quota": "my_quota" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "done": false, + * // "error": {}, + * // "metadata": {}, + * // "name": "my_name", + * // "response": {} + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + unfreeze( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze, + options: StreamMethodOptions + ): Promise>; + unfreeze( + params?: Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze, + options?: MethodOptions + ): Promise>; + unfreeze( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + unfreeze( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + unfreeze( + params: Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze, + callback: BodyResponseCallback + ): void; + unfreeze(callback: BodyResponseCallback): void; + unfreeze( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://file.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta1/{+name}:unfreeze').replace( + /([^:]\/)\/+/g, + '$1' + ), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: ['name'], + pathParams: ['name'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Create extends StandardParameters { + /** + * Required. The parent volume pool path, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}`. + */ + parent?: string; + /** + * Required. The ID to use for the volume. The ID must be unique within the specified volume pool. + */ + volumeId?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$Volume; + } + export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Createfromsource extends StandardParameters { + /** + * Required. The parent resource where this volume will be created. Format: projects/{project\}/locations/{location\}/volumePools/{volume_pool\} + */ + parent?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$CreateFromSourceRequest; + } + export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Delete extends StandardParameters { + /** + * Required. The volume resource name, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Directcreate extends StandardParameters { + /** + * Required. The parent volume pool path, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}`. + */ + parent?: string; + /** + * Required. The ID to use for the volume. The ID must be unique within the specified volume pool. + */ + volumeId?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$Volume; + } + export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Directdelete extends StandardParameters { + /** + * Required. The volume resource name, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$DeleteVolumeRequest; + } export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Get extends StandardParameters { /** * Required. The volume resource name, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. @@ -8298,4 +9172,30 @@ export namespace file_v1beta1 { */ parent?: string; } + export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Patch extends StandardParameters { + /** + * Identifier. The resource name of the volume, in the format `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. + */ + name?: string; + /** + * Required. Mask of fields to update. At least one path must be supplied in this field. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$Volume; + } + export interface Params$Resource$Projects$Locations$Volumepools$Volumes$Unfreeze extends StandardParameters { + /** + * Required. The name of the volume to unfreeze. Format: `projects/{project\}/locations/{location\}/volumePools/{volume_pool\}/volumes/{volume\}`. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$UnfreezeVolumeRequest; + } } diff --git a/src/apis/firebasecrashlytics/v1alpha.ts b/src/apis/firebasecrashlytics/v1alpha.ts index 73f6158d0a..6381d1daf7 100644 --- a/src/apis/firebasecrashlytics/v1alpha.ts +++ b/src/apis/firebasecrashlytics/v1alpha.ts @@ -2495,7 +2495,7 @@ export namespace firebasecrashlytics_v1alpha { * metricsMode: 'placeholder-value', * // Required. The report name. Format: "projects/{project\}/apps/{app_id\}/reports/{report\}". * name: 'projects/my-project/apps/my-app/reports/my-report', - * // Optional. The maximum number of result groups to return. If omitted, defaults to 25. + * // Optional. The maximum number of result groups to return. The maximum value is 100; values above 100 will be coerced to 100. If omitted, defaults to 25. * pageSize: 'placeholder-value', * // Optional. A page token, received from a previous call. The page token is only valid for the exact same set of filters, which must also be sent in subsequent requests. This token is valid for 10 minutes after the first request. * pageToken: 'placeholder-value', @@ -2821,7 +2821,7 @@ export namespace firebasecrashlytics_v1alpha { */ name?: string; /** - * Optional. The maximum number of result groups to return. If omitted, defaults to 25. + * Optional. The maximum number of result groups to return. The maximum value is 100; values above 100 will be coerced to 100. If omitted, defaults to 25. */ pageSize?: number; /** diff --git a/src/apis/firebasedataconnect/v1.ts b/src/apis/firebasedataconnect/v1.ts index 8572c1af0e..a01912835f 100644 --- a/src/apis/firebasedataconnect/v1.ts +++ b/src/apis/firebasedataconnect/v1.ts @@ -490,6 +490,23 @@ export namespace firebasedataconnect_v1 { */ dataConnect?: Schema$DataConnectProperties[]; } + /** + * Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; \} service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); \} Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); \} Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged. + */ + export interface Schema$HttpBody { + /** + * The HTTP Content-Type header value specifying the content type of the body. + */ + contentType?: string | null; + /** + * The HTTP request/response body as raw binary. + */ + data?: string | null; + /** + * Application specific response metadata. Must be set in the first response for streaming APIs. + */ + extensions?: Array<{[key: string]: any}> | null; + } /** * Settings for HTTP GraphQL server webhook. */ @@ -1899,12 +1916,16 @@ export namespace firebasedataconnect_v1 { export class Resource$Projects$Locations$Services { context: APIRequestContext; connectors: Resource$Projects$Locations$Services$Connectors; + postgrest: Resource$Projects$Locations$Services$Postgrest; schemas: Resource$Projects$Locations$Services$Schemas; constructor(context: APIRequestContext) { this.context = context; this.connectors = new Resource$Projects$Locations$Services$Connectors( this.context ); + this.postgrest = new Resource$Projects$Locations$Services$Postgrest( + this.context + ); this.schemas = new Resource$Projects$Locations$Services$Schemas( this.context ); @@ -5174,6 +5195,1209 @@ export namespace firebasedataconnect_v1 { requestBody?: Schema$Connector; } + export class Resource$Projects$Locations$Services$Postgrest { + context: APIRequestContext; + rpc: Resource$Projects$Locations$Services$Postgrest$Rpc; + constructor(context: APIRequestContext) { + this.context = context; + this.rpc = new Resource$Projects$Locations$Services$Postgrest$Rpc( + this.context + ); + } + + /** + * Executes a dynamic DELETE mutation on rows matching the URL filters. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestDelete( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to delete from. + * firebasedataconnectTable: '.*', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestDelete( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + options: StreamMethodOptions + ): Promise>; + postgrestDelete( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + options?: MethodOptions + ): Promise>; + postgrestDelete( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestDelete( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestDelete( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + callback: BodyResponseCallback + ): void; + postgrestDelete(callback: BodyResponseCallback): void; + postgrestDelete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a dynamic INSERT (create) or UPSERT mutation on a target table. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestInsert( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to insert into. + * firebasedataconnectTable: '.*', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * }, + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestInsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + options: StreamMethodOptions + ): Promise>; + postgrestInsert( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + options?: MethodOptions + ): Promise>; + postgrestInsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestInsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestInsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + callback: BodyResponseCallback + ): void; + postgrestInsert(callback: BodyResponseCallback): void; + postgrestInsert( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a dynamic SELECT (read) query on a target PostgreSQL table. Projections, filters, sorting, and embeddings are mapped from the HTTP URL query parameters. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestSelect( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to select from. + * firebasedataconnectTable: '.*', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestSelect( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + options: StreamMethodOptions + ): Promise>; + postgrestSelect( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + options?: MethodOptions + ): Promise>; + postgrestSelect( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestSelect( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestSelect( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + callback: BodyResponseCallback + ): void; + postgrestSelect(callback: BodyResponseCallback): void; + postgrestSelect( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a dynamic UPDATE (modify) mutation on rows matching the URL filters. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestUpdate( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to update. + * firebasedataconnectTable: '.*', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * }, + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestUpdate( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + options: StreamMethodOptions + ): Promise>; + postgrestUpdate( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + options?: MethodOptions + ): Promise>; + postgrestUpdate( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestUpdate( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestUpdate( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + callback: BodyResponseCallback + ): void; + postgrestUpdate(callback: BodyResponseCallback): void; + postgrestUpdate( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a dynamic UPSERT (replace or create) mutation on a target table identified by primary key filters. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestUpsert( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to upsert into. + * firebasedataconnectTable: '.*', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * }, + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestUpsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + options: StreamMethodOptions + ): Promise>; + postgrestUpsert( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + options?: MethodOptions + ): Promise>; + postgrestUpsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestUpsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestUpsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + callback: BodyResponseCallback + ): void; + postgrestUpsert(callback: BodyResponseCallback): void; + postgrestUpsert( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'PUT', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to delete from. + */ + firebasedataconnectTable?: string; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to insert into. + */ + firebasedataconnectTable?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$HttpBody; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to select from. + */ + firebasedataconnectTable?: string; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to update. + */ + firebasedataconnectTable?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$HttpBody; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to upsert into. + */ + firebasedataconnectTable?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$HttpBody; + } + + export class Resource$Projects$Locations$Services$Postgrest$Rpc { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Executes a PostgreSQL database function. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.rpc.postgrestCallFunction( + * { + * // Required. The name of the database function. + * firebasedataconnectFunction: '.*', + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * }, + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestCallFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + options: StreamMethodOptions + ): Promise>; + postgrestCallFunction( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + options?: MethodOptions + ): Promise>; + postgrestCallFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestCallFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestCallFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + callback: BodyResponseCallback + ): void; + postgrestCallFunction( + callback: BodyResponseCallback + ): void; + postgrestCallFunction( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1/{+firebasedataconnectService}/postgrest/rpc/{+firebasedataconnectFunction}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectFunction', + ], + pathParams: [ + 'firebasedataconnectFunction', + 'firebasedataconnectService', + ], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a read-only PostgreSQL database function. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.rpc.postgrestQueryFunction( + * { + * // Required. The name of the database function. + * firebasedataconnectFunction: '.*', + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestQueryFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + options: StreamMethodOptions + ): Promise>; + postgrestQueryFunction( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + options?: MethodOptions + ): Promise>; + postgrestQueryFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestQueryFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestQueryFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + callback: BodyResponseCallback + ): void; + postgrestQueryFunction( + callback: BodyResponseCallback + ): void; + postgrestQueryFunction( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1/{+firebasedataconnectService}/postgrest/rpc/{+firebasedataconnectFunction}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectFunction', + ], + pathParams: [ + 'firebasedataconnectFunction', + 'firebasedataconnectService', + ], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction extends StandardParameters { + /** + * Required. The name of the database function. + */ + firebasedataconnectFunction?: string; + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$HttpBody; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction extends StandardParameters { + /** + * Required. The name of the database function. + */ + firebasedataconnectFunction?: string; + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + } + export class Resource$Projects$Locations$Services$Schemas { context: APIRequestContext; constructor(context: APIRequestContext) { diff --git a/src/apis/firebasedataconnect/v1beta.ts b/src/apis/firebasedataconnect/v1beta.ts index 1704c7ba03..019ff53be5 100644 --- a/src/apis/firebasedataconnect/v1beta.ts +++ b/src/apis/firebasedataconnect/v1beta.ts @@ -490,6 +490,23 @@ export namespace firebasedataconnect_v1beta { */ dataConnect?: Schema$DataConnectProperties[]; } + /** + * Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; \} service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); \} Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); \} Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged. + */ + export interface Schema$HttpBody { + /** + * The HTTP Content-Type header value specifying the content type of the body. + */ + contentType?: string | null; + /** + * The HTTP request/response body as raw binary. + */ + data?: string | null; + /** + * Application specific response metadata. Must be set in the first response for streaming APIs. + */ + extensions?: Array<{[key: string]: any}> | null; + } /** * Settings for HTTP GraphQL server webhook. */ @@ -1902,12 +1919,16 @@ export namespace firebasedataconnect_v1beta { export class Resource$Projects$Locations$Services { context: APIRequestContext; connectors: Resource$Projects$Locations$Services$Connectors; + postgrest: Resource$Projects$Locations$Services$Postgrest; schemas: Resource$Projects$Locations$Services$Schemas; constructor(context: APIRequestContext) { this.context = context; this.connectors = new Resource$Projects$Locations$Services$Connectors( this.context ); + this.postgrest = new Resource$Projects$Locations$Services$Postgrest( + this.context + ); this.schemas = new Resource$Projects$Locations$Services$Schemas( this.context ); @@ -5177,6 +5198,1209 @@ export namespace firebasedataconnect_v1beta { requestBody?: Schema$Connector; } + export class Resource$Projects$Locations$Services$Postgrest { + context: APIRequestContext; + rpc: Resource$Projects$Locations$Services$Postgrest$Rpc; + constructor(context: APIRequestContext) { + this.context = context; + this.rpc = new Resource$Projects$Locations$Services$Postgrest$Rpc( + this.context + ); + } + + /** + * Executes a dynamic DELETE mutation on rows matching the URL filters. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1beta'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestDelete( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to delete from. + * firebasedataconnectTable: '.*', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestDelete( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + options: StreamMethodOptions + ): Promise>; + postgrestDelete( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + options?: MethodOptions + ): Promise>; + postgrestDelete( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestDelete( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestDelete( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete, + callback: BodyResponseCallback + ): void; + postgrestDelete(callback: BodyResponseCallback): void; + postgrestDelete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'DELETE', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a dynamic INSERT (create) or UPSERT mutation on a target table. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1beta'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestInsert( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to insert into. + * firebasedataconnectTable: '.*', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * }, + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestInsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + options: StreamMethodOptions + ): Promise>; + postgrestInsert( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + options?: MethodOptions + ): Promise>; + postgrestInsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestInsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestInsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert, + callback: BodyResponseCallback + ): void; + postgrestInsert(callback: BodyResponseCallback): void; + postgrestInsert( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a dynamic SELECT (read) query on a target PostgreSQL table. Projections, filters, sorting, and embeddings are mapped from the HTTP URL query parameters. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1beta'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestSelect( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to select from. + * firebasedataconnectTable: '.*', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestSelect( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + options: StreamMethodOptions + ): Promise>; + postgrestSelect( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + options?: MethodOptions + ): Promise>; + postgrestSelect( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestSelect( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestSelect( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect, + callback: BodyResponseCallback + ): void; + postgrestSelect(callback: BodyResponseCallback): void; + postgrestSelect( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a dynamic UPDATE (modify) mutation on rows matching the URL filters. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1beta'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestUpdate( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to update. + * firebasedataconnectTable: '.*', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * }, + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestUpdate( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + options: StreamMethodOptions + ): Promise>; + postgrestUpdate( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + options?: MethodOptions + ): Promise>; + postgrestUpdate( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestUpdate( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestUpdate( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate, + callback: BodyResponseCallback + ): void; + postgrestUpdate(callback: BodyResponseCallback): void; + postgrestUpdate( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'PATCH', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a dynamic UPSERT (replace or create) mutation on a target table identified by primary key filters. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1beta'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.postgrestUpsert( + * { + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * // Required. The name of the table to upsert into. + * firebasedataconnectTable: '.*', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * }, + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestUpsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + options: StreamMethodOptions + ): Promise>; + postgrestUpsert( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + options?: MethodOptions + ): Promise>; + postgrestUpsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestUpsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestUpsert( + params: Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert, + callback: BodyResponseCallback + ): void; + postgrestUpsert(callback: BodyResponseCallback): void; + postgrestUpsert( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1beta/{+firebasedataconnectService}/postgrest/{+firebasedataconnectTable}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'PUT', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectTable', + ], + pathParams: ['firebasedataconnectService', 'firebasedataconnectTable'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestdelete extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to delete from. + */ + firebasedataconnectTable?: string; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestinsert extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to insert into. + */ + firebasedataconnectTable?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$HttpBody; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestselect extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to select from. + */ + firebasedataconnectTable?: string; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupdate extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to update. + */ + firebasedataconnectTable?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$HttpBody; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Postgrestupsert extends StandardParameters { + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + /** + * Required. The name of the table to upsert into. + */ + firebasedataconnectTable?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$HttpBody; + } + + export class Resource$Projects$Locations$Services$Postgrest$Rpc { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Executes a PostgreSQL database function. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1beta'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.rpc.postgrestCallFunction( + * { + * // Required. The name of the database function. + * firebasedataconnectFunction: '.*', + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * }, + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestCallFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + options: StreamMethodOptions + ): Promise>; + postgrestCallFunction( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + options?: MethodOptions + ): Promise>; + postgrestCallFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestCallFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestCallFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction, + callback: BodyResponseCallback + ): void; + postgrestCallFunction( + callback: BodyResponseCallback + ): void; + postgrestCallFunction( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1beta/{+firebasedataconnectService}/postgrest/rpc/{+firebasedataconnectFunction}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'POST', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectFunction', + ], + pathParams: [ + 'firebasedataconnectFunction', + 'firebasedataconnectService', + ], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + + /** + * Executes a read-only PostgreSQL database function. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/firebasedataconnect.googleapis.com + * // - Login into gcloud by running: + * // ```sh + * // $ gcloud auth application-default login + * // ``` + * // - Install the npm module by running: + * // ```sh + * // $ npm install googleapis + * // ``` + * + * const {google} = require('googleapis'); + * const firebasedataconnect = google.firebasedataconnect('v1beta'); + * + * async function main() { + * const auth = new google.auth.GoogleAuth({ + * // Scopes can be specified either as an array or as a single, space-delimited string. + * scopes: ['https://www.googleapis.com/auth/cloud-platform'], + * }); + * + * // Acquire an auth client, and bind it to all future calls + * const authClient = await auth.getClient(); + * google.options({auth: authClient}); + * + * // Do the magic + * const res = + * await firebasedataconnect.projects.locations.services.postgrest.rpc.postgrestQueryFunction( + * { + * // Required. The name of the database function. + * firebasedataconnectFunction: '.*', + * // Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + * firebasedataconnectService: + * 'projects/my-project/locations/my-location/services/my-service', + * }, + * ); + * console.log(res.data); + * + * // Example response + * // { + * // "contentType": "my_contentType", + * // "data": "my_data", + * // "extensions": [] + * // } + * } + * + * main().catch(e => { + * console.error(e); + * throw e; + * }); + * + * ``` + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + postgrestQueryFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + options: StreamMethodOptions + ): Promise>; + postgrestQueryFunction( + params?: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + options?: MethodOptions + ): Promise>; + postgrestQueryFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestQueryFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + postgrestQueryFunction( + params: Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction, + callback: BodyResponseCallback + ): void; + postgrestQueryFunction( + callback: BodyResponseCallback + ): void; + postgrestQueryFunction( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://firebasedataconnect.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + + '/v1beta/{+firebasedataconnectService}/postgrest/rpc/{+firebasedataconnectFunction}' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + apiVersion: '', + }, + options + ), + params, + requiredParams: [ + 'firebasedataconnectService', + 'firebasedataconnectFunction', + ], + pathParams: [ + 'firebasedataconnectFunction', + 'firebasedataconnectService', + ], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest(parameters); + } + } + } + + export interface Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestcallfunction extends StandardParameters { + /** + * Required. The name of the database function. + */ + firebasedataconnectFunction?: string; + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$HttpBody; + } + export interface Params$Resource$Projects$Locations$Services$Postgrest$Rpc$Postgrestqueryfunction extends StandardParameters { + /** + * Required. The name of the database function. + */ + firebasedataconnectFunction?: string; + /** + * Required. The resource name of the service, in the format: `projects/{project\}/locations/{location\}/services/{service\}` + */ + firebasedataconnectService?: string; + } + export class Resource$Projects$Locations$Services$Schemas { context: APIRequestContext; constructor(context: APIRequestContext) { diff --git a/src/apis/gmail/v1.ts b/src/apis/gmail/v1.ts index 07e3978707..00e9528ff9 100644 --- a/src/apis/gmail/v1.ts +++ b/src/apis/gmail/v1.ts @@ -254,7 +254,7 @@ export namespace gmail_v1 { */ hardwareKeyMetadata?: Schema$HardwareKeyMetadata; /** - * Metadata for a private key instance managed by an external key access control list service. + * Metadata for a private key instance managed by an external key access control list service. The maximum size of the KACLS data field is 8 KiB. */ kaclsKeyMetadata?: Schema$KaclsKeyMetadata; /** @@ -464,15 +464,15 @@ export namespace gmail_v1 { maxFolderSize?: number | null; } /** - * Metadata for private keys managed by an external key access control list service. For details about managing key access, see [Google Workspace CSE API Reference](https://developers.google.com/workspace/cse/reference). + * Metadata for a cryptographic key managed by an external key access control list service. For details about managing key access, see [Google Workspace CSE API Reference](https://developers.google.com/workspace/cse/reference). */ export interface Schema$KaclsKeyMetadata { /** - * Opaque data generated and used by the key access control list service. Maximum size: 8 KiB. + * Opaque data generated and used by the key access control list service. */ kaclsData?: string | null; /** - * The URI of the key access control list service that manages the private key. + * The URI of the key access control list service that manages the key. */ kaclsUri?: string | null; } diff --git a/src/apis/health/v4.ts b/src/apis/health/v4.ts index 8f1f0a5758..12e874153c 100644 --- a/src/apis/health/v4.ts +++ b/src/apis/health/v4.ts @@ -757,7 +757,7 @@ export namespace health_v4 { */ export interface Schema$DailyRollUpDataPointsRequest { /** - * Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. + * Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. */ dataSourceFamily?: string | null; /** @@ -961,7 +961,7 @@ export namespace health_v4 { */ moods?: Schema$Moods; /** - * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. + * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. */ name?: string | null; /** @@ -1437,7 +1437,7 @@ export namespace health_v4 { */ export interface Schema$GoogleDevicesandservicesHealthV4betaDataType { /** - * Identifier. The resource name of the data type. Format: `users/{user\}/dataTypes/{data_type\}` See DataPoint.name for examples and possible values. + * Identifier. The resource name of the data type. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values. */ name?: string | null; } @@ -1464,7 +1464,7 @@ export namespace health_v4 { */ export interface Schema$GoogleDevicesandservicesHealthV4DataType { /** - * Identifier. The resource name of the data type. Format: `users/{user\}/dataTypes/{data_type\}` See DataPoint.name for examples and possible values. + * Identifier. The resource name of the data type. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values. */ name?: string | null; } @@ -2344,7 +2344,7 @@ export namespace health_v4 { */ dailyVo2Max?: Schema$DailyVO2Max; /** - * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. + * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. */ dataPointName?: string | null; /** @@ -2577,7 +2577,7 @@ export namespace health_v4 { */ export interface Schema$RollUpDataPointsRequest { /** - * Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. + * Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. */ dataSourceFamily?: string | null; /** @@ -5937,7 +5937,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.batchDelete({ - * // Optional. Parent (data type) for the Data Point collection Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/-` For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field. + * // Optional. Parent (data type) for the Data Point collection Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/-` - `users/1234567890/dataTypes/-` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field. * parent: 'users/my-user/dataTypes/my-dataType', * * // Request body metadata @@ -6093,7 +6093,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.create({ - * // Required. The parent resource name where the data point will be created. Format: `users/{user\}/dataTypes/{data_type\}` + * // Required. The parent resource name where the data point will be created. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). * parent: 'users/my-user/dataTypes/my-dataType', * * // Request body metadata @@ -6301,7 +6301,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.dailyRollUp({ - * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the DailyRollupDataPoint value union field. + * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DailyRollupDataPoint value union field. * parent: 'users/my-user/dataTypes/my-dataType', * * // Request body metadata @@ -6427,7 +6427,7 @@ export namespace health_v4 { } /** - * Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. Example: `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed. + * Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. ## Examples: ## `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` `https://health.googleapis.com/v4/users/1234567890/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed. * @example * ```js * // Before running the sample: @@ -6460,7 +6460,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.exportExerciseTcx({ - * // Required. The resource name of the exercise data point to export. Format: `users/{user\}/dataTypes/exercise/dataPoints/{data_point\}` Example: `users/me/dataTypes/exercise/dataPoints/2026443605080188808` The `{user\}` is the alias `"me"` currently. Future versions may support user IDs. The `{data_point\}` ID maps to the exercise ID, which is a long integer. + * // Required. The resource name of the exercise data point to export. Format: `users/{user\}/dataTypes/exercise/dataPoints/{data_point\}` Examples: - `users/me/dataTypes/exercise/dataPoints/2026443605080188808` - `users/1234567890/dataTypes/exercise/dataPoints/2026443605080188808` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). The `{data_point\}` ID maps to the exercise ID, which is a long integer. * name: 'users/my-user/dataTypes/my-dataType/dataPoints/my-dataPoint', * // Optional. Indicates whether to include the TCX data points when the GPS data is not available. If not specified, defaults to `false` and partial data will not be included. * partialData: 'placeholder-value', @@ -6620,7 +6620,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.get({ - * // Required. The name of the data point to retrieve. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` See DataPoint.name for examples and possible values. + * // Required. The name of the data point to retrieve. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values. * name: 'users/my-user/dataTypes/my-dataType/dataPoints/my-dataPoint', * }); * console.log(res.data); @@ -6813,7 +6813,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.list({ - * // Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/me/dataSourceFamilies/{data_source_family\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead. + * // Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead. * dataSourceFamily: 'placeholder-value', * // Optional. Filter expression following https://google.aip.dev/160. A time range (either physical or civil) can be specified. The supported filter fields are: - Interval start time: - Pattern: `{interval_data_type\}.interval.start_time` - Supported comparison operators: `\>=`, `<` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND` - Example: - `steps.interval.start_time \>= "2023-11-24T00:00:00Z" AND steps.interval.start_time < "2023-11-25T00:00:00Z"` - `distance.interval.start_time \>= "2024-08-14T12:34:56Z"` - Interval civil start time: - Pattern: `{interval_data_type\}.interval.civil_start_time` - Supported comparison operators: `\>=`, `<` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `steps.interval.civil_start_time \>= "2023-11-24" AND steps.interval.civil_start_time < "2023-11-25"` - `distance.interval.civil_start_time \>= "2024-08-14T12:34:56"` - Sample observation physical time: - Pattern: `{sample_data_type\}.sample_time.physical_time` - Supported comparison operators: `\>=`, `<` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND` - Example: - `weight.sample_time.physical_time \>= "2023-11-24T00:00:00Z" AND weight.sample_time.physical_time < "2023-11-25T00:00:00Z"` - `weight.sample_time.physical_time \>= "2024-08-14T12:34:56Z"` - Sample observation civil time: - Pattern: `{sample_data_type\}.sample_time.civil_time` - Supported comparison operators: `\>=`, `<` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `weight.sample_time.civil_time \>= "2023-11-24" AND weight.sample_time.civil_time < "2023-11-25"` - `weight.sample_time.civil_time \>= "2024-08-14T12:34:56"` - Daily summary date: - Pattern: `{daily_summary_data_type\}.date` - Supported comparison operators: `\>=`, `<` - Date literal expected in ISO 8601 `YYYY-MM-DD` format - Supported logical operators: `AND` - Example: - `daily_heart_rate_variability.date < "2024-08-15"` - Session civil start time (**Excluding Sleep and ECG**): - Pattern: `{session_data_type\}.interval.civil_start_time` - Supported comparison operators: `\>=`, `<` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `exercise.interval.civil_start_time \>= "2023-11-24" AND exercise.interval.civil_start_time < "2023-11-25"` - `exercise.interval.civil_start_time \>= "2024-08-14T12:34:56"` - Session start time (**ECG specific**): - Pattern: `electrocardiogram.interval.start_time` - Supported comparison operators: `\>=` - Timestamp literal expected in RFC-3339 format - Example: - `electrocardiogram.interval.start_time \>= "2024-08-14T12:34:56Z"` - Note: Only filtering by start time is supported for ECG. Filtering by end time (e.g., `electrocardiogram.interval.end_time`) is not supported. - Session end time (**Sleep specific**): - Pattern: `sleep.interval.end_time` - Supported comparison operators: `\>=`, `<` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND`, `OR` - Example: - `sleep.interval.end_time \>= "2023-11-24T00:00:00Z" AND sleep.interval.end_time < "2023-11-25T00:00:00Z"` - Session civil end time (**Sleep specific**): - Pattern: `sleep.interval.civil_end_time` - Supported comparison operators: `\>=`, `<` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND`, `OR` - Example: - `sleep.interval.civil_end_time \>= "2023-11-24" AND sleep.interval.civil_end_time < "2023-11-25"` Data points in the response will be ordered by the interval start time in descending order. * filter: 'placeholder-value', @@ -6821,7 +6821,7 @@ export namespace health_v4 { * pageSize: 'placeholder-value', * // Optional. The `next_page_token` from a previous request, if any. * pageToken: 'placeholder-value', - * // Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/weight` For a list of the supported data types see the DataPoint data union field. + * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/weight` - `users/1234567890/dataTypes/weight` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. * parent: 'users/my-user/dataTypes/my-dataType', * }); * console.log(res.data); @@ -6968,7 +6968,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.patch({ - * // Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. + * // Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. * name: 'users/my-user/dataTypes/my-dataType/dataPoints/my-dataPoint', * * // Request body metadata @@ -7173,7 +7173,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.reconcile({ - * // Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family\}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. + * // Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. * dataSourceFamily: 'placeholder-value', * // Optional. Filter expression based on https://aip.dev/160. A time range, either physical or civil, can be specified. See the ListDataPointsRequest.filter for the supported fields and syntax. * filter: 'placeholder-value', @@ -7181,7 +7181,7 @@ export namespace health_v4 { * pageSize: 'placeholder-value', * // Optional. The `next_page_token` from a previous request, if any. * pageToken: 'placeholder-value', - * // Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field. + * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/heart-rate` - `users/1234567890/dataTypes/heart-rate` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. * parent: 'users/my-user/dataTypes/my-dataType', * }); * console.log(res.data); @@ -7340,7 +7340,7 @@ export namespace health_v4 { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.rollUp({ - * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the RollupDataPoint value union field. + * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the RollupDataPoint value union field. * parent: 'users/my-user/dataTypes/my-dataType', * * // Request body metadata @@ -7465,7 +7465,7 @@ export namespace health_v4 { export interface Params$Resource$Users$Datatypes$Datapoints$Batchdelete extends StandardParameters { /** - * Optional. Parent (data type) for the Data Point collection Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/-` For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field. + * Optional. Parent (data type) for the Data Point collection Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/-` - `users/1234567890/dataTypes/-` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field. */ parent?: string; @@ -7476,7 +7476,7 @@ export namespace health_v4 { } export interface Params$Resource$Users$Datatypes$Datapoints$Create extends StandardParameters { /** - * Required. The parent resource name where the data point will be created. Format: `users/{user\}/dataTypes/{data_type\}` + * Required. The parent resource name where the data point will be created. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). */ parent?: string; @@ -7487,7 +7487,7 @@ export namespace health_v4 { } export interface Params$Resource$Users$Datatypes$Datapoints$Dailyrollup extends StandardParameters { /** - * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the DailyRollupDataPoint value union field. + * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DailyRollupDataPoint value union field. */ parent?: string; @@ -7498,7 +7498,7 @@ export namespace health_v4 { } export interface Params$Resource$Users$Datatypes$Datapoints$Exportexercisetcx extends StandardParameters { /** - * Required. The resource name of the exercise data point to export. Format: `users/{user\}/dataTypes/exercise/dataPoints/{data_point\}` Example: `users/me/dataTypes/exercise/dataPoints/2026443605080188808` The `{user\}` is the alias `"me"` currently. Future versions may support user IDs. The `{data_point\}` ID maps to the exercise ID, which is a long integer. + * Required. The resource name of the exercise data point to export. Format: `users/{user\}/dataTypes/exercise/dataPoints/{data_point\}` Examples: - `users/me/dataTypes/exercise/dataPoints/2026443605080188808` - `users/1234567890/dataTypes/exercise/dataPoints/2026443605080188808` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). The `{data_point\}` ID maps to the exercise ID, which is a long integer. */ name?: string; /** @@ -7508,13 +7508,13 @@ export namespace health_v4 { } export interface Params$Resource$Users$Datatypes$Datapoints$Get extends StandardParameters { /** - * Required. The name of the data point to retrieve. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` See DataPoint.name for examples and possible values. + * Required. The name of the data point to retrieve. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values. */ name?: string; } export interface Params$Resource$Users$Datatypes$Datapoints$List extends StandardParameters { /** - * Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/me/dataSourceFamilies/{data_source_family\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead. + * Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead. */ dataSourceFamily?: string; /** @@ -7530,13 +7530,13 @@ export namespace health_v4 { */ pageToken?: string; /** - * Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/weight` For a list of the supported data types see the DataPoint data union field. + * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/weight` - `users/1234567890/dataTypes/weight` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. */ parent?: string; } export interface Params$Resource$Users$Datatypes$Datapoints$Patch extends StandardParameters { /** - * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. + * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. */ name?: string; @@ -7547,7 +7547,7 @@ export namespace health_v4 { } export interface Params$Resource$Users$Datatypes$Datapoints$Reconcile extends StandardParameters { /** - * Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family\}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. + * Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. */ dataSourceFamily?: string; /** @@ -7563,13 +7563,13 @@ export namespace health_v4 { */ pageToken?: string; /** - * Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field. + * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/heart-rate` - `users/1234567890/dataTypes/heart-rate` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. */ parent?: string; } export interface Params$Resource$Users$Datatypes$Datapoints$Rollup extends StandardParameters { /** - * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the RollupDataPoint value union field. + * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the RollupDataPoint value union field. */ parent?: string; diff --git a/src/apis/health/v4beta.ts b/src/apis/health/v4beta.ts index ea082080cd..2b6c440271 100644 --- a/src/apis/health/v4beta.ts +++ b/src/apis/health/v4beta.ts @@ -761,7 +761,7 @@ export namespace health_v4beta { */ export interface Schema$DailyRollUpDataPointsRequest { /** - * Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. + * Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. */ dataSourceFamily?: string | null; /** @@ -965,7 +965,7 @@ export namespace health_v4beta { */ moods?: Schema$Moods; /** - * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. + * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. */ name?: string | null; /** @@ -1449,7 +1449,7 @@ export namespace health_v4beta { */ export interface Schema$GoogleDevicesandservicesHealthV4betaDataType { /** - * Identifier. The resource name of the data type. Format: `users/{user\}/dataTypes/{data_type\}` See DataPoint.name for examples and possible values. + * Identifier. The resource name of the data type. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values. */ name?: string | null; } @@ -1476,7 +1476,7 @@ export namespace health_v4beta { */ export interface Schema$GoogleDevicesandservicesHealthV4DataType { /** - * Identifier. The resource name of the data type. Format: `users/{user\}/dataTypes/{data_type\}` See DataPoint.name for examples and possible values. + * Identifier. The resource name of the data type. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values. */ name?: string | null; } @@ -2356,7 +2356,7 @@ export namespace health_v4beta { */ dailyVo2Max?: Schema$DailyVO2Max; /** - * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. + * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. */ dataPointName?: string | null; /** @@ -2601,7 +2601,7 @@ export namespace health_v4beta { */ export interface Schema$RollUpDataPointsRequest { /** - * Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/me/dataSourceFamilies/{data_source_family\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. + * Optional. The data source family name to roll up. If empty, data points from all available data sources will be rolled up. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. */ dataSourceFamily?: string | null; /** @@ -2824,7 +2824,7 @@ export namespace health_v4beta { weightUnit?: string | null; } /** - * ////////////////////////////////////////////////////////////////////////// SkinTemperature ////////////////////////////////////////////////////////////////////////// Skin temperature measurement. + * Skin temperature measurement. */ export interface Schema$SkinTemperature { /** @@ -6055,7 +6055,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.batchDelete({ - * // Optional. Parent (data type) for the Data Point collection Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/-` For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field. + * // Optional. Parent (data type) for the Data Point collection Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/-` - `users/1234567890/dataTypes/-` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field. * parent: 'users/my-user/dataTypes/my-dataType', * * // Request body metadata @@ -6211,7 +6211,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.create({ - * // Required. The parent resource name where the data point will be created. Format: `users/{user\}/dataTypes/{data_type\}` + * // Required. The parent resource name where the data point will be created. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). * parent: 'users/my-user/dataTypes/my-dataType', * * // Request body metadata @@ -6421,7 +6421,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.dailyRollUp({ - * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the DailyRollupDataPoint value union field. + * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DailyRollupDataPoint value union field. * parent: 'users/my-user/dataTypes/my-dataType', * * // Request body metadata @@ -6547,7 +6547,7 @@ export namespace health_v4beta { } /** - * Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. Example: `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed. + * Exports exercise data in TCX format. **IMPORTANT:** HTTP clients must append `?alt=media` to the request URL to download the raw TCX file. ## Examples: ## `https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` `https://health.googleapis.com/v4/users/1234567890/dataTypes/exercise/dataPoints/EXERCISE_ID:exportExerciseTcx?alt=media` Without `alt=media`, the server returns a JSON response (`ExportExerciseTcxResponse`) which is intended primarily for gRPC clients. **Note:** While the Authorization section below states that any one of the listed scopes is accepted, this specific method requires the user to provide both one of the `activity_and_fitness` scopes (`normal` or `readonly`) AND one of the `location` scopes (`normal` or `readonly`) in their access token to succeed. * @example * ```js * // Before running the sample: @@ -6580,7 +6580,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.exportExerciseTcx({ - * // Required. The resource name of the exercise data point to export. Format: `users/{user\}/dataTypes/exercise/dataPoints/{data_point\}` Example: `users/me/dataTypes/exercise/dataPoints/2026443605080188808` The `{user\}` is the alias `"me"` currently. Future versions may support user IDs. The `{data_point\}` ID maps to the exercise ID, which is a long integer. + * // Required. The resource name of the exercise data point to export. Format: `users/{user\}/dataTypes/exercise/dataPoints/{data_point\}` Examples: - `users/me/dataTypes/exercise/dataPoints/2026443605080188808` - `users/1234567890/dataTypes/exercise/dataPoints/2026443605080188808` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). The `{data_point\}` ID maps to the exercise ID, which is a long integer. * name: 'users/my-user/dataTypes/my-dataType/dataPoints/my-dataPoint', * // Optional. Indicates whether to include the TCX data points when the GPS data is not available. If not specified, defaults to `false` and partial data will not be included. * partialData: 'placeholder-value', @@ -6740,7 +6740,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.get({ - * // Required. The name of the data point to retrieve. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` See DataPoint.name for examples and possible values. + * // Required. The name of the data point to retrieve. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values. * name: 'users/my-user/dataTypes/my-dataType/dataPoints/my-dataPoint', * }); * console.log(res.data); @@ -6935,7 +6935,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.list({ - * // Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/me/dataSourceFamilies/{data_source_family\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead. + * // Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead. * dataSourceFamily: 'placeholder-value', * // Optional. Filter expression following https://google.aip.dev/160. A time range (either physical or civil) can be specified. The supported filter fields are: - Interval start time: - Pattern: `{interval_data_type\}.interval.start_time` - Supported comparison operators: `\>=`, `<` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND` - Example: - `steps.interval.start_time \>= "2023-11-24T00:00:00Z" AND steps.interval.start_time < "2023-11-25T00:00:00Z"` - `distance.interval.start_time \>= "2024-08-14T12:34:56Z"` - Interval civil start time: - Pattern: `{interval_data_type\}.interval.civil_start_time` - Supported comparison operators: `\>=`, `<` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `steps.interval.civil_start_time \>= "2023-11-24" AND steps.interval.civil_start_time < "2023-11-25"` - `distance.interval.civil_start_time \>= "2024-08-14T12:34:56"` - Sample observation physical time: - Pattern: `{sample_data_type\}.sample_time.physical_time` - Supported comparison operators: `\>=`, `<` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND` - Example: - `weight.sample_time.physical_time \>= "2023-11-24T00:00:00Z" AND weight.sample_time.physical_time < "2023-11-25T00:00:00Z"` - `weight.sample_time.physical_time \>= "2024-08-14T12:34:56Z"` - Sample observation civil time: - Pattern: `{sample_data_type\}.sample_time.civil_time` - Supported comparison operators: `\>=`, `<` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `weight.sample_time.civil_time \>= "2023-11-24" AND weight.sample_time.civil_time < "2023-11-25"` - `weight.sample_time.civil_time \>= "2024-08-14T12:34:56"` - Daily summary date: - Pattern: `{daily_summary_data_type\}.date` - Supported comparison operators: `\>=`, `<` - Date literal expected in ISO 8601 `YYYY-MM-DD` format - Supported logical operators: `AND` - Example: - `daily_heart_rate_variability.date < "2024-08-15"` - Session civil start time (**Excluding Sleep and ECG**): - Pattern: `{session_data_type\}.interval.civil_start_time` - Supported comparison operators: `\>=`, `<` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND` - Example: - `exercise.interval.civil_start_time \>= "2023-11-24" AND exercise.interval.civil_start_time < "2023-11-25"` - `exercise.interval.civil_start_time \>= "2024-08-14T12:34:56"` - Session start time (**ECG specific**): - Pattern: `electrocardiogram.interval.start_time` - Supported comparison operators: `\>=` - Timestamp literal expected in RFC-3339 format - Example: - `electrocardiogram.interval.start_time \>= "2024-08-14T12:34:56Z"` - Note: Only filtering by start time is supported for ECG. Filtering by end time (e.g., `electrocardiogram.interval.end_time`) is not supported. - Session end time (**Sleep specific**): - Pattern: `sleep.interval.end_time` - Supported comparison operators: `\>=`, `<` - Timestamp literal expected in RFC-3339 format - Supported logical operators: `AND`, `OR` - Example: - `sleep.interval.end_time \>= "2023-11-24T00:00:00Z" AND sleep.interval.end_time < "2023-11-25T00:00:00Z"` - Session civil end time (**Sleep specific**): - Pattern: `sleep.interval.civil_end_time` - Supported comparison operators: `\>=`, `<` - Date with optional time literal expected in ISO 8601 `YYYY-MM-DD[THH:mm:ss]` format - Supported logical operators: `AND`, `OR` - Example: - `sleep.interval.civil_end_time \>= "2023-11-24" AND sleep.interval.civil_end_time < "2023-11-25"` Data points in the response will be ordered by the interval start time in descending order. * filter: 'placeholder-value', @@ -6943,7 +6943,7 @@ export namespace health_v4beta { * pageSize: 'placeholder-value', * // Optional. The `next_page_token` from a previous request, if any. * pageToken: 'placeholder-value', - * // Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/weight` For a list of the supported data types see the DataPoint data union field. + * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/weight` - `users/1234567890/dataTypes/weight` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. * parent: 'users/my-user/dataTypes/my-dataType', * }); * console.log(res.data); @@ -7090,7 +7090,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.patch({ - * // Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. + * // Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. * name: 'users/my-user/dataTypes/my-dataType/dataPoints/my-dataPoint', * * // Request body metadata @@ -7297,7 +7297,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.reconcile({ - * // Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family\}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. + * // Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. * dataSourceFamily: 'placeholder-value', * // Optional. Filter expression based on https://aip.dev/160. A time range, either physical or civil, can be specified. See the ListDataPointsRequest.filter for the supported fields and syntax. * filter: 'placeholder-value', @@ -7305,7 +7305,7 @@ export namespace health_v4beta { * pageSize: 'placeholder-value', * // Optional. The `next_page_token` from a previous request, if any. * pageToken: 'placeholder-value', - * // Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field. + * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/heart-rate` - `users/1234567890/dataTypes/heart-rate` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. * parent: 'users/my-user/dataTypes/my-dataType', * }); * console.log(res.data); @@ -7464,7 +7464,7 @@ export namespace health_v4beta { * * // Do the magic * const res = await health.users.dataTypes.dataPoints.rollUp({ - * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the RollupDataPoint value union field. + * // Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the RollupDataPoint value union field. * parent: 'users/my-user/dataTypes/my-dataType', * * // Request body metadata @@ -7589,7 +7589,7 @@ export namespace health_v4beta { export interface Params$Resource$Users$Datatypes$Datapoints$Batchdelete extends StandardParameters { /** - * Optional. Parent (data type) for the Data Point collection Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/-` For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field. + * Optional. Parent (data type) for the Data Point collection Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/-` - `users/1234567890/dataTypes/-` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. Deleting data points across multiple data type collections is supported following https://aip.dev/159. If this is set, the parent of all of the data points specified in `names` must match this field. */ parent?: string; @@ -7600,7 +7600,7 @@ export namespace health_v4beta { } export interface Params$Resource$Users$Datatypes$Datapoints$Create extends StandardParameters { /** - * Required. The parent resource name where the data point will be created. Format: `users/{user\}/dataTypes/{data_type\}` + * Required. The parent resource name where the data point will be created. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). */ parent?: string; @@ -7611,7 +7611,7 @@ export namespace health_v4beta { } export interface Params$Resource$Users$Datatypes$Datapoints$Dailyrollup extends StandardParameters { /** - * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the DailyRollupDataPoint value union field. + * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DailyRollupDataPoint value union field. */ parent?: string; @@ -7622,7 +7622,7 @@ export namespace health_v4beta { } export interface Params$Resource$Users$Datatypes$Datapoints$Exportexercisetcx extends StandardParameters { /** - * Required. The resource name of the exercise data point to export. Format: `users/{user\}/dataTypes/exercise/dataPoints/{data_point\}` Example: `users/me/dataTypes/exercise/dataPoints/2026443605080188808` The `{user\}` is the alias `"me"` currently. Future versions may support user IDs. The `{data_point\}` ID maps to the exercise ID, which is a long integer. + * Required. The resource name of the exercise data point to export. Format: `users/{user\}/dataTypes/exercise/dataPoints/{data_point\}` Examples: - `users/me/dataTypes/exercise/dataPoints/2026443605080188808` - `users/1234567890/dataTypes/exercise/dataPoints/2026443605080188808` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). The `{data_point\}` ID maps to the exercise ID, which is a long integer. */ name?: string; /** @@ -7632,13 +7632,13 @@ export namespace health_v4beta { } export interface Params$Resource$Users$Datatypes$Datapoints$Get extends StandardParameters { /** - * Required. The name of the data point to retrieve. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` See DataPoint.name for examples and possible values. + * Required. The name of the data point to retrieve. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). See DataPoint.name for examples and possible values. */ name?: string; } export interface Params$Resource$Users$Datatypes$Datapoints$List extends StandardParameters { /** - * Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/me/dataSourceFamilies/{data_source_family\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead. + * Optional. The data source family name to filter by. If empty, data points from all available data sources will be returned. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data types may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. Filtering by data source family is not supported for the `sleep`, `food` and `food-measurement-unit` data types, because the underlying listing implementation cannot restrict results by data source. Such requests fail with `INVALID_ARGUMENT` when the data source family is set explicitly, and with `PERMISSION_DENIED` when the restriction is only implied by the caller's scopes. For `sleep`, use ReconcileDataPoints instead. */ dataSourceFamily?: string; /** @@ -7654,13 +7654,13 @@ export namespace health_v4beta { */ pageToken?: string; /** - * Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/weight` For a list of the supported data types see the DataPoint data union field. + * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/weight` - `users/1234567890/dataTypes/weight` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. */ parent?: string; } export interface Params$Resource$Users$Datatypes$Datapoints$Patch extends StandardParameters { /** - * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` Example: `users/abcd1234/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` ID is a system-generated identifier, as described in Identity.health_user_id. The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. + * Identifier. Data point name, only supported for the subset of identifiable data types. For the majority of the data types, individual data points do not need to be identified and this field would be empty. Format: `users/{user\}/dataTypes/{data_type\}/dataPoints/{data_point\}` ## Examples: ## `users/me/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` `users/1234567890/dataTypes/sleep/dataPoints/a1b2c3d4-e5f6-7890-1234-567890abcdef` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, which can be retrieved by calling GetIdentity (see Identity.health_user_id). The `{data_type\}` ID corresponds to the kebab-case version of the field names in the DataPoint data union field, e.g. `heart-rate` for the `heart_rate` field. The `{data_point\}` ID can be client-provided or system-generated. If client-provided, it must be a string of 4-63 characters, containing only lowercase letters, numbers, and hyphens. */ name?: string; @@ -7671,7 +7671,7 @@ export namespace health_v4beta { } export interface Params$Resource$Users$Datatypes$Datapoints$Reconcile extends StandardParameters { /** - * Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/me/dataSourceFamilies/{data_source_family\}` - `users/me/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/me/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/me/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/me/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. + * Optional. The data source family name to reconcile. If empty, data points from all data sources will be reconciled. Format: `users/{user\}/dataSourceFamilies/{data_source_family\}` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID, retrieved via GetIdentity (e.g. `users/me/dataSourceFamilies/...` or `users/1234567890/dataSourceFamilies/...`). The supported values are: - `users/{user\}/dataSourceFamilies/all-sources` - Default value. Includes data from all available data sources. - `users/{user\}/dataSourceFamilies/google-wearables` - Includes data from Google and Fitbit tracker devices (such as Fitbit trackers and Pixel Watch). Excludes manually logged data. - `users/{user\}/dataSourceFamilies/google-sources` - Includes first-party Google data, such as data from tracker devices, manually logged data, and Health Connect. - `users/{user\}/dataSourceFamilies/self-sources` - Includes only the data the calling client wrote through this API, that is, data points whose data source was registered through this API with the same OAuth client ID as the caller. Callers that were only granted write scopes for the requested data type may only read the data they wrote themselves: their requests are implicitly restricted to `self-sources`, and requesting any other data source family fails with `PERMISSION_DENIED`. If no data point matches the requested data source family, the response is an empty list rather than an error. */ dataSourceFamily?: string; /** @@ -7687,13 +7687,13 @@ export namespace health_v4beta { */ pageToken?: string; /** - * Required. Parent data type of the Data Point collection. Format: `users/me/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/heart-rate` For a list of the supported data types see the DataPoint data union field. + * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/heart-rate` - `users/1234567890/dataTypes/heart-rate` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the DataPoint data union field. */ parent?: string; } export interface Params$Resource$Users$Datatypes$Datapoints$Rollup extends StandardParameters { /** - * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/me/dataTypes/distance` For a list of the supported data types see the RollupDataPoint value union field. + * Required. Parent data type of the Data Point collection. Format: `users/{user\}/dataTypes/{data_type\}`, e.g.: - `users/me/dataTypes/steps` - `users/1234567890/dataTypes/steps` - `users/me/dataTypes/distance` - `users/1234567890/dataTypes/distance` The `{user\}` can be either the alias `me` or the authenticated user's numeric Health User ID (retrieved via GetIdentity). For a list of the supported data types see the RollupDataPoint value union field. */ parent?: string; diff --git a/src/apis/integrations/v2.ts b/src/apis/integrations/v2.ts index 10ab667496..eb223a873f 100644 --- a/src/apis/integrations/v2.ts +++ b/src/apis/integrations/v2.ts @@ -1567,7 +1567,7 @@ export namespace integrations_v2 { taskNumber?: string | null; } /** - * LINT.IfChange Use this request to post all workflows associated with a given trigger id. Next available id: 13 + * LINT.IfChange Use this request to post all workflows associated with a given trigger id. Next available id: 14 */ export interface Schema$GoogleInternalCloudCrmEventbusV3PostToQueueWithTriggerIdRequest { /** @@ -1614,6 +1614,10 @@ export namespace integrations_v2 { * This is a unique id provided by the method caller. If provided this will be used as the execution_id when a new execution info is created. This is a string representation of a UUID. Must have no more than 36 characters and contain only alphanumeric characters and hyphens. */ userGeneratedExecutionId?: string | null; + /** + * Optional. Pins the enqueue to this exact version rather than the ACTIVE one on the trigger, so an unpublished draft can be tested. Requires client_id, and the version is validated before it is enqueued; see integrationplatform/api/executionsservice/README.md. + */ + workflowId?: string | null; /** * Optional. If provided, the workflow_name is used to filter all the matched workflows having same trigger_id+client_id. A combination of trigger_id, client_id and workflow_name identifies a unique workflow. */ diff --git a/src/apis/networkservices/v1.ts b/src/apis/networkservices/v1.ts index 69fd096a06..a177dafff1 100644 --- a/src/apis/networkservices/v1.ts +++ b/src/apis/networkservices/v1.ts @@ -605,7 +605,7 @@ export namespace networkservices_v1 { */ labels?: {[key: string]: string} | null; /** - * Optional. A list of match conditions to match against the incoming request. The extension will be invoked if at least one condition matches the request, or if no match conditions are specified. Limited to 5 conditions. + * Optional. A list of match conditions to evaluate against the incoming request. The extension is invoked if the request matches at least one condition, or if no match conditions are specified. A request matches a condition only if it matches every field that is set in that condition. Limited to 5 conditions. */ matchConditions?: Schema$ExtensionBindingMatchCondition[]; /** @@ -613,19 +613,19 @@ export namespace networkservices_v1 { */ name?: string | null; /** - * Optional. Priority of the extension binding. Lower numbers indicate higher priority. Priority of extension bindings are used to determine the order in which extension bindings are applied to a request. + * Optional. Priority of the extension binding. Lower numbers indicate higher priority. The priority determines the order in which extension bindings are applied to a request. */ priority?: number | null; /** - * Required. The name of the extension that this binding should attach to target resources. Format: For Google-provided extensions, specify the service endpoint (see [Model Armor integration](https://docs.cloud.google.com/model-armor/integrations)) + * Required. The name of the extension that this binding should attach to target resources. Format: For Google-provided extensions, specify the service endpoint, for example `modelarmor.us-central1.rep.googleapis.com`. */ producerExtension?: string | null; /** - * Optional. Additional metadata that should be passed to the attached extension with each request. + * Optional. Additional metadata that should be passed to the attached extension with each request. This field is subject to the following limitations: * The total size of the metadata must be less than 1 KiB. * The total number of keys must be less than 16. * The length of each key must be less than 64 characters. * The length of each value must be less than 1024 characters. */ producerMetadata?: {[key: string]: string} | null; /** - * Required. Specifies a target to which this `ExtensionBinding` should be attached. The target can be either a single resource or a scope of resources. + * Required. Specifies a target to which this `ExtensionBinding` should be attached. */ target?: Schema$ExtensionBindingTarget; /** @@ -660,23 +660,23 @@ export namespace networkservices_v1 { */ export interface Schema$ExtensionBindingMatchConditionStringMatch { /** - * Optional. The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def`` + * Optional. The input string must contain the substring specified here. An empty substring is not allowed. Examples: * `abc` matches the value `xyz.abc.def`. */ contains?: string | null; /** - * Optional. The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``. + * Optional. The input string must match exactly the string specified here. Examples: * `abc` only matches the value `abc`. */ exact?: string | null; /** - * Optional. If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true. + * Optional. If true, the `exact`, `prefix`, `suffix`, or `contains` match is case insensitive. For example, the matcher `data` matches both `Data` and `data` when set to true. */ ignoreCase?: boolean | null; /** - * Optional. The input string must have the prefix specified here. Note: empty prefix is not allowed. Examples: * ``abc`` matches the value ``abc.xyz`` + * Optional. The input string must have the prefix specified here. An empty prefix is not allowed. Examples: * `abc` matches the value `abc.xyz`. */ prefix?: string | null; /** - * Optional. The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc`` + * Optional. The input string must have the suffix specified here. An empty suffix is not allowed. Examples: * `abc` matches the value `xyz.abc`. */ suffix?: string | null; } @@ -685,7 +685,7 @@ export namespace networkservices_v1 { */ export interface Schema$ExtensionBindingMatchConditionTo { /** - * Optional. Describes properties of destination of a request. Within a destination, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches. At least one of destination or not_destination must be specified. + * Optional. Describes properties of the destination of a request. A request matches the destination only if it matches every field that is set. Fields that are not set are always considered a match. For example, if only `hosts` and `paths` are set, a request matches when any host matches and any path matches. At least one of `destination` or `not_destination` must be specified. */ destination?: Schema$ExtensionBindingMatchConditionToDestination; /** @@ -719,7 +719,7 @@ export namespace networkservices_v1 { */ export interface Schema$ExtensionBindingMatchConditionToDestinationHeaderSet { /** - * Required. A list of headers to match against in http header. If multiple header matches are provided, they will be evaluated as an AND, i.e. all header matches must match for the request to match. + * Required. A list of HTTP headers to match against. If multiple header matches are provided, they are evaluated as an AND, meaning that all header matches must match for the request to match. Limited to 10 headers. */ headers?: Schema$ExtensionBindingMatchConditionHeaderMatch[]; } @@ -728,7 +728,7 @@ export namespace networkservices_v1 { */ export interface Schema$ExtensionBindingTarget { /** - * Optional. The reference to the target resource, to which this binding should attach. Exactly one of `resources` or `scope` must be set. + * Optional. The references to the target resources to which this binding should attach. Exactly one of `resources` or `scope` must be set. For AI Application resources, specify the full resource name in the format: `projects/{project\}/locations/{location\}/applications/{application\}`. Limited to 1 resource. */ resources?: string[] | null; /** @@ -741,11 +741,11 @@ export namespace networkservices_v1 { */ export interface Schema$ExtensionBindingTargetScope { /** - * Required. Parent resource name specification, in the format: `projects/{project_number\}`. + * Required. The parent resource that defines the scope, in the format `projects/{project_number\}`. When the scope is a project, the binding applies to the resources that meet all of the following conditions: * The resource belongs to the specified project. * The resource is in the same location as the `ExtensionBinding`. * The resource type is listed in `resource_types`. */ parent?: string | null; /** - * Required. Type of the resource to which the binding should attach. Limited to 1 resource type. + * Required. The types of resources to which the binding should attach. Limited to 1 resource type. */ resourceTypes?: string[] | null; } diff --git a/src/apis/networkservices/v1beta1.ts b/src/apis/networkservices/v1beta1.ts index 3156370ad5..9d7fe0a06b 100644 --- a/src/apis/networkservices/v1beta1.ts +++ b/src/apis/networkservices/v1beta1.ts @@ -561,7 +561,7 @@ export namespace networkservices_v1beta1 { */ labels?: {[key: string]: string} | null; /** - * Optional. A list of match conditions to match against the incoming request. The extension will be invoked if at least one condition matches the request, or if no match conditions are specified. Limited to 5 conditions. + * Optional. A list of match conditions to evaluate against the incoming request. The extension is invoked if the request matches at least one condition, or if no match conditions are specified. A request matches a condition only if it matches every field that is set in that condition. Limited to 5 conditions. */ matchConditions?: Schema$ExtensionBindingMatchCondition[]; /** @@ -569,19 +569,19 @@ export namespace networkservices_v1beta1 { */ name?: string | null; /** - * Optional. Priority of the extension binding. Lower numbers indicate higher priority. Priority of extension bindings are used to determine the order in which extension bindings are applied to a request. + * Optional. Priority of the extension binding. Lower numbers indicate higher priority. The priority determines the order in which extension bindings are applied to a request. */ priority?: number | null; /** - * Required. The name of the extension that this binding should attach to target resources. Format: For Google-provided extensions, specify the service endpoint (see [Model Armor integration](https://docs.cloud.google.com/model-armor/integrations)) + * Required. The name of the extension that this binding should attach to target resources. Format: For Google-provided extensions, specify the service endpoint, for example `modelarmor.us-central1.rep.googleapis.com`. */ producerExtension?: string | null; /** - * Optional. Additional metadata that should be passed to the attached extension with each request. + * Optional. Additional metadata that should be passed to the attached extension with each request. This field is subject to the following limitations: * The total size of the metadata must be less than 1 KiB. * The total number of keys must be less than 16. * The length of each key must be less than 64 characters. * The length of each value must be less than 1024 characters. */ producerMetadata?: {[key: string]: string} | null; /** - * Required. Specifies a target to which this `ExtensionBinding` should be attached. The target can be either a single resource or a scope of resources. + * Required. Specifies a target to which this `ExtensionBinding` should be attached. */ target?: Schema$ExtensionBindingTarget; /** @@ -616,23 +616,23 @@ export namespace networkservices_v1beta1 { */ export interface Schema$ExtensionBindingMatchConditionStringMatch { /** - * Optional. The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def`` + * Optional. The input string must contain the substring specified here. An empty substring is not allowed. Examples: * `abc` matches the value `xyz.abc.def`. */ contains?: string | null; /** - * Optional. The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``. + * Optional. The input string must match exactly the string specified here. Examples: * `abc` only matches the value `abc`. */ exact?: string | null; /** - * Optional. If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true. + * Optional. If true, the `exact`, `prefix`, `suffix`, or `contains` match is case insensitive. For example, the matcher `data` matches both `Data` and `data` when set to true. */ ignoreCase?: boolean | null; /** - * Optional. The input string must have the prefix specified here. Note: empty prefix is not allowed. Examples: * ``abc`` matches the value ``abc.xyz`` + * Optional. The input string must have the prefix specified here. An empty prefix is not allowed. Examples: * `abc` matches the value `abc.xyz`. */ prefix?: string | null; /** - * Optional. The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc`` + * Optional. The input string must have the suffix specified here. An empty suffix is not allowed. Examples: * `abc` matches the value `xyz.abc`. */ suffix?: string | null; } @@ -641,7 +641,7 @@ export namespace networkservices_v1beta1 { */ export interface Schema$ExtensionBindingMatchConditionTo { /** - * Optional. Describes properties of destination of a request. Within a destination, the match follows AND semantics across fields and OR semantics within a field, i.e. a match occurs when ANY path matches AND ANY header matches and ANY method matches. At least one of destination or not_destination must be specified. + * Optional. Describes properties of the destination of a request. A request matches the destination only if it matches every field that is set. Fields that are not set are always considered a match. For example, if only `hosts` and `paths` are set, a request matches when any host matches and any path matches. At least one of `destination` or `not_destination` must be specified. */ destination?: Schema$ExtensionBindingMatchConditionToDestination; /** @@ -675,7 +675,7 @@ export namespace networkservices_v1beta1 { */ export interface Schema$ExtensionBindingMatchConditionToDestinationHeaderSet { /** - * Required. A list of headers to match against in http header. If multiple header matches are provided, they will be evaluated as an AND, i.e. all header matches must match for the request to match. + * Required. A list of HTTP headers to match against. If multiple header matches are provided, they are evaluated as an AND, meaning that all header matches must match for the request to match. Limited to 10 headers. */ headers?: Schema$ExtensionBindingMatchConditionHeaderMatch[]; } @@ -684,7 +684,7 @@ export namespace networkservices_v1beta1 { */ export interface Schema$ExtensionBindingTarget { /** - * Optional. The reference to the target resource, to which this binding should attach. Exactly one of `resources` or `scope` must be set. + * Optional. The references to the target resources to which this binding should attach. Exactly one of `resources` or `scope` must be set. For AI Application resources, specify the full resource name in the format: `projects/{project\}/locations/{location\}/applications/{application\}`. Limited to 1 resource. */ resources?: string[] | null; /** @@ -697,11 +697,11 @@ export namespace networkservices_v1beta1 { */ export interface Schema$ExtensionBindingTargetScope { /** - * Required. Parent resource name specification, in the format: `projects/{project_number\}`. + * Required. The parent resource that defines the scope, in the format `projects/{project_number\}`. When the scope is a project, the binding applies to the resources that meet all of the following conditions: * The resource belongs to the specified project. * The resource is in the same location as the `ExtensionBinding`. * The resource type is listed in `resource_types`. */ parent?: string | null; /** - * Required. Type of the resource to which the binding should attach. Limited to 1 resource type. + * Required. The types of resources to which the binding should attach. Limited to 1 resource type. */ resourceTypes?: string[] | null; } diff --git a/src/apis/run/v1.ts b/src/apis/run/v1.ts index 19766be310..72c8d2d51c 100644 --- a/src/apis/run/v1.ts +++ b/src/apis/run/v1.ts @@ -1081,6 +1081,31 @@ export namespace run_v1 { */ workerRelease?: string | null; } + /** + * Aggregated/summary metrics over the entire build lifecycle. + */ + export interface Schema$GoogleDevtoolsCloudbuildV1BuildResourceUsage { + /** + * Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + */ + averageCpuUtilization?: number | null; + /** + * Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + */ + averageMemoryUtilization?: number | null; + /** + * Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + */ + peakCpuUtilization?: number | null; + /** + * Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + */ + peakMemoryUtilization?: number | null; + /** + * Output only. Total CPU execution time consumed across all cores during build execution. + */ + totalCpuDuration?: string | null; + } /** * A step in the build pipeline. */ @@ -1287,7 +1312,7 @@ export namespace run_v1 { */ export interface Schema$GoogleDevtoolsCloudbuildV1GenericArtifactDependency { /** - * Required. Where the artifact files should be placed on the worker. + * Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. */ destPath?: string | null; /** @@ -1607,6 +1632,10 @@ export namespace run_v1 { * Python artifacts uploaded to Artifact Registry at the end of the build. */ pythonPackages?: Schema$GoogleDevtoolsCloudbuildV1UploadedPythonPackage[]; + /** + * Output only. Aggregated metrics for the build. + */ + resourceUsage?: Schema$GoogleDevtoolsCloudbuildV1BuildResourceUsage; } /** * Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. diff --git a/src/apis/run/v2.ts b/src/apis/run/v2.ts index d5c3dade66..4349fcbfc5 100644 --- a/src/apis/run/v2.ts +++ b/src/apis/run/v2.ts @@ -2866,6 +2866,31 @@ export namespace run_v2 { */ workerRelease?: string | null; } + /** + * Aggregated/summary metrics over the entire build lifecycle. + */ + export interface Schema$GoogleDevtoolsCloudbuildV1BuildResourceUsage { + /** + * Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + */ + averageCpuUtilization?: number | null; + /** + * Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + */ + averageMemoryUtilization?: number | null; + /** + * Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + */ + peakCpuUtilization?: number | null; + /** + * Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + */ + peakMemoryUtilization?: number | null; + /** + * Output only. Total CPU execution time consumed across all cores during build execution. + */ + totalCpuDuration?: string | null; + } /** * A step in the build pipeline. */ @@ -3072,7 +3097,7 @@ export namespace run_v2 { */ export interface Schema$GoogleDevtoolsCloudbuildV1GenericArtifactDependency { /** - * Required. Where the artifact files should be placed on the worker. + * Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. */ destPath?: string | null; /** @@ -3392,6 +3417,10 @@ export namespace run_v2 { * Python artifacts uploaded to Artifact Registry at the end of the build. */ pythonPackages?: Schema$GoogleDevtoolsCloudbuildV1UploadedPythonPackage[]; + /** + * Output only. Aggregated metrics for the build. + */ + resourceUsage?: Schema$GoogleDevtoolsCloudbuildV1BuildResourceUsage; } /** * Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. diff --git a/src/apis/saasservicemgmt/v1.ts b/src/apis/saasservicemgmt/v1.ts index b1220a23d0..d53a5d34b5 100644 --- a/src/apis/saasservicemgmt/v1.ts +++ b/src/apis/saasservicemgmt/v1.ts @@ -138,11 +138,11 @@ export namespace saasservicemgmt_v1 { group?: string | null; } /** - * Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (e.g. terraform, helm etc) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). + * Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). */ export interface Schema$Blueprint { /** - * Output only. Type of the engine used to actuate the blueprint. e.g. terraform, helm etc. + * Output only. Type of the engine used to actuate the blueprint. (Terraform, for example) */ engine?: string | null; /** @@ -425,7 +425,7 @@ export namespace saasservicemgmt_v1 { release?: string | null; } /** - * A new version to be propagated and deployed to units. This includes pointers to packaged blueprints for actuation (e.g Helm or Terraform configuration packages) via artifact registry. + * A new version to be propagated and deployed to units. This includes pointers to packaged blueprints for actuation via Artifact Registry. */ export interface Schema$Release { /** @@ -637,7 +637,7 @@ export namespace saasservicemgmt_v1 { */ uid?: string | null; /** - * Optional. CEL(https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout. + * Optional. [CEL](https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout. */ unitFilter?: string | null; /** @@ -838,7 +838,7 @@ export namespace saasservicemgmt_v1 { inputVariable?: string | null; } /** - * A unit of deployment that has its lifecycle via a CRUD API using an actuation engine under the hood (e.g. based on Terraform, Helm or a custom implementation provided by a service producer). A building block of a SaaS Tenant. + * A unit of deployment that has its lifecycle via a CRUD API using an actuation engine under the hood (e.g. based on Terraform, or a custom implementation provided by a service producer). A building block of a SaaS Tenant. */ export interface Schema$Unit { /** @@ -894,7 +894,7 @@ export namespace saasservicemgmt_v1 { */ ongoingOperations?: string[] | null; /** - * Optional. Output only. Set of key/value pairs corresponding to output variables from execution of actuation templates. The variables are declared in actuation configs (e.g in helm chart or terraform) and the values are fetched and returned by the actuation engine upon completion of execution. + * Optional. Output only. Set of key/value pairs corresponding to output variables from execution of actuation templates. The variables are declared in actuation configs (in Terraform for example) and the values are fetched and returned by the actuation engine upon completion of execution. */ outputVariables?: Schema$UnitVariable[]; /** @@ -1008,6 +1008,10 @@ export namespace saasservicemgmt_v1 { * Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation. */ defaultRelease?: string | null; + /** + * Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation). + */ + deleteTime?: string | null; /** * Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10. */ @@ -6134,6 +6138,7 @@ export namespace saasservicemgmt_v1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], @@ -6155,6 +6160,7 @@ export namespace saasservicemgmt_v1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], @@ -6450,6 +6456,7 @@ export namespace saasservicemgmt_v1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], @@ -6759,6 +6766,7 @@ export namespace saasservicemgmt_v1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], @@ -6780,6 +6788,7 @@ export namespace saasservicemgmt_v1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], diff --git a/src/apis/saasservicemgmt/v1beta1.ts b/src/apis/saasservicemgmt/v1beta1.ts index df236663fa..70df0e9756 100644 --- a/src/apis/saasservicemgmt/v1beta1.ts +++ b/src/apis/saasservicemgmt/v1beta1.ts @@ -185,11 +185,11 @@ export namespace saasservicemgmt_v1beta1 { scope?: Schema$Scope; } /** - * Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (e.g. terraform, helm etc) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). + * Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). */ export interface Schema$Blueprint { /** - * Output only. Type of the engine used to actuate the blueprint. e.g. terraform, helm etc. + * Output only. Type of the engine used to actuate the blueprint. (Terraform, for example) */ engine?: string | null; /** @@ -967,7 +967,7 @@ export namespace saasservicemgmt_v1beta1 { release?: string | null; } /** - * A new version to be propagated and deployed to units. This includes pointers to packaged blueprints for actuation (e.g Helm or Terraform configuration packages) via artifact registry. + * A new version to be propagated and deployed to units. This includes pointers to packaged blueprints for actuation via Artifact Registry. */ export interface Schema$Release { /** @@ -1183,7 +1183,7 @@ export namespace saasservicemgmt_v1beta1 { */ uid?: string | null; /** - * Optional. CEL(https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout. + * Optional. [CEL](https://github.com/google/cel-spec) formatted filter string against Unit. The filter will be applied to determine the eligible unit population. This filter can only reduce, but not expand the scope of the rollout. */ unitFilter?: string | null; /** @@ -1434,7 +1434,7 @@ export namespace saasservicemgmt_v1beta1 { inputVariable?: string | null; } /** - * A unit of deployment that has its lifecycle via a CRUD API using an actuation engine under the hood (e.g. based on Terraform, Helm or a custom implementation provided by a service producer). A building block of a SaaS Tenant. + * A unit of deployment that has its lifecycle via a CRUD API using an actuation engine under the hood (e.g. based on Terraform, or a custom implementation provided by a service producer). A building block of a SaaS Tenant. */ export interface Schema$Unit { /** @@ -1498,7 +1498,7 @@ export namespace saasservicemgmt_v1beta1 { */ ongoingOperations?: string[] | null; /** - * Optional. Output only. Set of key/value pairs corresponding to output variables from execution of actuation templates. The variables are declared in actuation configs (e.g in helm chart or terraform) and the values are fetched and returned by the actuation engine upon completion of execution. + * Optional. Output only. Set of key/value pairs corresponding to output variables from execution of actuation templates. The variables are declared in actuation configs (in Terraform for example) and the values are fetched and returned by the actuation engine upon completion of execution. */ outputVariables?: Schema$UnitVariable[]; /** @@ -1694,6 +1694,10 @@ export namespace saasservicemgmt_v1beta1 { * Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation. */ defaultRelease?: string | null; + /** + * Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation). + */ + deleteTime?: string | null; /** * Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10. */ @@ -13119,6 +13123,7 @@ export namespace saasservicemgmt_v1beta1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], @@ -13142,6 +13147,7 @@ export namespace saasservicemgmt_v1beta1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], @@ -13439,6 +13445,7 @@ export namespace saasservicemgmt_v1beta1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], @@ -13750,6 +13757,7 @@ export namespace saasservicemgmt_v1beta1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], @@ -13773,6 +13781,7 @@ export namespace saasservicemgmt_v1beta1 { * // "createTime": "my_createTime", * // "defaultFlagRevisions": [], * // "defaultRelease": "my_defaultRelease", + * // "deleteTime": "my_deleteTime", * // "dependencies": [], * // "etag": "my_etag", * // "inputVariableMappings": [], diff --git a/src/apis/securitycenter/v1.ts b/src/apis/securitycenter/v1.ts index 59583515ab..a56fe0535e 100644 --- a/src/apis/securitycenter/v1.ts +++ b/src/apis/securitycenter/v1.ts @@ -709,6 +709,7 @@ export namespace securitycenter_v1 { export interface Schema$GoogleCloudSecuritycenterV1BigQueryExport { createTime?: string | null; dataset?: string | null; + deletionNotificationsEnabled?: boolean | null; description?: string | null; filter?: string | null; mostRecentEditor?: string | null; @@ -773,6 +774,7 @@ export namespace securitycenter_v1 { updateTime?: string | null; } export interface Schema$GoogleCloudSecuritycenterV1NotificationMessage { + deletedFinding?: boolean | null; finding?: Schema$Finding; notificationConfigName?: string | null; resource?: Schema$GoogleCloudSecuritycenterV1Resource; @@ -1049,6 +1051,7 @@ export namespace securitycenter_v1 { createTime?: string | null; cryptoKeyName?: string | null; dataset?: string | null; + deletionNotificationsEnabled?: boolean | null; description?: string | null; filter?: string | null; mostRecentEditor?: string | null; @@ -1615,6 +1618,7 @@ export namespace securitycenter_v1 { service?: string | null; } export interface Schema$GoogleCloudSecuritycenterV2NotificationMessage { + deletedFinding?: boolean | null; finding?: Schema$GoogleCloudSecuritycenterV2Finding; notificationConfigName?: string | null; resource?: Schema$GoogleCloudSecuritycenterV2Resource; @@ -2061,6 +2065,7 @@ export namespace securitycenter_v1 { service?: string | null; } export interface Schema$NotificationConfig { + deletionNotificationsEnabled?: boolean | null; description?: string | null; name?: string | null; pubsubTopic?: string | null; @@ -2993,6 +2998,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -3008,6 +3014,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -3297,6 +3304,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -3600,6 +3608,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -3615,6 +3624,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -6926,6 +6936,7 @@ export namespace securitycenter_v1 { * requestBody: { * // request body parameters * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -6938,6 +6949,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -7214,6 +7226,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -7506,6 +7519,7 @@ export namespace securitycenter_v1 { * requestBody: { * // request body parameters * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -7518,6 +7532,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -12192,6 +12207,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -12207,6 +12223,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -12496,6 +12513,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -12799,6 +12817,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -12814,6 +12833,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -16127,6 +16147,7 @@ export namespace securitycenter_v1 { * requestBody: { * // request body parameters * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -16139,6 +16160,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -16415,6 +16437,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -16707,6 +16730,7 @@ export namespace securitycenter_v1 { * requestBody: { * // request body parameters * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -16719,6 +16743,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -24851,6 +24876,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -24866,6 +24892,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -25155,6 +25182,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -25458,6 +25486,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -25473,6 +25502,7 @@ export namespace securitycenter_v1 { * // { * // "createTime": "my_createTime", * // "dataset": "my_dataset", + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "filter": "my_filter", * // "mostRecentEditor": "my_mostRecentEditor", @@ -28784,6 +28814,7 @@ export namespace securitycenter_v1 { * requestBody: { * // request body parameters * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -28796,6 +28827,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -29072,6 +29104,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -29364,6 +29397,7 @@ export namespace securitycenter_v1 { * requestBody: { * // request body parameters * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", @@ -29376,6 +29410,7 @@ export namespace securitycenter_v1 { * * // Example response * // { + * // "deletionNotificationsEnabled": false, * // "description": "my_description", * // "name": "my_name", * // "pubsubTopic": "my_pubsubTopic", diff --git a/src/apis/securitycenter/v1beta1.ts b/src/apis/securitycenter/v1beta1.ts index a0790cac76..de8b44ce70 100644 --- a/src/apis/securitycenter/v1beta1.ts +++ b/src/apis/securitycenter/v1beta1.ts @@ -650,6 +650,7 @@ export namespace securitycenter_v1beta1 { export interface Schema$GoogleCloudSecuritycenterV1BigQueryExport { createTime?: string | null; dataset?: string | null; + deletionNotificationsEnabled?: boolean | null; description?: string | null; filter?: string | null; mostRecentEditor?: string | null; @@ -714,6 +715,7 @@ export namespace securitycenter_v1beta1 { updateTime?: string | null; } export interface Schema$GoogleCloudSecuritycenterV1NotificationMessage { + deletedFinding?: boolean | null; finding?: Schema$Finding; notificationConfigName?: string | null; resource?: Schema$GoogleCloudSecuritycenterV1Resource; @@ -990,6 +992,7 @@ export namespace securitycenter_v1beta1 { createTime?: string | null; cryptoKeyName?: string | null; dataset?: string | null; + deletionNotificationsEnabled?: boolean | null; description?: string | null; filter?: string | null; mostRecentEditor?: string | null; @@ -1556,6 +1559,7 @@ export namespace securitycenter_v1beta1 { service?: string | null; } export interface Schema$GoogleCloudSecuritycenterV2NotificationMessage { + deletedFinding?: boolean | null; finding?: Schema$GoogleCloudSecuritycenterV2Finding; notificationConfigName?: string | null; resource?: Schema$GoogleCloudSecuritycenterV2Resource; diff --git a/src/apis/securitycenter/v1beta2.ts b/src/apis/securitycenter/v1beta2.ts index 0acfbb16e6..4256fca394 100644 --- a/src/apis/securitycenter/v1beta2.ts +++ b/src/apis/securitycenter/v1beta2.ts @@ -627,6 +627,7 @@ export namespace securitycenter_v1beta2 { export interface Schema$GoogleCloudSecuritycenterV1BigQueryExport { createTime?: string | null; dataset?: string | null; + deletionNotificationsEnabled?: boolean | null; description?: string | null; filter?: string | null; mostRecentEditor?: string | null; @@ -691,6 +692,7 @@ export namespace securitycenter_v1beta2 { updateTime?: string | null; } export interface Schema$GoogleCloudSecuritycenterV1NotificationMessage { + deletedFinding?: boolean | null; finding?: Schema$Finding; notificationConfigName?: string | null; resource?: Schema$GoogleCloudSecuritycenterV1Resource; @@ -967,6 +969,7 @@ export namespace securitycenter_v1beta2 { createTime?: string | null; cryptoKeyName?: string | null; dataset?: string | null; + deletionNotificationsEnabled?: boolean | null; description?: string | null; filter?: string | null; mostRecentEditor?: string | null; @@ -1533,6 +1536,7 @@ export namespace securitycenter_v1beta2 { service?: string | null; } export interface Schema$GoogleCloudSecuritycenterV2NotificationMessage { + deletedFinding?: boolean | null; finding?: Schema$GoogleCloudSecuritycenterV2Finding; notificationConfigName?: string | null; resource?: Schema$GoogleCloudSecuritycenterV2Resource; diff --git a/src/apis/servicecontrol/v1.ts b/src/apis/servicecontrol/v1.ts index f5c900da39..5af7fd9ec5 100644 --- a/src/apis/servicecontrol/v1.ts +++ b/src/apis/servicecontrol/v1.ts @@ -214,6 +214,10 @@ export namespace servicecontrol_v1 { * Authorization information. If there are multiple resources or permissions involved, then there is one AuthorizationInfo element for each {resource, permission\} tuple. */ authorizationInfo?: Schema$AuthorizationInfo[]; + /** + * Information set when the caller is an agent. + */ + callerAgent?: Schema$CallerAgent; /** * Other service-specific data about the request, response, and other information associated with the current audited event. */ @@ -383,6 +387,15 @@ export namespace servicecontrol_v1 { */ resourceAttributes?: Schema$Resource; } + /** + * Information set when the caller is an agent. + */ + export interface Schema$CallerAgent { + /** + * The type of authority for the caller agent. + */ + authority?: string | null; + } /** * Defines the errors to be returned in google.api.servicecontrol.v1.CheckResponse.check_errors. */ diff --git a/src/apis/servicecontrol/v2.ts b/src/apis/servicecontrol/v2.ts index 0183a0d146..597ddfd582 100644 --- a/src/apis/servicecontrol/v2.ts +++ b/src/apis/servicecontrol/v2.ts @@ -198,6 +198,10 @@ export namespace servicecontrol_v2 { * Authorization information. If there are multiple resources or permissions involved, then there is one AuthorizationInfo element for each {resource, permission\} tuple. */ authorizationInfo?: Schema$AuthorizationInfo[]; + /** + * Information set when the caller is an agent. + */ + callerAgent?: Schema$CallerAgent; /** * Other service-specific data about the request, response, and other information associated with the current audited event. */ @@ -367,6 +371,15 @@ export namespace servicecontrol_v2 { */ resourceAttributes?: Schema$Resource; } + /** + * Information set when the caller is an agent. + */ + export interface Schema$CallerAgent { + /** + * The type of authority for the caller agent. + */ + authority?: string | null; + } /** * Request message for the Check method. */ diff --git a/src/apis/workstations/v1beta.ts b/src/apis/workstations/v1beta.ts index 005899e04a..aed9efa29b 100644 --- a/src/apis/workstations/v1beta.ts +++ b/src/apis/workstations/v1beta.ts @@ -192,6 +192,10 @@ export namespace workstations_v1beta { * Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB. */ bootDiskSizeGb?: number | null; + /** + * Optional. Indicates if this boost config is eligible for automatic failover when the service cannot provision the default VM type. Defaults to `false`. + */ + enableAutomaticFailover?: boolean | null; /** * Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series. */