com.google.cloud.dataplex.v1.DataTaxonomyServiceClient Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of google-cloud-dataplex Show documentation
Cloud Dataplex provides intelligent data fabric that enables organizations to centrally manage, monitor, and govern their data across data lakes, data warehouses, and data marts with consistent controls, providing access to trusted data and powering analytics at scale.
There is a newer version: 1.52.0
Show newest version
/*
 * Copyright 2024 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.cloud.dataplex.v1;

import com.google.api.core.ApiFuture;
import com.google.api.core.ApiFutures;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
import com.google.api.gax.httpjson.longrunning.OperationsClient;
import com.google.api.gax.longrunning.OperationFuture;
import com.google.api.gax.paging.AbstractFixedSizeCollection;
import com.google.api.gax.paging.AbstractPage;
import com.google.api.gax.paging.AbstractPagedListResponse;
import com.google.api.gax.rpc.OperationCallable;
import com.google.api.gax.rpc.PageContext;
import com.google.api.gax.rpc.UnaryCallable;
import com.google.cloud.dataplex.v1.stub.DataTaxonomyServiceStub;
import com.google.cloud.dataplex.v1.stub.DataTaxonomyServiceStubSettings;
import com.google.cloud.location.GetLocationRequest;
import com.google.cloud.location.ListLocationsRequest;
import com.google.cloud.location.ListLocationsResponse;
import com.google.cloud.location.Location;
import com.google.common.util.concurrent.MoreExecutors;
import com.google.longrunning.Operation;
import com.google.protobuf.Empty;
import com.google.protobuf.FieldMask;
import java.io.IOException;
import java.util.List;
import java.util.concurrent.TimeUnit;
import javax.annotation.Generated;

// AUTO-GENERATED DOCUMENTATION AND CLASS.
/**
 * Service Description: DataTaxonomyService enables attribute-based governance. The resources
 * currently offered include DataTaxonomy and DataAttribute.
 *
 * 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
 * // This snippet has been automatically generated and should be regarded as a code template only.
 * // It will require modifications to work:
 * // - It may require correct/in-range values for request initialization.
 * // - It may require specifying regional endpoints when creating the service client as shown in
 * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
 *   DataTaxonomyName name = DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]");
 *   DataTaxonomy response = dataTaxonomyServiceClient.getDataTaxonomy(name);
 * }
 * }
 *
 * Note: close() needs to be called on the DataTaxonomyServiceClient object to clean up resources
 * such as threads. In the example above, try-with-resources is used, which automatically calls
 * close().
 *
 * 
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *    
 *      
 *      
 *      
 *    
 *  MethodsMethod Description Method Variants
 CreateDataTaxonomy  Create a DataTaxonomy resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            createDataTaxonomyAsync(CreateDataTaxonomyRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            createDataTaxonomyAsync(LocationName parent, DataTaxonomy dataTaxonomy, String dataTaxonomyId)
 *           
 createDataTaxonomyAsync(String parent, DataTaxonomy dataTaxonomy, String dataTaxonomyId)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            createDataTaxonomyOperationCallable()
 *           
 createDataTaxonomyCallable()
 *      
 *       
 UpdateDataTaxonomy  Updates a DataTaxonomy resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            updateDataTaxonomyAsync(UpdateDataTaxonomyRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            updateDataTaxonomyAsync(DataTaxonomy dataTaxonomy, FieldMask updateMask)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            updateDataTaxonomyOperationCallable()
 *           
 updateDataTaxonomyCallable()
 *      
 *       
 DeleteDataTaxonomy  Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before the DataTaxonomy can be deleted. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            deleteDataTaxonomyAsync(DeleteDataTaxonomyRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            deleteDataTaxonomyAsync(DataTaxonomyName name)
 *           
 deleteDataTaxonomyAsync(String name)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            deleteDataTaxonomyOperationCallable()
 *           
 deleteDataTaxonomyCallable()
 *      
 *       
 ListDataTaxonomies  Lists DataTaxonomy resources in a project and location. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            listDataTaxonomies(ListDataTaxonomiesRequest request)
 *      
 *      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
 *      
 *            listDataTaxonomies(LocationName parent)
 *           
 listDataTaxonomies(String parent)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            listDataTaxonomiesPagedCallable()
 *           
 listDataTaxonomiesCallable()
 *      
 *       
 GetDataTaxonomy  Retrieves a DataTaxonomy resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            getDataTaxonomy(GetDataTaxonomyRequest request)
 *      
 *      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
 *      
 *            getDataTaxonomy(DataTaxonomyName name)
 *           
 getDataTaxonomy(String name)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            getDataTaxonomyCallable()
 *      
 *       
 CreateDataAttributeBinding  Create a DataAttributeBinding resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            createDataAttributeBindingAsync(CreateDataAttributeBindingRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            createDataAttributeBindingAsync(LocationName parent, DataAttributeBinding dataAttributeBinding, String dataAttributeBindingId)
 *           
 createDataAttributeBindingAsync(String parent, DataAttributeBinding dataAttributeBinding, String dataAttributeBindingId)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            createDataAttributeBindingOperationCallable()
 *           
 createDataAttributeBindingCallable()
 *      
 *       
 UpdateDataAttributeBinding  Updates a DataAttributeBinding resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            updateDataAttributeBindingAsync(UpdateDataAttributeBindingRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            updateDataAttributeBindingAsync(DataAttributeBinding dataAttributeBinding, FieldMask updateMask)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            updateDataAttributeBindingOperationCallable()
 *           
 updateDataAttributeBindingCallable()
 *      
 *       
 DeleteDataAttributeBinding  Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be deleted before the DataAttributeBinding can be deleted. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            deleteDataAttributeBindingAsync(DeleteDataAttributeBindingRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            deleteDataAttributeBindingAsync(DataAttributeBindingName name)
 *           
 deleteDataAttributeBindingAsync(String name)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            deleteDataAttributeBindingOperationCallable()
 *           
 deleteDataAttributeBindingCallable()
 *      
 *       
 ListDataAttributeBindings  Lists DataAttributeBinding resources in a project and location. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            listDataAttributeBindings(ListDataAttributeBindingsRequest request)
 *      
 *      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
 *      
 *            listDataAttributeBindings(LocationName parent)
 *           
 listDataAttributeBindings(String parent)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            listDataAttributeBindingsPagedCallable()
 *           
 listDataAttributeBindingsCallable()
 *      
 *       
 GetDataAttributeBinding  Retrieves a DataAttributeBinding resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            getDataAttributeBinding(GetDataAttributeBindingRequest request)
 *      
 *      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
 *      
 *            getDataAttributeBinding(DataAttributeBindingName name)
 *           
 getDataAttributeBinding(String name)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            getDataAttributeBindingCallable()
 *      
 *       
 CreateDataAttribute  Create a DataAttribute resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            createDataAttributeAsync(CreateDataAttributeRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            createDataAttributeAsync(DataTaxonomyName parent, DataAttribute dataAttribute, String dataAttributeId)
 *           
 createDataAttributeAsync(String parent, DataAttribute dataAttribute, String dataAttributeId)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            createDataAttributeOperationCallable()
 *           
 createDataAttributeCallable()
 *      
 *       
 UpdateDataAttribute  Updates a DataAttribute resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            updateDataAttributeAsync(UpdateDataAttributeRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            updateDataAttributeAsync(DataAttribute dataAttribute, FieldMask updateMask)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            updateDataAttributeOperationCallable()
 *           
 updateDataAttributeCallable()
 *      
 *       
 DeleteDataAttribute  Deletes a Data Attribute resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            deleteDataAttributeAsync(DeleteDataAttributeRequest request)
 *      
 *      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.
 *      
 *            deleteDataAttributeAsync(DataAttributeName name)
 *           
 deleteDataAttributeAsync(String name)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            deleteDataAttributeOperationCallable()
 *           
 deleteDataAttributeCallable()
 *      
 *       
 ListDataAttributes  Lists Data Attribute resources in a DataTaxonomy. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            listDataAttributes(ListDataAttributesRequest request)
 *      
 *      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
 *      
 *            listDataAttributes(DataTaxonomyName parent)
 *           
 listDataAttributes(String parent)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            listDataAttributesPagedCallable()
 *           
 listDataAttributesCallable()
 *      
 *       
 GetDataAttribute  Retrieves a Data Attribute resource. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            getDataAttribute(GetDataAttributeRequest request)
 *      
 *      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.
 *      
 *            getDataAttribute(DataAttributeName name)
 *           
 getDataAttribute(String name)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            getDataAttributeCallable()
 *      
 *       
 ListLocations  Lists information about the supported locations for this service. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            listLocations(ListLocationsRequest request)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            listLocationsPagedCallable()
 *           
 listLocationsCallable()
 *      
 *       
 GetLocation  Gets information about a location. 
 *      Request object method variants only take one parameter, a request object, which must be constructed before the call.
 *      
 *            getLocation(GetLocationRequest request)
 *      
 *      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.
 *      
 *            getLocationCallable()
 *      
 *       
 *
 * See the individual methods for example code.
 *
 * 
Many parameters require resource names to be formatted in a particular way. To assist with
 * these names, this class includes a format method for each type of name, and additionally a parse
 * method to extract the individual identifiers contained within names that are returned.
 *
 * 
This class can be customized by passing in a custom instance of DataTaxonomyServiceSettings to
 * create(). For example:
 *
 * 
To customize credentials:
 *
 * 
{@code
 * // This snippet has been automatically generated and should be regarded as a code template only.
 * // It will require modifications to work:
 * // - It may require correct/in-range values for request initialization.
 * // - It may require specifying regional endpoints when creating the service client as shown in
 * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 * DataTaxonomyServiceSettings dataTaxonomyServiceSettings =
 *     DataTaxonomyServiceSettings.newBuilder()
 *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
 *         .build();
 * DataTaxonomyServiceClient dataTaxonomyServiceClient =
 *     DataTaxonomyServiceClient.create(dataTaxonomyServiceSettings);
 * }
 *
 * To customize the endpoint:
 *
 * 
{@code
 * // This snippet has been automatically generated and should be regarded as a code template only.
 * // It will require modifications to work:
 * // - It may require correct/in-range values for request initialization.
 * // - It may require specifying regional endpoints when creating the service client as shown in
 * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 * DataTaxonomyServiceSettings dataTaxonomyServiceSettings =
 *     DataTaxonomyServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 * DataTaxonomyServiceClient dataTaxonomyServiceClient =
 *     DataTaxonomyServiceClient.create(dataTaxonomyServiceSettings);
 * }
 *
 * To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over
 * the wire:
 *
 * 
{@code
 * // This snippet has been automatically generated and should be regarded as a code template only.
 * // It will require modifications to work:
 * // - It may require correct/in-range values for request initialization.
 * // - It may require specifying regional endpoints when creating the service client as shown in
 * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 * DataTaxonomyServiceSettings dataTaxonomyServiceSettings =
 *     DataTaxonomyServiceSettings.newHttpJsonBuilder().build();
 * DataTaxonomyServiceClient dataTaxonomyServiceClient =
 *     DataTaxonomyServiceClient.create(dataTaxonomyServiceSettings);
 * }
 *
 * Please refer to the GitHub repository's samples for more quickstart code snippets.
 */
@Generated("by gapic-generator-java")
public class DataTaxonomyServiceClient implements BackgroundResource {
  private final DataTaxonomyServiceSettings settings;
  private final DataTaxonomyServiceStub stub;
  private final OperationsClient httpJsonOperationsClient;
  private final com.google.longrunning.OperationsClient operationsClient;

  /** Constructs an instance of DataTaxonomyServiceClient with default settings. */
  public static final DataTaxonomyServiceClient create() throws IOException {
    return create(DataTaxonomyServiceSettings.newBuilder().build());
  }

  /**
   * Constructs an instance of DataTaxonomyServiceClient, using the given settings. The channels are
   * created based on the settings passed in, or defaults for any settings that are not set.
   */
  public static final DataTaxonomyServiceClient create(DataTaxonomyServiceSettings settings)
      throws IOException {
    return new DataTaxonomyServiceClient(settings);
  }

  /**
   * Constructs an instance of DataTaxonomyServiceClient, using the given stub for making calls.
   * This is for advanced usage - prefer using create(DataTaxonomyServiceSettings).
   */
  public static final DataTaxonomyServiceClient create(DataTaxonomyServiceStub stub) {
    return new DataTaxonomyServiceClient(stub);
  }

  /**
   * Constructs an instance of DataTaxonomyServiceClient, using the given settings. This is
   * protected so that it is easy to make a subclass, but otherwise, the static factory methods
   * should be preferred.
   */
  protected DataTaxonomyServiceClient(DataTaxonomyServiceSettings settings) throws IOException {
    this.settings = settings;
    this.stub = ((DataTaxonomyServiceStubSettings) settings.getStubSettings()).createStub();
    this.operationsClient =
        com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub());
    this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub());
  }

  protected DataTaxonomyServiceClient(DataTaxonomyServiceStub stub) {
    this.settings = null;
    this.stub = stub;
    this.operationsClient =
        com.google.longrunning.OperationsClient.create(this.stub.getOperationsStub());
    this.httpJsonOperationsClient = OperationsClient.create(this.stub.getHttpJsonOperationsStub());
  }

  public final DataTaxonomyServiceSettings getSettings() {
    return settings;
  }

  public DataTaxonomyServiceStub getStub() {
    return stub;
  }

  /**
   * Returns the OperationsClient that can be used to query the status of a long-running operation
   * returned by another API method call.
   */
  public final com.google.longrunning.OperationsClient getOperationsClient() {
    return operationsClient;
  }

  /**
   * Returns the OperationsClient that can be used to query the status of a long-running operation
   * returned by another API method call.
   */
  @BetaApi
  public final OperationsClient getHttpJsonOperationsClient() {
    return httpJsonOperationsClient;
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataTaxonomy resource.
   *
   * 
Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   *   DataTaxonomy dataTaxonomy = DataTaxonomy.newBuilder().build();
   *   String dataTaxonomyId = "dataTaxonomyId987458454";
   *   DataTaxonomy response =
   *       dataTaxonomyServiceClient
   *           .createDataTaxonomyAsync(parent, dataTaxonomy, dataTaxonomyId)
   *           .get();
   * }
   * }
   *
   * @param parent Required. The resource name of the data taxonomy location, of the form:
   *     projects/{project_number}/locations/{location_id} where `location_id` refers to a GCP
   *     region.
   * @param dataTaxonomy Required. DataTaxonomy resource.
   * @param dataTaxonomyId Required. DataTaxonomy identifier.
   *     
   *       Must contain only lowercase letters, numbers and hyphens.
   *       
Must start with a letter.
   *       
Must be between 1-63 characters.
   *       
Must end with a number or a letter.
   *       
Must be unique within the Project.
   *     
   *
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture createDataTaxonomyAsync(
      LocationName parent, DataTaxonomy dataTaxonomy, String dataTaxonomyId) {
    CreateDataTaxonomyRequest request =
        CreateDataTaxonomyRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .setDataTaxonomy(dataTaxonomy)
            .setDataTaxonomyId(dataTaxonomyId)
            .build();
    return createDataTaxonomyAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   *   DataTaxonomy dataTaxonomy = DataTaxonomy.newBuilder().build();
   *   String dataTaxonomyId = "dataTaxonomyId987458454";
   *   DataTaxonomy response =
   *       dataTaxonomyServiceClient
   *           .createDataTaxonomyAsync(parent, dataTaxonomy, dataTaxonomyId)
   *           .get();
   * }
   * }
   *
   * @param parent Required. The resource name of the data taxonomy location, of the form:
   *     projects/{project_number}/locations/{location_id} where `location_id` refers to a GCP
   *     region.
   * @param dataTaxonomy Required. DataTaxonomy resource.
   * @param dataTaxonomyId Required. DataTaxonomy identifier.
   *     
   *       Must contain only lowercase letters, numbers and hyphens.
   *       
Must start with a letter.
   *       
Must be between 1-63 characters.
   *       
Must end with a number or a letter.
   *       
Must be unique within the Project.
   *     
   *
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture createDataTaxonomyAsync(
      String parent, DataTaxonomy dataTaxonomy, String dataTaxonomyId) {
    CreateDataTaxonomyRequest request =
        CreateDataTaxonomyRequest.newBuilder()
            .setParent(parent)
            .setDataTaxonomy(dataTaxonomy)
            .setDataTaxonomyId(dataTaxonomyId)
            .build();
    return createDataTaxonomyAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataTaxonomyRequest request =
   *       CreateDataTaxonomyRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setDataTaxonomyId("dataTaxonomyId987458454")
   *           .setDataTaxonomy(DataTaxonomy.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   DataTaxonomy response = dataTaxonomyServiceClient.createDataTaxonomyAsync(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
   */
  public final OperationFuture createDataTaxonomyAsync(
      CreateDataTaxonomyRequest request) {
    return createDataTaxonomyOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataTaxonomyRequest request =
   *       CreateDataTaxonomyRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setDataTaxonomyId("dataTaxonomyId987458454")
   *           .setDataTaxonomy(DataTaxonomy.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient.createDataTaxonomyOperationCallable().futureCall(request);
   *   // Do something.
   *   DataTaxonomy response = future.get();
   * }
   * }
   */
  public final OperationCallable
      createDataTaxonomyOperationCallable() {
    return stub.createDataTaxonomyOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataTaxonomyRequest request =
   *       CreateDataTaxonomyRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setDataTaxonomyId("dataTaxonomyId987458454")
   *           .setDataTaxonomy(DataTaxonomy.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.createDataTaxonomyCallable().futureCall(request);
   *   // Do something.
   *   Operation response = future.get();
   * }
   * }
   */
  public final UnaryCallable createDataTaxonomyCallable() {
    return stub.createDataTaxonomyCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataTaxonomy dataTaxonomy = DataTaxonomy.newBuilder().build();
   *   FieldMask updateMask = FieldMask.newBuilder().build();
   *   DataTaxonomy response =
   *       dataTaxonomyServiceClient.updateDataTaxonomyAsync(dataTaxonomy, updateMask).get();
   * }
   * }
   *
   * @param dataTaxonomy Required. Only fields specified in `update_mask` are updated.
   * @param updateMask Required. Mask of fields to update.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture updateDataTaxonomyAsync(
      DataTaxonomy dataTaxonomy, FieldMask updateMask) {
    UpdateDataTaxonomyRequest request =
        UpdateDataTaxonomyRequest.newBuilder()
            .setDataTaxonomy(dataTaxonomy)
            .setUpdateMask(updateMask)
            .build();
    return updateDataTaxonomyAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataTaxonomyRequest request =
   *       UpdateDataTaxonomyRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataTaxonomy(DataTaxonomy.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   DataTaxonomy response = dataTaxonomyServiceClient.updateDataTaxonomyAsync(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
   */
  public final OperationFuture updateDataTaxonomyAsync(
      UpdateDataTaxonomyRequest request) {
    return updateDataTaxonomyOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataTaxonomyRequest request =
   *       UpdateDataTaxonomyRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataTaxonomy(DataTaxonomy.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient.updateDataTaxonomyOperationCallable().futureCall(request);
   *   // Do something.
   *   DataTaxonomy response = future.get();
   * }
   * }
   */
  public final OperationCallable
      updateDataTaxonomyOperationCallable() {
    return stub.updateDataTaxonomyOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataTaxonomyRequest request =
   *       UpdateDataTaxonomyRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataTaxonomy(DataTaxonomy.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.updateDataTaxonomyCallable().futureCall(request);
   *   // Do something.
   *   Operation response = future.get();
   * }
   * }
   */
  public final UnaryCallable updateDataTaxonomyCallable() {
    return stub.updateDataTaxonomyCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before
   * the DataTaxonomy can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataTaxonomyName name = DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]");
   *   dataTaxonomyServiceClient.deleteDataTaxonomyAsync(name).get();
   * }
   * }
   *
   * @param name Required. The resource name of the DataTaxonomy:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture deleteDataTaxonomyAsync(
      DataTaxonomyName name) {
    DeleteDataTaxonomyRequest request =
        DeleteDataTaxonomyRequest.newBuilder()
            .setName(name == null ? null : name.toString())
            .build();
    return deleteDataTaxonomyAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before
   * the DataTaxonomy can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String name = DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString();
   *   dataTaxonomyServiceClient.deleteDataTaxonomyAsync(name).get();
   * }
   * }
   *
   * @param name Required. The resource name of the DataTaxonomy:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture deleteDataTaxonomyAsync(String name) {
    DeleteDataTaxonomyRequest request =
        DeleteDataTaxonomyRequest.newBuilder().setName(name).build();
    return deleteDataTaxonomyAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before
   * the DataTaxonomy can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataTaxonomyRequest request =
   *       DeleteDataTaxonomyRequest.newBuilder()
   *           .setName(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   dataTaxonomyServiceClient.deleteDataTaxonomyAsync(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
   */
  public final OperationFuture deleteDataTaxonomyAsync(
      DeleteDataTaxonomyRequest request) {
    return deleteDataTaxonomyOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before
   * the DataTaxonomy can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataTaxonomyRequest request =
   *       DeleteDataTaxonomyRequest.newBuilder()
   *           .setName(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient.deleteDataTaxonomyOperationCallable().futureCall(request);
   *   // Do something.
   *   future.get();
   * }
   * }
   */
  public final OperationCallable
      deleteDataTaxonomyOperationCallable() {
    return stub.deleteDataTaxonomyOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before
   * the DataTaxonomy can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataTaxonomyRequest request =
   *       DeleteDataTaxonomyRequest.newBuilder()
   *           .setName(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.deleteDataTaxonomyCallable().futureCall(request);
   *   // Do something.
   *   future.get();
   * }
   * }
   */
  public final UnaryCallable deleteDataTaxonomyCallable() {
    return stub.deleteDataTaxonomyCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataTaxonomy resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   *   for (DataTaxonomy element :
   *       dataTaxonomyServiceClient.listDataTaxonomies(parent).iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   *
   * @param parent Required. The resource name of the DataTaxonomy location, of the form:
   *     projects/{project_number}/locations/{location_id} where `location_id` refers to a GCP
   *     region.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListDataTaxonomiesPagedResponse listDataTaxonomies(LocationName parent) {
    ListDataTaxonomiesRequest request =
        ListDataTaxonomiesRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .build();
    return listDataTaxonomies(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataTaxonomy resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   *   for (DataTaxonomy element :
   *       dataTaxonomyServiceClient.listDataTaxonomies(parent).iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   *
   * @param parent Required. The resource name of the DataTaxonomy location, of the form:
   *     projects/{project_number}/locations/{location_id} where `location_id` refers to a GCP
   *     region.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListDataTaxonomiesPagedResponse listDataTaxonomies(String parent) {
    ListDataTaxonomiesRequest request =
        ListDataTaxonomiesRequest.newBuilder().setParent(parent).build();
    return listDataTaxonomies(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataTaxonomy resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataTaxonomiesRequest request =
   *       ListDataTaxonomiesRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   for (DataTaxonomy element :
   *       dataTaxonomyServiceClient.listDataTaxonomies(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
   */
  public final ListDataTaxonomiesPagedResponse listDataTaxonomies(
      ListDataTaxonomiesRequest request) {
    return listDataTaxonomiesPagedCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataTaxonomy resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataTaxonomiesRequest request =
   *       ListDataTaxonomiesRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.listDataTaxonomiesPagedCallable().futureCall(request);
   *   // Do something.
   *   for (DataTaxonomy element : future.get().iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   */
  public final UnaryCallable
      listDataTaxonomiesPagedCallable() {
    return stub.listDataTaxonomiesPagedCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataTaxonomy resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataTaxonomiesRequest request =
   *       ListDataTaxonomiesRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   while (true) {
   *     ListDataTaxonomiesResponse response =
   *         dataTaxonomyServiceClient.listDataTaxonomiesCallable().call(request);
   *     for (DataTaxonomy element : response.getDataTaxonomiesList()) {
   *       // doThingsWith(element);
   *     }
   *     String nextPageToken = response.getNextPageToken();
   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
   *       request = request.toBuilder().setPageToken(nextPageToken).build();
   *     } else {
   *       break;
   *     }
   *   }
   * }
   * }
   */
  public final UnaryCallable
      listDataTaxonomiesCallable() {
    return stub.listDataTaxonomiesCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataTaxonomyName name = DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]");
   *   DataTaxonomy response = dataTaxonomyServiceClient.getDataTaxonomy(name);
   * }
   * }
   *
   * @param name Required. The resource name of the DataTaxonomy:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final DataTaxonomy getDataTaxonomy(DataTaxonomyName name) {
    GetDataTaxonomyRequest request =
        GetDataTaxonomyRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    return getDataTaxonomy(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String name = DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString();
   *   DataTaxonomy response = dataTaxonomyServiceClient.getDataTaxonomy(name);
   * }
   * }
   *
   * @param name Required. The resource name of the DataTaxonomy:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final DataTaxonomy getDataTaxonomy(String name) {
    GetDataTaxonomyRequest request = GetDataTaxonomyRequest.newBuilder().setName(name).build();
    return getDataTaxonomy(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   GetDataTaxonomyRequest request =
   *       GetDataTaxonomyRequest.newBuilder()
   *           .setName(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .build();
   *   DataTaxonomy response = dataTaxonomyServiceClient.getDataTaxonomy(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
   */
  public final DataTaxonomy getDataTaxonomy(GetDataTaxonomyRequest request) {
    return getDataTaxonomyCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a DataTaxonomy resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   GetDataTaxonomyRequest request =
   *       GetDataTaxonomyRequest.newBuilder()
   *           .setName(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.getDataTaxonomyCallable().futureCall(request);
   *   // Do something.
   *   DataTaxonomy response = future.get();
   * }
   * }
   */
  public final UnaryCallable getDataTaxonomyCallable() {
    return stub.getDataTaxonomyCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   *   DataAttributeBinding dataAttributeBinding = DataAttributeBinding.newBuilder().build();
   *   String dataAttributeBindingId = "dataAttributeBindingId1952425102";
   *   DataAttributeBinding response =
   *       dataTaxonomyServiceClient
   *           .createDataAttributeBindingAsync(parent, dataAttributeBinding, dataAttributeBindingId)
   *           .get();
   * }
   * }
   *
   * @param parent Required. The resource name of the parent data taxonomy
   *     projects/{project_number}/locations/{location_id}
   * @param dataAttributeBinding Required. DataAttributeBinding resource.
   * @param dataAttributeBindingId Required. DataAttributeBinding identifier.
   *     
   *       Must contain only lowercase letters, numbers and hyphens.
   *       
Must start with a letter.
   *       
Must be between 1-63 characters.
   *       
Must end with a number or a letter.
   *       
Must be unique within the Location.
   *     
   *
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture
      createDataAttributeBindingAsync(
          LocationName parent,
          DataAttributeBinding dataAttributeBinding,
          String dataAttributeBindingId) {
    CreateDataAttributeBindingRequest request =
        CreateDataAttributeBindingRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .setDataAttributeBinding(dataAttributeBinding)
            .setDataAttributeBindingId(dataAttributeBindingId)
            .build();
    return createDataAttributeBindingAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   *   DataAttributeBinding dataAttributeBinding = DataAttributeBinding.newBuilder().build();
   *   String dataAttributeBindingId = "dataAttributeBindingId1952425102";
   *   DataAttributeBinding response =
   *       dataTaxonomyServiceClient
   *           .createDataAttributeBindingAsync(parent, dataAttributeBinding, dataAttributeBindingId)
   *           .get();
   * }
   * }
   *
   * @param parent Required. The resource name of the parent data taxonomy
   *     projects/{project_number}/locations/{location_id}
   * @param dataAttributeBinding Required. DataAttributeBinding resource.
   * @param dataAttributeBindingId Required. DataAttributeBinding identifier.
   *     
   *       Must contain only lowercase letters, numbers and hyphens.
   *       
Must start with a letter.
   *       
Must be between 1-63 characters.
   *       
Must end with a number or a letter.
   *       
Must be unique within the Location.
   *     
   *
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture
      createDataAttributeBindingAsync(
          String parent, DataAttributeBinding dataAttributeBinding, String dataAttributeBindingId) {
    CreateDataAttributeBindingRequest request =
        CreateDataAttributeBindingRequest.newBuilder()
            .setParent(parent)
            .setDataAttributeBinding(dataAttributeBinding)
            .setDataAttributeBindingId(dataAttributeBindingId)
            .build();
    return createDataAttributeBindingAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataAttributeBindingRequest request =
   *       CreateDataAttributeBindingRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setDataAttributeBindingId("dataAttributeBindingId1952425102")
   *           .setDataAttributeBinding(DataAttributeBinding.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   DataAttributeBinding response =
   *       dataTaxonomyServiceClient.createDataAttributeBindingAsync(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
   */
  public final OperationFuture
      createDataAttributeBindingAsync(CreateDataAttributeBindingRequest request) {
    return createDataAttributeBindingOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataAttributeBindingRequest request =
   *       CreateDataAttributeBindingRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setDataAttributeBindingId("dataAttributeBindingId1952425102")
   *           .setDataAttributeBinding(DataAttributeBinding.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient
   *           .createDataAttributeBindingOperationCallable()
   *           .futureCall(request);
   *   // Do something.
   *   DataAttributeBinding response = future.get();
   * }
   * }
   */
  public final OperationCallable<
          CreateDataAttributeBindingRequest, DataAttributeBinding, OperationMetadata>
      createDataAttributeBindingOperationCallable() {
    return stub.createDataAttributeBindingOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataAttributeBindingRequest request =
   *       CreateDataAttributeBindingRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setDataAttributeBindingId("dataAttributeBindingId1952425102")
   *           .setDataAttributeBinding(DataAttributeBinding.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.createDataAttributeBindingCallable().futureCall(request);
   *   // Do something.
   *   Operation response = future.get();
   * }
   * }
   */
  public final UnaryCallable
      createDataAttributeBindingCallable() {
    return stub.createDataAttributeBindingCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataAttributeBinding dataAttributeBinding = DataAttributeBinding.newBuilder().build();
   *   FieldMask updateMask = FieldMask.newBuilder().build();
   *   DataAttributeBinding response =
   *       dataTaxonomyServiceClient
   *           .updateDataAttributeBindingAsync(dataAttributeBinding, updateMask)
   *           .get();
   * }
   * }
   *
   * @param dataAttributeBinding Required. Only fields specified in `update_mask` are updated.
   * @param updateMask Required. Mask of fields to update.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture
      updateDataAttributeBindingAsync(
          DataAttributeBinding dataAttributeBinding, FieldMask updateMask) {
    UpdateDataAttributeBindingRequest request =
        UpdateDataAttributeBindingRequest.newBuilder()
            .setDataAttributeBinding(dataAttributeBinding)
            .setUpdateMask(updateMask)
            .build();
    return updateDataAttributeBindingAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataAttributeBindingRequest request =
   *       UpdateDataAttributeBindingRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataAttributeBinding(DataAttributeBinding.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   DataAttributeBinding response =
   *       dataTaxonomyServiceClient.updateDataAttributeBindingAsync(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
   */
  public final OperationFuture
      updateDataAttributeBindingAsync(UpdateDataAttributeBindingRequest request) {
    return updateDataAttributeBindingOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataAttributeBindingRequest request =
   *       UpdateDataAttributeBindingRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataAttributeBinding(DataAttributeBinding.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient
   *           .updateDataAttributeBindingOperationCallable()
   *           .futureCall(request);
   *   // Do something.
   *   DataAttributeBinding response = future.get();
   * }
   * }
   */
  public final OperationCallable<
          UpdateDataAttributeBindingRequest, DataAttributeBinding, OperationMetadata>
      updateDataAttributeBindingOperationCallable() {
    return stub.updateDataAttributeBindingOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataAttributeBindingRequest request =
   *       UpdateDataAttributeBindingRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataAttributeBinding(DataAttributeBinding.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.updateDataAttributeBindingCallable().futureCall(request);
   *   // Do something.
   *   Operation response = future.get();
   * }
   * }
   */
  public final UnaryCallable
      updateDataAttributeBindingCallable() {
    return stub.updateDataAttributeBindingCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be
   * deleted before the DataAttributeBinding can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataAttributeBindingName name =
   *       DataAttributeBindingName.of("[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]");
   *   dataTaxonomyServiceClient.deleteDataAttributeBindingAsync(name).get();
   * }
   * }
   *
   * @param name Required. The resource name of the DataAttributeBinding:
   *     projects/{project_number}/locations/{location_id}/dataAttributeBindings/{data_attribute_binding_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture deleteDataAttributeBindingAsync(
      DataAttributeBindingName name) {
    DeleteDataAttributeBindingRequest request =
        DeleteDataAttributeBindingRequest.newBuilder()
            .setName(name == null ? null : name.toString())
            .build();
    return deleteDataAttributeBindingAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be
   * deleted before the DataAttributeBinding can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String name =
   *       DataAttributeBindingName.of("[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]")
   *           .toString();
   *   dataTaxonomyServiceClient.deleteDataAttributeBindingAsync(name).get();
   * }
   * }
   *
   * @param name Required. The resource name of the DataAttributeBinding:
   *     projects/{project_number}/locations/{location_id}/dataAttributeBindings/{data_attribute_binding_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture deleteDataAttributeBindingAsync(
      String name) {
    DeleteDataAttributeBindingRequest request =
        DeleteDataAttributeBindingRequest.newBuilder().setName(name).build();
    return deleteDataAttributeBindingAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be
   * deleted before the DataAttributeBinding can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataAttributeBindingRequest request =
   *       DeleteDataAttributeBindingRequest.newBuilder()
   *           .setName(
   *               DataAttributeBindingName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]")
   *                   .toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   dataTaxonomyServiceClient.deleteDataAttributeBindingAsync(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
   */
  public final OperationFuture deleteDataAttributeBindingAsync(
      DeleteDataAttributeBindingRequest request) {
    return deleteDataAttributeBindingOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be
   * deleted before the DataAttributeBinding can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataAttributeBindingRequest request =
   *       DeleteDataAttributeBindingRequest.newBuilder()
   *           .setName(
   *               DataAttributeBindingName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]")
   *                   .toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient
   *           .deleteDataAttributeBindingOperationCallable()
   *           .futureCall(request);
   *   // Do something.
   *   future.get();
   * }
   * }
   */
  public final OperationCallable
      deleteDataAttributeBindingOperationCallable() {
    return stub.deleteDataAttributeBindingOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be
   * deleted before the DataAttributeBinding can be deleted.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataAttributeBindingRequest request =
   *       DeleteDataAttributeBindingRequest.newBuilder()
   *           .setName(
   *               DataAttributeBindingName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]")
   *                   .toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.deleteDataAttributeBindingCallable().futureCall(request);
   *   // Do something.
   *   future.get();
   * }
   * }
   */
  public final UnaryCallable
      deleteDataAttributeBindingCallable() {
    return stub.deleteDataAttributeBindingCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataAttributeBinding resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   *   for (DataAttributeBinding element :
   *       dataTaxonomyServiceClient.listDataAttributeBindings(parent).iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   *
   * @param parent Required. The resource name of the Location:
   *     projects/{project_number}/locations/{location_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListDataAttributeBindingsPagedResponse listDataAttributeBindings(
      LocationName parent) {
    ListDataAttributeBindingsRequest request =
        ListDataAttributeBindingsRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .build();
    return listDataAttributeBindings(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataAttributeBinding resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   *   for (DataAttributeBinding element :
   *       dataTaxonomyServiceClient.listDataAttributeBindings(parent).iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   *
   * @param parent Required. The resource name of the Location:
   *     projects/{project_number}/locations/{location_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListDataAttributeBindingsPagedResponse listDataAttributeBindings(String parent) {
    ListDataAttributeBindingsRequest request =
        ListDataAttributeBindingsRequest.newBuilder().setParent(parent).build();
    return listDataAttributeBindings(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataAttributeBinding resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataAttributeBindingsRequest request =
   *       ListDataAttributeBindingsRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   for (DataAttributeBinding element :
   *       dataTaxonomyServiceClient.listDataAttributeBindings(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
   */
  public final ListDataAttributeBindingsPagedResponse listDataAttributeBindings(
      ListDataAttributeBindingsRequest request) {
    return listDataAttributeBindingsPagedCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataAttributeBinding resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataAttributeBindingsRequest request =
   *       ListDataAttributeBindingsRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.listDataAttributeBindingsPagedCallable().futureCall(request);
   *   // Do something.
   *   for (DataAttributeBinding element : future.get().iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   */
  public final UnaryCallable<
          ListDataAttributeBindingsRequest, ListDataAttributeBindingsPagedResponse>
      listDataAttributeBindingsPagedCallable() {
    return stub.listDataAttributeBindingsPagedCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists DataAttributeBinding resources in a project and location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataAttributeBindingsRequest request =
   *       ListDataAttributeBindingsRequest.newBuilder()
   *           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   while (true) {
   *     ListDataAttributeBindingsResponse response =
   *         dataTaxonomyServiceClient.listDataAttributeBindingsCallable().call(request);
   *     for (DataAttributeBinding element : response.getDataAttributeBindingsList()) {
   *       // doThingsWith(element);
   *     }
   *     String nextPageToken = response.getNextPageToken();
   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
   *       request = request.toBuilder().setPageToken(nextPageToken).build();
   *     } else {
   *       break;
   *     }
   *   }
   * }
   * }
   */
  public final UnaryCallable
      listDataAttributeBindingsCallable() {
    return stub.listDataAttributeBindingsCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataAttributeBindingName name =
   *       DataAttributeBindingName.of("[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]");
   *   DataAttributeBinding response = dataTaxonomyServiceClient.getDataAttributeBinding(name);
   * }
   * }
   *
   * @param name Required. The resource name of the DataAttributeBinding:
   *     projects/{project_number}/locations/{location_id}/dataAttributeBindings/{data_attribute_binding_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final DataAttributeBinding getDataAttributeBinding(DataAttributeBindingName name) {
    GetDataAttributeBindingRequest request =
        GetDataAttributeBindingRequest.newBuilder()
            .setName(name == null ? null : name.toString())
            .build();
    return getDataAttributeBinding(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String name =
   *       DataAttributeBindingName.of("[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]")
   *           .toString();
   *   DataAttributeBinding response = dataTaxonomyServiceClient.getDataAttributeBinding(name);
   * }
   * }
   *
   * @param name Required. The resource name of the DataAttributeBinding:
   *     projects/{project_number}/locations/{location_id}/dataAttributeBindings/{data_attribute_binding_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final DataAttributeBinding getDataAttributeBinding(String name) {
    GetDataAttributeBindingRequest request =
        GetDataAttributeBindingRequest.newBuilder().setName(name).build();
    return getDataAttributeBinding(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   GetDataAttributeBindingRequest request =
   *       GetDataAttributeBindingRequest.newBuilder()
   *           .setName(
   *               DataAttributeBindingName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]")
   *                   .toString())
   *           .build();
   *   DataAttributeBinding response = dataTaxonomyServiceClient.getDataAttributeBinding(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
   */
  public final DataAttributeBinding getDataAttributeBinding(
      GetDataAttributeBindingRequest request) {
    return getDataAttributeBindingCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a DataAttributeBinding resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   GetDataAttributeBindingRequest request =
   *       GetDataAttributeBindingRequest.newBuilder()
   *           .setName(
   *               DataAttributeBindingName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATA_ATTRIBUTE_BINDING_ID]")
   *                   .toString())
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.getDataAttributeBindingCallable().futureCall(request);
   *   // Do something.
   *   DataAttributeBinding response = future.get();
   * }
   * }
   */
  public final UnaryCallable
      getDataAttributeBindingCallable() {
    return stub.getDataAttributeBindingCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataTaxonomyName parent =
   *       DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]");
   *   DataAttribute dataAttribute = DataAttribute.newBuilder().build();
   *   String dataAttributeId = "dataAttributeId-44128563";
   *   DataAttribute response =
   *       dataTaxonomyServiceClient
   *           .createDataAttributeAsync(parent, dataAttribute, dataAttributeId)
   *           .get();
   * }
   * }
   *
   * @param parent Required. The resource name of the parent data taxonomy
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}
   * @param dataAttribute Required. DataAttribute resource.
   * @param dataAttributeId Required. DataAttribute identifier.
   *     
   *       Must contain only lowercase letters, numbers and hyphens.
   *       
Must start with a letter.
   *       
Must be between 1-63 characters.
   *       
Must end with a number or a letter.
   *       
Must be unique within the DataTaxonomy.
   *     
   *
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture createDataAttributeAsync(
      DataTaxonomyName parent, DataAttribute dataAttribute, String dataAttributeId) {
    CreateDataAttributeRequest request =
        CreateDataAttributeRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .setDataAttribute(dataAttribute)
            .setDataAttributeId(dataAttributeId)
            .build();
    return createDataAttributeAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String parent =
   *       DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString();
   *   DataAttribute dataAttribute = DataAttribute.newBuilder().build();
   *   String dataAttributeId = "dataAttributeId-44128563";
   *   DataAttribute response =
   *       dataTaxonomyServiceClient
   *           .createDataAttributeAsync(parent, dataAttribute, dataAttributeId)
   *           .get();
   * }
   * }
   *
   * @param parent Required. The resource name of the parent data taxonomy
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}
   * @param dataAttribute Required. DataAttribute resource.
   * @param dataAttributeId Required. DataAttribute identifier.
   *     
   *       Must contain only lowercase letters, numbers and hyphens.
   *       
Must start with a letter.
   *       
Must be between 1-63 characters.
   *       
Must end with a number or a letter.
   *       
Must be unique within the DataTaxonomy.
   *     
   *
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture createDataAttributeAsync(
      String parent, DataAttribute dataAttribute, String dataAttributeId) {
    CreateDataAttributeRequest request =
        CreateDataAttributeRequest.newBuilder()
            .setParent(parent)
            .setDataAttribute(dataAttribute)
            .setDataAttributeId(dataAttributeId)
            .build();
    return createDataAttributeAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataAttributeRequest request =
   *       CreateDataAttributeRequest.newBuilder()
   *           .setParent(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setDataAttributeId("dataAttributeId-44128563")
   *           .setDataAttribute(DataAttribute.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   DataAttribute response = dataTaxonomyServiceClient.createDataAttributeAsync(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
   */
  public final OperationFuture createDataAttributeAsync(
      CreateDataAttributeRequest request) {
    return createDataAttributeOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataAttributeRequest request =
   *       CreateDataAttributeRequest.newBuilder()
   *           .setParent(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setDataAttributeId("dataAttributeId-44128563")
   *           .setDataAttribute(DataAttribute.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient.createDataAttributeOperationCallable().futureCall(request);
   *   // Do something.
   *   DataAttribute response = future.get();
   * }
   * }
   */
  public final OperationCallable
      createDataAttributeOperationCallable() {
    return stub.createDataAttributeOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Create a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   CreateDataAttributeRequest request =
   *       CreateDataAttributeRequest.newBuilder()
   *           .setParent(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setDataAttributeId("dataAttributeId-44128563")
   *           .setDataAttribute(DataAttribute.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.createDataAttributeCallable().futureCall(request);
   *   // Do something.
   *   Operation response = future.get();
   * }
   * }
   */
  public final UnaryCallable createDataAttributeCallable() {
    return stub.createDataAttributeCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataAttribute dataAttribute = DataAttribute.newBuilder().build();
   *   FieldMask updateMask = FieldMask.newBuilder().build();
   *   DataAttribute response =
   *       dataTaxonomyServiceClient.updateDataAttributeAsync(dataAttribute, updateMask).get();
   * }
   * }
   *
   * @param dataAttribute Required. Only fields specified in `update_mask` are updated.
   * @param updateMask Required. Mask of fields to update.
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture updateDataAttributeAsync(
      DataAttribute dataAttribute, FieldMask updateMask) {
    UpdateDataAttributeRequest request =
        UpdateDataAttributeRequest.newBuilder()
            .setDataAttribute(dataAttribute)
            .setUpdateMask(updateMask)
            .build();
    return updateDataAttributeAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataAttributeRequest request =
   *       UpdateDataAttributeRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataAttribute(DataAttribute.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   DataAttribute response = dataTaxonomyServiceClient.updateDataAttributeAsync(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
   */
  public final OperationFuture updateDataAttributeAsync(
      UpdateDataAttributeRequest request) {
    return updateDataAttributeOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataAttributeRequest request =
   *       UpdateDataAttributeRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataAttribute(DataAttribute.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient.updateDataAttributeOperationCallable().futureCall(request);
   *   // Do something.
   *   DataAttribute response = future.get();
   * }
   * }
   */
  public final OperationCallable
      updateDataAttributeOperationCallable() {
    return stub.updateDataAttributeOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Updates a DataAttribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   UpdateDataAttributeRequest request =
   *       UpdateDataAttributeRequest.newBuilder()
   *           .setUpdateMask(FieldMask.newBuilder().build())
   *           .setDataAttribute(DataAttribute.newBuilder().build())
   *           .setValidateOnly(true)
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.updateDataAttributeCallable().futureCall(request);
   *   // Do something.
   *   Operation response = future.get();
   * }
   * }
   */
  public final UnaryCallable updateDataAttributeCallable() {
    return stub.updateDataAttributeCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataAttributeName name =
   *       DataAttributeName.of("[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]");
   *   dataTaxonomyServiceClient.deleteDataAttributeAsync(name).get();
   * }
   * }
   *
   * @param name Required. The resource name of the DataAttribute:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture deleteDataAttributeAsync(
      DataAttributeName name) {
    DeleteDataAttributeRequest request =
        DeleteDataAttributeRequest.newBuilder()
            .setName(name == null ? null : name.toString())
            .build();
    return deleteDataAttributeAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String name =
   *       DataAttributeName.of("[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]")
   *           .toString();
   *   dataTaxonomyServiceClient.deleteDataAttributeAsync(name).get();
   * }
   * }
   *
   * @param name Required. The resource name of the DataAttribute:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final OperationFuture deleteDataAttributeAsync(String name) {
    DeleteDataAttributeRequest request =
        DeleteDataAttributeRequest.newBuilder().setName(name).build();
    return deleteDataAttributeAsync(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataAttributeRequest request =
   *       DeleteDataAttributeRequest.newBuilder()
   *           .setName(
   *               DataAttributeName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]")
   *                   .toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   dataTaxonomyServiceClient.deleteDataAttributeAsync(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
   */
  public final OperationFuture deleteDataAttributeAsync(
      DeleteDataAttributeRequest request) {
    return deleteDataAttributeOperationCallable().futureCall(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataAttributeRequest request =
   *       DeleteDataAttributeRequest.newBuilder()
   *           .setName(
   *               DataAttributeName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]")
   *                   .toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   OperationFuture future =
   *       dataTaxonomyServiceClient.deleteDataAttributeOperationCallable().futureCall(request);
   *   // Do something.
   *   future.get();
   * }
   * }
   */
  public final OperationCallable
      deleteDataAttributeOperationCallable() {
    return stub.deleteDataAttributeOperationCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Deletes a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DeleteDataAttributeRequest request =
   *       DeleteDataAttributeRequest.newBuilder()
   *           .setName(
   *               DataAttributeName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]")
   *                   .toString())
   *           .setEtag("etag3123477")
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.deleteDataAttributeCallable().futureCall(request);
   *   // Do something.
   *   future.get();
   * }
   * }
   */
  public final UnaryCallable deleteDataAttributeCallable() {
    return stub.deleteDataAttributeCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists Data Attribute resources in a DataTaxonomy.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataTaxonomyName parent =
   *       DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]");
   *   for (DataAttribute element :
   *       dataTaxonomyServiceClient.listDataAttributes(parent).iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   *
   * @param parent Required. The resource name of the DataTaxonomy:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListDataAttributesPagedResponse listDataAttributes(DataTaxonomyName parent) {
    ListDataAttributesRequest request =
        ListDataAttributesRequest.newBuilder()
            .setParent(parent == null ? null : parent.toString())
            .build();
    return listDataAttributes(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists Data Attribute resources in a DataTaxonomy.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String parent =
   *       DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString();
   *   for (DataAttribute element :
   *       dataTaxonomyServiceClient.listDataAttributes(parent).iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   *
   * @param parent Required. The resource name of the DataTaxonomy:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final ListDataAttributesPagedResponse listDataAttributes(String parent) {
    ListDataAttributesRequest request =
        ListDataAttributesRequest.newBuilder().setParent(parent).build();
    return listDataAttributes(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists Data Attribute resources in a DataTaxonomy.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataAttributesRequest request =
   *       ListDataAttributesRequest.newBuilder()
   *           .setParent(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   for (DataAttribute element :
   *       dataTaxonomyServiceClient.listDataAttributes(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
   */
  public final ListDataAttributesPagedResponse listDataAttributes(
      ListDataAttributesRequest request) {
    return listDataAttributesPagedCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists Data Attribute resources in a DataTaxonomy.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataAttributesRequest request =
   *       ListDataAttributesRequest.newBuilder()
   *           .setParent(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.listDataAttributesPagedCallable().futureCall(request);
   *   // Do something.
   *   for (DataAttribute element : future.get().iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   */
  public final UnaryCallable
      listDataAttributesPagedCallable() {
    return stub.listDataAttributesPagedCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists Data Attribute resources in a DataTaxonomy.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListDataAttributesRequest request =
   *       ListDataAttributesRequest.newBuilder()
   *           .setParent(
   *               DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]").toString())
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .setFilter("filter-1274492040")
   *           .setOrderBy("orderBy-1207110587")
   *           .build();
   *   while (true) {
   *     ListDataAttributesResponse response =
   *         dataTaxonomyServiceClient.listDataAttributesCallable().call(request);
   *     for (DataAttribute element : response.getDataAttributesList()) {
   *       // doThingsWith(element);
   *     }
   *     String nextPageToken = response.getNextPageToken();
   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
   *       request = request.toBuilder().setPageToken(nextPageToken).build();
   *     } else {
   *       break;
   *     }
   *   }
   * }
   * }
   */
  public final UnaryCallable
      listDataAttributesCallable() {
    return stub.listDataAttributesCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   DataAttributeName name =
   *       DataAttributeName.of("[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]");
   *   DataAttribute response = dataTaxonomyServiceClient.getDataAttribute(name);
   * }
   * }
   *
   * @param name Required. The resource name of the dataAttribute:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final DataAttribute getDataAttribute(DataAttributeName name) {
    GetDataAttributeRequest request =
        GetDataAttributeRequest.newBuilder().setName(name == null ? null : name.toString()).build();
    return getDataAttribute(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   String name =
   *       DataAttributeName.of("[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]")
   *           .toString();
   *   DataAttribute response = dataTaxonomyServiceClient.getDataAttribute(name);
   * }
   * }
   *
   * @param name Required. The resource name of the dataAttribute:
   *     projects/{project_number}/locations/{location_id}/dataTaxonomies/{dataTaxonomy}/attributes/{data_attribute_id}
   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
   */
  public final DataAttribute getDataAttribute(String name) {
    GetDataAttributeRequest request = GetDataAttributeRequest.newBuilder().setName(name).build();
    return getDataAttribute(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   GetDataAttributeRequest request =
   *       GetDataAttributeRequest.newBuilder()
   *           .setName(
   *               DataAttributeName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]")
   *                   .toString())
   *           .build();
   *   DataAttribute response = dataTaxonomyServiceClient.getDataAttribute(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
   */
  public final DataAttribute getDataAttribute(GetDataAttributeRequest request) {
    return getDataAttributeCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Retrieves a Data Attribute resource.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   GetDataAttributeRequest request =
   *       GetDataAttributeRequest.newBuilder()
   *           .setName(
   *               DataAttributeName.of(
   *                       "[PROJECT]", "[LOCATION]", "[DATATAXONOMY]", "[DATA_ATTRIBUTE_ID]")
   *                   .toString())
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.getDataAttributeCallable().futureCall(request);
   *   // Do something.
   *   DataAttribute response = future.get();
   * }
   * }
   */
  public final UnaryCallable getDataAttributeCallable() {
    return stub.getDataAttributeCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists information about the supported locations for this service.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListLocationsRequest request =
   *       ListLocationsRequest.newBuilder()
   *           .setName("name3373707")
   *           .setFilter("filter-1274492040")
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .build();
   *   for (Location element : dataTaxonomyServiceClient.listLocations(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
   */
  public final ListLocationsPagedResponse listLocations(ListLocationsRequest request) {
    return listLocationsPagedCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists information about the supported locations for this service.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListLocationsRequest request =
   *       ListLocationsRequest.newBuilder()
   *           .setName("name3373707")
   *           .setFilter("filter-1274492040")
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.listLocationsPagedCallable().futureCall(request);
   *   // Do something.
   *   for (Location element : future.get().iterateAll()) {
   *     // doThingsWith(element);
   *   }
   * }
   * }
   */
  public final UnaryCallable
      listLocationsPagedCallable() {
    return stub.listLocationsPagedCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Lists information about the supported locations for this service.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   ListLocationsRequest request =
   *       ListLocationsRequest.newBuilder()
   *           .setName("name3373707")
   *           .setFilter("filter-1274492040")
   *           .setPageSize(883849137)
   *           .setPageToken("pageToken873572522")
   *           .build();
   *   while (true) {
   *     ListLocationsResponse response =
   *         dataTaxonomyServiceClient.listLocationsCallable().call(request);
   *     for (Location element : response.getLocationsList()) {
   *       // doThingsWith(element);
   *     }
   *     String nextPageToken = response.getNextPageToken();
   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
   *       request = request.toBuilder().setPageToken(nextPageToken).build();
   *     } else {
   *       break;
   *     }
   *   }
   * }
   * }
   */
  public final UnaryCallable listLocationsCallable() {
    return stub.listLocationsCallable();
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Gets information about a location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   GetLocationRequest request = GetLocationRequest.newBuilder().setName("name3373707").build();
   *   Location response = dataTaxonomyServiceClient.getLocation(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
   */
  public final Location getLocation(GetLocationRequest request) {
    return getLocationCallable().call(request);
  }

  // AUTO-GENERATED DOCUMENTATION AND METHOD.
  /**
   * Gets information about a location.
   *
   * Sample code:
   *
   * 
{@code
   * // This snippet has been automatically generated and should be regarded as a code template only.
   * // It will require modifications to work:
   * // - It may require correct/in-range values for request initialization.
   * // - It may require specifying regional endpoints when creating the service client as shown in
   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
   * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
   *   GetLocationRequest request = GetLocationRequest.newBuilder().setName("name3373707").build();
   *   ApiFuture future =
   *       dataTaxonomyServiceClient.getLocationCallable().futureCall(request);
   *   // Do something.
   *   Location response = future.get();
   * }
   * }
   */
  public final UnaryCallable getLocationCallable() {
    return stub.getLocationCallable();
  }

  @Override
  public final void close() {
    stub.close();
  }

  @Override
  public void shutdown() {
    stub.shutdown();
  }

  @Override
  public boolean isShutdown() {
    return stub.isShutdown();
  }

  @Override
  public boolean isTerminated() {
    return stub.isTerminated();
  }

  @Override
  public void shutdownNow() {
    stub.shutdownNow();
  }

  @Override
  public boolean awaitTermination(long duration, TimeUnit unit) throws InterruptedException {
    return stub.awaitTermination(duration, unit);
  }

  public static class ListDataTaxonomiesPagedResponse
      extends AbstractPagedListResponse<
          ListDataTaxonomiesRequest,
          ListDataTaxonomiesResponse,
          DataTaxonomy,
          ListDataTaxonomiesPage,
          ListDataTaxonomiesFixedSizeCollection> {

    public static ApiFuture createAsync(
        PageContext context,
        ApiFuture futureResponse) {
      ApiFuture futurePage =
          ListDataTaxonomiesPage.createEmptyPage().createPageAsync(context, futureResponse);
      return ApiFutures.transform(
          futurePage,
          input -> new ListDataTaxonomiesPagedResponse(input),
          MoreExecutors.directExecutor());
    }

    private ListDataTaxonomiesPagedResponse(ListDataTaxonomiesPage page) {
      super(page, ListDataTaxonomiesFixedSizeCollection.createEmptyCollection());
    }
  }

  public static class ListDataTaxonomiesPage
      extends AbstractPage<
          ListDataTaxonomiesRequest,
          ListDataTaxonomiesResponse,
          DataTaxonomy,
          ListDataTaxonomiesPage> {

    private ListDataTaxonomiesPage(
        PageContext context,
        ListDataTaxonomiesResponse response) {
      super(context, response);
    }

    private static ListDataTaxonomiesPage createEmptyPage() {
      return new ListDataTaxonomiesPage(null, null);
    }

    @Override
    protected ListDataTaxonomiesPage createPage(
        PageContext context,
        ListDataTaxonomiesResponse response) {
      return new ListDataTaxonomiesPage(context, response);
    }

    @Override
    public ApiFuture createPageAsync(
        PageContext context,
        ApiFuture futureResponse) {
      return super.createPageAsync(context, futureResponse);
    }
  }

  public static class ListDataTaxonomiesFixedSizeCollection
      extends AbstractFixedSizeCollection<
          ListDataTaxonomiesRequest,
          ListDataTaxonomiesResponse,
          DataTaxonomy,
          ListDataTaxonomiesPage,
          ListDataTaxonomiesFixedSizeCollection> {

    private ListDataTaxonomiesFixedSizeCollection(
        List pages, int collectionSize) {
      super(pages, collectionSize);
    }

    private static ListDataTaxonomiesFixedSizeCollection createEmptyCollection() {
      return new ListDataTaxonomiesFixedSizeCollection(null, 0);
    }

    @Override
    protected ListDataTaxonomiesFixedSizeCollection createCollection(
        List pages, int collectionSize) {
      return new ListDataTaxonomiesFixedSizeCollection(pages, collectionSize);
    }
  }

  public static class ListDataAttributeBindingsPagedResponse
      extends AbstractPagedListResponse<
          ListDataAttributeBindingsRequest,
          ListDataAttributeBindingsResponse,
          DataAttributeBinding,
          ListDataAttributeBindingsPage,
          ListDataAttributeBindingsFixedSizeCollection> {

    public static ApiFuture createAsync(
        PageContext<
                ListDataAttributeBindingsRequest,
                ListDataAttributeBindingsResponse,
                DataAttributeBinding>
            context,
        ApiFuture futureResponse) {
      ApiFuture futurePage =
          ListDataAttributeBindingsPage.createEmptyPage().createPageAsync(context, futureResponse);
      return ApiFutures.transform(
          futurePage,
          input -> new ListDataAttributeBindingsPagedResponse(input),
          MoreExecutors.directExecutor());
    }

    private ListDataAttributeBindingsPagedResponse(ListDataAttributeBindingsPage page) {
      super(page, ListDataAttributeBindingsFixedSizeCollection.createEmptyCollection());
    }
  }

  public static class ListDataAttributeBindingsPage
      extends AbstractPage<
          ListDataAttributeBindingsRequest,
          ListDataAttributeBindingsResponse,
          DataAttributeBinding,
          ListDataAttributeBindingsPage> {

    private ListDataAttributeBindingsPage(
        PageContext<
                ListDataAttributeBindingsRequest,
                ListDataAttributeBindingsResponse,
                DataAttributeBinding>
            context,
        ListDataAttributeBindingsResponse response) {
      super(context, response);
    }

    private static ListDataAttributeBindingsPage createEmptyPage() {
      return new ListDataAttributeBindingsPage(null, null);
    }

    @Override
    protected ListDataAttributeBindingsPage createPage(
        PageContext<
                ListDataAttributeBindingsRequest,
                ListDataAttributeBindingsResponse,
                DataAttributeBinding>
            context,
        ListDataAttributeBindingsResponse response) {
      return new ListDataAttributeBindingsPage(context, response);
    }

    @Override
    public ApiFuture createPageAsync(
        PageContext<
                ListDataAttributeBindingsRequest,
                ListDataAttributeBindingsResponse,
                DataAttributeBinding>
            context,
        ApiFuture futureResponse) {
      return super.createPageAsync(context, futureResponse);
    }
  }

  public static class ListDataAttributeBindingsFixedSizeCollection
      extends AbstractFixedSizeCollection<
          ListDataAttributeBindingsRequest,
          ListDataAttributeBindingsResponse,
          DataAttributeBinding,
          ListDataAttributeBindingsPage,
          ListDataAttributeBindingsFixedSizeCollection> {

    private ListDataAttributeBindingsFixedSizeCollection(
        List pages, int collectionSize) {
      super(pages, collectionSize);
    }

    private static ListDataAttributeBindingsFixedSizeCollection createEmptyCollection() {
      return new ListDataAttributeBindingsFixedSizeCollection(null, 0);
    }

    @Override
    protected ListDataAttributeBindingsFixedSizeCollection createCollection(
        List pages, int collectionSize) {
      return new ListDataAttributeBindingsFixedSizeCollection(pages, collectionSize);
    }
  }

  public static class ListDataAttributesPagedResponse
      extends AbstractPagedListResponse<
          ListDataAttributesRequest,
          ListDataAttributesResponse,
          DataAttribute,
          ListDataAttributesPage,
          ListDataAttributesFixedSizeCollection> {

    public static ApiFuture createAsync(
        PageContext context,
        ApiFuture futureResponse) {
      ApiFuture futurePage =
          ListDataAttributesPage.createEmptyPage().createPageAsync(context, futureResponse);
      return ApiFutures.transform(
          futurePage,
          input -> new ListDataAttributesPagedResponse(input),
          MoreExecutors.directExecutor());
    }

    private ListDataAttributesPagedResponse(ListDataAttributesPage page) {
      super(page, ListDataAttributesFixedSizeCollection.createEmptyCollection());
    }
  }

  public static class ListDataAttributesPage
      extends AbstractPage<
          ListDataAttributesRequest,
          ListDataAttributesResponse,
          DataAttribute,
          ListDataAttributesPage> {

    private ListDataAttributesPage(
        PageContext context,
        ListDataAttributesResponse response) {
      super(context, response);
    }

    private static ListDataAttributesPage createEmptyPage() {
      return new ListDataAttributesPage(null, null);
    }

    @Override
    protected ListDataAttributesPage createPage(
        PageContext context,
        ListDataAttributesResponse response) {
      return new ListDataAttributesPage(context, response);
    }

    @Override
    public ApiFuture createPageAsync(
        PageContext context,
        ApiFuture futureResponse) {
      return super.createPageAsync(context, futureResponse);
    }
  }

  public static class ListDataAttributesFixedSizeCollection
      extends AbstractFixedSizeCollection<
          ListDataAttributesRequest,
          ListDataAttributesResponse,
          DataAttribute,
          ListDataAttributesPage,
          ListDataAttributesFixedSizeCollection> {

    private ListDataAttributesFixedSizeCollection(
        List pages, int collectionSize) {
      super(pages, collectionSize);
    }

    private static ListDataAttributesFixedSizeCollection createEmptyCollection() {
      return new ListDataAttributesFixedSizeCollection(null, 0);
    }

    @Override
    protected ListDataAttributesFixedSizeCollection createCollection(
        List pages, int collectionSize) {
      return new ListDataAttributesFixedSizeCollection(pages, collectionSize);
    }
  }

  public static class ListLocationsPagedResponse
      extends AbstractPagedListResponse<
          ListLocationsRequest,
          ListLocationsResponse,
          Location,
          ListLocationsPage,
          ListLocationsFixedSizeCollection> {

    public static ApiFuture createAsync(
        PageContext context,
        ApiFuture futureResponse) {
      ApiFuture futurePage =
          ListLocationsPage.createEmptyPage().createPageAsync(context, futureResponse);
      return ApiFutures.transform(
          futurePage,
          input -> new ListLocationsPagedResponse(input),
          MoreExecutors.directExecutor());
    }

    private ListLocationsPagedResponse(ListLocationsPage page) {
      super(page, ListLocationsFixedSizeCollection.createEmptyCollection());
    }
  }

  public static class ListLocationsPage
      extends AbstractPage<
          ListLocationsRequest, ListLocationsResponse, Location, ListLocationsPage> {

    private ListLocationsPage(
        PageContext context,
        ListLocationsResponse response) {
      super(context, response);
    }

    private static ListLocationsPage createEmptyPage() {
      return new ListLocationsPage(null, null);
    }

    @Override
    protected ListLocationsPage createPage(
        PageContext context,
        ListLocationsResponse response) {
      return new ListLocationsPage(context, response);
    }

    @Override
    public ApiFuture createPageAsync(
        PageContext context,
        ApiFuture futureResponse) {
      return super.createPageAsync(context, futureResponse);
    }
  }

  public static class ListLocationsFixedSizeCollection
      extends AbstractFixedSizeCollection<
          ListLocationsRequest,
          ListLocationsResponse,
          Location,
          ListLocationsPage,
          ListLocationsFixedSizeCollection> {

    private ListLocationsFixedSizeCollection(List pages, int collectionSize) {
      super(pages, collectionSize);
    }

    private static ListLocationsFixedSizeCollection createEmptyCollection() {
      return new ListLocationsFixedSizeCollection(null, 0);
    }

    @Override
    protected ListLocationsFixedSizeCollection createCollection(
        List pages, int collectionSize) {
      return new ListLocationsFixedSizeCollection(pages, collectionSize);
    }
  }
}
Method	Description	Method Variants
CreateDataTaxonomy	Create a DataTaxonomy resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * createDataTaxonomyAsync(CreateDataTaxonomyRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * createDataTaxonomyAsync(LocationName parent, DataTaxonomy dataTaxonomy, String dataTaxonomyId) * createDataTaxonomyAsync(String parent, DataTaxonomy dataTaxonomy, String dataTaxonomyId) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * createDataTaxonomyOperationCallable() * createDataTaxonomyCallable() * *
UpdateDataTaxonomy	Updates a DataTaxonomy resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * updateDataTaxonomyAsync(UpdateDataTaxonomyRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * updateDataTaxonomyAsync(DataTaxonomy dataTaxonomy, FieldMask updateMask) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * updateDataTaxonomyOperationCallable() * updateDataTaxonomyCallable() * *
DeleteDataTaxonomy	Deletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before the DataTaxonomy can be deleted.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * deleteDataTaxonomyAsync(DeleteDataTaxonomyRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * deleteDataTaxonomyAsync(DataTaxonomyName name) * deleteDataTaxonomyAsync(String name) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * deleteDataTaxonomyOperationCallable() * deleteDataTaxonomyCallable() * *
ListDataTaxonomies	Lists DataTaxonomy resources in a project and location.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * listDataTaxonomies(ListDataTaxonomiesRequest request) * * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. * * listDataTaxonomies(LocationName parent) * listDataTaxonomies(String parent) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * listDataTaxonomiesPagedCallable() * listDataTaxonomiesCallable() * *
GetDataTaxonomy	Retrieves a DataTaxonomy resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * getDataTaxonomy(GetDataTaxonomyRequest request) * * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. * * getDataTaxonomy(DataTaxonomyName name) * getDataTaxonomy(String name) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * getDataTaxonomyCallable() * *
CreateDataAttributeBinding	Create a DataAttributeBinding resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * createDataAttributeBindingAsync(CreateDataAttributeBindingRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * createDataAttributeBindingAsync(LocationName parent, DataAttributeBinding dataAttributeBinding, String dataAttributeBindingId) * createDataAttributeBindingAsync(String parent, DataAttributeBinding dataAttributeBinding, String dataAttributeBindingId) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * createDataAttributeBindingOperationCallable() * createDataAttributeBindingCallable() * *
UpdateDataAttributeBinding	Updates a DataAttributeBinding resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * updateDataAttributeBindingAsync(UpdateDataAttributeBindingRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * updateDataAttributeBindingAsync(DataAttributeBinding dataAttributeBinding, FieldMask updateMask) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * updateDataAttributeBindingOperationCallable() * updateDataAttributeBindingCallable() * *
DeleteDataAttributeBinding	Deletes a DataAttributeBinding resource. All attributes within the DataAttributeBinding must be deleted before the DataAttributeBinding can be deleted.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * deleteDataAttributeBindingAsync(DeleteDataAttributeBindingRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * deleteDataAttributeBindingAsync(DataAttributeBindingName name) * deleteDataAttributeBindingAsync(String name) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * deleteDataAttributeBindingOperationCallable() * deleteDataAttributeBindingCallable() * *
ListDataAttributeBindings	Lists DataAttributeBinding resources in a project and location.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * listDataAttributeBindings(ListDataAttributeBindingsRequest request) * * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. * * listDataAttributeBindings(LocationName parent) * listDataAttributeBindings(String parent) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * listDataAttributeBindingsPagedCallable() * listDataAttributeBindingsCallable() * *
GetDataAttributeBinding	Retrieves a DataAttributeBinding resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * getDataAttributeBinding(GetDataAttributeBindingRequest request) * * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. * * getDataAttributeBinding(DataAttributeBindingName name) * getDataAttributeBinding(String name) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * getDataAttributeBindingCallable() * *
CreateDataAttribute	Create a DataAttribute resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * createDataAttributeAsync(CreateDataAttributeRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * createDataAttributeAsync(DataTaxonomyName parent, DataAttribute dataAttribute, String dataAttributeId) * createDataAttributeAsync(String parent, DataAttribute dataAttribute, String dataAttributeId) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * createDataAttributeOperationCallable() * createDataAttributeCallable() * *
UpdateDataAttribute	Updates a DataAttribute resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * updateDataAttributeAsync(UpdateDataAttributeRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * updateDataAttributeAsync(DataAttribute dataAttribute, FieldMask updateMask) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * updateDataAttributeOperationCallable() * updateDataAttributeCallable() * *
DeleteDataAttribute	Deletes a Data Attribute resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * deleteDataAttributeAsync(DeleteDataAttributeRequest request) * * Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service. * * deleteDataAttributeAsync(DataAttributeName name) * deleteDataAttributeAsync(String name) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * deleteDataAttributeOperationCallable() * deleteDataAttributeCallable() * *
ListDataAttributes	Lists Data Attribute resources in a DataTaxonomy.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * listDataAttributes(ListDataAttributesRequest request) * * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. * * listDataAttributes(DataTaxonomyName parent) * listDataAttributes(String parent) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * listDataAttributesPagedCallable() * listDataAttributesCallable() * *
GetDataAttribute	Retrieves a Data Attribute resource.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * getDataAttribute(GetDataAttributeRequest request) * * "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method. * * getDataAttribute(DataAttributeName name) * getDataAttribute(String name) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * getDataAttributeCallable() * *
ListLocations	Lists information about the supported locations for this service.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * listLocations(ListLocationsRequest request) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * listLocationsPagedCallable() * listLocationsCallable() * *
GetLocation	Gets information about a location.	* Request object method variants only take one parameter, a request object, which must be constructed before the call. * * getLocation(GetLocationRequest request) * * Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. * * getLocationCallable() * *