From 09e44234121af299286afa597632c772fd66f8d0 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Tue, 16 Feb 2021 09:53:21 -0800 Subject: [PATCH] docs: generate sample code in the Java microgenerator (#409) Committer: @miraleung PiperOrigin-RevId: 356341083 Source-Author: Google APIs Source-Date: Mon Feb 8 13:33:28 2021 -0800 Source-Repo: googleapis/googleapis Source-Sha: 8d8c008e56f1af31d57f75561e0f1848ffb29eeb Source-Link: https://github.com/googleapis/googleapis/commit/8d8c008e56f1af31d57f75561e0f1848ffb29eeb --- .../cloud/talent/v4/CompanyServiceClient.java | 248 +++++++ .../cloud/talent/v4/CompletionClient.java | 47 ++ .../cloud/talent/v4/EventServiceClient.java | 55 ++ .../cloud/talent/v4/JobServiceClient.java | 522 +++++++++++++++ .../cloud/talent/v4/TenantServiceClient.java | 245 +++++++ .../google/cloud/talent/v4/package-info.java | 46 ++ .../v4beta1/ApplicationServiceClient.java | 262 ++++++++ .../talent/v4beta1/CompanyServiceClient.java | 290 ++++++++ .../talent/v4beta1/CompletionClient.java | 59 ++ .../talent/v4beta1/EventServiceClient.java | 70 ++ .../talent/v4beta1/JobServiceClient.java | 623 ++++++++++++++++++ .../talent/v4beta1/ProfileServiceClient.java | 319 +++++++++ .../talent/v4beta1/TenantServiceClient.java | 244 +++++++ .../cloud/talent/v4beta1/package-info.java | 66 ++ synth.metadata | 8 +- 15 files changed, 3100 insertions(+), 4 deletions(-) diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/CompanyServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/CompanyServiceClient.java index 5ba1fb40..af96dc62 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/CompanyServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/CompanyServiceClient.java @@ -43,6 +43,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+ *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+ *   Company company = Company.newBuilder().build();
+ *   Company response = companyServiceClient.createCompany(parent, company);
+ * }
+ * }
+ * *

Note: close() needs to be called on the CompanyServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -146,6 +154,16 @@ public CompanyServiceStub getStub() { /** * Creates a new company entity. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   Company company = Company.newBuilder().build();
+   *   Company response = companyServiceClient.createCompany(parent, company);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -165,6 +183,16 @@ public final Company createCompany(TenantName parent, Company company) { /** * Creates a new company entity. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   String parent = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   Company company = Company.newBuilder().build();
+   *   Company response = companyServiceClient.createCompany(parent, company);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -181,6 +209,19 @@ public final Company createCompany(String parent, Company company) { /** * Creates a new company entity. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   CreateCompanyRequest request =
+   *       CreateCompanyRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setCompany(Company.newBuilder().build())
+   *           .build();
+   *   Company response = companyServiceClient.createCompany(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -193,6 +234,19 @@ public final Company createCompany(CreateCompanyRequest request) { * Creates a new company entity. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   CreateCompanyRequest request =
+   *       CreateCompanyRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setCompany(Company.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = companyServiceClient.createCompanyCallable().futureCall(request);
+   *   // Do something.
+   *   Company response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createCompanyCallable() { return stub.createCompanyCallable(); @@ -202,6 +256,15 @@ public final UnaryCallable createCompanyCallable( /** * Retrieves specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   CompanyName name = CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]");
+   *   Company response = companyServiceClient.getCompany(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the company to be retrieved. *

The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for * example, "projects/api-test-project/tenants/foo/companies/bar". @@ -217,6 +280,15 @@ public final Company getCompany(CompanyName name) { /** * Retrieves specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   String name = CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString();
+   *   Company response = companyServiceClient.getCompany(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the company to be retrieved. *

The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for * example, "projects/api-test-project/tenants/foo/companies/bar". @@ -231,6 +303,18 @@ public final Company getCompany(String name) { /** * Retrieves specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   GetCompanyRequest request =
+   *       GetCompanyRequest.newBuilder()
+   *           .setName(CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString())
+   *           .build();
+   *   Company response = companyServiceClient.getCompany(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -243,6 +327,18 @@ public final Company getCompany(GetCompanyRequest request) { * Retrieves specified company. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   GetCompanyRequest request =
+   *       GetCompanyRequest.newBuilder()
+   *           .setName(CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString())
+   *           .build();
+   *   ApiFuture future = companyServiceClient.getCompanyCallable().futureCall(request);
+   *   // Do something.
+   *   Company response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getCompanyCallable() { return stub.getCompanyCallable(); @@ -252,6 +348,16 @@ public final UnaryCallable getCompanyCallable() { /** * Updates specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   Company company = Company.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   Company response = companyServiceClient.updateCompany(company, updateMask);
+   * }
+   * }
+ * * @param company Required. The company resource to replace the current resource in the system. * @param updateMask Strongly recommended for the best service experience. *

If [update_mask][google.cloud.talent.v4.UpdateCompanyRequest.update_mask] is provided, @@ -271,6 +377,19 @@ public final Company updateCompany(Company company, FieldMask updateMask) { /** * Updates specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   UpdateCompanyRequest request =
+   *       UpdateCompanyRequest.newBuilder()
+   *           .setCompany(Company.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Company response = companyServiceClient.updateCompany(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -283,6 +402,19 @@ public final Company updateCompany(UpdateCompanyRequest request) { * Updates specified company. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   UpdateCompanyRequest request =
+   *       UpdateCompanyRequest.newBuilder()
+   *           .setCompany(Company.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = companyServiceClient.updateCompanyCallable().futureCall(request);
+   *   // Do something.
+   *   Company response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateCompanyCallable() { return stub.updateCompanyCallable(); @@ -292,6 +424,15 @@ public final UnaryCallable updateCompanyCallable( /** * Deletes specified company. Prerequisite: The company has no jobs associated with it. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   CompanyName name = CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]");
+   *   companyServiceClient.deleteCompany(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the company to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for * example, "projects/foo/tenants/bar/companies/baz". @@ -307,6 +448,15 @@ public final void deleteCompany(CompanyName name) { /** * Deletes specified company. Prerequisite: The company has no jobs associated with it. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   String name = CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString();
+   *   companyServiceClient.deleteCompany(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the company to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for * example, "projects/foo/tenants/bar/companies/baz". @@ -321,6 +471,18 @@ public final void deleteCompany(String name) { /** * Deletes specified company. Prerequisite: The company has no jobs associated with it. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   DeleteCompanyRequest request =
+   *       DeleteCompanyRequest.newBuilder()
+   *           .setName(CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString())
+   *           .build();
+   *   companyServiceClient.deleteCompany(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -333,6 +495,18 @@ public final void deleteCompany(DeleteCompanyRequest request) { * Deletes specified company. Prerequisite: The company has no jobs associated with it. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   DeleteCompanyRequest request =
+   *       DeleteCompanyRequest.newBuilder()
+   *           .setName(CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString())
+   *           .build();
+   *   ApiFuture future = companyServiceClient.deleteCompanyCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteCompanyCallable() { return stub.deleteCompanyCallable(); @@ -342,6 +516,17 @@ public final UnaryCallable deleteCompanyCallable() /** * Lists all companies associated with the project. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   for (Company element : companyServiceClient.listCompanies(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -359,6 +544,17 @@ public final ListCompaniesPagedResponse listCompanies(TenantName parent) { /** * Lists all companies associated with the project. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   String parent = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   for (Company element : companyServiceClient.listCompanies(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -373,6 +569,23 @@ public final ListCompaniesPagedResponse listCompanies(String parent) { /** * Lists all companies associated with the project. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   ListCompaniesRequest request =
+   *       ListCompaniesRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .setRequireOpenJobs(true)
+   *           .build();
+   *   for (Company element : companyServiceClient.listCompanies(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -385,6 +598,24 @@ public final ListCompaniesPagedResponse listCompanies(ListCompaniesRequest reque * Lists all companies associated with the project. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   ListCompaniesRequest request =
+   *       ListCompaniesRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .setRequireOpenJobs(true)
+   *           .build();
+   *   ApiFuture future =
+   *       companyServiceClient.listCompaniesPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Company element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listCompaniesPagedCallable() { @@ -396,6 +627,23 @@ public final ListCompaniesPagedResponse listCompanies(ListCompaniesRequest reque * Lists all companies associated with the project. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   while (true) {
+   *     ListCompaniesResponse response = companyServiceClient.listCompaniesCallable().call(request);
+   *     for (Company element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listCompaniesCallable() { return stub.listCompaniesCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/CompletionClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/CompletionClient.java index 93c3e92a..780fafc6 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/CompletionClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/CompletionClient.java @@ -32,6 +32,20 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (CompletionClient completionClient = CompletionClient.create()) {
+ *   CompleteQueryRequest request =
+ *       CompleteQueryRequest.newBuilder()
+ *           .setTenant(TenantName.of("[PROJECT]", "[TENANT]").toString())
+ *           .setQuery("query107944136")
+ *           .addAllLanguageCodes(new ArrayList())
+ *           .setPageSize(883849137)
+ *           .setCompany(CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString())
+ *           .build();
+ *   CompleteQueryResponse response = completionClient.completeQuery(request);
+ * }
+ * }
+ * *

Note: close() needs to be called on the CompletionClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -134,6 +148,22 @@ public CompletionStub getStub() { * Completes the specified prefix with keyword suggestions. Intended for use by a job search * auto-complete search box. * + *

Sample code: + * + *

{@code
+   * try (CompletionClient completionClient = CompletionClient.create()) {
+   *   CompleteQueryRequest request =
+   *       CompleteQueryRequest.newBuilder()
+   *           .setTenant(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setQuery("query107944136")
+   *           .addAllLanguageCodes(new ArrayList())
+   *           .setPageSize(883849137)
+   *           .setCompany(CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString())
+   *           .build();
+   *   CompleteQueryResponse response = completionClient.completeQuery(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -147,6 +177,23 @@ public final CompleteQueryResponse completeQuery(CompleteQueryRequest request) { * auto-complete search box. * *

Sample code: + * + *

{@code
+   * try (CompletionClient completionClient = CompletionClient.create()) {
+   *   CompleteQueryRequest request =
+   *       CompleteQueryRequest.newBuilder()
+   *           .setTenant(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setQuery("query107944136")
+   *           .addAllLanguageCodes(new ArrayList())
+   *           .setPageSize(883849137)
+   *           .setCompany(CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString())
+   *           .build();
+   *   ApiFuture future =
+   *       completionClient.completeQueryCallable().futureCall(request);
+   *   // Do something.
+   *   CompleteQueryResponse response = future.get();
+   * }
+   * }
*/ public final UnaryCallable completeQueryCallable() { return stub.completeQueryCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/EventServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/EventServiceClient.java index e0389291..a02d1671 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/EventServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/EventServiceClient.java @@ -32,6 +32,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+ *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+ *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+ *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+ * }
+ * }
+ * *

Note: close() needs to be called on the EventServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -137,6 +145,16 @@ public EventServiceStub getStub() { * tools](https://console.cloud.google.com/talent-solution/overview). [Learn * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * + *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+   *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the event is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -160,6 +178,16 @@ public final ClientEvent createClientEvent(TenantName parent, ClientEvent client * tools](https://console.cloud.google.com/talent-solution/overview). [Learn * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * + *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   String parent = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+   *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the event is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -180,6 +208,19 @@ public final ClientEvent createClientEvent(String parent, ClientEvent clientEven * tools](https://console.cloud.google.com/talent-solution/overview). [Learn * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * + *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   CreateClientEventRequest request =
+   *       CreateClientEventRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setClientEvent(ClientEvent.newBuilder().build())
+   *           .build();
+   *   ClientEvent response = eventServiceClient.createClientEvent(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -195,6 +236,20 @@ public final ClientEvent createClientEvent(CreateClientEventRequest request) { * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   CreateClientEventRequest request =
+   *       CreateClientEventRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setClientEvent(ClientEvent.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       eventServiceClient.createClientEventCallable().futureCall(request);
+   *   // Do something.
+   *   ClientEvent response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createClientEventCallable() { return stub.createClientEventCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/JobServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/JobServiceClient.java index 0f3afc0d..229a053d 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/JobServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/JobServiceClient.java @@ -48,6 +48,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+ *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+ *   Job job = Job.newBuilder().build();
+ *   Job response = jobServiceClient.createJob(parent, job);
+ * }
+ * }
+ * *

Note: close() needs to be called on the JobServiceClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -162,6 +170,16 @@ public final OperationsClient getOperationsClient() { * *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   Job job = Job.newBuilder().build();
+   *   Job response = jobServiceClient.createJob(parent, job);
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -183,6 +201,16 @@ public final Job createJob(TenantName parent, Job job) { * *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   Job job = Job.newBuilder().build();
+   *   Job response = jobServiceClient.createJob(parent, job);
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -200,6 +228,19 @@ public final Job createJob(String parent, Job job) { * *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   CreateJobRequest request =
+   *       CreateJobRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setJob(Job.newBuilder().build())
+   *           .build();
+   *   Job response = jobServiceClient.createJob(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -214,6 +255,19 @@ public final Job createJob(CreateJobRequest request) { *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   CreateJobRequest request =
+   *       CreateJobRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setJob(Job.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.createJobCallable().futureCall(request);
+   *   // Do something.
+   *   Job response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createJobCallable() { return stub.createJobCallable(); @@ -223,6 +277,16 @@ public final UnaryCallable createJobCallable() { /** * Begins executing a batch create jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   List jobs = new ArrayList<>();
+   *   BatchCreateJobsResponse response = jobServiceClient.batchCreateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -243,6 +307,16 @@ public final UnaryCallable createJobCallable() { /** * Begins executing a batch create jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   List jobs = new ArrayList<>();
+   *   BatchCreateJobsResponse response = jobServiceClient.batchCreateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -260,6 +334,19 @@ public final UnaryCallable createJobCallable() { /** * Begins executing a batch create jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchCreateJobsRequest request =
+   *       BatchCreateJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .build();
+   *   BatchCreateJobsResponse response = jobServiceClient.batchCreateJobsAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -273,6 +360,20 @@ public final UnaryCallable createJobCallable() { * Begins executing a batch create jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchCreateJobsRequest request =
+   *       BatchCreateJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .build();
+   *   OperationFuture future =
+   *       jobServiceClient.batchCreateJobsOperationCallable().futureCall(request);
+   *   // Do something.
+   *   BatchCreateJobsResponse response = future.get();
+   * }
+   * }
*/ public final OperationCallable< BatchCreateJobsRequest, BatchCreateJobsResponse, BatchOperationMetadata> @@ -285,6 +386,19 @@ public final UnaryCallable createJobCallable() { * Begins executing a batch create jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchCreateJobsRequest request =
+   *       BatchCreateJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.batchCreateJobsCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable batchCreateJobsCallable() { return stub.batchCreateJobsCallable(); @@ -294,6 +408,15 @@ public final UnaryCallable batchCreateJobsCal /** * Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   JobName name = JobName.of("[PROJECT]", "[TENANT]", "[JOB]");
+   *   Job response = jobServiceClient.getJob(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the job to retrieve. *

The format is "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example, * "projects/foo/tenants/bar/jobs/baz". @@ -309,6 +432,15 @@ public final Job getJob(JobName name) { /** * Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String name = JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   Job response = jobServiceClient.getJob(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the job to retrieve. *

The format is "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example, * "projects/foo/tenants/bar/jobs/baz". @@ -323,6 +455,18 @@ public final Job getJob(String name) { /** * Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   GetJobRequest request =
+   *       GetJobRequest.newBuilder()
+   *           .setName(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .build();
+   *   Job response = jobServiceClient.getJob(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -335,6 +479,18 @@ public final Job getJob(GetJobRequest request) { * Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   GetJobRequest request =
+   *       GetJobRequest.newBuilder()
+   *           .setName(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.getJobCallable().futureCall(request);
+   *   // Do something.
+   *   Job response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getJobCallable() { return stub.getJobCallable(); @@ -347,6 +503,16 @@ public final UnaryCallable getJobCallable() { *

Typically, updated contents become visible in search results within 10 seconds, but it may * take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   Job job = Job.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   Job response = jobServiceClient.updateJob(job, updateMask);
+   * }
+   * }
+ * * @param job Required. The Job to be updated. * @param updateMask Strongly recommended for the best service experience. *

If [update_mask][google.cloud.talent.v4.UpdateJobRequest.update_mask] is provided, only @@ -369,6 +535,19 @@ public final Job updateJob(Job job, FieldMask updateMask) { *

Typically, updated contents become visible in search results within 10 seconds, but it may * take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   UpdateJobRequest request =
+   *       UpdateJobRequest.newBuilder()
+   *           .setJob(Job.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Job response = jobServiceClient.updateJob(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -384,6 +563,19 @@ public final Job updateJob(UpdateJobRequest request) { * take up to 5 minutes. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   UpdateJobRequest request =
+   *       UpdateJobRequest.newBuilder()
+   *           .setJob(Job.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.updateJobCallable().futureCall(request);
+   *   // Do something.
+   *   Job response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateJobCallable() { return stub.updateJobCallable(); @@ -393,6 +585,16 @@ public final UnaryCallable updateJobCallable() { /** * Begins executing a batch update jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   List jobs = new ArrayList<>();
+   *   BatchUpdateJobsResponse response = jobServiceClient.batchUpdateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -413,6 +615,16 @@ public final UnaryCallable updateJobCallable() { /** * Begins executing a batch update jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   List jobs = new ArrayList<>();
+   *   BatchUpdateJobsResponse response = jobServiceClient.batchUpdateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -430,6 +642,20 @@ public final UnaryCallable updateJobCallable() { /** * Begins executing a batch update jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchUpdateJobsRequest request =
+   *       BatchUpdateJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   BatchUpdateJobsResponse response = jobServiceClient.batchUpdateJobsAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -443,6 +669,21 @@ public final UnaryCallable updateJobCallable() { * Begins executing a batch update jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchUpdateJobsRequest request =
+   *       BatchUpdateJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   OperationFuture future =
+   *       jobServiceClient.batchUpdateJobsOperationCallable().futureCall(request);
+   *   // Do something.
+   *   BatchUpdateJobsResponse response = future.get();
+   * }
+   * }
*/ public final OperationCallable< BatchUpdateJobsRequest, BatchUpdateJobsResponse, BatchOperationMetadata> @@ -455,6 +696,20 @@ public final UnaryCallable updateJobCallable() { * Begins executing a batch update jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchUpdateJobsRequest request =
+   *       BatchUpdateJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.batchUpdateJobsCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable batchUpdateJobsCallable() { return stub.batchUpdateJobsCallable(); @@ -466,6 +721,15 @@ public final UnaryCallable batchUpdateJobsCal * *

Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   JobName name = JobName.of("[PROJECT]", "[TENANT]", "[JOB]");
+   *   jobServiceClient.deleteJob(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the job to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example, * "projects/foo/tenants/bar/jobs/baz". @@ -483,6 +747,15 @@ public final void deleteJob(JobName name) { * *

Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String name = JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   jobServiceClient.deleteJob(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the job to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example, * "projects/foo/tenants/bar/jobs/baz". @@ -499,6 +772,18 @@ public final void deleteJob(String name) { * *

Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   DeleteJobRequest request =
+   *       DeleteJobRequest.newBuilder()
+   *           .setName(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .build();
+   *   jobServiceClient.deleteJob(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -513,6 +798,18 @@ public final void deleteJob(DeleteJobRequest request) { *

Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   DeleteJobRequest request =
+   *       DeleteJobRequest.newBuilder()
+   *           .setName(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.deleteJobCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteJobCallable() { return stub.deleteJobCallable(); @@ -522,6 +819,16 @@ public final UnaryCallable deleteJobCallable() { /** * Begins executing a batch delete jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   List names = new ArrayList<>();
+   *   BatchDeleteJobsResponse response = jobServiceClient.batchDeleteJobsAsync(parent, names).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -546,6 +853,16 @@ public final UnaryCallable deleteJobCallable() { /** * Begins executing a batch delete jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   List names = new ArrayList<>();
+   *   BatchDeleteJobsResponse response = jobServiceClient.batchDeleteJobsAsync(parent, names).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -567,6 +884,19 @@ public final UnaryCallable deleteJobCallable() { /** * Begins executing a batch delete jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchDeleteJobsRequest request =
+   *       BatchDeleteJobsRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .addAllNames(new ArrayList())
+   *           .build();
+   *   BatchDeleteJobsResponse response = jobServiceClient.batchDeleteJobsAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -580,6 +910,20 @@ public final UnaryCallable deleteJobCallable() { * Begins executing a batch delete jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchDeleteJobsRequest request =
+   *       BatchDeleteJobsRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .addAllNames(new ArrayList())
+   *           .build();
+   *   OperationFuture future =
+   *       jobServiceClient.batchDeleteJobsOperationCallable().futureCall(request);
+   *   // Do something.
+   *   BatchDeleteJobsResponse response = future.get();
+   * }
+   * }
*/ public final OperationCallable< BatchDeleteJobsRequest, BatchDeleteJobsResponse, BatchOperationMetadata> @@ -592,6 +936,19 @@ public final UnaryCallable deleteJobCallable() { * Begins executing a batch delete jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchDeleteJobsRequest request =
+   *       BatchDeleteJobsRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .addAllNames(new ArrayList())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.batchDeleteJobsCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable batchDeleteJobsCallable() { return stub.batchDeleteJobsCallable(); @@ -601,6 +958,18 @@ public final UnaryCallable batchDeleteJobsCal /** * Lists jobs by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   String filter = "filter-1274492040";
+   *   for (Job element : jobServiceClient.listJobs(parent, filter).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -635,6 +1004,18 @@ public final ListJobsPagedResponse listJobs(TenantName parent, String filter) { /** * Lists jobs by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   String filter = "filter-1274492040";
+   *   for (Job element : jobServiceClient.listJobs(parent, filter).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -666,6 +1047,23 @@ public final ListJobsPagedResponse listJobs(String parent, String filter) { /** * Lists jobs by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ListJobsRequest request =
+   *       ListJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setFilter("filter-1274492040")
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   for (Job element : jobServiceClient.listJobs(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -678,6 +1076,23 @@ public final ListJobsPagedResponse listJobs(ListJobsRequest request) { * Lists jobs by filter. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ListJobsRequest request =
+   *       ListJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setFilter("filter-1274492040")
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   ApiFuture future = jobServiceClient.listJobsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Job element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listJobsPagedCallable() { return stub.listJobsPagedCallable(); @@ -688,6 +1103,23 @@ public final UnaryCallable listJobsPaged * Lists jobs by filter. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   while (true) {
+   *     ListJobsResponse response = jobServiceClient.listJobsCallable().call(request);
+   *     for (Job element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listJobsCallable() { return stub.listJobsCallable(); @@ -701,6 +1133,28 @@ public final UnaryCallable listJobsCallable() *

This call constrains the [visibility][google.cloud.talent.v4.Job.visibility] of jobs present * in the database, and only returns jobs that the caller has permission to search against. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   SearchJobsRequest request =
+   *       SearchJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setJobQuery(JobQuery.newBuilder().build())
+   *           .setEnableBroadening(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setOffset(-1019779949)
+   *           .setMaxPageSize(524069526)
+   *           .setPageToken("pageToken873572522")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCustomRankingInfo(SearchJobsRequest.CustomRankingInfo.newBuilder().build())
+   *           .setDisableKeywordMatch(true)
+   *           .build();
+   *   SearchJobsResponse response = jobServiceClient.searchJobs(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -717,6 +1171,29 @@ public final SearchJobsResponse searchJobs(SearchJobsRequest request) { * in the database, and only returns jobs that the caller has permission to search against. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   SearchJobsRequest request =
+   *       SearchJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setJobQuery(JobQuery.newBuilder().build())
+   *           .setEnableBroadening(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setOffset(-1019779949)
+   *           .setMaxPageSize(524069526)
+   *           .setPageToken("pageToken873572522")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCustomRankingInfo(SearchJobsRequest.CustomRankingInfo.newBuilder().build())
+   *           .setDisableKeywordMatch(true)
+   *           .build();
+   *   ApiFuture future =
+   *       jobServiceClient.searchJobsCallable().futureCall(request);
+   *   // Do something.
+   *   SearchJobsResponse response = future.get();
+   * }
+   * }
*/ public final UnaryCallable searchJobsCallable() { return stub.searchJobsCallable(); @@ -735,6 +1212,28 @@ public final UnaryCallable searchJobsCall *

This call constrains the [visibility][google.cloud.talent.v4.Job.visibility] of jobs present * in the database, and only returns jobs the caller has permission to search against. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   SearchJobsRequest request =
+   *       SearchJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setJobQuery(JobQuery.newBuilder().build())
+   *           .setEnableBroadening(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setOffset(-1019779949)
+   *           .setMaxPageSize(524069526)
+   *           .setPageToken("pageToken873572522")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCustomRankingInfo(SearchJobsRequest.CustomRankingInfo.newBuilder().build())
+   *           .setDisableKeywordMatch(true)
+   *           .build();
+   *   SearchJobsResponse response = jobServiceClient.searchJobsForAlert(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -756,6 +1255,29 @@ public final SearchJobsResponse searchJobsForAlert(SearchJobsRequest request) { * in the database, and only returns jobs the caller has permission to search against. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   SearchJobsRequest request =
+   *       SearchJobsRequest.newBuilder()
+   *           .setParent(JobName.of("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setJobQuery(JobQuery.newBuilder().build())
+   *           .setEnableBroadening(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setOffset(-1019779949)
+   *           .setMaxPageSize(524069526)
+   *           .setPageToken("pageToken873572522")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCustomRankingInfo(SearchJobsRequest.CustomRankingInfo.newBuilder().build())
+   *           .setDisableKeywordMatch(true)
+   *           .build();
+   *   ApiFuture future =
+   *       jobServiceClient.searchJobsForAlertCallable().futureCall(request);
+   *   // Do something.
+   *   SearchJobsResponse response = future.get();
+   * }
+   * }
*/ public final UnaryCallable searchJobsForAlertCallable() { return stub.searchJobsForAlertCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/TenantServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/TenantServiceClient.java index c166bd24..ed800537 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/TenantServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/TenantServiceClient.java @@ -43,6 +43,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   Tenant tenant = Tenant.newBuilder().build();
+ *   Tenant response = tenantServiceClient.createTenant(parent, tenant);
+ * }
+ * }
+ * *

Note: close() needs to be called on the TenantServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -146,6 +154,16 @@ public TenantServiceStub getStub() { /** * Creates a new tenant entity. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   Tenant tenant = Tenant.newBuilder().build();
+   *   Tenant response = tenantServiceClient.createTenant(parent, tenant);
+   * }
+   * }
+ * * @param parent Required. Resource name of the project under which the tenant is created. *

The format is "projects/{project_id}", for example, "projects/foo". * @param tenant Required. The tenant to be created. @@ -164,6 +182,16 @@ public final Tenant createTenant(ProjectName parent, Tenant tenant) { /** * Creates a new tenant entity. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   String parent = ProjectName.of("[PROJECT]").toString();
+   *   Tenant tenant = Tenant.newBuilder().build();
+   *   Tenant response = tenantServiceClient.createTenant(parent, tenant);
+   * }
+   * }
+ * * @param parent Required. Resource name of the project under which the tenant is created. *

The format is "projects/{project_id}", for example, "projects/foo". * @param tenant Required. The tenant to be created. @@ -179,6 +207,19 @@ public final Tenant createTenant(String parent, Tenant tenant) { /** * Creates a new tenant entity. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   CreateTenantRequest request =
+   *       CreateTenantRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setTenant(Tenant.newBuilder().build())
+   *           .build();
+   *   Tenant response = tenantServiceClient.createTenant(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -191,6 +232,19 @@ public final Tenant createTenant(CreateTenantRequest request) { * Creates a new tenant entity. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   CreateTenantRequest request =
+   *       CreateTenantRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setTenant(Tenant.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.createTenantCallable().futureCall(request);
+   *   // Do something.
+   *   Tenant response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createTenantCallable() { return stub.createTenantCallable(); @@ -200,6 +254,15 @@ public final UnaryCallable createTenantCallable() { /** * Retrieves specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   TenantName name = TenantName.of("[PROJECT]", "[TENANT]");
+   *   Tenant response = tenantServiceClient.getTenant(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the tenant to be retrieved. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -215,6 +278,15 @@ public final Tenant getTenant(TenantName name) { /** * Retrieves specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   String name = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   Tenant response = tenantServiceClient.getTenant(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the tenant to be retrieved. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -229,6 +301,18 @@ public final Tenant getTenant(String name) { /** * Retrieves specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   GetTenantRequest request =
+   *       GetTenantRequest.newBuilder()
+   *           .setName(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .build();
+   *   Tenant response = tenantServiceClient.getTenant(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -241,6 +325,18 @@ public final Tenant getTenant(GetTenantRequest request) { * Retrieves specified tenant. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   GetTenantRequest request =
+   *       GetTenantRequest.newBuilder()
+   *           .setName(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.getTenantCallable().futureCall(request);
+   *   // Do something.
+   *   Tenant response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getTenantCallable() { return stub.getTenantCallable(); @@ -250,6 +346,16 @@ public final UnaryCallable getTenantCallable() { /** * Updates specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   Tenant tenant = Tenant.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   Tenant response = tenantServiceClient.updateTenant(tenant, updateMask);
+   * }
+   * }
+ * * @param tenant Required. The tenant resource to replace the current resource in the system. * @param updateMask Strongly recommended for the best service experience. *

If [update_mask][google.cloud.talent.v4.UpdateTenantRequest.update_mask] is provided, @@ -269,6 +375,19 @@ public final Tenant updateTenant(Tenant tenant, FieldMask updateMask) { /** * Updates specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   UpdateTenantRequest request =
+   *       UpdateTenantRequest.newBuilder()
+   *           .setTenant(Tenant.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Tenant response = tenantServiceClient.updateTenant(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -281,6 +400,19 @@ public final Tenant updateTenant(UpdateTenantRequest request) { * Updates specified tenant. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   UpdateTenantRequest request =
+   *       UpdateTenantRequest.newBuilder()
+   *           .setTenant(Tenant.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.updateTenantCallable().futureCall(request);
+   *   // Do something.
+   *   Tenant response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateTenantCallable() { return stub.updateTenantCallable(); @@ -290,6 +422,15 @@ public final UnaryCallable updateTenantCallable() { /** * Deletes specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   TenantName name = TenantName.of("[PROJECT]", "[TENANT]");
+   *   tenantServiceClient.deleteTenant(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the tenant to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -305,6 +446,15 @@ public final void deleteTenant(TenantName name) { /** * Deletes specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   String name = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   tenantServiceClient.deleteTenant(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the tenant to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -319,6 +469,18 @@ public final void deleteTenant(String name) { /** * Deletes specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   DeleteTenantRequest request =
+   *       DeleteTenantRequest.newBuilder()
+   *           .setName(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .build();
+   *   tenantServiceClient.deleteTenant(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -331,6 +493,18 @@ public final void deleteTenant(DeleteTenantRequest request) { * Deletes specified tenant. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   DeleteTenantRequest request =
+   *       DeleteTenantRequest.newBuilder()
+   *           .setName(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.deleteTenantCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteTenantCallable() { return stub.deleteTenantCallable(); @@ -340,6 +514,17 @@ public final UnaryCallable deleteTenantCallable() { /** * Lists all tenants associated with the project. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   for (Tenant element : tenantServiceClient.listTenants(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the project under which the tenant is created. *

The format is "projects/{project_id}", for example, "projects/foo". * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -356,6 +541,17 @@ public final ListTenantsPagedResponse listTenants(ProjectName parent) { /** * Lists all tenants associated with the project. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   String parent = ProjectName.of("[PROJECT]").toString();
+   *   for (Tenant element : tenantServiceClient.listTenants(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the project under which the tenant is created. *

The format is "projects/{project_id}", for example, "projects/foo". * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -369,6 +565,22 @@ public final ListTenantsPagedResponse listTenants(String parent) { /** * Lists all tenants associated with the project. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   ListTenantsRequest request =
+   *       ListTenantsRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   for (Tenant element : tenantServiceClient.listTenants(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -381,6 +593,22 @@ public final ListTenantsPagedResponse listTenants(ListTenantsRequest request) { * Lists all tenants associated with the project. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   ListTenantsRequest request =
+   *       ListTenantsRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.listTenantsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Tenant element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listTenantsPagedCallable() { @@ -392,6 +620,23 @@ public final ListTenantsPagedResponse listTenants(ListTenantsRequest request) { * Lists all tenants associated with the project. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   while (true) {
+   *     ListTenantsResponse response = tenantServiceClient.listTenantsCallable().call(request);
+   *     for (Tenant element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listTenantsCallable() { return stub.listTenantsCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/package-info.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/package-info.java index 393c3d62..5185853d 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/package-info.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4/package-info.java @@ -24,18 +24,48 @@ * *

Sample for CompanyServiceClient: * + *

{@code
+ * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+ *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+ *   Company company = Company.newBuilder().build();
+ *   Company response = companyServiceClient.createCompany(parent, company);
+ * }
+ * }
+ * *

======================= CompletionClient ======================= * *

Service Description: A service handles auto completion. * *

Sample for CompletionClient: * + *

{@code
+ * try (CompletionClient completionClient = CompletionClient.create()) {
+ *   CompleteQueryRequest request =
+ *       CompleteQueryRequest.newBuilder()
+ *           .setTenant(TenantName.of("[PROJECT]", "[TENANT]").toString())
+ *           .setQuery("query107944136")
+ *           .addAllLanguageCodes(new ArrayList())
+ *           .setPageSize(883849137)
+ *           .setCompany(CompanyName.of("[PROJECT]", "[TENANT]", "[COMPANY]").toString())
+ *           .build();
+ *   CompleteQueryResponse response = completionClient.completeQuery(request);
+ * }
+ * }
+ * *

======================= EventServiceClient ======================= * *

Service Description: A service handles client event report. * *

Sample for EventServiceClient: * + *

{@code
+ * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+ *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+ *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+ *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+ * }
+ * }
+ * *

======================= JobServiceClient ======================= * *

Service Description: A service handles job management, including job CRUD, enumeration and @@ -43,11 +73,27 @@ * *

Sample for JobServiceClient: * + *

{@code
+ * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+ *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+ *   Job job = Job.newBuilder().build();
+ *   Job response = jobServiceClient.createJob(parent, job);
+ * }
+ * }
+ * *

======================= TenantServiceClient ======================= * *

Service Description: A service that handles tenant management, including CRUD and enumeration. * *

Sample for TenantServiceClient: + * + *

{@code
+ * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   Tenant tenant = Tenant.newBuilder().build();
+ *   Tenant response = tenantServiceClient.createTenant(parent, tenant);
+ * }
+ * }
*/ @Generated("by gapic-generator-java") package com.google.cloud.talent.v4; diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/ApplicationServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/ApplicationServiceClient.java index 5d72f45e..0a77bf7a 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/ApplicationServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/ApplicationServiceClient.java @@ -43,6 +43,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+ *   ProfileName parent = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]");
+ *   Application application = Application.newBuilder().build();
+ *   Application response = applicationServiceClient.createApplication(parent, application);
+ * }
+ * }
+ * *

Note: close() needs to be called on the ApplicationServiceClient object to clean up resources * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). @@ -150,6 +158,16 @@ public ApplicationServiceStub getStub() { /** * Creates a new application entity. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   ProfileName parent = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]");
+   *   Application application = Application.newBuilder().build();
+   *   Application response = applicationServiceClient.createApplication(parent, application);
+   * }
+   * }
+ * * @param parent Required. Resource name of the profile under which the application is created. *

The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For * example, "projects/foo/tenants/bar/profiles/baz". @@ -169,6 +187,16 @@ public final Application createApplication(ProfileName parent, Application appli /** * Creates a new application entity. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   String parent = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString();
+   *   Application application = Application.newBuilder().build();
+   *   Application response = applicationServiceClient.createApplication(parent, application);
+   * }
+   * }
+ * * @param parent Required. Resource name of the profile under which the application is created. *

The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For * example, "projects/foo/tenants/bar/profiles/baz". @@ -185,6 +213,19 @@ public final Application createApplication(String parent, Application applicatio /** * Creates a new application entity. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   CreateApplicationRequest request =
+   *       CreateApplicationRequest.newBuilder()
+   *           .setParent(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .setApplication(Application.newBuilder().build())
+   *           .build();
+   *   Application response = applicationServiceClient.createApplication(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -197,6 +238,20 @@ public final Application createApplication(CreateApplicationRequest request) { * Creates a new application entity. * *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   CreateApplicationRequest request =
+   *       CreateApplicationRequest.newBuilder()
+   *           .setParent(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .setApplication(Application.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       applicationServiceClient.createApplicationCallable().futureCall(request);
+   *   // Do something.
+   *   Application response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createApplicationCallable() { return stub.createApplicationCallable(); @@ -206,6 +261,16 @@ public final UnaryCallable createApplicat /** * Retrieves specified application. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   ApplicationName name =
+   *       ApplicationName.of("[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]");
+   *   Application response = applicationServiceClient.getApplication(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the application to be retrieved. *

The format is * "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}". @@ -222,6 +287,16 @@ public final Application getApplication(ApplicationName name) { /** * Retrieves specified application. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   String name =
+   *       ApplicationName.of("[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]").toString();
+   *   Application response = applicationServiceClient.getApplication(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the application to be retrieved. *

The format is * "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}". @@ -237,6 +312,20 @@ public final Application getApplication(String name) { /** * Retrieves specified application. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   GetApplicationRequest request =
+   *       GetApplicationRequest.newBuilder()
+   *           .setName(
+   *               ApplicationName.of("[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]")
+   *                   .toString())
+   *           .build();
+   *   Application response = applicationServiceClient.getApplication(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -249,6 +338,21 @@ public final Application getApplication(GetApplicationRequest request) { * Retrieves specified application. * *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   GetApplicationRequest request =
+   *       GetApplicationRequest.newBuilder()
+   *           .setName(
+   *               ApplicationName.of("[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future =
+   *       applicationServiceClient.getApplicationCallable().futureCall(request);
+   *   // Do something.
+   *   Application response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getApplicationCallable() { return stub.getApplicationCallable(); @@ -258,6 +362,15 @@ public final UnaryCallable getApplicationCal /** * Updates specified application. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   Application application = Application.newBuilder().build();
+   *   Application response = applicationServiceClient.updateApplication(application);
+   * }
+   * }
+ * * @param application Required. The application resource to replace the current resource in the * system. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -272,6 +385,19 @@ public final Application updateApplication(Application application) { /** * Updates specified application. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   UpdateApplicationRequest request =
+   *       UpdateApplicationRequest.newBuilder()
+   *           .setApplication(Application.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Application response = applicationServiceClient.updateApplication(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -284,6 +410,20 @@ public final Application updateApplication(UpdateApplicationRequest request) { * Updates specified application. * *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   UpdateApplicationRequest request =
+   *       UpdateApplicationRequest.newBuilder()
+   *           .setApplication(Application.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       applicationServiceClient.updateApplicationCallable().futureCall(request);
+   *   // Do something.
+   *   Application response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateApplicationCallable() { return stub.updateApplicationCallable(); @@ -293,6 +433,16 @@ public final UnaryCallable updateApplicat /** * Deletes specified application. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   ApplicationName name =
+   *       ApplicationName.of("[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]");
+   *   applicationServiceClient.deleteApplication(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the application to be deleted. *

The format is * "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}". @@ -311,6 +461,16 @@ public final void deleteApplication(ApplicationName name) { /** * Deletes specified application. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   String name =
+   *       ApplicationName.of("[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]").toString();
+   *   applicationServiceClient.deleteApplication(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the application to be deleted. *

The format is * "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}". @@ -326,6 +486,20 @@ public final void deleteApplication(String name) { /** * Deletes specified application. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   DeleteApplicationRequest request =
+   *       DeleteApplicationRequest.newBuilder()
+   *           .setName(
+   *               ApplicationName.of("[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]")
+   *                   .toString())
+   *           .build();
+   *   applicationServiceClient.deleteApplication(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -338,6 +512,21 @@ public final void deleteApplication(DeleteApplicationRequest request) { * Deletes specified application. * *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   DeleteApplicationRequest request =
+   *       DeleteApplicationRequest.newBuilder()
+   *           .setName(
+   *               ApplicationName.of("[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future =
+   *       applicationServiceClient.deleteApplicationCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteApplicationCallable() { return stub.deleteApplicationCallable(); @@ -347,6 +536,17 @@ public final UnaryCallable deleteApplicationCal /** * Lists all applications associated with the profile. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   ProfileName parent = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]");
+   *   for (Application element : applicationServiceClient.listApplications(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the profile under which the application is created. *

The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for * example, "projects/foo/tenants/bar/profiles/baz". @@ -364,6 +564,17 @@ public final ListApplicationsPagedResponse listApplications(ProfileName parent) /** * Lists all applications associated with the profile. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   String parent = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString();
+   *   for (Application element : applicationServiceClient.listApplications(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the profile under which the application is created. *

The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for * example, "projects/foo/tenants/bar/profiles/baz". @@ -379,6 +590,22 @@ public final ListApplicationsPagedResponse listApplications(String parent) { /** * Lists all applications associated with the profile. * + *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   ListApplicationsRequest request =
+   *       ListApplicationsRequest.newBuilder()
+   *           .setParent(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   for (Application element : applicationServiceClient.listApplications(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -391,6 +618,23 @@ public final ListApplicationsPagedResponse listApplications(ListApplicationsRequ * Lists all applications associated with the profile. * *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   ListApplicationsRequest request =
+   *       ListApplicationsRequest.newBuilder()
+   *           .setParent(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   ApiFuture future =
+   *       applicationServiceClient.listApplicationsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Application element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listApplicationsPagedCallable() { @@ -402,6 +646,24 @@ public final ListApplicationsPagedResponse listApplications(ListApplicationsRequ * Lists all applications associated with the profile. * *

Sample code: + * + *

{@code
+   * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+   *   while (true) {
+   *     ListApplicationsResponse response =
+   *         applicationServiceClient.listApplicationsCallable().call(request);
+   *     for (Application element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listApplicationsCallable() { diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/CompanyServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/CompanyServiceClient.java index 4ce79af4..c6f8862b 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/CompanyServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/CompanyServiceClient.java @@ -42,6 +42,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   Company company = Company.newBuilder().build();
+ *   Company response = companyServiceClient.createCompany(parent, company);
+ * }
+ * }
+ * *

Note: close() needs to be called on the CompanyServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -146,6 +154,16 @@ public CompanyServiceStub getStub() { /** * Creates a new company entity. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   Company company = Company.newBuilder().build();
+   *   Company response = companyServiceClient.createCompany(parent, company);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created, for @@ -166,6 +184,16 @@ public final Company createCompany(ProjectName parent, Company company) { /** * Creates a new company entity. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   Company company = Company.newBuilder().build();
+   *   Company response = companyServiceClient.createCompany(parent, company);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created, for @@ -186,6 +214,17 @@ public final Company createCompany(TenantName parent, Company company) { /** * Creates a new company entity. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   String parent =
+   *       CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]").toString();
+   *   Company company = Company.newBuilder().build();
+   *   Company response = companyServiceClient.createCompany(parent, company);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created, for @@ -203,6 +242,21 @@ public final Company createCompany(String parent, Company company) { /** * Creates a new company entity. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   CreateCompanyRequest request =
+   *       CreateCompanyRequest.newBuilder()
+   *           .setParent(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .setCompany(Company.newBuilder().build())
+   *           .build();
+   *   Company response = companyServiceClient.createCompany(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -215,6 +269,21 @@ public final Company createCompany(CreateCompanyRequest request) { * Creates a new company entity. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   CreateCompanyRequest request =
+   *       CreateCompanyRequest.newBuilder()
+   *           .setParent(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .setCompany(Company.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = companyServiceClient.createCompanyCallable().futureCall(request);
+   *   // Do something.
+   *   Company response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createCompanyCallable() { return stub.createCompanyCallable(); @@ -224,6 +293,16 @@ public final UnaryCallable createCompanyCallable( /** * Retrieves specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   CompanyName name =
+   *       CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]");
+   *   Company response = companyServiceClient.getCompany(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the company to be retrieved. *

The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for * example, "projects/api-test-project/tenants/foo/companies/bar". @@ -241,6 +320,16 @@ public final Company getCompany(CompanyName name) { /** * Retrieves specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   String name =
+   *       CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]").toString();
+   *   Company response = companyServiceClient.getCompany(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the company to be retrieved. *

The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for * example, "projects/api-test-project/tenants/foo/companies/bar". @@ -257,6 +346,20 @@ public final Company getCompany(String name) { /** * Retrieves specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   GetCompanyRequest request =
+   *       GetCompanyRequest.newBuilder()
+   *           .setName(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .build();
+   *   Company response = companyServiceClient.getCompany(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -269,6 +372,20 @@ public final Company getCompany(GetCompanyRequest request) { * Retrieves specified company. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   GetCompanyRequest request =
+   *       GetCompanyRequest.newBuilder()
+   *           .setName(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future = companyServiceClient.getCompanyCallable().futureCall(request);
+   *   // Do something.
+   *   Company response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getCompanyCallable() { return stub.getCompanyCallable(); @@ -278,6 +395,15 @@ public final UnaryCallable getCompanyCallable() { /** * Updates specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   Company company = Company.newBuilder().build();
+   *   Company response = companyServiceClient.updateCompany(company);
+   * }
+   * }
+ * * @param company Required. The company resource to replace the current resource in the system. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -290,6 +416,19 @@ public final Company updateCompany(Company company) { /** * Updates specified company. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   UpdateCompanyRequest request =
+   *       UpdateCompanyRequest.newBuilder()
+   *           .setCompany(Company.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Company response = companyServiceClient.updateCompany(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -302,6 +441,19 @@ public final Company updateCompany(UpdateCompanyRequest request) { * Updates specified company. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   UpdateCompanyRequest request =
+   *       UpdateCompanyRequest.newBuilder()
+   *           .setCompany(Company.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = companyServiceClient.updateCompanyCallable().futureCall(request);
+   *   // Do something.
+   *   Company response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateCompanyCallable() { return stub.updateCompanyCallable(); @@ -311,6 +463,16 @@ public final UnaryCallable updateCompanyCallable( /** * Deletes specified company. Prerequisite: The company has no jobs associated with it. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   CompanyName name =
+   *       CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]");
+   *   companyServiceClient.deleteCompany(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the company to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for * example, "projects/foo/tenants/bar/companies/baz". @@ -328,6 +490,16 @@ public final void deleteCompany(CompanyName name) { /** * Deletes specified company. Prerequisite: The company has no jobs associated with it. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   String name =
+   *       CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]").toString();
+   *   companyServiceClient.deleteCompany(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the company to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for * example, "projects/foo/tenants/bar/companies/baz". @@ -344,6 +516,20 @@ public final void deleteCompany(String name) { /** * Deletes specified company. Prerequisite: The company has no jobs associated with it. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   DeleteCompanyRequest request =
+   *       DeleteCompanyRequest.newBuilder()
+   *           .setName(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .build();
+   *   companyServiceClient.deleteCompany(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -356,6 +542,20 @@ public final void deleteCompany(DeleteCompanyRequest request) { * Deletes specified company. Prerequisite: The company has no jobs associated with it. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   DeleteCompanyRequest request =
+   *       DeleteCompanyRequest.newBuilder()
+   *           .setName(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future = companyServiceClient.deleteCompanyCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteCompanyCallable() { return stub.deleteCompanyCallable(); @@ -365,6 +565,17 @@ public final UnaryCallable deleteCompanyCallable() /** * Lists all companies associated with the project. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   for (Company element : companyServiceClient.listCompanies(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". @@ -384,6 +595,17 @@ public final ListCompaniesPagedResponse listCompanies(ProjectName parent) { /** * Lists all companies associated with the project. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   for (Company element : companyServiceClient.listCompanies(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". @@ -403,6 +625,18 @@ public final ListCompaniesPagedResponse listCompanies(TenantName parent) { /** * Lists all companies associated with the project. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   String parent =
+   *       CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]").toString();
+   *   for (Company element : companyServiceClient.listCompanies(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the company is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". @@ -419,6 +653,25 @@ public final ListCompaniesPagedResponse listCompanies(String parent) { /** * Lists all companies associated with the project. * + *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   ListCompaniesRequest request =
+   *       ListCompaniesRequest.newBuilder()
+   *           .setParent(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .setRequireOpenJobs(true)
+   *           .build();
+   *   for (Company element : companyServiceClient.listCompanies(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -431,6 +684,26 @@ public final ListCompaniesPagedResponse listCompanies(ListCompaniesRequest reque * Lists all companies associated with the project. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   ListCompaniesRequest request =
+   *       ListCompaniesRequest.newBuilder()
+   *           .setParent(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .setRequireOpenJobs(true)
+   *           .build();
+   *   ApiFuture future =
+   *       companyServiceClient.listCompaniesPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Company element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listCompaniesPagedCallable() { @@ -442,6 +715,23 @@ public final ListCompaniesPagedResponse listCompanies(ListCompaniesRequest reque * Lists all companies associated with the project. * *

Sample code: + * + *

{@code
+   * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+   *   while (true) {
+   *     ListCompaniesResponse response = companyServiceClient.listCompaniesCallable().call(request);
+   *     for (Company element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listCompaniesCallable() { return stub.listCompaniesCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/CompletionClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/CompletionClient.java index 7333b607..ad63f255 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/CompletionClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/CompletionClient.java @@ -32,6 +32,24 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (CompletionClient completionClient = CompletionClient.create()) {
+ *   CompleteQueryRequest request =
+ *       CompleteQueryRequest.newBuilder()
+ *           .setParent(
+ *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+ *                   .toString())
+ *           .setQuery("query107944136")
+ *           .addAllLanguageCodes(new ArrayList())
+ *           .setPageSize(883849137)
+ *           .setCompany(
+ *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+ *                   .toString())
+ *           .build();
+ *   CompleteQueryResponse response = completionClient.completeQuery(request);
+ * }
+ * }
+ * *

Note: close() needs to be called on the CompletionClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -135,6 +153,26 @@ public CompletionStub getStub() { * Completes the specified prefix with keyword suggestions. Intended for use by a job search * auto-complete search box. * + *

Sample code: + * + *

{@code
+   * try (CompletionClient completionClient = CompletionClient.create()) {
+   *   CompleteQueryRequest request =
+   *       CompleteQueryRequest.newBuilder()
+   *           .setParent(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .setQuery("query107944136")
+   *           .addAllLanguageCodes(new ArrayList())
+   *           .setPageSize(883849137)
+   *           .setCompany(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .build();
+   *   CompleteQueryResponse response = completionClient.completeQuery(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -148,6 +186,27 @@ public final CompleteQueryResponse completeQuery(CompleteQueryRequest request) { * auto-complete search box. * *

Sample code: + * + *

{@code
+   * try (CompletionClient completionClient = CompletionClient.create()) {
+   *   CompleteQueryRequest request =
+   *       CompleteQueryRequest.newBuilder()
+   *           .setParent(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .setQuery("query107944136")
+   *           .addAllLanguageCodes(new ArrayList())
+   *           .setPageSize(883849137)
+   *           .setCompany(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .build();
+   *   ApiFuture future =
+   *       completionClient.completeQueryCallable().futureCall(request);
+   *   // Do something.
+   *   CompleteQueryResponse response = future.get();
+   * }
+   * }
*/ public final UnaryCallable completeQueryCallable() { return stub.completeQueryCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/EventServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/EventServiceClient.java index d6ee8205..bbbe4f0f 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/EventServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/EventServiceClient.java @@ -32,6 +32,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+ *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+ * }
+ * }
+ * *

Note: close() needs to be called on the EventServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -138,6 +146,16 @@ public EventServiceStub getStub() { * tools](https://console.cloud.google.com/talent-solution/overview). [Learn * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * + *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+   *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the event is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created, for @@ -162,6 +180,16 @@ public final ClientEvent createClientEvent(ProjectName parent, ClientEvent clien * tools](https://console.cloud.google.com/talent-solution/overview). [Learn * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * + *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+   *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the event is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created, for @@ -186,6 +214,17 @@ public final ClientEvent createClientEvent(TenantName parent, ClientEvent client * tools](https://console.cloud.google.com/talent-solution/overview). [Learn * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * + *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   String parent =
+   *       CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]").toString();
+   *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+   *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+   * }
+   * }
+ * * @param parent Required. Resource name of the tenant under which the event is created. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created, for @@ -207,6 +246,21 @@ public final ClientEvent createClientEvent(String parent, ClientEvent clientEven * tools](https://console.cloud.google.com/talent-solution/overview). [Learn * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * + *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   CreateClientEventRequest request =
+   *       CreateClientEventRequest.newBuilder()
+   *           .setParent(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .setClientEvent(ClientEvent.newBuilder().build())
+   *           .build();
+   *   ClientEvent response = eventServiceClient.createClientEvent(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -222,6 +276,22 @@ public final ClientEvent createClientEvent(CreateClientEventRequest request) { * more](https://cloud.google.com/talent-solution/docs/management-tools) about self service tools. * *

Sample code: + * + *

{@code
+   * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+   *   CreateClientEventRequest request =
+   *       CreateClientEventRequest.newBuilder()
+   *           .setParent(
+   *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+   *                   .toString())
+   *           .setClientEvent(ClientEvent.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       eventServiceClient.createClientEventCallable().futureCall(request);
+   *   // Do something.
+   *   ClientEvent response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createClientEventCallable() { return stub.createClientEventCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/JobServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/JobServiceClient.java index a9c9ec13..3752878d 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/JobServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/JobServiceClient.java @@ -47,6 +47,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   Job job = Job.newBuilder().build();
+ *   Job response = jobServiceClient.createJob(parent, job);
+ * }
+ * }
+ * *

Note: close() needs to be called on the JobServiceClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -162,6 +170,16 @@ public final OperationsClient getOperationsClient() { * *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   Job job = Job.newBuilder().build();
+   *   Job response = jobServiceClient.createJob(parent, job);
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified a default tenant is created. For @@ -184,6 +202,16 @@ public final Job createJob(ProjectName parent, Job job) { * *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   Job job = Job.newBuilder().build();
+   *   Job response = jobServiceClient.createJob(parent, job);
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified a default tenant is created. For @@ -206,6 +234,16 @@ public final Job createJob(TenantName parent, Job job) { * *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   Job job = Job.newBuilder().build();
+   *   Job response = jobServiceClient.createJob(parent, job);
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified a default tenant is created. For @@ -224,6 +262,20 @@ public final Job createJob(String parent, Job job) { * *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   CreateJobRequest request =
+   *       CreateJobRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setJob(Job.newBuilder().build())
+   *           .build();
+   *   Job response = jobServiceClient.createJob(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -238,6 +290,20 @@ public final Job createJob(CreateJobRequest request) { *

Typically, the job becomes searchable within 10 seconds, but it may take up to 5 minutes. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   CreateJobRequest request =
+   *       CreateJobRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setJob(Job.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.createJobCallable().futureCall(request);
+   *   // Do something.
+   *   Job response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createJobCallable() { return stub.createJobCallable(); @@ -247,6 +313,16 @@ public final UnaryCallable createJobCallable() { /** * Begins executing a batch create jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   List jobs = new ArrayList<>();
+   *   JobOperationResult response = jobServiceClient.batchCreateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -268,6 +344,16 @@ public final OperationFuture batchCr /** * Begins executing a batch create jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   List jobs = new ArrayList<>();
+   *   JobOperationResult response = jobServiceClient.batchCreateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -289,6 +375,16 @@ public final OperationFuture batchCr /** * Begins executing a batch create jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   List jobs = new ArrayList<>();
+   *   JobOperationResult response = jobServiceClient.batchCreateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -307,6 +403,20 @@ public final OperationFuture batchCr /** * Begins executing a batch create jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchCreateJobsRequest request =
+   *       BatchCreateJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .build();
+   *   JobOperationResult response = jobServiceClient.batchCreateJobsAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -320,6 +430,21 @@ public final OperationFuture batchCr * Begins executing a batch create jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchCreateJobsRequest request =
+   *       BatchCreateJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .build();
+   *   OperationFuture future =
+   *       jobServiceClient.batchCreateJobsOperationCallable().futureCall(request);
+   *   // Do something.
+   *   JobOperationResult response = future.get();
+   * }
+   * }
*/ public final OperationCallable batchCreateJobsOperationCallable() { @@ -331,6 +456,20 @@ public final OperationFuture batchCr * Begins executing a batch create jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchCreateJobsRequest request =
+   *       BatchCreateJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.batchCreateJobsCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable batchCreateJobsCallable() { return stub.batchCreateJobsCallable(); @@ -340,6 +479,15 @@ public final UnaryCallable batchCreateJobsCal /** * Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   JobName name = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]");
+   *   Job response = jobServiceClient.getJob(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the job to retrieve. *

The format is "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example, * "projects/foo/tenants/bar/jobs/baz". @@ -357,6 +505,15 @@ public final Job getJob(JobName name) { /** * Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String name = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   Job response = jobServiceClient.getJob(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the job to retrieve. *

The format is "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example, * "projects/foo/tenants/bar/jobs/baz". @@ -373,6 +530,18 @@ public final Job getJob(String name) { /** * Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   GetJobRequest request =
+   *       GetJobRequest.newBuilder()
+   *           .setName(JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .build();
+   *   Job response = jobServiceClient.getJob(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -385,6 +554,18 @@ public final Job getJob(GetJobRequest request) { * Retrieves the specified job, whose status is OPEN or recently EXPIRED within the last 90 days. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   GetJobRequest request =
+   *       GetJobRequest.newBuilder()
+   *           .setName(JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.getJobCallable().futureCall(request);
+   *   // Do something.
+   *   Job response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getJobCallable() { return stub.getJobCallable(); @@ -397,6 +578,15 @@ public final UnaryCallable getJobCallable() { *

Typically, updated contents become visible in search results within 10 seconds, but it may * take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   Job job = Job.newBuilder().build();
+   *   Job response = jobServiceClient.updateJob(job);
+   * }
+   * }
+ * * @param job Required. The Job to be updated. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -412,6 +602,19 @@ public final Job updateJob(Job job) { *

Typically, updated contents become visible in search results within 10 seconds, but it may * take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   UpdateJobRequest request =
+   *       UpdateJobRequest.newBuilder()
+   *           .setJob(Job.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Job response = jobServiceClient.updateJob(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -427,6 +630,19 @@ public final Job updateJob(UpdateJobRequest request) { * take up to 5 minutes. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   UpdateJobRequest request =
+   *       UpdateJobRequest.newBuilder()
+   *           .setJob(Job.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.updateJobCallable().futureCall(request);
+   *   // Do something.
+   *   Job response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateJobCallable() { return stub.updateJobCallable(); @@ -436,6 +652,16 @@ public final UnaryCallable updateJobCallable() { /** * Begins executing a batch update jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   List jobs = new ArrayList<>();
+   *   JobOperationResult response = jobServiceClient.batchUpdateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -457,6 +683,16 @@ public final OperationFuture batchUp /** * Begins executing a batch update jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   List jobs = new ArrayList<>();
+   *   JobOperationResult response = jobServiceClient.batchUpdateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -478,6 +714,16 @@ public final OperationFuture batchUp /** * Begins executing a batch update jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   List jobs = new ArrayList<>();
+   *   JobOperationResult response = jobServiceClient.batchUpdateJobsAsync(parent, jobs).get();
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -496,6 +742,21 @@ public final OperationFuture batchUp /** * Begins executing a batch update jobs operation. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchUpdateJobsRequest request =
+   *       BatchUpdateJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   JobOperationResult response = jobServiceClient.batchUpdateJobsAsync(request).get();
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -509,6 +770,22 @@ public final OperationFuture batchUp * Begins executing a batch update jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchUpdateJobsRequest request =
+   *       BatchUpdateJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   OperationFuture future =
+   *       jobServiceClient.batchUpdateJobsOperationCallable().futureCall(request);
+   *   // Do something.
+   *   JobOperationResult response = future.get();
+   * }
+   * }
*/ public final OperationCallable batchUpdateJobsOperationCallable() { @@ -520,6 +797,21 @@ public final OperationFuture batchUp * Begins executing a batch update jobs operation. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchUpdateJobsRequest request =
+   *       BatchUpdateJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .addAllJobs(new ArrayList())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.batchUpdateJobsCallable().futureCall(request);
+   *   // Do something.
+   *   Operation response = future.get();
+   * }
+   * }
*/ public final UnaryCallable batchUpdateJobsCallable() { return stub.batchUpdateJobsCallable(); @@ -531,6 +823,15 @@ public final UnaryCallable batchUpdateJobsCal * *

Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   JobName name = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]");
+   *   jobServiceClient.deleteJob(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the job to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example, * "projects/foo/tenants/bar/jobs/baz". @@ -550,6 +851,15 @@ public final void deleteJob(JobName name) { * *

Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String name = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   jobServiceClient.deleteJob(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the job to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example, * "projects/foo/tenants/bar/jobs/baz". @@ -568,6 +878,18 @@ public final void deleteJob(String name) { * *

Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   DeleteJobRequest request =
+   *       DeleteJobRequest.newBuilder()
+   *           .setName(JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .build();
+   *   jobServiceClient.deleteJob(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -582,6 +904,18 @@ public final void deleteJob(DeleteJobRequest request) { *

Typically, the job becomes unsearchable within 10 seconds, but it may take up to 5 minutes. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   DeleteJobRequest request =
+   *       DeleteJobRequest.newBuilder()
+   *           .setName(JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .build();
+   *   ApiFuture future = jobServiceClient.deleteJobCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteJobCallable() { return stub.deleteJobCallable(); @@ -591,6 +925,16 @@ public final UnaryCallable deleteJobCallable() { /** * Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   String filter = "filter-1274492040";
+   *   jobServiceClient.batchDeleteJobs(parent, filter);
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -618,6 +962,16 @@ public final void batchDeleteJobs(ProjectName parent, String filter) { /** * Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   String filter = "filter-1274492040";
+   *   jobServiceClient.batchDeleteJobs(parent, filter);
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -645,6 +999,16 @@ public final void batchDeleteJobs(TenantName parent, String filter) { /** * Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   String filter = "filter-1274492040";
+   *   jobServiceClient.batchDeleteJobs(parent, filter);
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -669,6 +1033,20 @@ public final void batchDeleteJobs(String parent, String filter) { /** * Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchDeleteJobsRequest request =
+   *       BatchDeleteJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setFilter("filter-1274492040")
+   *           .build();
+   *   jobServiceClient.batchDeleteJobs(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -681,6 +1059,20 @@ public final void batchDeleteJobs(BatchDeleteJobsRequest request) { * Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   BatchDeleteJobsRequest request =
+   *       BatchDeleteJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setFilter("filter-1274492040")
+   *           .build();
+   *   ApiFuture future = jobServiceClient.batchDeleteJobsCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable batchDeleteJobsCallable() { return stub.batchDeleteJobsCallable(); @@ -690,6 +1082,18 @@ public final UnaryCallable batchDeleteJobsCallabl /** * Lists jobs by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   String filter = "filter-1274492040";
+   *   for (Job element : jobServiceClient.listJobs(parent, filter).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -725,6 +1129,18 @@ public final ListJobsPagedResponse listJobs(ProjectName parent, String filter) { /** * Lists jobs by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   String filter = "filter-1274492040";
+   *   for (Job element : jobServiceClient.listJobs(parent, filter).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -760,6 +1176,18 @@ public final ListJobsPagedResponse listJobs(TenantName parent, String filter) { /** * Lists jobs by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   String parent = JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString();
+   *   String filter = "filter-1274492040";
+   *   for (Job element : jobServiceClient.listJobs(parent, filter).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the job is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant is created. For @@ -792,6 +1220,24 @@ public final ListJobsPagedResponse listJobs(String parent, String filter) { /** * Lists jobs by filter. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ListJobsRequest request =
+   *       ListJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setFilter("filter-1274492040")
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   for (Job element : jobServiceClient.listJobs(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -804,6 +1250,24 @@ public final ListJobsPagedResponse listJobs(ListJobsRequest request) { * Lists jobs by filter. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   ListJobsRequest request =
+   *       ListJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setFilter("filter-1274492040")
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   ApiFuture future = jobServiceClient.listJobsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Job element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listJobsPagedCallable() { return stub.listJobsPagedCallable(); @@ -814,6 +1278,23 @@ public final UnaryCallable listJobsPaged * Lists jobs by filter. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   while (true) {
+   *     ListJobsResponse response = jobServiceClient.listJobsCallable().call(request);
+   *     for (Job element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listJobsCallable() { return stub.listJobsCallable(); @@ -828,6 +1309,33 @@ public final UnaryCallable listJobsCallable() * present in the database, and only returns jobs that the caller has permission to search * against. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   SearchJobsRequest request =
+   *       SearchJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setJobQuery(JobQuery.newBuilder().build())
+   *           .setEnableBroadening(true)
+   *           .setRequirePreciseResultSize(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setOffset(-1019779949)
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCustomRankingInfo(SearchJobsRequest.CustomRankingInfo.newBuilder().build())
+   *           .setDisableKeywordMatch(true)
+   *           .build();
+   *   for (SearchJobsResponse.MatchingJob element :
+   *       jobServiceClient.searchJobs(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -845,6 +1353,33 @@ public final SearchJobsPagedResponse searchJobs(SearchJobsRequest request) { * against. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   SearchJobsRequest request =
+   *       SearchJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setJobQuery(JobQuery.newBuilder().build())
+   *           .setEnableBroadening(true)
+   *           .setRequirePreciseResultSize(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setOffset(-1019779949)
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCustomRankingInfo(SearchJobsRequest.CustomRankingInfo.newBuilder().build())
+   *           .setDisableKeywordMatch(true)
+   *           .build();
+   *   ApiFuture future =
+   *       jobServiceClient.searchJobsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (SearchJobsResponse.MatchingJob element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable searchJobsPagedCallable() { return stub.searchJobsPagedCallable(); @@ -860,6 +1395,23 @@ public final UnaryCallable searchJob * against. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   while (true) {
+   *     SearchJobsResponse response = jobServiceClient.searchJobsCallable().call(request);
+   *     for (SearchJobsResponse.MatchingJob element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable searchJobsCallable() { return stub.searchJobsCallable(); @@ -877,6 +1429,33 @@ public final UnaryCallable searchJobsCall *

This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs * present in the database, and only returns jobs the caller has permission to search against. * + *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   SearchJobsRequest request =
+   *       SearchJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setJobQuery(JobQuery.newBuilder().build())
+   *           .setEnableBroadening(true)
+   *           .setRequirePreciseResultSize(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setOffset(-1019779949)
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCustomRankingInfo(SearchJobsRequest.CustomRankingInfo.newBuilder().build())
+   *           .setDisableKeywordMatch(true)
+   *           .build();
+   *   for (SearchJobsResponse.MatchingJob element :
+   *       jobServiceClient.searchJobsForAlert(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -897,6 +1476,33 @@ public final SearchJobsForAlertPagedResponse searchJobsForAlert(SearchJobsReques * present in the database, and only returns jobs the caller has permission to search against. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   SearchJobsRequest request =
+   *       SearchJobsRequest.newBuilder()
+   *           .setParent(
+   *               JobName.ofProjectTenantJobName("[PROJECT]", "[TENANT]", "[JOB]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setJobQuery(JobQuery.newBuilder().build())
+   *           .setEnableBroadening(true)
+   *           .setRequirePreciseResultSize(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setOffset(-1019779949)
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCustomRankingInfo(SearchJobsRequest.CustomRankingInfo.newBuilder().build())
+   *           .setDisableKeywordMatch(true)
+   *           .build();
+   *   ApiFuture future =
+   *       jobServiceClient.searchJobsForAlertPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (SearchJobsResponse.MatchingJob element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable searchJobsForAlertPagedCallable() { @@ -916,6 +1522,23 @@ public final SearchJobsForAlertPagedResponse searchJobsForAlert(SearchJobsReques * present in the database, and only returns jobs the caller has permission to search against. * *

Sample code: + * + *

{@code
+   * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+   *   while (true) {
+   *     SearchJobsResponse response = jobServiceClient.searchJobsForAlertCallable().call(request);
+   *     for (SearchJobsResponse.MatchingJob element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable searchJobsForAlertCallable() { return stub.searchJobsForAlertCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/ProfileServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/ProfileServiceClient.java index 58807f0d..017e688a 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/ProfileServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/ProfileServiceClient.java @@ -43,6 +43,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+ *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+ *   Profile profile = Profile.newBuilder().build();
+ *   Profile response = profileServiceClient.createProfile(parent, profile);
+ * }
+ * }
+ * *

Note: close() needs to be called on the ProfileServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -147,6 +155,17 @@ public ProfileServiceStub getStub() { /** * Lists profiles by filter. The order is unspecified. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   for (Profile element : profileServiceClient.listProfiles(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the profile is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -164,6 +183,17 @@ public final ListProfilesPagedResponse listProfiles(TenantName parent) { /** * Lists profiles by filter. The order is unspecified. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   String parent = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString();
+   *   for (Profile element : profileServiceClient.listProfiles(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. The resource name of the tenant under which the profile is created. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -178,6 +208,24 @@ public final ListProfilesPagedResponse listProfiles(String parent) { /** * Lists profiles by filter. The order is unspecified. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   ListProfilesRequest request =
+   *       ListProfilesRequest.newBuilder()
+   *           .setParent(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .setFilter("filter-1274492040")
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .setReadMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   for (Profile element : profileServiceClient.listProfiles(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -190,6 +238,25 @@ public final ListProfilesPagedResponse listProfiles(ListProfilesRequest request) * Lists profiles by filter. The order is unspecified. * *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   ListProfilesRequest request =
+   *       ListProfilesRequest.newBuilder()
+   *           .setParent(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .setFilter("filter-1274492040")
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .setReadMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future =
+   *       profileServiceClient.listProfilesPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Profile element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listProfilesPagedCallable() { @@ -201,6 +268,23 @@ public final ListProfilesPagedResponse listProfiles(ListProfilesRequest request) * Lists profiles by filter. The order is unspecified. * *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   while (true) {
+   *     ListProfilesResponse response = profileServiceClient.listProfilesCallable().call(request);
+   *     for (Profile element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listProfilesCallable() { return stub.listProfilesCallable(); @@ -210,6 +294,16 @@ public final UnaryCallable listProfil /** * Creates and returns a new profile. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+   *   Profile profile = Profile.newBuilder().build();
+   *   Profile response = profileServiceClient.createProfile(parent, profile);
+   * }
+   * }
+ * * @param parent Required. The name of the tenant this profile belongs to. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -229,6 +323,16 @@ public final Profile createProfile(TenantName parent, Profile profile) { /** * Creates and returns a new profile. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   String parent = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   Profile profile = Profile.newBuilder().build();
+   *   Profile response = profileServiceClient.createProfile(parent, profile);
+   * }
+   * }
+ * * @param parent Required. The name of the tenant this profile belongs to. *

The format is "projects/{project_id}/tenants/{tenant_id}". For example, * "projects/foo/tenants/bar". @@ -245,6 +349,19 @@ public final Profile createProfile(String parent, Profile profile) { /** * Creates and returns a new profile. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   CreateProfileRequest request =
+   *       CreateProfileRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setProfile(Profile.newBuilder().build())
+   *           .build();
+   *   Profile response = profileServiceClient.createProfile(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -257,6 +374,19 @@ public final Profile createProfile(CreateProfileRequest request) { * Creates and returns a new profile. * *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   CreateProfileRequest request =
+   *       CreateProfileRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setProfile(Profile.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = profileServiceClient.createProfileCallable().futureCall(request);
+   *   // Do something.
+   *   Profile response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createProfileCallable() { return stub.createProfileCallable(); @@ -266,6 +396,15 @@ public final UnaryCallable createProfileCallable( /** * Gets the specified profile. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   ProfileName name = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]");
+   *   Profile response = profileServiceClient.getProfile(name);
+   * }
+   * }
+ * * @param name Required. Resource name of the profile to get. *

The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For * example, "projects/foo/tenants/bar/profiles/baz". @@ -281,6 +420,15 @@ public final Profile getProfile(ProfileName name) { /** * Gets the specified profile. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   String name = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString();
+   *   Profile response = profileServiceClient.getProfile(name);
+   * }
+   * }
+ * * @param name Required. Resource name of the profile to get. *

The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For * example, "projects/foo/tenants/bar/profiles/baz". @@ -295,6 +443,18 @@ public final Profile getProfile(String name) { /** * Gets the specified profile. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   GetProfileRequest request =
+   *       GetProfileRequest.newBuilder()
+   *           .setName(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .build();
+   *   Profile response = profileServiceClient.getProfile(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -307,6 +467,18 @@ public final Profile getProfile(GetProfileRequest request) { * Gets the specified profile. * *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   GetProfileRequest request =
+   *       GetProfileRequest.newBuilder()
+   *           .setName(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .build();
+   *   ApiFuture future = profileServiceClient.getProfileCallable().futureCall(request);
+   *   // Do something.
+   *   Profile response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getProfileCallable() { return stub.getProfileCallable(); @@ -316,6 +488,15 @@ public final UnaryCallable getProfileCallable() { /** * Updates the specified profile and returns the updated result. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   Profile profile = Profile.newBuilder().build();
+   *   Profile response = profileServiceClient.updateProfile(profile);
+   * }
+   * }
+ * * @param profile Required. Profile to be updated. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -328,6 +509,19 @@ public final Profile updateProfile(Profile profile) { /** * Updates the specified profile and returns the updated result. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   UpdateProfileRequest request =
+   *       UpdateProfileRequest.newBuilder()
+   *           .setProfile(Profile.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Profile response = profileServiceClient.updateProfile(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -340,6 +534,19 @@ public final Profile updateProfile(UpdateProfileRequest request) { * Updates the specified profile and returns the updated result. * *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   UpdateProfileRequest request =
+   *       UpdateProfileRequest.newBuilder()
+   *           .setProfile(Profile.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = profileServiceClient.updateProfileCallable().futureCall(request);
+   *   // Do something.
+   *   Profile response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateProfileCallable() { return stub.updateProfileCallable(); @@ -350,6 +557,15 @@ public final UnaryCallable updateProfileCallable( * Deletes the specified profile. Prerequisite: The profile has no associated applications or * assignments associated. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   ProfileName name = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]");
+   *   profileServiceClient.deleteProfile(name);
+   * }
+   * }
+ * * @param name Required. Resource name of the profile to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For * example, "projects/foo/tenants/bar/profiles/baz". @@ -366,6 +582,15 @@ public final void deleteProfile(ProfileName name) { * Deletes the specified profile. Prerequisite: The profile has no associated applications or * assignments associated. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   String name = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString();
+   *   profileServiceClient.deleteProfile(name);
+   * }
+   * }
+ * * @param name Required. Resource name of the profile to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For * example, "projects/foo/tenants/bar/profiles/baz". @@ -381,6 +606,18 @@ public final void deleteProfile(String name) { * Deletes the specified profile. Prerequisite: The profile has no associated applications or * assignments associated. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   DeleteProfileRequest request =
+   *       DeleteProfileRequest.newBuilder()
+   *           .setName(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .build();
+   *   profileServiceClient.deleteProfile(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -394,6 +631,18 @@ public final void deleteProfile(DeleteProfileRequest request) { * assignments associated. * *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   DeleteProfileRequest request =
+   *       DeleteProfileRequest.newBuilder()
+   *           .setName(ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]").toString())
+   *           .build();
+   *   ApiFuture future = profileServiceClient.deleteProfileCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteProfileCallable() { return stub.deleteProfileCallable(); @@ -409,6 +658,32 @@ public final UnaryCallable deleteProfileCallable() *

See [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest] for more * information. * + *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   SearchProfilesRequest request =
+   *       SearchProfilesRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setProfileQuery(ProfileQuery.newBuilder().build())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setOffset(-1019779949)
+   *           .setDisableSpellCheck(true)
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCaseSensitiveSort(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setResultSetId("resultSetId-548600064")
+   *           .setStrictKeywordsSearch(true)
+   *           .build();
+   *   for (HistogramQueryResult element :
+   *       profileServiceClient.searchProfiles(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -427,6 +702,32 @@ public final SearchProfilesPagedResponse searchProfiles(SearchProfilesRequest re * information. * *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   SearchProfilesRequest request =
+   *       SearchProfilesRequest.newBuilder()
+   *           .setParent(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .setRequestMetadata(RequestMetadata.newBuilder().build())
+   *           .setProfileQuery(ProfileQuery.newBuilder().build())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .setOffset(-1019779949)
+   *           .setDisableSpellCheck(true)
+   *           .setOrderBy("orderBy-1207110587")
+   *           .setCaseSensitiveSort(true)
+   *           .addAllHistogramQueries(new ArrayList())
+   *           .setResultSetId("resultSetId-548600064")
+   *           .setStrictKeywordsSearch(true)
+   *           .build();
+   *   ApiFuture future =
+   *       profileServiceClient.searchProfilesPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (HistogramQueryResult element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable searchProfilesPagedCallable() { @@ -444,6 +745,24 @@ public final SearchProfilesPagedResponse searchProfiles(SearchProfilesRequest re * information. * *

Sample code: + * + *

{@code
+   * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+   *   while (true) {
+   *     SearchProfilesResponse response =
+   *         profileServiceClient.searchProfilesCallable().call(request);
+   *     for (HistogramQueryResult element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable searchProfilesCallable() { diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/TenantServiceClient.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/TenantServiceClient.java index 361630d3..9d41ba99 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/TenantServiceClient.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/TenantServiceClient.java @@ -42,6 +42,14 @@ *

This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *

{@code
+ * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   Tenant tenant = Tenant.newBuilder().build();
+ *   Tenant response = tenantServiceClient.createTenant(parent, tenant);
+ * }
+ * }
+ * *

Note: close() needs to be called on the TenantServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * @@ -146,6 +154,16 @@ public TenantServiceStub getStub() { /** * Creates a new tenant entity. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   Tenant tenant = Tenant.newBuilder().build();
+   *   Tenant response = tenantServiceClient.createTenant(parent, tenant);
+   * }
+   * }
+ * * @param parent Required. Resource name of the project under which the tenant is created. *

The format is "projects/{project_id}", for example, "projects/foo". * @param tenant Required. The tenant to be created. @@ -164,6 +182,16 @@ public final Tenant createTenant(ProjectName parent, Tenant tenant) { /** * Creates a new tenant entity. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   String parent = ProjectName.of("[PROJECT]").toString();
+   *   Tenant tenant = Tenant.newBuilder().build();
+   *   Tenant response = tenantServiceClient.createTenant(parent, tenant);
+   * }
+   * }
+ * * @param parent Required. Resource name of the project under which the tenant is created. *

The format is "projects/{project_id}", for example, "projects/foo". * @param tenant Required. The tenant to be created. @@ -179,6 +207,19 @@ public final Tenant createTenant(String parent, Tenant tenant) { /** * Creates a new tenant entity. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   CreateTenantRequest request =
+   *       CreateTenantRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setTenant(Tenant.newBuilder().build())
+   *           .build();
+   *   Tenant response = tenantServiceClient.createTenant(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -191,6 +232,19 @@ public final Tenant createTenant(CreateTenantRequest request) { * Creates a new tenant entity. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   CreateTenantRequest request =
+   *       CreateTenantRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setTenant(Tenant.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.createTenantCallable().futureCall(request);
+   *   // Do something.
+   *   Tenant response = future.get();
+   * }
+   * }
*/ public final UnaryCallable createTenantCallable() { return stub.createTenantCallable(); @@ -200,6 +254,15 @@ public final UnaryCallable createTenantCallable() { /** * Retrieves specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   TenantName name = TenantName.of("[PROJECT]", "[TENANT]");
+   *   Tenant response = tenantServiceClient.getTenant(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the tenant to be retrieved. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -215,6 +278,15 @@ public final Tenant getTenant(TenantName name) { /** * Retrieves specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   String name = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   Tenant response = tenantServiceClient.getTenant(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the tenant to be retrieved. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -229,6 +301,18 @@ public final Tenant getTenant(String name) { /** * Retrieves specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   GetTenantRequest request =
+   *       GetTenantRequest.newBuilder()
+   *           .setName(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .build();
+   *   Tenant response = tenantServiceClient.getTenant(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -241,6 +325,18 @@ public final Tenant getTenant(GetTenantRequest request) { * Retrieves specified tenant. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   GetTenantRequest request =
+   *       GetTenantRequest.newBuilder()
+   *           .setName(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.getTenantCallable().futureCall(request);
+   *   // Do something.
+   *   Tenant response = future.get();
+   * }
+   * }
*/ public final UnaryCallable getTenantCallable() { return stub.getTenantCallable(); @@ -250,6 +346,15 @@ public final UnaryCallable getTenantCallable() { /** * Updates specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   Tenant tenant = Tenant.newBuilder().build();
+   *   Tenant response = tenantServiceClient.updateTenant(tenant);
+   * }
+   * }
+ * * @param tenant Required. The tenant resource to replace the current resource in the system. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -262,6 +367,19 @@ public final Tenant updateTenant(Tenant tenant) { /** * Updates specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   UpdateTenantRequest request =
+   *       UpdateTenantRequest.newBuilder()
+   *           .setTenant(Tenant.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Tenant response = tenantServiceClient.updateTenant(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -274,6 +392,19 @@ public final Tenant updateTenant(UpdateTenantRequest request) { * Updates specified tenant. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   UpdateTenantRequest request =
+   *       UpdateTenantRequest.newBuilder()
+   *           .setTenant(Tenant.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.updateTenantCallable().futureCall(request);
+   *   // Do something.
+   *   Tenant response = future.get();
+   * }
+   * }
*/ public final UnaryCallable updateTenantCallable() { return stub.updateTenantCallable(); @@ -283,6 +414,15 @@ public final UnaryCallable updateTenantCallable() { /** * Deletes specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   TenantName name = TenantName.of("[PROJECT]", "[TENANT]");
+   *   tenantServiceClient.deleteTenant(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the tenant to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -298,6 +438,15 @@ public final void deleteTenant(TenantName name) { /** * Deletes specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   String name = TenantName.of("[PROJECT]", "[TENANT]").toString();
+   *   tenantServiceClient.deleteTenant(name);
+   * }
+   * }
+ * * @param name Required. The resource name of the tenant to be deleted. *

The format is "projects/{project_id}/tenants/{tenant_id}", for example, * "projects/foo/tenants/bar". @@ -312,6 +461,18 @@ public final void deleteTenant(String name) { /** * Deletes specified tenant. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   DeleteTenantRequest request =
+   *       DeleteTenantRequest.newBuilder()
+   *           .setName(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .build();
+   *   tenantServiceClient.deleteTenant(request);
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -324,6 +485,18 @@ public final void deleteTenant(DeleteTenantRequest request) { * Deletes specified tenant. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   DeleteTenantRequest request =
+   *       DeleteTenantRequest.newBuilder()
+   *           .setName(TenantName.of("[PROJECT]", "[TENANT]").toString())
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.deleteTenantCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }
*/ public final UnaryCallable deleteTenantCallable() { return stub.deleteTenantCallable(); @@ -333,6 +506,17 @@ public final UnaryCallable deleteTenantCallable() { /** * Lists all tenants associated with the project. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   for (Tenant element : tenantServiceClient.listTenants(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the project under which the tenant is created. *

The format is "projects/{project_id}", for example, "projects/foo". * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -349,6 +533,17 @@ public final ListTenantsPagedResponse listTenants(ProjectName parent) { /** * Lists all tenants associated with the project. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   String parent = ProjectName.of("[PROJECT]").toString();
+   *   for (Tenant element : tenantServiceClient.listTenants(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param parent Required. Resource name of the project under which the tenant is created. *

The format is "projects/{project_id}", for example, "projects/foo". * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -362,6 +557,22 @@ public final ListTenantsPagedResponse listTenants(String parent) { /** * Lists all tenants associated with the project. * + *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   ListTenantsRequest request =
+   *       ListTenantsRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   for (Tenant element : tenantServiceClient.listTenants(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
+ * * @param request The request object containing all of the parameters for the API call. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -374,6 +585,22 @@ public final ListTenantsPagedResponse listTenants(ListTenantsRequest request) { * Lists all tenants associated with the project. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   ListTenantsRequest request =
+   *       ListTenantsRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setPageToken("pageToken873572522")
+   *           .setPageSize(883849137)
+   *           .build();
+   *   ApiFuture future = tenantServiceClient.listTenantsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Tenant element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listTenantsPagedCallable() { @@ -385,6 +612,23 @@ public final ListTenantsPagedResponse listTenants(ListTenantsRequest request) { * Lists all tenants associated with the project. * *

Sample code: + * + *

{@code
+   * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+   *   while (true) {
+   *     ListTenantsResponse response = tenantServiceClient.listTenantsCallable().call(request);
+   *     for (Tenant element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }
*/ public final UnaryCallable listTenantsCallable() { return stub.listTenantsCallable(); diff --git a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/package-info.java b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/package-info.java index 33b3d656..ef1936e2 100644 --- a/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/package-info.java +++ b/google-cloud-talent/src/main/java/com/google/cloud/talent/v4beta1/package-info.java @@ -24,6 +24,14 @@ * *

Sample for ApplicationServiceClient: * + *

{@code
+ * try (ApplicationServiceClient applicationServiceClient = ApplicationServiceClient.create()) {
+ *   ProfileName parent = ProfileName.of("[PROJECT]", "[TENANT]", "[PROFILE]");
+ *   Application application = Application.newBuilder().build();
+ *   Application response = applicationServiceClient.createApplication(parent, application);
+ * }
+ * }
+ * *

======================= CompanyServiceClient ======================= * *

Service Description: A service that handles company management, including CRUD and @@ -31,18 +39,52 @@ * *

Sample for CompanyServiceClient: * + *

{@code
+ * try (CompanyServiceClient companyServiceClient = CompanyServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   Company company = Company.newBuilder().build();
+ *   Company response = companyServiceClient.createCompany(parent, company);
+ * }
+ * }
+ * *

======================= CompletionClient ======================= * *

Service Description: A service handles auto completion. * *

Sample for CompletionClient: * + *

{@code
+ * try (CompletionClient completionClient = CompletionClient.create()) {
+ *   CompleteQueryRequest request =
+ *       CompleteQueryRequest.newBuilder()
+ *           .setParent(
+ *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+ *                   .toString())
+ *           .setQuery("query107944136")
+ *           .addAllLanguageCodes(new ArrayList())
+ *           .setPageSize(883849137)
+ *           .setCompany(
+ *               CompanyName.ofProjectTenantCompanyName("[PROJECT]", "[TENANT]", "[COMPANY]")
+ *                   .toString())
+ *           .build();
+ *   CompleteQueryResponse response = completionClient.completeQuery(request);
+ * }
+ * }
+ * *

======================= EventServiceClient ======================= * *

Service Description: A service handles client event report. * *

Sample for EventServiceClient: * + *

{@code
+ * try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   ClientEvent clientEvent = ClientEvent.newBuilder().build();
+ *   ClientEvent response = eventServiceClient.createClientEvent(parent, clientEvent);
+ * }
+ * }
+ * *

======================= JobServiceClient ======================= * *

Service Description: A service handles job management, including job CRUD, enumeration and @@ -50,6 +92,14 @@ * *

Sample for JobServiceClient: * + *

{@code
+ * try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   Job job = Job.newBuilder().build();
+ *   Job response = jobServiceClient.createJob(parent, job);
+ * }
+ * }
+ * *

======================= ProfileServiceClient ======================= * *

Service Description: A service that handles profile management, including profile CRUD, @@ -57,11 +107,27 @@ * *

Sample for ProfileServiceClient: * + *

{@code
+ * try (ProfileServiceClient profileServiceClient = ProfileServiceClient.create()) {
+ *   TenantName parent = TenantName.of("[PROJECT]", "[TENANT]");
+ *   Profile profile = Profile.newBuilder().build();
+ *   Profile response = profileServiceClient.createProfile(parent, profile);
+ * }
+ * }
+ * *

======================= TenantServiceClient ======================= * *

Service Description: A service that handles tenant management, including CRUD and enumeration. * *

Sample for TenantServiceClient: + * + *

{@code
+ * try (TenantServiceClient tenantServiceClient = TenantServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   Tenant tenant = Tenant.newBuilder().build();
+ *   Tenant response = tenantServiceClient.createTenant(parent, tenant);
+ * }
+ * }
*/ @Generated("by gapic-generator-java") package com.google.cloud.talent.v4beta1; diff --git a/synth.metadata b/synth.metadata index 7fed6fc9..abf887f5 100644 --- a/synth.metadata +++ b/synth.metadata @@ -11,16 +11,16 @@ "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "ceaaf31b3d13badab7cf9d3b570f5639db5593d9", - "internalRef": "352816749" + "sha": "8d8c008e56f1af31d57f75561e0f1848ffb29eeb", + "internalRef": "356341083" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "ceaaf31b3d13badab7cf9d3b570f5639db5593d9", - "internalRef": "352816749" + "sha": "8d8c008e56f1af31d57f75561e0f1848ffb29eeb", + "internalRef": "356341083" } }, {