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 de inscrição do cliente sem contato 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 de registro sem toque. Consulte Começar.
Java 1.7 ou mais recente.
Gradle 2.3 ou mais recente.
Acesso à Internet e a um navegador da Web.

Etapa 1: ativar a API de 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 Acessar credenciais
Defina Quais dados você vai acessar? como Dados do aplicativo.
Clique em Próxima. Você vai receber uma solicitação para 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 (parece um endereço de e-mail), porque você vai precisar dele 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 **Adicionar chave** e depois em **Criar nova chave**.
Em **Tipo de chave**, selecione **JSON**.
Clique em Criar, e a chave privada será salva no seu 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ê fez o download ao criar 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 por este 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 e 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 UNIX e Mac computadores, execute o comando abaixo no seu terminal:

gradle -q run

Observações

Evite compartilhar o arquivo service_account_key.json com ninguém. Não inclua o arquivo em repositórios de código-fonte. Você pode ler mais conselhos sobre como lidar com secrets de contas de serviço.