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

…6890) 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: eyJwIjoiU3RvcmFnZVRyYW5zZmVyLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiU3VwcG9ydC8uT3dsQm90LnlhbWwiLCJoIjoiN2Y1Y2UyYWIxOWU3MTBjZTlhMDg2ZDhiZWQzZjc0MzBiY2U0MjUwNiJ9 Copy-Tag: eyJwIjoiVGFsZW50Ly5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVGFza3MvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiVGVsY29BdXRvbWF0aW9uLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVGV4dFRvU3BlZWNoLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVHB1Ly5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVHJhY2UvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiVHJhbnNsYXRlLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVmlkZW9JbnRlbGxpZ2VuY2UvLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiVmlkZW9MaXZlU3RyZWFtLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVmlkZW9TdGl0Y2hlci8uT3dsQm90LnlhbWwiLCJoIjoiN2Y1Y2UyYWIxOWU3MTBjZTlhMDg2ZDhiZWQzZjc0MzBiY2U0MjUwNiJ9 Copy-Tag: eyJwIjoiVmlkZW9UcmFuc2NvZGVyLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVmlzaW9uLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVm1NaWdyYXRpb24vLk93bEJvdC55YW1sIiwiaCI6IjdmNWNlMmFiMTllNzEwY2U5YTA4NmQ4YmVkM2Y3NDMwYmNlNDI1MDYifQ== Copy-Tag: eyJwIjoiVm13YXJlRW5naW5lLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiVnBjQWNjZXNzLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiV2ViUmlzay8uT3dsQm90LnlhbWwiLCJoIjoiN2Y1Y2UyYWIxOWU3MTBjZTlhMDg2ZDhiZWQzZjc0MzBiY2U0MjUwNiJ9 Copy-Tag: eyJwIjoiV2ViU2VjdXJpdHlTY2FubmVyLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0= Copy-Tag: eyJwIjoiV29ya2Zsb3dzLy5Pd2xCb3QueWFtbCIsImgiOiI3ZjVjZTJhYjE5ZTcxMGNlOWEwODZkOGJlZDNmNzQzMGJjZTQyNTA2In0=
googleapis · Dec 15, 2023 · f8e4dc4 · f8e4dc4
1 parent 5c8aaa5
commit f8e4dc4
Show file tree

Hide file tree

Showing 64 changed files with 1,296 additions and 748 deletions.
diff --git a/StorageTransfer/src/V1/Client/StorageTransferServiceClient.php b/StorageTransfer/src/V1/Client/StorageTransferServiceClient.php
@@ -69,12 +69,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\StorageTransfer\V1\StorageTransferServiceClient} for the stable
- * implementation
- *
- * @experimental
- *
  * @method PromiseInterface createAgentPoolAsync(CreateAgentPoolRequest $request, array $optionalArgs = [])
  * @method PromiseInterface createTransferJobAsync(CreateTransferJobRequest $request, array $optionalArgs = [])
  * @method PromiseInterface deleteAgentPoolAsync(DeleteAgentPoolRequest $request, array $optionalArgs = [])
@@ -98,9 +92,16 @@ final class StorageTransferServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.storagetransfer.v1.StorageTransferService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'storagetransfer.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'storagetransfer.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/StorageTransfer/src/V1/Gapic/StorageTransferServiceGapicClient.php b/StorageTransfer/src/V1/Gapic/StorageTransferServiceGapicClient.php
@@ -84,9 +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\StorageTransfer\V1\Client\StorageTransferServiceClient} to use the
- * new surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\StorageTransfer\V1\Client\StorageTransferServiceClient}.
  */
 class StorageTransferServiceGapicClient
 {
@@ -95,9 +93,16 @@ class StorageTransferServiceGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.storagetransfer.v1.StorageTransferService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'storagetransfer.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'storagetransfer.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Support/src/V2/Client/CaseAttachmentServiceClient.php b/Support/src/V2/Client/CaseAttachmentServiceClient.php
@@ -47,10 +47,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.
- *
- * @experimental
- *
  * @method PromiseInterface listAttachmentsAsync(ListAttachmentsRequest $request, array $optionalArgs = [])
  */
 final class CaseAttachmentServiceClient
@@ -61,9 +57,16 @@ final class CaseAttachmentServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.support.v2.CaseAttachmentService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'cloudsupport.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'cloudsupport.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Support/src/V2/Client/CaseServiceClient.php b/Support/src/V2/Client/CaseServiceClient.php
@@ -55,10 +55,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.
- *
- * @experimental
- *
  * @method PromiseInterface closeCaseAsync(CloseCaseRequest $request, array $optionalArgs = [])
  * @method PromiseInterface createCaseAsync(CreateCaseRequest $request, array $optionalArgs = [])
  * @method PromiseInterface escalateCaseAsync(EscalateCaseRequest $request, array $optionalArgs = [])
@@ -76,9 +72,16 @@ final class CaseServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.support.v2.CaseService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'cloudsupport.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'cloudsupport.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Support/src/V2/Client/CommentServiceClient.php b/Support/src/V2/Client/CommentServiceClient.php
@@ -49,10 +49,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.
- *
- * @experimental
- *
  * @method PromiseInterface createCommentAsync(CreateCommentRequest $request, array $optionalArgs = [])
  * @method PromiseInterface listCommentsAsync(ListCommentsRequest $request, array $optionalArgs = [])
  */
@@ -64,9 +60,16 @@ final class CommentServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.support.v2.CommentService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'cloudsupport.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'cloudsupport.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Talent/src/V4/Client/CompanyServiceClient.php b/Talent/src/V4/Client/CompanyServiceClient.php
@@ -52,11 +52,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\Talent\V4\CompanyServiceClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface createCompanyAsync(CreateCompanyRequest $request, array $optionalArgs = [])
  * @method PromiseInterface deleteCompanyAsync(DeleteCompanyRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getCompanyAsync(GetCompanyRequest $request, array $optionalArgs = [])
@@ -71,9 +66,16 @@ final class CompanyServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.talent.v4.CompanyService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'jobs.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'jobs.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Talent/src/V4/Client/CompletionClient.php b/Talent/src/V4/Client/CompletionClient.php
@@ -47,11 +47,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\Talent\V4\CompletionClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface completeQueryAsync(CompleteQueryRequest $request, array $optionalArgs = [])
  */
 final class CompletionClient
@@ -62,9 +57,16 @@ final class CompletionClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.talent.v4.Completion';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'jobs.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'jobs.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Talent/src/V4/Client/EventServiceClient.php b/Talent/src/V4/Client/EventServiceClient.php
@@ -47,11 +47,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\Talent\V4\EventServiceClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface createClientEventAsync(CreateClientEventRequest $request, array $optionalArgs = [])
  */
 final class EventServiceClient
@@ -62,9 +57,16 @@ final class EventServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.talent.v4.EventService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'jobs.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'jobs.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Talent/src/V4/Client/JobServiceClient.php b/Talent/src/V4/Client/JobServiceClient.php
@@ -60,11 +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\Talent\V4\JobServiceClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface batchCreateJobsAsync(BatchCreateJobsRequest $request, array $optionalArgs = [])
  * @method PromiseInterface batchDeleteJobsAsync(BatchDeleteJobsRequest $request, array $optionalArgs = [])
  * @method PromiseInterface batchUpdateJobsAsync(BatchUpdateJobsRequest $request, array $optionalArgs = [])
@@ -84,9 +79,16 @@ final class JobServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.talent.v4.JobService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'jobs.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'jobs.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Talent/src/V4/Client/TenantServiceClient.php b/Talent/src/V4/Client/TenantServiceClient.php
@@ -52,11 +52,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\Talent\V4\TenantServiceClient} for the stable implementation
- *
- * @experimental
- *
  * @method PromiseInterface createTenantAsync(CreateTenantRequest $request, array $optionalArgs = [])
  * @method PromiseInterface deleteTenantAsync(DeleteTenantRequest $request, array $optionalArgs = [])
  * @method PromiseInterface getTenantAsync(GetTenantRequest $request, array $optionalArgs = [])
@@ -71,9 +66,16 @@ final class TenantServiceClient
     /** The name of the service. */
     private const SERVICE_NAME = 'google.cloud.talent.v4.TenantService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     private const SERVICE_ADDRESS = 'jobs.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'jobs.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     private const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Talent/src/V4/Gapic/CompanyServiceGapicClient.php b/Talent/src/V4/Gapic/CompanyServiceGapicClient.php
@@ -65,8 +65,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\Talent\V4\Client\CompanyServiceClient} to use the new surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Talent\V4\Client\CompanyServiceClient}.
  */
 class CompanyServiceGapicClient
 {
@@ -75,9 +74,16 @@ class CompanyServiceGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.cloud.talent.v4.CompanyService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'jobs.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'jobs.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Talent/src/V4/Gapic/CompletionGapicClient.php b/Talent/src/V4/Gapic/CompletionGapicClient.php
@@ -61,8 +61,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\Talent\V4\Client\CompletionClient} to use the new surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Talent\V4\Client\CompletionClient}.
  */
 class CompletionGapicClient
 {
@@ -71,9 +70,16 @@ class CompletionGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.cloud.talent.v4.Completion';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'jobs.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'jobs.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;
 

diff --git a/Talent/src/V4/Gapic/EventServiceGapicClient.php b/Talent/src/V4/Gapic/EventServiceGapicClient.php
@@ -58,8 +58,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\Talent\V4\Client\EventServiceClient} to use the new surface.
+ * @deprecated Please use the new service client {@see \Google\Cloud\Talent\V4\Client\EventServiceClient}.
  */
 class EventServiceGapicClient
 {
@@ -68,9 +67,16 @@ class EventServiceGapicClient
     /** The name of the service. */
     const SERVICE_NAME = 'google.cloud.talent.v4.EventService';
 
-    /** The default address of the service. */
+    /**
+     * The default address of the service.
+     *
+     * @deprecated SERVICE_ADDRESS_TEMPLATE should be used instead.
+     */
     const SERVICE_ADDRESS = 'jobs.googleapis.com';
 
+    /** The address template of the service. */
+    private const SERVICE_ADDRESS_TEMPLATE = 'jobs.UNIVERSE_DOMAIN';
+
     /** The default port of the service. */
     const DEFAULT_SERVICE_PORT = 443;