feat: add support for Universe Domain via service address template (#…

…6887) feat: mark new surface GA and previous surface deprecated PiperOrigin-RevId: 591226459 Source-Link: googleapis/googleapis@5c1f64e Source-Link: googleapis/googleapis-gen@7f5ce2a Copy-Tag: eyJwIjoiSWFtQ3JlZGVudGlhbHMvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiSWFwLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiSWRzLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiSW90Ly5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiS21zLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiS21zSW52ZW50b3J5Ly5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiTGFuZ3VhZ2UvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiTGlmZVNjaWVuY2VzLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiTG9nZ2luZy8uT3dsQm90LnlhbWwiLCJoIjoiN2Y1Y2UyYWIxOWU3MTBjZTlhMDg2ZDhiZWQzZjc0MzBiY2U0MjUwNiJ9 Copy-Tag: eyJwIjoiTG9uZ1J1bm5pbmcvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiTWFuYWdlZElkZW50aXRpZXMvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiTWVkaWFUcmFuc2xhdGlvbi8uT3dsQm90LnlhbWwiLCJoIjoiN2Y1Y2UyYWIxOWU3MTBjZTlhMDg2ZDhiZWQzZjc0MzBiY2U0MjUwNiJ9 Copy-Tag: eyJwIjoiTWVtY2FjaGUvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiTWlncmF0aW9uQ2VudGVyLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiTW9uaXRvcmluZy8uT3dsQm90LnlhbWwiLCJoIjoiN2Y1Y2UyYWIxOWU3MTBjZTlhMDg2ZDhiZWQzZjc0MzBiY2U0MjUwNiJ9 Copy-Tag: eyJwIjoiTmV0QXBwLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiTmV0d29ya0Nvbm5lY3Rpdml0eS8uT3dsQm90LnlhbWwiLCJoIjoiN2Y1Y2UyYWIxOWU3MTBjZTlhMDg2ZDhiZWQzZjc0MzBiY2U0MjUwNiJ9 Copy-Tag: eyJwIjoiTmV0d29ya01hbmFnZW1lbnQvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiTmV0d29ya1NlY3VyaXR5Ly5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiTm90ZWJvb2tzLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0=
googleapis · Dec 15, 2023 · 5ef552e · 5ef552e
1 parent 89e362f
commit 5ef552e
Show file tree

Hide file tree

Showing 71 changed files with 1,672 additions and 1,269 deletions.
diff --git a/IamCredentials/src/V1/Client/IAMCredentialsClient.php b/IamCredentials/src/V1/Client/IAMCredentialsClient.php
@@ -61,12 +61,6 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This class is currently experimental and may be subject to changes. See {@see
- * \Google\Cloud\Iam\Credentials\V1\IAMCredentialsClient} for the stable
- * implementation
- *
- * @experimental
- *
  * @method PromiseInterface generateAccessTokenAsync(GenerateAccessTokenRequest $request, array $optionalArgs = [])
  * @method PromiseInterface generateIdTokenAsync(GenerateIdTokenRequest $request, array $optionalArgs = [])
  * @method PromiseInterface signBlobAsync(SignBlobRequest $request, array $optionalArgs = [])
@@ -80,9 +74,16 @@ final class IAMCredentialsClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.iam.credentials.v1.IAMCredentials';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'iamcredentials.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'iamcredentials.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/IamCredentials/src/V1/Gapic/IAMCredentialsGapicClient.php b/IamCredentials/src/V1/Gapic/IAMCredentialsGapicClient.php
@@ -73,9 +73,7 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This service has a new (beta) implementation. See {@see
- * \Google\Cloud\Iam\Credentials\V1\Client\IAMCredentialsClient} to use the new
- * surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Iam\Credentials\V1\Client\IAMCredentialsClient}.
  */
 class IAMCredentialsGapicClient
 {
@@ -84,9 +82,16 @@ class IAMCredentialsGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.iam.credentials.v1.IAMCredentials';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'iamcredentials.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'iamcredentials.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Iap/src/V1/Client/IdentityAwareProxyAdminServiceClient.php b/Iap/src/V1/Client/IdentityAwareProxyAdminServiceClient.php
@@ -60,12 +60,6 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This class is currently experimental and may be subject to changes. See {@see
- * \Google\Cloud\Iap\V1\IdentityAwareProxyAdminServiceClient} for the stable
- * implementation
- *
- * @experimental
- *
  * @method PromiseInterface createTunnelDestGroupAsync(CreateTunnelDestGroupRequest $request, array $optionalArgs = [])
  * @method PromiseInterface deleteTunnelDestGroupAsync(DeleteTunnelDestGroupRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getIamPolicyAsync(GetIamPolicyRequest $request, array $optionalArgs = [])
@@ -85,9 +79,16 @@ final class IdentityAwareProxyAdminServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.iap.v1.IdentityAwareProxyAdminService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'iap.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'iap.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Iap/src/V1/Client/IdentityAwareProxyOAuthServiceClient.php b/Iap/src/V1/Client/IdentityAwareProxyOAuthServiceClient.php
@@ -53,12 +53,6 @@
  * This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods.
  *
- * This class is currently experimental and may be subject to changes. See {@see
- * \Google\Cloud\Iap\V1\IdentityAwareProxyOAuthServiceClient} for the stable
- * implementation
- *
- * @experimental
- *
  * @method PromiseInterface createBrandAsync(CreateBrandRequest $request, array $optionalArgs = [])
  * @method PromiseInterface createIdentityAwareProxyClientAsync(CreateIdentityAwareProxyClientRequest $request, array $optionalArgs = [])
  * @method PromiseInterface deleteIdentityAwareProxyClientAsync(DeleteIdentityAwareProxyClientRequest $request, array $optionalArgs = [])
@@ -75,9 +69,16 @@ final class IdentityAwareProxyOAuthServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.iap.v1.IdentityAwareProxyOAuthService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'iap.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'iap.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Iap/src/V1/Gapic/IdentityAwareProxyAdminServiceGapicClient.php b/Iap/src/V1/Gapic/IdentityAwareProxyAdminServiceGapicClient.php
@@ -75,9 +75,7 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This service has a new (beta) implementation. See {@see
- * \Google\Cloud\Iap\V1\Client\IdentityAwareProxyAdminServiceClient} to use the new
- * surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Iap\V1\Client\IdentityAwareProxyAdminServiceClient}.
  */
 class IdentityAwareProxyAdminServiceGapicClient
 {
@@ -86,9 +84,16 @@ class IdentityAwareProxyAdminServiceGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.cloud.iap.v1.IdentityAwareProxyAdminService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'iap.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'iap.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Iap/src/V1/Gapic/IdentityAwareProxyOAuthServiceGapicClient.php b/Iap/src/V1/Gapic/IdentityAwareProxyOAuthServiceGapicClient.php
@@ -65,9 +65,7 @@
  * }
  * ```
  *
- * This service has a new (beta) implementation. See {@see
- * \Google\Cloud\Iap\V1\Client\IdentityAwareProxyOAuthServiceClient} to use the new
- * surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Iap\V1\Client\IdentityAwareProxyOAuthServiceClient}.
  */
 class IdentityAwareProxyOAuthServiceGapicClient
 {
@@ -76,9 +74,16 @@ class IdentityAwareProxyOAuthServiceGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.cloud.iap.v1.IdentityAwareProxyOAuthService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'iap.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'iap.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Ids/src/V1/Client/IDSClient.php b/Ids/src/V1/Client/IDSClient.php
@@ -54,11 +54,6 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This class is currently experimental and may be subject to changes. See {@see
- * \Google\Cloud\Ids\V1\IDSClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface createEndpointAsync(CreateEndpointRequest $request, array $optionalArgs = [])
  * @method PromiseInterface deleteEndpointAsync(DeleteEndpointRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getEndpointAsync(GetEndpointRequest $request, array $optionalArgs = [])
@@ -72,9 +67,16 @@ final class IDSClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.ids.v1.IDS';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'ids.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'ids.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Ids/src/V1/Gapic/IDSGapicClient.php b/Ids/src/V1/Gapic/IDSGapicClient.php
@@ -91,8 +91,7 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This service has a new (beta) implementation. See {@see
- * \Google\Cloud\Ids\V1\Client\IDSClient} to use the new surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Ids\V1\Client\IDSClient}.
  */
 class IDSGapicClient
 {
@@ -101,9 +100,16 @@ class IDSGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.cloud.ids.v1.IDS';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'ids.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'ids.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Iot/src/V1/Client/DeviceManagerClient.php b/Iot/src/V1/Client/DeviceManagerClient.php
@@ -75,11 +75,6 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This class is currently experimental and may be subject to changes. See {@see
- * \Google\Cloud\Iot\V1\DeviceManagerClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface bindDeviceToGatewayAsync(BindDeviceToGatewayRequest $request, array $optionalArgs = [])
  * @method PromiseInterface createDeviceAsync(CreateDeviceRequest $request, array $optionalArgs = [])
  * @method PromiseInterface createDeviceRegistryAsync(CreateDeviceRegistryRequest $request, array $optionalArgs = [])
@@ -108,9 +103,16 @@ final class DeviceManagerClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.iot.v1.DeviceManager';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'cloudiot.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'cloudiot.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Iot/src/V1/Gapic/DeviceManagerGapicClient.php b/Iot/src/V1/Gapic/DeviceManagerGapicClient.php
@@ -92,8 +92,7 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This service has a new (beta) implementation. See {@see
- * \Google\Cloud\Iot\V1\Client\DeviceManagerClient} to use the new surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Iot\V1\Client\DeviceManagerClient}.
  */
 class DeviceManagerGapicClient
 {
@@ -102,9 +101,16 @@ class DeviceManagerGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.cloud.iot.v1.DeviceManager';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'cloudiot.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'cloudiot.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Kms/src/V1/Client/EkmServiceClient.php b/Kms/src/V1/Client/EkmServiceClient.php
@@ -68,11 +68,6 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This class is currently experimental and may be subject to changes. See {@see
- * \Google\Cloud\Kms\V1\EkmServiceClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface createEkmConnectionAsync(CreateEkmConnectionRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getEkmConfigAsync(GetEkmConfigRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getEkmConnectionAsync(GetEkmConnectionRequest $request, array $optionalArgs = [])
@@ -94,9 +89,16 @@ final class EkmServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.kms.v1.EkmService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'cloudkms.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'cloudkms.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Kms/src/V1/Client/KeyManagementServiceClient.php b/Kms/src/V1/Client/KeyManagementServiceClient.php
@@ -107,11 +107,6 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This class is currently experimental and may be subject to changes. See {@see
- * \Google\Cloud\Kms\V1\KeyManagementServiceClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface asymmetricDecryptAsync(AsymmetricDecryptRequest $request, array $optionalArgs = [])
  * @method PromiseInterface asymmetricSignAsync(AsymmetricSignRequest $request, array $optionalArgs = [])
  * @method PromiseInterface createCryptoKeyAsync(CreateCryptoKeyRequest $request, array $optionalArgs = [])
@@ -154,9 +149,16 @@ final class KeyManagementServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.kms.v1.KeyManagementService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'cloudkms.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'cloudkms.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Kms/src/V1/Gapic/EkmServiceGapicClient.php b/Kms/src/V1/Gapic/EkmServiceGapicClient.php
@@ -84,8 +84,7 @@
  * name, and additionally a parseName method to extract the individual identifiers
  * contained within formatted names that are returned by the API.
  *
- * This service has a new (beta) implementation. See {@see
- * \Google\Cloud\Kms\V1\Client\EkmServiceClient} to use the new surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Kms\V1\Client\EkmServiceClient}.
  */
 class EkmServiceGapicClient
 {
@@ -94,9 +93,16 @@ class EkmServiceGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.cloud.kms.v1.EkmService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'cloudkms.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'cloudkms.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;