Esta página foi traduzida pela API Cloud Translation.

Guia de início rápido do Java para clientes que usam uma conta de serviço

Siga as etapas neste guia de início rápido e, em cerca de 10 minutos, você terá um app de linha de comando Java simples que faz solicitações à API do cliente de registro sem toque usando uma conta de serviço.

Pré-requisitos

Para executar este guia de início rápido, você precisa de:

Uma conta de serviço vinculada à sua conta de cliente do registro sem toque. Consulte Primeiros passos.
Java 1.7 ou superior
Gradle 2.3 ou versões mais recentes (link em inglês).
Acesso à Internet e a um navegador da Web.

Etapa 1: ativar a API do registro sem toque

Use este assistente para criar ou selecionar um projeto no Google Developers Console e ativar a API automaticamente. Clique em Continuar e, em seguida, em Acessar credenciais.
Defina Quais dados você acessará? como Dados de aplicativos.
Clique em Próxima. Você precisará criar uma conta de serviço.
Dê um nome descritivo para Nome da conta de serviço.
Anote o ID da conta de serviço, que parece um endereço de e-mail, porque você o usará mais tarde.
Defina Papel como Contas de serviço > Usuário da conta de serviço.
Clique em Concluído para terminar a criação da conta de serviço.
Clique no endereço de e-mail da conta de serviço que você criou.
Clique em **Chaves**.
Clique em **Add key** e em **Create new key**.
Em **Tipo de chave**, selecione **JSON**.
Clique em Criar e a chave privada será salva no computador.
Clique em **Fechar**.
Mova o arquivo para o diretório de trabalho e renomeie-o como service_account_key.json.

Etapa 2: preparar o projeto

Siga as etapas abaixo para configurar seu projeto do Gradle:

Execute o seguinte comando para criar um novo projeto no diretório de trabalho:
```
gradle init --type basic
mkdir -p src/main/java src/main/resources
```
Copie o service_account_key.json que você salvou quando criou sua conta de serviço no diretório src/main/resources/ criado acima.
Abra o arquivo build.gradle padrão e substitua o conteúdo dele pelo seguinte código:

apply plugin: 'java'
apply plugin: 'application'

mainClassName = 'CustomerQuickstart'
sourceCompatibility = 1.7
targetCompatibility = 1.7
version = '1.0'

repositories {
    mavenCentral()
}

dependencies {
    compile 'com.google.api-client:google-api-client:2.2.0'
    compile 'com.google.apis:google-api-services-androiddeviceprovisioning:v1-rev20230509-2.0.0'
    compile 'com.google.auth:google-auth-library-oauth2-http:1.16.1'
    compile 'com.google.auth:google-auth-library-credentials:1.16.1'
    compile 'com.google.http-client:google-http-client:1.43.1'
    compile 'com.google.oauth-client:google-oauth-client-jetty:1.34.1'
}

Etapa 3: configurar a amostra

Crie um arquivo chamado src/main/java/CustomerQuickstart.java, copie o código a seguir e salve o arquivo.

import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.androiddeviceprovisioning.v1.AndroidProvisioningPartner;
import com.google.api.services.androiddeviceprovisioning.v1.model.Company;
import com.google.api.services.androiddeviceprovisioning.v1.model.CustomerListCustomersResponse;
import com.google.api.services.androiddeviceprovisioning.v1.model.CustomerListDpcsResponse;
import com.google.api.services.androiddeviceprovisioning.v1.model.Dpc;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.auth.oauth2.ServiceAccountCredentials;
import java.io.IOException;
import java.io.InputStream;
import java.util.Arrays;
import java.util.List;

/** This class forms the quickstart introduction to the zero-touch enrollment customer API. */
public class CustomerQuickstart {

  // A single auth scope is used for the zero-touch enrollment customer API.
  private static final List<String> SCOPES =
      Arrays.asList("https://www.googleapis.com/auth/androidworkzerotouchemm");
  private static final String APP_NAME = "Zero-touch Enrollment Java Quickstart";

  // Global shared instances
  private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
  private static HttpTransport HTTP_TRANSPORT;

  static {
    try {
      HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
    } catch (Throwable t) {
      t.printStackTrace();
      System.exit(1);
    }
  }

  /**
   * Creates a GoogleCredentials object with the correct OAuth2 authorization for the service
   * account that calls the reseller API. The service endpoint invokes this method when setting up a
   * new service instance.
   *
   * @return an authorized GoogleCredentials object.
   * @throws IOException
   */
  public static GoogleCredentials authorize() throws IOException {
    // Load service account key.
    InputStream in = CustomerQuickstart.class.getResourceAsStream("/service_account_key.json");

    // Create the credential scoped to the zero-touch enrollment customer APIs.
    GoogleCredentials credential = ServiceAccountCredentials.fromStream(in).createScoped(SCOPES);
    return credential;
  }

  /**
   * Build and return an authorized zero-touch enrollment API client service. Use the service
   * endpoint to call the API methods.
   *
   * @return an authorized client service endpoint
   * @throws IOException
   */
  public static AndroidProvisioningPartner getService() throws IOException {
    GoogleCredentials credential = authorize();
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(credential);
    return new AndroidProvisioningPartner.Builder(HTTP_TRANSPORT, JSON_FACTORY, requestInitializer)
        .setApplicationName(APP_NAME)
        .build();
  }

  /**
   * Runs the zero-touch enrollment quickstart app.
   *
   * @throws IOException
   */
  public static void main(String[] args) throws IOException {

    // Create a zero-touch enrollment API service endpoint.
    AndroidProvisioningPartner service = getService();

    // Get the customer's account. Because a customer might have more
    // than one, limit the results to the first account found.
    AndroidProvisioningPartner.Customers.List accountRequest = service.customers().list();
    accountRequest.setPageSize(1);
    CustomerListCustomersResponse accountResponse = accountRequest.execute();
    if (accountResponse.getCustomers().isEmpty()) {
      // No accounts found for the user. Confirm the Google Account
      // that authorizes the request can access the zero-touch portal.
      System.out.println("No zero-touch enrollment account found.");
      System.exit(-1);
    }
    Company customer = accountResponse.getCustomers().get(0);
    String customerAccount = customer.getName();

    // Send an API request to list all the DPCs available using the customer account.
    AndroidProvisioningPartner.Customers.Dpcs.List request =
        service.customers().dpcs().list(customerAccount);
    CustomerListDpcsResponse response = request.execute();

    // Print out the details of each DPC.
    java.util.List<Dpc> dpcs = response.getDpcs();
    for (Dpc dpcApp : dpcs) {
      System.out.format("Name:%s  APK:%s\n", dpcApp.getDpcName(), dpcApp.getPackageName());
    }
  }
}

Etapa 4: executar a amostra

Use a ajuda do sistema operacional para executar o script no arquivo. Em computadores UNIX e Mac, execute o comando abaixo no terminal:

gradle -q run

Observações

Evite compartilhar o arquivo service_account_key.json com outras pessoas. Tenha cuidado para não incluí-lo nos repositórios de código-fonte. Leia mais sobre como gerenciar secrets de conta de serviço.