diff --git a/discovery/accessapproval-v1.json b/discovery/accessapproval-v1.json index eecea31aa4e..e32c745a3f2 100644 --- a/discovery/accessapproval-v1.json +++ b/discovery/accessapproval-v1.json @@ -913,7 +913,7 @@ } } }, - "revision": "20260703", + "revision": "20260731", "rootUrl": "https://accessapproval.googleapis.com/", "schemas": { "AccessApprovalServiceAccount": { @@ -1352,6 +1352,9 @@ "PQ_SIGN_ML_DSA_44_EXTERNAL_MU", "PQ_SIGN_ML_DSA_65_EXTERNAL_MU", "PQ_SIGN_ML_DSA_87_EXTERNAL_MU", + "KEM_ECDH_P256", + "KEM_ECDH_P384", + "KEM_ECDH_P521", "AES_256_KWP" ], "enumDescriptions": [ @@ -1402,6 +1405,9 @@ "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 1. Randomized version supporting externally-computed message representatives.", "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version supporting externally-computed message representatives.", "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 5. Randomized version supporting externally-computed message representatives.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-256 key that returns shared secret.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-384 key that returns shared secret.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-521 key that returns shared secret.", "AES key wrap with zero padding algorithm (RFC 5649). Can only be used by keys with purpose AES_WRAPPING." ], "type": "string" diff --git a/discovery/alloydb-v1.json b/discovery/alloydb-v1.json index 3a830a2382d..d5df43f185a 100644 --- a/discovery/alloydb-v1.json +++ b/discovery/alloydb-v1.json @@ -1879,9 +1879,19 @@ } } }, - "revision": "20260723", + "revision": "20260730", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { + "AlloydbClhErrorsAlloyDbInternalDebugInfo": { + "description": "AlloyDbInternalDebugInfo contains internal debugging information for AlloyDB errors. It is explicitly kept out of the allowlist (errors.yaml) to ensure it is sanitized (stripped) by OnePlatform for all external requests. Used only to carry internal error details to across UPC/FlowLib boundary for ObservabilityInfo.", + "id": "AlloydbClhErrorsAlloyDbInternalDebugInfo", + "properties": { + "originalError": { + "type": "string" + } + }, + "type": "object" + }, "AuthorizedNetwork": { "description": "AuthorizedNetwork contains metadata for an authorized network.", "id": "AuthorizedNetwork", diff --git a/discovery/alloydb-v1alpha.json b/discovery/alloydb-v1alpha.json index b7c242dd278..549291c3b3f 100644 --- a/discovery/alloydb-v1alpha.json +++ b/discovery/alloydb-v1alpha.json @@ -2086,9 +2086,19 @@ } } }, - "revision": "20260723", + "revision": "20260730", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { + "AlloydbClhErrorsAlloyDbInternalDebugInfo": { + "description": "AlloyDbInternalDebugInfo contains internal debugging information for AlloyDB errors. It is explicitly kept out of the allowlist (errors.yaml) to ensure it is sanitized (stripped) by OnePlatform for all external requests. Used only to carry internal error details to across UPC/FlowLib boundary for ObservabilityInfo.", + "id": "AlloydbClhErrorsAlloyDbInternalDebugInfo", + "properties": { + "originalError": { + "type": "string" + } + }, + "type": "object" + }, "AuthorizedNetwork": { "description": "AuthorizedNetwork contains metadata for an authorized network.", "id": "AuthorizedNetwork", diff --git a/discovery/alloydb-v1beta.json b/discovery/alloydb-v1beta.json index f2ac636bf52..2e1f39b55e5 100644 --- a/discovery/alloydb-v1beta.json +++ b/discovery/alloydb-v1beta.json @@ -2083,9 +2083,19 @@ } } }, - "revision": "20260723", + "revision": "20260730", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { + "AlloydbClhErrorsAlloyDbInternalDebugInfo": { + "description": "AlloyDbInternalDebugInfo contains internal debugging information for AlloyDB errors. It is explicitly kept out of the allowlist (errors.yaml) to ensure it is sanitized (stripped) by OnePlatform for all external requests. Used only to carry internal error details to across UPC/FlowLib boundary for ObservabilityInfo.", + "id": "AlloydbClhErrorsAlloyDbInternalDebugInfo", + "properties": { + "originalError": { + "type": "string" + } + }, + "type": "object" + }, "AuthorizedNetwork": { "description": "AuthorizedNetwork contains metadata for an authorized network.", "id": "AuthorizedNetwork", diff --git a/discovery/analyticsadmin-v1alpha.json b/discovery/analyticsadmin-v1alpha.json index eff9e1fbeeb..44410883563 100644 --- a/discovery/analyticsadmin-v1alpha.json +++ b/discovery/analyticsadmin-v1alpha.json @@ -2366,7 +2366,7 @@ ] }, "create": { - "description": "Creates a CustomDimension.", + "description": "Creates a CustomDimension. Warning: It's not permissible to use this method to collect data on individual users. In particular, sending user IDs in custom dimensions violates the [Google Analytics Terms of Service](https://www.google.com/analytics/terms/).", "flatPath": "v1alpha/properties/{propertiesId}/customDimensions", "httpMethod": "POST", "id": "analyticsadmin.properties.customDimensions.create", @@ -5146,7 +5146,7 @@ } } }, - "revision": "20260628", + "revision": "20260802", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": { diff --git a/discovery/analyticsadmin-v1beta.json b/discovery/analyticsadmin-v1beta.json index f847e3ae4f7..4a3ec1535f7 100644 --- a/discovery/analyticsadmin-v1beta.json +++ b/discovery/analyticsadmin-v1beta.json @@ -816,7 +816,7 @@ ] }, "create": { - "description": "Creates a CustomDimension.", + "description": "Creates a CustomDimension. Warning: It's not permissible to use this method to collect data on individual users. In particular, sending user IDs in custom dimensions violates the [Google Analytics Terms of Service](https://www.google.com/analytics/terms/).", "flatPath": "v1beta/properties/{propertiesId}/customDimensions", "httpMethod": "POST", "id": "analyticsadmin.properties.customDimensions.create", @@ -1788,7 +1788,7 @@ } } }, - "revision": "20260628", + "revision": "20260802", "rootUrl": "https://analyticsadmin.googleapis.com/", "schemas": { "GoogleAnalyticsAdminV1betaAccessBetweenFilter": { diff --git a/discovery/androiddeveloperidstatus-v1.json b/discovery/androiddeveloperidstatus-v1.json new file mode 100644 index 00000000000..87c51284997 --- /dev/null +++ b/discovery/androiddeveloperidstatus-v1.json @@ -0,0 +1,176 @@ +{ + "basePath": "", + "baseUrl": "https://androiddeveloperidstatus.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Android Developer ID Status", + "description": "Android Developer ID Status API.", + "discoveryVersion": "v1", + "documentationLink": "https://developer.android.com/developer-verification/guides/check-registration-status", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "androiddeveloperidstatus:v1", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://androiddeveloperidstatus.mtls.googleapis.com/", + "name": "androiddeveloperidstatus", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "packages": { + "resources": { + "packageRegistrationStatus": { + "methods": { + "check": { + "description": "Retrieves the Android Developer ID registration status for a given package.", + "flatPath": "v1/packages/{packagesId}/packageRegistrationStatus:check", + "httpMethod": "GET", + "id": "androiddeveloperidstatus.packages.packageRegistrationStatus.check", + "parameterOrder": [ + "name" + ], + "parameters": { + "certificateFingerprint": { + "description": "Optional. The SHA-256 fingerprint of the public certificate represented as a 64-character lowercase hexadecimal string without any colons or separators (e.g., `d6ac89ed1d0a805aad4b087d06d5f41645b814480b133fbc867ef7498d069e06`).", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The name of the package registration status resource. Format: packages/{package}/packageRegistrationStatus `{package}` must follow the specific format: The fully-qualified Android package name with dots ('.') replaced by hyphens ('-') (e.g., `com-example-app` instead of `com.example.app`).", + "location": "path", + "pattern": "^packages/[^/]+/packageRegistrationStatus$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:check", + "response": { + "$ref": "PackageRegistrationStatus" + } + } + } + } + } + } + }, + "revision": "20260804", + "rootUrl": "https://androiddeveloperidstatus.googleapis.com/", + "schemas": { + "PackageRegistrationStatus": { + "description": "Resource message PackageRegistrationStatus.", + "id": "PackageRegistrationStatus", + "properties": { + "certificateFingerprint": { + "description": "Output only. The SHA-256 fingerprint of the public certificate represented as a 64-character lowercase hexadecimal string without any colons or separators (e.g., `d6ac89ed1d0a805aad4b087d06d5f41645b814480b133fbc867ef7498d069e06`).", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Identifier. The name of the package registration status resource. Format: packages/{package}/packageRegistrationStatus `{package}` must follow the specific format: The fully-qualified Android package name with dots ('.') replaced by hyphens ('-') (e.g., `com-example-app` instead of `com.example.app`).", + "type": "string" + }, + "state": { + "description": "Output only. Registration state of the package, or pair.", + "enum": [ + "REGISTRATION_STATE_UNSPECIFIED", + "REGISTERED", + "NOT_REGISTERED", + "REGISTERED_WITH_ANOTHER_CERTIFICATE_FINGERPRINT" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Package is registered with the given certificate fingerprint.", + "Package is not registered with any public certificate.", + "Package is registered with another public certificate fingerprint." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Android Developer ID Status API", + "version": "v1", + "version_module": true +} \ No newline at end of file diff --git a/discovery/androiddeviceprovisioning-v1.json b/discovery/androiddeviceprovisioning-v1.json index 8be4076d0fc..2f399011236 100644 --- a/discovery/androiddeviceprovisioning-v1.json +++ b/discovery/androiddeviceprovisioning-v1.json @@ -309,7 +309,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of devices to show in a page of results. If unset or 0, defaults to 1000. If a value greater than 1000 is specified, it will be coerced to 1000.", + "description": "Optional. The maximum number of devices to show in a page of results. If unset or `0`, defaults to `5000`. If a value greater than `10000` is specified, it will be coerced to `10000`.", "format": "int64", "location": "query", "type": "string" @@ -851,7 +851,7 @@ } } }, - "revision": "20260712", + "revision": "20260803", "rootUrl": "https://androiddeviceprovisioning.googleapis.com/", "schemas": { "ClaimDeviceRequest": { diff --git a/discovery/apihub-v1.json b/discovery/apihub-v1.json index fc8a6ab4264..e3f67922063 100644 --- a/discovery/apihub-v1.json +++ b/discovery/apihub-v1.json @@ -3435,7 +3435,7 @@ } } }, - "revision": "20260720", + "revision": "20260729", "rootUrl": "https://apihub.googleapis.com/", "schemas": { "Empty": { @@ -6500,7 +6500,8 @@ "CLOUD_ENDPOINTS", "API_DISCOVERY", "OTHERS", - "AWS_API_GATEWAY" + "AWS_API_GATEWAY", + "AZURE_API_MANAGEMENT" ], "enumDescriptions": [ "The gateway type is not specified.", @@ -6511,7 +6512,8 @@ "The gateway type is Cloud Endpoints.", "The gateway type is API Discovery.", "The gateway type for any other types of gateways.", - "The gateway type is AWS API Gateway." + "The gateway type is AWS API Gateway.", + "The gateway type is Azure API Management." ], "type": "string" }, @@ -7401,7 +7403,7 @@ "type": "array" }, "deployments": { - "description": "Optional. The deployments linked to this API version. Note: A particular API version could be deployed to multiple deployments (for dev deployment, UAT deployment, etc) Format is `projects/{project}/locations/{location}/deployments/{deployment}`", + "description": "Optional. The deployments linked directly to this API version. Only directly-linked deployments are returned; deployments linked to this version's specs or operations are not included. Note: A particular API version could be deployed to multiple deployments (for dev deployment, UAT deployment, etc) Format is `projects/{project}/locations/{location}/deployments/{deployment}`", "items": { "type": "string" }, diff --git a/discovery/apikeys-v2.json b/discovery/apikeys-v2.json index 978838122d2..1e4b53e0e7a 100644 --- a/discovery/apikeys-v2.json +++ b/discovery/apikeys-v2.json @@ -336,6 +336,21 @@ "name" ], "parameters": { + "checkExistingUsage": { + "description": "Optional. Defines the behavior for checking existing usage when updating a key.", + "enum": [ + "CHECK_EXISTING_USAGE_UNSPECIFIED", + "SKIP", + "CHECK" + ], + "enumDescriptions": [ + "When unset, the default behavior is used, which is SKIP.", + "If set, skip checking existing usage when updating a key.", + "If set, existing usage is checked when updating the key. If the key has usage in the last 7 days, the request returns a FAILED_PRECONDITION error." + ], + "location": "query", + "type": "string" + }, "name": { "description": "Identifier. The resource name of the key. The `name` has the form: `projects//locations/global/keys/`. For example: `projects/123456867718/locations/global/keys/b7ff1f9f-8275-410a-94dd-3855ee9b5dd2` NOTE: Key is a global resource; hence the only supported value for location is `global`.", "location": "path", @@ -396,7 +411,7 @@ } } }, - "revision": "20260317", + "revision": "20260721", "rootUrl": "https://apikeys.googleapis.com/", "schemas": { "Operation": { diff --git a/discovery/cloudasset-v1.json b/discovery/cloudasset-v1.json index b226af562e3..aa451efc69a 100644 --- a/discovery/cloudasset-v1.json +++ b/discovery/cloudasset-v1.json @@ -1102,7 +1102,7 @@ } } }, - "revision": "20260703", + "revision": "20260801", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -3109,7 +3109,7 @@ "properties": { "addRequestHeader": { "$ref": "GoogleIdentityAccesscontextmanagerV1AddRequestHeader", - "description": "Adds additional HTTP request headers." + "description": "Adds an additional HTTP request header." } }, "type": "object" @@ -3174,7 +3174,7 @@ "type": "array" }, "pattern": { - "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be alphanumerical name.", + "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be an alphanumeric name.", "type": "string" }, "service": { @@ -3307,7 +3307,7 @@ "GOOGLE_APIS_VIA_PRIVATE_PATH" ], "enumDescriptions": [ - "Default value. This can not be used.", + "Default value. This cannot be used.", "Enables VPC Accessible Services enforcement for all APIs (including unsupported APIs) for Private Google Access configured with Private VIP and Private Service Connect Endpoint for Global Google APIs that uses 'all-apis' bundle." ], "type": "string" diff --git a/discovery/cloudasset-v1beta1.json b/discovery/cloudasset-v1beta1.json index ba11edfcd65..9ba11221812 100644 --- a/discovery/cloudasset-v1beta1.json +++ b/discovery/cloudasset-v1beta1.json @@ -417,7 +417,7 @@ } } }, - "revision": "20260703", + "revision": "20260801", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -1388,7 +1388,7 @@ "properties": { "addRequestHeader": { "$ref": "GoogleIdentityAccesscontextmanagerV1AddRequestHeader", - "description": "Adds additional HTTP request headers." + "description": "Adds an additional HTTP request header." } }, "type": "object" @@ -1453,7 +1453,7 @@ "type": "array" }, "pattern": { - "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be alphanumerical name.", + "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be an alphanumeric name.", "type": "string" }, "service": { @@ -1586,7 +1586,7 @@ "GOOGLE_APIS_VIA_PRIVATE_PATH" ], "enumDescriptions": [ - "Default value. This can not be used.", + "Default value. This cannot be used.", "Enables VPC Accessible Services enforcement for all APIs (including unsupported APIs) for Private Google Access configured with Private VIP and Private Service Connect Endpoint for Global Google APIs that uses 'all-apis' bundle." ], "type": "string" diff --git a/discovery/cloudasset-v1p1beta1.json b/discovery/cloudasset-v1p1beta1.json index 9fa45981181..45d7ea640f8 100644 --- a/discovery/cloudasset-v1p1beta1.json +++ b/discovery/cloudasset-v1p1beta1.json @@ -207,7 +207,7 @@ } } }, - "revision": "20260703", + "revision": "20260801", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -1084,7 +1084,7 @@ "properties": { "addRequestHeader": { "$ref": "GoogleIdentityAccesscontextmanagerV1AddRequestHeader", - "description": "Adds additional HTTP request headers." + "description": "Adds an additional HTTP request header." } }, "type": "object" @@ -1149,7 +1149,7 @@ "type": "array" }, "pattern": { - "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be alphanumerical name.", + "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be an alphanumeric name.", "type": "string" }, "service": { @@ -1282,7 +1282,7 @@ "GOOGLE_APIS_VIA_PRIVATE_PATH" ], "enumDescriptions": [ - "Default value. This can not be used.", + "Default value. This cannot be used.", "Enables VPC Accessible Services enforcement for all APIs (including unsupported APIs) for Private Google Access configured with Private VIP and Private Service Connect Endpoint for Global Google APIs that uses 'all-apis' bundle." ], "type": "string" diff --git a/discovery/cloudasset-v1p5beta1.json b/discovery/cloudasset-v1p5beta1.json index 37a8813ba3a..6c31fe5ffde 100644 --- a/discovery/cloudasset-v1p5beta1.json +++ b/discovery/cloudasset-v1p5beta1.json @@ -177,7 +177,7 @@ } } }, - "revision": "20260703", + "revision": "20260801", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -1089,7 +1089,7 @@ "properties": { "addRequestHeader": { "$ref": "GoogleIdentityAccesscontextmanagerV1AddRequestHeader", - "description": "Adds additional HTTP request headers." + "description": "Adds an additional HTTP request header." } }, "type": "object" @@ -1154,7 +1154,7 @@ "type": "array" }, "pattern": { - "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be alphanumerical name.", + "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be an alphanumeric name.", "type": "string" }, "service": { @@ -1287,7 +1287,7 @@ "GOOGLE_APIS_VIA_PRIVATE_PATH" ], "enumDescriptions": [ - "Default value. This can not be used.", + "Default value. This cannot be used.", "Enables VPC Accessible Services enforcement for all APIs (including unsupported APIs) for Private Google Access configured with Private VIP and Private Service Connect Endpoint for Global Google APIs that uses 'all-apis' bundle." ], "type": "string" diff --git a/discovery/cloudasset-v1p7beta1.json b/discovery/cloudasset-v1p7beta1.json index f6c1f745bb6..a92a577396f 100644 --- a/discovery/cloudasset-v1p7beta1.json +++ b/discovery/cloudasset-v1p7beta1.json @@ -171,7 +171,7 @@ } } }, - "revision": "20260703", + "revision": "20260801", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -1162,7 +1162,7 @@ "properties": { "addRequestHeader": { "$ref": "GoogleIdentityAccesscontextmanagerV1AddRequestHeader", - "description": "Adds additional HTTP request headers." + "description": "Adds an additional HTTP request header." } }, "type": "object" @@ -1227,7 +1227,7 @@ "type": "array" }, "pattern": { - "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be alphanumerical name.", + "description": "URL pattern to allow. Only patterns of \".googleapis.com/*\", \"www.googleapis.com//*\" and \"*.appspot.com/* forms are supported, where should be an alphanumeric name.", "type": "string" }, "service": { @@ -1360,7 +1360,7 @@ "GOOGLE_APIS_VIA_PRIVATE_PATH" ], "enumDescriptions": [ - "Default value. This can not be used.", + "Default value. This cannot be used.", "Enables VPC Accessible Services enforcement for all APIs (including unsupported APIs) for Private Google Access configured with Private VIP and Private Service Connect Endpoint for Global Google APIs that uses 'all-apis' bundle." ], "type": "string" diff --git a/discovery/cloudidentity-v1.json b/discovery/cloudidentity-v1.json index 75c43df0526..59786fb331b 100644 --- a/discovery/cloudidentity-v1.json +++ b/discovery/cloudidentity-v1.json @@ -2311,7 +2311,7 @@ } } }, - "revision": "20260617", + "revision": "20260803", "rootUrl": "https://cloudidentity.googleapis.com/", "schemas": { "AddIdpCredentialOperationMetadata": { @@ -4657,7 +4657,7 @@ "id": "Setting", "properties": { "type": { - "description": "Required. Immutable. The type of the Setting. .", + "description": "Required. Immutable. The type of the Setting.", "type": "string" }, "value": { diff --git a/discovery/cloudidentity-v1beta1.json b/discovery/cloudidentity-v1beta1.json index f242fb891fa..0bc44d8bb58 100644 --- a/discovery/cloudidentity-v1beta1.json +++ b/discovery/cloudidentity-v1beta1.json @@ -2349,7 +2349,7 @@ } } }, - "revision": "20260722", + "revision": "20260803", "rootUrl": "https://cloudidentity.googleapis.com/", "schemas": { "AddIdpCredentialOperationMetadata": { @@ -5794,7 +5794,7 @@ "id": "Setting", "properties": { "type": { - "description": "Required. Immutable. The type of the Setting. .", + "description": "Required. Immutable. The type of the Setting.", "type": "string" }, "value": { diff --git a/discovery/cloudsearch-v1.json b/discovery/cloudsearch-v1.json index 8c36a873116..73237c497b2 100644 --- a/discovery/cloudsearch-v1.json +++ b/discovery/cloudsearch-v1.json @@ -1020,6 +1020,11 @@ "location": "query", "type": "string" }, + "requestOptions.countryCode": { + "description": "Optional. Specifies the country/region where the query originated, as a lowercase ISO 3166-1 alpha-2 region code (using 'uk' instead of 'gb' for the United Kingdom).", + "location": "query", + "type": "string" + }, "requestOptions.debugOptions.enableDebugging": { "description": "If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.", "location": "query", @@ -2106,7 +2111,7 @@ } } }, - "revision": "20260610", + "revision": "20260729", "rootUrl": "https://cloudsearch.googleapis.com/", "schemas": { "Action": { @@ -6894,6 +6899,10 @@ "description": "The BCP-47 language code, such as \"pt\" or \"en\". It represents the user's preferred Display Language.", "type": "string" }, + "countryCode": { + "description": "Optional. Specifies the country/region where the query originated, as a lowercase ISO 3166-1 alpha-2 region code (using 'uk' instead of 'gb' for the United Kingdom).", + "type": "string" + }, "debugOptions": { "$ref": "DebugOptions", "description": "Debug options of the request" diff --git a/discovery/compute-v1.json b/discovery/compute-v1.json index 7f8a088e27f..d20567b9fa3 100644 --- a/discovery/compute-v1.json +++ b/discovery/compute-v1.json @@ -48715,7 +48715,7 @@ } } }, - "revision": "20260722", + "revision": "20260729", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -48863,6 +48863,11 @@ "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", "type": "string" }, + "resourceMetadata": { + "$ref": "ResourceMetadata", + "description": "Output only. Contains standard resource metadata for an AcceleratorType\nresource. It is populated for each instance of the AcceleratorType\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", + "readOnly": true + }, "selfLink": { "description": "Output only. [Output Only] Server-defined, fully qualified URL for this resource.", "readOnly": true, @@ -49014,7 +49019,7 @@ "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 }", + "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": { @@ -49171,7 +49176,7 @@ "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 }", + "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": { @@ -49308,7 +49313,7 @@ "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 }", + "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": { @@ -49725,7 +49730,7 @@ "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 }", + "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": { @@ -49882,7 +49887,7 @@ "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 }", + "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": { @@ -50019,7 +50024,7 @@ "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 }", + "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": { @@ -50913,7 +50918,7 @@ "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 }", + "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": { @@ -51070,7 +51075,7 @@ "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 }", + "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": { @@ -51265,7 +51270,7 @@ "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 }", + "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": { @@ -51854,7 +51859,7 @@ "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 }", + "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": { @@ -52141,7 +52146,7 @@ "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 }", + "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": { @@ -52297,7 +52302,7 @@ "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 }", + "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": { @@ -52459,7 +52464,7 @@ "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 }", + "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": { @@ -53013,7 +53018,7 @@ "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 }", + "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": { @@ -53473,7 +53478,7 @@ "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 }", + "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": { @@ -53630,7 +53635,7 @@ "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 }", + "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": { @@ -54008,7 +54013,7 @@ "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 }", + "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": { @@ -55219,7 +55224,7 @@ "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 }", + "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": { @@ -55376,7 +55381,7 @@ "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 }", + "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": { @@ -55539,7 +55544,7 @@ "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 }", + "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": { @@ -55769,7 +55774,7 @@ "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 }", + "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": { @@ -55958,7 +55963,7 @@ "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 }", + "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": { @@ -56119,7 +56124,7 @@ "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 }", + "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": { @@ -56459,7 +56464,7 @@ "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 }", + "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": { @@ -57121,7 +57126,7 @@ "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 }", + "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": { @@ -57353,7 +57358,7 @@ "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 }", + "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": { @@ -57643,7 +57648,7 @@ "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 }", + "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": { @@ -57800,7 +57805,7 @@ "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 }", + "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": { @@ -57937,7 +57942,7 @@ "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 }", + "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": { @@ -58121,7 +58126,7 @@ "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 }", + "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": { @@ -58429,7 +58434,7 @@ "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 }", + "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": { @@ -58712,7 +58717,7 @@ "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 }", + "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": { @@ -59065,7 +59070,7 @@ "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 }", + "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": { @@ -59258,7 +59263,7 @@ "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 }", + "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": { @@ -59545,7 +59550,7 @@ "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 }", + "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": { @@ -60352,7 +60357,7 @@ "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 }", + "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": { @@ -60521,7 +60526,7 @@ "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 }", + "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": { @@ -60686,7 +60691,7 @@ "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 }", + "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": { @@ -60833,6 +60838,11 @@ "description": "Name of reservations where the capacity is provisioned at the time of\ndelivery of future reservations. If the reservation with the given name\ndoes not exist already, it is created automatically at the time of Approval\nwith INACTIVE state till specified start-time. Either provide the\nreservation_name or a name_prefix.", "type": "string" }, + "resourceMetadata": { + "$ref": "ResourceMetadata", + "description": "Output only. Contains standard resource metadata for an FutureReservation\nresource. It is populated for each instance of the FutureReservation\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", + "readOnly": true + }, "schedulingType": { "description": "Maintenance information for this reservation", "enum": [ @@ -61322,7 +61332,7 @@ "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 }", + "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": { @@ -61489,7 +61499,7 @@ "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 }", + "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": { @@ -61626,7 +61636,7 @@ "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 }", + "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": { @@ -62355,7 +62365,7 @@ "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 }", + "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": { @@ -62960,7 +62970,7 @@ "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 }", + "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": { @@ -63201,7 +63211,7 @@ "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 }", + "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": { @@ -63356,7 +63366,7 @@ "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 }", + "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": { @@ -63630,7 +63640,7 @@ "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 }", + "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": { @@ -63898,7 +63908,7 @@ "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 }", + "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": { @@ -64067,7 +64077,7 @@ "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 }", + "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": { @@ -64204,7 +64214,7 @@ "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 }", + "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": { @@ -64369,7 +64379,7 @@ "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 }", + "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": { @@ -64506,7 +64516,7 @@ "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 }", + "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": { @@ -64746,7 +64756,7 @@ "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 }", + "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": { @@ -64935,7 +64945,7 @@ "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 }", + "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": { @@ -65113,7 +65123,7 @@ "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 }", + "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": { @@ -65605,7 +65615,7 @@ "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 }", + "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": { @@ -65971,7 +65981,7 @@ "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 }", + "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": { @@ -66423,7 +66433,7 @@ "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 }", + "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": { @@ -66827,7 +66837,7 @@ "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 }", + "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": { @@ -67333,7 +67343,7 @@ "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 }", + "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": { @@ -67667,7 +67677,7 @@ "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 }", + "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": { @@ -67827,7 +67837,7 @@ "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 }", + "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": { @@ -68268,7 +68278,7 @@ "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 }", + "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": { @@ -68551,7 +68561,7 @@ "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 }", + "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": { @@ -68938,7 +68948,7 @@ "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 }", + "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": { @@ -69757,7 +69767,7 @@ "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 }", + "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": { @@ -69936,7 +69946,7 @@ "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 }", + "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": { @@ -70197,7 +70207,7 @@ "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 }", + "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": { @@ -70367,7 +70377,7 @@ "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 }", + "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": { @@ -70543,7 +70553,7 @@ "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 }", + "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": { @@ -70700,7 +70710,7 @@ "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 }", + "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": { @@ -71268,7 +71278,7 @@ "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 }", + "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": { @@ -71425,7 +71435,7 @@ "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 }", + "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": { @@ -71562,7 +71572,7 @@ "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 }", + "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": { @@ -71926,7 +71936,7 @@ "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 }", + "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": { @@ -72345,7 +72355,7 @@ "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 }", + "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": { @@ -72624,7 +72634,7 @@ "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 }", + "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": { @@ -72786,7 +72796,7 @@ "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 }", + "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": { @@ -73645,7 +73655,7 @@ "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 }", + "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": { @@ -74165,7 +74175,7 @@ "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 }", + "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": { @@ -74518,7 +74528,7 @@ "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 }", + "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": { @@ -74700,7 +74710,7 @@ "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 }", + "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": { @@ -75482,7 +75492,7 @@ "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 }", + "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": { @@ -75722,7 +75732,7 @@ "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 }", + "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": { @@ -76060,7 +76070,7 @@ "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 }", + "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": { @@ -76620,7 +76630,7 @@ "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 }", + "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": { @@ -77115,7 +77125,7 @@ "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 }", + "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": { @@ -77283,7 +77293,7 @@ "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 }", + "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": { @@ -77693,7 +77703,7 @@ "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 }", + "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": { @@ -77980,7 +77990,7 @@ "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 }", + "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": { @@ -78137,7 +78147,7 @@ "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 }", + "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": { @@ -78274,7 +78284,7 @@ "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 }", + "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": { @@ -79158,7 +79168,7 @@ "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 }", + "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": { @@ -79371,7 +79381,7 @@ "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 }", + "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": { @@ -79508,7 +79518,7 @@ "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 }", + "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": { @@ -79733,7 +79743,7 @@ "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 }", + "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": { @@ -79870,7 +79880,7 @@ "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 }", + "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": { @@ -80192,7 +80202,7 @@ "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 }", + "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": { @@ -80401,7 +80411,7 @@ "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 }", + "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": { @@ -80640,7 +80650,7 @@ "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 }", + "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": { @@ -80778,7 +80788,7 @@ "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 }", + "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": { @@ -80963,7 +80973,7 @@ "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 }", + "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": { @@ -81276,7 +81286,7 @@ "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 }", + "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": { @@ -82330,7 +82340,7 @@ "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 }", + "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": { @@ -82821,7 +82831,7 @@ "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 }", + "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": { @@ -83010,7 +83020,7 @@ "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 }", + "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": { @@ -83310,7 +83320,7 @@ "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 }", + "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": { @@ -83465,7 +83475,7 @@ "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 }", + "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": { @@ -83762,7 +83772,7 @@ "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 }", + "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": { @@ -83919,7 +83929,7 @@ "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 }", + "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": { @@ -84071,7 +84081,7 @@ "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 }", + "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": { @@ -84306,7 +84316,7 @@ "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 }", + "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": { @@ -84463,7 +84473,7 @@ "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 }", + "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": { @@ -84600,7 +84610,7 @@ "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 }", + "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": { @@ -84813,7 +84823,7 @@ "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 }", + "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": { @@ -84996,7 +85006,7 @@ "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 }", + "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": { @@ -85133,7 +85143,7 @@ "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 }", + "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": { @@ -85431,7 +85441,7 @@ "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 }", + "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": { @@ -85601,7 +85611,7 @@ "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 }", + "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": { @@ -85757,7 +85767,7 @@ "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 }", + "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": { @@ -85894,7 +85904,7 @@ "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 }", + "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": { @@ -86283,7 +86293,7 @@ "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 }", + "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": { @@ -86489,7 +86499,7 @@ "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 }", + "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": { @@ -86698,7 +86708,7 @@ "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 }", + "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": { @@ -87235,7 +87245,7 @@ "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 }", + "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": { @@ -87824,7 +87834,7 @@ "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 }", + "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": { @@ -88161,7 +88171,7 @@ "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 }", + "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": { @@ -88316,7 +88326,7 @@ "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 }", + "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": { @@ -88537,7 +88547,7 @@ "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 }", + "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": { @@ -89121,7 +89131,7 @@ "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 }", + "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": { @@ -89328,7 +89338,7 @@ "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 }", + "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": { @@ -89484,7 +89494,7 @@ "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 }", + "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": { @@ -89700,7 +89710,7 @@ "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 }", + "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": { @@ -89874,7 +89884,7 @@ "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 }", + "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": { @@ -90058,7 +90068,7 @@ "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 }", + "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": { @@ -90328,7 +90338,7 @@ "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 }", + "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": { @@ -90606,7 +90616,7 @@ "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 }", + "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": { @@ -90805,7 +90815,7 @@ "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 }", + "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": { @@ -91197,7 +91207,7 @@ "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 }", + "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": { @@ -91366,6 +91376,11 @@ "$ref": "AllocationReservationSharingPolicy", "description": "Specify the reservation sharing policy. If unspecified, the reservation\nwill not be shared with Google Cloud managed services." }, + "resourceMetadata": { + "$ref": "ResourceMetadata", + "description": "Output only. [Output Only] Contains standard resource metadata for an Allocation\nresource. It is populated for each instance of the Allocation\nresource, and includes the api_version the\ninstance was retrieved through, and its canonical\nresource_type name.", + "readOnly": true + }, "resourcePolicies": { "additionalProperties": { "type": "string" @@ -91635,7 +91650,7 @@ "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 }", + "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": { @@ -91995,7 +92010,7 @@ "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 }", + "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": { @@ -92151,7 +92166,7 @@ "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 }", + "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": { @@ -92479,7 +92494,7 @@ "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 }", + "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": { @@ -92824,7 +92839,7 @@ "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 }", + "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": { @@ -93084,7 +93099,7 @@ "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 }", + "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": { @@ -93154,6 +93169,21 @@ }, "type": "object" }, + "ResourceMetadata": { + "description": "Standardized resource metadata common to all compute resources.", + "id": "ResourceMetadata", + "properties": { + "apiVersion": { + "description": "The version of the API interface that this resource was retrieved through.\nFor example, `\"2025-01-01\"` or `\"2025-01-01-preview\"`.", + "type": "string" + }, + "resourceType": { + "description": "The canonical resource type name in the format of a resource type\nas defined by [AIP-123](https://google.aip.dev/123).\nFor example, `\"compute.googleapis.com/Instance\"`.", + "type": "string" + } + }, + "type": "object" + }, "ResourcePoliciesScopedList": { "id": "ResourcePoliciesScopedList", "properties": { @@ -93265,7 +93295,7 @@ "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 }", + "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": { @@ -93524,7 +93554,7 @@ "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 }", + "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": { @@ -93814,7 +93844,7 @@ "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 }", + "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": { @@ -94878,7 +94908,7 @@ "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 }", + "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": { @@ -95166,7 +95196,7 @@ "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 }", + "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": { @@ -95479,7 +95509,7 @@ "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 }", + "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": { @@ -95669,7 +95699,7 @@ "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 }", + "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": { @@ -96022,7 +96052,7 @@ "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 }", + "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": { @@ -96504,7 +96534,7 @@ "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 }", + "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": { @@ -97336,7 +97366,7 @@ "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 }", + "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": { @@ -97503,7 +97533,7 @@ "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 }", + "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": { @@ -97670,7 +97700,7 @@ "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 }", + "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": { @@ -97817,7 +97847,7 @@ "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 }", + "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": { @@ -98419,7 +98449,7 @@ "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 }", + "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": { @@ -98565,7 +98595,7 @@ "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 }", + "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": { @@ -99108,7 +99138,7 @@ "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 }", + "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": { @@ -99490,7 +99520,7 @@ "type": "string" }, "enforceOnKey": { - "description": "Determines the key to enforce the rate_limit_threshold on. Possible\nvalues are:\n \n - ALL: A single rate limit threshold is applied to all\n the requests matching this rule. This is the default value if\n \"enforceOnKey\" is not configured.\n - IP: The source IP address of\n the request is the key. Each IP has this limit enforced\n separately.\n - HTTP_HEADER: The value of the HTTP\n header whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the header value. If no\n such header is present in the request, the key type defaults toALL.\n - XFF_IP: The first IP address (i.e. the\n originating client IP address) specified in the list of IPs under\n X-Forwarded-For HTTP header. If no such header is present or the value\n is not a valid IP, the key defaults to the source IP address of\n the request i.e. key type IP.\n - HTTP_COOKIE: The value of the HTTP\n cookie whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the cookie value. If no\n such cookie is present in the request, the key type defaults toALL.\n - HTTP_PATH: The URL path of the HTTP request. The key\n value is truncated to the first 128 bytes. \n - SNI: Server name indication in the TLS session of the\n HTTPS request. The key value is truncated to the first 128 bytes. The\n key type defaults to ALL on a HTTP session. \n - REGION_CODE: The country/region from which the request\n originates. \n - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n - USER_IP: The IP address of the originating client,\n which is resolved based on \"userIpRequestHeaders\" configured with the\n security policy. If there is no \"userIpRequestHeaders\" configuration or\n an IP address cannot be resolved from it, the key type defaults toIP. \n\n- TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the\nclient connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\nkey type defaults to ALL. \nFor \"fairshare\" action, this value is limited to ALL i.e. a single rate\nlimit threshold is enforced for all the requests matching the rule.", + "description": "Determines the key to enforce the rate_limit_threshold on. Possible\nvalues are:\n \n - ALL: A single rate limit threshold is applied to all\n the requests matching this rule. This is the default value if\n \"enforceOnKey\" is not configured.\n - IP: The source IP address of\n the request is the key. Each IP has this limit enforced\n separately.\n - HTTP_HEADER: The value of the HTTP\n header whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the header value. If no\n such header is present in the request, the key type defaults toALL.\n - XFF_IP: The first IP address (i.e. the\n originating client IP address) specified in the list of IPs under\n X-Forwarded-For HTTP header. If no such header is present or the value\n is not a valid IP, the key defaults to the source IP address of\n the request i.e. key type IP.\n - HTTP_COOKIE: The value of the HTTP\n cookie whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the cookie value. If no\n such cookie is present in the request, the key type defaults toALL.\n - HTTP_PATH: The URL path of the HTTP request. The key\n value is truncated to the first 128 bytes. \n - SNI: Server name indication in the TLS session of the\n HTTPS request. The key value is truncated to the first 128 bytes. The\n key type defaults to ALL on a HTTP session. \n - REGION_CODE: The country/region from which the request\n originates. \n - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n - USER_IP: The IP address of the originating client,\n which is resolved based on \"userIpRequestHeaders\" configured with the\n security policy. If there is no \"userIpRequestHeaders\" configuration or\n an IP address cannot be resolved from it, the key type defaults toIP. \n - ASN: The autonomous system number of the originating\n client. If not available, the key type defaults toALL.\n - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n\n\nFor \"fairshare\" action, this value is limited to ALL i.e. a single rate\nlimit threshold is enforced for all the requests matching the rule.", "enum": [ "ALL", "HTTP_COOKIE", @@ -99553,7 +99583,7 @@ "type": "string" }, "enforceOnKeyType": { - "description": "Determines the key to enforce the rate_limit_threshold on. Possible\nvalues are:\n \n - ALL: A single rate limit threshold is applied to all\n the requests matching this rule. This is the default value if\n \"enforceOnKeyConfigs\" is not configured.\n - IP: The source IP address of\n the request is the key. Each IP has this limit enforced\n separately.\n - HTTP_HEADER: The value of the HTTP\n header whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the header value. If no\n such header is present in the request, the key type defaults toALL.\n - XFF_IP: The first IP address (i.e. the\n originating client IP address) specified in the list of IPs under\n X-Forwarded-For HTTP header. If no such header is present or the\n value is not a valid IP, the key defaults to the source IP address of\n the request i.e. key type IP.\n - HTTP_COOKIE: The value of the HTTP\n cookie whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the cookie value. If no\n such cookie is present in the request, the key type defaults toALL.\n - HTTP_PATH: The URL path of the HTTP request. The key\n value is truncated to the first 128 bytes. \n - SNI: Server name indication in the TLS session of\n the HTTPS request. The key value is truncated to the first 128 bytes.\n The key type defaults to ALL on a HTTP session. \n - REGION_CODE: The country/region from which the\n request originates. \n - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n - USER_IP: The IP address of the originating client,\n which is resolved based on \"userIpRequestHeaders\" configured with the\n security policy. If there is no \"userIpRequestHeaders\" configuration\n or an IP address cannot be resolved from it, the key type defaults toIP. \n\n- TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the\nclient connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\nkey type defaults to ALL.", + "description": "Determines the key to enforce the rate_limit_threshold on. Possible\nvalues are:\n \n - ALL: A single rate limit threshold is applied to all\n the requests matching this rule. This is the default value if\n \"enforceOnKeyConfigs\" is not configured.\n - IP: The source IP address of\n the request is the key. Each IP has this limit enforced\n separately.\n - HTTP_HEADER: The value of the HTTP\n header whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the header value. If no\n such header is present in the request, the key type defaults toALL.\n - XFF_IP: The first IP address (i.e. the\n originating client IP address) specified in the list of IPs under\n X-Forwarded-For HTTP header. If no such header is present or the\n value is not a valid IP, the key defaults to the source IP address of\n the request i.e. key type IP.\n - HTTP_COOKIE: The value of the HTTP\n cookie whose name is configured under \"enforceOnKeyName\". The key\n value is truncated to the first 128 bytes of the cookie value. If no\n such cookie is present in the request, the key type defaults toALL.\n - HTTP_PATH: The URL path of the HTTP request. The key\n value is truncated to the first 128 bytes. \n - SNI: Server name indication in the TLS session of\n the HTTPS request. The key value is truncated to the first 128 bytes.\n The key type defaults to ALL on a HTTP session. \n - REGION_CODE: The country/region from which the\n request originates. \n - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL. \n - USER_IP: The IP address of the originating client,\n which is resolved based on \"userIpRequestHeaders\" configured with the\n security policy. If there is no \"userIpRequestHeaders\" configuration\n or an IP address cannot be resolved from it, the key type defaults toIP. \n - ASN: The autonomous system number of the originating\n client. If not available, the key type defaults toALL.\n - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the\n client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the\n key type defaults to ALL.", "enum": [ "ALL", "HTTP_COOKIE", @@ -100036,7 +100066,7 @@ "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 }", + "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": { @@ -100270,7 +100300,7 @@ "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 }", + "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": { @@ -100407,7 +100437,7 @@ "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 }", + "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": { @@ -101029,7 +101059,7 @@ "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 }", + "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": { @@ -101523,7 +101553,7 @@ "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 }", + "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": { @@ -101680,7 +101710,7 @@ "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 }", + "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": { @@ -101893,7 +101923,7 @@ "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 }", + "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": { @@ -102061,7 +102091,7 @@ "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 }", + "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": { @@ -102220,7 +102250,7 @@ "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 }", + "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": { @@ -102369,7 +102399,7 @@ "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 }", + "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": { @@ -102605,7 +102635,7 @@ "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 }", + "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": { @@ -103042,7 +103072,7 @@ "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 }", + "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": { @@ -103319,7 +103349,7 @@ "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 }", + "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": { @@ -103488,7 +103518,7 @@ "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 }", + "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": { @@ -103855,7 +103885,7 @@ "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 }", + "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": { @@ -104012,7 +104042,7 @@ "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 }", + "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": { @@ -104149,7 +104179,7 @@ "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 }", + "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": { @@ -104286,7 +104316,7 @@ "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 }", + "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": { @@ -104692,7 +104722,7 @@ "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 }", + "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": { @@ -104849,7 +104879,7 @@ "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 }", + "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": { @@ -105165,7 +105195,7 @@ "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 }", + "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": { @@ -105299,7 +105329,7 @@ "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 }", + "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": { @@ -105611,7 +105641,7 @@ "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 }", + "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": { @@ -105748,7 +105778,7 @@ "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 }", + "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": { @@ -106005,7 +106035,7 @@ "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 }", + "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": { @@ -106142,7 +106172,7 @@ "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 }", + "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": { @@ -106462,7 +106492,7 @@ "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 }", + "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": { @@ -106619,7 +106649,7 @@ "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 }", + "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": { @@ -106847,7 +106877,7 @@ "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 }", + "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": { @@ -107004,7 +107034,7 @@ "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 }", + "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": { @@ -107141,7 +107171,7 @@ "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 }", + "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": { @@ -107400,7 +107430,7 @@ "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 }", + "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": { @@ -107575,7 +107605,7 @@ "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 }", + "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": { @@ -107764,7 +107794,7 @@ "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 }", + "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": { @@ -108048,7 +108078,7 @@ "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 }", + "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": { @@ -108185,7 +108215,7 @@ "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 }", + "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": { @@ -108455,7 +108485,7 @@ "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 }", + "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": { @@ -108612,7 +108642,7 @@ "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 }", + "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": { @@ -108877,7 +108907,7 @@ "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 }", + "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": { @@ -109034,7 +109064,7 @@ "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 }", + "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": { @@ -109184,7 +109214,7 @@ "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 }", + "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": { @@ -109631,7 +109661,7 @@ "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 }", + "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": { @@ -109886,7 +109916,7 @@ "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 }", + "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": { @@ -110023,7 +110053,7 @@ "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 }", + "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": { @@ -110362,7 +110392,7 @@ "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 }", + "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": { @@ -110647,7 +110677,7 @@ "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 }", + "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": { @@ -110784,7 +110814,7 @@ "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 }", + "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": { @@ -111050,7 +111080,7 @@ "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 }", + "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": { @@ -111262,7 +111292,7 @@ "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 }", + "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": { @@ -111534,7 +111564,7 @@ "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 }", + "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": { @@ -111691,7 +111721,7 @@ "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 }", + "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": { @@ -111972,7 +112002,7 @@ "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 }", + "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": { @@ -112301,7 +112331,7 @@ "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 }", + "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": { @@ -112470,7 +112500,7 @@ "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 }", + "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": { @@ -112674,7 +112704,7 @@ "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 }", + "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": { @@ -113050,7 +113080,7 @@ "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 }", + "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": { @@ -113286,7 +113316,7 @@ "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 }", + "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": { @@ -113536,7 +113566,7 @@ "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 }", + "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": { diff --git a/discovery/dataform-v1.json b/discovery/dataform-v1.json index afeb20a684a..ea7d896de8f 100644 --- a/discovery/dataform-v1.json +++ b/discovery/dataform-v1.json @@ -3220,7 +3220,7 @@ } } }, - "revision": "20260702", + "revision": "20260802", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -3424,6 +3424,10 @@ "description": "Optional. The default schema (BigQuery dataset ID).", "type": "string" }, + "pipelineConfig": { + "$ref": "PipelineConfig", + "description": "Optional. The pipeline options which defines the pipeline type and path within the Git repository." + }, "schemaSuffix": { "description": "Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names.", "type": "string" @@ -3641,6 +3645,11 @@ "readOnly": true, "type": "string" }, + "gcsRepositorySnapshotMetadata": { + "$ref": "GcsRepositorySnapshotMetadata", + "description": "Output only. Metadata about the repository snapshot used by scheduled notebooks.", + "readOnly": true + }, "gitCommitish": { "description": "Immutable. Git commit/tag/branch name at which the repository should be compiled. Must exist in the remote repository. Examples: - a commit SHA: `12ade345` - a tag: `tag1` - a branch name: `branch1`", "type": "string" @@ -4133,6 +4142,40 @@ }, "type": "object" }, + "GcsRepositorySnapshotDestination": { + "description": "Configures the destination for a repository snapshot.", + "id": "GcsRepositorySnapshotDestination", + "properties": { + "repositorySnapshotUri": { + "description": "Optional. The Google Cloud Storage destination to upload the repository snapshot to. Format: `gs://bucket-name/path/`.", + "type": "string" + } + }, + "type": "object" + }, + "GcsRepositorySnapshotMetadata": { + "description": "Metadata about a repository snapshot stored in Google Cloud Storage.", + "id": "GcsRepositorySnapshotMetadata", + "properties": { + "crc32cChecksum": { + "description": "Output only. The crc32c checksum of the repository snapshot, big-endian base64 encoded.", + "readOnly": true, + "type": "string" + }, + "generation": { + "description": "Output only. The generation number of the Cloud Storage object. See https://cloud.google.com/storage/docs/metadata#generation-number.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "repositorySnapshotUri": { + "description": "Output only. The Google Cloud Storage URI of the repository snapshot.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GitRemoteSettings": { "description": "Controls Git remote configuration for a repository.", "id": "GitRemoteSettings", @@ -4252,7 +4295,12 @@ "InstallNpmPackagesRequest": { "description": "`InstallNpmPackages` request message.", "id": "InstallNpmPackagesRequest", - "properties": {}, + "properties": { + "pipelineConfig": { + "$ref": "PipelineConfig", + "description": "Optional. The pipeline options which defines the pipeline type and path within the Git repository." + } + }, "type": "object" }, "InstallNpmPackagesResponse": { @@ -4698,6 +4746,11 @@ "readOnly": true, "type": "string" }, + "filePath": { + "description": "Output only. The path to the notebook file in the repository.", + "readOnly": true, + "type": "string" + }, "jobId": { "description": "Output only. The ID of the Gemini Enterprise Agent Platform job that executed the notebook in contents and also the ID used for the outputs created in Google Cloud Storage buckets. Only set once the job has started to run.", "readOnly": true, @@ -4717,6 +4770,10 @@ "gcsOutputBucket": { "description": "Optional. The Google Cloud Storage location to upload the result to. Format: `gs://bucket-name`.", "type": "string" + }, + "gcsRepositorySnapshotDestination": { + "$ref": "GcsRepositorySnapshotDestination", + "description": "Optional. The Google Cloud Storage destination to upload the snapshot to. For empty URI it defaults to the provided gcs_output_bucket. Format: `gs://bucket-name/path/`." } }, "type": "object" @@ -4840,6 +4897,33 @@ }, "type": "object" }, + "PipelineConfig": { + "description": "Defines the pipeline type and path within the Git repository.", + "id": "PipelineConfig", + "properties": { + "path": { + "description": "Required. The relative path within the Git repository where the pipeline is defined. For example, for a Dataform pipeline, it is a path to the folder where `workflow_settings.yaml` or `dataform.json` is located.", + "type": "string" + }, + "pipelineType": { + "description": "Required. The type of the pipeline.", + "enum": [ + "PIPELINE_TYPE_UNSPECIFIED", + "DATAFORM", + "SQL", + "NOTEBOOK" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Regular Dataform pipeline.", + "SQL single file asset.", + "Notebook single file asset." + ], + "type": "string" + } + }, + "type": "object" + }, "Policy": { "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "id": "Policy", @@ -5278,7 +5362,7 @@ "type": "string" }, "timeZone": { - "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC.", + "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the [time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is `UTC`.", "type": "string" } }, @@ -5783,7 +5867,7 @@ "type": "string" }, "timeZone": { - "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC.", + "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the [time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is `UTC`.", "type": "string" }, "updateTime": { @@ -5827,6 +5911,11 @@ "readOnly": true, "type": "string" }, + "pipelineConfig": { + "$ref": "PipelineConfig", + "description": "Output only. The pipeline options which defines the pipeline type and path within the Git repository.", + "readOnly": true + }, "privateResourceMetadata": { "$ref": "PrivateResourceMetadata", "description": "Output only. Metadata indicating whether this resource is user-scoped. `WorkflowInvocation` resource is `user_scoped` only if it is sourced from a compilation result and the compilation result is user-scoped.", diff --git a/discovery/dataform-v1beta1.json b/discovery/dataform-v1beta1.json index 60d3050e401..df351a52091 100644 --- a/discovery/dataform-v1beta1.json +++ b/discovery/dataform-v1beta1.json @@ -3261,7 +3261,7 @@ } } }, - "revision": "20260702", + "revision": "20260802", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "ActionErrorTable": { @@ -3465,6 +3465,10 @@ "description": "Optional. The default schema (BigQuery dataset ID).", "type": "string" }, + "pipelineConfig": { + "$ref": "PipelineConfig", + "description": "Optional. The pipeline options which defines the pipeline type and path within the Git repository." + }, "schemaSuffix": { "description": "Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names.", "type": "string" @@ -3682,6 +3686,11 @@ "readOnly": true, "type": "string" }, + "gcsRepositorySnapshotMetadata": { + "$ref": "GcsRepositorySnapshotMetadata", + "description": "Output only. Metadata about the repository snapshot used by scheduled notebooks.", + "readOnly": true + }, "gitCommitish": { "description": "Immutable. Git commit/tag/branch name at which the repository should be compiled. Must exist in the remote repository. Examples: - a commit SHA: `12ade345` - a tag: `tag1` - a branch name: `branch1`", "type": "string" @@ -4185,6 +4194,40 @@ }, "type": "object" }, + "GcsRepositorySnapshotDestination": { + "description": "Configures the destination for a repository snapshot.", + "id": "GcsRepositorySnapshotDestination", + "properties": { + "repositorySnapshotUri": { + "description": "Optional. The Google Cloud Storage destination to upload the repository snapshot to. Format: `gs://bucket-name/path/`.", + "type": "string" + } + }, + "type": "object" + }, + "GcsRepositorySnapshotMetadata": { + "description": "Metadata about a repository snapshot stored in Google Cloud Storage.", + "id": "GcsRepositorySnapshotMetadata", + "properties": { + "crc32cChecksum": { + "description": "Output only. The crc32c checksum of the repository snapshot, big-endian base64 encoded.", + "readOnly": true, + "type": "string" + }, + "generation": { + "description": "Output only. The generation number of the Cloud Storage object. See https://cloud.google.com/storage/docs/metadata#generation-number.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "repositorySnapshotUri": { + "description": "Output only. The Google Cloud Storage URI of the repository snapshot.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GitRemoteSettings": { "description": "Controls Git remote configuration for a repository.", "id": "GitRemoteSettings", @@ -4304,7 +4347,12 @@ "InstallNpmPackagesRequest": { "description": "`InstallNpmPackages` request message.", "id": "InstallNpmPackagesRequest", - "properties": {}, + "properties": { + "pipelineConfig": { + "$ref": "PipelineConfig", + "description": "Optional. The pipeline options which defines the pipeline type and path within the Git repository." + } + }, "type": "object" }, "InstallNpmPackagesResponse": { @@ -4750,6 +4798,11 @@ "readOnly": true, "type": "string" }, + "filePath": { + "description": "Output only. The path to the notebook file in the repository.", + "readOnly": true, + "type": "string" + }, "jobId": { "description": "Output only. The ID of the Gemini Enterprise Agent Platform job that executed the notebook in contents and also the ID used for the outputs created in Google Cloud Storage buckets. Only set once the job has started to run.", "readOnly": true, @@ -4769,6 +4822,10 @@ "gcsOutputBucket": { "description": "Optional. The Google Cloud Storage location to upload the result to. Format: `gs://bucket-name`.", "type": "string" + }, + "gcsRepositorySnapshotDestination": { + "$ref": "GcsRepositorySnapshotDestination", + "description": "Optional. The Google Cloud Storage destination to upload the snapshot to. For empty URI it defaults to the provided gcs_output_bucket. Format: `gs://bucket-name/path/`." } }, "type": "object" @@ -4892,6 +4949,33 @@ }, "type": "object" }, + "PipelineConfig": { + "description": "Defines the pipeline type and path within the Git repository.", + "id": "PipelineConfig", + "properties": { + "path": { + "description": "Required. The relative path within the Git repository where the pipeline is defined. For example, for a Dataform pipeline, it is a path to the folder where `workflow_settings.yaml` or `dataform.json` is located.", + "type": "string" + }, + "pipelineType": { + "description": "Required. The type of the pipeline.", + "enum": [ + "PIPELINE_TYPE_UNSPECIFIED", + "DATAFORM", + "SQL", + "NOTEBOOK" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Regular Dataform pipeline.", + "SQL single file asset.", + "Notebook single file asset." + ], + "type": "string" + } + }, + "type": "object" + }, "Policy": { "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", "id": "Policy", @@ -5330,7 +5414,7 @@ "type": "string" }, "timeZone": { - "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC.", + "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the [time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is `UTC`.", "type": "string" } }, @@ -5870,7 +5954,7 @@ "type": "string" }, "timeZone": { - "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC.", + "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the [time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is `UTC`.", "type": "string" }, "updateTime": { @@ -5881,7 +5965,7 @@ }, "workflowTriggerConfig": { "$ref": "WorkflowTriggerConfig", - "description": "Optional. Optional trigger configuration for this workflow. If present, the workflow will be triggered based on the specified triggers." + "description": "Optional. Trigger configuration for this workflow. If present, the workflow will be triggered based on the specified triggers." } }, "type": "object" @@ -5918,6 +6002,11 @@ "readOnly": true, "type": "string" }, + "pipelineConfig": { + "$ref": "PipelineConfig", + "description": "Output only. The pipeline options which defines the pipeline type and path within the Git repository.", + "readOnly": true + }, "privateResourceMetadata": { "$ref": "PrivateResourceMetadata", "description": "Output only. Metadata indicating whether this resource is user-scoped. `WorkflowInvocation` resource is `user_scoped` only if it is sourced from a compilation result and the compilation result is user-scoped.", @@ -6067,7 +6156,7 @@ "type": "string" }, "minExecutionDuration": { - "description": "Optional. Minimum duration between two consecutive executions. If not specified, the workflow will be executed every time trigger conditions are met and no ongoing workflow execution.", + "description": "Optional. Minimum duration between two consecutive executions. If not specified, the workflow will be executed every time trigger conditions are met and there is no ongoing workflow execution.", "format": "google-duration", "type": "string" }, diff --git a/discovery/developerknowledge-v1.json b/discovery/developerknowledge-v1.json index 50c6ddb2398..187c7c526b2 100644 --- a/discovery/developerknowledge-v1.json +++ b/discovery/developerknowledge-v1.json @@ -115,7 +115,7 @@ "parameterOrder": [], "parameters": { "names": { - "description": "Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` ", + "description": "Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` Each name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. ", "location": "query", "repeated": true, "type": "string" @@ -156,7 +156,7 @@ ], "parameters": { "name": { - "description": "Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`", + "description": "Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` The name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error.", "location": "path", "pattern": "^documents/.*$", "required": true, @@ -212,7 +212,7 @@ "type": "string" }, "query": { - "description": "Required. Provides the raw query string provided by the user, such as \"How to create a Cloud Storage bucket?\".", + "description": "Required. Provides the raw query string provided by the user, such as \"How to create a Cloud Storage bucket?\". The query must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error.", "location": "query", "type": "string" } @@ -250,7 +250,7 @@ } } }, - "revision": "20260719", + "revision": "20260802", "rootUrl": "https://developerknowledge.googleapis.com/", "schemas": { "Answer": { @@ -369,7 +369,7 @@ "type": "object" }, "Document": { - "description": "A Document represents a piece of content from the Developer Knowledge corpus.", + "description": "A Document represents a page of documentation in the Developer Knowledge corpus, like the page at https://docs.cloud.google.com/storage/docs/creating-buckets.", "id": "Document", "properties": { "content": { @@ -477,7 +477,7 @@ "id": "SearchDocumentChunksResponse", "properties": { "nextPageToken": { - "description": "Optional. Provides a token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "description": "Provides a token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "results": { diff --git a/discovery/developerknowledge-v1alpha.json b/discovery/developerknowledge-v1alpha.json index e1c63305eac..7c4fc4a2151 100644 --- a/discovery/developerknowledge-v1alpha.json +++ b/discovery/developerknowledge-v1alpha.json @@ -115,7 +115,7 @@ "parameterOrder": [], "parameters": { "names": { - "description": "Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` ", + "description": "Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` Each name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. ", "location": "query", "repeated": true, "type": "string" @@ -156,7 +156,7 @@ ], "parameters": { "name": { - "description": "Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`", + "description": "Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` The name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error.", "location": "path", "pattern": "^documents/.*$", "required": true, @@ -212,7 +212,7 @@ "type": "string" }, "query": { - "description": "Required. Provides the raw query string provided by the user, such as \"How to create a Cloud Storage bucket?\".", + "description": "Required. Provides the raw query string provided by the user, such as \"How to create a Cloud Storage bucket?\". The query must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error.", "location": "query", "type": "string" } @@ -250,7 +250,7 @@ } } }, - "revision": "20260719", + "revision": "20260802", "rootUrl": "https://developerknowledge.googleapis.com/", "schemas": { "Answer": { @@ -311,6 +311,10 @@ "description": "Request message for DeveloperKnowledge.AnswerQuery.", "id": "AnswerQueryRequest", "properties": { + "filter": { + "description": "Optional. Applies a strict filter to the search results used to ground the answer. The expression supports a subset of the syntax described at https://google.aip.dev/160. Supported fields for filtering: * `content_length_bytes` (INTEGER): The length of the `Document.content` field in bytes. * `data_source` (STRING): The source of the document, e.g. `docs.cloud.google.com`. See https://developers.google.com/knowledge/reference/corpus-reference for the complete list of data sources in the corpus. * `update_time` (TIMESTAMP): The timestamp of when the document was last meaningfully updated. A meaningful update is one that changes document's markdown content or metadata. * `uri` (STRING): The document URI, e.g. `https://docs.cloud.google.com/bigquery/docs/tables`. INTEGER fields support `=`, `<`, `<=`, `>`, and `>=` operators. STRING fields support `=` (equals) and `!=` (not equals) operators for **exact match** on the whole string. Partial match, prefix match, and regexp match are not supported. TIMESTAMP fields support `=`, `<`, `<=`, `>`, and `>=` operators. Timestamps must be in RFC-3339 format, e.g., `\"2025-01-01T00:00:00Z\"`. You can combine expressions using `AND`, `OR`, and `NOT` (or `-`) logical operators. `OR` has higher precedence than `AND`. Use parentheses for explicit precedence grouping. Examples: * Filter by `Document.content_length_bytes`: `content_length_bytes < 50000` * `data_source = \"docs.cloud.google.com\" OR data_source = \"firebase.google.com\"` * `data_source != \"firebase.google.com\"` * `update_time < \"2024-01-01T00:00:00Z\"` * `update_time >= \"2025-01-22T00:00:00Z\" AND (data_source = \"developer.chrome.com\" OR data_source = \"web.dev\")` * `uri = \"https://docs.cloud.google.com/release-notes\"` The `filter` string must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error.", + "type": "string" + }, "query": { "description": "Required. The query to answer.", "type": "string" @@ -369,7 +373,7 @@ "type": "object" }, "Document": { - "description": "A Document represents a piece of content from the Developer Knowledge corpus.", + "description": "A Document represents a page of documentation in the Developer Knowledge corpus, like the page at https://docs.cloud.google.com/storage/docs/creating-buckets.", "id": "Document", "properties": { "content": { @@ -456,6 +460,12 @@ "description": "Output only. Contains the resource name of the document this chunk is from. Format: `documents/{uri_without_scheme}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`", "readOnly": true, "type": "string" + }, + "relevanceScore": { + "description": "Output only. Represents the relevance score of the chunk to the search query. Higher score indicates higher chunk relevance. The score is in range [0.0, 1.0].", + "format": "double", + "readOnly": true, + "type": "number" } }, "type": "object" @@ -477,7 +487,7 @@ "id": "SearchDocumentChunksResponse", "properties": { "nextPageToken": { - "description": "Optional. Provides a token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "description": "Provides a token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "results": { diff --git a/discovery/discoveryengine-v1.json b/discovery/discoveryengine-v1.json index 02dca11c55f..a967da4636f 100644 --- a/discovery/discoveryengine-v1.json +++ b/discovery/discoveryengine-v1.json @@ -317,6 +317,36 @@ "https://www.googleapis.com/auth/discoveryengine.serving.readwrite" ] }, + "provision": { + "description": "Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:provision", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.provision", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full resource name of a Project, such as `projects/{project_id_or_number}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:provision", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1ProvisionProjectRequest" + }, + "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" + ] + }, "setUpDataConnector": { "description": "Creates a Collection and sets up the DataConnector for it. To stop a DataConnector after setup, use the CollectionService.DeleteCollection method.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:setUpDataConnector", @@ -9712,7 +9742,7 @@ } } }, - "revision": "20260724", + "revision": "20260802", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "A2aV1APIKeySecurityScheme": { @@ -11392,12 +11422,14 @@ "enum": [ "PERSON_TYPE_UNSPECIFIED", "CLOUD_IDENTITY", - "THIRD_PARTY_IDENTITY" + "THIRD_PARTY_IDENTITY", + "GOOGLE_GROUP" ], "enumDescriptions": [ "Default value.", "The suggestion is from a GOOGLE_IDENTITY source.", - "The suggestion is from a THIRD_PARTY_IDENTITY source." + "The suggestion is from a THIRD_PARTY_IDENTITY source.", + "The suggestion is a group (e.g. a Google Group), not an individual." ], "type": "string" }, @@ -13616,7 +13648,7 @@ }, "inlineSource": { "$ref": "GoogleCloudDiscoveryengineV1BatchUpdateUserLicensesRequestInlineSource", - "description": "The inline source for the input content for document embeddings." + "description": "The inline source for the input content for license assignment." } }, "type": "object" @@ -15475,13 +15507,9 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata": { - "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).", + "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).", "id": "GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata", "properties": { - "authenticatedAccount": { - "description": "Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.", - "type": "string" - }, "author": { "description": "Optional. The party that authored the connector, e.g. \"Google\" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).", "type": "string" @@ -16718,7 +16746,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { @@ -22511,6 +22539,17 @@ "readOnly": true, "type": "string" }, + "dataSourceEndUserDisplayName": { + "description": "Output only. The end-user-facing display name of the data source, sourced from `ConnectorSource.end_user_display_name`. When unset, clients fall back to `data_source_display_name`.", + "readOnly": true, + "type": "string" + }, + "dataSourceVersion": { + "description": "Output only. The version of the connector definition backing this collection, mirroring `DataConnector.data_source_version`.", + "format": "double", + "readOnly": true, + "type": "number" + }, "dataStoreComponents": { "description": "For the data store collection, list of the children data stores.", "items": { @@ -22527,6 +22566,16 @@ "readOnly": true, "type": "string" }, + "isFirstParty": { + "description": "Output only. Whether this is a first-party (Google-owned) connector, as opposed to a third-party connector. Used by the frontend to group 1P vs 3P connectors. Sourced from `ConnectorSource.is_first_party` once that field is universally populated (b/534727761); until then derived from `ConnectorSource.connector_type == FIRST_PARTY`.", + "readOnly": true, + "type": "boolean" + }, + "metadata": { + "$ref": "GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata", + "description": "Output only. User-facing connector metadata (`title`, `description`, `short_description`, `author`, `note`), retrieved from the registry `ConnectorSource.metadata` (joined by data source). Shown on the connector detail page.", + "readOnly": true + }, "name": { "description": "The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector.", "type": "string" @@ -22881,7 +22930,7 @@ ], "type": "string" }, - "description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "readOnly": true, "type": "object" }, @@ -26156,13 +26205,9 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata": { - "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).", + "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).", "id": "GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata", "properties": { - "authenticatedAccount": { - "description": "Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.", - "type": "string" - }, "author": { "description": "Optional. The party that authored the connector, e.g. \"Google\" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).", "type": "string" @@ -27281,7 +27326,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { @@ -32865,7 +32910,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { diff --git a/discovery/discoveryengine-v1alpha.json b/discovery/discoveryengine-v1alpha.json index f408dbc87eb..aafcce03a40 100644 --- a/discovery/discoveryengine-v1alpha.json +++ b/discovery/discoveryengine-v1alpha.json @@ -594,6 +594,36 @@ "https://www.googleapis.com/auth/discoveryengine.serving.readwrite" ] }, + "provision": { + "description": "Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}:provision", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.provision", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full resource name of a Project, such as `projects/{project_id_or_number}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:provision", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1alphaProvisionProjectRequest" + }, + "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" + ] + }, "queryConfigurablePricingUsageStats": { "description": "Queries configurable pricing usage stats for a project.", "flatPath": "v1alpha/projects/{projectsId}/locations/{location}:queryConfigurablePricingUsageStats", @@ -13397,7 +13427,7 @@ } } }, - "revision": "20260724", + "revision": "20260802", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -15249,13 +15279,9 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata": { - "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).", + "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).", "id": "GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata", "properties": { - "authenticatedAccount": { - "description": "Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.", - "type": "string" - }, "author": { "description": "Optional. The party that authored the connector, e.g. \"Google\" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).", "type": "string" @@ -16250,7 +16276,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { @@ -18804,12 +18830,14 @@ "enum": [ "PERSON_TYPE_UNSPECIFIED", "CLOUD_IDENTITY", - "THIRD_PARTY_IDENTITY" + "THIRD_PARTY_IDENTITY", + "GOOGLE_GROUP" ], "enumDescriptions": [ "Default value.", "The suggestion is from a GOOGLE_IDENTITY source.", - "The suggestion is from a THIRD_PARTY_IDENTITY source." + "The suggestion is from a THIRD_PARTY_IDENTITY source.", + "The suggestion is a group (e.g. a Google Group), not an individual." ], "type": "string" }, @@ -21889,7 +21917,7 @@ }, "inlineSource": { "$ref": "GoogleCloudDiscoveryengineV1alphaBatchUpdateUserLicensesRequestInlineSource", - "description": "The inline source for the input content for document embeddings." + "description": "The inline source for the input content for license assignment." } }, "type": "object" @@ -24477,13 +24505,9 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata": { - "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).", + "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).", "id": "GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata", "properties": { - "authenticatedAccount": { - "description": "Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.", - "type": "string" - }, "author": { "description": "Optional. The party that authored the connector, e.g. \"Google\" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).", "type": "string" @@ -25866,7 +25890,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { @@ -34741,6 +34765,17 @@ "readOnly": true, "type": "string" }, + "dataSourceEndUserDisplayName": { + "description": "Output only. The end-user-facing display name of the data source, sourced from `ConnectorSource.end_user_display_name`. When unset, clients fall back to `data_source_display_name`.", + "readOnly": true, + "type": "string" + }, + "dataSourceVersion": { + "description": "Output only. The version of the connector definition backing this collection, mirroring `DataConnector.data_source_version`.", + "format": "double", + "readOnly": true, + "type": "number" + }, "dataStoreComponents": { "description": "For the data store collection, list of the children data stores.", "items": { @@ -34757,6 +34792,16 @@ "readOnly": true, "type": "string" }, + "isFirstParty": { + "description": "Output only. Whether this is a first-party (Google-owned) connector, as opposed to a third-party connector. Used by the frontend to group 1P vs 3P connectors. Sourced from `ConnectorSource.is_first_party` once that field is universally populated (b/534727761); until then derived from `ConnectorSource.connector_type == FIRST_PARTY`.", + "readOnly": true, + "type": "boolean" + }, + "metadata": { + "$ref": "GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata", + "description": "Output only. User-facing connector metadata (`title`, `description`, `short_description`, `author`, `note`), retrieved from the registry `ConnectorSource.metadata` (joined by data source). Shown on the connector detail page.", + "readOnly": true + }, "name": { "description": "The name of the collection. It should be collection resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector.", "type": "string" @@ -35159,7 +35204,7 @@ ], "type": "string" }, - "description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "readOnly": true, "type": "object" }, @@ -36820,7 +36865,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { diff --git a/discovery/discoveryengine-v1beta.json b/discovery/discoveryengine-v1beta.json index bf40323f6fe..eadb43effac 100644 --- a/discovery/discoveryengine-v1beta.json +++ b/discovery/discoveryengine-v1beta.json @@ -347,6 +347,36 @@ "https://www.googleapis.com/auth/discoveryengine.serving.readwrite" ] }, + "provision": { + "description": "Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}:provision", + "httpMethod": "POST", + "id": "discoveryengine.projects.locations.provision", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full resource name of a Project, such as `projects/{project_id_or_number}`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+name}:provision", + "request": { + "$ref": "GoogleCloudDiscoveryengineV1betaProvisionProjectRequest" + }, + "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" + ] + }, "removeDedicatedCrawlRate": { "description": "Removes the dedicated crawl rate for a craw_rate_scope. If the dedicated crawl rate was set, this will disable vertex AI's crawl bot from using the dedicated crawl rate for crawling. If the dedicated crawl rate was not set, this is a no-op.", "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}:removeDedicatedCrawlRate", @@ -9524,7 +9554,7 @@ } } }, - "revision": "20260724", + "revision": "20260802", "rootUrl": "https://discoveryengine.googleapis.com/", "schemas": { "GoogleApiDistribution": { @@ -11376,13 +11406,9 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata": { - "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).", + "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).", "id": "GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata", "properties": { - "authenticatedAccount": { - "description": "Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.", - "type": "string" - }, "author": { "description": "Optional. The party that authored the connector, e.g. \"Google\" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).", "type": "string" @@ -12377,7 +12403,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { @@ -17497,13 +17523,9 @@ "type": "object" }, "GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata": { - "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).", + "description": "User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note).", "id": "GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata", "properties": { - "authenticatedAccount": { - "description": "Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.", - "type": "string" - }, "author": { "description": "Optional. The party that authored the connector, e.g. \"Google\" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).", "type": "string" @@ -18622,7 +18644,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { @@ -23107,12 +23129,14 @@ "enum": [ "PERSON_TYPE_UNSPECIFIED", "CLOUD_IDENTITY", - "THIRD_PARTY_IDENTITY" + "THIRD_PARTY_IDENTITY", + "GOOGLE_GROUP" ], "enumDescriptions": [ "Default value.", "The suggestion is from a GOOGLE_IDENTITY source.", - "The suggestion is from a THIRD_PARTY_IDENTITY source." + "The suggestion is from a THIRD_PARTY_IDENTITY source.", + "The suggestion is a group (e.g. a Google Group), not an individual." ], "type": "string" }, @@ -25331,7 +25355,7 @@ }, "inlineSource": { "$ref": "GoogleCloudDiscoveryengineV1betaBatchUpdateUserLicensesRequestInlineSource", - "description": "The inline source for the input content for document embeddings." + "description": "The inline source for the input content for license assignment." } }, "type": "object" @@ -27789,7 +27813,7 @@ ], "type": "string" }, - "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`", + "description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`", "type": "object" }, "industryVertical": { diff --git a/discovery/displayvideo-v2.json b/discovery/displayvideo-v2.json index f26a695f6e3..633a10e0738 100644 --- a/discovery/displayvideo-v2.json +++ b/discovery/displayvideo-v2.json @@ -7823,7 +7823,7 @@ } } }, - "revision": "20260720", + "revision": "20260805", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -11187,16 +11187,16 @@ "type": "boolean" }, "syntheticContentAttestationStatus": { - "description": "Optional. Whether the creative contains synthetic content or was created using AI.", + "description": "Optional. Whether to add a label to the creative as created or edited using AI when served in regions with local AI labeling regulations.", "enum": [ "SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED", "NOT_SYNTHETIC", "IS_SYNTHETIC" ], "enumDescriptions": [ - "Attestation status is unspecified.", - "Not synthetic content.", - "Is synthetic content." + "No attestation has been provided.", + "Attested as not created or edited using AI.", + "Attested as created or edited using AI." ], "type": "string" }, diff --git a/discovery/displayvideo-v3.json b/discovery/displayvideo-v3.json index 4753c56ad9f..da3d74df19a 100644 --- a/discovery/displayvideo-v3.json +++ b/discovery/displayvideo-v3.json @@ -8360,7 +8360,7 @@ } } }, - "revision": "20260720", + "revision": "20260805", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -13683,16 +13683,16 @@ "type": "boolean" }, "syntheticContentAttestationStatus": { - "description": "Optional. Whether the creative contains synthetic content or was created using AI.", + "description": "Optional. Whether to add a label to the creative as created or edited using AI when served in regions with local AI labeling regulations.", "enum": [ "SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED", "NOT_SYNTHETIC", "IS_SYNTHETIC" ], "enumDescriptions": [ - "Attestation status is unspecified.", - "Not synthetic content.", - "Is synthetic content." + "No attestation has been provided.", + "Attested as not created or edited using AI.", + "Attested as created or edited using AI." ], "type": "string" }, diff --git a/discovery/displayvideo-v4.json b/discovery/displayvideo-v4.json index e9612d4348e..f7f8a559430 100644 --- a/discovery/displayvideo-v4.json +++ b/discovery/displayvideo-v4.json @@ -517,7 +517,7 @@ ] }, "patch": { - "description": "Updates an ad asset. Returns the updated ad asset if successful. Supports updating assets of AdAssetType `AD_ASSET_TYPE_YOUTUBE_VIDEO` and `AD_ASSET_TYPE_IMAGE`. Only the `synthetic_content_attestation_status` field is mutable.", + "description": "Updates an ad asset. Returns the updated ad asset if successful. Supports updating assets of AdAssetType `AD_ASSET_TYPE_YOUTUBE_VIDEO` and `AD_ASSET_TYPE_IMAGE`. Only the AdAsset.synthetic_content_attestation_status field is mutable.", "flatPath": "v4/advertisers/{advertisersId}/adAssets/{adAssetsId}", "httpMethod": "PATCH", "id": "displayvideo.advertisers.adAssets.patch", @@ -5023,7 +5023,7 @@ "reachForecast": { "methods": { "generateReachForecast": { - "description": "Generates a reach forecast for a given advertiser and targeting configuration.", + "description": "Generates a reach forecast for a given advertiser and targeting configuration. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.", "flatPath": "v4/advertisers/{advertisersId}/reachForecast:generateReachForecast", "httpMethod": "POST", "id": "displayvideo.advertisers.reachForecast.generateReachForecast", @@ -5052,7 +5052,7 @@ ] }, "retrievePlannableLocations": { - "description": "Retrieves the list of countries where reach forecasting is supported.", + "description": "Retrieves the list of countries where reach forecasting is supported. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.", "flatPath": "v4/advertisers/{advertisersId}/reachForecast:retrievePlannableLocations", "httpMethod": "GET", "id": "displayvideo.advertisers.reachForecast.retrievePlannableLocations", @@ -5078,7 +5078,7 @@ ] }, "retrievePlannableProducts": { - "description": "Retrieves the list of products that can be planned for a location.", + "description": "Retrieves the list of products that can be planned for a location. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.", "flatPath": "v4/advertisers/{advertisersId}/reachForecast:retrievePlannableProducts", "httpMethod": "GET", "id": "displayvideo.advertisers.reachForecast.retrievePlannableProducts", @@ -5109,7 +5109,7 @@ ] }, "retrievePlannableUserInterests": { - "description": "Retrieves Google Audiences (User Interests) available for forecasting.", + "description": "Retrieves Google Audiences (User Interests) available for forecasting. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.", "flatPath": "v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserInterests", "httpMethod": "GET", "id": "displayvideo.advertisers.reachForecast.retrievePlannableUserInterests", @@ -5150,7 +5150,7 @@ ] }, "retrievePlannableUserLists": { - "description": "Retrieves first and third party user lists available for forecasting.", + "description": "Retrieves first and third party user lists available for forecasting. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.", "flatPath": "v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserLists", "httpMethod": "GET", "id": "displayvideo.advertisers.reachForecast.retrievePlannableUserLists", @@ -9618,7 +9618,7 @@ } } }, - "revision": "20260720", + "revision": "20260805", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActiveViewVideoViewabilityMetricConfig": { @@ -9786,16 +9786,16 @@ "type": "string" }, "syntheticContentAttestationStatus": { - "description": "Optional. Whether the asset contains synthetic content or was created using AI.", + "description": "Optional. Whether to add a label to the asset as created or edited using AI when served in regions with local AI labeling regulations.", "enum": [ "SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED", "NOT_SYNTHETIC", "IS_SYNTHETIC" ], "enumDescriptions": [ - "Attestation status is unspecified.", - "Not synthetic content.", - "Is synthetic content." + "No attestation has been provided.", + "Attested as not created or edited using AI.", + "Attested as created or edited using AI." ], "type": "string" }, @@ -14292,7 +14292,7 @@ "id": "ContactInfo", "properties": { "countryCode": { - "description": "Optional. Country code of the member. Must also be set with the following fields: * country_code * hashed_first_name * hashed_last_name * zip_codes", + "description": "Optional. Country code of the member. Must also be set with the following fields: * hashed_first_name * hashed_last_name * zip_codes", "type": "string" }, "hashedEmails": { @@ -15338,16 +15338,16 @@ "type": "boolean" }, "syntheticContentAttestationStatus": { - "description": "Optional. Whether the creative contains synthetic content or was created using AI.", + "description": "Optional. Whether to add a label to the creative as created or edited using AI when served in regions with local AI labeling regulations.", "enum": [ "SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED", "NOT_SYNTHETIC", "IS_SYNTHETIC" ], "enumDescriptions": [ - "Attestation status is unspecified.", - "Not synthetic content.", - "Is synthetic content." + "No attestation has been provided.", + "Attested as not created or edited using AI.", + "Attested as created or edited using AI." ], "type": "string" }, @@ -25424,16 +25424,16 @@ "type": "string" }, "syntheticContentAttestationStatus": { - "description": "Optional. Whether the asset contains synthetic content or was created using AI.", + "description": "Optional. Whether to add a label to the asset as created or edited using AI when served in regions with local AI labeling regulations.", "enum": [ "SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED", "NOT_SYNTHETIC", "IS_SYNTHETIC" ], "enumDescriptions": [ - "Attestation status is unspecified.", - "Not synthetic content.", - "Is synthetic content." + "No attestation has been provided.", + "Attested as not created or edited using AI.", + "Attested as created or edited using AI." ], "type": "string" } diff --git a/discovery/firebaseappdistribution-v1.json b/discovery/firebaseappdistribution-v1.json index 9a9f5c1ba2f..8d614d3362f 100644 --- a/discovery/firebaseappdistribution-v1.json +++ b/discovery/firebaseappdistribution-v1.json @@ -946,7 +946,7 @@ } } }, - "revision": "20260723", + "revision": "20260803", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "GdataBlobstore2Info": { @@ -1419,7 +1419,8 @@ "PLAY_IAS_TERMS_NOT_ACCEPTED", "ADHOC_SHARING_KEY_NOT_GENERATED", "ADHOC_SHARING_KEY_NOT_REGISTERED", - "PLAY_ANDROID_DEVELOPER_CONSOLE_ACCOUNT_NOT_FOUND" + "PLAY_ANDROID_DEVELOPER_CONSOLE_ACCOUNT_NOT_FOUND", + "PLAY_ANDROID_DEVELOPER_CONSOLE_PACKAGE_NOT_FOUND" ], "enumDescriptions": [ "AAB integration state unspecified.", @@ -1431,7 +1432,8 @@ "Play in-app sharing terms not accepted.", "The ad-hoc sharing key has not been generated for this app.", "The ad-hoc sharing key is not yet registered in Android Developer Verification for this app.", - "The linked Play developer account was not found or is not fully set up in Android Developer Console." + "The linked Play developer account was not found or is not fully set up in Android Developer Console.", + "The package was not found in the Android Developer Console." ], "type": "string" }, diff --git a/discovery/firebaseappdistribution-v1alpha.json b/discovery/firebaseappdistribution-v1alpha.json index 7d83e50a889..56a135d0167 100644 --- a/discovery/firebaseappdistribution-v1alpha.json +++ b/discovery/firebaseappdistribution-v1alpha.json @@ -868,7 +868,7 @@ } } }, - "revision": "20260723", + "revision": "20260803", "rootUrl": "https://firebaseappdistribution.googleapis.com/", "schemas": { "AndroidxCrawlerOutputPoint": { @@ -1791,7 +1791,8 @@ "AAB_UPLOAD_ERROR", "APP_NOT_FOUND", "AAB_ADHOC_SHARING_KEY_NOT_REGISTERED", - "AAB_ANDROID_DEVELOPER_CONSOLE_ACCOUNT_NOT_FOUND" + "AAB_ANDROID_DEVELOPER_CONSOLE_ACCOUNT_NOT_FOUND", + "AAB_ANDROID_DEVELOPER_CONSOLE_PACKAGE_NOT_FOUND" ], "enumDescriptions": [ "", @@ -1818,7 +1819,8 @@ "", "Happens if the Firebase app no longer exists by the time of extraction", "", - "A corresponding Android Developer Console account for this app's Play Console account was not found." + "A corresponding Android Developer Console account for this app's Play Console account was not found.", + "The package was not found in the Android Developer Console." ], "type": "string" }, diff --git a/discovery/firebaseml-v2beta.json b/discovery/firebaseml-v2beta.json index 831ddf9a8eb..eda8d065ee7 100644 --- a/discovery/firebaseml-v2beta.json +++ b/discovery/firebaseml-v2beta.json @@ -206,7 +206,7 @@ } } }, - "revision": "20260726", + "revision": "20260802", "rootUrl": "https://firebaseml.googleapis.com/", "schemas": { "Date": { @@ -357,11 +357,20 @@ }, "languageAuto": { "$ref": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageAuto", - "description": "Optional. The model will detect the language automatically." + "deprecated": true, + "description": "Optional. Deprecated: Use top-level `language_codes` instead. The model will detect the language automatically." + }, + "languageCodes": { + "description": "Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.", + "items": { + "type": "string" + }, + "type": "array" }, "languageHints": { "$ref": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageHints", - "description": "Optional. Specifies one or more languages in the audio." + "deprecated": true, + "description": "Optional. Deprecated: Use top-level `language_codes` instead. Specifies one or more languages in the audio." }, "wordTimestamp": { "description": "Optional. Configures word-level timestamp generation.", @@ -371,17 +380,20 @@ "type": "object" }, "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageAuto": { - "description": "Indicates the language of the audio should be automatically detected.", + "deprecated": true, + "description": "Deprecated: Use top-level `language_codes` instead. Indicates the language of the audio should be automatically detected.", "id": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageAuto", "properties": {}, "type": "object" }, "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageHints": { - "description": "Provides hints to the model about possible languages present in the audio.", + "deprecated": true, + "description": "Deprecated: Use top-level `language_codes` instead. Provides hints to the model about possible languages present in the audio.", "id": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageHints", "properties": { "languageCodes": { - "description": "Required. BCP-47 language codes. At least one must be specified.", + "deprecated": true, + "description": "Required. Deprecated: Use top-level `language_codes` instead. BCP-47 language codes. At least one must be specified.", "items": { "type": "string" }, @@ -1444,6 +1456,7 @@ "ON_DEMAND", "ON_DEMAND_PRIORITY", "ON_DEMAND_FLEX", + "ON_DEMAND_OFFPEAK", "PROVISIONED_THROUGHPUT" ], "enumDescriptions": [ @@ -1451,6 +1464,7 @@ "The request was processed using Pay-As-You-Go quota.", "Type for Priority Pay-As-You-Go traffic.", "Type for Flex traffic.", + "Type for Off-Peak Pay-As-You-Go traffic.", "Type for Provisioned Throughput traffic." ], "readOnly": true, @@ -3601,6 +3615,10 @@ "gcsUri": { "description": "Optional. The Google Cloud Storage URI to store the video output. Required for Vertex if delivery is URI.", "type": "string" + }, + "resolution": { + "description": "Optional. The video output resolution. Supported values: \"360p\", \"720p\", \"1080p\", \"4k\".", + "type": "string" } }, "type": "object" diff --git a/discovery/ftp-v1.json b/discovery/ftp-v1.json new file mode 100644 index 00000000000..5069434f50a --- /dev/null +++ b/discovery/ftp-v1.json @@ -0,0 +1,1402 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://ftp.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Cloud FTP", + "description": "Cloud FTP is a managed service that allows transferring files directly to Google Cloud Storage using SFTP.", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/cloud-ftp/overview", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "ftp:v1", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://ftp.mtls.googleapis.com/", + "name": "ftp", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "projects": { + "resources": { + "locations": { + "methods": { + "get": { + "description": "Gets information about a location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", + "httpMethod": "GET", + "id": "ftp.projects.locations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Resource name for the location.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Location" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists information about the supported locations for this service. 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": "v1/projects/{projectsId}/locations", + "httpMethod": "GET", + "id": "ftp.projects.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": "v1/{+name}/locations", + "response": { + "$ref": "ListLocationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "ftp.projects.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "ftp.projects.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "ftp.projects.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "ftp.projects.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + }, + "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": "v1/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "servers": { + "methods": { + "create": { + "description": "Creates a new Server in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers", + "httpMethod": "POST", + "id": "ftp.projects.locations.servers.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Value for parent.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "serverId": { + "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/servers", + "request": { + "$ref": "Server" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single Server.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}", + "httpMethod": "DELETE", + "id": "ftp.projects.locations.servers.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single Server.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}", + "httpMethod": "GET", + "id": "ftp.projects.locations.servers.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. The view of the Server resource to return.", + "enum": [ + "SERVER_VIEW_UNSPECIFIED", + "SERVER_VIEW_BASIC", + "SERVER_VIEW_FULL" + ], + "enumDescriptions": [ + "Default value. Equivalent to SERVER_VIEW_BASIC.", + "Basic view. Excludes heavy configurations (internal_config, external_config, google_managed_server_credential).", + "Full view. Includes all fields." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Server" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists Servers in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers", + "httpMethod": "GET", + "id": "ftp.projects.locations.servers.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 value for ListServersRequest", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. The view of the Server resource to return.", + "enum": [ + "SERVER_VIEW_UNSPECIFIED", + "SERVER_VIEW_BASIC", + "SERVER_VIEW_FULL" + ], + "enumDescriptions": [ + "Default value. Equivalent to SERVER_VIEW_BASIC.", + "Basic view. Excludes heavy configurations (internal_config, external_config, google_managed_server_credential).", + "Full view. Includes all fields." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/servers", + "response": { + "$ref": "ListServersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single Server.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}", + "httpMethod": "PATCH", + "id": "ftp.projects.locations.servers.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. name of resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Optional. Field mask is used to specify the fields to be overwritten in the Server resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Server" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "start": { + "description": "Starts a stopping/stopped Server.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}:start", + "httpMethod": "POST", + "id": "ftp.projects.locations.servers.start", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource Format: `projects/{project}/locations/{location}/servers/{server}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:start", + "request": { + "$ref": "StartServerRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "stop": { + "description": "Stops an active Server.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}:stop", + "httpMethod": "POST", + "id": "ftp.projects.locations.servers.stop", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource. Format: `projects/{project}/locations/{location}/servers/{server}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:stop", + "request": { + "$ref": "StopServerRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "users": { + "methods": { + "create": { + "description": "Creates a new User in a given project and location and Server.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users", + "httpMethod": "POST", + "id": "ftp.projects.locations.servers.users.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Value for parent.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "userId": { + "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/users", + "request": { + "$ref": "User" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single User.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users/{usersId}", + "httpMethod": "DELETE", + "id": "ftp.projects.locations.servers.users.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "force": { + "description": "Optional. If set to true, the request will force the deletion of the User.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+/users/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single User.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users/{usersId}", + "httpMethod": "GET", + "id": "ftp.projects.locations.servers.users.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+/users/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. The view of the User resource to return.", + "enum": [ + "USER_VIEW_UNSPECIFIED", + "USER_VIEW_BASIC", + "USER_VIEW_FULL" + ], + "enumDescriptions": [ + "Default value. Equivalent to USER_VIEW_BASIC.", + "Basic view. Excludes heavy configurations (user_credentials, storage_directory_mappings).", + "Full view. Includes all fields." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "User" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists Users in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users", + "httpMethod": "GET", + "id": "ftp.projects.locations.servers.users.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. User may return fewer items than requested. The maximum value is 1000; The default value is 50 if the field is omitted (or set to 0).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results the user should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent value for ListUsersRequest", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. The view of the User resource to return.", + "enum": [ + "USER_VIEW_UNSPECIFIED", + "USER_VIEW_BASIC", + "USER_VIEW_FULL" + ], + "enumDescriptions": [ + "Default value. Equivalent to USER_VIEW_BASIC.", + "Basic view. Excludes heavy configurations (user_credentials, storage_directory_mappings).", + "Full view. Includes all fields." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/users", + "response": { + "$ref": "ListUsersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single User.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users/{usersId}", + "httpMethod": "PATCH", + "id": "ftp.projects.locations.servers.users.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. User-friendly name via which User will be identified. projects/{project}/locations/{location}/servers/{server}/users/{user}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+/users/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "User" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + } + } + }, + "revision": "20260729", + "rootUrl": "https://ftp.googleapis.com/", + "schemas": { + "AllowedConsumer": { + "description": "A consumer project or network that is permitted to connect to the server via PSC.", + "id": "AllowedConsumer", + "properties": { + "connectionLimit": { + "description": "Required. The connection limit for the consumer. Value must be greater than 0.", + "format": "int64", + "type": "string" + }, + "project": { + "description": "The project ID or number of the consumer project. Must be in the format: `projects/{project}`.", + "type": "string" + } + }, + "type": "object" + }, + "CancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "CancelOperationRequest", + "properties": {}, + "type": "object" + }, + "DeniedConsumer": { + "description": "A consumer project or network that is denied to connect to the server via PSC.", + "id": "DeniedConsumer", + "properties": { + "project": { + "description": "The project ID or number of the consumer project. Must be in the format: `projects/{project}`.", + "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", + "properties": {}, + "type": "object" + }, + "ExternalServerConfig": { + "description": "Configuration for external server.", + "id": "ExternalServerConfig", + "properties": { + "allowedCidrBlocks": { + "description": "Optional. List of CIDR blocks that are allowed to access the Server. A CIDR range consists of an IP Address and a prefix length to construct the subnet mask. By default, the prefix length is 32 (i.e. matches a single IP address). For now, only IPV4 addresses are supported. Examples: \"203.0.113.0/24\" - matches with the IP addresses in the range 203.0.113.0 - 203.0.113.255. \"0.0.0.0/0\" - matches against any IP address. This field must contain at least one entry if the access type is EXTERNAL. The number of allowed CIDR blocks cannot exceed 500. Example: 192.168.0.0/16", + "items": { + "type": "string" + }, + "type": "array" + }, + "ipAddress": { + "description": "Output only. IP address of the LB via which clients will connect.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InternalServerConfig": { + "description": "Configuration for private server accessible via PSC.", + "id": "InternalServerConfig", + "properties": { + "consumerAcceptList": { + "description": "Required. A list of projects that are permitted to connect. At least one project is required in the allow list.", + "items": { + "$ref": "AllowedConsumer" + }, + "type": "array" + }, + "consumerRejectList": { + "description": "Optional. A list of projects that are denied connection. Format: \"projects/sample_project_id\" or \"projects/1234567890\" Projects in this list will be denied access, even if they are included in the `allow_list`. If this list is empty, no projects are explicitly rejected.", + "items": { + "$ref": "DeniedConsumer" + }, + "type": "array" + }, + "pscEndpoints": { + "description": "Output only. Details of endpoints created by the customer.", + "items": { + "$ref": "PscEndpoint" + }, + "readOnly": true, + "type": "array" + }, + "serviceAttachment": { + "description": "Output only. The resource name of the service attachment. Format: `projects/{project}/regions/{region}/serviceAttachments/{service_attachment}`", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ListLocationsResponse": { + "description": "The response message for Locations.ListLocations.", + "id": "ListLocationsResponse", + "properties": { + "locations": { + "description": "A list of locations that matches the specified filter in the request.", + "items": { + "$ref": "Location" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + } + }, + "type": "object" + }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + }, + "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" + }, + "ListServersResponse": { + "description": "Message for response to listing Servers", + "id": "ListServersResponse", + "properties": { + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + }, + "servers": { + "description": "The list of Server", + "items": { + "$ref": "Server" + }, + "type": "array" + }, + "unreachable": { + "description": "Unordered list. Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListUsersResponse": { + "description": "Message for response to listing Users", + "id": "ListUsersResponse", + "properties": { + "nextPageToken": { + "description": "A token identifying a page of results the user should return.", + "type": "string" + }, + "unreachable": { + "description": "Unordered list. Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + }, + "users": { + "description": "The list of User", + "items": { + "$ref": "User" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "A resource that represents a Google Cloud location.", + "id": "Location", + "properties": { + "displayName": { + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", + "type": "object" + }, + "locationId": { + "description": "The canonical id for this location. For example: `\"us-east1\"`.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata. For example the available capacity at the given location.", + "type": "object" + }, + "name": { + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", + "type": "string" + } + }, + "type": "object" + }, + "Operation": { + "description": "This resource represents a long-running operation that is the result of a network API call.", + "id": "Operation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "type": "boolean" + }, + "error": { + "$ref": "Status", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + }, + "OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.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" + }, + "PscEndpoint": { + "description": "Details of PSC endpoint created by customer.", + "id": "PscEndpoint", + "properties": { + "endpoint": { + "description": "Output only. This is a Resource name for Private Service Connect endpoint. Format: `projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}`", + "readOnly": true, + "type": "string" + }, + "network": { + "description": "Output only. The consumer network. Format: `projects/{project}/locations/{location}/networks/{network}`", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. The status of the connected endpoint.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "Server": { + "description": "Message describing Server object", + "id": "Server", + "properties": { + "accessType": { + "description": "Required. The access type of the Server.", + "enum": [ + "ACCESS_TYPE_UNSPECIFIED", + "EXTERNAL", + "INTERNAL" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Server is assigned a public IP.", + "Server is assigned an internal IP." + ], + "type": "string" + }, + "createTime": { + "description": "Output only. [Output only] Create time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. Display name of the Server", + "type": "string" + }, + "externalConfig": { + "$ref": "ExternalServerConfig", + "description": "Configuration for external access." + }, + "googleManagedServerCredential": { + "$ref": "ServerCredential", + "description": "Output only. Credentials of the FTP Server.", + "readOnly": true + }, + "internalConfig": { + "$ref": "InternalServerConfig", + "description": "Configuration for internal access." + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs", + "type": "object" + }, + "name": { + "description": "Identifier. name of resource", + "type": "string" + }, + "serviceAgent": { + "description": "Output only. Service agent used to access the customer bucket.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The state of the server.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "STARTING", + "ACTIVE", + "STOPPING", + "STOPPED", + "DELETING", + "ERROR", + "UPDATING" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Server is being created.", + "Server is starting.", + "Server is ready to be used.", + "Server is stopping.", + "Server is stopped.", + "Server is being deleted.", + "Server is in error state.", + "Server is being updated." + ], + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. [Output only] Update time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ServerCredential": { + "description": "Represents credentials of an FTP Server.", + "id": "ServerCredential", + "properties": { + "asymmetricAlgorithm": { + "description": "Output only. Asymmetric algorithm used by the public key. Possible values (can be expanded in future): - ssh-ed25519", + "readOnly": true, + "type": "string" + }, + "fingerprint": { + "description": "Output only. The fingerprint is a hash of the public key, and is displayed when clients access the server for the first time to verify the server's identity.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "StartServerRequest": { + "description": "Request message for starting a Server.", + "id": "StartServerRequest", + "properties": {}, + "type": "object" + }, + "Status": { + "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", + "id": "Status", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, + "StopServerRequest": { + "description": "Request message for stopping a Server.", + "id": "StopServerRequest", + "properties": {}, + "type": "object" + }, + "StorageDirectoryMapping": { + "description": "Mapping of backing Cloud Storage path to the directory where the user lands in the SFTP server. If directory is not specified, it'll default to '/'. Eg 1 - (bucket_name: bucket, bucket_prefix: path1/path2, directory: /abc/def/username) The user will land at /abcd/def/username, and the view there will match that of /bucket/path1/path2. The user will not be aware of Cloud Storage prefix '/bucket/path1' and there will be no such directory in the view. Eg 2 - (bucket_name: bucket, bucket_prefix: path1/path2, directory: '') The user will land at '/', and the view there will match that of /bucket/path1/path2. The user will not be aware of Cloud Storage prefix '/bucket/path1/path2' and there will be no such directory in the view.", + "id": "StorageDirectoryMapping", + "properties": { + "bucket": { + "description": "Required. Name of the bucket.", + "type": "string" + }, + "bucketPrefix": { + "description": "Optional. Prefix inside the bucket.", + "type": "string" + }, + "directory": { + "description": "Required. Directory where the user lands in the SFTP server.", + "type": "string" + }, + "permission": { + "description": "Required. Permission to the bucket.", + "enum": [ + "PERMISSION_UNSPECIFIED", + "READ_ONLY", + "READ_WRITE" + ], + "enumDescriptions": [ + "Permission unspecified.", + "Read only permission.", + "Read write permission." + ], + "type": "string" + } + }, + "type": "object" + }, + "User": { + "description": "Message describing User object", + "id": "User", + "properties": { + "createTime": { + "description": "Output only. [Output only] Create time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "customerServiceAccount": { + "description": "Required. Service account in customer project attached to this SFTP User.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs", + "type": "object" + }, + "name": { + "description": "Identifier. User-friendly name via which User will be identified. projects/{project}/locations/{location}/servers/{server}/users/{user}", + "type": "string" + }, + "state": { + "description": "Output only. Tracks user creation.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "ERROR", + "UPDATING", + "DELETING" + ], + "enumDescriptions": [ + "State unspecified.", + "User is being created.", + "User is ready to be used.", + "User creation failed.", + "The resource is being updated.", + "The resource is being deleted." + ], + "readOnly": true, + "type": "string" + }, + "storageDirectoryMappings": { + "description": "Required. Mapping of Cloud Storage buckets to directories where the user will land in the SFTP server.", + "items": { + "$ref": "StorageDirectoryMapping" + }, + "type": "array" + }, + "updateTime": { + "description": "Output only. [Output only] Update time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "userCredentials": { + "description": "Required. User credential for the user. The maximum number of user credentials is 10.", + "items": { + "$ref": "UserCredential" + }, + "type": "array" + }, + "username": { + "description": "Output only. [Output only] The username of the user.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "UserCredential": { + "description": "Message describing UserCredential object", + "id": "UserCredential", + "properties": { + "credentialName": { + "description": "Required. Name of the user credential.", + "type": "string" + }, + "credentialType": { + "description": "Required. Type of credential.", + "enum": [ + "TYPE_UNSPECIFIED", + "PUBLIC_KEY" + ], + "enumDescriptions": [ + "Type unspecified.", + "Public key credential." + ], + "type": "string" + }, + "sshPublicKeyBody": { + "description": "Optional. SSH public key body in OpenSSH format. Example: \"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ...\"", + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Cloud FTP API", + "version": "v1", + "version_module": true +} \ No newline at end of file diff --git a/discovery/ftp-v1alpha.json b/discovery/ftp-v1alpha.json new file mode 100644 index 00000000000..aaed4332fb0 --- /dev/null +++ b/discovery/ftp-v1alpha.json @@ -0,0 +1,1402 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + } + } + } + }, + "basePath": "", + "baseUrl": "https://ftp.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Cloud FTP", + "description": "Cloud FTP is a managed service that allows transferring files directly to Google Cloud Storage using SFTP.", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/cloud-ftp/overview", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "ftp:v1alpha", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://ftp.mtls.googleapis.com/", + "name": "ftp", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "projects": { + "resources": { + "locations": { + "methods": { + "get": { + "description": "Gets information about a location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}", + "httpMethod": "GET", + "id": "ftp.projects.locations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Resource name for the location.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Location" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "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": "v1alpha/projects/{projectsId}/locations", + "httpMethod": "GET", + "id": "ftp.projects.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": "v1alpha/{+name}/locations", + "response": { + "$ref": "ListLocationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "ftp.projects.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:cancel", + "request": { + "$ref": "CancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "ftp.projects.locations.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "ftp.projects.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "ftp.projects.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + }, + "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": "v1alpha/{+name}/operations", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "servers": { + "methods": { + "create": { + "description": "Creates a new Server in a given project and location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers", + "httpMethod": "POST", + "id": "ftp.projects.locations.servers.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Value for parent.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "serverId": { + "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/servers", + "request": { + "$ref": "Server" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single Server.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}", + "httpMethod": "DELETE", + "id": "ftp.projects.locations.servers.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single Server.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}", + "httpMethod": "GET", + "id": "ftp.projects.locations.servers.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. The view of the Server resource to return.", + "enum": [ + "SERVER_VIEW_UNSPECIFIED", + "SERVER_VIEW_BASIC", + "SERVER_VIEW_FULL" + ], + "enumDescriptions": [ + "Default value. Equivalent to SERVER_VIEW_BASIC.", + "Basic view. Excludes heavy configurations (internal_config, external_config, google_managed_server_credential).", + "Full view. Includes all fields." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Server" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists Servers in a given project and location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers", + "httpMethod": "GET", + "id": "ftp.projects.locations.servers.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 value for ListServersRequest", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. The view of the Server resource to return.", + "enum": [ + "SERVER_VIEW_UNSPECIFIED", + "SERVER_VIEW_BASIC", + "SERVER_VIEW_FULL" + ], + "enumDescriptions": [ + "Default value. Equivalent to SERVER_VIEW_BASIC.", + "Basic view. Excludes heavy configurations (internal_config, external_config, google_managed_server_credential).", + "Full view. Includes all fields." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/servers", + "response": { + "$ref": "ListServersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single Server.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}", + "httpMethod": "PATCH", + "id": "ftp.projects.locations.servers.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. name of resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Optional. Field mask is used to specify the fields to be overwritten in the Server resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "request": { + "$ref": "Server" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "start": { + "description": "Starts a stopping/stopped Server.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}:start", + "httpMethod": "POST", + "id": "ftp.projects.locations.servers.start", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource Format: `projects/{project}/locations/{location}/servers/{server}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:start", + "request": { + "$ref": "StartServerRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "stop": { + "description": "Stops an active Server.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}:stop", + "httpMethod": "POST", + "id": "ftp.projects.locations.servers.stop", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource. Format: `projects/{project}/locations/{location}/servers/{server}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}:stop", + "request": { + "$ref": "StopServerRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "users": { + "methods": { + "create": { + "description": "Creates a new User in a given project and location and Server.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users", + "httpMethod": "POST", + "id": "ftp.projects.locations.servers.users.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. Value for parent.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + }, + "requestId": { + "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "userId": { + "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/users", + "request": { + "$ref": "User" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single User.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users/{usersId}", + "httpMethod": "DELETE", + "id": "ftp.projects.locations.servers.users.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "force": { + "description": "Optional. If set to true, the request will force the deletion of the User.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+/users/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single User.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users/{usersId}", + "httpMethod": "GET", + "id": "ftp.projects.locations.servers.users.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the resource", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+/users/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. The view of the User resource to return.", + "enum": [ + "USER_VIEW_UNSPECIFIED", + "USER_VIEW_BASIC", + "USER_VIEW_FULL" + ], + "enumDescriptions": [ + "Default value. Equivalent to USER_VIEW_BASIC.", + "Basic view. Excludes heavy configurations (user_credentials, storage_directory_mappings).", + "Full view. Includes all fields." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "response": { + "$ref": "User" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists Users in a given project and location.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users", + "httpMethod": "GET", + "id": "ftp.projects.locations.servers.users.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. User may return fewer items than requested. The maximum value is 1000; The default value is 50 if the field is omitted (or set to 0).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A token identifying a page of results the user should return.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent value for ListUsersRequest", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Optional. The view of the User resource to return.", + "enum": [ + "USER_VIEW_UNSPECIFIED", + "USER_VIEW_BASIC", + "USER_VIEW_FULL" + ], + "enumDescriptions": [ + "Default value. Equivalent to USER_VIEW_BASIC.", + "Basic view. Excludes heavy configurations (user_credentials, storage_directory_mappings).", + "Full view. Includes all fields." + ], + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+parent}/users", + "response": { + "$ref": "ListUsersResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single User.", + "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/servers/{serversId}/users/{usersId}", + "httpMethod": "PATCH", + "id": "ftp.projects.locations.servers.users.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. User-friendly name via which User will be identified. projects/{project}/locations/{location}/servers/{server}/users/{user}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/servers/[^/]+/users/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1alpha/{+name}", + "request": { + "$ref": "User" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + } + } + }, + "revision": "20260729", + "rootUrl": "https://ftp.googleapis.com/", + "schemas": { + "AllowedConsumer": { + "description": "A consumer project or network that is permitted to connect to the server via PSC.", + "id": "AllowedConsumer", + "properties": { + "connectionLimit": { + "description": "Required. The connection limit for the consumer. Value must be greater than 0.", + "format": "int64", + "type": "string" + }, + "project": { + "description": "The project ID or number of the consumer project. Must be in the format: `projects/{project}`.", + "type": "string" + } + }, + "type": "object" + }, + "CancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "CancelOperationRequest", + "properties": {}, + "type": "object" + }, + "DeniedConsumer": { + "description": "A consumer project or network that is denied to connect to the server via PSC.", + "id": "DeniedConsumer", + "properties": { + "project": { + "description": "The project ID or number of the consumer project. Must be in the format: `projects/{project}`.", + "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", + "properties": {}, + "type": "object" + }, + "ExternalServerConfig": { + "description": "Configuration for external server.", + "id": "ExternalServerConfig", + "properties": { + "allowedCidrBlocks": { + "description": "Optional. List of CIDR blocks that are allowed to access the Server. A CIDR range consists of an IP Address and a prefix length to construct the subnet mask. By default, the prefix length is 32 (i.e. matches a single IP address). For now, only IPV4 addresses are supported. Examples: \"203.0.113.0/24\" - matches with the IP addresses in the range 203.0.113.0 - 203.0.113.255. \"0.0.0.0/0\" - matches against any IP address. This field must contain at least one entry if the access type is EXTERNAL. The number of allowed CIDR blocks cannot exceed 500. Example: 192.168.0.0/16", + "items": { + "type": "string" + }, + "type": "array" + }, + "ipAddress": { + "description": "Output only. IP address of the LB via which clients will connect.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "InternalServerConfig": { + "description": "Configuration for private server accessible via PSC.", + "id": "InternalServerConfig", + "properties": { + "consumerAcceptList": { + "description": "Required. A list of projects that are permitted to connect. At least one project is required in the allow list.", + "items": { + "$ref": "AllowedConsumer" + }, + "type": "array" + }, + "consumerRejectList": { + "description": "Optional. A list of projects that are denied connection. Format: \"projects/sample_project_id\" or \"projects/1234567890\" Projects in this list will be denied access, even if they are included in the `allow_list`. If this list is empty, no projects are explicitly rejected.", + "items": { + "$ref": "DeniedConsumer" + }, + "type": "array" + }, + "pscEndpoints": { + "description": "Output only. Details of endpoints created by the customer.", + "items": { + "$ref": "PscEndpoint" + }, + "readOnly": true, + "type": "array" + }, + "serviceAttachment": { + "description": "Output only. The resource name of the service attachment. Format: `projects/{project}/regions/{region}/serviceAttachments/{service_attachment}`", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ListLocationsResponse": { + "description": "The response message for Locations.ListLocations.", + "id": "ListLocationsResponse", + "properties": { + "locations": { + "description": "A list of locations that matches the specified filter in the request.", + "items": { + "$ref": "Location" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + } + }, + "type": "object" + }, + "ListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "ListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "Operation" + }, + "type": "array" + }, + "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" + }, + "ListServersResponse": { + "description": "Message for response to listing Servers", + "id": "ListServersResponse", + "properties": { + "nextPageToken": { + "description": "A token identifying a page of results the server should return.", + "type": "string" + }, + "servers": { + "description": "The list of Server", + "items": { + "$ref": "Server" + }, + "type": "array" + }, + "unreachable": { + "description": "Unordered list. Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListUsersResponse": { + "description": "Message for response to listing Users", + "id": "ListUsersResponse", + "properties": { + "nextPageToken": { + "description": "A token identifying a page of results the user should return.", + "type": "string" + }, + "unreachable": { + "description": "Unordered list. Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + }, + "users": { + "description": "The list of User", + "items": { + "$ref": "User" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "A resource that represents a Google Cloud location.", + "id": "Location", + "properties": { + "displayName": { + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", + "type": "object" + }, + "locationId": { + "description": "The canonical id for this location. For example: `\"us-east1\"`.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata. For example the available capacity at the given location.", + "type": "object" + }, + "name": { + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", + "type": "string" + } + }, + "type": "object" + }, + "Operation": { + "description": "This resource represents a long-running operation that is the result of a network API call.", + "id": "Operation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", + "type": "boolean" + }, + "error": { + "$ref": "Status", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + }, + "OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.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" + }, + "PscEndpoint": { + "description": "Details of PSC endpoint created by customer.", + "id": "PscEndpoint", + "properties": { + "endpoint": { + "description": "Output only. This is a Resource name for Private Service Connect endpoint. Format: `projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}`", + "readOnly": true, + "type": "string" + }, + "network": { + "description": "Output only. The consumer network. Format: `projects/{project}/locations/{location}/networks/{network}`", + "readOnly": true, + "type": "string" + }, + "status": { + "description": "Output only. The status of the connected endpoint.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "Server": { + "description": "Message describing Server object", + "id": "Server", + "properties": { + "accessType": { + "description": "Required. The access type of the Server.", + "enum": [ + "ACCESS_TYPE_UNSPECIFIED", + "EXTERNAL", + "INTERNAL" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Server is assigned a public IP.", + "Server is assigned an internal IP." + ], + "type": "string" + }, + "createTime": { + "description": "Output only. [Output only] Create time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "displayName": { + "description": "Optional. Display name of the Server", + "type": "string" + }, + "externalConfig": { + "$ref": "ExternalServerConfig", + "description": "Configuration for external access." + }, + "googleManagedServerCredential": { + "$ref": "ServerCredential", + "description": "Output only. Credentials of the FTP Server.", + "readOnly": true + }, + "internalConfig": { + "$ref": "InternalServerConfig", + "description": "Configuration for internal access." + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs", + "type": "object" + }, + "name": { + "description": "Identifier. name of resource", + "type": "string" + }, + "serviceAgent": { + "description": "Output only. Service agent used to access the customer bucket.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The state of the server.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "STARTING", + "ACTIVE", + "STOPPING", + "STOPPED", + "DELETING", + "ERROR", + "UPDATING" + ], + "enumDescriptions": [ + "Default value. This value is unused.", + "Server is being created.", + "Server is starting.", + "Server is ready to be used.", + "Server is stopping.", + "Server is stopped.", + "Server is being deleted.", + "Server is in error state.", + "Server is being updated." + ], + "readOnly": true, + "type": "string" + }, + "updateTime": { + "description": "Output only. [Output only] Update time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "ServerCredential": { + "description": "Represents credentials of an FTP Server.", + "id": "ServerCredential", + "properties": { + "asymmetricAlgorithm": { + "description": "Output only. Asymmetric algorithm used by the public key. Possible values (can be expanded in future): - ssh-ed25519", + "readOnly": true, + "type": "string" + }, + "fingerprint": { + "description": "Output only. The fingerprint is a hash of the public key, and is displayed when clients access the server for the first time to verify the server's identity.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "StartServerRequest": { + "description": "Request message for starting a Server.", + "id": "StartServerRequest", + "properties": {}, + "type": "object" + }, + "Status": { + "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", + "id": "Status", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + }, + "StopServerRequest": { + "description": "Request message for stopping a Server.", + "id": "StopServerRequest", + "properties": {}, + "type": "object" + }, + "StorageDirectoryMapping": { + "description": "Mapping of backing Cloud Storage path to the directory where the user lands in the SFTP server. If directory is not specified, it'll default to '/'. Eg 1 - (bucket_name: bucket, bucket_prefix: path1/path2, directory: /abc/def/username) The user will land at /abcd/def/username, and the view there will match that of /bucket/path1/path2. The user will not be aware of Cloud Storage prefix '/bucket/path1' and there will be no such directory in the view. Eg 2 - (bucket_name: bucket, bucket_prefix: path1/path2, directory: '') The user will land at '/', and the view there will match that of /bucket/path1/path2. The user will not be aware of Cloud Storage prefix '/bucket/path1/path2' and there will be no such directory in the view.", + "id": "StorageDirectoryMapping", + "properties": { + "bucket": { + "description": "Required. Name of the bucket.", + "type": "string" + }, + "bucketPrefix": { + "description": "Optional. Prefix inside the bucket.", + "type": "string" + }, + "directory": { + "description": "Required. Directory where the user lands in the SFTP server.", + "type": "string" + }, + "permission": { + "description": "Required. Permission to the bucket.", + "enum": [ + "PERMISSION_UNSPECIFIED", + "READ_ONLY", + "READ_WRITE" + ], + "enumDescriptions": [ + "Permission unspecified.", + "Read only permission.", + "Read write permission." + ], + "type": "string" + } + }, + "type": "object" + }, + "User": { + "description": "Message describing User object", + "id": "User", + "properties": { + "createTime": { + "description": "Output only. [Output only] Create time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "customerServiceAccount": { + "description": "Required. Service account in customer project attached to this SFTP User.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Labels as key value pairs", + "type": "object" + }, + "name": { + "description": "Identifier. User-friendly name via which User will be identified. projects/{project}/locations/{location}/servers/{server}/users/{user}", + "type": "string" + }, + "state": { + "description": "Output only. Tracks user creation.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "ACTIVE", + "ERROR", + "UPDATING", + "DELETING" + ], + "enumDescriptions": [ + "State unspecified.", + "User is being created.", + "User is ready to be used.", + "User creation failed.", + "The resource is being updated.", + "The resource is being deleted." + ], + "readOnly": true, + "type": "string" + }, + "storageDirectoryMappings": { + "description": "Required. Mapping of Cloud Storage buckets to directories where the user will land in the SFTP server.", + "items": { + "$ref": "StorageDirectoryMapping" + }, + "type": "array" + }, + "updateTime": { + "description": "Output only. [Output only] Update time stamp", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "userCredentials": { + "description": "Required. User credential for the user. The maximum number of user credentials is 10.", + "items": { + "$ref": "UserCredential" + }, + "type": "array" + }, + "username": { + "description": "Output only. [Output only] The username of the user.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "UserCredential": { + "description": "Message describing UserCredential object", + "id": "UserCredential", + "properties": { + "credentialName": { + "description": "Required. Name of the user credential.", + "type": "string" + }, + "credentialType": { + "description": "Required. Type of credential.", + "enum": [ + "TYPE_UNSPECIFIED", + "PUBLIC_KEY" + ], + "enumDescriptions": [ + "Type unspecified.", + "Public key credential." + ], + "type": "string" + }, + "sshPublicKeyBody": { + "description": "Optional. SSH public key body in OpenSSH format. Example: \"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ...\"", + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Cloud FTP API", + "version": "v1alpha", + "version_module": true +} \ No newline at end of file diff --git a/discovery/gkehub-v1.json b/discovery/gkehub-v1.json index b7e1cf80598..6496cbf1b93 100644 --- a/discovery/gkehub-v1.json +++ b/discovery/gkehub-v1.json @@ -2596,7 +2596,7 @@ } } }, - "revision": "20260719", + "revision": "20260731", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -6800,7 +6800,7 @@ "type": "object" }, "Rollout": { - "description": "Rollout contains the Rollout metadata and configuration. Next ID: 28", + "description": "Rollout contains the Rollout metadata and configuration. Next ID: 31", "id": "Rollout", "properties": { "completeTime": { diff --git a/discovery/gkehub-v1alpha.json b/discovery/gkehub-v1alpha.json index c00ad37741e..12cf307c7a9 100644 --- a/discovery/gkehub-v1alpha.json +++ b/discovery/gkehub-v1alpha.json @@ -2740,7 +2740,7 @@ } } }, - "revision": "20260719", + "revision": "20260731", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -7317,7 +7317,7 @@ "type": "object" }, "Rollout": { - "description": "Rollout contains the Rollout metadata and configuration. Next ID: 28", + "description": "Rollout contains the Rollout metadata and configuration. Next ID: 31", "id": "Rollout", "properties": { "completeTime": { diff --git a/discovery/gkehub-v1beta.json b/discovery/gkehub-v1beta.json index 2066a851a61..91afd0bcc7a 100644 --- a/discovery/gkehub-v1beta.json +++ b/discovery/gkehub-v1beta.json @@ -2596,7 +2596,7 @@ } } }, - "revision": "20260719", + "revision": "20260731", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -6926,7 +6926,7 @@ "type": "object" }, "Rollout": { - "description": "Rollout contains the Rollout metadata and configuration. Next ID: 28", + "description": "Rollout contains the Rollout metadata and configuration. Next ID: 31", "id": "Rollout", "properties": { "completeTime": { diff --git a/discovery/health-v4.json b/discovery/health-v4.json index 3985ed43d9d..4b9755d80e1 100644 --- a/discovery/health-v4.json +++ b/discovery/health-v4.json @@ -936,7 +936,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}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - default value - `users/me/dataSourceFamilies/google-wearables` - tracker devices - `users/me/dataSourceFamilies/google-sources` - Google first party sources", + "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.", "location": "query", "type": "string" }, @@ -970,9 +970,17 @@ }, "scopes": [ "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly", + "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly", "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly", + "https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly", "https://www.googleapis.com/auth/googlehealth.location.readonly", - "https://www.googleapis.com/auth/googlehealth.sleep.readonly" + "https://www.googleapis.com/auth/googlehealth.location.writeonly", + "https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly", + "https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly", + "https://www.googleapis.com/auth/googlehealth.nutrition.writeonly", + "https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly", + "https://www.googleapis.com/auth/googlehealth.sleep.readonly", + "https://www.googleapis.com/auth/googlehealth.sleep.writeonly" ] }, "rollUp": { @@ -1078,7 +1086,7 @@ } } }, - "revision": "20260729", + "revision": "20260805", "rootUrl": "https://health.googleapis.com/", "schemas": { "ActiveEnergyBurned": { @@ -1933,7 +1941,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 - `users/me/dataSourceFamilies/google-wearables` - tracker devices - `users/me/dataSourceFamilies/google-sources` - Google first party sources", + "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.", "type": "string" }, "pageSize": { @@ -2267,6 +2275,14 @@ "$ref": "IrregularRhythmNotification", "description": "Optional. Data for points in the `irregular-rhythm-notification` session data type collection." }, + "menstrualPeriod": { + "$ref": "MenstrualPeriod", + "description": "Optional. Data for points in the `menstrual-period` interval data type collection." + }, + "moods": { + "$ref": "Moods", + "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.", "type": "string" @@ -2275,6 +2291,10 @@ "$ref": "NutritionLog", "description": "Optional. Data for points in the `nutrition-log` session data type collection." }, + "ovulationTest": { + "$ref": "OvulationTest", + "description": "Optional. Data for points in the `ovulation-test` sample data type collection." + }, "oxygenSaturation": { "$ref": "OxygenSaturation", "description": "Optional. Data for points in the `oxygen-saturation` sample data type collection." @@ -2303,6 +2323,10 @@ "$ref": "SwimLengthsData", "description": "Optional. Data for points in the `swim-lengths-data` interval data type collection." }, + "symptoms": { + "$ref": "Symptoms", + "description": "Optional. Data for points in the `symptoms` sample data type collection." + }, "timeInHeartRateZone": { "$ref": "TimeInHeartRateZone", "description": "Optional. Data for points in the `time-in-heart-rate-zone` interval data type collection." @@ -2695,7 +2719,7 @@ "type": "string" }, "displayName": { - "description": "Required. Exercise display name.", + "description": "Required. The localized, human-readable name of the exercise. For all exercise types other than `OTHER`, the system ignores client input and overrides this field with a generated name based on `exercise_type` (e.g., \"Walking\" for `WALKING`). If `exercise_type` is `OTHER`, this field can contain the user's custom, free-form display name.", "type": "string" }, "exerciseEvents": { @@ -3908,6 +3932,21 @@ }, "type": "object" }, + "MenstrualPeriod": { + "description": "Menstrual period record.", + "id": "MenstrualPeriod", + "properties": { + "interval": { + "$ref": "ObservationTimeInterval", + "description": "Required. Observed interval." + }, + "notes": { + "description": "Optional. Standard free-form notes captured at manual logging.", + "type": "string" + } + }, + "type": "object" + }, "MetricsSummary": { "description": "Summary metrics for an exercise.", "id": "MetricsSummary", @@ -4005,6 +4044,161 @@ }, "type": "object" }, + "Moods": { + "description": "Moods record.", + "id": "Moods", + "properties": { + "moods": { + "description": "Required. The moods logged.", + "items": { + "enum": [ + "MOOD_UNSPECIFIED", + "AMAZED", + "AMUSED", + "ANGRY", + "ANNOYED", + "ANXIOUS", + "HAPPY", + "CONTENT", + "SAD", + "WORRIED", + "FRUSTRATED", + "EXCITED", + "CALM", + "STRESSED", + "ASHAMED", + "BRAVE", + "CONFIDENT", + "DISAPPOINTED", + "DISCOURAGED", + "DISGUSTED", + "DRAINED", + "EMBARRASSED", + "GRATEFUL", + "GUILTY", + "HOPEFUL", + "HOPELESS", + "INDIFFERENT", + "IRRITATED", + "JEALOUS", + "JOYFUL", + "LONELY", + "OVERWHELMED", + "PASSIONATE", + "PEACEFUL", + "PROUD", + "RELIEVED", + "SATISFIED", + "SCARED", + "SURPRISED", + "ENERGIZED", + "FATIGUED", + "VERY_CALM", + "VERY_STRESSED", + "NEUTRAL", + "AFRAID", + "HURTING", + "BORED", + "BITTER", + "ENVIOUS", + "CONFUSED", + "CURIOUS", + "AWESTRUCK", + "INSPIRED", + "LONGING", + "ACCOMPLISHED", + "LOVING", + "COMPASSIONATE" + ], + "enumDescriptions": [ + "Unspecified mood.", + "Amazed.", + "Amused.", + "Angry.", + "Annoyed.", + "Anxious.", + "Happy.", + "Content.", + "Sad.", + "Worried.", + "Frustrated.", + "Excited.", + "Calm.", + "Stressed.", + "Ashamed.", + "Brave.", + "Confident.", + "Disappointed.", + "Discouraged.", + "Disgusted.", + "Drained.", + "Embarrassed.", + "Grateful.", + "Guilty.", + "Hopeful.", + "Hopeless.", + "Indifferent.", + "Irritated.", + "Jealous.", + "Joyful.", + "Lonely.", + "Overwhelmed.", + "Passionate.", + "Peaceful.", + "Proud.", + "Relieved.", + "Satisfied.", + "Scared.", + "Surprised.", + "Energized.", + "Fatigued.", + "Very calm.", + "Very stressed.", + "Neutral.", + "Afraid.", + "Hurting.", + "Bored.", + "Bitter.", + "Envious.", + "Confused.", + "Curious.", + "Awestruck.", + "Inspired.", + "Longing.", + "Accomplished.", + "Loving.", + "Compassionate." + ], + "type": "string" + }, + "type": "array" + }, + "sampleTime": { + "$ref": "ObservationSampleTime", + "description": "Required. The time at which moods were measured." + }, + "valences": { + "description": "Optional. The valences.", + "items": { + "enum": [ + "VALENCE_UNSPECIFIED", + "UNPLEASANT", + "BASELINE", + "PLEASANT" + ], + "enumDescriptions": [ + "Unspecified valence.", + "Unpleasant.", + "Baseline.", + "Pleasant." + ], + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "NutrientQuantity": { "description": "Represents the quantity of a nutrient.", "id": "NutrientQuantity", @@ -4428,6 +4622,37 @@ }, "type": "object" }, + "OvulationTest": { + "description": "Ovulation test record.", + "id": "OvulationTest", + "properties": { + "result": { + "description": "Required. The result of the ovulation test.", + "enum": [ + "OVULATION_TEST_RESULT_UNSPECIFIED", + "NEGATIVE", + "LUTEINIZING_HORMONE_SURGE", + "ESTROGEN_SURGE", + "POSITIVE", + "INDETERMINATE" + ], + "enumDescriptions": [ + "Unspecified result.", + "Negative result.", + "Luteinizing hormone surge.", + "Estrogen surge.", + "Positive result.", + "Indeterminate result." + ], + "type": "string" + }, + "sampleTime": { + "$ref": "ObservationSampleTime", + "description": "Required. The time at which ovulation test was measured." + } + }, + "type": "object" + }, "OxygenSaturation": { "description": "Captures the user's instantaneous oxygen saturation percentage (SpO2).", "id": "OxygenSaturation", @@ -4784,7 +5009,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 - `users/me/dataSourceFamilies/google-wearables` - tracker devices - `users/me/dataSourceFamilies/google-sources` - Google first party sources", + "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.", "type": "string" }, "pageSize": { @@ -5055,7 +5280,7 @@ "type": "boolean" }, "distanceUnit": { - "description": "Optional. The measurement unit defined in the user's account settings. Updates to this field are currently not supported.", + "description": "Optional. The measurement unit defined in the user's account settings.", "enum": [ "DISTANCE_UNIT_UNSPECIFIED", "DISTANCE_UNIT_MILES", @@ -5238,6 +5463,14 @@ }, "type": "array" }, + "shortAwakenings": { + "description": "Output only. List of short awake segments (under a set threshold) that are part of the sleep session. These can overlap with sleep stages.", + "items": { + "$ref": "SleepStage" + }, + "readOnly": true, + "type": "array" + }, "stages": { "description": "Optional. List of non-overlapping contiguous sleep stage segments that cover the sleep period.", "items": { @@ -5742,6 +5975,88 @@ }, "type": "object" }, + "Symptoms": { + "description": "Symptoms logged by the user.", + "id": "Symptoms", + "properties": { + "sampleTime": { + "$ref": "ObservationSampleTime", + "description": "Required. Time when the symptoms were logged." + }, + "symptoms": { + "description": "Required. List of symptoms experienced.", + "items": { + "enum": [ + "SYMPTOM_VALUE_UNSPECIFIED", + "CRAMPS", + "HEADACHE", + "TENDER_BREASTS", + "ACNE", + "SICK", + "BLOATED", + "HOT_FLASHES", + "PMS", + "COUGH", + "FEVER", + "DIFFICULTY_BREATHING", + "BACK_PAIN", + "SHAKINESS", + "HUNGER", + "SWEATING", + "ANXIETY", + "THIRST", + "FREQUENT_URINATION", + "BLURRED_VISION", + "OTHER", + "SEX_DRIVE_HIGH", + "SEX_DRIVE_MEDIUM", + "SEX_DRIVE_LOW", + "HEART_PALPITATIONS", + "FAINTING", + "CHEST_PAIN", + "FATIGUE", + "CONFUSION", + "DIZZINESS" + ], + "enumDescriptions": [ + "Unspecified symptom value.", + "Abdominal cramps.", + "Headache.", + "Tender breasts.", + "Acne.", + "Feeling sick or unwell.", + "Bloating or abdominal swelling.", + "Hot flashes.", + "Premenstrual syndrome symptoms.", + "Coughing.", + "Fever or elevated body temperature.", + "Difficulty breathing or shortness of breath.", + "Back pain.", + "Shakiness or tremors.", + "Excessive hunger.", + "Excessive sweating.", + "Anxiety or nervousness.", + "Excessive thirst.", + "Frequent urination.", + "Blurred vision.", + "Other symptoms.", + "High sex drive.", + "Medium sex drive.", + "Low sex drive.", + "Heart palpitations or racing heart.", + "Fainting or loss of consciousness.", + "Chest pain or discomfort.", + "Fatigue or extreme tiredness.", + "Confusion or mental fogginess.", + "Dizziness or lightheadedness." + ], + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "TimeInHeartRateZone": { "description": "Time in heart rate zone record. It's an interval spent in specific heart rate zone.", "id": "TimeInHeartRateZone", diff --git a/discovery/homegraph-v1.json b/discovery/homegraph-v1.json index 0bde773d003..01eae12bb81 100644 --- a/discovery/homegraph-v1.json +++ b/discovery/homegraph-v1.json @@ -216,7 +216,7 @@ } } }, - "revision": "20260724", + "revision": "20260731", "rootUrl": "https://homegraph.googleapis.com/", "schemas": { "AgentDeviceId": { @@ -245,6 +245,31 @@ }, "type": "object" }, + "CameraEventStreamTrait": { + "description": "This cluster defines the camera event stream used by GHP for their Cloud-to-Cloud eventing flow", + "id": "CameraEventStreamTrait", + "properties": {}, + "type": "object" + }, + "CommonEventDataStruct": { + "description": "Common camera event data.", + "id": "CommonEventDataStruct", + "properties": { + "mediaUrls": { + "$ref": "MediaUrlsStruct", + "description": "Contains media urls for the event" + }, + "sessionId": { + "description": "Camera event session id. Used for identifying a unique event session", + "type": "string" + }, + "trackId": { + "description": "Id of the track this object belongs to", + "type": "string" + } + }, + "type": "object" + }, "Component": { "description": "Component of a provider device.", "id": "Component", @@ -364,6 +389,33 @@ }, "type": "object" }, + "DeviceBlameStruct": { + "description": "Contains metadata about the cause of presence state change attributed to a device.", + "id": "DeviceBlameStruct", + "properties": { + "blameType": { + "description": "Required. Specifies the device blame type.", + "enum": [ + "DEVICE_BLAME_TYPE_ENUM_UNSPECIFIED", + "LOCK", + "UNLOCK", + "MOTION_DETECTION", + "TOUCH_INTERACTION", + "VOICE_INTERACTION" + ], + "enumDescriptions": [ + "Indicates an unspecified device blame type.", + "Indicates lock interaction.", + "Indicates unlock interaction.", + "Indicates motion detection.", + "Indicates touch interaction.", + "Indicates voice interaction." + ], + "type": "string" + } + }, + "type": "object" + }, "DeviceInfo": { "description": "Device information.", "id": "DeviceInfo", @@ -433,6 +485,127 @@ "properties": {}, "type": "object" }, + "EveUtilityTrait": { + "id": "EveUtilityTrait", + "properties": { + "acceptedCommandList": { + "description": "Required. Output only. Accepted command list for this trait", + "items": { + "enum": [ + "COMMANDS_UNSPECIFIED" + ], + "enumDeprecated": [ + true + ], + "enumDescriptions": [ + "Deprecated: This enum exists only to conform to AIP guidelines and should never be used." + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "accumulatedControlPoint": { + "format": "int64", + "type": "string" + }, + "airPressure": { + "format": "double", + "readOnly": true, + "type": "number" + }, + "altitude": { + "format": "double", + "type": "number" + }, + "childLock": { + "type": "boolean" + }, + "current": { + "format": "double", + "readOnly": true, + "type": "number" + }, + "getConfig": { + "format": "byte", + "readOnly": true, + "type": "string" + }, + "holdPosition": { + "type": "boolean" + }, + "lastEventTime": { + "format": "int64", + "readOnly": true, + "type": "string" + }, + "loggingControlPoint": { + "format": "byte", + "type": "string" + }, + "loggingData": { + "format": "byte", + "readOnly": true, + "type": "string" + }, + "loggingMetadata": { + "format": "byte", + "readOnly": true, + "type": "string" + }, + "loggingTime": { + "format": "byte", + "type": "string" + }, + "motionSensitivity": { + "format": "int32", + "type": "integer" + }, + "obstructionDetected": { + "readOnly": true, + "type": "boolean" + }, + "openCount": { + "format": "int64", + "type": "string" + }, + "rloc16": { + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "setConfig": { + "format": "byte", + "type": "string" + }, + "statusFault": { + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "voltage": { + "format": "double", + "readOnly": true, + "type": "number" + }, + "watt": { + "format": "double", + "readOnly": true, + "type": "number" + }, + "wattAccumulated": { + "format": "double", + "readOnly": true, + "type": "number" + }, + "weatherTrend": { + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, "EventData": { "description": "Contains the details for a single event.", "id": "EventData", @@ -522,6 +695,76 @@ }, "type": "object" }, + "MediaUrlsStruct": { + "id": "MediaUrlsStruct", + "properties": { + "dashManifestUrl": { + "description": "URL for a dash manifest for playback", + "type": "string" + }, + "hlsMasterPlaylistUrl": { + "description": "URL for a hls master playlist for playback", + "type": "string" + }, + "previewUrl": { + "description": "URL for animated preview clip representing the event session", + "type": "string" + }, + "thumbnailUrl": { + "description": "URL for thumbnail image representing the event session", + "type": "string" + } + }, + "type": "object" + }, + "MotionEvent": { + "description": "Represents a newly detected motion event.", + "id": "MotionEvent", + "properties": { + "commonEventData": { + "$ref": "CommonEventDataStruct" + }, + "zones": { + "description": "Zones where events are detected in.", + "items": { + "$ref": "ZoneStruct" + }, + "type": "array" + }, + "zonesIsEmpty": { + "description": "If set, zones is an empty list.", + "type": "boolean" + } + }, + "type": "object" + }, + "PartnerPresenceSignalTrait": { + "description": "Provides attributes and events related to partner presence signals. See PartnerPresenceSignal trait:", + "id": "PartnerPresenceSignalTrait", + "properties": {}, + "type": "object" + }, + "PersonEvent": { + "description": "Represents a newly detected person event.", + "id": "PersonEvent", + "properties": { + "commonEventData": { + "$ref": "CommonEventDataStruct" + }, + "zones": { + "description": "Zones where events are detected in.", + "items": { + "$ref": "ZoneStruct" + }, + "type": "array" + }, + "zonesIsEmpty": { + "description": "If set, zones is an empty list.", + "type": "boolean" + } + }, + "type": "object" + }, "QueryRequest": { "description": "Request type for the [`Query`](#google.home.graph.v1.HomeGraphApiService.Query) call.", "id": "QueryRequest", @@ -763,6 +1006,46 @@ }, "type": "object" }, + "StructurePresenceStateChangeEvent": { + "description": "Sent when the structure presence state changes.", + "id": "StructurePresenceStateChangeEvent", + "properties": { + "presenceState": { + "description": "Required. Specifies the presence state.", + "enum": [ + "STRUCTURE_PRESENCE_STATE_ENUM_UNSPECIFIED", + "HOME", + "AWAY" + ], + "enumDescriptions": [ + "Indicates an unknown presence state.", + "Indicates home presence state.", + "Indicates away presence state." + ], + "type": "string" + }, + "reason": { + "$ref": "StructurePresenceStateChangeReasonStruct", + "description": "Optional. Specifies the presence state change reason." + } + }, + "type": "object" + }, + "StructurePresenceStateChangeReasonStruct": { + "description": "Contains the metadata about the cause of the structure presence state change.", + "id": "StructurePresenceStateChangeReasonStruct", + "properties": { + "deviceBlame": { + "$ref": "DeviceBlameStruct", + "description": "Optional. Contains metadata about the cause of presence state change attributed to a device." + }, + "userBlame": { + "$ref": "UserBlameStruct", + "description": "Optional. Contains metadata about the cause of presence state change attributed to a user." + } + }, + "type": "object" + }, "SyncRequest": { "description": "Request type for the [`Sync`](#google.home.graph.v1.HomeGraphApiService.Sync) call.", "id": "SyncRequest", @@ -811,6 +1094,40 @@ }, "type": "object" }, + "ThermostatFanControlTrait": { + "description": "This cluster provides fan control capabilities for thermostats.", + "id": "ThermostatFanControlTrait", + "properties": { + "timerDuration": { + "format": "int64", + "type": "string" + }, + "timerEnd": { + "format": "int64", + "type": "string" + }, + "timerSpeed": { + "enum": [ + "FAN_SPEED_SETTING_ENUM_UNSPECIFIED", + "FAN_SPEED_SETTING_OFF", + "FAN_SPEED_SETTING_STAGE1", + "FAN_SPEED_SETTING_STAGE2", + "FAN_SPEED_SETTING_STAGE3", + "FAN_SPEED_SETTING_AUTO" + ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" + ], + "type": "string" + } + }, + "type": "object" + }, "TraitData": { "description": "Contains the trait payload for a single trait.", "id": "TraitData", @@ -835,6 +1152,46 @@ } }, "type": "object" + }, + "UserBlameStruct": { + "description": "Contains metadata about the cause of presence state change attributed to a user.", + "id": "UserBlameStruct", + "properties": { + "blameType": { + "description": "Required. Specifies the user blame type.", + "enum": [ + "USER_BLAME_TYPE_ENUM_UNSPECIFIED", + "PHONE_LOCATION", + "MANUAL_CHANGE" + ], + "enumDescriptions": [ + "Indicates an unspecified user blame type.", + "Indicates phone location.", + "Indicates manual change." + ], + "type": "string" + }, + "userEmail": { + "description": "Required. Specifies the email of the user.", + "type": "string" + } + }, + "type": "object" + }, + "ZoneStruct": { + "id": "ZoneStruct", + "properties": { + "label": { + "description": "Name of the zone.", + "type": "string" + }, + "zoneId": { + "description": "Id of the zone", + "format": "int64", + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/discovery/hypercomputecluster-v1.json b/discovery/hypercomputecluster-v1.json index 306581849f6..f77870d65c8 100644 --- a/discovery/hypercomputecluster-v1.json +++ b/discovery/hypercomputecluster-v1.json @@ -498,7 +498,7 @@ } } }, - "revision": "20260617", + "revision": "20260729", "rootUrl": "https://hypercomputecluster.googleapis.com/", "schemas": { "BootDisk": { @@ -1168,14 +1168,16 @@ "STANDARD", "NEARLINE", "COLDLINE", - "ARCHIVE" + "ARCHIVE", + "RAPID" ], "enumDescriptions": [ "Not set.", "Best for data that is frequently accessed.", "Low-cost storage for data that is accessed less frequently.", "Very low-cost storage for infrequently accessed data.", - "Lowest-cost storage for data archiving, online backup, and disaster recovery." + "Lowest-cost storage for data archiving, online backup, and disaster recovery.", + "Storage class optimized for I/O intensive workloads." ], "type": "string" } diff --git a/discovery/index.json b/discovery/index.json index 94c57e63ade..8bde157657f 100644 --- a/discovery/index.json +++ b/discovery/index.json @@ -541,6 +541,21 @@ "title": "Analytics Hub API", "version": "v1" }, + { + "description": "Android Developer ID Status API.", + "discoveryRestUrl": "https://androiddeveloperidstatus.googleapis.com/$discovery/rest?version=v1", + "documentationLink": "https://developer.android.com/developer-verification/guides/check-registration-status", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "id": "androiddeveloperidstatus:v1", + "kind": "discovery#directoryItem", + "name": "androiddeveloperidstatus", + "preferred": true, + "title": "Android Developer ID Status API", + "version": "v1" + }, { "description": "Automates Android zero-touch enrollment for device resellers, customers, and EMMs.", "discoveryRestUrl": "https://androiddeviceprovisioning.googleapis.com/$discovery/rest?version=v1", @@ -3770,6 +3785,36 @@ "title": "Google Forms API", "version": "v1" }, + { + "description": "A managed, cloud-native solution to move data in and out of Google Cloud by using SSH File Transfer Protocol (SFTP).", + "discoveryRestUrl": "https://ftp.googleapis.com/$discovery/rest?version=v1alpha", + "documentationLink": "https://docs.cloud.google.com/cloud-ftp", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "id": "ftp:v1alpha", + "kind": "discovery#directoryItem", + "name": "ftp", + "preferred": false, + "title": "Cloud FTP API", + "version": "v1alpha" + }, + { + "description": "A managed, cloud-native solution to move data in and out of Google Cloud by using SSH File Transfer Protocol (SFTP).", + "discoveryRestUrl": "https://ftp.googleapis.com/$discovery/rest?version=v1", + "documentationLink": "https://docs.cloud.google.com/cloud-ftp", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "id": "ftp:v1", + "kind": "discovery#directoryItem", + "name": "ftp", + "preferred": true, + "title": "Cloud FTP API", + "version": "v1" + }, { "description": "The Google Play Games Service allows developers to enhance games with social leaderboards, achievements, game state, sign-in with Google, and more.", "discoveryRestUrl": "https://games.googleapis.com/$discovery/rest?version=v1", @@ -4820,6 +4865,21 @@ "title": "Merchant API", "version": "lfp_v1beta" }, + { + "description": "Programmatically manage your Merchant Center Accounts.", + "discoveryRestUrl": "https://merchantapi.googleapis.com/$discovery/rest?version=loyaltycustomers_v1", + "documentationLink": "https://developers.google.com/merchant/api", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "id": "merchantapi:loyaltycustomers_v1", + "kind": "discovery#directoryItem", + "name": "merchantapi", + "preferred": false, + "title": "Merchant API", + "version": "loyaltycustomers_v1" + }, { "description": "Programmatically manage your Merchant Center Accounts.", "discoveryRestUrl": "https://merchantapi.googleapis.com/$discovery/rest?version=notifications_v1", diff --git a/discovery/kmsinventory-v1.json b/discovery/kmsinventory-v1.json index 58f39d6ca8a..6c83a68672a 100644 --- a/discovery/kmsinventory-v1.json +++ b/discovery/kmsinventory-v1.json @@ -306,7 +306,7 @@ } } }, - "revision": "20260705", + "revision": "20260802", "rootUrl": "https://kmsinventory.googleapis.com/", "schemas": { "GoogleCloudKmsInventoryV1ListCryptoKeysResponse": { @@ -618,6 +618,9 @@ "PQ_SIGN_ML_DSA_44_EXTERNAL_MU", "PQ_SIGN_ML_DSA_65_EXTERNAL_MU", "PQ_SIGN_ML_DSA_87_EXTERNAL_MU", + "KEM_ECDH_P256", + "KEM_ECDH_P384", + "KEM_ECDH_P521", "AES_256_KWP" ], "enumDescriptions": [ @@ -668,6 +671,9 @@ "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 1. Randomized version supporting externally-computed message representatives.", "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version supporting externally-computed message representatives.", "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 5. Randomized version supporting externally-computed message representatives.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-256 key that returns shared secret.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-384 key that returns shared secret.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-521 key that returns shared secret.", "AES key wrap with zero padding algorithm (RFC 5649). Can only be used by keys with purpose AES_WRAPPING." ], "readOnly": true, @@ -859,6 +865,9 @@ "PQ_SIGN_ML_DSA_44_EXTERNAL_MU", "PQ_SIGN_ML_DSA_65_EXTERNAL_MU", "PQ_SIGN_ML_DSA_87_EXTERNAL_MU", + "KEM_ECDH_P256", + "KEM_ECDH_P384", + "KEM_ECDH_P521", "AES_256_KWP" ], "enumDescriptions": [ @@ -909,6 +918,9 @@ "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 1. Randomized version supporting externally-computed message representatives.", "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version supporting externally-computed message representatives.", "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 5. Randomized version supporting externally-computed message representatives.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-256 key that returns shared secret.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-384 key that returns shared secret.", + "Key encapsulation: Elliptic Curve Diffie-Hellman with NIST P-521 key that returns shared secret.", "AES key wrap with zero padding algorithm (RFC 5649). Can only be used by keys with purpose AES_WRAPPING." ], "type": "string" diff --git a/discovery/looker-v1.json b/discovery/looker-v1.json index 0133cff3987..08cd516e116 100644 --- a/discovery/looker-v1.json +++ b/discovery/looker-v1.json @@ -748,7 +748,7 @@ } } }, - "revision": "20260609", + "revision": "20260726", "rootUrl": "https://looker.googleapis.com/", "schemas": { "AdminSettings": { @@ -1391,14 +1391,14 @@ "id": "ListInstancesResponse", "properties": { "instances": { - "description": "The list of instances matching the request filters, up to the requested ListInstancesRequest.pageSize.", + "description": "The list of instances matching the request filters, up to the requested `pageSize`.", "items": { "$ref": "Instance" }, "type": "array" }, "nextPageToken": { - "description": "If provided, a page token that can look up the next ListInstancesRequest.pageSize results. If empty, the results list is exhausted.", + "description": "If provided, a page token that can look up the next `pageSize` results. If empty, the results list is exhausted.", "type": "string" }, "unreachable": { diff --git a/discovery/merchantapi-loyaltycustomers_v1.json b/discovery/merchantapi-loyaltycustomers_v1.json new file mode 100644 index 00000000000..56cab38c93e --- /dev/null +++ b/discovery/merchantapi-loyaltycustomers_v1.json @@ -0,0 +1,422 @@ +{ + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/content": { + "description": "Manage your product listings and accounts for Google Shopping" + } + } + } + }, + "basePath": "", + "baseUrl": "https://merchantapi.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Merchant", + "description": "Programmatically manage your Merchant Center Accounts.", + "discoveryVersion": "v1", + "documentationLink": "https://developers.google.com/merchant/api", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "merchantapi:loyaltycustomers_v1", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://merchantapi.mtls.googleapis.com/", + "name": "merchantapi", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "accounts": { + "resources": { + "loyaltyCustomers": { + "methods": { + "manage": { + "description": "Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization.", + "flatPath": "loyaltyCustomers/v1/accounts/{accountsId}/loyaltyCustomers:manage", + "httpMethod": "POST", + "id": "merchantapi.accounts.loyaltyCustomers.manage", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent account where this loyalty customer will be handled. Format: `accounts/{account}`", + "location": "path", + "pattern": "^accounts/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "loyaltyCustomers/v1/{+parent}/loyaltyCustomers:manage", + "request": { + "$ref": "ManageLoyaltyCustomerMatchRequest" + }, + "response": { + "$ref": "ManageLoyaltyCustomerMatchResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/content" + ] + } + } + } + } + } + }, + "revision": "20260805", + "rootUrl": "https://merchantapi.googleapis.com/", + "schemas": { + "AddressInfo": { + "description": "Represents a customer’s physical address.", + "id": "AddressInfo", + "properties": { + "city": { + "description": "Optional. The city of the customer.", + "type": "string" + }, + "familyName": { + "description": "Optional. The family name of the customer.", + "type": "string" + }, + "givenName": { + "description": "Optional. The given name of the customer.", + "type": "string" + }, + "postalCode": { + "description": "Optional. The postal code (zip code) of the customer. **Format Rules:** * **United States:** 5-digit zip codes (e.g., \"94108\").", + "type": "string" + }, + "regionCode": { + "description": "Optional. The Unicode country/region code (CLDR) of the customer, such as \"US\" or \"CH\". This field is case-insensitive. For more information, see https://cldr.unicode.org/ and https://www.unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html.", + "type": "string" + }, + "state": { + "description": "Optional. The state or province of the customer.", + "type": "string" + } + }, + "type": "object" + }, + "LoyaltyCustomer": { + "description": "Represents a customer’s loyalty information. Represents loyalty customer data in `ManageLoyaltyCustomerMatch` API, but is not a resource that can be retrieved or listed by other methods.", + "id": "LoyaltyCustomer", + "properties": { + "loyaltyTier": { + "description": "Required. The tier label of the loyalty tier the customer belongs to.", + "enum": [ + "LOYALTY_TIER_UNSPECIFIED", + "TIER1", + "TIER2", + "TIER3", + "TIER4", + "TIER5", + "TIER6", + "TIER7", + "NON_MEMBER" + ], + "enumDescriptions": [ + "Loyalty tier unspecified.", + "Loyalty tier 1.", + "Loyalty tier 2.", + "Loyalty tier 3.", + "Loyalty tier 4.", + "Loyalty tier 5.", + "Loyalty tier 6.", + "Loyalty tier 7.", + "Disassociates the user from any loyalty tier. Only set to “NON_MEMBER” when the intent is to remove the user association from Google organic loyalty customer match experience." + ], + "type": "string" + }, + "pointBalance": { + "description": "Optional. The point balance of the loyalty customer.", + "format": "int64", + "type": "string" + }, + "userIdentifier": { + "$ref": "UserIdentifier", + "description": "Required. The identifiers for the customer." + } + }, + "type": "object" + }, + "ManageLoyaltyCustomerMatchRequest": { + "description": "Request message for the ManageLoyaltyCustomerMatch method.", + "id": "ManageLoyaltyCustomerMatchRequest", + "properties": { + "loyaltyCustomer": { + "$ref": "LoyaltyCustomer", + "description": "Required. The loyalty customer to insert, update, or remove." + } + }, + "type": "object" + }, + "ManageLoyaltyCustomerMatchResponse": { + "description": "Response message for the ManageLoyaltyCustomerMatch method.", + "id": "ManageLoyaltyCustomerMatchResponse", + "properties": { + "loyaltyCustomer": { + "$ref": "LoyaltyCustomer", + "description": "The loyalty customer that was inserted, updated, or removed. If the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization, this field will contain a default `LoyaltyCustomer` instance." + } + }, + "type": "object" + }, + "ProductChange": { + "description": "The change that happened to the product including old value, new value, country code as the region code and reporting context.", + "id": "ProductChange", + "properties": { + "newValue": { + "description": "The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)", + "type": "string" + }, + "oldValue": { + "description": "The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)", + "type": "string" + }, + "regionCode": { + "description": "Countries that have the change (if applicable). Represented in the ISO 3166 format.", + "type": "string" + }, + "reportingContext": { + "description": "Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)", + "enum": [ + "REPORTING_CONTEXT_ENUM_UNSPECIFIED", + "SHOPPING_ADS", + "DISCOVERY_ADS", + "DEMAND_GEN_ADS", + "DEMAND_GEN_ADS_DISCOVER_SURFACE", + "VIDEO_ADS", + "DISPLAY_ADS", + "LOCAL_INVENTORY_ADS", + "VEHICLE_INVENTORY_ADS", + "FREE_LISTINGS", + "FREE_LISTINGS_UCP_CHECKOUT", + "FREE_LOCAL_LISTINGS", + "FREE_LOCAL_VEHICLE_LISTINGS", + "YOUTUBE_AFFILIATE", + "YOUTUBE_SHOPPING", + "CLOUD_RETAIL", + "LOCAL_CLOUD_RETAIL", + "PRODUCT_REVIEWS", + "MERCHANT_REVIEWS", + "YOUTUBE_CHECKOUT" + ], + "enumDeprecated": [ + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enumDescriptions": [ + "Not specified.", + "[Shopping ads](https://support.google.com/merchants/answer/6149970).", + "Deprecated: Use `DEMAND_GEN_ADS` instead. [Discovery and Demand Gen ads](https://support.google.com/merchants/answer/13389785).", + "[Demand Gen ads](https://support.google.com/merchants/answer/13389785).", + "[Demand Gen ads on Discover surface](https://support.google.com/merchants/answer/13389785).", + "[Video ads](https://support.google.com/google-ads/answer/6340491).", + "[Display ads](https://support.google.com/merchants/answer/6069387).", + "[Local inventory ads](https://support.google.com/merchants/answer/3271956).", + "[Vehicle inventory ads](https://support.google.com/merchants/answer/11544533).", + "[Free product listings](https://support.google.com/merchants/answer/9199328).", + "[Free product listings on UCP checkout](https://developers.google.com/merchant/ucp).", + "[Free local product listings](https://support.google.com/merchants/answer/9825611).", + "[Free local vehicle listings](https://support.google.com/merchants/answer/11544533).", + "[Youtube Affiliate](https://support.google.com/youtube/answer/13376398).", + "[YouTube Shopping](https://support.google.com/merchants/answer/13478370).", + "[Cloud retail](https://cloud.google.com/solutions/retail).", + "[Local cloud retail](https://cloud.google.com/solutions/retail).", + "[Product Reviews](https://support.google.com/merchants/answer/14620732).", + "[Merchant Reviews](https://developers.google.com/merchant-review-feeds).", + "YouTube Checkout ." + ], + "type": "string" + } + }, + "type": "object" + }, + "ProductStatusChangeMessage": { + "description": "The message that the merchant will receive to notify about product status change event", + "id": "ProductStatusChangeMessage", + "properties": { + "account": { + "description": "The target account that owns the entity that changed. Format : `accounts/{merchant_id}`", + "type": "string" + }, + "attribute": { + "description": "The attribute in the resource that changed, in this case it will be always `Status`.", + "enum": [ + "ATTRIBUTE_UNSPECIFIED", + "STATUS" + ], + "enumDescriptions": [ + "Unspecified attribute", + "Status of the changed entity" + ], + "type": "string" + }, + "changes": { + "description": "A message to describe the change that happened to the product", + "items": { + "$ref": "ProductChange" + }, + "type": "array" + }, + "eventTime": { + "description": "The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.", + "format": "google-datetime", + "type": "string" + }, + "expirationTime": { + "description": "Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.", + "format": "google-datetime", + "type": "string" + }, + "managingAccount": { + "description": "The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}`", + "type": "string" + }, + "resource": { + "description": "The product name. Format: `accounts/{account}/products/{product}`", + "type": "string" + }, + "resourceId": { + "description": "The product id.", + "type": "string" + }, + "resourceType": { + "description": "The resource that changed, in this case it will always be `Product`.", + "enum": [ + "RESOURCE_UNSPECIFIED", + "PRODUCT", + "ACCOUNT_SERVICE" + ], + "enumDescriptions": [ + "Unspecified resource", + "Resource type : product", + "Account service" + ], + "type": "string" + } + }, + "type": "object" + }, + "UserIdentifier": { + "description": "The user identifiers associated with the customer. At least one of the fields within this message must be provided.", + "id": "UserIdentifier", + "properties": { + "address": { + "$ref": "AddressInfo", + "description": "Optional. The customer’s physical address." + }, + "emailAddress": { + "description": "Optional. The customer’s email address.", + "type": "string" + }, + "phoneNumber": { + "description": "Optional. The customer's phone number, in [E.164 format](https://support.google.com/google-ads/answer/16355235) (e.g., \"+16502530000\").", + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Merchant API", + "version": "loyaltycustomers_v1", + "version_module": true +} \ No newline at end of file diff --git a/discovery/migrationcenter-v1.json b/discovery/migrationcenter-v1.json index 581d7ee1fcb..54bed93c519 100644 --- a/discovery/migrationcenter-v1.json +++ b/discovery/migrationcenter-v1.json @@ -1976,7 +1976,7 @@ "type": "string" }, "reportConfigId": { - "description": "Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: [a-z]([a-z0-9-]{0,61}[a-z0-9])?.", + "description": "Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.", "location": "query", "type": "string" }, @@ -2124,7 +2124,7 @@ "type": "string" }, "reportId": { - "description": "Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: [a-z]([a-z0-9-]{0,61}[a-z0-9])?.", + "description": "Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.", "location": "query", "type": "string" }, @@ -2568,7 +2568,7 @@ } } }, - "revision": "20260423", + "revision": "20260730", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { diff --git a/discovery/migrationcenter-v1alpha1.json b/discovery/migrationcenter-v1alpha1.json index 4946773b3e9..a534f390d17 100644 --- a/discovery/migrationcenter-v1alpha1.json +++ b/discovery/migrationcenter-v1alpha1.json @@ -1967,7 +1967,7 @@ "type": "string" }, "reportConfigId": { - "description": "Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: [a-z]([a-z0-9-]{0,61}[a-z0-9])?.", + "description": "Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.", "location": "query", "type": "string" }, @@ -2115,7 +2115,7 @@ "type": "string" }, "reportId": { - "description": "Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: [a-z]([a-z0-9-]{0,61}[a-z0-9])?.", + "description": "Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.", "location": "query", "type": "string" }, @@ -2722,7 +2722,7 @@ } } }, - "revision": "20260621", + "revision": "20260730", "rootUrl": "https://migrationcenter.googleapis.com/", "schemas": { "AddAssetsToGroupRequest": { @@ -4440,7 +4440,7 @@ "type": "string" }, "smtEnabled": { - "description": "Output only. Whether simultaneous multithreading is enabled (see https://cloud.google.com/compute/docs/instances/set-threads-per-core).", + "description": "Output only. Whether simultaneous multithreading is enabled. See https://cloud.google.com/compute/docs/instances/set-threads-per-core.", "readOnly": true, "type": "boolean" }, diff --git a/discovery/mybusinessbusinessinformation-v1.json b/discovery/mybusinessbusinessinformation-v1.json index 360eb87a0c8..29abc75ecce 100644 --- a/discovery/mybusinessbusinessinformation-v1.json +++ b/discovery/mybusinessbusinessinformation-v1.json @@ -612,7 +612,7 @@ } } }, - "revision": "20260726", + "revision": "20260804", "rootUrl": "https://mybusinessbusinessinformation.googleapis.com/", "schemas": { "AdWordsLocationExtensions": { @@ -1754,7 +1754,7 @@ }, "closeTime": { "$ref": "TimeOfDay", - "description": "Required. Valid values are 00:00-24:00, where 24:00 represents midnight at the end of the specified day field." + "description": "Required. Valid values are 00:00-24:00, where 24:00 represents midnight at the end of the specified day field. Note: In Proto3 JSON mapping, default zero values (00:00) are omitted, producing `{}` for close_time." }, "openDay": { "description": "Required. Indicates the day of the week this period starts on.", @@ -1782,7 +1782,7 @@ }, "openTime": { "$ref": "TimeOfDay", - "description": "Required. Valid values are 00:00-24:00, where 24:00 represents midnight at the end of the specified day field." + "description": "Required. Valid values are 00:00-24:00, where 24:00 represents midnight at the end of the specified day field. Note: In Proto3 JSON mapping, default zero values (00:00) are omitted, producing `{}` for open_time." } }, "type": "object" diff --git a/discovery/networkservices-v1.json b/discovery/networkservices-v1.json index a07b110b974..7ea64e61552 100644 --- a/discovery/networkservices-v1.json +++ b/discovery/networkservices-v1.json @@ -183,6 +183,173 @@ } }, "resources": { + "agentConnectivityTemplates": { + "methods": { + "create": { + "description": "Creates a new AgentConnectivityTemplate in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates", + "httpMethod": "POST", + "id": "networkservices.projects.locations.agentConnectivityTemplates.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "agentConnectivityTemplateId": { + "description": "Required. Short name of the AgentConnectivityTemplate resource to be created.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource of the AgentConnectivityTemplate. Must be in the format `projects/*/locations/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/agentConnectivityTemplates", + "request": { + "$ref": "AgentConnectivityTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single AgentConnectivityTemplate.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates/{agentConnectivityTemplatesId}", + "httpMethod": "DELETE", + "id": "networkservices.projects.locations.agentConnectivityTemplates.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "Optional. The etag of the AgentConnectivityTemplate to delete.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. A name of the AgentConnectivityTemplate to delete. Must be in the format `projects/*/locations/*/agentConnectivityTemplates/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/agentConnectivityTemplates/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single AgentConnectivityTemplate.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates/{agentConnectivityTemplatesId}", + "httpMethod": "GET", + "id": "networkservices.projects.locations.agentConnectivityTemplates.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the AgentConnectivityTemplate to get. Must be in the format `projects/*/locations/*/agentConnectivityTemplates/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/agentConnectivityTemplates/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "AgentConnectivityTemplate" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists AgentConnectivityTemplates in a given project and location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates", + "httpMethod": "GET", + "id": "networkservices.projects.locations.agentConnectivityTemplates.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Maximum number of AgentConnectivityTemplates to return per call.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The value returned by the last `ListAgentConnectivityTemplatesResponse` Indicates that this is a continuation of a prior `ListAgentConnectivityTemplates` call, and that the system should return the next page of data.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The project and location from which the AgentConnectivityTemplates should be listed, specified in the format `projects/*/locations/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If true, allow partial responses for multi-regional Aggregated List requests. Otherwise if one of the locations is down or unreachable, the Aggregated List request will fail.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1/{+parent}/agentConnectivityTemplates", + "response": { + "$ref": "ListAgentConnectivityTemplatesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single AgentConnectivityTemplate.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates/{agentConnectivityTemplatesId}", + "httpMethod": "PATCH", + "id": "networkservices.projects.locations.agentConnectivityTemplates.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/*/locations/*/agentConnectivityTemplates/`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/agentConnectivityTemplates/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. Field mask is used to specify the fields to be overwritten in the AgentConnectivityTemplate resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "AgentConnectivityTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "agentGateways": { "methods": { "create": { @@ -3732,9 +3899,82 @@ } } }, - "revision": "20260710", + "revision": "20260724", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { + "AgentConnectivityTemplate": { + "description": "AgentConnectivityTemplate represents a reusable network configuration.", + "id": "AgentConnectivityTemplate", + "properties": { + "accessPath": { + "description": "Required. Immutable. The path of the access. Maps roughly to ingress/egress, though we keep CLIENT_TO_AGENT and AGENT_TO_ANYWHERE as carryovers from Agent Gateway's original resource model. The path is immutable once set. Exactly one path can be set.", + "enum": [ + "ACCESS_PATH_UNSPECIFIED", + "CLIENT_TO_AGENT", + "AGENT_TO_ANYWHERE" + ], + "enumDescriptions": [ + "Unspecified access path.", + "Protect connection to Agent or Tool.", + "Govern agent connections to destinations." + ], + "type": "string" + }, + "accessTypes": { + "description": "Optional. The types of network access provided to the gateway. Both PUBLIC and PRIVATE can be configured.", + "items": { + "enum": [ + "ACCESS_TYPE_UNSPECIFIED", + "PUBLIC", + "PRIVATE" + ], + "enumDescriptions": [ + "Unspecified access type.", + "Public network access.", + "Private network access." + ], + "type": "string" + }, + "type": "array" + }, + "createTime": { + "description": "Output only. The timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A free-text description of the resource. Max length 1024 characters.", + "type": "string" + }, + "egressNetworkConfig": { + "$ref": "EgressNetworkConfig", + "description": "Optional. Configuration for egress network traffic." + }, + "etag": { + "description": "Optional. Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Set of label tags associated with the AgentConnectivityTemplate resource.", + "type": "object" + }, + "name": { + "description": "Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/*/locations/*/agentConnectivityTemplates/`.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The timestamp when the resource was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "AgentGateway": { "description": "AgentGateway represents the agent gateway resource.", "id": "AgentGateway", @@ -4102,6 +4342,82 @@ "properties": {}, "type": "object" }, + "DnsPeeringConfig": { + "description": "DNS Peering configuration.", + "id": "DnsPeeringConfig", + "properties": { + "domain": { + "description": "Optional. The domain to peer.", + "type": "string" + }, + "targetNetwork": { + "description": "Optional. The target network resource name for DNS peering. Format: projects/{project}/global/networks/{network_id}", + "type": "string" + } + }, + "type": "object" + }, + "EgressNetworkConfig": { + "id": "EgressNetworkConfig", + "properties": { + "dnsPeeringConfig": { + "$ref": "DnsPeeringConfig", + "description": "Optional. DNS Peering configuration." + }, + "networkAttachment": { + "description": "Optional. The network attachment resource name. Format: projects/{project}/regions/{region}/networkAttachments/{network_attachment_id}", + "type": "string" + }, + "tlsConfig": { + "$ref": "EgressNetworkConfigTlsConfig", + "description": "Optional. The TLS configuration for the egress traffic." + }, + "trustConfig": { + "description": "Optional. The trust config resource name. Format: projects/{project}/locations/{location}/trustConfigs/{trust_config}", + "type": "string" + }, + "vpcEgress": { + "description": "Optional. The VPC egress setting.", + "enum": [ + "VPC_EGRESS_UNSPECIFIED", + "ALL_TRAFFIC", + "PRIVATE_RANGES_ONLY" + ], + "enumDescriptions": [ + "Unspecified", + "All outbound traffic is routed through the VPC connector.", + "Only private IP ranges are routed through the VPC connector." + ], + "type": "string" + } + }, + "type": "object" + }, + "EgressNetworkConfigTlsConfig": { + "description": "Configuration for TLS connections.", + "id": "EgressNetworkConfigTlsConfig", + "properties": { + "additionalRoots": { + "description": "Optional. The additional roots to trust.", + "enum": [ + "ADDITIONAL_ROOTS_UNSPECIFIED", + "NO_ADDITIONAL_ROOTS", + "PUBLICLY_TRUSTED_ROOTS" + ], + "enumDescriptions": [ + "Unspecified additional roots.", + "Trust only the certificates provided in `trust_config`.", + "Trust certificates provided in `trust_config` and publicly trusted roots." + ], + "type": "string" + }, + "trustConfig": { + "description": "Optional. The trust config resource name. Format: projects/{project}/locations/{location}/trustConfigs/{trust_config}", + "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", @@ -5629,6 +5945,31 @@ }, "type": "object" }, + "ListAgentConnectivityTemplatesResponse": { + "description": "Response returned by the ListAgentConnectivityTemplates method.", + "id": "ListAgentConnectivityTemplatesResponse", + "properties": { + "agentConnectivityTemplates": { + "description": "List of AgentConnectivityTemplate resources.", + "items": { + "$ref": "AgentConnectivityTemplate" + }, + "type": "array" + }, + "nextPageToken": { + "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", + "type": "string" + }, + "unreachable": { + "description": "Unordered list. Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListAgentGatewaysResponse": { "description": "Response returned by the ListAgentGateways method.", "id": "ListAgentGatewaysResponse", diff --git a/discovery/networkservices-v1beta1.json b/discovery/networkservices-v1beta1.json index 62822a709d3..341daa3517a 100644 --- a/discovery/networkservices-v1beta1.json +++ b/discovery/networkservices-v1beta1.json @@ -183,6 +183,173 @@ } }, "resources": { + "agentConnectivityTemplates": { + "methods": { + "create": { + "description": "Creates a new AgentConnectivityTemplate in a given project and location.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates", + "httpMethod": "POST", + "id": "networkservices.projects.locations.agentConnectivityTemplates.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "agentConnectivityTemplateId": { + "description": "Required. Short name of the AgentConnectivityTemplate resource to be created.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The parent resource of the AgentConnectivityTemplate. Must be in the format `projects/*/locations/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}/agentConnectivityTemplates", + "request": { + "$ref": "AgentConnectivityTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a single AgentConnectivityTemplate.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates/{agentConnectivityTemplatesId}", + "httpMethod": "DELETE", + "id": "networkservices.projects.locations.agentConnectivityTemplates.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "Optional. The etag of the AgentConnectivityTemplate to delete.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. A name of the AgentConnectivityTemplate to delete. Must be in the format `projects/*/locations/*/agentConnectivityTemplates/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/agentConnectivityTemplates/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets details of a single AgentConnectivityTemplate.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates/{agentConnectivityTemplatesId}", + "httpMethod": "GET", + "id": "networkservices.projects.locations.agentConnectivityTemplates.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. A name of the AgentConnectivityTemplate to get. Must be in the format `projects/*/locations/*/agentConnectivityTemplates/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/agentConnectivityTemplates/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "response": { + "$ref": "AgentConnectivityTemplate" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists AgentConnectivityTemplates in a given project and location.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates", + "httpMethod": "GET", + "id": "networkservices.projects.locations.agentConnectivityTemplates.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. Maximum number of AgentConnectivityTemplates to return per call.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. The value returned by the last `ListAgentConnectivityTemplatesResponse` Indicates that this is a continuation of a prior `ListAgentConnectivityTemplates` call, and that the system should return the next page of data.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The project and location from which the AgentConnectivityTemplates should be listed, specified in the format `projects/*/locations/*`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Optional. If true, allow partial responses for multi-regional Aggregated List requests. Otherwise if one of the locations is down or unreachable, the Aggregated List request will fail.", + "location": "query", + "type": "boolean" + } + }, + "path": "v1beta1/{+parent}/agentConnectivityTemplates", + "response": { + "$ref": "ListAgentConnectivityTemplatesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Updates the parameters of a single AgentConnectivityTemplate.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentConnectivityTemplates/{agentConnectivityTemplatesId}", + "httpMethod": "PATCH", + "id": "networkservices.projects.locations.agentConnectivityTemplates.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/*/locations/*/agentConnectivityTemplates/`.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/agentConnectivityTemplates/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. Field mask is used to specify the fields to be overwritten in the AgentConnectivityTemplate resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}", + "request": { + "$ref": "AgentConnectivityTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "agentGateways": { "methods": { "create": { @@ -3277,9 +3444,82 @@ } } }, - "revision": "20260710", + "revision": "20260724", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { + "AgentConnectivityTemplate": { + "description": "AgentConnectivityTemplate represents a reusable network configuration.", + "id": "AgentConnectivityTemplate", + "properties": { + "accessPath": { + "description": "Required. Immutable. The path of the access. Maps roughly to ingress/egress, though we keep CLIENT_TO_AGENT and AGENT_TO_ANYWHERE as carryovers from Agent Gateway's original resource model. The path is immutable once set. Exactly one path can be set.", + "enum": [ + "ACCESS_PATH_UNSPECIFIED", + "CLIENT_TO_AGENT", + "AGENT_TO_ANYWHERE" + ], + "enumDescriptions": [ + "Unspecified access path.", + "Protect connection to Agent or Tool.", + "Govern agent connections to destinations." + ], + "type": "string" + }, + "accessTypes": { + "description": "Optional. The types of network access provided to the gateway. Both PUBLIC and PRIVATE can be configured.", + "items": { + "enum": [ + "ACCESS_TYPE_UNSPECIFIED", + "PUBLIC", + "PRIVATE" + ], + "enumDescriptions": [ + "Unspecified access type.", + "Public network access.", + "Private network access." + ], + "type": "string" + }, + "type": "array" + }, + "createTime": { + "description": "Output only. The timestamp when the resource was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "Optional. A free-text description of the resource. Max length 1024 characters.", + "type": "string" + }, + "egressNetworkConfig": { + "$ref": "EgressNetworkConfig", + "description": "Optional. Configuration for egress network traffic." + }, + "etag": { + "description": "Optional. Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error.", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Set of label tags associated with the AgentConnectivityTemplate resource.", + "type": "object" + }, + "name": { + "description": "Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/*/locations/*/agentConnectivityTemplates/`.", + "type": "string" + }, + "updateTime": { + "description": "Output only. The timestamp when the resource was updated.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "AgentGateway": { "description": "AgentGateway represents the agent gateway resource.", "id": "AgentGateway", @@ -3577,6 +3817,82 @@ "properties": {}, "type": "object" }, + "DnsPeeringConfig": { + "description": "DNS Peering configuration.", + "id": "DnsPeeringConfig", + "properties": { + "domain": { + "description": "Optional. The domain to peer.", + "type": "string" + }, + "targetNetwork": { + "description": "Optional. The target network resource name for DNS peering. Format: projects/{project}/global/networks/{network_id}", + "type": "string" + } + }, + "type": "object" + }, + "EgressNetworkConfig": { + "id": "EgressNetworkConfig", + "properties": { + "dnsPeeringConfig": { + "$ref": "DnsPeeringConfig", + "description": "Optional. DNS Peering configuration." + }, + "networkAttachment": { + "description": "Optional. The network attachment resource name. Format: projects/{project}/regions/{region}/networkAttachments/{network_attachment_id}", + "type": "string" + }, + "tlsConfig": { + "$ref": "EgressNetworkConfigTlsConfig", + "description": "Optional. The TLS configuration for the egress traffic." + }, + "trustConfig": { + "description": "Optional. The trust config resource name. Format: projects/{project}/locations/{location}/trustConfigs/{trust_config}", + "type": "string" + }, + "vpcEgress": { + "description": "Optional. The VPC egress setting.", + "enum": [ + "VPC_EGRESS_UNSPECIFIED", + "ALL_TRAFFIC", + "PRIVATE_RANGES_ONLY" + ], + "enumDescriptions": [ + "Unspecified", + "All outbound traffic is routed through the VPC connector.", + "Only private IP ranges are routed through the VPC connector." + ], + "type": "string" + } + }, + "type": "object" + }, + "EgressNetworkConfigTlsConfig": { + "description": "Configuration for TLS connections.", + "id": "EgressNetworkConfigTlsConfig", + "properties": { + "additionalRoots": { + "description": "Optional. The additional roots to trust.", + "enum": [ + "ADDITIONAL_ROOTS_UNSPECIFIED", + "NO_ADDITIONAL_ROOTS", + "PUBLICLY_TRUSTED_ROOTS" + ], + "enumDescriptions": [ + "Unspecified additional roots.", + "Trust only the certificates provided in `trust_config`.", + "Trust certificates provided in `trust_config` and publicly trusted roots." + ], + "type": "string" + }, + "trustConfig": { + "description": "Optional. The trust config resource name. Format: projects/{project}/locations/{location}/trustConfigs/{trust_config}", + "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", @@ -5108,6 +5424,31 @@ }, "type": "object" }, + "ListAgentConnectivityTemplatesResponse": { + "description": "Response returned by the ListAgentConnectivityTemplates method.", + "id": "ListAgentConnectivityTemplatesResponse", + "properties": { + "agentConnectivityTemplates": { + "description": "List of AgentConnectivityTemplate resources.", + "items": { + "$ref": "AgentConnectivityTemplate" + }, + "type": "array" + }, + "nextPageToken": { + "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", + "type": "string" + }, + "unreachable": { + "description": "Unordered list. Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "ListAgentGatewaysResponse": { "description": "Response returned by the ListAgentGateways method.", "id": "ListAgentGatewaysResponse", diff --git a/discovery/ondemandscanning-v1.json b/discovery/ondemandscanning-v1.json index 3fa5ffbef93..413cda5552a 100644 --- a/discovery/ondemandscanning-v1.json +++ b/discovery/ondemandscanning-v1.json @@ -344,7 +344,7 @@ } } }, - "revision": "20260706", + "revision": "20260803", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AISkillAnalysisOccurrence": { @@ -359,7 +359,7 @@ "type": "array" }, "maxSeverity": { - "description": "Maximum severity found among findings.", + "description": "Maximum severity found among findings. Per scanner verdict details.", "enum": [ "SEVERITY_UNSPECIFIED", "CRITICAL", @@ -372,6 +372,10 @@ ], "type": "string" }, + "perScannerVerdict": { + "$ref": "PerScannerVerdict", + "description": "Per scanner verdict." + }, "skillName": { "description": "Name of the skill that produced this analysis.", "type": "string" @@ -2133,6 +2137,111 @@ }, "type": "object" }, + "MaliciousContentLLMResult": { + "description": "Result of Malicious Content LLM scan.", + "id": "MaliciousContentLLMResult", + "properties": { + "maxSeverity": { + "description": "Tracks max severity found.", + "enum": [ + "SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH" + ], + "enumDescriptions": [ + "Unspecified severity.", + "Critical severity.", + "High severity." + ], + "type": "string" + }, + "scanStatus": { + "description": "Status of the scan.", + "enum": [ + "SCAN_STATUS_UNSPECIFIED", + "PERFORMED", + "NOT_PERFORMED" + ], + "enumDescriptions": [ + "Unspecified scan status.", + "Scan was performed.", + "Scan was not performed." + ], + "type": "string" + } + }, + "type": "object" + }, + "MaliciousContentStaticResult": { + "description": "Result of Malicious Content Static scan.", + "id": "MaliciousContentStaticResult", + "properties": { + "maxSeverity": { + "description": "Tracks max severity found.", + "enum": [ + "SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH" + ], + "enumDescriptions": [ + "Unspecified severity.", + "Critical severity.", + "High severity." + ], + "type": "string" + }, + "scanStatus": { + "description": "Status of the scan.", + "enum": [ + "SCAN_STATUS_UNSPECIFIED", + "PERFORMED", + "NOT_PERFORMED" + ], + "enumDescriptions": [ + "Unspecified scan status.", + "Scan was performed.", + "Scan was not performed." + ], + "type": "string" + } + }, + "type": "object" + }, + "MalwareScanResult": { + "description": "Result of Malware scan.", + "id": "MalwareScanResult", + "properties": { + "scanStatus": { + "description": "Status of the scan.", + "enum": [ + "SCAN_STATUS_UNSPECIFIED", + "PERFORMED", + "NOT_PERFORMED" + ], + "enumDescriptions": [ + "Unspecified scan status.", + "Scan was performed.", + "Scan was not performed." + ], + "type": "string" + }, + "verdict": { + "description": "Verdict of the scan.", + "enum": [ + "VERDICT_UNSPECIFIED", + "PASSED", + "FAILED" + ], + "enumDescriptions": [ + "Unspecified verdict.", + "Scanner passed.", + "Scanner failed." + ], + "type": "string" + } + }, + "type": "object" + }, "Material": { "id": "Material", "properties": { @@ -2628,6 +2737,28 @@ }, "type": "object" }, + "PerScannerVerdict": { + "id": "PerScannerVerdict", + "properties": { + "maliciousContentLlmResult": { + "$ref": "MaliciousContentLLMResult", + "description": "Malicious Content LLM scan result." + }, + "maliciousContentStaticResult": { + "$ref": "MaliciousContentStaticResult", + "description": "Malicious Content Static scan result." + }, + "malwareScan": { + "$ref": "MalwareScanResult", + "description": "Malware scan result." + }, + "workspacePolicy": { + "$ref": "WorkspacePolicyResult", + "description": "Workspace Policy scan result." + } + }, + "type": "object" + }, "ProjectRepoId": { "description": "Selects a repo using a Google Cloud Platform project ID (e.g., winged-cargo-31) and a repo name within that project.", "id": "ProjectRepoId", @@ -3648,6 +3779,41 @@ } }, "type": "object" + }, + "WorkspacePolicyResult": { + "description": "Result of Workspace Policy scan.", + "id": "WorkspacePolicyResult", + "properties": { + "scanStatus": { + "description": "Status of the scan.", + "enum": [ + "SCAN_STATUS_UNSPECIFIED", + "PERFORMED", + "NOT_PERFORMED" + ], + "enumDescriptions": [ + "Unspecified scan status.", + "Scan was performed.", + "Scan was not performed." + ], + "type": "string" + }, + "verdict": { + "description": "Verdict of the scan.", + "enum": [ + "VERDICT_UNSPECIFIED", + "PASSED", + "FAILED" + ], + "enumDescriptions": [ + "Unspecified verdict.", + "Scanner passed.", + "Scanner failed." + ], + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/discovery/ondemandscanning-v1beta1.json b/discovery/ondemandscanning-v1beta1.json index 53e5f0721ce..1a7240b1ba9 100644 --- a/discovery/ondemandscanning-v1beta1.json +++ b/discovery/ondemandscanning-v1beta1.json @@ -344,7 +344,7 @@ } } }, - "revision": "20260706", + "revision": "20260803", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AISkillAnalysisOccurrence": { @@ -359,7 +359,7 @@ "type": "array" }, "maxSeverity": { - "description": "Maximum severity found among findings.", + "description": "Maximum severity found among findings. Per scanner verdict details.", "enum": [ "SEVERITY_UNSPECIFIED", "CRITICAL", @@ -372,6 +372,10 @@ ], "type": "string" }, + "perScannerVerdict": { + "$ref": "PerScannerVerdict", + "description": "Per scanner verdict." + }, "skillName": { "description": "Name of the skill that produced this analysis.", "type": "string" @@ -2128,6 +2132,111 @@ }, "type": "object" }, + "MaliciousContentLLMResult": { + "description": "Result of Malicious Content LLM scan.", + "id": "MaliciousContentLLMResult", + "properties": { + "maxSeverity": { + "description": "Tracks max severity found.", + "enum": [ + "SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH" + ], + "enumDescriptions": [ + "Unspecified severity.", + "Critical severity.", + "High severity." + ], + "type": "string" + }, + "scanStatus": { + "description": "Status of the scan.", + "enum": [ + "SCAN_STATUS_UNSPECIFIED", + "PERFORMED", + "NOT_PERFORMED" + ], + "enumDescriptions": [ + "Unspecified scan status.", + "Scan was performed.", + "Scan was not performed." + ], + "type": "string" + } + }, + "type": "object" + }, + "MaliciousContentStaticResult": { + "description": "Result of Malicious Content Static scan.", + "id": "MaliciousContentStaticResult", + "properties": { + "maxSeverity": { + "description": "Tracks max severity found.", + "enum": [ + "SEVERITY_UNSPECIFIED", + "CRITICAL", + "HIGH" + ], + "enumDescriptions": [ + "Unspecified severity.", + "Critical severity.", + "High severity." + ], + "type": "string" + }, + "scanStatus": { + "description": "Status of the scan.", + "enum": [ + "SCAN_STATUS_UNSPECIFIED", + "PERFORMED", + "NOT_PERFORMED" + ], + "enumDescriptions": [ + "Unspecified scan status.", + "Scan was performed.", + "Scan was not performed." + ], + "type": "string" + } + }, + "type": "object" + }, + "MalwareScanResult": { + "description": "Result of Malware scan.", + "id": "MalwareScanResult", + "properties": { + "scanStatus": { + "description": "Status of the scan.", + "enum": [ + "SCAN_STATUS_UNSPECIFIED", + "PERFORMED", + "NOT_PERFORMED" + ], + "enumDescriptions": [ + "Unspecified scan status.", + "Scan was performed.", + "Scan was not performed." + ], + "type": "string" + }, + "verdict": { + "description": "Verdict of the scan.", + "enum": [ + "VERDICT_UNSPECIFIED", + "PASSED", + "FAILED" + ], + "enumDescriptions": [ + "Unspecified verdict.", + "Scanner passed.", + "Scanner failed." + ], + "type": "string" + } + }, + "type": "object" + }, "Material": { "id": "Material", "properties": { @@ -2623,6 +2732,28 @@ }, "type": "object" }, + "PerScannerVerdict": { + "id": "PerScannerVerdict", + "properties": { + "maliciousContentLlmResult": { + "$ref": "MaliciousContentLLMResult", + "description": "Malicious Content LLM scan result." + }, + "maliciousContentStaticResult": { + "$ref": "MaliciousContentStaticResult", + "description": "Malicious Content Static scan result." + }, + "malwareScan": { + "$ref": "MalwareScanResult", + "description": "Malware scan result." + }, + "workspacePolicy": { + "$ref": "WorkspacePolicyResult", + "description": "Workspace Policy scan result." + } + }, + "type": "object" + }, "ProjectRepoId": { "description": "Selects a repo using a Google Cloud Platform project ID (e.g., winged-cargo-31) and a repo name within that project.", "id": "ProjectRepoId", @@ -3643,6 +3774,41 @@ } }, "type": "object" + }, + "WorkspacePolicyResult": { + "description": "Result of Workspace Policy scan.", + "id": "WorkspacePolicyResult", + "properties": { + "scanStatus": { + "description": "Status of the scan.", + "enum": [ + "SCAN_STATUS_UNSPECIFIED", + "PERFORMED", + "NOT_PERFORMED" + ], + "enumDescriptions": [ + "Unspecified scan status.", + "Scan was performed.", + "Scan was not performed." + ], + "type": "string" + }, + "verdict": { + "description": "Verdict of the scan.", + "enum": [ + "VERDICT_UNSPECIFIED", + "PASSED", + "FAILED" + ], + "enumDescriptions": [ + "Unspecified verdict.", + "Scanner passed.", + "Scanner failed." + ], + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/discovery/retail-v2alpha.json b/discovery/retail-v2alpha.json index e20f27f32d9..c415f280316 100644 --- a/discovery/retail-v2alpha.json +++ b/discovery/retail-v2alpha.json @@ -2874,7 +2874,7 @@ } } }, - "revision": "20260723", + "revision": "20260803", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -4377,6 +4377,13 @@ "description": "Resource that represents completion results.", "id": "GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResult", "properties": { + "agentPrompts": { + "description": "Conversational prompts to trigger agents like Shopping Agent. There may be multiple prompts for a single suggestion. This is an experimental feature for select customers. If you want to receive this prompt information, reach out to the Retail support team.", + "items": { + "$ref": "GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResultAgentPrompt" + }, + "type": "array" + }, "attributes": { "additionalProperties": { "$ref": "GoogleCloudRetailV2alphaCustomAttribute" @@ -4403,6 +4410,17 @@ }, "type": "object" }, + "GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResultAgentPrompt": { + "description": "A conversational prompt to trigger agents like Shopping Agent.", + "id": "GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResultAgentPrompt", + "properties": { + "prompt": { + "description": "The conversational prompt string.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudRetailV2alphaCompleteQueryResponseRecentSearchResult": { "deprecated": true, "description": "Deprecated: Recent search of this user.", @@ -7634,6 +7652,13 @@ "$ref": "GoogleCloudRetailV2alphaSearchRequestConversationalSearchSpec", "description": "Optional. This field specifies all conversational related parameters addition to traditional retail search." }, + "dynamicControls": { + "description": "Optional. A set of controls that are applied dynamically to the search request. These controls are applied in addition to the controls specified in the serving config. These controls are expected to not yet be persisted in storage. A control could be applied twice if it is in both the serving config and specified here. A maximum of 5 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.", + "items": { + "$ref": "GoogleCloudRetailV2alphaControl" + }, + "type": "array" + }, "dynamicFacetSpec": { "$ref": "GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec", "deprecated": true, @@ -7658,6 +7683,13 @@ "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the products being filtered. Filter expression is case-sensitive. For more information, see [Filter](https://cloud.google.com/retail/docs/filter-and-order#filter). If this field is unrecognizable, an INVALID_ARGUMENT is returned.", "type": "string" }, + "ignoredControlIds": { + "description": "Optional. A list of control IDs to ignore. These controls will not be applied to the search request, even if they are specified in the serving config.", + "items": { + "type": "string" + }, + "type": "array" + }, "labels": { "additionalProperties": { "type": "string" diff --git a/discovery/searchconsole-v1.json b/discovery/searchconsole-v1.json index 4beae6a36c9..91ba02456bb 100644 --- a/discovery/searchconsole-v1.json +++ b/discovery/searchconsole-v1.json @@ -400,7 +400,7 @@ } } }, - "revision": "20250714", + "revision": "20260805", "rootUrl": "https://searchconsole.googleapis.com/", "schemas": { "AmpInspectionResult": { @@ -624,16 +624,18 @@ "type": "object" }, "ApiDimensionFilterGroup": { - "description": "A set of dimension value filters to test against each row. Only rows that pass all filter groups will be returned. All results within a filter group are either AND'ed or OR'ed together, depending on the group type selected. All filter groups are AND'ed together.", + "description": "A set of `dimension` value filters to test against each row. Only rows that pass all filter groups will be returned. All results within a filter group are either AND'ed or OR'ed together, depending on the group type selected. All filter groups are AND'ed together.", "id": "ApiDimensionFilterGroup", "properties": { "filters": { + "description": "Optional. A list of single-value filters in this group.", "items": { "$ref": "ApiDimensionFilter" }, "type": "array" }, "groupType": { + "description": "Optional. The logic operator between filters of the same group.", "enum": [ "AND" ], diff --git a/discovery/serviceconsumermanagement-v1beta1.json b/discovery/serviceconsumermanagement-v1beta1.json index 51c6aac11f9..d07e752b0d8 100644 --- a/discovery/serviceconsumermanagement-v1beta1.json +++ b/discovery/serviceconsumermanagement-v1beta1.json @@ -724,7 +724,7 @@ } } }, - "revision": "20260423", + "revision": "20260721", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { @@ -2257,6 +2257,14 @@ "description": "Bind API methods to metrics. Binding a method to a metric causes that metric's configured quota behaviors to apply to the method call.", "id": "MetricRule", "properties": { + "agenticMetricCosts": { + "additionalProperties": { + "format": "int64", + "type": "string" + }, + "description": "Optional. Metrics to update when the selected methods are called, and the associated cost applied to each metric, iff the source of the call is an agent. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative.", + "type": "object" + }, "metricCosts": { "additionalProperties": { "format": "int64", @@ -2265,6 +2273,14 @@ "description": "Metrics to update when the selected methods are called, and the associated cost applied to each metric. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative.", "type": "object" }, + "nonagenticMetricCosts": { + "additionalProperties": { + "format": "int64", + "type": "string" + }, + "description": "Optional. Metrics to update when the selected methods are called, and the associated cost applied to each metric, iff the source of the call is not an agent. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative.", + "type": "object" + }, "selector": { "description": "Selects the methods to which this rule applies. Refer to selector for syntax details.", "type": "string" @@ -2650,6 +2666,20 @@ "description": "Name of the quota limit. The name must be provided, and it must be unique within the service. The name can only include alphanumeric characters as well as '-'. The maximum length of the limit name is 64 characters.", "type": "string" }, + "trafficSource": { + "description": "Optional. This is only informational, the logic to allocate the quota to the correct metric (such as in `metric_rules`) should identify which quota metrics to allocate to.", + "enum": [ + "TRAFFIC_SOURCE_UNSPECIFIED", + "TRAFFIC_SOURCE_NONAGENTIC", + "TRAFFIC_SOURCE_AGENTIC" + ], + "enumDescriptions": [ + "This quota limit applies to all traffic. This is the default value.", + "This quota limit applies to traffic not recognized as agentic.", + "This quota limit applies to only agentic traffic." + ], + "type": "string" + }, "unit": { "description": "Specify the unit of the quota limit. It uses the same syntax as MetricDescriptor.unit. The supported unit kinds are determined by the quota backend system. Here are some examples: * \"1/min/{project}\" for quota per minute per project. Note: the order of unit components is insignificant. The \"1\" at the beginning is required to follow the metric unit syntax.", "type": "string" diff --git a/discovery/serviceusage-v1beta1.json b/discovery/serviceusage-v1beta1.json index 97a83e221d4..2e093f8ae7e 100644 --- a/discovery/serviceusage-v1beta1.json +++ b/discovery/serviceusage-v1beta1.json @@ -969,7 +969,7 @@ } } }, - "revision": "20260721", + "revision": "20260731", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1752,6 +1752,20 @@ }, "type": "array" }, + "trafficSource": { + "description": "Indicates the traffic type attribution for this quota limit (e.g. agentic). This is an informational field used to categorize and filter the quota limits.", + "enum": [ + "TRAFFIC_SOURCE_UNSPECIFIED", + "TRAFFIC_SOURCE_NONAGENTIC", + "TRAFFIC_SOURCE_AGENTIC" + ], + "enumDescriptions": [ + "This quota limit applies to all traffic. This is the default value.", + "This quota limit applies to traffic not recognized as agentic.", + "This quota limit applies to only agentic traffic." + ], + "type": "string" + }, "unit": { "description": "The limit unit. An example unit would be `1/{project}/{region}` Note that `{project}` and `{region}` are not placeholders in this example; the literal characters `{` and `}` occur in the string.", "type": "string" diff --git a/discovery/threatintelligence-v1beta.json b/discovery/threatintelligence-v1beta.json index de3bbe7014a..216ecae7777 100644 --- a/discovery/threatintelligence-v1beta.json +++ b/discovery/threatintelligence-v1beta.json @@ -842,7 +842,7 @@ } } }, - "revision": "20260726", + "revision": "20260803", "rootUrl": "https://threatintelligence.googleapis.com/", "schemas": { "Alert": { @@ -1210,6 +1210,10 @@ "description": "Wrapper class that contains the union struct for all the various configuration detail specific classes.", "id": "ConfigurationDetail", "properties": { + "customThreatScenario": { + "$ref": "CustomThreatScenarioConfig", + "description": "Custom Threat Scenario detail config." + }, "customerProfile": { "$ref": "CustomerProfileConfig", "description": "Customer Profile detail config." @@ -1247,6 +1251,17 @@ }, "type": "object" }, + "CustomThreatScenarioConfig": { + "description": "CustomThreatScenarioConfig represents a user-defined threat scenario configuration.", + "id": "CustomThreatScenarioConfig", + "properties": { + "documentCondition": { + "description": "Required. The condition driving the scenario, stored as a stringified JSON. This is used to query/filter documents.", + "type": "string" + } + }, + "type": "object" + }, "CustomerProfileCitation": { "description": "Citation information for the customer profile.", "id": "CustomerProfileCitation", diff --git a/discovery/toolresults-v1beta3.json b/discovery/toolresults-v1beta3.json index 063cee2f55a..65effa342fc 100644 --- a/discovery/toolresults-v1beta3.json +++ b/discovery/toolresults-v1beta3.json @@ -1464,7 +1464,7 @@ } } }, - "revision": "20260528", + "revision": "20260803", "rootUrl": "https://toolresults.googleapis.com/", "schemas": { "ANR": { @@ -1589,6 +1589,12 @@ "properties": {}, "type": "object" }, + "AntiTamperingTermination": { + "description": "Anti-tampering termination was detected.", + "id": "AntiTamperingTermination", + "properties": {}, + "type": "object" + }, "Any": { "description": " `Any` contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides support to pack/unpack Any values in the form of utility functions or additional generated methods of the Any type. Example 1: Pack and unpack a message in C++. Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... } Example 2: Pack and unpack a message in Java. Foo foo = ...; Any any = Any.pack(foo); ... if (any.is(Foo.class)) { foo = any.unpack(Foo.class); } Example 3: Pack and unpack a message in Python. foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DESCRIPTOR): any.Unpack(foo) ... Example 4: Pack and unpack a message in Go foo := &pb.Foo{...} any, err := ptypes.MarshalAny(foo) ... foo := &pb.Foo{} if err := ptypes.UnmarshalAny(any, foo); err != nil { ... } The pack methods provided by protobuf library will by default use 'type.googleapis.com/full.type.name' as the type URL and the unpack methods only use the fully qualified type name after the last '/' in the type URL, for example \"foo.bar.com/x/y.z\" will yield type name \"y.z\". # JSON The JSON representation of an `Any` value uses the regular representation of the deserialized, embedded message, with an additional field `@type` which contains the type URL. Example: package google.profile; message Person { string first_name = 1; string last_name = 2; } { \"@type\": \"type.googleapis.com/google.profile.Person\", \"firstName\": , \"lastName\": } If the embedded message type is well-known and has a custom JSON representation, that representation will be embedded adding a field `value` which holds the custom JSON in addition to the `@type` field. Example (for message google.protobuf.Duration): { \"@type\": \"type.googleapis.com/google.protobuf.Duration\", \"value\": \"1.212s\" }", "id": "Any", @@ -3647,7 +3653,8 @@ "logcatCollectionError", "detectedAppSplashScreen", "assetIssue", - "licensingProtectionTermination" + "licensingProtectionTermination", + "antiTamperingTermination" ], "enumDescriptions": [ "Default unspecified type. Do not use. For versioning only.", @@ -3683,7 +3690,8 @@ "Problems detected while collecting logcat", "Robo detected a splash screen provided by app (vs. Android OS splash screen).", "There was an issue with the assets in this test.", - "Licensing protection termination (Pairip) was detected." + "Licensing protection termination (Pairip) was detected.", + "Anti-tampering termination was detected." ], "type": "string" }, diff --git a/discovery/walletobjects-v1.json b/discovery/walletobjects-v1.json index c9b89304ad0..7ca473a0fb2 100644 --- a/discovery/walletobjects-v1.json +++ b/discovery/walletobjects-v1.json @@ -1546,6 +1546,24 @@ "scopes": [ "https://www.googleapis.com/auth/wallet_object.issuer" ] + }, + "validate": { + "description": "Checks that the JWT or JSON string in the request represents a valid pass to be saved.", + "flatPath": "walletobjects/v1/jwt/validate", + "httpMethod": "POST", + "id": "walletobjects.jwt.validate", + "parameterOrder": [], + "parameters": {}, + "path": "walletobjects/v1/jwt/validate", + "request": { + "$ref": "JwtValidateRequest" + }, + "response": { + "$ref": "JwtValidateResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/wallet_object.issuer" + ] } } }, @@ -2713,7 +2731,7 @@ } } }, - "revision": "20260511", + "revision": "20260806", "rootUrl": "https://walletobjects.googleapis.com/", "schemas": { "ActivationOptions": { @@ -6411,6 +6429,17 @@ }, "type": "object" }, + "JsonResource": { + "description": "A JSON representation of a pass.", + "id": "JsonResource", + "properties": { + "json": { + "description": "Required. A JSON string representing the unencoded JWT payload for a pass of the format described at https://developers.google.com/wallet/reference/rest/v1/Jwt. This can be set to either the entire JSON representation described at this link or just the contents of the payload field holding the relevant classes and objects.", + "type": "string" + } + }, + "type": "object" + }, "JwtInsertResponse": { "id": "JwtInsertResponse", "properties": { @@ -6436,6 +6465,27 @@ }, "type": "object" }, + "JwtValidateRequest": { + "description": "Request to validate the JWT or JSON representation of a pass.", + "id": "JwtValidateRequest", + "properties": { + "jsonResource": { + "$ref": "JsonResource", + "description": "Optional. A JSON representation of a pass to be validated. Either this or jwt_resource should be set. Requests setting both or neither will be rejected." + }, + "jwtResource": { + "$ref": "JwtResource", + "description": "Optional. A JWT representation of a pass to be validated. Either this or json_resource should be set. Requests setting both or neither will be rejected." + } + }, + "type": "object" + }, + "JwtValidateResponse": { + "description": "Empty if the resource in the request is valid. Returns exception if invalid.", + "id": "JwtValidateResponse", + "properties": {}, + "type": "object" + }, "LabelValue": { "description": "A pair of text strings to be displayed in the details view. Note we no longer display LabelValue/LabelValueRow as a table, instead a list of items.", "id": "LabelValue", diff --git a/discovery/webcontentpublisher-v1.json b/discovery/webcontentpublisher-v1.json index 4a49beb6b4e..2420cd5d259 100644 --- a/discovery/webcontentpublisher-v1.json +++ b/discovery/webcontentpublisher-v1.json @@ -346,6 +346,37 @@ "https://www.googleapis.com/auth/subscribewithgoogle.publications.entitlements.manage", "https://www.googleapis.com/auth/subscribewithgoogle.publications.entitlements.readonly" ] + }, + "patch": { + "description": "Updates a CTA.", + "flatPath": "v1/organizations/{organizationsId}/publications/{publicationsId}/ctas/{ctasId}", + "httpMethod": "PATCH", + "id": "webcontentpublisher.organizations.publications.ctas.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Identifier. The resource name of the Cta. Format: organizations/{organization}/publications/{publication}/ctas/{cta}", + "location": "path", + "pattern": "^organizations/[^/]+/publications/[^/]+/ctas/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Optional. The list of fields to update.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Cta" + }, + "response": { + "$ref": "Cta" + } } } } @@ -394,7 +425,7 @@ } } }, - "revision": "20260724", + "revision": "20260804", "rootUrl": "https://webcontentpublisher.googleapis.com/", "schemas": { "CheckFreeAccessResponse": { @@ -561,6 +592,10 @@ "description": "Optional. Whether the user is required to provide their name to sign up.", "type": "boolean" }, + "optInRequired": { + "description": "Optional. Whether checking the opt-in checkbox is required.", + "type": "boolean" + }, "title": { "description": "Required. The title of the newsletter signup prompt.", "type": "string" diff --git a/discovery/youtube-v3.json b/discovery/youtube-v3.json index 99e99f4733c..738c3eb9054 100644 --- a/discovery/youtube-v3.json +++ b/discovery/youtube-v3.json @@ -4192,7 +4192,7 @@ } } }, - "revision": "20260709", + "revision": "20260805", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { @@ -4667,6 +4667,68 @@ }, "type": "object" }, + "AvailabilityConfig": { + "description": "Common proto for Live and VOD geo-restrictions", + "id": "AvailabilityConfig", + "properties": { + "globalConfig": { + "$ref": "AvailabilityConfigGlobalConfig", + "description": "Video is available in all regions except the ones specified in the config." + }, + "regionsConfig": { + "$ref": "AvailabilityConfigRegionsConfig", + "description": "Video is available in the specified regions only." + } + }, + "type": "object" + }, + "AvailabilityConfigGlobalConfig": { + "description": "Video is available in all regions except the ones specified in the excluded_region_codes list.", + "id": "AvailabilityConfigGlobalConfig", + "properties": { + "excludedRegionCodes": { + "description": "Optional. Regions where video is blocked", + "items": { + "type": "string" + }, + "type": "array" + }, + "interval": { + "$ref": "Interval", + "description": "Default time window where video is available for all non-blocked regions Not supported for upcoming / active live broadcasts. If start time is unspecified, video is already available If end time is unspecified, video is available forever Specified start and end times cannot be more than five years in the future." + } + }, + "type": "object" + }, + "AvailabilityConfigRegionsConfig": { + "description": "Video is available in the specified regions only.", + "id": "AvailabilityConfigRegionsConfig", + "properties": { + "regionIntervals": { + "description": "Required. List of regions and time windows where video is available. If a region is specified multiple times, the union of all intervals is used.", + "items": { + "$ref": "AvailabilityConfigRegionsConfigRegionInterval" + }, + "type": "array" + } + }, + "type": "object" + }, + "AvailabilityConfigRegionsConfigRegionInterval": { + "description": "Region and time window where video is available for the region.", + "id": "AvailabilityConfigRegionsConfigRegionInterval", + "properties": { + "interval": { + "$ref": "Interval", + "description": "Time window where video is available for the region. Not supported for upcoming / active live broadcasts. If start time is unspecified, video is already available If end time is unspecified, video is available forever Specified start and end times cannot be more than five years in the future." + }, + "regionCode": { + "description": "Required. Region where video is available", + "type": "string" + } + }, + "type": "object" + }, "BatchGetStatsResponse": { "description": "Response for the Videos.stats API. Returns VideoStat information about a batch of videos. VideoStat contains a subset of the information in Video that is relevant to statistics and content details. BatchGetStats is intentionally not atomic to provide a better user experience. BatchGetStatsResponse returns a summary to help users understand the outcome of the operation.", "id": "BatchGetStatsResponse", @@ -8297,6 +8359,23 @@ }, "type": "object" }, + "Interval": { + "description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.", + "id": "Interval", + "properties": { + "endTime": { + "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.", + "format": "google-datetime", + "type": "string" + }, + "startTime": { + "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "InvideoBranding": { "description": "Describes an invideo branding.", "id": "InvideoBranding", @@ -8462,6 +8541,10 @@ "description": "Detailed settings of a broadcast.", "id": "LiveBroadcastContentDetails", "properties": { + "availabilityConfig": { + "$ref": "AvailabilityConfig", + "description": "Optional. The broadcast's availability config. Used to set specific region availability or block specific regions It is optional - if not set, it is not enforced." + }, "boundStreamId": { "description": "This value uniquely identifies the live stream bound to the broadcast.", "type": "string" diff --git a/release-please-config.json b/release-please-config.json index 271d136ea71..2c4c6b0ab4d 100644 --- a/release-please-config.json +++ b/release-please-config.json @@ -332,6 +332,8 @@ "src/apis/firebasecrashlytics": {}, "src/apis/databasecenter": {}, "src/apis/cloudproductregistry": {}, - "src/apis/agentidentity": {} + "src/apis/agentidentity": {}, + "src/apis/androiddeveloperidstatus": {}, + "src/apis/ftp": {} } } \ No newline at end of file diff --git a/src/apis/aiplatform/index.ts b/src/apis/aiplatform/index.ts index fb2e0512a75..112d16fe81a 100644 --- a/src/apis/aiplatform/index.ts +++ b/src/apis/aiplatform/index.ts @@ -35,10 +35,7 @@ export function aiplatform< >( this: GoogleConfigurable, versionOrOptions: - | 'v1' - | aiplatform_v1.Options - | 'v1beta1' - | aiplatform_v1beta1.Options + 'v1' | aiplatform_v1.Options | 'v1beta1' | aiplatform_v1beta1.Options ) { return getAPI('aiplatform', versionOrOptions, VERSIONS, this); } diff --git a/src/apis/alloydb/v1.ts b/src/apis/alloydb/v1.ts index ebd4d001634..0d7299c5d43 100644 --- a/src/apis/alloydb/v1.ts +++ b/src/apis/alloydb/v1.ts @@ -124,6 +124,12 @@ export namespace alloydb_v1 { } } + /** + * AlloyDbInternalDebugInfo contains internal debugging information for AlloyDB errors. It is explicitly kept out of the allowlist (errors.yaml) to ensure it is sanitized (stripped) by OnePlatform for all external requests. Used only to carry internal error details to across UPC/FlowLib boundary for ObservabilityInfo. + */ + export interface Schema$AlloydbClhErrorsAlloyDbInternalDebugInfo { + originalError?: string | null; + } /** * AuthorizedNetwork contains metadata for an authorized network. */ diff --git a/src/apis/alloydb/v1alpha.ts b/src/apis/alloydb/v1alpha.ts index 408d9e1a66f..52e6ccbd03b 100644 --- a/src/apis/alloydb/v1alpha.ts +++ b/src/apis/alloydb/v1alpha.ts @@ -124,6 +124,12 @@ export namespace alloydb_v1alpha { } } + /** + * AlloyDbInternalDebugInfo contains internal debugging information for AlloyDB errors. It is explicitly kept out of the allowlist (errors.yaml) to ensure it is sanitized (stripped) by OnePlatform for all external requests. Used only to carry internal error details to across UPC/FlowLib boundary for ObservabilityInfo. + */ + export interface Schema$AlloydbClhErrorsAlloyDbInternalDebugInfo { + originalError?: string | null; + } /** * AuthorizedNetwork contains metadata for an authorized network. */ diff --git a/src/apis/alloydb/v1beta.ts b/src/apis/alloydb/v1beta.ts index afd9b83f32a..94b2b721355 100644 --- a/src/apis/alloydb/v1beta.ts +++ b/src/apis/alloydb/v1beta.ts @@ -124,6 +124,12 @@ export namespace alloydb_v1beta { } } + /** + * AlloyDbInternalDebugInfo contains internal debugging information for AlloyDB errors. It is explicitly kept out of the allowlist (errors.yaml) to ensure it is sanitized (stripped) by OnePlatform for all external requests. Used only to carry internal error details to across UPC/FlowLib boundary for ObservabilityInfo. + */ + export interface Schema$AlloydbClhErrorsAlloyDbInternalDebugInfo { + originalError?: string | null; + } /** * AuthorizedNetwork contains metadata for an authorized network. */ diff --git a/src/apis/analytics/README.md b/src/apis/analytics/README.md index 59a78d582d2..dc267db247a 100644 --- a/src/apis/analytics/README.md +++ b/src/apis/analytics/README.md @@ -2,7 +2,7 @@ # analytics -> The Analytics API provides access to Analytics configuration and report data. +> ## Installation diff --git a/src/apis/analyticsadmin/v1alpha.ts b/src/apis/analyticsadmin/v1alpha.ts index 8377c19bce7..cb45dfcc3f0 100644 --- a/src/apis/analyticsadmin/v1alpha.ts +++ b/src/apis/analyticsadmin/v1alpha.ts @@ -15767,7 +15767,7 @@ export namespace analyticsadmin_v1alpha { } /** - * Creates a CustomDimension. + * Creates a CustomDimension. Warning: It's not permissible to use this method to collect data on individual users. In particular, sending user IDs in custom dimensions violates the [Google Analytics Terms of Service](https://www.google.com/analytics/terms/). * @example * ```js * // Before running the sample: diff --git a/src/apis/analyticsadmin/v1beta.ts b/src/apis/analyticsadmin/v1beta.ts index f0196a30da0..dc2e587f129 100644 --- a/src/apis/analyticsadmin/v1beta.ts +++ b/src/apis/analyticsadmin/v1beta.ts @@ -5374,7 +5374,7 @@ export namespace analyticsadmin_v1beta { } /** - * Creates a CustomDimension. + * Creates a CustomDimension. Warning: It's not permissible to use this method to collect data on individual users. In particular, sending user IDs in custom dimensions violates the [Google Analytics Terms of Service](https://www.google.com/analytics/terms/). * @example * ```js * // Before running the sample: diff --git a/src/apis/androiddeveloperidstatus/README.md b/src/apis/androiddeveloperidstatus/README.md new file mode 100644 index 00000000000..3f5f2f2e3ec --- /dev/null +++ b/src/apis/androiddeveloperidstatus/README.md @@ -0,0 +1,28 @@ +Google Inc. logo + +# androiddeveloperidstatus + +> Android Developer ID Status API. + +## Installation + +```sh +$ npm install @googleapis/androiddeveloperidstatus +``` + +## Usage +All documentation and usage information can be found on [GitHub](https://github.com/googleapis/google-api-nodejs-client). +Information on classes can be found in [Googleapis Documentation](https://googleapis.dev/nodejs/googleapis/latest/androiddeveloperidstatus/classes/Androiddeveloperidstatus.html). + +## License +This library is licensed under Apache 2.0. Full license text is available in [LICENSE](https://github.com/googleapis/google-api-nodejs-client/blob/main/LICENSE). + +## Contributing +We love contributions! Before submitting a Pull Request, it's always good to start with a new issue first. To learn more, see [CONTRIBUTING](https://github.com/google/google-api-nodejs-client/blob/main/.github/CONTRIBUTING.md). + +## Questions/problems? +* Ask your development related questions on [StackOverflow](http://stackoverflow.com/questions/tagged/google-api-nodejs-client). +* If you've found an bug/issue, please [file it on GitHub](https://github.com/googleapis/google-api-nodejs-client/issues). + + +*Crafted with ❤️ by the Google Node.js team* diff --git a/src/apis/androiddeveloperidstatus/index.ts b/src/apis/androiddeveloperidstatus/index.ts new file mode 100644 index 00000000000..648c919c285 --- /dev/null +++ b/src/apis/androiddeveloperidstatus/index.ts @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +/*! THIS FILE IS AUTO-GENERATED */ + +import {AuthPlus, getAPI, GoogleConfigurable} from 'googleapis-common'; +import {androiddeveloperidstatus_v1} from './v1'; + +export const VERSIONS = { + v1: androiddeveloperidstatus_v1.Androiddeveloperidstatus, +}; + +export function androiddeveloperidstatus( + version: 'v1' +): androiddeveloperidstatus_v1.Androiddeveloperidstatus; +export function androiddeveloperidstatus( + options: androiddeveloperidstatus_v1.Options +): androiddeveloperidstatus_v1.Androiddeveloperidstatus; +export function androiddeveloperidstatus< + T = androiddeveloperidstatus_v1.Androiddeveloperidstatus, +>( + this: GoogleConfigurable, + versionOrOptions: 'v1' | androiddeveloperidstatus_v1.Options +) { + return getAPI( + 'androiddeveloperidstatus', + versionOrOptions, + VERSIONS, + this + ); +} + +const auth = new AuthPlus(); +export {auth}; +export {androiddeveloperidstatus_v1}; +export { + AuthPlus, + GlobalOptions, + APIRequestContext, + GoogleConfigurable, + StreamMethodOptions, + MethodOptions, + BodyResponseCallback, +} from 'googleapis-common'; diff --git a/src/apis/androiddeveloperidstatus/package.json b/src/apis/androiddeveloperidstatus/package.json new file mode 100644 index 00000000000..0f28af4dc4e --- /dev/null +++ b/src/apis/androiddeveloperidstatus/package.json @@ -0,0 +1,43 @@ +{ + "name": "@googleapis/androiddeveloperidstatus", + "version": "0.1.0", + "description": "androiddeveloperidstatus", + "main": "build/index.js", + "types": "build/index.d.ts", + "keywords": [ + "google" + ], + "author": "Google LLC", + "license": "Apache-2.0", + "homepage": "https://github.com/googleapis/google-api-nodejs-client", + "bugs": { + "url": "https://github.com/googleapis/google-api-nodejs-client/issues" + }, + "repository": { + "type": "git", + "url": "https://github.com/googleapis/google-api-nodejs-client.git" + }, + "engines": { + "node": ">=12.0.0" + }, + "scripts": { + "fix": "gts fix", + "lint": "gts check", + "compile": "tsc -p .", + "prepare": "npm run compile", + "webpack": "webpack" + }, + "dependencies": { + "googleapis-common": "^8.0.0" + }, + "devDependencies": { + "@microsoft/api-documenter": "^7.8.10", + "@microsoft/api-extractor": "^7.8.10", + "gts": "^6.0.0", + "null-loader": "^4.0.0", + "ts-loader": "^9.0.0", + "typescript": "5.7.3", + "webpack": "^5.0.0", + "webpack-cli": "^5.0.0" + } +} diff --git a/src/apis/androiddeveloperidstatus/tsconfig.json b/src/apis/androiddeveloperidstatus/tsconfig.json new file mode 100644 index 00000000000..e0810904968 --- /dev/null +++ b/src/apis/androiddeveloperidstatus/tsconfig.json @@ -0,0 +1,10 @@ +{ + "extends": "./node_modules/gts/tsconfig-google.json", + "compilerOptions": { + "rootDir": ".", + "outDir": "build" + }, + "include": [ + "*.ts", + ] +} diff --git a/src/apis/androiddeveloperidstatus/v1.ts b/src/apis/androiddeveloperidstatus/v1.ts new file mode 100644 index 00000000000..fc6d1c79b8a --- /dev/null +++ b/src/apis/androiddeveloperidstatus/v1.ts @@ -0,0 +1,315 @@ +// Copyright 2020 Google LLC +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +/* eslint-disable @typescript-eslint/no-explicit-any */ +/* eslint-disable @typescript-eslint/no-unused-vars */ +/* eslint-disable @typescript-eslint/no-empty-interface */ +/* eslint-disable @typescript-eslint/no-namespace */ +/* eslint-disable no-irregular-whitespace */ + +import { + OAuth2Client, + JWT, + Compute, + UserRefreshClient, + BaseExternalAccountClient, + GaxiosResponseWithHTTP2, + GoogleConfigurable, + createAPIRequest, + MethodOptions, + StreamMethodOptions, + GlobalOptions, + GoogleAuth, + BodyResponseCallback, + APIRequestContext, +} from 'googleapis-common'; +import {Readable} from 'stream'; + +export namespace androiddeveloperidstatus_v1 { + export interface Options extends GlobalOptions { + version: 'v1'; + } + + interface StandardParameters { + /** + * Auth client or API Key for the request + */ + auth?: + | string + | OAuth2Client + | JWT + | Compute + | UserRefreshClient + | BaseExternalAccountClient + | GoogleAuth; + + /** + * V1 error format. + */ + '$.xgafv'?: string; + /** + * OAuth access token. + */ + access_token?: string; + /** + * Data format for response. + */ + alt?: string; + /** + * JSONP + */ + callback?: string; + /** + * Selector specifying which fields to include in a partial response. + */ + fields?: string; + /** + * API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. + */ + key?: string; + /** + * OAuth 2.0 token for the current user. + */ + oauth_token?: string; + /** + * Returns response with indentations and line breaks. + */ + prettyPrint?: boolean; + /** + * Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. + */ + quotaUser?: string; + /** + * Legacy upload protocol for media (e.g. "media", "multipart"). + */ + uploadType?: string; + /** + * Upload protocol for media (e.g. "raw", "multipart"). + */ + upload_protocol?: string; + } + + /** + * Android Developer ID Status API + * + * Android Developer ID Status API. + * + * @example + * ```js + * const {google} = require('googleapis'); + * const androiddeveloperidstatus = google.androiddeveloperidstatus('v1'); + * ``` + */ + export class Androiddeveloperidstatus { + context: APIRequestContext; + packages: Resource$Packages; + + constructor(options: GlobalOptions, google?: GoogleConfigurable) { + this.context = { + _options: options || {}, + google, + }; + + this.packages = new Resource$Packages(this.context); + } + } + + /** + * Resource message PackageRegistrationStatus. + */ + export interface Schema$PackageRegistrationStatus { + /** + * Output only. The SHA-256 fingerprint of the public certificate represented as a 64-character lowercase hexadecimal string without any colons or separators (e.g., `d6ac89ed1d0a805aad4b087d06d5f41645b814480b133fbc867ef7498d069e06`). + */ + certificateFingerprint?: string | null; + /** + * Identifier. The name of the package registration status resource. Format: packages/{package\}/packageRegistrationStatus `{package\}` must follow the specific format: The fully-qualified Android package name with dots ('.') replaced by hyphens ('-') (e.g., `com-example-app` instead of `com.example.app`). + */ + name?: string | null; + /** + * Output only. Registration state of the package, or pair. + */ + state?: string | null; + } + + export class Resource$Packages { + context: APIRequestContext; + packageRegistrationStatus: Resource$Packages$Packageregistrationstatus; + constructor(context: APIRequestContext) { + this.context = context; + this.packageRegistrationStatus = + new Resource$Packages$Packageregistrationstatus(this.context); + } + } + + export class Resource$Packages$Packageregistrationstatus { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Retrieves the Android Developer ID registration status for a given package. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/androiddeveloperidstatus.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 androiddeveloperidstatus = google.androiddeveloperidstatus('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 androiddeveloperidstatus.packages.packageRegistrationStatus.check({ + * // Optional. The SHA-256 fingerprint of the public certificate represented as a 64-character lowercase hexadecimal string without any colons or separators (e.g., `d6ac89ed1d0a805aad4b087d06d5f41645b814480b133fbc867ef7498d069e06`). + * certificateFingerprint: 'placeholder-value', + * // Required. The name of the package registration status resource. Format: packages/{package\}/packageRegistrationStatus `{package\}` must follow the specific format: The fully-qualified Android package name with dots ('.') replaced by hyphens ('-') (e.g., `com-example-app` instead of `com.example.app`). + * name: 'packages/my-package/packageRegistrationStatus', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "certificateFingerprint": "my_certificateFingerprint", + * // "name": "my_name", + * // "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. + */ + check( + params: Params$Resource$Packages$Packageregistrationstatus$Check, + options: StreamMethodOptions + ): Promise>; + check( + params?: Params$Resource$Packages$Packageregistrationstatus$Check, + options?: MethodOptions + ): Promise>; + check( + params: Params$Resource$Packages$Packageregistrationstatus$Check, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + check( + params: Params$Resource$Packages$Packageregistrationstatus$Check, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + check( + params: Params$Resource$Packages$Packageregistrationstatus$Check, + callback: BodyResponseCallback + ): void; + check( + callback: BodyResponseCallback + ): void; + check( + paramsOrCallback?: + | Params$Resource$Packages$Packageregistrationstatus$Check + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Packages$Packageregistrationstatus$Check; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Packages$Packageregistrationstatus$Check; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://androiddeveloperidstatus.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}:check').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$Packages$Packageregistrationstatus$Check extends StandardParameters { + /** + * Optional. The SHA-256 fingerprint of the public certificate represented as a 64-character lowercase hexadecimal string without any colons or separators (e.g., `d6ac89ed1d0a805aad4b087d06d5f41645b814480b133fbc867ef7498d069e06`). + */ + certificateFingerprint?: string; + /** + * Required. The name of the package registration status resource. Format: packages/{package\}/packageRegistrationStatus `{package\}` must follow the specific format: The fully-qualified Android package name with dots ('.') replaced by hyphens ('-') (e.g., `com-example-app` instead of `com.example.app`). + */ + name?: string; + } +} diff --git a/src/apis/androiddeveloperidstatus/webpack.config.js b/src/apis/androiddeveloperidstatus/webpack.config.js new file mode 100644 index 00000000000..470ce07d0fe --- /dev/null +++ b/src/apis/androiddeveloperidstatus/webpack.config.js @@ -0,0 +1,79 @@ +// Copyright 2019 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Use `npm run webpack` to produce Webpack bundle for this library. + +const path = require('path'); + +module.exports = { + entry: './index.ts', + resolve: { + extensions: ['.ts', '.js', '.json'], + fallback: { + crypto: false, + child_process: false, + fs: false, + http2: false, + buffer: 'browserify', + process: false, + os: false, + querystring: false, + path: false, + stream: 'stream-browserify', + url: false, + util: false, + zlib: false, + }, + }, + output: { + library: 'Androiddeveloperidstatus', + filename: 'androiddeveloperidstatus.min.js', + path: path.resolve(__dirname, 'dist'), + }, + module: { + rules: [ + { + test: /node_modules[\\/]google-auth-library[\\/]src[\\/]crypto[\\/]node[\\/]crypto/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]https-proxy-agent[\\/]/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]gcp-metadata[\\/]/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]gtoken[\\/]/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]pkginfo[\\/]/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]semver[\\/]/, + use: 'null-loader', + }, + { + test: /\.ts$/, + use: 'ts-loader', + exclude: /node_modules/, + }, + ], + }, + mode: 'production', + plugins: [], +}; diff --git a/src/apis/androiddeviceprovisioning/v1.ts b/src/apis/androiddeviceprovisioning/v1.ts index 4afb36a7722..19d09e22284 100644 --- a/src/apis/androiddeviceprovisioning/v1.ts +++ b/src/apis/androiddeviceprovisioning/v1.ts @@ -2204,7 +2204,7 @@ export namespace androiddeviceprovisioning_v1 { * * // Do the magic * const res = await androiddeviceprovisioning.customers.devices.list({ - * // Optional. The maximum number of devices to show in a page of results. If unset or 0, defaults to 1000. If a value greater than 1000 is specified, it will be coerced to 1000. + * // Optional. The maximum number of devices to show in a page of results. If unset or `0`, defaults to `5000`. If a value greater than `10000` is specified, it will be coerced to `10000`. * pageSize: 'placeholder-value', * // A token specifying which result page to return. * pageToken: 'placeholder-value', @@ -2626,7 +2626,7 @@ export namespace androiddeviceprovisioning_v1 { } export interface Params$Resource$Customers$Devices$List extends StandardParameters { /** - * Optional. The maximum number of devices to show in a page of results. If unset or 0, defaults to 1000. If a value greater than 1000 is specified, it will be coerced to 1000. + * Optional. The maximum number of devices to show in a page of results. If unset or `0`, defaults to `5000`. If a value greater than `10000` is specified, it will be coerced to `10000`. */ pageSize?: string; /** diff --git a/src/apis/apihub/v1.ts b/src/apis/apihub/v1.ts index ccc7cd488b9..365cd7f0628 100644 --- a/src/apis/apihub/v1.ts +++ b/src/apis/apihub/v1.ts @@ -2800,7 +2800,7 @@ export namespace apihub_v1 { */ definitions?: string[] | null; /** - * Optional. The deployments linked to this API version. Note: A particular API version could be deployed to multiple deployments (for dev deployment, UAT deployment, etc) Format is `projects/{project\}/locations/{location\}/deployments/{deployment\}` + * Optional. The deployments linked directly to this API version. Only directly-linked deployments are returned; deployments linked to this version's specs or operations are not included. Note: A particular API version could be deployed to multiple deployments (for dev deployment, UAT deployment, etc) Format is `projects/{project\}/locations/{location\}/deployments/{deployment\}` */ deployments?: string[] | null; /** diff --git a/src/apis/apikeys/v2.ts b/src/apis/apikeys/v2.ts index 3ff469a53e4..bfe754e9509 100644 --- a/src/apis/apikeys/v2.ts +++ b/src/apis/apikeys/v2.ts @@ -1434,6 +1434,8 @@ export namespace apikeys_v2 { * * // Do the magic * const res = await apikeys.projects.locations.keys.patch({ + * // Optional. Defines the behavior for checking existing usage when updating a key. + * checkExistingUsage: 'placeholder-value', * // Identifier. The resource name of the key. The `name` has the form: `projects//locations/global/keys/`. For example: `projects/123456867718/locations/global/keys/b7ff1f9f-8275-410a-94dd-3855ee9b5dd2` NOTE: Key is a global resource; hence the only supported value for location is `global`. * name: 'projects/my-project/locations/my-location/keys/my-key', * // The field mask specifies which fields to be updated as part of this request. All other fields are ignored. Mutable fields are: `display_name`, `restrictions`, and `annotations`. If an update mask is not provided, the service treats it as an implied mask equivalent to all allowed fields that are set on the wire. If the field mask has a special value "*", the service treats it equivalent to replace all allowed mutable fields. @@ -1763,6 +1765,10 @@ export namespace apikeys_v2 { showDeleted?: boolean; } export interface Params$Resource$Projects$Locations$Keys$Patch extends StandardParameters { + /** + * Optional. Defines the behavior for checking existing usage when updating a key. + */ + checkExistingUsage?: string; /** * Identifier. The resource name of the key. The `name` has the form: `projects//locations/global/keys/`. For example: `projects/123456867718/locations/global/keys/b7ff1f9f-8275-410a-94dd-3855ee9b5dd2` NOTE: Key is a global resource; hence the only supported value for location is `global`. */ diff --git a/src/apis/cloudasset/v1.ts b/src/apis/cloudasset/v1.ts index 8b122d827bf..881dba85a48 100644 --- a/src/apis/cloudasset/v1.ts +++ b/src/apis/cloudasset/v1.ts @@ -1568,7 +1568,7 @@ export namespace cloudasset_v1 { */ export interface Schema$GoogleIdentityAccesscontextmanagerV1Modifier { /** - * Adds additional HTTP request headers. + * Adds an additional HTTP request header. */ addRequestHeader?: Schema$GoogleIdentityAccesscontextmanagerV1AddRequestHeader; } @@ -1607,7 +1607,7 @@ export namespace cloudasset_v1 { */ modifiers?: Schema$GoogleIdentityAccesscontextmanagerV1Modifier[]; /** - * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be alphanumerical name. + * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be an alphanumeric name. */ pattern?: string | null; /** diff --git a/src/apis/cloudasset/v1beta1.ts b/src/apis/cloudasset/v1beta1.ts index cf27f5d100f..36dfe694076 100644 --- a/src/apis/cloudasset/v1beta1.ts +++ b/src/apis/cloudasset/v1beta1.ts @@ -811,7 +811,7 @@ export namespace cloudasset_v1beta1 { */ export interface Schema$GoogleIdentityAccesscontextmanagerV1Modifier { /** - * Adds additional HTTP request headers. + * Adds an additional HTTP request header. */ addRequestHeader?: Schema$GoogleIdentityAccesscontextmanagerV1AddRequestHeader; } @@ -850,7 +850,7 @@ export namespace cloudasset_v1beta1 { */ modifiers?: Schema$GoogleIdentityAccesscontextmanagerV1Modifier[]; /** - * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be alphanumerical name. + * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be an alphanumeric name. */ pattern?: string | null; /** diff --git a/src/apis/cloudasset/v1p1beta1.ts b/src/apis/cloudasset/v1p1beta1.ts index 45ad0904077..eb395e745d3 100644 --- a/src/apis/cloudasset/v1p1beta1.ts +++ b/src/apis/cloudasset/v1p1beta1.ts @@ -738,7 +738,7 @@ export namespace cloudasset_v1p1beta1 { */ export interface Schema$GoogleIdentityAccesscontextmanagerV1Modifier { /** - * Adds additional HTTP request headers. + * Adds an additional HTTP request header. */ addRequestHeader?: Schema$GoogleIdentityAccesscontextmanagerV1AddRequestHeader; } @@ -777,7 +777,7 @@ export namespace cloudasset_v1p1beta1 { */ modifiers?: Schema$GoogleIdentityAccesscontextmanagerV1Modifier[]; /** - * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be alphanumerical name. + * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be an alphanumeric name. */ pattern?: string | null; /** diff --git a/src/apis/cloudasset/v1p5beta1.ts b/src/apis/cloudasset/v1p5beta1.ts index d0b1ee043cc..ff8ef97d75a 100644 --- a/src/apis/cloudasset/v1p5beta1.ts +++ b/src/apis/cloudasset/v1p5beta1.ts @@ -768,7 +768,7 @@ export namespace cloudasset_v1p5beta1 { */ export interface Schema$GoogleIdentityAccesscontextmanagerV1Modifier { /** - * Adds additional HTTP request headers. + * Adds an additional HTTP request header. */ addRequestHeader?: Schema$GoogleIdentityAccesscontextmanagerV1AddRequestHeader; } @@ -807,7 +807,7 @@ export namespace cloudasset_v1p5beta1 { */ modifiers?: Schema$GoogleIdentityAccesscontextmanagerV1Modifier[]; /** - * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be alphanumerical name. + * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be an alphanumeric name. */ pattern?: string | null; /** diff --git a/src/apis/cloudasset/v1p7beta1.ts b/src/apis/cloudasset/v1p7beta1.ts index 0d772cb9374..be847e26c65 100644 --- a/src/apis/cloudasset/v1p7beta1.ts +++ b/src/apis/cloudasset/v1p7beta1.ts @@ -814,7 +814,7 @@ export namespace cloudasset_v1p7beta1 { */ export interface Schema$GoogleIdentityAccesscontextmanagerV1Modifier { /** - * Adds additional HTTP request headers. + * Adds an additional HTTP request header. */ addRequestHeader?: Schema$GoogleIdentityAccesscontextmanagerV1AddRequestHeader; } @@ -853,7 +853,7 @@ export namespace cloudasset_v1p7beta1 { */ modifiers?: Schema$GoogleIdentityAccesscontextmanagerV1Modifier[]; /** - * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be alphanumerical name. + * URL pattern to allow. Only patterns of ".googleapis.com/x", "www.googleapis.com//x" and "*.appspot.com/x forms are supported, where should be an alphanumeric name. */ pattern?: string | null; /** diff --git a/src/apis/cloudidentity/v1.ts b/src/apis/cloudidentity/v1.ts index 55737feaa9d..f78b1c4b394 100644 --- a/src/apis/cloudidentity/v1.ts +++ b/src/apis/cloudidentity/v1.ts @@ -1712,7 +1712,7 @@ export namespace cloudidentity_v1 { */ export interface Schema$Setting { /** - * Required. Immutable. The type of the Setting. . + * Required. Immutable. The type of the Setting. */ type?: string | null; /** diff --git a/src/apis/cloudidentity/v1beta1.ts b/src/apis/cloudidentity/v1beta1.ts index 6b611aed3bd..a5413217ea2 100644 --- a/src/apis/cloudidentity/v1beta1.ts +++ b/src/apis/cloudidentity/v1beta1.ts @@ -2328,7 +2328,7 @@ export namespace cloudidentity_v1beta1 { */ export interface Schema$Setting { /** - * Required. Immutable. The type of the Setting. . + * Required. Immutable. The type of the Setting. */ type?: string | null; /** diff --git a/src/apis/cloudsearch/v1.ts b/src/apis/cloudsearch/v1.ts index 747106e9fed..9e57e3c2839 100644 --- a/src/apis/cloudsearch/v1.ts +++ b/src/apis/cloudsearch/v1.ts @@ -2986,6 +2986,10 @@ export namespace cloudsearch_v1 { * The BCP-47 language code, such as "pt" or "en". It represents the user's preferred Display Language. */ clientDisplayLanguageCode?: string | null; + /** + * Optional. Specifies the country/region where the query originated, as a lowercase ISO 3166-1 alpha-2 region code (using 'uk' instead of 'gb' for the United Kingdom). + */ + countryCode?: string | null; /** * Debug options of the request */ @@ -7756,6 +7760,8 @@ export namespace cloudsearch_v1 { * pageToken: 'placeholder-value', * // The BCP-47 language code, such as "pt" or "en". It represents the user's preferred Display Language. * 'requestOptions.clientDisplayLanguageCode': 'placeholder-value', + * // Optional. Specifies the country/region where the query originated, as a lowercase ISO 3166-1 alpha-2 region code (using 'uk' instead of 'gb' for the United Kingdom). + * 'requestOptions.countryCode': 'placeholder-value', * // If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field. * 'requestOptions.debugOptions.enableDebugging': 'placeholder-value', * // The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. For translations. Set this field using the language set in browser or for the page. In the event that the user's language preference is known, set this field to the known user language. When specified, the documents in search results are biased towards the specified language. The Suggest API uses this field as a hint to make better third-party autocomplete predictions. @@ -7877,6 +7883,10 @@ export namespace cloudsearch_v1 { * The BCP-47 language code, such as "pt" or "en". It represents the user's preferred Display Language. */ 'requestOptions.clientDisplayLanguageCode'?: string; + /** + * Optional. Specifies the country/region where the query originated, as a lowercase ISO 3166-1 alpha-2 region code (using 'uk' instead of 'gb' for the United Kingdom). + */ + 'requestOptions.countryCode'?: string; /** * If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field. */ diff --git a/src/apis/compute/v1.ts b/src/apis/compute/v1.ts index bfb9217e77d..0a7d7670211 100644 --- a/src/apis/compute/v1.ts +++ b/src/apis/compute/v1.ts @@ -535,6 +535,14 @@ export namespace compute_v1 { * [Output Only] Name of the resource. */ name?: string | null; + /** + * Output only. Contains standard resource metadata for an AcceleratorType + * resource. It is populated for each instance of the AcceleratorType + * resource, and includes the api_version the + * instance was retrieved through, and its canonical + * resource_type name. + */ + resourceMetadata?: Schema$ResourceMetadata; /** * Output only. [Output Only] Server-defined, fully qualified URL for this resource. */ @@ -8882,6 +8890,14 @@ export namespace compute_v1 { * reservation_name or a name_prefix. */ reservationName?: string | null; + /** + * Output only. Contains standard resource metadata for an FutureReservation + * resource. It is populated for each instance of the FutureReservation + * resource, and includes the api_version the + * instance was retrieved through, and its canonical + * resource_type name. + */ + resourceMetadata?: Schema$ResourceMetadata; /** * Maintenance information for this reservation */ @@ -24700,6 +24716,14 @@ export namespace compute_v1 { * will not be shared with Google Cloud managed services. */ reservationSharingPolicy?: Schema$AllocationReservationSharingPolicy; + /** + * Output only. [Output Only] Contains standard resource metadata for an Allocation + * resource. It is populated for each instance of the Allocation + * resource, and includes the api_version the + * instance was retrieved through, and its canonical + * resource_type name. + */ + resourceMetadata?: Schema$ResourceMetadata; /** * Resource policies to be added to this reservation. The key is defined by * user, and the value is resource policy url. This is to define placement @@ -25458,6 +25482,22 @@ export namespace compute_v1 { */ group?: string | null; } + /** + * Standardized resource metadata common to all compute resources. + */ + export interface Schema$ResourceMetadata { + /** + * The version of the API interface that this resource was retrieved through. + * For example, `"2025-01-01"` or `"2025-01-01-preview"`. + */ + apiVersion?: string | null; + /** + * The canonical resource type name in the format of a resource type + * as defined by [AIP-123](https://google.aip.dev/123). + * For example, `"compute.googleapis.com/Instance"`. + */ + resourceType?: string | null; + } export interface Schema$ResourcePoliciesScopedList { /** * A list of resourcePolicies contained in this scope. @@ -29228,10 +29268,13 @@ export namespace compute_v1 { * which is resolved based on "userIpRequestHeaders" configured with the * security policy. If there is no "userIpRequestHeaders" configuration or * an IP address cannot be resolved from it, the key type defaults toIP. + * - ASN: The autonomous system number of the originating + * client. If not available, the key type defaults toALL. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. + * * - * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the - * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the - * key type defaults to ALL. * For "fairshare" action, this value is limited to ALL i.e. a single rate * limit threshold is enforced for all the requests matching the rule. */ @@ -29321,10 +29364,11 @@ export namespace compute_v1 { * which is resolved based on "userIpRequestHeaders" configured with the * security policy. If there is no "userIpRequestHeaders" configuration * or an IP address cannot be resolved from it, the key type defaults toIP. - * - * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the - * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the - * key type defaults to ALL. + * - ASN: The autonomous system number of the originating + * client. If not available, the key type defaults toALL. + * - TLS_JA4_FINGERPRINT: JA4 TLS/SSL fingerprint if the + * client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the + * key type defaults to ALL. */ enforceOnKeyType?: string | null; } @@ -36362,6 +36406,7 @@ export namespace compute_v1 { * // "kind": "my_kind", * // "maximumCardsPerInstance": 0, * // "name": "my_name", + * // "resourceMetadata": {}, * // "selfLink": "my_selfLink", * // "zone": "my_zone" * // } @@ -64753,6 +64798,7 @@ export namespace compute_v1 { * // "planningStatus": "my_planningStatus", * // "reservationMode": "my_reservationMode", * // "reservationName": "my_reservationName", + * // "resourceMetadata": {}, * // "schedulingType": "my_schedulingType", * // "selfLink": "my_selfLink", * // "selfLinkWithId": "my_selfLinkWithId", @@ -64936,6 +64982,7 @@ export namespace compute_v1 { * // "planningStatus": "my_planningStatus", * // "reservationMode": "my_reservationMode", * // "reservationName": "my_reservationName", + * // "resourceMetadata": {}, * // "schedulingType": "my_schedulingType", * // "selfLink": "my_selfLink", * // "selfLinkWithId": "my_selfLinkWithId", @@ -65402,6 +65449,7 @@ export namespace compute_v1 { * // "planningStatus": "my_planningStatus", * // "reservationMode": "my_reservationMode", * // "reservationName": "my_reservationName", + * // "resourceMetadata": {}, * // "schedulingType": "my_schedulingType", * // "selfLink": "my_selfLink", * // "selfLinkWithId": "my_selfLinkWithId", @@ -217935,6 +217983,7 @@ export namespace compute_v1 { * // "params": {}, * // "protectionTier": "my_protectionTier", * // "reservationSharingPolicy": {}, + * // "resourceMetadata": {}, * // "resourcePolicies": {}, * // "resourceStatus": {}, * // "satisfiesPzs": false, @@ -218270,6 +218319,7 @@ export namespace compute_v1 { * // "params": {}, * // "protectionTier": "my_protectionTier", * // "reservationSharingPolicy": {}, + * // "resourceMetadata": {}, * // "resourcePolicies": {}, * // "resourceStatus": {}, * // "satisfiesPzs": false, @@ -219431,6 +219481,7 @@ export namespace compute_v1 { * // "params": {}, * // "protectionTier": "my_protectionTier", * // "reservationSharingPolicy": {}, + * // "resourceMetadata": {}, * // "resourcePolicies": {}, * // "resourceStatus": {}, * // "satisfiesPzs": false, diff --git a/src/apis/dataform/v1.ts b/src/apis/dataform/v1.ts index d9310ffb058..5ec1d12e729 100644 --- a/src/apis/dataform/v1.ts +++ b/src/apis/dataform/v1.ts @@ -291,6 +291,10 @@ export namespace dataform_v1 { * Optional. The default schema (BigQuery dataset ID). */ defaultSchema?: string | null; + /** + * Optional. The pipeline options which defines the pipeline type and path within the Git repository. + */ + pipelineConfig?: Schema$PipelineConfig; /** * Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names. */ @@ -460,6 +464,10 @@ export namespace dataform_v1 { * Output only. The version of `@dataform/core` that was used for compilation. */ dataformCoreVersion?: string | null; + /** + * Output only. Metadata about the repository snapshot used by scheduled notebooks. + */ + gcsRepositorySnapshotMetadata?: Schema$GcsRepositorySnapshotMetadata; /** * Immutable. Git commit/tag/branch name at which the repository should be compiled. Must exist in the remote repository. Examples: - a commit SHA: `12ade345` - a tag: `tag1` - a branch name: `branch1` */ @@ -848,6 +856,32 @@ export namespace dataform_v1 { */ repository?: Schema$Repository; } + /** + * Configures the destination for a repository snapshot. + */ + export interface Schema$GcsRepositorySnapshotDestination { + /** + * Optional. The Google Cloud Storage destination to upload the repository snapshot to. Format: `gs://bucket-name/path/`. + */ + repositorySnapshotUri?: string | null; + } + /** + * Metadata about a repository snapshot stored in Google Cloud Storage. + */ + export interface Schema$GcsRepositorySnapshotMetadata { + /** + * Output only. The crc32c checksum of the repository snapshot, big-endian base64 encoded. + */ + crc32cChecksum?: string | null; + /** + * Output only. The generation number of the Cloud Storage object. See https://cloud.google.com/storage/docs/metadata#generation-number. + */ + generation?: string | null; + /** + * Output only. The Google Cloud Storage URI of the repository snapshot. + */ + repositorySnapshotUri?: string | null; + } /** * Controls Git remote configuration for a repository. */ @@ -935,7 +969,12 @@ export namespace dataform_v1 { /** * `InstallNpmPackages` request message. */ - export interface Schema$InstallNpmPackagesRequest {} + export interface Schema$InstallNpmPackagesRequest { + /** + * Optional. The pipeline options which defines the pipeline type and path within the Git repository. + */ + pipelineConfig?: Schema$PipelineConfig; + } /** * `InstallNpmPackages` response message. */ @@ -1258,6 +1297,10 @@ export namespace dataform_v1 { * Output only. The code contents of a Notebook to be run. */ contents?: string | null; + /** + * Output only. The path to the notebook file in the repository. + */ + filePath?: string | null; /** * Output only. The ID of the Gemini Enterprise Agent Platform job that executed the notebook in contents and also the ID used for the outputs created in Google Cloud Storage buckets. Only set once the job has started to run. */ @@ -1275,6 +1318,10 @@ export namespace dataform_v1 { * Optional. The Google Cloud Storage location to upload the result to. Format: `gs://bucket-name`. */ gcsOutputBucket?: string | null; + /** + * Optional. The Google Cloud Storage destination to upload the snapshot to. For empty URI it defaults to the provided gcs_output_bucket. Format: `gs://bucket-name/path/`. + */ + gcsRepositorySnapshotDestination?: Schema$GcsRepositorySnapshotDestination; } /** * This resource represents a long-running operation that is the result of a network API call. @@ -1363,6 +1410,19 @@ export namespace dataform_v1 { */ tags?: string[] | null; } + /** + * Defines the pipeline type and path within the Git repository. + */ + export interface Schema$PipelineConfig { + /** + * Required. The relative path within the Git repository where the pipeline is defined. For example, for a Dataform pipeline, it is a path to the folder where `workflow_settings.yaml` or `dataform.json` is located. + */ + path?: string | null; + /** + * Required. The type of the pipeline. + */ + pipelineType?: string | null; + } /** * An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] \}, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", \} \} ], "etag": "BwWWja0YfJA=", "version": 3 \} ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/). */ @@ -1676,7 +1736,7 @@ export namespace dataform_v1 { */ releaseCompilationResult?: string | null; /** - * Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC. + * Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the [time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is `UTC`. */ timeZone?: string | null; } @@ -2066,7 +2126,7 @@ export namespace dataform_v1 { */ releaseConfig?: string | null; /** - * Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC. + * Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the [time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is `UTC`. */ timeZone?: string | null; /** @@ -2102,6 +2162,10 @@ export namespace dataform_v1 { * Output only. The workflow invocation's name. */ name?: string | null; + /** + * Output only. The pipeline options which defines the pipeline type and path within the Git repository. + */ + pipelineConfig?: Schema$PipelineConfig; /** * Output only. Metadata indicating whether this resource is user-scoped. `WorkflowInvocation` resource is `user_scoped` only if it is sourced from a compilation result and the compilation result is user-scoped. */ @@ -7866,6 +7930,7 @@ export namespace dataform_v1 { * // "createTime": "my_createTime", * // "dataEncryptionState": {}, * // "dataformCoreVersion": "my_dataformCoreVersion", + * // "gcsRepositorySnapshotMetadata": {}, * // "gitCommitish": "my_gitCommitish", * // "internalMetadata": "my_internalMetadata", * // "name": "my_name", @@ -7885,6 +7950,7 @@ export namespace dataform_v1 { * // "createTime": "my_createTime", * // "dataEncryptionState": {}, * // "dataformCoreVersion": "my_dataformCoreVersion", + * // "gcsRepositorySnapshotMetadata": {}, * // "gitCommitish": "my_gitCommitish", * // "internalMetadata": "my_internalMetadata", * // "name": "my_name", @@ -8038,6 +8104,7 @@ export namespace dataform_v1 { * // "createTime": "my_createTime", * // "dataEncryptionState": {}, * // "dataformCoreVersion": "my_dataformCoreVersion", + * // "gcsRepositorySnapshotMetadata": {}, * // "gitCommitish": "my_gitCommitish", * // "internalMetadata": "my_internalMetadata", * // "name": "my_name", @@ -10396,6 +10463,7 @@ export namespace dataform_v1 { * // "invocationConfig": {}, * // "invocationTiming": {}, * // "name": "my_name", + * // "pipelineConfig": {}, * // "privateResourceMetadata": {}, * // "resolvedCompilationResult": "my_resolvedCompilationResult", * // "state": "my_state", @@ -10413,6 +10481,7 @@ export namespace dataform_v1 { * // "invocationConfig": {}, * // "invocationTiming": {}, * // "name": "my_name", + * // "pipelineConfig": {}, * // "privateResourceMetadata": {}, * // "resolvedCompilationResult": "my_resolvedCompilationResult", * // "state": "my_state", @@ -10700,6 +10769,7 @@ export namespace dataform_v1 { * // "invocationConfig": {}, * // "invocationTiming": {}, * // "name": "my_name", + * // "pipelineConfig": {}, * // "privateResourceMetadata": {}, * // "resolvedCompilationResult": "my_resolvedCompilationResult", * // "state": "my_state", @@ -12419,7 +12489,9 @@ export namespace dataform_v1 { * // Request body metadata * requestBody: { * // request body parameters - * // {} + * // { + * // "pipelineConfig": {} + * // } * }, * }, * ); diff --git a/src/apis/dataform/v1beta1.ts b/src/apis/dataform/v1beta1.ts index d8c30d35677..b107688fcf3 100644 --- a/src/apis/dataform/v1beta1.ts +++ b/src/apis/dataform/v1beta1.ts @@ -291,6 +291,10 @@ export namespace dataform_v1beta1 { * Optional. The default schema (BigQuery dataset ID). */ defaultSchema?: string | null; + /** + * Optional. The pipeline options which defines the pipeline type and path within the Git repository. + */ + pipelineConfig?: Schema$PipelineConfig; /** * Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names. */ @@ -460,6 +464,10 @@ export namespace dataform_v1beta1 { * Output only. The version of `@dataform/core` that was used for compilation. */ dataformCoreVersion?: string | null; + /** + * Output only. Metadata about the repository snapshot used by scheduled notebooks. + */ + gcsRepositorySnapshotMetadata?: Schema$GcsRepositorySnapshotMetadata; /** * Immutable. Git commit/tag/branch name at which the repository should be compiled. Must exist in the remote repository. Examples: - a commit SHA: `12ade345` - a tag: `tag1` - a branch name: `branch1` */ @@ -857,6 +865,32 @@ export namespace dataform_v1beta1 { */ repository?: Schema$Repository; } + /** + * Configures the destination for a repository snapshot. + */ + export interface Schema$GcsRepositorySnapshotDestination { + /** + * Optional. The Google Cloud Storage destination to upload the repository snapshot to. Format: `gs://bucket-name/path/`. + */ + repositorySnapshotUri?: string | null; + } + /** + * Metadata about a repository snapshot stored in Google Cloud Storage. + */ + export interface Schema$GcsRepositorySnapshotMetadata { + /** + * Output only. The crc32c checksum of the repository snapshot, big-endian base64 encoded. + */ + crc32cChecksum?: string | null; + /** + * Output only. The generation number of the Cloud Storage object. See https://cloud.google.com/storage/docs/metadata#generation-number. + */ + generation?: string | null; + /** + * Output only. The Google Cloud Storage URI of the repository snapshot. + */ + repositorySnapshotUri?: string | null; + } /** * Controls Git remote configuration for a repository. */ @@ -944,7 +978,12 @@ export namespace dataform_v1beta1 { /** * `InstallNpmPackages` request message. */ - export interface Schema$InstallNpmPackagesRequest {} + export interface Schema$InstallNpmPackagesRequest { + /** + * Optional. The pipeline options which defines the pipeline type and path within the Git repository. + */ + pipelineConfig?: Schema$PipelineConfig; + } /** * `InstallNpmPackages` response message. */ @@ -1267,6 +1306,10 @@ export namespace dataform_v1beta1 { * Output only. The code contents of a Notebook to be run. */ contents?: string | null; + /** + * Output only. The path to the notebook file in the repository. + */ + filePath?: string | null; /** * Output only. The ID of the Gemini Enterprise Agent Platform job that executed the notebook in contents and also the ID used for the outputs created in Google Cloud Storage buckets. Only set once the job has started to run. */ @@ -1284,6 +1327,10 @@ export namespace dataform_v1beta1 { * Optional. The Google Cloud Storage location to upload the result to. Format: `gs://bucket-name`. */ gcsOutputBucket?: string | null; + /** + * Optional. The Google Cloud Storage destination to upload the snapshot to. For empty URI it defaults to the provided gcs_output_bucket. Format: `gs://bucket-name/path/`. + */ + gcsRepositorySnapshotDestination?: Schema$GcsRepositorySnapshotDestination; } /** * This resource represents a long-running operation that is the result of a network API call. @@ -1372,6 +1419,19 @@ export namespace dataform_v1beta1 { */ tags?: string[] | null; } + /** + * Defines the pipeline type and path within the Git repository. + */ + export interface Schema$PipelineConfig { + /** + * Required. The relative path within the Git repository where the pipeline is defined. For example, for a Dataform pipeline, it is a path to the folder where `workflow_settings.yaml` or `dataform.json` is located. + */ + path?: string | null; + /** + * Required. The type of the pipeline. + */ + pipelineType?: string | null; + } /** * An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] \}, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", \} \} ], "etag": "BwWWja0YfJA=", "version": 3 \} ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/). */ @@ -1685,7 +1745,7 @@ export namespace dataform_v1beta1 { */ releaseCompilationResult?: string | null; /** - * Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC. + * Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the [time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is `UTC`. */ timeZone?: string | null; } @@ -2101,7 +2161,7 @@ export namespace dataform_v1beta1 { */ releaseConfig?: string | null; /** - * Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC. + * Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the [time zone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is `UTC`. */ timeZone?: string | null; /** @@ -2109,7 +2169,7 @@ export namespace dataform_v1beta1 { */ updateTime?: string | null; /** - * Optional. Optional trigger configuration for this workflow. If present, the workflow will be triggered based on the specified triggers. + * Optional. Trigger configuration for this workflow. If present, the workflow will be triggered based on the specified triggers. */ workflowTriggerConfig?: Schema$WorkflowTriggerConfig; } @@ -2141,6 +2201,10 @@ export namespace dataform_v1beta1 { * Output only. The workflow invocation's name. */ name?: string | null; + /** + * Output only. The pipeline options which defines the pipeline type and path within the Git repository. + */ + pipelineConfig?: Schema$PipelineConfig; /** * Output only. Metadata indicating whether this resource is user-scoped. `WorkflowInvocation` resource is `user_scoped` only if it is sourced from a compilation result and the compilation result is user-scoped. */ @@ -2225,7 +2289,7 @@ export namespace dataform_v1beta1 { */ maxWaitDuration?: string | null; /** - * Optional. Minimum duration between two consecutive executions. If not specified, the workflow will be executed every time trigger conditions are met and no ongoing workflow execution. + * Optional. Minimum duration between two consecutive executions. If not specified, the workflow will be executed every time trigger conditions are met and there is no ongoing workflow execution. */ minExecutionDuration?: string | null; /** @@ -8122,6 +8186,7 @@ export namespace dataform_v1beta1 { * // "createTime": "my_createTime", * // "dataEncryptionState": {}, * // "dataformCoreVersion": "my_dataformCoreVersion", + * // "gcsRepositorySnapshotMetadata": {}, * // "gitCommitish": "my_gitCommitish", * // "internalMetadata": "my_internalMetadata", * // "name": "my_name", @@ -8141,6 +8206,7 @@ export namespace dataform_v1beta1 { * // "createTime": "my_createTime", * // "dataEncryptionState": {}, * // "dataformCoreVersion": "my_dataformCoreVersion", + * // "gcsRepositorySnapshotMetadata": {}, * // "gitCommitish": "my_gitCommitish", * // "internalMetadata": "my_internalMetadata", * // "name": "my_name", @@ -8294,6 +8360,7 @@ export namespace dataform_v1beta1 { * // "createTime": "my_createTime", * // "dataEncryptionState": {}, * // "dataformCoreVersion": "my_dataformCoreVersion", + * // "gcsRepositorySnapshotMetadata": {}, * // "gitCommitish": "my_gitCommitish", * // "internalMetadata": "my_internalMetadata", * // "name": "my_name", @@ -10663,6 +10730,7 @@ export namespace dataform_v1beta1 { * // "invocationConfig": {}, * // "invocationTiming": {}, * // "name": "my_name", + * // "pipelineConfig": {}, * // "privateResourceMetadata": {}, * // "resolvedCompilationResult": "my_resolvedCompilationResult", * // "state": "my_state", @@ -10680,6 +10748,7 @@ export namespace dataform_v1beta1 { * // "invocationConfig": {}, * // "invocationTiming": {}, * // "name": "my_name", + * // "pipelineConfig": {}, * // "privateResourceMetadata": {}, * // "resolvedCompilationResult": "my_resolvedCompilationResult", * // "state": "my_state", @@ -10967,6 +11036,7 @@ export namespace dataform_v1beta1 { * // "invocationConfig": {}, * // "invocationTiming": {}, * // "name": "my_name", + * // "pipelineConfig": {}, * // "privateResourceMetadata": {}, * // "resolvedCompilationResult": "my_resolvedCompilationResult", * // "state": "my_state", @@ -12692,7 +12762,9 @@ export namespace dataform_v1beta1 { * // Request body metadata * requestBody: { * // request body parameters - * // {} + * // { + * // "pipelineConfig": {} + * // } * }, * }, * ); diff --git a/src/apis/developerknowledge/v1.ts b/src/apis/developerknowledge/v1.ts index 860aaea4705..c5844fab9dd 100644 --- a/src/apis/developerknowledge/v1.ts +++ b/src/apis/developerknowledge/v1.ts @@ -206,7 +206,7 @@ export namespace developerknowledge_v1 { referenceIndex?: number | null; } /** - * A Document represents a piece of content from the Developer Knowledge corpus. + * A Document represents a page of documentation in the Developer Knowledge corpus, like the page at https://docs.cloud.google.com/storage/docs/creating-buckets. */ export interface Schema$Document { /** @@ -281,7 +281,7 @@ export namespace developerknowledge_v1 { */ export interface Schema$SearchDocumentChunksResponse { /** - * Optional. Provides a token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. + * Provides a token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. */ nextPageToken?: string | null; /** @@ -327,7 +327,7 @@ export namespace developerknowledge_v1 { * * // Do the magic * const res = await developerknowledge.documents.batchGet({ - * // Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` + * // Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` Each name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. * names: 'placeholder-value', * // Optional. Specifies the DocumentView of the document. If unspecified, DeveloperKnowledge.BatchGetDocuments defaults to `DOCUMENT_VIEW_CONTENT`. * view: 'placeholder-value', @@ -470,7 +470,7 @@ export namespace developerknowledge_v1 { * * // Do the magic * const res = await developerknowledge.documents.get({ - * // Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` + * // Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` The name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. * name: 'documents/.*', * // Optional. Specifies the DocumentView of the document. If unspecified, DeveloperKnowledge.GetDocument defaults to `DOCUMENT_VIEW_CONTENT`. * view: 'placeholder-value', @@ -619,7 +619,7 @@ export namespace developerknowledge_v1 { * pageSize: 'placeholder-value', * // Optional. Contains a page token, received from a previous `SearchDocumentChunks` call. Provide this to retrieve the subsequent page. * pageToken: 'placeholder-value', - * // Required. Provides the raw query string provided by the user, such as "How to create a Cloud Storage bucket?". + * // Required. Provides the raw query string provided by the user, such as "How to create a Cloud Storage bucket?". The query must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. * query: 'placeholder-value', * }); * console.log(res.data); @@ -736,7 +736,7 @@ export namespace developerknowledge_v1 { export interface Params$Resource$Documents$Batchget extends StandardParameters { /** - * Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` + * Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` Each name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. */ names?: string[]; /** @@ -746,7 +746,7 @@ export namespace developerknowledge_v1 { } export interface Params$Resource$Documents$Get extends StandardParameters { /** - * Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` + * Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` The name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. */ name?: string; /** @@ -768,7 +768,7 @@ export namespace developerknowledge_v1 { */ pageToken?: string; /** - * Required. Provides the raw query string provided by the user, such as "How to create a Cloud Storage bucket?". + * Required. Provides the raw query string provided by the user, such as "How to create a Cloud Storage bucket?". The query must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. */ query?: string; } diff --git a/src/apis/developerknowledge/v1alpha.ts b/src/apis/developerknowledge/v1alpha.ts index c55907967a3..7768b479c6a 100644 --- a/src/apis/developerknowledge/v1alpha.ts +++ b/src/apis/developerknowledge/v1alpha.ts @@ -164,6 +164,10 @@ export namespace developerknowledge_v1alpha { * Request message for DeveloperKnowledge.AnswerQuery. */ export interface Schema$AnswerQueryRequest { + /** + * Optional. Applies a strict filter to the search results used to ground the answer. The expression supports a subset of the syntax described at https://google.aip.dev/160. Supported fields for filtering: * `content_length_bytes` (INTEGER): The length of the `Document.content` field in bytes. * `data_source` (STRING): The source of the document, e.g. `docs.cloud.google.com`. See https://developers.google.com/knowledge/reference/corpus-reference for the complete list of data sources in the corpus. * `update_time` (TIMESTAMP): The timestamp of when the document was last meaningfully updated. A meaningful update is one that changes document's markdown content or metadata. * `uri` (STRING): The document URI, e.g. `https://docs.cloud.google.com/bigquery/docs/tables`. INTEGER fields support `=`, `<`, `<=`, `\>`, and `\>=` operators. STRING fields support `=` (equals) and `!=` (not equals) operators for **exact match** on the whole string. Partial match, prefix match, and regexp match are not supported. TIMESTAMP fields support `=`, `<`, `<=`, `\>`, and `\>=` operators. Timestamps must be in RFC-3339 format, e.g., `"2025-01-01T00:00:00Z"`. You can combine expressions using `AND`, `OR`, and `NOT` (or `-`) logical operators. `OR` has higher precedence than `AND`. Use parentheses for explicit precedence grouping. Examples: * Filter by `Document.content_length_bytes`: `content_length_bytes < 50000` * `data_source = "docs.cloud.google.com" OR data_source = "firebase.google.com"` * `data_source != "firebase.google.com"` * `update_time < "2024-01-01T00:00:00Z"` * `update_time \>= "2025-01-22T00:00:00Z" AND (data_source = "developer.chrome.com" OR data_source = "web.dev")` * `uri = "https://docs.cloud.google.com/release-notes"` The `filter` string must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. + */ + filter?: string | null; /** * Required. The query to answer. */ @@ -206,7 +210,7 @@ export namespace developerknowledge_v1alpha { referenceIndex?: number | null; } /** - * A Document represents a piece of content from the Developer Knowledge corpus. + * A Document represents a page of documentation in the Developer Knowledge corpus, like the page at https://docs.cloud.google.com/storage/docs/creating-buckets. */ export interface Schema$Document { /** @@ -266,6 +270,10 @@ export namespace developerknowledge_v1alpha { * Output only. Contains the resource name of the document this chunk is from. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` */ parent?: string | null; + /** + * Output only. Represents the relevance score of the chunk to the search query. Higher score indicates higher chunk relevance. The score is in range [0.0, 1.0]. + */ + relevanceScore?: number | null; } /** * Represents a reference to a document. @@ -281,7 +289,7 @@ export namespace developerknowledge_v1alpha { */ export interface Schema$SearchDocumentChunksResponse { /** - * Optional. Provides a token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. + * Provides a token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. */ nextPageToken?: string | null; /** @@ -327,7 +335,7 @@ export namespace developerknowledge_v1alpha { * * // Do the magic * const res = await developerknowledge.documents.batchGet({ - * // Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` + * // Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` Each name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. * names: 'placeholder-value', * // Optional. Specifies the DocumentView of the document. If unspecified, DeveloperKnowledge.BatchGetDocuments defaults to `DOCUMENT_VIEW_CONTENT`. * view: 'placeholder-value', @@ -470,7 +478,7 @@ export namespace developerknowledge_v1alpha { * * // Do the magic * const res = await developerknowledge.documents.get({ - * // Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` + * // Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` The name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. * name: 'documents/.*', * // Optional. Specifies the DocumentView of the document. If unspecified, DeveloperKnowledge.GetDocument defaults to `DOCUMENT_VIEW_CONTENT`. * view: 'placeholder-value', @@ -619,7 +627,7 @@ export namespace developerknowledge_v1alpha { * pageSize: 'placeholder-value', * // Optional. Contains a page token, received from a previous `SearchDocumentChunks` call. Provide this to retrieve the subsequent page. * pageToken: 'placeholder-value', - * // Required. Provides the raw query string provided by the user, such as "How to create a Cloud Storage bucket?". + * // Required. Provides the raw query string provided by the user, such as "How to create a Cloud Storage bucket?". The query must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. * query: 'placeholder-value', * }); * console.log(res.data); @@ -736,7 +744,7 @@ export namespace developerknowledge_v1alpha { export interface Params$Resource$Documents$Batchget extends StandardParameters { /** - * Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` + * Required. Specifies the names of the documents to retrieve. A maximum of 20 documents can be retrieved in a batch. The documents are returned in the same order as the `names` in the request. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` Each name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. */ names?: string[]; /** @@ -746,7 +754,7 @@ export namespace developerknowledge_v1alpha { } export interface Params$Resource$Documents$Get extends StandardParameters { /** - * Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` + * Required. Specifies the name of the document to retrieve. Format: `documents/{uri_without_scheme\}` Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` The name must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. */ name?: string; /** @@ -768,7 +776,7 @@ export namespace developerknowledge_v1alpha { */ pageToken?: string; /** - * Required. Provides the raw query string provided by the user, such as "How to create a Cloud Storage bucket?". + * Required. Provides the raw query string provided by the user, such as "How to create a Cloud Storage bucket?". The query must not exceed 500 characters; values longer than 500 characters will result in an `INVALID_ARGUMENT` error. */ query?: string; } @@ -814,6 +822,7 @@ export namespace developerknowledge_v1alpha { * requestBody: { * // request body parameters * // { + * // "filter": "my_filter", * // "query": "my_query" * // } * }, diff --git a/src/apis/discoveryengine/v1.ts b/src/apis/discoveryengine/v1.ts index da61f9b628e..2f1b2e44f05 100644 --- a/src/apis/discoveryengine/v1.ts +++ b/src/apis/discoveryengine/v1.ts @@ -3364,13 +3364,9 @@ export namespace discoveryengine_v1 { vpcscEnabled?: boolean | null; } /** - * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note). + * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note). */ export interface Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata { - /** - * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides. - */ - authenticatedAccount?: string | null; /** * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors). */ @@ -4193,7 +4189,7 @@ export namespace discoveryengine_v1 { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -8416,7 +8412,7 @@ export namespace discoveryengine_v1 { */ deleteUnassignedUserLicenses?: boolean | null; /** - * The inline source for the input content for document embeddings. + * The inline source for the input content for license assignment. */ inlineSource?: Schema$GoogleCloudDiscoveryengineV1BatchUpdateUserLicensesRequestInlineSource; } @@ -9401,7 +9397,7 @@ export namespace discoveryengine_v1 { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -12610,13 +12606,9 @@ export namespace discoveryengine_v1 { vpcscEnabled?: boolean | null; } /** - * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note). + * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note). */ export interface Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata { - /** - * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides. - */ - authenticatedAccount?: string | null; /** * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors). */ @@ -13521,7 +13513,7 @@ export namespace discoveryengine_v1 { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -17607,6 +17599,14 @@ export namespace discoveryengine_v1 { * Output only. The display name of the data source. */ dataSourceDisplayName?: string | null; + /** + * Output only. The end-user-facing display name of the data source, sourced from `ConnectorSource.end_user_display_name`. When unset, clients fall back to `data_source_display_name`. + */ + dataSourceEndUserDisplayName?: string | null; + /** + * Output only. The version of the connector definition backing this collection, mirroring `DataConnector.data_source_version`. + */ + dataSourceVersion?: number | null; /** * For the data store collection, list of the children data stores. */ @@ -17619,6 +17619,14 @@ export namespace discoveryengine_v1 { * Output only. the identifier of the collection, used for widget service. For now it refers to collection_id, in the future we will migrate the field to encrypted collection name UUID. For synthetic placeholder entries (see message-level comment) this is a synthetic placeholder id, not a real collection_id. */ id?: string | null; + /** + * Output only. Whether this is a first-party (Google-owned) connector, as opposed to a third-party connector. Used by the frontend to group 1P vs 3P connectors. Sourced from `ConnectorSource.is_first_party` once that field is universally populated (b/534727761); until then derived from `ConnectorSource.connector_type == FIRST_PARTY`. + */ + isFirstParty?: boolean | null; + /** + * Output only. User-facing connector metadata (`title`, `description`, `short_description`, `author`, `note`), retrieved from the registry `ConnectorSource.metadata` (joined by data source). Shown on the connector detail page. + */ + metadata?: Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata; /** * The name of the collection. It should be collection resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. */ @@ -17848,7 +17856,7 @@ export namespace discoveryengine_v1 { */ enableVisualContentSummary?: boolean | null; /** - * Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -19223,6 +19231,165 @@ export namespace discoveryengine_v1 { } } + /** + * Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms. + * @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('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', + * '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.provision({ + * // Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`. + * name: 'projects/my-project/locations/my-location', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "acceptDataUseTerms": false, + * // "dataUseTermsVersion": "my_dataUseTermsVersion", + * // "saasParams": {} + * // } + * }, + * }); + * 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. + */ + provision( + params: Params$Resource$Projects$Locations$Provision, + options: StreamMethodOptions + ): Promise>; + provision( + params?: Params$Resource$Projects$Locations$Provision, + options?: MethodOptions + ): Promise>; + provision( + params: Params$Resource$Projects$Locations$Provision, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + provision( + params: Params$Resource$Projects$Locations$Provision, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + provision( + params: Params$Resource$Projects$Locations$Provision, + callback: BodyResponseCallback + ): void; + provision( + callback: BodyResponseCallback + ): void; + provision( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Provision + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Provision; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Provision; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://discoveryengine.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}:provision').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); + } + } + /** * Creates a Collection and sets up the DataConnector for it. To stop a DataConnector after setup, use the CollectionService.DeleteCollection method. * @example @@ -19926,6 +20093,17 @@ export namespace discoveryengine_v1 { */ name?: string; } + export interface Params$Resource$Projects$Locations$Provision extends StandardParameters { + /** + * Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleCloudDiscoveryengineV1ProvisionProjectRequest; + } export interface Params$Resource$Projects$Locations$Setupdataconnector extends StandardParameters { /** * Required. The parent of Collection, in the format of `projects/{project\}/locations/{location\}`. diff --git a/src/apis/discoveryengine/v1alpha.ts b/src/apis/discoveryengine/v1alpha.ts index b339f991244..df6ccd82957 100644 --- a/src/apis/discoveryengine/v1alpha.ts +++ b/src/apis/discoveryengine/v1alpha.ts @@ -3041,7 +3041,7 @@ export namespace discoveryengine_v1alpha { */ deleteUnassignedUserLicenses?: boolean | null; /** - * The inline source for the input content for document embeddings. + * The inline source for the input content for license assignment. */ inlineSource?: Schema$GoogleCloudDiscoveryengineV1alphaBatchUpdateUserLicensesRequestInlineSource; } @@ -4699,13 +4699,9 @@ export namespace discoveryengine_v1alpha { vpcscEnabled?: boolean | null; } /** - * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note). + * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note). */ export interface Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata { - /** - * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides. - */ - authenticatedAccount?: string | null; /** * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors). */ @@ -5731,7 +5727,7 @@ export namespace discoveryengine_v1alpha { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -11938,6 +11934,14 @@ export namespace discoveryengine_v1alpha { * Output only. The display name of the data source. */ dataSourceDisplayName?: string | null; + /** + * Output only. The end-user-facing display name of the data source, sourced from `ConnectorSource.end_user_display_name`. When unset, clients fall back to `data_source_display_name`. + */ + dataSourceEndUserDisplayName?: string | null; + /** + * Output only. The version of the connector definition backing this collection, mirroring `DataConnector.data_source_version`. + */ + dataSourceVersion?: number | null; /** * For the data store collection, list of the children data stores. */ @@ -11950,6 +11954,14 @@ export namespace discoveryengine_v1alpha { * Output only. the identifier of the collection, used for widget service. For now it refers to collection_id, in the future we will migrate the field to encrypted collection name UUID. For synthetic placeholder entries (see message-level comment) this is a synthetic placeholder id, not a real collection_id. */ id?: string | null; + /** + * Output only. Whether this is a first-party (Google-owned) connector, as opposed to a third-party connector. Used by the frontend to group 1P vs 3P connectors. Sourced from `ConnectorSource.is_first_party` once that field is universally populated (b/534727761); until then derived from `ConnectorSource.connector_type == FIRST_PARTY`. + */ + isFirstParty?: boolean | null; + /** + * Output only. User-facing connector metadata (`title`, `description`, `short_description`, `author`, `note`), retrieved from the registry `ConnectorSource.metadata` (joined by data source). Shown on the connector detail page. + */ + metadata?: Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata; /** * The name of the collection. It should be collection resource name. Format: `projects/{project\}/locations/{location\}/collections/{collection_id\}`. For APIs under WidgetService, such as WidgetService.LookupWidgetConfig, the project number and location part is erased in this field. For synthetic placeholder entries (see message-level comment) this carries a synthetic placeholder collection id that does not correspond to a real collection. Callers must not attempt to resolve / GET this resource until the user authorizes the connector. */ @@ -12187,7 +12199,7 @@ export namespace discoveryengine_v1alpha { */ enableVisualContentSummary?: boolean | null; /** - * Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -13611,7 +13623,7 @@ export namespace discoveryengine_v1alpha { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -16181,13 +16193,9 @@ export namespace discoveryengine_v1alpha { vpcscEnabled?: boolean | null; } /** - * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note). + * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note). */ export interface Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata { - /** - * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides. - */ - authenticatedAccount?: string | null; /** * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors). */ @@ -16907,7 +16915,7 @@ export namespace discoveryengine_v1alpha { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -21476,6 +21484,165 @@ export namespace discoveryengine_v1alpha { } } + /** + * Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms. + * @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.provision({ + * // Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`. + * name: 'projects/my-project/locations/my-location', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "acceptDataUseTerms": false, + * // "dataUseTermsVersion": "my_dataUseTermsVersion", + * // "saasParams": {} + * // } + * }, + * }); + * 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. + */ + provision( + params: Params$Resource$Projects$Locations$Provision, + options: StreamMethodOptions + ): Promise>; + provision( + params?: Params$Resource$Projects$Locations$Provision, + options?: MethodOptions + ): Promise>; + provision( + params: Params$Resource$Projects$Locations$Provision, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + provision( + params: Params$Resource$Projects$Locations$Provision, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + provision( + params: Params$Resource$Projects$Locations$Provision, + callback: BodyResponseCallback + ): void; + provision( + callback: BodyResponseCallback + ): void; + provision( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Provision + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Provision; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Provision; + 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}:provision').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); + } + } + /** * Queries configurable pricing usage stats for a project. * @example @@ -22714,6 +22881,17 @@ export namespace discoveryengine_v1alpha { */ requestBody?: Schema$GoogleCloudDiscoveryengineV1alphaObtainCrawlRateRequest; } + export interface Params$Resource$Projects$Locations$Provision extends StandardParameters { + /** + * Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleCloudDiscoveryengineV1alphaProvisionProjectRequest; + } export interface Params$Resource$Projects$Locations$Queryconfigurablepricingusagestats extends StandardParameters { /** * Required. The location to query usage stats for. diff --git a/src/apis/discoveryengine/v1beta.ts b/src/apis/discoveryengine/v1beta.ts index d20bf478a6b..50abde1a8fc 100644 --- a/src/apis/discoveryengine/v1beta.ts +++ b/src/apis/discoveryengine/v1beta.ts @@ -2493,13 +2493,9 @@ export namespace discoveryengine_v1beta { vpcscEnabled?: boolean | null; } /** - * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note). + * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note). */ export interface Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata { - /** - * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides. - */ - authenticatedAccount?: string | null; /** * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors). */ @@ -3322,7 +3318,7 @@ export namespace discoveryengine_v1beta { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -8126,7 +8122,7 @@ export namespace discoveryengine_v1beta { */ deleteUnassignedUserLicenses?: boolean | null; /** - * The inline source for the input content for document embeddings. + * The inline source for the input content for license assignment. */ inlineSource?: Schema$GoogleCloudDiscoveryengineV1betaBatchUpdateUserLicensesRequestInlineSource; } @@ -9848,7 +9844,7 @@ export namespace discoveryengine_v1beta { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -14895,13 +14891,9 @@ export namespace discoveryengine_v1beta { vpcscEnabled?: boolean | null; } /** - * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note). + * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, note). */ export interface Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata { - /** - * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides. - */ - authenticatedAccount?: string | null; /** * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors). */ @@ -15621,7 +15613,7 @@ export namespace discoveryengine_v1beta { */ displayName?: string | null; /** - * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` + * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` */ features?: {[key: string]: string} | null; /** @@ -18416,6 +18408,165 @@ export namespace discoveryengine_v1beta { } } + /** + * Provisions the project resource. During the process, related systems will get prepared and initialized. Caller must read the [Terms for data use](https://cloud.google.com/retail/data-use-terms), and optionally specify in request to provide consent to that service terms. + * @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('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', + * '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.provision({ + * // Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`. + * name: 'projects/my-project/locations/my-location', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "acceptDataUseTerms": false, + * // "dataUseTermsVersion": "my_dataUseTermsVersion", + * // "saasParams": {} + * // } + * }, + * }); + * 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. + */ + provision( + params: Params$Resource$Projects$Locations$Provision, + options: StreamMethodOptions + ): Promise>; + provision( + params?: Params$Resource$Projects$Locations$Provision, + options?: MethodOptions + ): Promise>; + provision( + params: Params$Resource$Projects$Locations$Provision, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + provision( + params: Params$Resource$Projects$Locations$Provision, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + provision( + params: Params$Resource$Projects$Locations$Provision, + callback: BodyResponseCallback + ): void; + provision( + callback: BodyResponseCallback + ): void; + provision( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Provision + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Provision; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Provision; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://discoveryengine.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta/{+name}:provision').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); + } + } + /** * Removes the dedicated crawl rate for a craw_rate_scope. If the dedicated crawl rate was set, this will disable vertex AI's crawl bot from using the dedicated crawl rate for crawling. If the dedicated crawl rate was not set, this is a no-op. * @example @@ -19080,6 +19231,17 @@ export namespace discoveryengine_v1beta { */ requestBody?: Schema$GoogleCloudDiscoveryengineV1betaObtainCrawlRateRequest; } + export interface Params$Resource$Projects$Locations$Provision extends StandardParameters { + /** + * Required. Full resource name of a Project, such as `projects/{project_id_or_number\}`. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$GoogleCloudDiscoveryengineV1betaProvisionProjectRequest; + } export interface Params$Resource$Projects$Locations$Removededicatedcrawlrate extends StandardParameters { /** * Required. The location resource where crawl rate management will be performed. Format: `projects/{project\}/locations/{location\}` diff --git a/src/apis/displayvideo/v2.ts b/src/apis/displayvideo/v2.ts index 833704adb62..31d05d2bda3 100644 --- a/src/apis/displayvideo/v2.ts +++ b/src/apis/displayvideo/v2.ts @@ -1935,7 +1935,7 @@ export namespace displayvideo_v2 { */ skippable?: boolean | null; /** - * Optional. Whether the creative contains synthetic content or was created using AI. + * Optional. Whether to add a label to the creative as created or edited using AI when served in regions with local AI labeling regulations. */ syntheticContentAttestationStatus?: string | null; /** diff --git a/src/apis/displayvideo/v3.ts b/src/apis/displayvideo/v3.ts index fbda541e434..f0424cbfda9 100644 --- a/src/apis/displayvideo/v3.ts +++ b/src/apis/displayvideo/v3.ts @@ -2810,7 +2810,7 @@ export namespace displayvideo_v3 { */ skippable?: boolean | null; /** - * Optional. Whether the creative contains synthetic content or was created using AI. + * Optional. Whether to add a label to the creative as created or edited using AI when served in regions with local AI labeling regulations. */ syntheticContentAttestationStatus?: string | null; /** diff --git a/src/apis/displayvideo/v4.ts b/src/apis/displayvideo/v4.ts index 0b7a2082eb8..7cc4f30e6f5 100644 --- a/src/apis/displayvideo/v4.ts +++ b/src/apis/displayvideo/v4.ts @@ -205,7 +205,7 @@ export namespace displayvideo_v4 { */ name?: string | null; /** - * Optional. Whether the asset contains synthetic content or was created using AI. + * Optional. Whether to add a label to the asset as created or edited using AI when served in regions with local AI labeling regulations. */ syntheticContentAttestationStatus?: string | null; /** @@ -2561,7 +2561,7 @@ export namespace displayvideo_v4 { */ export interface Schema$ContactInfo { /** - * Optional. Country code of the member. Must also be set with the following fields: * country_code * hashed_first_name * hashed_last_name * zip_codes + * Optional. Country code of the member. Must also be set with the following fields: * hashed_first_name * hashed_last_name * zip_codes */ countryCode?: string | null; /** @@ -2994,7 +2994,7 @@ export namespace displayvideo_v4 { */ skippable?: boolean | null; /** - * Optional. Whether the creative contains synthetic content or was created using AI. + * Optional. Whether to add a label to the creative as created or edited using AI when served in regions with local AI labeling regulations. */ syntheticContentAttestationStatus?: string | null; /** @@ -7439,7 +7439,7 @@ export namespace displayvideo_v4 { */ filename?: string | null; /** - * Optional. Whether the asset contains synthetic content or was created using AI. + * Optional. Whether to add a label to the asset as created or edited using AI when served in regions with local AI labeling regulations. */ syntheticContentAttestationStatus?: string | null; } @@ -9952,7 +9952,7 @@ export namespace displayvideo_v4 { } /** - * Updates an ad asset. Returns the updated ad asset if successful. Supports updating assets of AdAssetType `AD_ASSET_TYPE_YOUTUBE_VIDEO` and `AD_ASSET_TYPE_IMAGE`. Only the `synthetic_content_attestation_status` field is mutable. + * Updates an ad asset. Returns the updated ad asset if successful. Supports updating assets of AdAssetType `AD_ASSET_TYPE_YOUTUBE_VIDEO` and `AD_ASSET_TYPE_IMAGE`. Only the AdAsset.synthetic_content_attestation_status field is mutable. * @example * ```js * // Before running the sample: @@ -24915,7 +24915,7 @@ export namespace displayvideo_v4 { } /** - * Generates a reach forecast for a given advertiser and targeting configuration. + * Generates a reach forecast for a given advertiser and targeting configuration. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users. * @example * ```js * // Before running the sample: @@ -25073,7 +25073,7 @@ export namespace displayvideo_v4 { } /** - * Retrieves the list of countries where reach forecasting is supported. + * Retrieves the list of countries where reach forecasting is supported. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users. * @example * ```js * // Before running the sample: @@ -25222,7 +25222,7 @@ export namespace displayvideo_v4 { } /** - * Retrieves the list of products that can be planned for a location. + * Retrieves the list of products that can be planned for a location. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users. * @example * ```js * // Before running the sample: @@ -25373,7 +25373,7 @@ export namespace displayvideo_v4 { } /** - * Retrieves Google Audiences (User Interests) available for forecasting. + * Retrieves Google Audiences (User Interests) available for forecasting. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users. * @example * ```js * // Before running the sample: @@ -25526,7 +25526,7 @@ export namespace displayvideo_v4 { } /** - * Retrieves first and third party user lists available for forecasting. + * Retrieves first and third party user lists available for forecasting. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users. * @example * ```js * // Before running the sample: diff --git a/src/apis/firebaseml/v2beta.ts b/src/apis/firebaseml/v2beta.ts index 0962a8017f5..c856d594a09 100644 --- a/src/apis/firebaseml/v2beta.ts +++ b/src/apis/firebaseml/v2beta.ts @@ -218,11 +218,15 @@ export namespace firebaseml_v2beta { */ diarization?: boolean | null; /** - * Optional. The model will detect the language automatically. + * Optional. Deprecated: Use top-level `language_codes` instead. The model will detect the language automatically. */ languageAuto?: Schema$GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageAuto; /** - * Optional. Specifies one or more languages in the audio. + * Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection. + */ + languageCodes?: string[] | null; + /** + * Optional. Deprecated: Use top-level `language_codes` instead. Specifies one or more languages in the audio. */ languageHints?: Schema$GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageHints; /** @@ -231,15 +235,15 @@ export namespace firebaseml_v2beta { wordTimestamp?: boolean | null; } /** - * Indicates the language of the audio should be automatically detected. + * Deprecated: Use top-level `language_codes` instead. Indicates the language of the audio should be automatically detected. */ export interface Schema$GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageAuto {} /** - * Provides hints to the model about possible languages present in the audio. + * Deprecated: Use top-level `language_codes` instead. Provides hints to the model about possible languages present in the audio. */ export interface Schema$GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageHints { /** - * Required. BCP-47 language codes. At least one must be specified. + * Required. Deprecated: Use top-level `language_codes` instead. BCP-47 language codes. At least one must be specified. */ languageCodes?: string[] | null; } @@ -2313,6 +2317,10 @@ export namespace firebaseml_v2beta { * Optional. The Google Cloud Storage URI to store the video output. Required for Vertex if delivery is URI. */ gcsUri?: string | null; + /** + * Optional. The video output resolution. Supported values: "360p", "720p", "1080p", "4k". + */ + resolution?: string | null; } /** * Configuration for a voice. diff --git a/src/apis/ftp/README.md b/src/apis/ftp/README.md new file mode 100644 index 00000000000..2fb3ce7e3ad --- /dev/null +++ b/src/apis/ftp/README.md @@ -0,0 +1,28 @@ +Google Inc. logo + +# ftp + +> A managed, cloud-native solution to move data in and out of Google Cloud by using SSH File Transfer Protocol (SFTP). + +## Installation + +```sh +$ npm install @googleapis/ftp +``` + +## Usage +All documentation and usage information can be found on [GitHub](https://github.com/googleapis/google-api-nodejs-client). +Information on classes can be found in [Googleapis Documentation](https://googleapis.dev/nodejs/googleapis/latest/ftp/classes/Ftp.html). + +## License +This library is licensed under Apache 2.0. Full license text is available in [LICENSE](https://github.com/googleapis/google-api-nodejs-client/blob/main/LICENSE). + +## Contributing +We love contributions! Before submitting a Pull Request, it's always good to start with a new issue first. To learn more, see [CONTRIBUTING](https://github.com/google/google-api-nodejs-client/blob/main/.github/CONTRIBUTING.md). + +## Questions/problems? +* Ask your development related questions on [StackOverflow](http://stackoverflow.com/questions/tagged/google-api-nodejs-client). +* If you've found an bug/issue, please [file it on GitHub](https://github.com/googleapis/google-api-nodejs-client/issues). + + +*Crafted with ❤️ by the Google Node.js team* diff --git a/src/apis/ftp/index.ts b/src/apis/ftp/index.ts new file mode 100644 index 00000000000..7a81f1e08bb --- /dev/null +++ b/src/apis/ftp/index.ts @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +/*! THIS FILE IS AUTO-GENERATED */ + +import {AuthPlus, getAPI, GoogleConfigurable} from 'googleapis-common'; +import {ftp_v1} from './v1'; +import {ftp_v1alpha} from './v1alpha'; + +export const VERSIONS = { + v1: ftp_v1.Ftp, + v1alpha: ftp_v1alpha.Ftp, +}; + +export function ftp(version: 'v1'): ftp_v1.Ftp; +export function ftp(options: ftp_v1.Options): ftp_v1.Ftp; +export function ftp(version: 'v1alpha'): ftp_v1alpha.Ftp; +export function ftp(options: ftp_v1alpha.Options): ftp_v1alpha.Ftp; +export function ftp( + this: GoogleConfigurable, + versionOrOptions: 'v1' | ftp_v1.Options | 'v1alpha' | ftp_v1alpha.Options +) { + return getAPI('ftp', versionOrOptions, VERSIONS, this); +} + +const auth = new AuthPlus(); +export {auth}; +export {ftp_v1}; +export {ftp_v1alpha}; +export { + AuthPlus, + GlobalOptions, + APIRequestContext, + GoogleConfigurable, + StreamMethodOptions, + MethodOptions, + BodyResponseCallback, +} from 'googleapis-common'; diff --git a/src/apis/ftp/package.json b/src/apis/ftp/package.json new file mode 100644 index 00000000000..389ed04afd7 --- /dev/null +++ b/src/apis/ftp/package.json @@ -0,0 +1,43 @@ +{ + "name": "@googleapis/ftp", + "version": "0.1.0", + "description": "ftp", + "main": "build/index.js", + "types": "build/index.d.ts", + "keywords": [ + "google" + ], + "author": "Google LLC", + "license": "Apache-2.0", + "homepage": "https://github.com/googleapis/google-api-nodejs-client", + "bugs": { + "url": "https://github.com/googleapis/google-api-nodejs-client/issues" + }, + "repository": { + "type": "git", + "url": "https://github.com/googleapis/google-api-nodejs-client.git" + }, + "engines": { + "node": ">=12.0.0" + }, + "scripts": { + "fix": "gts fix", + "lint": "gts check", + "compile": "tsc -p .", + "prepare": "npm run compile", + "webpack": "webpack" + }, + "dependencies": { + "googleapis-common": "^8.0.0" + }, + "devDependencies": { + "@microsoft/api-documenter": "^7.8.10", + "@microsoft/api-extractor": "^7.8.10", + "gts": "^6.0.0", + "null-loader": "^4.0.0", + "ts-loader": "^9.0.0", + "typescript": "5.7.3", + "webpack": "^5.0.0", + "webpack-cli": "^5.0.0" + } +} diff --git a/src/apis/ftp/tsconfig.json b/src/apis/ftp/tsconfig.json new file mode 100644 index 00000000000..e0810904968 --- /dev/null +++ b/src/apis/ftp/tsconfig.json @@ -0,0 +1,10 @@ +{ + "extends": "./node_modules/gts/tsconfig-google.json", + "compilerOptions": { + "rootDir": ".", + "outDir": "build" + }, + "include": [ + "*.ts", + ] +} diff --git a/src/apis/ftp/v1.ts b/src/apis/ftp/v1.ts new file mode 100644 index 00000000000..741bad8d4c1 --- /dev/null +++ b/src/apis/ftp/v1.ts @@ -0,0 +1,3446 @@ +// Copyright 2020 Google LLC +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +/* eslint-disable @typescript-eslint/no-explicit-any */ +/* eslint-disable @typescript-eslint/no-unused-vars */ +/* eslint-disable @typescript-eslint/no-empty-interface */ +/* eslint-disable @typescript-eslint/no-namespace */ +/* eslint-disable no-irregular-whitespace */ + +import { + OAuth2Client, + JWT, + Compute, + UserRefreshClient, + BaseExternalAccountClient, + GaxiosResponseWithHTTP2, + GoogleConfigurable, + createAPIRequest, + MethodOptions, + StreamMethodOptions, + GlobalOptions, + GoogleAuth, + BodyResponseCallback, + APIRequestContext, +} from 'googleapis-common'; +import {Readable} from 'stream'; + +export namespace ftp_v1 { + export interface Options extends GlobalOptions { + version: 'v1'; + } + + interface StandardParameters { + /** + * Auth client or API Key for the request + */ + auth?: + | string + | OAuth2Client + | JWT + | Compute + | UserRefreshClient + | BaseExternalAccountClient + | GoogleAuth; + + /** + * V1 error format. + */ + '$.xgafv'?: string; + /** + * OAuth access token. + */ + access_token?: string; + /** + * Data format for response. + */ + alt?: string; + /** + * JSONP + */ + callback?: string; + /** + * Selector specifying which fields to include in a partial response. + */ + fields?: string; + /** + * API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. + */ + key?: string; + /** + * OAuth 2.0 token for the current user. + */ + oauth_token?: string; + /** + * Returns response with indentations and line breaks. + */ + prettyPrint?: boolean; + /** + * Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. + */ + quotaUser?: string; + /** + * Legacy upload protocol for media (e.g. "media", "multipart"). + */ + uploadType?: string; + /** + * Upload protocol for media (e.g. "raw", "multipart"). + */ + upload_protocol?: string; + } + + /** + * Cloud FTP API + * + * Cloud FTP is a managed service that allows transferring files directly to Google Cloud Storage using SFTP. + * + * @example + * ```js + * const {google} = require('googleapis'); + * const ftp = google.ftp('v1'); + * ``` + */ + export class Ftp { + context: APIRequestContext; + projects: Resource$Projects; + + constructor(options: GlobalOptions, google?: GoogleConfigurable) { + this.context = { + _options: options || {}, + google, + }; + + this.projects = new Resource$Projects(this.context); + } + } + + /** + * A consumer project or network that is permitted to connect to the server via PSC. + */ + export interface Schema$AllowedConsumer { + /** + * Required. The connection limit for the consumer. Value must be greater than 0. + */ + connectionLimit?: string | null; + /** + * The project ID or number of the consumer project. Must be in the format: `projects/{project\}`. + */ + project?: string | null; + } + /** + * The request message for Operations.CancelOperation. + */ + export interface Schema$CancelOperationRequest {} + /** + * A consumer project or network that is denied to connect to the server via PSC. + */ + export interface Schema$DeniedConsumer { + /** + * The project ID or number of the consumer project. Must be in the format: `projects/{project\}`. + */ + project?: 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 {} + /** + * Configuration for external server. + */ + export interface Schema$ExternalServerConfig { + /** + * Optional. List of CIDR blocks that are allowed to access the Server. A CIDR range consists of an IP Address and a prefix length to construct the subnet mask. By default, the prefix length is 32 (i.e. matches a single IP address). For now, only IPV4 addresses are supported. Examples: "203.0.113.0/24" - matches with the IP addresses in the range 203.0.113.0 - 203.0.113.255. "0.0.0.0/0" - matches against any IP address. This field must contain at least one entry if the access type is EXTERNAL. The number of allowed CIDR blocks cannot exceed 500. Example: 192.168.0.0/16 + */ + allowedCidrBlocks?: string[] | null; + /** + * Output only. IP address of the LB via which clients will connect. + */ + ipAddress?: string | null; + } + /** + * Configuration for private server accessible via PSC. + */ + export interface Schema$InternalServerConfig { + /** + * Required. A list of projects that are permitted to connect. At least one project is required in the allow list. + */ + consumerAcceptList?: Schema$AllowedConsumer[]; + /** + * Optional. A list of projects that are denied connection. Format: "projects/sample_project_id" or "projects/1234567890" Projects in this list will be denied access, even if they are included in the `allow_list`. If this list is empty, no projects are explicitly rejected. + */ + consumerRejectList?: Schema$DeniedConsumer[]; + /** + * Output only. Details of endpoints created by the customer. + */ + pscEndpoints?: Schema$PscEndpoint[]; + /** + * Output only. The resource name of the service attachment. Format: `projects/{project\}/regions/{region\}/serviceAttachments/{service_attachment\}` + */ + serviceAttachment?: string | 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; + } + /** + * The response message for Operations.ListOperations. + */ + export interface Schema$ListOperationsResponse { + /** + * The standard List next-page token. + */ + nextPageToken?: string | null; + /** + * A list of operations that matches the specified filter in the request. + */ + operations?: Schema$Operation[]; + /** + * 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; + } + /** + * Message for response to listing Servers + */ + export interface Schema$ListServersResponse { + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + /** + * The list of Server + */ + servers?: Schema$Server[]; + /** + * Unordered list. Locations that could not be reached. + */ + unreachable?: string[] | null; + } + /** + * Message for response to listing Users + */ + export interface Schema$ListUsersResponse { + /** + * A token identifying a page of results the user should return. + */ + nextPageToken?: string | null; + /** + * Unordered list. Locations that could not be reached. + */ + unreachable?: string[] | null; + /** + * The list of User + */ + users?: Schema$User[]; + } + /** + * 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; + } + /** + * This resource represents a long-running operation that is the result of a network API call. + */ + export interface Schema$Operation { + /** + * If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. + */ + done?: boolean | null; + /** + * The error result of the operation in case of failure or cancellation. + */ + error?: Schema$Status; + /** + * Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any. + */ + metadata?: {[key: string]: any} | null; + /** + * The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id\}`. + */ + name?: string | null; + /** + * The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. + */ + response?: {[key: string]: any} | null; + } + /** + * 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 been cancelled successfully have google.longrunning.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; + } + /** + * Details of PSC endpoint created by customer. + */ + export interface Schema$PscEndpoint { + /** + * Output only. This is a Resource name for Private Service Connect endpoint. Format: `projects/{project\}/regions/{region\}/forwardingRules/{forwarding_rule\}` + */ + endpoint?: string | null; + /** + * Output only. The consumer network. Format: `projects/{project\}/locations/{location\}/networks/{network\}` + */ + network?: string | null; + /** + * Output only. The status of the connected endpoint. + */ + status?: string | null; + } + /** + * Message describing Server object + */ + export interface Schema$Server { + /** + * Required. The access type of the Server. + */ + accessType?: string | null; + /** + * Output only. [Output only] Create time stamp + */ + createTime?: string | null; + /** + * Optional. Display name of the Server + */ + displayName?: string | null; + /** + * Configuration for external access. + */ + externalConfig?: Schema$ExternalServerConfig; + /** + * Output only. Credentials of the FTP Server. + */ + googleManagedServerCredential?: Schema$ServerCredential; + /** + * Configuration for internal access. + */ + internalConfig?: Schema$InternalServerConfig; + /** + * Optional. Labels as key value pairs + */ + labels?: {[key: string]: string} | null; + /** + * Identifier. name of resource + */ + name?: string | null; + /** + * Output only. Service agent used to access the customer bucket. + */ + serviceAgent?: string | null; + /** + * Output only. The state of the server. + */ + state?: string | null; + /** + * Output only. [Output only] Update time stamp + */ + updateTime?: string | null; + } + /** + * Represents credentials of an FTP Server. + */ + export interface Schema$ServerCredential { + /** + * Output only. Asymmetric algorithm used by the public key. Possible values (can be expanded in future): - ssh-ed25519 + */ + asymmetricAlgorithm?: string | null; + /** + * Output only. The fingerprint is a hash of the public key, and is displayed when clients access the server for the first time to verify the server's identity. + */ + fingerprint?: string | null; + } + /** + * Request message for starting a Server. + */ + export interface Schema$StartServerRequest {} + /** + * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). + */ + export interface Schema$Status { + /** + * The status code, which should be an enum value of google.rpc.Code. + */ + code?: number | null; + /** + * A list of messages that carry the error details. There is a common set of message types for APIs to use. + */ + details?: Array<{[key: string]: any}> | null; + /** + * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. + */ + message?: string | null; + } + /** + * Request message for stopping a Server. + */ + export interface Schema$StopServerRequest {} + /** + * Mapping of backing Cloud Storage path to the directory where the user lands in the SFTP server. If directory is not specified, it'll default to '/'. Eg 1 - (bucket_name: bucket, bucket_prefix: path1/path2, directory: /abc/def/username) The user will land at /abcd/def/username, and the view there will match that of /bucket/path1/path2. The user will not be aware of Cloud Storage prefix '/bucket/path1' and there will be no such directory in the view. Eg 2 - (bucket_name: bucket, bucket_prefix: path1/path2, directory: '') The user will land at '/', and the view there will match that of /bucket/path1/path2. The user will not be aware of Cloud Storage prefix '/bucket/path1/path2' and there will be no such directory in the view. + */ + export interface Schema$StorageDirectoryMapping { + /** + * Required. Name of the bucket. + */ + bucket?: string | null; + /** + * Optional. Prefix inside the bucket. + */ + bucketPrefix?: string | null; + /** + * Required. Directory where the user lands in the SFTP server. + */ + directory?: string | null; + /** + * Required. Permission to the bucket. + */ + permission?: string | null; + } + /** + * Message describing User object + */ + export interface Schema$User { + /** + * Output only. [Output only] Create time stamp + */ + createTime?: string | null; + /** + * Required. Service account in customer project attached to this SFTP User. + */ + customerServiceAccount?: string | null; + /** + * Optional. Labels as key value pairs + */ + labels?: {[key: string]: string} | null; + /** + * Identifier. User-friendly name via which User will be identified. projects/{project\}/locations/{location\}/servers/{server\}/users/{user\} + */ + name?: string | null; + /** + * Output only. Tracks user creation. + */ + state?: string | null; + /** + * Required. Mapping of Cloud Storage buckets to directories where the user will land in the SFTP server. + */ + storageDirectoryMappings?: Schema$StorageDirectoryMapping[]; + /** + * Output only. [Output only] Update time stamp + */ + updateTime?: string | null; + /** + * Required. User credential for the user. The maximum number of user credentials is 10. + */ + userCredentials?: Schema$UserCredential[]; + /** + * Output only. [Output only] The username of the user. + */ + username?: string | null; + } + /** + * Message describing UserCredential object + */ + export interface Schema$UserCredential { + /** + * Required. Name of the user credential. + */ + credentialName?: string | null; + /** + * Required. Type of credential. + */ + credentialType?: string | null; + /** + * Optional. SSH public key body in OpenSSH format. Example: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ..." + */ + sshPublicKeyBody?: string | null; + } + + export class Resource$Projects { + context: APIRequestContext; + locations: Resource$Projects$Locations; + constructor(context: APIRequestContext) { + this.context = context; + this.locations = new Resource$Projects$Locations(this.context); + } + } + + export class Resource$Projects$Locations { + context: APIRequestContext; + operations: Resource$Projects$Locations$Operations; + servers: Resource$Projects$Locations$Servers; + constructor(context: APIRequestContext) { + this.context = context; + this.operations = new Resource$Projects$Locations$Operations( + this.context + ); + this.servers = new Resource$Projects$Locations$Servers(this.context); + } + + /** + * Gets information about a location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.get({ + * // Resource name for the location. + * name: 'projects/my-project/locations/my-location', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "displayName": "my_displayName", + * // "labels": {}, + * // "locationId": "my_locationId", + * // "metadata": {}, + * // "name": "my_name" + * // } + * } + * + * 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$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 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: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.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', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "locations": [], + * // "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$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$List, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}/locations').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$Get extends StandardParameters { + /** + * Resource name for the location. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$List extends StandardParameters { + /** + * Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage. + */ + extraLocationTypes?: string[]; + /** + * 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?: string; + /** + * The resource that owns the locations collection, if applicable. + */ + name?: string; + /** + * The maximum number of results to return. If not set, the service selects a default. + */ + pageSize?: number; + /** + * A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page. + */ + pageToken?: string; + } + + export class Resource$Projects$Locations$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/ftp.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 ftp = google.ftp('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 ftp.projects.locations.operations.cancel({ + * // The name of the operation resource to be cancelled. + * name: 'projects/my-project/locations/my-location/operations/my-operation', + * + * // 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. + */ + cancel( + params: Params$Resource$Projects$Locations$Operations$Cancel, + options: StreamMethodOptions + ): Promise>; + cancel( + params?: Params$Resource$Projects$Locations$Operations$Cancel, + options?: MethodOptions + ): Promise>; + cancel( + params: Params$Resource$Projects$Locations$Operations$Cancel, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + cancel( + params: Params$Resource$Projects$Locations$Operations$Cancel, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + cancel( + params: Params$Resource$Projects$Locations$Operations$Cancel, + callback: BodyResponseCallback + ): void; + cancel(callback: BodyResponseCallback): void; + cancel( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Operations$Cancel + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Operations$Cancel; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Operations$Cancel; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}:cancel').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); + } + } + + /** + * 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: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.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 => { + * 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$Projects$Locations$Operations$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Projects$Locations$Operations$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Operations$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Operations$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Operations$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Operations$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Operations$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Operations$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 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/ftp.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 ftp = google.ftp('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 ftp.projects.locations.operations.get({ + * // The name of the operation resource. + * name: 'projects/my-project/locations/my-location/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$Operations$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Operations$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Operations$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Operations$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Operations$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Operations$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Operations$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Operations$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 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: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.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 + * // { + * // "nextPageToken": "my_nextPageToken", + * // "operations": [], + * // "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$Operations$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Operations$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Operations$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Operations$List, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Operations$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Operations$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Operations$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Operations$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}/operations').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$Operations$Cancel extends StandardParameters { + /** + * The name of the operation resource to be cancelled. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$CancelOperationRequest; + } + export interface Params$Resource$Projects$Locations$Operations$Delete extends StandardParameters { + /** + * The name of the operation resource to be deleted. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Operations$Get extends StandardParameters { + /** + * The name of the operation resource. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$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$Projects$Locations$Servers { + context: APIRequestContext; + users: Resource$Projects$Locations$Servers$Users; + constructor(context: APIRequestContext) { + this.context = context; + this.users = new Resource$Projects$Locations$Servers$Users(this.context); + } + + /** + * Creates a new Server in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.create({ + * // Required. Value for parent. + * parent: 'projects/my-project/locations/my-location', + * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + * requestId: 'placeholder-value', + * // Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC + * serverId: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "accessType": "my_accessType", + * // "createTime": "my_createTime", + * // "displayName": "my_displayName", + * // "externalConfig": {}, + * // "googleManagedServerCredential": {}, + * // "internalConfig": {}, + * // "labels": {}, + * // "name": "my_name", + * // "serviceAgent": "my_serviceAgent", + * // "state": "my_state", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * 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. + */ + create( + params: Params$Resource$Projects$Locations$Servers$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Projects$Locations$Servers$Create, + options?: MethodOptions + ): Promise>; + create( + params: Params$Resource$Projects$Locations$Servers$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Servers$Create, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Servers$Create, + callback: BodyResponseCallback + ): void; + create(callback: BodyResponseCallback): void; + create( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/servers').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 single Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.delete({ + * // Required. Name of the resource + * name: 'projects/my-project/locations/my-location/servers/my-server', + * }); + * 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. + */ + delete( + params: Params$Resource$Projects$Locations$Servers$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Projects$Locations$Servers$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Servers$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Servers$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Servers$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 details of a single Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.get({ + * // Required. Name of the resource + * name: 'projects/my-project/locations/my-location/servers/my-server', + * // Optional. The view of the Server resource to return. + * view: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "accessType": "my_accessType", + * // "createTime": "my_createTime", + * // "displayName": "my_displayName", + * // "externalConfig": {}, + * // "googleManagedServerCredential": {}, + * // "internalConfig": {}, + * // "labels": {}, + * // "name": "my_name", + * // "serviceAgent": "my_serviceAgent", + * // "state": "my_state", + * // "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$Servers$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Servers$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Servers$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Servers$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Servers$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 Servers in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.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 value for ListServersRequest + * parent: 'projects/my-project/locations/my-location', + * // Optional. The view of the Server resource to return. + * view: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "nextPageToken": "my_nextPageToken", + * // "servers": [], + * // "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$Servers$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Servers$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Servers$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Servers$List, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Servers$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/servers').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 parameters of a single Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.patch({ + * // Identifier. name of resource + * name: 'projects/my-project/locations/my-location/servers/my-server', + * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + * requestId: 'placeholder-value', + * // Optional. Field mask is used to specify the fields to be overwritten in the Server resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "accessType": "my_accessType", + * // "createTime": "my_createTime", + * // "displayName": "my_displayName", + * // "externalConfig": {}, + * // "googleManagedServerCredential": {}, + * // "internalConfig": {}, + * // "labels": {}, + * // "name": "my_name", + * // "serviceAgent": "my_serviceAgent", + * // "state": "my_state", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * 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. + */ + patch( + params: Params$Resource$Projects$Locations$Servers$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Projects$Locations$Servers$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Projects$Locations$Servers$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Servers$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Servers$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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); + } + } + + /** + * Starts a stopping/stopped Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.start({ + * // Required. Name of the resource Format: `projects/{project\}/locations/{location\}/servers/{server\}` + * name: 'projects/my-project/locations/my-location/servers/my-server', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // {} + * }, + * }); + * 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. + */ + start( + params: Params$Resource$Projects$Locations$Servers$Start, + options: StreamMethodOptions + ): Promise>; + start( + params?: Params$Resource$Projects$Locations$Servers$Start, + options?: MethodOptions + ): Promise>; + start( + params: Params$Resource$Projects$Locations$Servers$Start, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + start( + params: Params$Resource$Projects$Locations$Servers$Start, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + start( + params: Params$Resource$Projects$Locations$Servers$Start, + callback: BodyResponseCallback + ): void; + start(callback: BodyResponseCallback): void; + start( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Start + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Start; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Start; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}:start').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); + } + } + + /** + * Stops an active Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.stop({ + * // Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/servers/{server\}` + * name: 'projects/my-project/locations/my-location/servers/my-server', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // {} + * }, + * }); + * 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. + */ + stop( + params: Params$Resource$Projects$Locations$Servers$Stop, + options: StreamMethodOptions + ): Promise>; + stop( + params?: Params$Resource$Projects$Locations$Servers$Stop, + options?: MethodOptions + ): Promise>; + stop( + params: Params$Resource$Projects$Locations$Servers$Stop, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + stop( + params: Params$Resource$Projects$Locations$Servers$Stop, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + stop( + params: Params$Resource$Projects$Locations$Servers$Stop, + callback: BodyResponseCallback + ): void; + stop(callback: BodyResponseCallback): void; + stop( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Stop + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Stop; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Stop; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+name}:stop').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$Servers$Create extends StandardParameters { + /** + * Required. Value for parent. + */ + parent?: string; + /** + * Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + */ + requestId?: string; + /** + * Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC + */ + serverId?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$Server; + } + export interface Params$Resource$Projects$Locations$Servers$Delete extends StandardParameters { + /** + * Required. Name of the resource + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Get extends StandardParameters { + /** + * Required. Name of the resource + */ + name?: string; + /** + * Optional. The view of the Server resource to return. + */ + view?: string; + } + export interface Params$Resource$Projects$Locations$Servers$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 value for ListServersRequest + */ + parent?: string; + /** + * Optional. The view of the Server resource to return. + */ + view?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Patch extends StandardParameters { + /** + * Identifier. name of resource + */ + name?: string; + /** + * Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + */ + requestId?: string; + /** + * Optional. Field mask is used to specify the fields to be overwritten in the Server resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$Server; + } + export interface Params$Resource$Projects$Locations$Servers$Start extends StandardParameters { + /** + * Required. Name of the resource Format: `projects/{project\}/locations/{location\}/servers/{server\}` + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$StartServerRequest; + } + export interface Params$Resource$Projects$Locations$Servers$Stop extends StandardParameters { + /** + * Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/servers/{server\}` + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$StopServerRequest; + } + + export class Resource$Projects$Locations$Servers$Users { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates a new User in a given project and location and Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.create({ + * // Required. Value for parent. + * parent: 'projects/my-project/locations/my-location/servers/my-server', + * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + * requestId: 'placeholder-value', + * // Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC + * userId: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "createTime": "my_createTime", + * // "customerServiceAccount": "my_customerServiceAccount", + * // "labels": {}, + * // "name": "my_name", + * // "state": "my_state", + * // "storageDirectoryMappings": [], + * // "updateTime": "my_updateTime", + * // "userCredentials": [], + * // "username": "my_username" + * // } + * }, + * }); + * 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. + */ + create( + params: Params$Resource$Projects$Locations$Servers$Users$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Projects$Locations$Servers$Users$Create, + options?: MethodOptions + ): Promise>; + create( + params: Params$Resource$Projects$Locations$Servers$Users$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Servers$Users$Create, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Servers$Users$Create, + callback: BodyResponseCallback + ): void; + create(callback: BodyResponseCallback): void; + create( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/users').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 single User. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.delete({ + * // Optional. If set to true, the request will force the deletion of the User. + * force: 'placeholder-value', + * // Required. Name of the resource + * name: 'projects/my-project/locations/my-location/servers/my-server/users/my-user', + * }); + * 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. + */ + delete( + params: Params$Resource$Projects$Locations$Servers$Users$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Projects$Locations$Servers$Users$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Servers$Users$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Servers$Users$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Servers$Users$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 details of a single User. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.get({ + * // Required. Name of the resource + * name: 'projects/my-project/locations/my-location/servers/my-server/users/my-user', + * // Optional. The view of the User resource to return. + * view: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "createTime": "my_createTime", + * // "customerServiceAccount": "my_customerServiceAccount", + * // "labels": {}, + * // "name": "my_name", + * // "state": "my_state", + * // "storageDirectoryMappings": [], + * // "updateTime": "my_updateTime", + * // "userCredentials": [], + * // "username": "my_username" + * // } + * } + * + * 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$Servers$Users$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Servers$Users$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Servers$Users$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Servers$Users$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Servers$Users$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 Users in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.list({ + * // Optional. Filtering results + * filter: 'placeholder-value', + * // Optional. Hint for how to order the results + * orderBy: 'placeholder-value', + * // Optional. Requested page size. User may return fewer items than requested. The maximum value is 1000; The default value is 50 if the field is omitted (or set to 0). + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the user should return. + * pageToken: 'placeholder-value', + * // Required. Parent value for ListUsersRequest + * parent: 'projects/my-project/locations/my-location/servers/my-server', + * // Optional. The view of the User resource to return. + * view: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "nextPageToken": "my_nextPageToken", + * // "unreachable": [], + * // "users": [] + * // } + * } + * + * 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$Servers$Users$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Servers$Users$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Servers$Users$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Servers$Users$List, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Servers$Users$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/users').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 parameters of a single User. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.patch({ + * // Identifier. User-friendly name via which User will be identified. projects/{project\}/locations/{location\}/servers/{server\}/users/{user\} + * name: 'projects/my-project/locations/my-location/servers/my-server/users/my-user', + * // Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "createTime": "my_createTime", + * // "customerServiceAccount": "my_customerServiceAccount", + * // "labels": {}, + * // "name": "my_name", + * // "state": "my_state", + * // "storageDirectoryMappings": [], + * // "updateTime": "my_updateTime", + * // "userCredentials": [], + * // "username": "my_username" + * // } + * }, + * }); + * 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. + */ + patch( + params: Params$Resource$Projects$Locations$Servers$Users$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Projects$Locations$Servers$Users$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Projects$Locations$Servers$Users$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Servers$Users$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Servers$Users$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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$Projects$Locations$Servers$Users$Create extends StandardParameters { + /** + * Required. Value for parent. + */ + parent?: string; + /** + * Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + */ + requestId?: string; + /** + * Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC + */ + userId?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$User; + } + export interface Params$Resource$Projects$Locations$Servers$Users$Delete extends StandardParameters { + /** + * Optional. If set to true, the request will force the deletion of the User. + */ + force?: boolean; + /** + * Required. Name of the resource + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Users$Get extends StandardParameters { + /** + * Required. Name of the resource + */ + name?: string; + /** + * Optional. The view of the User resource to return. + */ + view?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Users$List extends StandardParameters { + /** + * Optional. Filtering results + */ + filter?: string; + /** + * Optional. Hint for how to order the results + */ + orderBy?: string; + /** + * Optional. Requested page size. User may return fewer items than requested. The maximum value is 1000; The default value is 50 if the field is omitted (or set to 0). + */ + pageSize?: number; + /** + * Optional. A token identifying a page of results the user should return. + */ + pageToken?: string; + /** + * Required. Parent value for ListUsersRequest + */ + parent?: string; + /** + * Optional. The view of the User resource to return. + */ + view?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Users$Patch extends StandardParameters { + /** + * Identifier. User-friendly name via which User will be identified. projects/{project\}/locations/{location\}/servers/{server\}/users/{user\} + */ + name?: string; + /** + * Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$User; + } +} diff --git a/src/apis/ftp/v1alpha.ts b/src/apis/ftp/v1alpha.ts new file mode 100644 index 00000000000..bee89cc5d1a --- /dev/null +++ b/src/apis/ftp/v1alpha.ts @@ -0,0 +1,3455 @@ +// Copyright 2020 Google LLC +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +/* eslint-disable @typescript-eslint/no-explicit-any */ +/* eslint-disable @typescript-eslint/no-unused-vars */ +/* eslint-disable @typescript-eslint/no-empty-interface */ +/* eslint-disable @typescript-eslint/no-namespace */ +/* eslint-disable no-irregular-whitespace */ + +import { + OAuth2Client, + JWT, + Compute, + UserRefreshClient, + BaseExternalAccountClient, + GaxiosResponseWithHTTP2, + GoogleConfigurable, + createAPIRequest, + MethodOptions, + StreamMethodOptions, + GlobalOptions, + GoogleAuth, + BodyResponseCallback, + APIRequestContext, +} from 'googleapis-common'; +import {Readable} from 'stream'; + +export namespace ftp_v1alpha { + export interface Options extends GlobalOptions { + version: 'v1alpha'; + } + + interface StandardParameters { + /** + * Auth client or API Key for the request + */ + auth?: + | string + | OAuth2Client + | JWT + | Compute + | UserRefreshClient + | BaseExternalAccountClient + | GoogleAuth; + + /** + * V1 error format. + */ + '$.xgafv'?: string; + /** + * OAuth access token. + */ + access_token?: string; + /** + * Data format for response. + */ + alt?: string; + /** + * JSONP + */ + callback?: string; + /** + * Selector specifying which fields to include in a partial response. + */ + fields?: string; + /** + * API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. + */ + key?: string; + /** + * OAuth 2.0 token for the current user. + */ + oauth_token?: string; + /** + * Returns response with indentations and line breaks. + */ + prettyPrint?: boolean; + /** + * Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. + */ + quotaUser?: string; + /** + * Legacy upload protocol for media (e.g. "media", "multipart"). + */ + uploadType?: string; + /** + * Upload protocol for media (e.g. "raw", "multipart"). + */ + upload_protocol?: string; + } + + /** + * Cloud FTP API + * + * Cloud FTP is a managed service that allows transferring files directly to Google Cloud Storage using SFTP. + * + * @example + * ```js + * const {google} = require('googleapis'); + * const ftp = google.ftp('v1alpha'); + * ``` + */ + export class Ftp { + context: APIRequestContext; + projects: Resource$Projects; + + constructor(options: GlobalOptions, google?: GoogleConfigurable) { + this.context = { + _options: options || {}, + google, + }; + + this.projects = new Resource$Projects(this.context); + } + } + + /** + * A consumer project or network that is permitted to connect to the server via PSC. + */ + export interface Schema$AllowedConsumer { + /** + * Required. The connection limit for the consumer. Value must be greater than 0. + */ + connectionLimit?: string | null; + /** + * The project ID or number of the consumer project. Must be in the format: `projects/{project\}`. + */ + project?: string | null; + } + /** + * The request message for Operations.CancelOperation. + */ + export interface Schema$CancelOperationRequest {} + /** + * A consumer project or network that is denied to connect to the server via PSC. + */ + export interface Schema$DeniedConsumer { + /** + * The project ID or number of the consumer project. Must be in the format: `projects/{project\}`. + */ + project?: 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 {} + /** + * Configuration for external server. + */ + export interface Schema$ExternalServerConfig { + /** + * Optional. List of CIDR blocks that are allowed to access the Server. A CIDR range consists of an IP Address and a prefix length to construct the subnet mask. By default, the prefix length is 32 (i.e. matches a single IP address). For now, only IPV4 addresses are supported. Examples: "203.0.113.0/24" - matches with the IP addresses in the range 203.0.113.0 - 203.0.113.255. "0.0.0.0/0" - matches against any IP address. This field must contain at least one entry if the access type is EXTERNAL. The number of allowed CIDR blocks cannot exceed 500. Example: 192.168.0.0/16 + */ + allowedCidrBlocks?: string[] | null; + /** + * Output only. IP address of the LB via which clients will connect. + */ + ipAddress?: string | null; + } + /** + * Configuration for private server accessible via PSC. + */ + export interface Schema$InternalServerConfig { + /** + * Required. A list of projects that are permitted to connect. At least one project is required in the allow list. + */ + consumerAcceptList?: Schema$AllowedConsumer[]; + /** + * Optional. A list of projects that are denied connection. Format: "projects/sample_project_id" or "projects/1234567890" Projects in this list will be denied access, even if they are included in the `allow_list`. If this list is empty, no projects are explicitly rejected. + */ + consumerRejectList?: Schema$DeniedConsumer[]; + /** + * Output only. Details of endpoints created by the customer. + */ + pscEndpoints?: Schema$PscEndpoint[]; + /** + * Output only. The resource name of the service attachment. Format: `projects/{project\}/regions/{region\}/serviceAttachments/{service_attachment\}` + */ + serviceAttachment?: string | 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; + } + /** + * The response message for Operations.ListOperations. + */ + export interface Schema$ListOperationsResponse { + /** + * The standard List next-page token. + */ + nextPageToken?: string | null; + /** + * A list of operations that matches the specified filter in the request. + */ + operations?: Schema$Operation[]; + /** + * 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; + } + /** + * Message for response to listing Servers + */ + export interface Schema$ListServersResponse { + /** + * A token identifying a page of results the server should return. + */ + nextPageToken?: string | null; + /** + * The list of Server + */ + servers?: Schema$Server[]; + /** + * Unordered list. Locations that could not be reached. + */ + unreachable?: string[] | null; + } + /** + * Message for response to listing Users + */ + export interface Schema$ListUsersResponse { + /** + * A token identifying a page of results the user should return. + */ + nextPageToken?: string | null; + /** + * Unordered list. Locations that could not be reached. + */ + unreachable?: string[] | null; + /** + * The list of User + */ + users?: Schema$User[]; + } + /** + * 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; + } + /** + * This resource represents a long-running operation that is the result of a network API call. + */ + export interface Schema$Operation { + /** + * If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. + */ + done?: boolean | null; + /** + * The error result of the operation in case of failure or cancellation. + */ + error?: Schema$Status; + /** + * Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any. + */ + metadata?: {[key: string]: any} | null; + /** + * The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id\}`. + */ + name?: string | null; + /** + * The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`. + */ + response?: {[key: string]: any} | null; + } + /** + * 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 been cancelled successfully have google.longrunning.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; + } + /** + * Details of PSC endpoint created by customer. + */ + export interface Schema$PscEndpoint { + /** + * Output only. This is a Resource name for Private Service Connect endpoint. Format: `projects/{project\}/regions/{region\}/forwardingRules/{forwarding_rule\}` + */ + endpoint?: string | null; + /** + * Output only. The consumer network. Format: `projects/{project\}/locations/{location\}/networks/{network\}` + */ + network?: string | null; + /** + * Output only. The status of the connected endpoint. + */ + status?: string | null; + } + /** + * Message describing Server object + */ + export interface Schema$Server { + /** + * Required. The access type of the Server. + */ + accessType?: string | null; + /** + * Output only. [Output only] Create time stamp + */ + createTime?: string | null; + /** + * Optional. Display name of the Server + */ + displayName?: string | null; + /** + * Configuration for external access. + */ + externalConfig?: Schema$ExternalServerConfig; + /** + * Output only. Credentials of the FTP Server. + */ + googleManagedServerCredential?: Schema$ServerCredential; + /** + * Configuration for internal access. + */ + internalConfig?: Schema$InternalServerConfig; + /** + * Optional. Labels as key value pairs + */ + labels?: {[key: string]: string} | null; + /** + * Identifier. name of resource + */ + name?: string | null; + /** + * Output only. Service agent used to access the customer bucket. + */ + serviceAgent?: string | null; + /** + * Output only. The state of the server. + */ + state?: string | null; + /** + * Output only. [Output only] Update time stamp + */ + updateTime?: string | null; + } + /** + * Represents credentials of an FTP Server. + */ + export interface Schema$ServerCredential { + /** + * Output only. Asymmetric algorithm used by the public key. Possible values (can be expanded in future): - ssh-ed25519 + */ + asymmetricAlgorithm?: string | null; + /** + * Output only. The fingerprint is a hash of the public key, and is displayed when clients access the server for the first time to verify the server's identity. + */ + fingerprint?: string | null; + } + /** + * Request message for starting a Server. + */ + export interface Schema$StartServerRequest {} + /** + * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). + */ + export interface Schema$Status { + /** + * The status code, which should be an enum value of google.rpc.Code. + */ + code?: number | null; + /** + * A list of messages that carry the error details. There is a common set of message types for APIs to use. + */ + details?: Array<{[key: string]: any}> | null; + /** + * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. + */ + message?: string | null; + } + /** + * Request message for stopping a Server. + */ + export interface Schema$StopServerRequest {} + /** + * Mapping of backing Cloud Storage path to the directory where the user lands in the SFTP server. If directory is not specified, it'll default to '/'. Eg 1 - (bucket_name: bucket, bucket_prefix: path1/path2, directory: /abc/def/username) The user will land at /abcd/def/username, and the view there will match that of /bucket/path1/path2. The user will not be aware of Cloud Storage prefix '/bucket/path1' and there will be no such directory in the view. Eg 2 - (bucket_name: bucket, bucket_prefix: path1/path2, directory: '') The user will land at '/', and the view there will match that of /bucket/path1/path2. The user will not be aware of Cloud Storage prefix '/bucket/path1/path2' and there will be no such directory in the view. + */ + export interface Schema$StorageDirectoryMapping { + /** + * Required. Name of the bucket. + */ + bucket?: string | null; + /** + * Optional. Prefix inside the bucket. + */ + bucketPrefix?: string | null; + /** + * Required. Directory where the user lands in the SFTP server. + */ + directory?: string | null; + /** + * Required. Permission to the bucket. + */ + permission?: string | null; + } + /** + * Message describing User object + */ + export interface Schema$User { + /** + * Output only. [Output only] Create time stamp + */ + createTime?: string | null; + /** + * Required. Service account in customer project attached to this SFTP User. + */ + customerServiceAccount?: string | null; + /** + * Optional. Labels as key value pairs + */ + labels?: {[key: string]: string} | null; + /** + * Identifier. User-friendly name via which User will be identified. projects/{project\}/locations/{location\}/servers/{server\}/users/{user\} + */ + name?: string | null; + /** + * Output only. Tracks user creation. + */ + state?: string | null; + /** + * Required. Mapping of Cloud Storage buckets to directories where the user will land in the SFTP server. + */ + storageDirectoryMappings?: Schema$StorageDirectoryMapping[]; + /** + * Output only. [Output only] Update time stamp + */ + updateTime?: string | null; + /** + * Required. User credential for the user. The maximum number of user credentials is 10. + */ + userCredentials?: Schema$UserCredential[]; + /** + * Output only. [Output only] The username of the user. + */ + username?: string | null; + } + /** + * Message describing UserCredential object + */ + export interface Schema$UserCredential { + /** + * Required. Name of the user credential. + */ + credentialName?: string | null; + /** + * Required. Type of credential. + */ + credentialType?: string | null; + /** + * Optional. SSH public key body in OpenSSH format. Example: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ..." + */ + sshPublicKeyBody?: string | null; + } + + export class Resource$Projects { + context: APIRequestContext; + locations: Resource$Projects$Locations; + constructor(context: APIRequestContext) { + this.context = context; + this.locations = new Resource$Projects$Locations(this.context); + } + } + + export class Resource$Projects$Locations { + context: APIRequestContext; + operations: Resource$Projects$Locations$Operations; + servers: Resource$Projects$Locations$Servers; + constructor(context: APIRequestContext) { + this.context = context; + this.operations = new Resource$Projects$Locations$Operations( + this.context + ); + this.servers = new Resource$Projects$Locations$Servers(this.context); + } + + /** + * Gets information about a location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.get({ + * // Resource name for the location. + * name: 'projects/my-project/locations/my-location', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "displayName": "my_displayName", + * // "labels": {}, + * // "locationId": "my_locationId", + * // "metadata": {}, + * // "name": "my_name" + * // } + * } + * + * 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$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 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: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.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', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "locations": [], + * // "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$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$List, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}/locations').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$Get extends StandardParameters { + /** + * Resource name for the location. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$List extends StandardParameters { + /** + * Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage. + */ + extraLocationTypes?: string[]; + /** + * 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?: string; + /** + * The resource that owns the locations collection, if applicable. + */ + name?: string; + /** + * The maximum number of results to return. If not set, the service selects a default. + */ + pageSize?: number; + /** + * A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page. + */ + pageToken?: string; + } + + export class Resource$Projects$Locations$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/ftp.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 ftp = google.ftp('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 ftp.projects.locations.operations.cancel({ + * // The name of the operation resource to be cancelled. + * name: 'projects/my-project/locations/my-location/operations/my-operation', + * + * // 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. + */ + cancel( + params: Params$Resource$Projects$Locations$Operations$Cancel, + options: StreamMethodOptions + ): Promise>; + cancel( + params?: Params$Resource$Projects$Locations$Operations$Cancel, + options?: MethodOptions + ): Promise>; + cancel( + params: Params$Resource$Projects$Locations$Operations$Cancel, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + cancel( + params: Params$Resource$Projects$Locations$Operations$Cancel, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + cancel( + params: Params$Resource$Projects$Locations$Operations$Cancel, + callback: BodyResponseCallback + ): void; + cancel(callback: BodyResponseCallback): void; + cancel( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Operations$Cancel + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Operations$Cancel; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Operations$Cancel; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}:cancel').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); + } + } + + /** + * 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: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.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 => { + * 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$Projects$Locations$Operations$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Projects$Locations$Operations$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Operations$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Operations$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Operations$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Operations$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Operations$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Operations$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+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 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/ftp.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 ftp = google.ftp('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 ftp.projects.locations.operations.get({ + * // The name of the operation resource. + * name: 'projects/my-project/locations/my-location/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$Operations$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Operations$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Operations$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Operations$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Operations$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Operations$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Operations$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Operations$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 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: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.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 + * // { + * // "nextPageToken": "my_nextPageToken", + * // "operations": [], + * // "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$Operations$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Operations$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Operations$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Operations$List, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Operations$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Operations$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Operations$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Operations$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}/operations').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$Operations$Cancel extends StandardParameters { + /** + * The name of the operation resource to be cancelled. + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$CancelOperationRequest; + } + export interface Params$Resource$Projects$Locations$Operations$Delete extends StandardParameters { + /** + * The name of the operation resource to be deleted. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Operations$Get extends StandardParameters { + /** + * The name of the operation resource. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$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$Projects$Locations$Servers { + context: APIRequestContext; + users: Resource$Projects$Locations$Servers$Users; + constructor(context: APIRequestContext) { + this.context = context; + this.users = new Resource$Projects$Locations$Servers$Users(this.context); + } + + /** + * Creates a new Server in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.create({ + * // Required. Value for parent. + * parent: 'projects/my-project/locations/my-location', + * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + * requestId: 'placeholder-value', + * // Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC + * serverId: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "accessType": "my_accessType", + * // "createTime": "my_createTime", + * // "displayName": "my_displayName", + * // "externalConfig": {}, + * // "googleManagedServerCredential": {}, + * // "internalConfig": {}, + * // "labels": {}, + * // "name": "my_name", + * // "serviceAgent": "my_serviceAgent", + * // "state": "my_state", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * 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. + */ + create( + params: Params$Resource$Projects$Locations$Servers$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Projects$Locations$Servers$Create, + options?: MethodOptions + ): Promise>; + create( + params: Params$Resource$Projects$Locations$Servers$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Servers$Create, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Servers$Create, + callback: BodyResponseCallback + ): void; + create(callback: BodyResponseCallback): void; + create( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+parent}/servers').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 single Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.delete({ + * // Required. Name of the resource + * name: 'projects/my-project/locations/my-location/servers/my-server', + * }); + * 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. + */ + delete( + params: Params$Resource$Projects$Locations$Servers$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Projects$Locations$Servers$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Servers$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Servers$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Servers$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+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 details of a single Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.get({ + * // Required. Name of the resource + * name: 'projects/my-project/locations/my-location/servers/my-server', + * // Optional. The view of the Server resource to return. + * view: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "accessType": "my_accessType", + * // "createTime": "my_createTime", + * // "displayName": "my_displayName", + * // "externalConfig": {}, + * // "googleManagedServerCredential": {}, + * // "internalConfig": {}, + * // "labels": {}, + * // "name": "my_name", + * // "serviceAgent": "my_serviceAgent", + * // "state": "my_state", + * // "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$Servers$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Servers$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Servers$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Servers$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Servers$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 Servers in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.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 value for ListServersRequest + * parent: 'projects/my-project/locations/my-location', + * // Optional. The view of the Server resource to return. + * view: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "nextPageToken": "my_nextPageToken", + * // "servers": [], + * // "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$Servers$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Servers$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Servers$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Servers$List, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Servers$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+parent}/servers').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 parameters of a single Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.patch({ + * // Identifier. name of resource + * name: 'projects/my-project/locations/my-location/servers/my-server', + * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + * requestId: 'placeholder-value', + * // Optional. Field mask is used to specify the fields to be overwritten in the Server resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "accessType": "my_accessType", + * // "createTime": "my_createTime", + * // "displayName": "my_displayName", + * // "externalConfig": {}, + * // "googleManagedServerCredential": {}, + * // "internalConfig": {}, + * // "labels": {}, + * // "name": "my_name", + * // "serviceAgent": "my_serviceAgent", + * // "state": "my_state", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * 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. + */ + patch( + params: Params$Resource$Projects$Locations$Servers$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Projects$Locations$Servers$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Projects$Locations$Servers$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Servers$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Servers$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+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); + } + } + + /** + * Starts a stopping/stopped Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.start({ + * // Required. Name of the resource Format: `projects/{project\}/locations/{location\}/servers/{server\}` + * name: 'projects/my-project/locations/my-location/servers/my-server', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // {} + * }, + * }); + * 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. + */ + start( + params: Params$Resource$Projects$Locations$Servers$Start, + options: StreamMethodOptions + ): Promise>; + start( + params?: Params$Resource$Projects$Locations$Servers$Start, + options?: MethodOptions + ): Promise>; + start( + params: Params$Resource$Projects$Locations$Servers$Start, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + start( + params: Params$Resource$Projects$Locations$Servers$Start, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + start( + params: Params$Resource$Projects$Locations$Servers$Start, + callback: BodyResponseCallback + ): void; + start(callback: BodyResponseCallback): void; + start( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Start + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Start; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Start; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}:start').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); + } + } + + /** + * Stops an active Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.stop({ + * // Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/servers/{server\}` + * name: 'projects/my-project/locations/my-location/servers/my-server', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // {} + * }, + * }); + * 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. + */ + stop( + params: Params$Resource$Projects$Locations$Servers$Stop, + options: StreamMethodOptions + ): Promise>; + stop( + params?: Params$Resource$Projects$Locations$Servers$Stop, + options?: MethodOptions + ): Promise>; + stop( + params: Params$Resource$Projects$Locations$Servers$Stop, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + stop( + params: Params$Resource$Projects$Locations$Servers$Stop, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + stop( + params: Params$Resource$Projects$Locations$Servers$Stop, + callback: BodyResponseCallback + ): void; + stop(callback: BodyResponseCallback): void; + stop( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Stop + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Stop; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Stop; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+name}:stop').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$Servers$Create extends StandardParameters { + /** + * Required. Value for parent. + */ + parent?: string; + /** + * Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + */ + requestId?: string; + /** + * Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC + */ + serverId?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$Server; + } + export interface Params$Resource$Projects$Locations$Servers$Delete extends StandardParameters { + /** + * Required. Name of the resource + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Get extends StandardParameters { + /** + * Required. Name of the resource + */ + name?: string; + /** + * Optional. The view of the Server resource to return. + */ + view?: string; + } + export interface Params$Resource$Projects$Locations$Servers$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 value for ListServersRequest + */ + parent?: string; + /** + * Optional. The view of the Server resource to return. + */ + view?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Patch extends StandardParameters { + /** + * Identifier. name of resource + */ + name?: string; + /** + * Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + */ + requestId?: string; + /** + * Optional. Field mask is used to specify the fields to be overwritten in the Server resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$Server; + } + export interface Params$Resource$Projects$Locations$Servers$Start extends StandardParameters { + /** + * Required. Name of the resource Format: `projects/{project\}/locations/{location\}/servers/{server\}` + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$StartServerRequest; + } + export interface Params$Resource$Projects$Locations$Servers$Stop extends StandardParameters { + /** + * Required. Name of the resource. Format: `projects/{project\}/locations/{location\}/servers/{server\}` + */ + name?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$StopServerRequest; + } + + export class Resource$Projects$Locations$Servers$Users { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates a new User in a given project and location and Server. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.create({ + * // Required. Value for parent. + * parent: 'projects/my-project/locations/my-location/servers/my-server', + * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + * requestId: 'placeholder-value', + * // Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC + * userId: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "createTime": "my_createTime", + * // "customerServiceAccount": "my_customerServiceAccount", + * // "labels": {}, + * // "name": "my_name", + * // "state": "my_state", + * // "storageDirectoryMappings": [], + * // "updateTime": "my_updateTime", + * // "userCredentials": [], + * // "username": "my_username" + * // } + * }, + * }); + * 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. + */ + create( + params: Params$Resource$Projects$Locations$Servers$Users$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Projects$Locations$Servers$Users$Create, + options?: MethodOptions + ): Promise>; + create( + params: Params$Resource$Projects$Locations$Servers$Users$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Servers$Users$Create, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Servers$Users$Create, + callback: BodyResponseCallback + ): void; + create(callback: BodyResponseCallback): void; + create( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+parent}/users').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 single User. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.delete({ + * // Optional. If set to true, the request will force the deletion of the User. + * force: 'placeholder-value', + * // Required. Name of the resource + * name: 'projects/my-project/locations/my-location/servers/my-server/users/my-user', + * }); + * 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. + */ + delete( + params: Params$Resource$Projects$Locations$Servers$Users$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Projects$Locations$Servers$Users$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Servers$Users$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Servers$Users$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Servers$Users$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+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 details of a single User. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.get({ + * // Required. Name of the resource + * name: 'projects/my-project/locations/my-location/servers/my-server/users/my-user', + * // Optional. The view of the User resource to return. + * view: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "createTime": "my_createTime", + * // "customerServiceAccount": "my_customerServiceAccount", + * // "labels": {}, + * // "name": "my_name", + * // "state": "my_state", + * // "storageDirectoryMappings": [], + * // "updateTime": "my_updateTime", + * // "userCredentials": [], + * // "username": "my_username" + * // } + * } + * + * 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$Servers$Users$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Servers$Users$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Servers$Users$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Servers$Users$Get, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Servers$Users$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.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 Users in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.list({ + * // Optional. Filtering results + * filter: 'placeholder-value', + * // Optional. Hint for how to order the results + * orderBy: 'placeholder-value', + * // Optional. Requested page size. User may return fewer items than requested. The maximum value is 1000; The default value is 50 if the field is omitted (or set to 0). + * pageSize: 'placeholder-value', + * // Optional. A token identifying a page of results the user should return. + * pageToken: 'placeholder-value', + * // Required. Parent value for ListUsersRequest + * parent: 'projects/my-project/locations/my-location/servers/my-server', + * // Optional. The view of the User resource to return. + * view: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "nextPageToken": "my_nextPageToken", + * // "unreachable": [], + * // "users": [] + * // } + * } + * + * 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$Servers$Users$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Servers$Users$List, + options?: MethodOptions + ): Promise>; + list( + params: Params$Resource$Projects$Locations$Servers$Users$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Servers$Users$List, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Servers$Users$List, + callback: BodyResponseCallback + ): void; + list(callback: BodyResponseCallback): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+parent}/users').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 parameters of a single User. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/ftp.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 ftp = google.ftp('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 ftp.projects.locations.servers.users.patch({ + * // Identifier. User-friendly name via which User will be identified. projects/{project\}/locations/{location\}/servers/{server\}/users/{user\} + * name: 'projects/my-project/locations/my-location/servers/my-server/users/my-user', + * // Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "createTime": "my_createTime", + * // "customerServiceAccount": "my_customerServiceAccount", + * // "labels": {}, + * // "name": "my_name", + * // "state": "my_state", + * // "storageDirectoryMappings": [], + * // "updateTime": "my_updateTime", + * // "userCredentials": [], + * // "username": "my_username" + * // } + * }, + * }); + * 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. + */ + patch( + params: Params$Resource$Projects$Locations$Servers$Users$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Projects$Locations$Servers$Users$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Projects$Locations$Servers$Users$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Servers$Users$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Servers$Users$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Servers$Users$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Servers$Users$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Projects$Locations$Servers$Users$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://ftp.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1alpha/{+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$Projects$Locations$Servers$Users$Create extends StandardParameters { + /** + * Required. Value for parent. + */ + parent?: string; + /** + * Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). + */ + requestId?: string; + /** + * Required. Id of the requesting object If auto-generating Id server-side, remove this field and server_id from the method_signature of Create RPC + */ + userId?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$User; + } + export interface Params$Resource$Projects$Locations$Servers$Users$Delete extends StandardParameters { + /** + * Optional. If set to true, the request will force the deletion of the User. + */ + force?: boolean; + /** + * Required. Name of the resource + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Users$Get extends StandardParameters { + /** + * Required. Name of the resource + */ + name?: string; + /** + * Optional. The view of the User resource to return. + */ + view?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Users$List extends StandardParameters { + /** + * Optional. Filtering results + */ + filter?: string; + /** + * Optional. Hint for how to order the results + */ + orderBy?: string; + /** + * Optional. Requested page size. User may return fewer items than requested. The maximum value is 1000; The default value is 50 if the field is omitted (or set to 0). + */ + pageSize?: number; + /** + * Optional. A token identifying a page of results the user should return. + */ + pageToken?: string; + /** + * Required. Parent value for ListUsersRequest + */ + parent?: string; + /** + * Optional. The view of the User resource to return. + */ + view?: string; + } + export interface Params$Resource$Projects$Locations$Servers$Users$Patch extends StandardParameters { + /** + * Identifier. User-friendly name via which User will be identified. projects/{project\}/locations/{location\}/servers/{server\}/users/{user\} + */ + name?: string; + /** + * Optional. Field mask is used to specify the fields to be overwritten in the User resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields present in the request will be overwritten. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$User; + } +} diff --git a/src/apis/ftp/webpack.config.js b/src/apis/ftp/webpack.config.js new file mode 100644 index 00000000000..918453175f9 --- /dev/null +++ b/src/apis/ftp/webpack.config.js @@ -0,0 +1,79 @@ +// Copyright 2019 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Use `npm run webpack` to produce Webpack bundle for this library. + +const path = require('path'); + +module.exports = { + entry: './index.ts', + resolve: { + extensions: ['.ts', '.js', '.json'], + fallback: { + crypto: false, + child_process: false, + fs: false, + http2: false, + buffer: 'browserify', + process: false, + os: false, + querystring: false, + path: false, + stream: 'stream-browserify', + url: false, + util: false, + zlib: false, + }, + }, + output: { + library: 'Ftp', + filename: 'ftp.min.js', + path: path.resolve(__dirname, 'dist'), + }, + module: { + rules: [ + { + test: /node_modules[\\/]google-auth-library[\\/]src[\\/]crypto[\\/]node[\\/]crypto/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]https-proxy-agent[\\/]/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]gcp-metadata[\\/]/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]gtoken[\\/]/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]pkginfo[\\/]/, + use: 'null-loader', + }, + { + test: /node_modules[\\/]semver[\\/]/, + use: 'null-loader', + }, + { + test: /\.ts$/, + use: 'ts-loader', + exclude: /node_modules/, + }, + ], + }, + mode: 'production', + plugins: [], +}; diff --git a/src/apis/gkehub/v1.ts b/src/apis/gkehub/v1.ts index 518771418ed..a2aaef0a1af 100644 --- a/src/apis/gkehub/v1.ts +++ b/src/apis/gkehub/v1.ts @@ -2949,7 +2949,7 @@ export namespace gkehub_v1 { predefinedRole?: string | null; } /** - * Rollout contains the Rollout metadata and configuration. Next ID: 28 + * Rollout contains the Rollout metadata and configuration. Next ID: 31 */ export interface Schema$Rollout { /** diff --git a/src/apis/gkehub/v1alpha.ts b/src/apis/gkehub/v1alpha.ts index 9e29bc20bb2..44c45823698 100644 --- a/src/apis/gkehub/v1alpha.ts +++ b/src/apis/gkehub/v1alpha.ts @@ -3182,7 +3182,7 @@ export namespace gkehub_v1alpha { predefinedRole?: string | null; } /** - * Rollout contains the Rollout metadata and configuration. Next ID: 28 + * Rollout contains the Rollout metadata and configuration. Next ID: 31 */ export interface Schema$Rollout { /** diff --git a/src/apis/gkehub/v1beta.ts b/src/apis/gkehub/v1beta.ts index d88af9bbe31..d229dbf27c1 100644 --- a/src/apis/gkehub/v1beta.ts +++ b/src/apis/gkehub/v1beta.ts @@ -3026,7 +3026,7 @@ export namespace gkehub_v1beta { predefinedRole?: string | null; } /** - * Rollout contains the Rollout metadata and configuration. Next ID: 28 + * Rollout contains the Rollout metadata and configuration. Next ID: 31 */ export interface Schema$Rollout { /** diff --git a/src/apis/health/v4.ts b/src/apis/health/v4.ts index 257047987ed..f6deab9b6bd 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 - `users/me/dataSourceFamilies/google-wearables` - tracker devices - `users/me/dataSourceFamilies/google-sources` - Google first party sources + * 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. */ dataSourceFamily?: string | null; /** @@ -948,6 +948,14 @@ export namespace health_v4 { * Optional. Data for points in the `irregular-rhythm-notification` session data type collection. */ irregularRhythmNotification?: Schema$IrregularRhythmNotification; + /** + * Optional. Data for points in the `menstrual-period` interval data type collection. + */ + menstrualPeriod?: Schema$MenstrualPeriod; + /** + * Optional. Data for points in the `moods` sample data type collection. + */ + 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. */ @@ -956,6 +964,10 @@ export namespace health_v4 { * Optional. Data for points in the `nutrition-log` session data type collection. */ nutritionLog?: Schema$NutritionLog; + /** + * Optional. Data for points in the `ovulation-test` sample data type collection. + */ + ovulationTest?: Schema$OvulationTest; /** * Optional. Data for points in the `oxygen-saturation` sample data type collection. */ @@ -984,6 +996,10 @@ export namespace health_v4 { * Optional. Data for points in the `swim-lengths-data` interval data type collection. */ swimLengthsData?: Schema$SwimLengthsData; + /** + * Optional. Data for points in the `symptoms` sample data type collection. + */ + symptoms?: Schema$Symptoms; /** * Optional. Data for points in the `time-in-heart-rate-zone` interval data type collection. */ @@ -1208,7 +1224,7 @@ export namespace health_v4 { */ createTime?: string | null; /** - * Required. Exercise display name. + * Required. The localized, human-readable name of the exercise. For all exercise types other than `OTHER`, the system ignores client input and overrides this field with a generated name based on `exercise_type` (e.g., "Walking" for `WALKING`). If `exercise_type` is `OTHER`, this field can contain the user's custom, free-form display name. */ displayName?: string | null; /** @@ -1806,6 +1822,19 @@ export namespace health_v4 { */ serviceVersion?: string | null; } + /** + * Menstrual period record. + */ + export interface Schema$MenstrualPeriod { + /** + * Required. Observed interval. + */ + interval?: Schema$ObservationTimeInterval; + /** + * Optional. Standard free-form notes captured at manual logging. + */ + notes?: string | null; + } /** * Summary metrics for an exercise. */ @@ -1884,6 +1913,23 @@ export namespace health_v4 { */ avgVerticalRatio?: number | null; } + /** + * Moods record. + */ + export interface Schema$Moods { + /** + * Required. The moods logged. + */ + moods?: string[] | null; + /** + * Required. The time at which moods were measured. + */ + sampleTime?: Schema$ObservationSampleTime; + /** + * Optional. The valences. + */ + valences?: string[] | null; + } /** * Represents the quantity of a nutrient. */ @@ -2072,6 +2118,19 @@ export namespace health_v4 { */ startUtcOffset?: string | null; } + /** + * Ovulation test record. + */ + export interface Schema$OvulationTest { + /** + * Required. The result of the ovulation test. + */ + result?: string | null; + /** + * Required. The time at which ovulation test was measured. + */ + sampleTime?: Schema$ObservationSampleTime; + } /** * Captures the user's instantaneous oxygen saturation percentage (SpO2). */ @@ -2470,7 +2529,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 - `users/me/dataSourceFamilies/google-wearables` - tracker devices - `users/me/dataSourceFamilies/google-sources` - Google first party sources + * 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. */ dataSourceFamily?: string | null; /** @@ -2606,7 +2665,7 @@ export namespace health_v4 { */ autoStrideEnabled?: boolean | null; /** - * Optional. The measurement unit defined in the user's account settings. Updates to this field are currently not supported. + * Optional. The measurement unit defined in the user's account settings. */ distanceUnit?: string | null; /** @@ -2682,6 +2741,10 @@ export namespace health_v4 { * Optional. “Out of bed” segments that can overlap with sleep stages. */ outOfBedSegments?: Schema$OutOfBedSegment[]; + /** + * Output only. List of short awake segments (under a set threshold) that are part of the sleep session. These can overlap with sleep stages. + */ + shortAwakenings?: Schema$SleepStage[]; /** * Optional. List of non-overlapping contiguous sleep stage segments that cover the sleep period. */ @@ -2968,6 +3031,19 @@ export namespace health_v4 { */ strokeCountSum?: string | null; } + /** + * Symptoms logged by the user. + */ + export interface Schema$Symptoms { + /** + * Required. Time when the symptoms were logged. + */ + sampleTime?: Schema$ObservationSampleTime; + /** + * Required. List of symptoms experienced. + */ + symptoms?: string[] | null; + } /** * Time in heart rate zone record. It's an interval spent in specific heart rate zone. */ @@ -6003,8 +6079,11 @@ export namespace health_v4 { * // "height": {}, * // "hydrationLog": {}, * // "irregularRhythmNotification": {}, + * // "menstrualPeriod": {}, + * // "moods": {}, * // "name": "my_name", * // "nutritionLog": {}, + * // "ovulationTest": {}, * // "oxygenSaturation": {}, * // "respiratoryRateSleepSummary": {}, * // "runVo2Max": {}, @@ -6012,6 +6091,7 @@ export namespace health_v4 { * // "sleep": {}, * // "steps": {}, * // "swimLengthsData": {}, + * // "symptoms": {}, * // "timeInHeartRateZone": {}, * // "vo2Max": {}, * // "weight": {} @@ -6501,8 +6581,11 @@ export namespace health_v4 { * // "height": {}, * // "hydrationLog": {}, * // "irregularRhythmNotification": {}, + * // "menstrualPeriod": {}, + * // "moods": {}, * // "name": "my_name", * // "nutritionLog": {}, + * // "ovulationTest": {}, * // "oxygenSaturation": {}, * // "respiratoryRateSleepSummary": {}, * // "runVo2Max": {}, @@ -6510,6 +6593,7 @@ export namespace health_v4 { * // "sleep": {}, * // "steps": {}, * // "swimLengthsData": {}, + * // "symptoms": {}, * // "timeInHeartRateZone": {}, * // "vo2Max": {}, * // "weight": {} @@ -6832,8 +6916,11 @@ export namespace health_v4 { * // "height": {}, * // "hydrationLog": {}, * // "irregularRhythmNotification": {}, + * // "menstrualPeriod": {}, + * // "moods": {}, * // "name": "my_name", * // "nutritionLog": {}, + * // "ovulationTest": {}, * // "oxygenSaturation": {}, * // "respiratoryRateSleepSummary": {}, * // "runVo2Max": {}, @@ -6841,6 +6928,7 @@ export namespace health_v4 { * // "sleep": {}, * // "steps": {}, * // "swimLengthsData": {}, + * // "symptoms": {}, * // "timeInHeartRateZone": {}, * // "vo2Max": {}, * // "weight": {} @@ -6974,9 +7062,17 @@ export namespace health_v4 { * // Scopes can be specified either as an array or as a single, space-delimited string. * scopes: [ * 'https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly', + * 'https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly', * 'https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly', + * 'https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly', * 'https://www.googleapis.com/auth/googlehealth.location.readonly', + * 'https://www.googleapis.com/auth/googlehealth.location.writeonly', + * 'https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly', + * 'https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly', + * 'https://www.googleapis.com/auth/googlehealth.nutrition.writeonly', + * 'https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly', * 'https://www.googleapis.com/auth/googlehealth.sleep.readonly', + * 'https://www.googleapis.com/auth/googlehealth.sleep.writeonly', * ], * }); * @@ -6986,7 +7082,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\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - default value - `users/me/dataSourceFamilies/google-wearables` - tracker devices - `users/me/dataSourceFamilies/google-sources` - Google first party sources + * // 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. * 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', @@ -7344,7 +7440,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\}` The supported values are: - `users/me/dataSourceFamilies/all-sources` - default value - `users/me/dataSourceFamilies/google-wearables` - tracker devices - `users/me/dataSourceFamilies/google-sources` - Google first party sources + * 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. */ dataSourceFamily?: string; /** diff --git a/src/apis/homegraph/v1.ts b/src/apis/homegraph/v1.ts index 0006b2a58e7..23d249304ec 100644 --- a/src/apis/homegraph/v1.ts +++ b/src/apis/homegraph/v1.ts @@ -148,6 +148,27 @@ export namespace homegraph_v1 { */ deviceId?: string | null; } + /** + * This cluster defines the camera event stream used by GHP for their Cloud-to-Cloud eventing flow + */ + export interface Schema$CameraEventStreamTrait {} + /** + * Common camera event data. + */ + export interface Schema$CommonEventDataStruct { + /** + * Contains media urls for the event + */ + mediaUrls?: Schema$MediaUrlsStruct; + /** + * Camera event session id. Used for identifying a unique event session + */ + sessionId?: string | null; + /** + * Id of the track this object belongs to + */ + trackId?: string | null; + } /** * Component of a provider device. */ @@ -235,6 +256,15 @@ export namespace homegraph_v1 { */ willReportState?: boolean | null; } + /** + * Contains metadata about the cause of presence state change attributed to a device. + */ + export interface Schema$DeviceBlameStruct { + /** + * Required. Specifies the device blame type. + */ + blameType?: string | null; + } /** * Device information. */ @@ -316,6 +346,34 @@ export namespace homegraph_v1 { */ events?: Schema$EventData[]; } + export interface Schema$EveUtilityTrait { + /** + * Required. Output only. Accepted command list for this trait + */ + acceptedCommandList?: string[] | null; + accumulatedControlPoint?: string | null; + airPressure?: number | null; + altitude?: number | null; + childLock?: boolean | null; + current?: number | null; + getConfig?: string | null; + holdPosition?: boolean | null; + lastEventTime?: string | null; + loggingControlPoint?: string | null; + loggingData?: string | null; + loggingMetadata?: string | null; + loggingTime?: string | null; + motionSensitivity?: number | null; + obstructionDetected?: boolean | null; + openCount?: string | null; + rloc16?: number | null; + setConfig?: string | null; + statusFault?: number | null; + voltage?: number | null; + watt?: number | null; + wattAccumulated?: number | null; + weatherTrend?: number | null; + } /** * Contains the set of events for an item. */ @@ -351,6 +409,56 @@ export namespace homegraph_v1 { */ deviceId?: string | null; } + export interface Schema$MediaUrlsStruct { + /** + * URL for a dash manifest for playback + */ + dashManifestUrl?: string | null; + /** + * URL for a hls master playlist for playback + */ + hlsMasterPlaylistUrl?: string | null; + /** + * URL for animated preview clip representing the event session + */ + previewUrl?: string | null; + /** + * URL for thumbnail image representing the event session + */ + thumbnailUrl?: string | null; + } + /** + * Represents a newly detected motion event. + */ + export interface Schema$MotionEvent { + commonEventData?: Schema$CommonEventDataStruct; + /** + * Zones where events are detected in. + */ + zones?: Schema$ZoneStruct[]; + /** + * If set, zones is an empty list. + */ + zonesIsEmpty?: boolean | null; + } + /** + * Provides attributes and events related to partner presence signals. See PartnerPresenceSignal trait: + */ + export interface Schema$PartnerPresenceSignalTrait {} + /** + * Represents a newly detected person event. + */ + export interface Schema$PersonEvent { + commonEventData?: Schema$CommonEventDataStruct; + /** + * Zones where events are detected in. + */ + zones?: Schema$ZoneStruct[]; + /** + * If set, zones is an empty list. + */ + zonesIsEmpty?: boolean | null; + } /** * Request type for the [`Query`](#google.home.graph.v1.HomeGraphApiService.Query) call. */ @@ -518,6 +626,32 @@ export namespace homegraph_v1 { */ devices?: Schema$ReportStateAndNotificationDevice; } + /** + * Sent when the structure presence state changes. + */ + export interface Schema$StructurePresenceStateChangeEvent { + /** + * Required. Specifies the presence state. + */ + presenceState?: string | null; + /** + * Optional. Specifies the presence state change reason. + */ + reason?: Schema$StructurePresenceStateChangeReasonStruct; + } + /** + * Contains the metadata about the cause of the structure presence state change. + */ + export interface Schema$StructurePresenceStateChangeReasonStruct { + /** + * Optional. Contains metadata about the cause of presence state change attributed to a device. + */ + deviceBlame?: Schema$DeviceBlameStruct; + /** + * Optional. Contains metadata about the cause of presence state change attributed to a user. + */ + userBlame?: Schema$UserBlameStruct; + } /** * Request type for the [`Sync`](#google.home.graph.v1.HomeGraphApiService.Sync) call. */ @@ -557,6 +691,14 @@ export namespace homegraph_v1 { */ devices?: Schema$Device[]; } + /** + * This cluster provides fan control capabilities for thermostats. + */ + export interface Schema$ThermostatFanControlTrait { + timerDuration?: string | null; + timerEnd?: string | null; + timerSpeed?: string | null; + } /** * Contains the trait payload for a single trait. */ @@ -574,6 +716,29 @@ export namespace homegraph_v1 { */ trait?: {[key: string]: any} | null; } + /** + * Contains metadata about the cause of presence state change attributed to a user. + */ + export interface Schema$UserBlameStruct { + /** + * Required. Specifies the user blame type. + */ + blameType?: string | null; + /** + * Required. Specifies the email of the user. + */ + userEmail?: string | null; + } + export interface Schema$ZoneStruct { + /** + * Name of the zone. + */ + label?: string | null; + /** + * Id of the zone + */ + zoneId?: string | null; + } export class Resource$Agentusers { context: APIRequestContext; diff --git a/src/apis/index.ts b/src/apis/index.ts index ba9d0720560..d8096148182 100644 --- a/src/apis/index.ts +++ b/src/apis/index.ts @@ -87,6 +87,10 @@ import { VERSIONS as analyticsreportingVersions, analyticsreporting, } from './analyticsreporting'; +import { + VERSIONS as androiddeveloperidstatusVersions, + androiddeveloperidstatus, +} from './androiddeveloperidstatus'; import { VERSIONS as androiddeviceprovisioningVersions, androiddeviceprovisioning, @@ -414,6 +418,7 @@ import { import {VERSIONS as firestoreVersions, firestore} from './firestore'; import {VERSIONS as fitnessVersions, fitness} from './fitness'; import {VERSIONS as formsVersions, forms} from './forms'; +import {VERSIONS as ftpVersions, ftp} from './ftp'; import {VERSIONS as gamesVersions, games} from './games'; import { VERSIONS as gamesConfigurationVersions, @@ -848,6 +853,7 @@ export const APIS: APIList = { analyticsdata: analyticsdataVersions, analyticshub: analyticshubVersions, analyticsreporting: analyticsreportingVersions, + androiddeveloperidstatus: androiddeveloperidstatusVersions, androiddeviceprovisioning: androiddeviceprovisioningVersions, androidenterprise: androidenterpriseVersions, androidmanagement: androidmanagementVersions, @@ -986,6 +992,7 @@ export const APIS: APIList = { firestore: firestoreVersions, fitness: fitnessVersions, forms: formsVersions, + ftp: ftpVersions, games: gamesVersions, gamesConfiguration: gamesConfigurationVersions, gamesManagement: gamesManagementVersions, @@ -1182,6 +1189,7 @@ export class GeneratedAPIs { analyticsdata = analyticsdata; analyticshub = analyticshub; analyticsreporting = analyticsreporting; + androiddeveloperidstatus = androiddeveloperidstatus; androiddeviceprovisioning = androiddeviceprovisioning; androidenterprise = androidenterprise; androidmanagement = androidmanagement; @@ -1320,6 +1328,7 @@ export class GeneratedAPIs { firestore = firestore; fitness = fitness; forms = forms; + ftp = ftp; games = games; gamesConfiguration = gamesConfiguration; gamesManagement = gamesManagement; diff --git a/src/apis/looker/v1.ts b/src/apis/looker/v1.ts index 93d93cb3338..3c6a5e862be 100644 --- a/src/apis/looker/v1.ts +++ b/src/apis/looker/v1.ts @@ -541,11 +541,11 @@ export namespace looker_v1 { */ export interface Schema$ListInstancesResponse { /** - * The list of instances matching the request filters, up to the requested ListInstancesRequest.pageSize. + * The list of instances matching the request filters, up to the requested `pageSize`. */ instances?: Schema$Instance[]; /** - * If provided, a page token that can look up the next ListInstancesRequest.pageSize results. If empty, the results list is exhausted. + * If provided, a page token that can look up the next `pageSize` results. If empty, the results list is exhausted. */ nextPageToken?: string | null; /** diff --git a/src/apis/merchantapi/index.ts b/src/apis/merchantapi/index.ts index 6e0e55329b8..7ea979cbf7c 100644 --- a/src/apis/merchantapi/index.ts +++ b/src/apis/merchantapi/index.ts @@ -26,6 +26,7 @@ import {merchantapi_issueresolution_v1} from './issueresolution_v1'; import {merchantapi_issueresolution_v1beta} from './issueresolution_v1beta'; import {merchantapi_lfp_v1} from './lfp_v1'; import {merchantapi_lfp_v1beta} from './lfp_v1beta'; +import {merchantapi_loyaltycustomers_v1} from './loyaltycustomers_v1'; import {merchantapi_notifications_v1} from './notifications_v1'; import {merchantapi_notifications_v1beta} from './notifications_v1beta'; import {merchantapi_ordertracking_v1} from './ordertracking_v1'; @@ -53,6 +54,7 @@ export const VERSIONS = { issueresolution_v1beta: merchantapi_issueresolution_v1beta.Merchantapi, lfp_v1: merchantapi_lfp_v1.Merchantapi, lfp_v1beta: merchantapi_lfp_v1beta.Merchantapi, + loyaltycustomers_v1: merchantapi_loyaltycustomers_v1.Merchantapi, notifications_v1: merchantapi_notifications_v1.Merchantapi, notifications_v1beta: merchantapi_notifications_v1beta.Merchantapi, ordertracking_v1: merchantapi_ordertracking_v1.Merchantapi, @@ -138,6 +140,12 @@ export function merchantapi( export function merchantapi( options: merchantapi_lfp_v1beta.Options ): merchantapi_lfp_v1beta.Merchantapi; +export function merchantapi( + version: 'loyaltycustomers_v1' +): merchantapi_loyaltycustomers_v1.Merchantapi; +export function merchantapi( + options: merchantapi_loyaltycustomers_v1.Options +): merchantapi_loyaltycustomers_v1.Merchantapi; export function merchantapi( version: 'notifications_v1' ): merchantapi_notifications_v1.Merchantapi; @@ -230,6 +238,7 @@ export function merchantapi< | merchantapi_issueresolution_v1beta.Merchantapi | merchantapi_lfp_v1.Merchantapi | merchantapi_lfp_v1beta.Merchantapi + | merchantapi_loyaltycustomers_v1.Merchantapi | merchantapi_notifications_v1.Merchantapi | merchantapi_notifications_v1beta.Merchantapi | merchantapi_ordertracking_v1.Merchantapi @@ -270,6 +279,8 @@ export function merchantapi< | merchantapi_lfp_v1.Options | 'lfp_v1beta' | merchantapi_lfp_v1beta.Options + | 'loyaltycustomers_v1' + | merchantapi_loyaltycustomers_v1.Options | 'notifications_v1' | merchantapi_notifications_v1.Options | 'notifications_v1beta' @@ -314,6 +325,7 @@ export {merchantapi_issueresolution_v1}; export {merchantapi_issueresolution_v1beta}; export {merchantapi_lfp_v1}; export {merchantapi_lfp_v1beta}; +export {merchantapi_loyaltycustomers_v1}; export {merchantapi_notifications_v1}; export {merchantapi_notifications_v1beta}; export {merchantapi_ordertracking_v1}; diff --git a/src/apis/merchantapi/loyaltycustomers_v1.ts b/src/apis/merchantapi/loyaltycustomers_v1.ts new file mode 100644 index 00000000000..92c5c322151 --- /dev/null +++ b/src/apis/merchantapi/loyaltycustomers_v1.ts @@ -0,0 +1,454 @@ +// Copyright 2020 Google LLC +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +/* eslint-disable @typescript-eslint/no-explicit-any */ +/* eslint-disable @typescript-eslint/no-unused-vars */ +/* eslint-disable @typescript-eslint/no-empty-interface */ +/* eslint-disable @typescript-eslint/no-namespace */ +/* eslint-disable no-irregular-whitespace */ + +import { + OAuth2Client, + JWT, + Compute, + UserRefreshClient, + BaseExternalAccountClient, + GaxiosResponseWithHTTP2, + GoogleConfigurable, + createAPIRequest, + MethodOptions, + StreamMethodOptions, + GlobalOptions, + GoogleAuth, + BodyResponseCallback, + APIRequestContext, +} from 'googleapis-common'; +import {Readable} from 'stream'; + +export namespace merchantapi_loyaltycustomers_v1 { + export interface Options extends GlobalOptions { + version: 'loyaltycustomers_v1'; + } + + interface StandardParameters { + /** + * Auth client or API Key for the request + */ + auth?: + | string + | OAuth2Client + | JWT + | Compute + | UserRefreshClient + | BaseExternalAccountClient + | GoogleAuth; + + /** + * V1 error format. + */ + '$.xgafv'?: string; + /** + * OAuth access token. + */ + access_token?: string; + /** + * Data format for response. + */ + alt?: string; + /** + * JSONP + */ + callback?: string; + /** + * Selector specifying which fields to include in a partial response. + */ + fields?: string; + /** + * API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. + */ + key?: string; + /** + * OAuth 2.0 token for the current user. + */ + oauth_token?: string; + /** + * Returns response with indentations and line breaks. + */ + prettyPrint?: boolean; + /** + * Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. + */ + quotaUser?: string; + /** + * Legacy upload protocol for media (e.g. "media", "multipart"). + */ + uploadType?: string; + /** + * Upload protocol for media (e.g. "raw", "multipart"). + */ + upload_protocol?: string; + } + + /** + * Merchant API + * + * Programmatically manage your Merchant Center Accounts. + * + * @example + * ```js + * const {google} = require('googleapis'); + * const merchantapi = google.merchantapi('loyaltycustomers_v1'); + * ``` + */ + export class Merchantapi { + context: APIRequestContext; + accounts: Resource$Accounts; + + constructor(options: GlobalOptions, google?: GoogleConfigurable) { + this.context = { + _options: options || {}, + google, + }; + + this.accounts = new Resource$Accounts(this.context); + } + } + + /** + * Represents a customer’s physical address. + */ + export interface Schema$AddressInfo { + /** + * Optional. The city of the customer. + */ + city?: string | null; + /** + * Optional. The family name of the customer. + */ + familyName?: string | null; + /** + * Optional. The given name of the customer. + */ + givenName?: string | null; + /** + * Optional. The postal code (zip code) of the customer. **Format Rules:** * **United States:** 5-digit zip codes (e.g., "94108"). + */ + postalCode?: string | null; + /** + * Optional. The Unicode country/region code (CLDR) of the customer, such as "US" or "CH". This field is case-insensitive. For more information, see https://cldr.unicode.org/ and https://www.unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html. + */ + regionCode?: string | null; + /** + * Optional. The state or province of the customer. + */ + state?: string | null; + } + /** + * Represents a customer’s loyalty information. Represents loyalty customer data in `ManageLoyaltyCustomerMatch` API, but is not a resource that can be retrieved or listed by other methods. + */ + export interface Schema$LoyaltyCustomer { + /** + * Required. The tier label of the loyalty tier the customer belongs to. + */ + loyaltyTier?: string | null; + /** + * Optional. The point balance of the loyalty customer. + */ + pointBalance?: string | null; + /** + * Required. The identifiers for the customer. + */ + userIdentifier?: Schema$UserIdentifier; + } + /** + * Request message for the ManageLoyaltyCustomerMatch method. + */ + export interface Schema$ManageLoyaltyCustomerMatchRequest { + /** + * Required. The loyalty customer to insert, update, or remove. + */ + loyaltyCustomer?: Schema$LoyaltyCustomer; + } + /** + * Response message for the ManageLoyaltyCustomerMatch method. + */ + export interface Schema$ManageLoyaltyCustomerMatchResponse { + /** + * The loyalty customer that was inserted, updated, or removed. If the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization, this field will contain a default `LoyaltyCustomer` instance. + */ + loyaltyCustomer?: Schema$LoyaltyCustomer; + } + /** + * The change that happened to the product including old value, new value, country code as the region code and reporting context. + */ + export interface Schema$ProductChange { + /** + * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``) + */ + newValue?: string | null; + /** + * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``) + */ + oldValue?: string | null; + /** + * Countries that have the change (if applicable). Represented in the ISO 3166 format. + */ + regionCode?: string | null; + /** + * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum) + */ + reportingContext?: string | null; + } + /** + * The message that the merchant will receive to notify about product status change event + */ + export interface Schema$ProductStatusChangeMessage { + /** + * The target account that owns the entity that changed. Format : `accounts/{merchant_id\}` + */ + account?: string | null; + /** + * The attribute in the resource that changed, in this case it will be always `Status`. + */ + attribute?: string | null; + /** + * A message to describe the change that happened to the product + */ + changes?: Schema$ProductChange[]; + /** + * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications. + */ + eventTime?: string | null; + /** + * Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event. + */ + expirationTime?: string | null; + /** + * The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id\}` + */ + managingAccount?: string | null; + /** + * The product name. Format: `accounts/{account\}/products/{product\}` + */ + resource?: string | null; + /** + * The product id. + */ + resourceId?: string | null; + /** + * The resource that changed, in this case it will always be `Product`. + */ + resourceType?: string | null; + } + /** + * The user identifiers associated with the customer. At least one of the fields within this message must be provided. + */ + export interface Schema$UserIdentifier { + /** + * Optional. The customer’s physical address. + */ + address?: Schema$AddressInfo; + /** + * Optional. The customer’s email address. + */ + emailAddress?: string | null; + /** + * Optional. The customer's phone number, in [E.164 format](https://support.google.com/google-ads/answer/16355235) (e.g., "+16502530000"). + */ + phoneNumber?: string | null; + } + + export class Resource$Accounts { + context: APIRequestContext; + loyaltyCustomers: Resource$Accounts$Loyaltycustomers; + constructor(context: APIRequestContext) { + this.context = context; + this.loyaltyCustomers = new Resource$Accounts$Loyaltycustomers( + this.context + ); + } + } + + export class Resource$Accounts$Loyaltycustomers { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('loyaltycustomers_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/content'], + * }); + * + * // 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 merchantapi.accounts.loyaltyCustomers.manage({ + * // Required. The parent account where this loyalty customer will be handled. Format: `accounts/{account\}` + * parent: 'accounts/my-account', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "loyaltyCustomer": {} + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "loyaltyCustomer": {} + * // } + * } + * + * 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. + */ + manage( + params: Params$Resource$Accounts$Loyaltycustomers$Manage, + options: StreamMethodOptions + ): Promise>; + manage( + params?: Params$Resource$Accounts$Loyaltycustomers$Manage, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + manage( + params: Params$Resource$Accounts$Loyaltycustomers$Manage, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + manage( + params: Params$Resource$Accounts$Loyaltycustomers$Manage, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + manage( + params: Params$Resource$Accounts$Loyaltycustomers$Manage, + callback: BodyResponseCallback + ): void; + manage( + callback: BodyResponseCallback + ): void; + manage( + paramsOrCallback?: + | Params$Resource$Accounts$Loyaltycustomers$Manage + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Accounts$Loyaltycustomers$Manage; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Accounts$Loyaltycustomers$Manage; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = options.rootUrl || 'https://merchantapi.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/loyaltyCustomers/v1/{+parent}/loyaltyCustomers:manage' + ).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 + ); + } + } + } + + export interface Params$Resource$Accounts$Loyaltycustomers$Manage extends StandardParameters { + /** + * Required. The parent account where this loyalty customer will be handled. Format: `accounts/{account\}` + */ + parent?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$ManageLoyaltyCustomerMatchRequest; + } +} diff --git a/src/apis/migrationcenter/v1.ts b/src/apis/migrationcenter/v1.ts index d2cba4799b3..ba1d2f35738 100644 --- a/src/apis/migrationcenter/v1.ts +++ b/src/apis/migrationcenter/v1.ts @@ -12325,7 +12325,7 @@ export namespace migrationcenter_v1 { * const res = await migrationcenter.projects.locations.reportConfigs.create({ * // Required. Value for parent. * parent: 'projects/my-project/locations/my-location', - * // Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: [a-z]([a-z0-9-]{0,61\}[a-z0-9])?. + * // Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`. * reportConfigId: 'placeholder-value', * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). * requestId: 'placeholder-value', @@ -12890,7 +12890,7 @@ export namespace migrationcenter_v1 { */ parent?: string; /** - * Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: [a-z]([a-z0-9-]{0,61\}[a-z0-9])?. + * Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`. */ reportConfigId?: string; /** @@ -12987,7 +12987,7 @@ export namespace migrationcenter_v1 { * // Required. Value for parent. * parent: * 'projects/my-project/locations/my-location/reportConfigs/my-reportConfig', - * // Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: [a-z]([a-z0-9-]{0,61\}[a-z0-9])?. + * // Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`. * reportId: 'placeholder-value', * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). * requestId: 'placeholder-value', @@ -13562,7 +13562,7 @@ export namespace migrationcenter_v1 { */ parent?: string; /** - * Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: [a-z]([a-z0-9-]{0,61\}[a-z0-9])?. + * Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`. */ reportId?: string; /** diff --git a/src/apis/migrationcenter/v1alpha1.ts b/src/apis/migrationcenter/v1alpha1.ts index 8698ab526fa..17200f4264e 100644 --- a/src/apis/migrationcenter/v1alpha1.ts +++ b/src/apis/migrationcenter/v1alpha1.ts @@ -1267,7 +1267,7 @@ export namespace migrationcenter_v1alpha1 { */ series?: string | null; /** - * Output only. Whether simultaneous multithreading is enabled (see https://cloud.google.com/compute/docs/instances/set-threads-per-core). + * Output only. Whether simultaneous multithreading is enabled. See https://cloud.google.com/compute/docs/instances/set-threads-per-core. */ smtEnabled?: boolean | null; /** @@ -13927,7 +13927,7 @@ export namespace migrationcenter_v1alpha1 { * const res = await migrationcenter.projects.locations.reportConfigs.create({ * // Required. Value for parent. * parent: 'projects/my-project/locations/my-location', - * // Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: [a-z]([a-z0-9-]{0,61\}[a-z0-9])?. + * // Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`. * reportConfigId: 'placeholder-value', * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). * requestId: 'placeholder-value', @@ -14492,7 +14492,7 @@ export namespace migrationcenter_v1alpha1 { */ parent?: string; /** - * Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: [a-z]([a-z0-9-]{0,61\}[a-z0-9])?. + * Required. User specified ID for the report config. It will become the last component of the report config name. The ID must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The ID must match the regular expression: `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`. */ reportConfigId?: string; /** @@ -14594,7 +14594,7 @@ export namespace migrationcenter_v1alpha1 { * // Required. Value for parent. * parent: * 'projects/my-project/locations/my-location/reportConfigs/my-reportConfig', - * // Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: [a-z]([a-z0-9-]{0,61\}[a-z0-9])?. + * // Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`. * reportId: 'placeholder-value', * // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). * requestId: 'placeholder-value', @@ -15169,7 +15169,7 @@ export namespace migrationcenter_v1alpha1 { */ parent?: string; /** - * Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: [a-z]([a-z0-9-]{0,61\}[a-z0-9])?. + * Required. User specified id for the report. It will become the last component of the report name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. The id must match the regular expression: `[a-z]([a-z0-9-]{0,61\}[a-z0-9])?`. */ reportId?: string; /** diff --git a/src/apis/mybusinessbusinessinformation/v1.ts b/src/apis/mybusinessbusinessinformation/v1.ts index 54317817115..f7ade589fd8 100644 --- a/src/apis/mybusinessbusinessinformation/v1.ts +++ b/src/apis/mybusinessbusinessinformation/v1.ts @@ -972,7 +972,7 @@ export namespace mybusinessbusinessinformation_v1 { */ closeDay?: string | null; /** - * Required. Valid values are 00:00-24:00, where 24:00 represents midnight at the end of the specified day field. + * Required. Valid values are 00:00-24:00, where 24:00 represents midnight at the end of the specified day field. Note: In Proto3 JSON mapping, default zero values (00:00) are omitted, producing `{\}` for close_time. */ closeTime?: Schema$TimeOfDay; /** @@ -980,7 +980,7 @@ export namespace mybusinessbusinessinformation_v1 { */ openDay?: string | null; /** - * Required. Valid values are 00:00-24:00, where 24:00 represents midnight at the end of the specified day field. + * Required. Valid values are 00:00-24:00, where 24:00 represents midnight at the end of the specified day field. Note: In Proto3 JSON mapping, default zero values (00:00) are omitted, producing `{\}` for open_time. */ openTime?: Schema$TimeOfDay; } diff --git a/src/apis/networkservices/v1.ts b/src/apis/networkservices/v1.ts index 01616353025..655e54ef02e 100644 --- a/src/apis/networkservices/v1.ts +++ b/src/apis/networkservices/v1.ts @@ -124,6 +124,47 @@ export namespace networkservices_v1 { } } + /** + * AgentConnectivityTemplate represents a reusable network configuration. + */ + export interface Schema$AgentConnectivityTemplate { + /** + * Required. Immutable. The path of the access. Maps roughly to ingress/egress, though we keep CLIENT_TO_AGENT and AGENT_TO_ANYWHERE as carryovers from Agent Gateway's original resource model. The path is immutable once set. Exactly one path can be set. + */ + accessPath?: string | null; + /** + * Optional. The types of network access provided to the gateway. Both PUBLIC and PRIVATE can be configured. + */ + accessTypes?: string[] | null; + /** + * Output only. The timestamp when the resource was created. + */ + createTime?: string | null; + /** + * Optional. A free-text description of the resource. Max length 1024 characters. + */ + description?: string | null; + /** + * Optional. Configuration for egress network traffic. + */ + egressNetworkConfig?: Schema$EgressNetworkConfig; + /** + * Optional. Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error. + */ + etag?: string | null; + /** + * Optional. Set of label tags associated with the AgentConnectivityTemplate resource. + */ + labels?: {[key: string]: string} | null; + /** + * Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/x/locations/x/agentConnectivityTemplates/`. + */ + name?: string | null; + /** + * Output only. The timestamp when the resource was updated. + */ + updateTime?: string | null; + } /** * AgentGateway represents the agent gateway resource. */ @@ -363,6 +404,54 @@ export namespace networkservices_v1 { * The request message for Operations.CancelOperation. */ export interface Schema$CancelOperationRequest {} + /** + * DNS Peering configuration. + */ + export interface Schema$DnsPeeringConfig { + /** + * Optional. The domain to peer. + */ + domain?: string | null; + /** + * Optional. The target network resource name for DNS peering. Format: projects/{project\}/global/networks/{network_id\} + */ + targetNetwork?: string | null; + } + export interface Schema$EgressNetworkConfig { + /** + * Optional. DNS Peering configuration. + */ + dnsPeeringConfig?: Schema$DnsPeeringConfig; + /** + * Optional. The network attachment resource name. Format: projects/{project\}/regions/{region\}/networkAttachments/{network_attachment_id\} + */ + networkAttachment?: string | null; + /** + * Optional. The TLS configuration for the egress traffic. + */ + tlsConfig?: Schema$EgressNetworkConfigTlsConfig; + /** + * Optional. The trust config resource name. Format: projects/{project\}/locations/{location\}/trustConfigs/{trust_config\} + */ + trustConfig?: string | null; + /** + * Optional. The VPC egress setting. + */ + vpcEgress?: string | null; + } + /** + * Configuration for TLS connections. + */ + export interface Schema$EgressNetworkConfigTlsConfig { + /** + * Optional. The additional roots to trust. + */ + additionalRoots?: string | null; + /** + * Optional. The trust config resource name. Format: projects/{project\}/locations/{location\}/trustConfigs/{trust_config\} + */ + trustConfig?: 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); \} */ @@ -1423,6 +1512,23 @@ export namespace networkservices_v1 { */ updateTime?: string | null; } + /** + * Response returned by the ListAgentConnectivityTemplates method. + */ + export interface Schema$ListAgentConnectivityTemplatesResponse { + /** + * List of AgentConnectivityTemplate resources. + */ + agentConnectivityTemplates?: Schema$AgentConnectivityTemplate[]; + /** + * If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`. + */ + nextPageToken?: string | null; + /** + * Unordered list. Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable. + */ + unreachable?: string[] | null; + } /** * Response returned by the ListAgentGateways method. */ @@ -2615,6 +2721,7 @@ export namespace networkservices_v1 { export class Resource$Projects$Locations { context: APIRequestContext; + agentConnectivityTemplates: Resource$Projects$Locations$Agentconnectivitytemplates; agentGateways: Resource$Projects$Locations$Agentgateways; authzExtensions: Resource$Projects$Locations$Authzextensions; edgeCacheKeysets: Resource$Projects$Locations$Edgecachekeysets; @@ -2638,6 +2745,10 @@ export namespace networkservices_v1 { wasmPlugins: Resource$Projects$Locations$Wasmplugins; constructor(context: APIRequestContext) { this.context = context; + this.agentConnectivityTemplates = + new Resource$Projects$Locations$Agentconnectivitytemplates( + this.context + ); this.agentGateways = new Resource$Projects$Locations$Agentgateways( this.context ); @@ -3009,6 +3120,843 @@ export namespace networkservices_v1 { pageToken?: string; } + export class Resource$Projects$Locations$Agentconnectivitytemplates { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates a new AgentConnectivityTemplate in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.create({ + * // Required. Short name of the AgentConnectivityTemplate resource to be created. + * agentConnectivityTemplateId: 'placeholder-value', + * // Required. The parent resource of the AgentConnectivityTemplate. Must be in the format `projects/x/locations/x`. + * parent: 'projects/my-project/locations/my-location', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "accessPath": "my_accessPath", + * // "accessTypes": [], + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "egressNetworkConfig": {}, + * // "etag": "my_etag", + * // "labels": {}, + * // "name": "my_name", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * 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. + */ + create( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + options?: MethodOptions + ): Promise>; + create( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + callback: BodyResponseCallback + ): void; + create(callback: BodyResponseCallback): void; + create( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/agentConnectivityTemplates').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 single AgentConnectivityTemplate. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.delete({ + * // Optional. The etag of the AgentConnectivityTemplate to delete. + * etag: 'placeholder-value', + * // Required. A name of the AgentConnectivityTemplate to delete. Must be in the format `projects/x/locations/x/agentConnectivityTemplates/x`. + * name: 'projects/my-project/locations/my-location/agentConnectivityTemplates/my-agentConnectivityTemplate', + * }); + * 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. + */ + delete( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.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 details of a single AgentConnectivityTemplate. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.get({ + * // Required. A name of the AgentConnectivityTemplate to get. Must be in the format `projects/x/locations/x/agentConnectivityTemplates/x`. + * name: 'projects/my-project/locations/my-location/agentConnectivityTemplates/my-agentConnectivityTemplate', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "accessPath": "my_accessPath", + * // "accessTypes": [], + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "egressNetworkConfig": {}, + * // "etag": "my_etag", + * // "labels": {}, + * // "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$Agentconnectivitytemplates$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.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 AgentConnectivityTemplates in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.list({ + * // Optional. Maximum number of AgentConnectivityTemplates to return per call. + * pageSize: 'placeholder-value', + * // Optional. The value returned by the last `ListAgentConnectivityTemplatesResponse` Indicates that this is a continuation of a prior `ListAgentConnectivityTemplates` call, and that the system should return the next page of data. + * pageToken: 'placeholder-value', + * // Required. The project and location from which the AgentConnectivityTemplates should be listed, specified in the format `projects/x/locations/x`. + * parent: 'projects/my-project/locations/my-location', + * // Optional. If true, allow partial responses for multi-regional Aggregated List requests. Otherwise if one of the locations is down or unreachable, the Aggregated List request will fail. + * returnPartialSuccess: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "agentConnectivityTemplates": [], + * // "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$Agentconnectivitytemplates$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$List, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + list( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1/{+parent}/agentConnectivityTemplates').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 parameters of a single AgentConnectivityTemplate. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.patch({ + * // Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/x/locations/x/agentConnectivityTemplates/`. + * name: 'projects/my-project/locations/my-location/agentConnectivityTemplates/my-agentConnectivityTemplate', + * // Optional. Field mask is used to specify the fields to be overwritten in the AgentConnectivityTemplate resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "accessPath": "my_accessPath", + * // "accessTypes": [], + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "egressNetworkConfig": {}, + * // "etag": "my_etag", + * // "labels": {}, + * // "name": "my_name", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * 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. + */ + patch( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.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$Projects$Locations$Agentconnectivitytemplates$Create extends StandardParameters { + /** + * Required. Short name of the AgentConnectivityTemplate resource to be created. + */ + agentConnectivityTemplateId?: string; + /** + * Required. The parent resource of the AgentConnectivityTemplate. Must be in the format `projects/x/locations/x`. + */ + parent?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$AgentConnectivityTemplate; + } + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete extends StandardParameters { + /** + * Optional. The etag of the AgentConnectivityTemplate to delete. + */ + etag?: string; + /** + * Required. A name of the AgentConnectivityTemplate to delete. Must be in the format `projects/x/locations/x/agentConnectivityTemplates/x`. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get extends StandardParameters { + /** + * Required. A name of the AgentConnectivityTemplate to get. Must be in the format `projects/x/locations/x/agentConnectivityTemplates/x`. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$List extends StandardParameters { + /** + * Optional. Maximum number of AgentConnectivityTemplates to return per call. + */ + pageSize?: number; + /** + * Optional. The value returned by the last `ListAgentConnectivityTemplatesResponse` Indicates that this is a continuation of a prior `ListAgentConnectivityTemplates` call, and that the system should return the next page of data. + */ + pageToken?: string; + /** + * Required. The project and location from which the AgentConnectivityTemplates should be listed, specified in the format `projects/x/locations/x`. + */ + parent?: string; + /** + * Optional. If true, allow partial responses for multi-regional Aggregated List requests. Otherwise if one of the locations is down or unreachable, the Aggregated List request will fail. + */ + returnPartialSuccess?: boolean; + } + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch extends StandardParameters { + /** + * Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/x/locations/x/agentConnectivityTemplates/`. + */ + name?: string; + /** + * Optional. Field mask is used to specify the fields to be overwritten in the AgentConnectivityTemplate resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$AgentConnectivityTemplate; + } + export class Resource$Projects$Locations$Agentgateways { context: APIRequestContext; constructor(context: APIRequestContext) { diff --git a/src/apis/networkservices/v1beta1.ts b/src/apis/networkservices/v1beta1.ts index a360055ba3b..545b0b45830 100644 --- a/src/apis/networkservices/v1beta1.ts +++ b/src/apis/networkservices/v1beta1.ts @@ -124,6 +124,47 @@ export namespace networkservices_v1beta1 { } } + /** + * AgentConnectivityTemplate represents a reusable network configuration. + */ + export interface Schema$AgentConnectivityTemplate { + /** + * Required. Immutable. The path of the access. Maps roughly to ingress/egress, though we keep CLIENT_TO_AGENT and AGENT_TO_ANYWHERE as carryovers from Agent Gateway's original resource model. The path is immutable once set. Exactly one path can be set. + */ + accessPath?: string | null; + /** + * Optional. The types of network access provided to the gateway. Both PUBLIC and PRIVATE can be configured. + */ + accessTypes?: string[] | null; + /** + * Output only. The timestamp when the resource was created. + */ + createTime?: string | null; + /** + * Optional. A free-text description of the resource. Max length 1024 characters. + */ + description?: string | null; + /** + * Optional. Configuration for egress network traffic. + */ + egressNetworkConfig?: Schema$EgressNetworkConfig; + /** + * Optional. Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error. + */ + etag?: string | null; + /** + * Optional. Set of label tags associated with the AgentConnectivityTemplate resource. + */ + labels?: {[key: string]: string} | null; + /** + * Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/x/locations/x/agentConnectivityTemplates/`. + */ + name?: string | null; + /** + * Output only. The timestamp when the resource was updated. + */ + updateTime?: string | null; + } /** * AgentGateway represents the agent gateway resource. */ @@ -320,6 +361,54 @@ export namespace networkservices_v1beta1 { * The request message for Operations.CancelOperation. */ export interface Schema$CancelOperationRequest {} + /** + * DNS Peering configuration. + */ + export interface Schema$DnsPeeringConfig { + /** + * Optional. The domain to peer. + */ + domain?: string | null; + /** + * Optional. The target network resource name for DNS peering. Format: projects/{project\}/global/networks/{network_id\} + */ + targetNetwork?: string | null; + } + export interface Schema$EgressNetworkConfig { + /** + * Optional. DNS Peering configuration. + */ + dnsPeeringConfig?: Schema$DnsPeeringConfig; + /** + * Optional. The network attachment resource name. Format: projects/{project\}/regions/{region\}/networkAttachments/{network_attachment_id\} + */ + networkAttachment?: string | null; + /** + * Optional. The TLS configuration for the egress traffic. + */ + tlsConfig?: Schema$EgressNetworkConfigTlsConfig; + /** + * Optional. The trust config resource name. Format: projects/{project\}/locations/{location\}/trustConfigs/{trust_config\} + */ + trustConfig?: string | null; + /** + * Optional. The VPC egress setting. + */ + vpcEgress?: string | null; + } + /** + * Configuration for TLS connections. + */ + export interface Schema$EgressNetworkConfigTlsConfig { + /** + * Optional. The additional roots to trust. + */ + additionalRoots?: string | null; + /** + * Optional. The trust config resource name. Format: projects/{project\}/locations/{location\}/trustConfigs/{trust_config\} + */ + trustConfig?: 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); \} */ @@ -1378,6 +1467,23 @@ export namespace networkservices_v1beta1 { */ updateTime?: string | null; } + /** + * Response returned by the ListAgentConnectivityTemplates method. + */ + export interface Schema$ListAgentConnectivityTemplatesResponse { + /** + * List of AgentConnectivityTemplate resources. + */ + agentConnectivityTemplates?: Schema$AgentConnectivityTemplate[]; + /** + * If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`. + */ + nextPageToken?: string | null; + /** + * Unordered list. Unreachable resources. Populated when the request attempts to list all resources across all supported locations, while some locations are temporarily unavailable. + */ + unreachable?: string[] | null; + } /** * Response returned by the ListAgentGateways method. */ @@ -2415,6 +2521,7 @@ export namespace networkservices_v1beta1 { export class Resource$Projects$Locations { context: APIRequestContext; + agentConnectivityTemplates: Resource$Projects$Locations$Agentconnectivitytemplates; agentGateways: Resource$Projects$Locations$Agentgateways; authzExtensions: Resource$Projects$Locations$Authzextensions; endpointPolicies: Resource$Projects$Locations$Endpointpolicies; @@ -2434,6 +2541,10 @@ export namespace networkservices_v1beta1 { wasmPlugins: Resource$Projects$Locations$Wasmplugins; constructor(context: APIRequestContext) { this.context = context; + this.agentConnectivityTemplates = + new Resource$Projects$Locations$Agentconnectivitytemplates( + this.context + ); this.agentGateways = new Resource$Projects$Locations$Agentgateways( this.context ); @@ -2792,6 +2903,841 @@ export namespace networkservices_v1beta1 { pageToken?: string; } + export class Resource$Projects$Locations$Agentconnectivitytemplates { + context: APIRequestContext; + constructor(context: APIRequestContext) { + this.context = context; + } + + /** + * Creates a new AgentConnectivityTemplate in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.create({ + * // Required. Short name of the AgentConnectivityTemplate resource to be created. + * agentConnectivityTemplateId: 'placeholder-value', + * // Required. The parent resource of the AgentConnectivityTemplate. Must be in the format `projects/x/locations/x`. + * parent: 'projects/my-project/locations/my-location', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "accessPath": "my_accessPath", + * // "accessTypes": [], + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "egressNetworkConfig": {}, + * // "etag": "my_etag", + * // "labels": {}, + * // "name": "my_name", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * 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. + */ + create( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + options: StreamMethodOptions + ): Promise>; + create( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + options?: MethodOptions + ): Promise>; + create( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + create( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create, + callback: BodyResponseCallback + ): void; + create(callback: BodyResponseCallback): void; + create( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/v1beta1/{+parent}/agentConnectivityTemplates' + ).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 single AgentConnectivityTemplate. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.delete({ + * // Optional. The etag of the AgentConnectivityTemplate to delete. + * etag: 'placeholder-value', + * // Required. A name of the AgentConnectivityTemplate to delete. Must be in the format `projects/x/locations/x/agentConnectivityTemplates/x`. + * name: 'projects/my-project/locations/my-location/agentConnectivityTemplates/my-agentConnectivityTemplate', + * }); + * 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. + */ + delete( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + options: StreamMethodOptions + ): Promise>; + delete( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + options?: MethodOptions + ): Promise>; + delete( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + delete( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete, + callback: BodyResponseCallback + ): void; + delete(callback: BodyResponseCallback): void; + delete( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/v1beta1/{+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 details of a single AgentConnectivityTemplate. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.get({ + * // Required. A name of the AgentConnectivityTemplate to get. Must be in the format `projects/x/locations/x/agentConnectivityTemplates/x`. + * name: 'projects/my-project/locations/my-location/agentConnectivityTemplates/my-agentConnectivityTemplate', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "accessPath": "my_accessPath", + * // "accessTypes": [], + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "egressNetworkConfig": {}, + * // "etag": "my_etag", + * // "labels": {}, + * // "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$Agentconnectivitytemplates$Get, + options: StreamMethodOptions + ): Promise>; + get( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get, + options?: MethodOptions + ): Promise>; + get( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get, + options: + MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + get( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get, + callback: BodyResponseCallback + ): void; + get(callback: BodyResponseCallback): void; + get( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.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 AgentConnectivityTemplates in a given project and location. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.list({ + * // Optional. Maximum number of AgentConnectivityTemplates to return per call. + * pageSize: 'placeholder-value', + * // Optional. The value returned by the last `ListAgentConnectivityTemplatesResponse` Indicates that this is a continuation of a prior `ListAgentConnectivityTemplates` call, and that the system should return the next page of data. + * pageToken: 'placeholder-value', + * // Required. The project and location from which the AgentConnectivityTemplates should be listed, specified in the format `projects/x/locations/x`. + * parent: 'projects/my-project/locations/my-location', + * // Optional. If true, allow partial responses for multi-regional Aggregated List requests. Otherwise if one of the locations is down or unreachable, the Aggregated List request will fail. + * returnPartialSuccess: 'placeholder-value', + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "agentConnectivityTemplates": [], + * // "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$Agentconnectivitytemplates$List, + options: StreamMethodOptions + ): Promise>; + list( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$List, + options?: MethodOptions + ): Promise< + GaxiosResponseWithHTTP2 + >; + list( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$List, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$List, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + list( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$List, + callback: BodyResponseCallback + ): void; + list( + callback: BodyResponseCallback + ): void; + list( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$List + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise< + GaxiosResponseWithHTTP2 + > + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$List; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$List; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/v1beta1/{+parent}/agentConnectivityTemplates' + ).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 parameters of a single AgentConnectivityTemplate. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/networkservices.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 networkservices = google.networkservices('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 networkservices.projects.locations.agentConnectivityTemplates.patch({ + * // Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/x/locations/x/agentConnectivityTemplates/`. + * name: 'projects/my-project/locations/my-location/agentConnectivityTemplates/my-agentConnectivityTemplate', + * // Optional. Field mask is used to specify the fields to be overwritten in the AgentConnectivityTemplate resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "accessPath": "my_accessPath", + * // "accessTypes": [], + * // "createTime": "my_createTime", + * // "description": "my_description", + * // "egressNetworkConfig": {}, + * // "etag": "my_etag", + * // "labels": {}, + * // "name": "my_name", + * // "updateTime": "my_updateTime" + * // } + * }, + * }); + * 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. + */ + patch( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://networkservices.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); + } + } + } + + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$Create extends StandardParameters { + /** + * Required. Short name of the AgentConnectivityTemplate resource to be created. + */ + agentConnectivityTemplateId?: string; + /** + * Required. The parent resource of the AgentConnectivityTemplate. Must be in the format `projects/x/locations/x`. + */ + parent?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$AgentConnectivityTemplate; + } + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$Delete extends StandardParameters { + /** + * Optional. The etag of the AgentConnectivityTemplate to delete. + */ + etag?: string; + /** + * Required. A name of the AgentConnectivityTemplate to delete. Must be in the format `projects/x/locations/x/agentConnectivityTemplates/x`. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$Get extends StandardParameters { + /** + * Required. A name of the AgentConnectivityTemplate to get. Must be in the format `projects/x/locations/x/agentConnectivityTemplates/x`. + */ + name?: string; + } + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$List extends StandardParameters { + /** + * Optional. Maximum number of AgentConnectivityTemplates to return per call. + */ + pageSize?: number; + /** + * Optional. The value returned by the last `ListAgentConnectivityTemplatesResponse` Indicates that this is a continuation of a prior `ListAgentConnectivityTemplates` call, and that the system should return the next page of data. + */ + pageToken?: string; + /** + * Required. The project and location from which the AgentConnectivityTemplates should be listed, specified in the format `projects/x/locations/x`. + */ + parent?: string; + /** + * Optional. If true, allow partial responses for multi-regional Aggregated List requests. Otherwise if one of the locations is down or unreachable, the Aggregated List request will fail. + */ + returnPartialSuccess?: boolean; + } + export interface Params$Resource$Projects$Locations$Agentconnectivitytemplates$Patch extends StandardParameters { + /** + * Identifier. Name of the AgentConnectivityTemplate resource. It matches pattern `projects/x/locations/x/agentConnectivityTemplates/`. + */ + name?: string; + /** + * Optional. Field mask is used to specify the fields to be overwritten in the AgentConnectivityTemplate resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$AgentConnectivityTemplate; + } + export class Resource$Projects$Locations$Agentgateways { context: APIRequestContext; constructor(context: APIRequestContext) { diff --git a/src/apis/ondemandscanning/v1.ts b/src/apis/ondemandscanning/v1.ts index e92a888385a..8b6956f3103 100644 --- a/src/apis/ondemandscanning/v1.ts +++ b/src/apis/ondemandscanning/v1.ts @@ -133,9 +133,13 @@ export namespace ondemandscanning_v1 { */ findings?: Schema$Finding[]; /** - * Maximum severity found among findings. + * Maximum severity found among findings. Per scanner verdict details. */ maxSeverity?: string | null; + /** + * Per scanner verdict. + */ + perScannerVerdict?: Schema$PerScannerVerdict; /** * Name of the skill that produced this analysis. */ @@ -1144,6 +1148,45 @@ export namespace ondemandscanning_v1 { name?: string | null; url?: string | null; } + /** + * Result of Malicious Content LLM scan. + */ + export interface Schema$MaliciousContentLLMResult { + /** + * Tracks max severity found. + */ + maxSeverity?: string | null; + /** + * Status of the scan. + */ + scanStatus?: string | null; + } + /** + * Result of Malicious Content Static scan. + */ + export interface Schema$MaliciousContentStaticResult { + /** + * Tracks max severity found. + */ + maxSeverity?: string | null; + /** + * Status of the scan. + */ + scanStatus?: string | null; + } + /** + * Result of Malware scan. + */ + export interface Schema$MalwareScanResult { + /** + * Status of the scan. + */ + scanStatus?: string | null; + /** + * Verdict of the scan. + */ + verdict?: string | null; + } export interface Schema$Material { digest?: {[key: string]: string} | null; uri?: string | null; @@ -1466,6 +1509,24 @@ export namespace ondemandscanning_v1 { name?: string | null; version?: string | null; } + export interface Schema$PerScannerVerdict { + /** + * Malicious Content LLM scan result. + */ + maliciousContentLlmResult?: Schema$MaliciousContentLLMResult; + /** + * Malicious Content Static scan result. + */ + maliciousContentStaticResult?: Schema$MaliciousContentStaticResult; + /** + * Malware scan result. + */ + malwareScan?: Schema$MalwareScanResult; + /** + * Workspace Policy scan result. + */ + workspacePolicy?: Schema$WorkspacePolicyResult; + } /** * Selects a repo using a Google Cloud Platform project ID (e.g., winged-cargo-31) and a repo name within that project. */ @@ -2080,6 +2141,19 @@ export namespace ondemandscanning_v1 { */ title?: string | null; } + /** + * Result of Workspace Policy scan. + */ + export interface Schema$WorkspacePolicyResult { + /** + * Status of the scan. + */ + scanStatus?: string | null; + /** + * Verdict of the scan. + */ + verdict?: string | null; + } export class Resource$Projects { context: APIRequestContext; diff --git a/src/apis/ondemandscanning/v1beta1.ts b/src/apis/ondemandscanning/v1beta1.ts index e53c7dcee2b..9b7889badbf 100644 --- a/src/apis/ondemandscanning/v1beta1.ts +++ b/src/apis/ondemandscanning/v1beta1.ts @@ -133,9 +133,13 @@ export namespace ondemandscanning_v1beta1 { */ findings?: Schema$Finding[]; /** - * Maximum severity found among findings. + * Maximum severity found among findings. Per scanner verdict details. */ maxSeverity?: string | null; + /** + * Per scanner verdict. + */ + perScannerVerdict?: Schema$PerScannerVerdict; /** * Name of the skill that produced this analysis. */ @@ -1140,6 +1144,45 @@ export namespace ondemandscanning_v1beta1 { name?: string | null; url?: string | null; } + /** + * Result of Malicious Content LLM scan. + */ + export interface Schema$MaliciousContentLLMResult { + /** + * Tracks max severity found. + */ + maxSeverity?: string | null; + /** + * Status of the scan. + */ + scanStatus?: string | null; + } + /** + * Result of Malicious Content Static scan. + */ + export interface Schema$MaliciousContentStaticResult { + /** + * Tracks max severity found. + */ + maxSeverity?: string | null; + /** + * Status of the scan. + */ + scanStatus?: string | null; + } + /** + * Result of Malware scan. + */ + export interface Schema$MalwareScanResult { + /** + * Status of the scan. + */ + scanStatus?: string | null; + /** + * Verdict of the scan. + */ + verdict?: string | null; + } export interface Schema$Material { digest?: {[key: string]: string} | null; uri?: string | null; @@ -1462,6 +1505,24 @@ export namespace ondemandscanning_v1beta1 { name?: string | null; version?: string | null; } + export interface Schema$PerScannerVerdict { + /** + * Malicious Content LLM scan result. + */ + maliciousContentLlmResult?: Schema$MaliciousContentLLMResult; + /** + * Malicious Content Static scan result. + */ + maliciousContentStaticResult?: Schema$MaliciousContentStaticResult; + /** + * Malware scan result. + */ + malwareScan?: Schema$MalwareScanResult; + /** + * Workspace Policy scan result. + */ + workspacePolicy?: Schema$WorkspacePolicyResult; + } /** * Selects a repo using a Google Cloud Platform project ID (e.g., winged-cargo-31) and a repo name within that project. */ @@ -2076,6 +2137,19 @@ export namespace ondemandscanning_v1beta1 { */ title?: string | null; } + /** + * Result of Workspace Policy scan. + */ + export interface Schema$WorkspacePolicyResult { + /** + * Status of the scan. + */ + scanStatus?: string | null; + /** + * Verdict of the scan. + */ + verdict?: string | null; + } export class Resource$Projects { context: APIRequestContext; diff --git a/src/apis/retail/v2alpha.ts b/src/apis/retail/v2alpha.ts index 065912fe9be..c25746cb8a4 100644 --- a/src/apis/retail/v2alpha.ts +++ b/src/apis/retail/v2alpha.ts @@ -778,6 +778,10 @@ export namespace retail_v2alpha { * Resource that represents completion results. */ export interface Schema$GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResult { + /** + * Conversational prompts to trigger agents like Shopping Agent. There may be multiple prompts for a single suggestion. This is an experimental feature for select customers. If you want to receive this prompt information, reach out to the Retail support team. + */ + agentPrompts?: Schema$GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResultAgentPrompt[]; /** * Custom attributes for the suggestion term. * For `user-data`, the attributes are additional custom attributes ingested through BigQuery. * For `cloud-retail`, the attributes are product attributes generated by Cloud Retail. It requires UserEvent.product_details is imported properly. */ @@ -797,6 +801,15 @@ export namespace retail_v2alpha { */ totalProductCount?: number | null; } + /** + * A conversational prompt to trigger agents like Shopping Agent. + */ + export interface Schema$GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResultAgentPrompt { + /** + * The conversational prompt string. + */ + prompt?: string | null; + } /** * Deprecated: Recent search of this user. */ @@ -3083,6 +3096,10 @@ export namespace retail_v2alpha { * Optional. This field specifies all conversational related parameters addition to traditional retail search. */ conversationalSearchSpec?: Schema$GoogleCloudRetailV2alphaSearchRequestConversationalSearchSpec; + /** + * Optional. A set of controls that are applied dynamically to the search request. These controls are applied in addition to the controls specified in the serving config. These controls are expected to not yet be persisted in storage. A control could be applied twice if it is in both the serving config and specified here. A maximum of 5 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned. + */ + dynamicControls?: Schema$GoogleCloudRetailV2alphaControl[]; /** * Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic to enable dynamic facets. Do not set this field. The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated. */ @@ -3103,6 +3120,10 @@ export namespace retail_v2alpha { * The filter syntax consists of an expression language for constructing a predicate from one or more fields of the products being filtered. Filter expression is case-sensitive. For more information, see [Filter](https://cloud.google.com/retail/docs/filter-and-order#filter). If this field is unrecognizable, an INVALID_ARGUMENT is returned. */ filter?: string | null; + /** + * Optional. A list of control IDs to ignore. These controls will not be applied to the search request, even if they are specified in the serving config. + */ + ignoredControlIds?: string[] | null; /** * The labels applied to a resource must meet the following requirements: * Each resource can have multiple labels, up to a maximum of 64. * Each label must be a key-value pair. * Keys have a minimum length of 1 character and a maximum length of 63 characters and cannot be empty. Values can be empty and have a maximum length of 63 characters. * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. * The key portion of a label must be unique. However, you can use the same key with multiple resources. * Keys must start with a lowercase letter or international character. For more information, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) in the Resource Manager documentation. */ @@ -16156,11 +16177,13 @@ export namespace retail_v2alpha { * // "branch": "my_branch", * // "canonicalFilter": "my_canonicalFilter", * // "conversationalSearchSpec": {}, + * // "dynamicControls": [], * // "dynamicFacetSpec": {}, * // "entity": "my_entity", * // "experimentId": "my_experimentId", * // "facetSpecs": [], * // "filter": "my_filter", + * // "ignoredControlIds": [], * // "labels": {}, * // "languageCode": "my_languageCode", * // "offset": 0, @@ -17928,11 +17951,13 @@ export namespace retail_v2alpha { * // "branch": "my_branch", * // "canonicalFilter": "my_canonicalFilter", * // "conversationalSearchSpec": {}, + * // "dynamicControls": [], * // "dynamicFacetSpec": {}, * // "entity": "my_entity", * // "experimentId": "my_experimentId", * // "facetSpecs": [], * // "filter": "my_filter", + * // "ignoredControlIds": [], * // "labels": {}, * // "languageCode": "my_languageCode", * // "offset": 0, diff --git a/src/apis/searchconsole/v1.ts b/src/apis/searchconsole/v1.ts index ab3e0438ebb..72c766f39c4 100644 --- a/src/apis/searchconsole/v1.ts +++ b/src/apis/searchconsole/v1.ts @@ -198,10 +198,16 @@ export namespace searchconsole_v1 { operator?: string | null; } /** - * A set of dimension value filters to test against each row. Only rows that pass all filter groups will be returned. All results within a filter group are either AND'ed or OR'ed together, depending on the group type selected. All filter groups are AND'ed together. + * A set of `dimension` value filters to test against each row. Only rows that pass all filter groups will be returned. All results within a filter group are either AND'ed or OR'ed together, depending on the group type selected. All filter groups are AND'ed together. */ export interface Schema$ApiDimensionFilterGroup { + /** + * Optional. A list of single-value filters in this group. + */ filters?: Schema$ApiDimensionFilter[]; + /** + * Optional. The logic operator between filters of the same group. + */ groupType?: string | null; } /** diff --git a/src/apis/serviceconsumermanagement/v1beta1.ts b/src/apis/serviceconsumermanagement/v1beta1.ts index d75a685280d..978a7b72445 100644 --- a/src/apis/serviceconsumermanagement/v1beta1.ts +++ b/src/apis/serviceconsumermanagement/v1beta1.ts @@ -1153,10 +1153,18 @@ export namespace serviceconsumermanagement_v1beta1 { * Bind API methods to metrics. Binding a method to a metric causes that metric's configured quota behaviors to apply to the method call. */ export interface Schema$MetricRule { + /** + * Optional. Metrics to update when the selected methods are called, and the associated cost applied to each metric, iff the source of the call is an agent. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative. + */ + agenticMetricCosts?: {[key: string]: string} | null; /** * Metrics to update when the selected methods are called, and the associated cost applied to each metric. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative. */ metricCosts?: {[key: string]: string} | null; + /** + * Optional. Metrics to update when the selected methods are called, and the associated cost applied to each metric, iff the source of the call is not an agent. The key of the map is the metric name, and the values are the amount increased for the metric against which the quota limits are defined. The value must not be negative. + */ + nonagenticMetricCosts?: {[key: string]: string} | null; /** * Selects the methods to which this rule applies. Refer to selector for syntax details. */ @@ -1427,6 +1435,10 @@ export namespace serviceconsumermanagement_v1beta1 { * Name of the quota limit. The name must be provided, and it must be unique within the service. The name can only include alphanumeric characters as well as '-'. The maximum length of the limit name is 64 characters. */ name?: string | null; + /** + * Optional. This is only informational, the logic to allocate the quota to the correct metric (such as in `metric_rules`) should identify which quota metrics to allocate to. + */ + trafficSource?: string | null; /** * Specify the unit of the quota limit. It uses the same syntax as MetricDescriptor.unit. The supported unit kinds are determined by the quota backend system. Here are some examples: * "1/min/{project\}" for quota per minute per project. Note: the order of unit components is insignificant. The "1" at the beginning is required to follow the metric unit syntax. */ diff --git a/src/apis/serviceusage/v1beta1.ts b/src/apis/serviceusage/v1beta1.ts index a1c15f2e01b..55bb994ee97 100644 --- a/src/apis/serviceusage/v1beta1.ts +++ b/src/apis/serviceusage/v1beta1.ts @@ -668,6 +668,10 @@ export namespace serviceusage_v1beta1 { * List of all supported locations. This field is present only if the limit has a {region\} or {zone\} dimension. */ supportedLocations?: string[] | null; + /** + * Indicates the traffic type attribution for this quota limit (e.g. agentic). This is an informational field used to categorize and filter the quota limits. + */ + trafficSource?: string | null; /** * The limit unit. An example unit would be `1/{project\}/{region\}` Note that `{project\}` and `{region\}` are not placeholders in this example; the literal characters `{` and `\}` occur in the string. */ @@ -4828,6 +4832,7 @@ export namespace serviceusage_v1beta1 { * // "name": "my_name", * // "quotaBuckets": [], * // "supportedLocations": [], + * // "trafficSource": "my_trafficSource", * // "unit": "my_unit" * // } * } diff --git a/src/apis/threatintelligence/v1beta.ts b/src/apis/threatintelligence/v1beta.ts index 2f9ec3ffbee..ea18e09bd48 100644 --- a/src/apis/threatintelligence/v1beta.ts +++ b/src/apis/threatintelligence/v1beta.ts @@ -371,6 +371,10 @@ export namespace threatintelligence_v1beta { * Customer Profile detail config. */ customerProfile?: Schema$CustomerProfileConfig; + /** + * Custom Threat Scenario detail config. + */ + customThreatScenario?: Schema$CustomThreatScenarioConfig; /** * Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union. */ @@ -681,6 +685,15 @@ export namespace threatintelligence_v1beta { */ domain?: string | null; } + /** + * CustomThreatScenarioConfig represents a user-defined threat scenario configuration. + */ + export interface Schema$CustomThreatScenarioConfig { + /** + * Required. The condition driving the scenario, stored as a stringified JSON. This is used to query/filter documents. + */ + documentCondition?: string | null; + } /** * Captures the specific details of Data Leak alert. */ diff --git a/src/apis/toolresults/v1beta3.ts b/src/apis/toolresults/v1beta3.ts index 959dc0ead6a..471799a2a6f 100644 --- a/src/apis/toolresults/v1beta3.ts +++ b/src/apis/toolresults/v1beta3.ts @@ -229,6 +229,10 @@ export namespace toolresults_v1beta3 { */ stackTrace?: Schema$StackTrace; } + /** + * Anti-tampering termination was detected. + */ + export interface Schema$AntiTamperingTermination {} /** * `Any` contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides support to pack/unpack Any values in the form of utility functions or additional generated methods of the Any type. Example 1: Pack and unpack a message in C++. Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... \} Example 2: Pack and unpack a message in Java. Foo foo = ...; Any any = Any.pack(foo); ... if (any.is(Foo.class)) { foo = any.unpack(Foo.class); \} Example 3: Pack and unpack a message in Python. foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DESCRIPTOR): any.Unpack(foo) ... Example 4: Pack and unpack a message in Go foo := &pb.Foo{...\} any, err := ptypes.MarshalAny(foo) ... foo := &pb.Foo{\} if err := ptypes.UnmarshalAny(any, foo); err != nil { ... \} The pack methods provided by protobuf library will by default use 'type.googleapis.com/full.type.name' as the type URL and the unpack methods only use the fully qualified type name after the last '/' in the type URL, for example "foo.bar.com/x/y.z" will yield type name "y.z". # JSON The JSON representation of an `Any` value uses the regular representation of the deserialized, embedded message, with an additional field `@type` which contains the type URL. Example: package google.profile; message Person { string first_name = 1; string last_name = 2; \} { "@type": "type.googleapis.com/google.profile.Person", "firstName": , "lastName": \} If the embedded message type is well-known and has a custom JSON representation, that representation will be embedded adding a field `value` which holds the custom JSON in addition to the `@type` field. Example (for message google.protobuf.Duration): { "@type": "type.googleapis.com/google.protobuf.Duration", "value": "1.212s" \} */ diff --git a/src/apis/walletobjects/v1.ts b/src/apis/walletobjects/v1.ts index 3eb8ac2d6af..f76241dbe3e 100644 --- a/src/apis/walletobjects/v1.ts +++ b/src/apis/walletobjects/v1.ts @@ -2278,6 +2278,15 @@ export namespace walletobjects_v1 { */ value?: string | null; } + /** + * A JSON representation of a pass. + */ + export interface Schema$JsonResource { + /** + * Required. A JSON string representing the unencoded JWT payload for a pass of the format described at https://developers.google.com/wallet/reference/rest/v1/Jwt. This can be set to either the entire JSON representation described at this link or just the contents of the payload field holding the relevant classes and objects. + */ + json?: string | null; + } export interface Schema$JwtInsertResponse { /** * Data that corresponds to the ids of the provided classes and objects in the JWT. resources will only include the non-empty arrays (i.e. if the JWT only includes eventTicketObjects, then that is the only field that will be present in resources). @@ -2297,6 +2306,23 @@ export namespace walletobjects_v1 { */ jwt?: string | null; } + /** + * Request to validate the JWT or JSON representation of a pass. + */ + export interface Schema$JwtValidateRequest { + /** + * Optional. A JSON representation of a pass to be validated. Either this or jwt_resource should be set. Requests setting both or neither will be rejected. + */ + jsonResource?: Schema$JsonResource; + /** + * Optional. A JWT representation of a pass to be validated. Either this or json_resource should be set. Requests setting both or neither will be rejected. + */ + jwtResource?: Schema$JwtResource; + } + /** + * Empty if the resource in the request is valid. Returns exception if invalid. + */ + export interface Schema$JwtValidateResponse {} /** * A pair of text strings to be displayed in the details view. Note we no longer display LabelValue/LabelValueRow as a table, instead a list of items. */ @@ -14848,6 +14874,147 @@ export namespace walletobjects_v1 { return createAPIRequest(parameters); } } + + /** + * Checks that the JWT or JSON string in the request represents a valid pass to be saved. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/walletobjects.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 walletobjects = google.walletobjects('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/wallet_object.issuer'], + * }); + * + * // 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 walletobjects.jwt.validate({ + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "jsonResource": {}, + * // "jwtResource": {} + * // } + * }, + * }); + * 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. + */ + validate( + params: Params$Resource$Jwt$Validate, + options: StreamMethodOptions + ): Promise>; + validate( + params?: Params$Resource$Jwt$Validate, + options?: MethodOptions + ): Promise>; + validate( + params: Params$Resource$Jwt$Validate, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + validate( + params: Params$Resource$Jwt$Validate, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + validate( + params: Params$Resource$Jwt$Validate, + callback: BodyResponseCallback + ): void; + validate(callback: BodyResponseCallback): void; + validate( + paramsOrCallback?: + | Params$Resource$Jwt$Validate + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || {}) as Params$Resource$Jwt$Validate; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Jwt$Validate; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://walletobjects.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: (rootUrl + '/walletobjects/v1/jwt/validate').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$Jwt$Insert extends StandardParameters { @@ -14856,6 +15023,12 @@ export namespace walletobjects_v1 { */ requestBody?: Schema$JwtResource; } + export interface Params$Resource$Jwt$Validate extends StandardParameters { + /** + * Request body metadata + */ + requestBody?: Schema$JwtValidateRequest; + } export class Resource$Loyaltyclass { context: APIRequestContext; diff --git a/src/apis/webcontentpublisher/v1.ts b/src/apis/webcontentpublisher/v1.ts index 48173a32085..2381c321dd9 100644 --- a/src/apis/webcontentpublisher/v1.ts +++ b/src/apis/webcontentpublisher/v1.ts @@ -228,6 +228,10 @@ export namespace webcontentpublisher_v1 { * Optional. Whether the user is required to provide their name to sign up. */ nameRequired?: boolean | null; + /** + * Optional. Whether checking the opt-in checkbox is required. + */ + optInRequired?: boolean | null; /** * Required. The title of the newsletter signup prompt. */ @@ -1538,6 +1542,158 @@ export namespace webcontentpublisher_v1 { return createAPIRequest(parameters); } } + + /** + * Updates a CTA. + * @example + * ```js + * // Before running the sample: + * // - Enable the API at: + * // https://console.developers.google.com/apis/api/webcontentpublisher.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 webcontentpublisher = google.webcontentpublisher('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 webcontentpublisher.organizations.publications.ctas.patch({ + * // Identifier. The resource name of the Cta. Format: organizations/{organization\}/publications/{publication\}/ctas/{cta\} + * name: 'organizations/my-organization/publications/my-publication/ctas/my-cta', + * // Optional. The list of fields to update. + * updateMask: 'placeholder-value', + * + * // Request body metadata + * requestBody: { + * // request body parameters + * // { + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "newsletterConfig": {}, + * // "state": "my_state", + * // "type": "my_type" + * // } + * }, + * }); + * console.log(res.data); + * + * // Example response + * // { + * // "displayName": "my_displayName", + * // "name": "my_name", + * // "newsletterConfig": {}, + * // "state": "my_state", + * // "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$Organizations$Publications$Ctas$Patch, + options: StreamMethodOptions + ): Promise>; + patch( + params?: Params$Resource$Organizations$Publications$Ctas$Patch, + options?: MethodOptions + ): Promise>; + patch( + params: Params$Resource$Organizations$Publications$Ctas$Patch, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Organizations$Publications$Ctas$Patch, + options: MethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + patch( + params: Params$Resource$Organizations$Publications$Ctas$Patch, + callback: BodyResponseCallback + ): void; + patch(callback: BodyResponseCallback): void; + patch( + paramsOrCallback?: + | Params$Resource$Organizations$Publications$Ctas$Patch + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + BodyResponseCallback | BodyResponseCallback + ): + | void + | Promise> + | Promise> { + let params = (paramsOrCallback || + {}) as Params$Resource$Organizations$Publications$Ctas$Patch; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = {} as Params$Resource$Organizations$Publications$Ctas$Patch; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://webcontentpublisher.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$Organizations$Publications$Ctas$Create extends StandardParameters { @@ -1575,6 +1731,21 @@ export namespace webcontentpublisher_v1 { */ parent?: string; } + export interface Params$Resource$Organizations$Publications$Ctas$Patch extends StandardParameters { + /** + * Identifier. The resource name of the Cta. Format: organizations/{organization\}/publications/{publication\}/ctas/{cta\} + */ + name?: string; + /** + * Optional. The list of fields to update. + */ + updateMask?: string; + + /** + * Request body metadata + */ + requestBody?: Schema$Cta; + } export class Resource$Publications { context: APIRequestContext; diff --git a/src/apis/youtube/v3.ts b/src/apis/youtube/v3.ts index 53ca6b6415f..01b77a99d05 100644 --- a/src/apis/youtube/v3.ts +++ b/src/apis/youtube/v3.ts @@ -520,6 +520,54 @@ export namespace youtube_v3 { */ type?: string | null; } + /** + * Common proto for Live and VOD geo-restrictions + */ + export interface Schema$AvailabilityConfig { + /** + * Video is available in all regions except the ones specified in the config. + */ + globalConfig?: Schema$AvailabilityConfigGlobalConfig; + /** + * Video is available in the specified regions only. + */ + regionsConfig?: Schema$AvailabilityConfigRegionsConfig; + } + /** + * Video is available in all regions except the ones specified in the excluded_region_codes list. + */ + export interface Schema$AvailabilityConfigGlobalConfig { + /** + * Optional. Regions where video is blocked + */ + excludedRegionCodes?: string[] | null; + /** + * Default time window where video is available for all non-blocked regions Not supported for upcoming / active live broadcasts. If start time is unspecified, video is already available If end time is unspecified, video is available forever Specified start and end times cannot be more than five years in the future. + */ + interval?: Schema$Interval; + } + /** + * Video is available in the specified regions only. + */ + export interface Schema$AvailabilityConfigRegionsConfig { + /** + * Required. List of regions and time windows where video is available. If a region is specified multiple times, the union of all intervals is used. + */ + regionIntervals?: Schema$AvailabilityConfigRegionsConfigRegionInterval[]; + } + /** + * Region and time window where video is available for the region. + */ + export interface Schema$AvailabilityConfigRegionsConfigRegionInterval { + /** + * Time window where video is available for the region. Not supported for upcoming / active live broadcasts. If start time is unspecified, video is already available If end time is unspecified, video is available forever Specified start and end times cannot be more than five years in the future. + */ + interval?: Schema$Interval; + /** + * Required. Region where video is available + */ + regionCode?: string | null; + } /** * Response for the Videos.stats API. Returns VideoStat information about a batch of videos. VideoStat contains a subset of the information in Video that is relevant to statistics and content details. BatchGetStats is intentionally not atomic to provide a better user experience. BatchGetStatsResponse returns a summary to help users understand the outcome of the operation. */ @@ -2045,6 +2093,19 @@ export namespace youtube_v3 { */ streamName?: string | null; } + /** + * Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. + */ + export interface Schema$Interval { + /** + * Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end. + */ + endTime?: string | null; + /** + * Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start. + */ + startTime?: string | null; + } /** * Describes an invideo branding. */ @@ -2150,6 +2211,10 @@ export namespace youtube_v3 { * Detailed settings of a broadcast. */ export interface Schema$LiveBroadcastContentDetails { + /** + * Optional. The broadcast's availability config. Used to set specific region availability or block specific regions It is optional - if not set, it is not enforced. + */ + availabilityConfig?: Schema$AvailabilityConfig; /** * This value uniquely identifies the live stream bound to the broadcast. */ diff --git a/src/index.ts b/src/index.ts index c40b7ce9ae4..a593828fb3d 100644 --- a/src/index.ts +++ b/src/index.ts @@ -57,6 +57,7 @@ export {alertcenter_v1beta1} from './apis/alertcenter/v1beta1'; export {alloydb_v1} from './apis/alloydb/v1'; export {alloydb_v1alpha} from './apis/alloydb/v1alpha'; export {alloydb_v1beta} from './apis/alloydb/v1beta'; +export {analytics_v3} from './apis/analytics/v3'; export {analyticsadmin_v1alpha} from './apis/analyticsadmin/v1alpha'; export {analyticsadmin_v1beta} from './apis/analyticsadmin/v1beta'; export {analyticsdata_v1alpha} from './apis/analyticsdata/v1alpha'; @@ -64,6 +65,7 @@ export {analyticsdata_v1beta} from './apis/analyticsdata/v1beta'; export {analyticshub_v1} from './apis/analyticshub/v1'; export {analyticshub_v1beta1} from './apis/analyticshub/v1beta1'; export {analyticsreporting_v4} from './apis/analyticsreporting/v4'; +export {androiddeveloperidstatus_v1} from './apis/androiddeveloperidstatus/v1'; export {androiddeviceprovisioning_v1} from './apis/androiddeviceprovisioning/v1'; export {androidenterprise_v1} from './apis/androidenterprise/v1'; export {androidmanagement_v1} from './apis/androidmanagement/v1'; @@ -310,6 +312,8 @@ export {firestore_v1beta1} from './apis/firestore/v1beta1'; export {firestore_v1beta2} from './apis/firestore/v1beta2'; export {fitness_v1} from './apis/fitness/v1'; export {forms_v1} from './apis/forms/v1'; +export {ftp_v1} from './apis/ftp/v1'; +export {ftp_v1alpha} from './apis/ftp/v1alpha'; export {games_v1} from './apis/games/v1'; export {gamesConfiguration_v1configuration} from './apis/gamesConfiguration/v1configuration'; export {gamesManagement_v1management} from './apis/gamesManagement/v1management'; @@ -389,6 +393,7 @@ export {merchantapi_issueresolution_v1} from './apis/merchantapi/issueresolution export {merchantapi_issueresolution_v1beta} from './apis/merchantapi/issueresolution_v1beta'; export {merchantapi_lfp_v1} from './apis/merchantapi/lfp_v1'; export {merchantapi_lfp_v1beta} from './apis/merchantapi/lfp_v1beta'; +export {merchantapi_loyaltycustomers_v1} from './apis/merchantapi/loyaltycustomers_v1'; export {merchantapi_notifications_v1} from './apis/merchantapi/notifications_v1'; export {merchantapi_notifications_v1beta} from './apis/merchantapi/notifications_v1beta'; export {merchantapi_ordertracking_v1} from './apis/merchantapi/ordertracking_v1';