Esta página foi traduzida pela API Cloud Translation.

Guia de início rápido do Java para revendedores

Siga as etapas deste 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 revendedor de registro sem toque.

Pré-requisitos

Para executar este guia de início rápido, você precisará do seguinte:

Uma Conta do Google faz parte da sua conta de revendedor sem registro. Se você ainda não tiver feito a integração, siga as etapas em Primeiros passos no guia do portal do revendedor.
Java 1.7 ou mais recente
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 Acessar credenciais.
Defina Quais dados você vai acessar? como Dados do aplicativo.
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 é um endereço de e-mail. Ele será usado 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 em **Criar nova chave**.
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: vincular a conta de serviço

Abra o portal do registro sem toque. Talvez seja necessário fazer login.
Clique em Contas de serviço.
Clique em Vincular conta de serviço.
Defina o Endereço de e-mail como o endereço da conta de serviço que você criou.
Clique em Vincular conta de serviço para usar a conta de serviço com sua conta de registro sem toque.

Etapa 3: preparar o projeto

Siga as etapas abaixo para configurar o projeto do Gradle:

Execute este 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 arquivo service_account_key.json que você salvou na Etapa 1 no diretório src/main/resources/ que você criou acima.

Abra o arquivo build.gradle padrão e substitua o conteúdo pelo seguinte código:

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

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

repositories {
    mavenCentral()
}

dependencies {
    compile 'com.google.api-client:google-api-client:1.30.11'
    compile 'com.google.apis:google-api-services-androiddeviceprovisioning:+'
    compile 'com.google.oauth-client:google-oauth-client-jetty:+'
}

Etapa 4: configurar o exemplo

Crie um arquivo chamado src/main/java/ResellerQuickstart.java, copie o código a seguir e salve-o. Insira seu próprio ID do parceiro revendedor como o valor de PARTNER_ID (a primeira linha do app).

import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.jackson2.JacksonFactory;
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.ListCustomersResponse;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.Arrays;
import java.util.List;

/**
 * This class forms the quickstart introduction to the zero-touch enrollemnt
 * reseller API.
 */
public class ResellerQuickstart {

  // TODO: replace this with your partner reseller ID.
  private static long PARTNER_ID = 11036885;

  // Use a single scope for the all methods in the reseller API.
  private static final List<String> SCOPES =
      Arrays.asList("https://www.googleapis.com/auth/androidworkprovisioning");
  private static final String APP_NAME = "Zero-touch Reseller Java Quickstart";

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

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

  /**
   * Creates a Credential 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 Credential object.
   * @throws IOException
   */
  public static Credential authorize() throws IOException {
      // Load the service account key from the JSON file.
      InputStream in =
          ResellerQuickstart.class.getResourceAsStream("/service_account_key.json");

      // Create the credential scoped to the zero-touch enrollemnt
      // reseller APIs.
      GoogleCredential credential = GoogleCredential
         .fromStream(in)
         .createScoped(SCOPES);
      return credential;
  }

  /**
   * Builds and returns 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 {
    Credential credential = authorize();
    return new AndroidProvisioningPartner.Builder(
        HTTP_TRANSPORT, JSON_FACTORY, credential)
        .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();

    // Send an API request to list all our customers.
    AndroidProvisioningPartner.Partners.Customers.List request =
          service.partners().customers().list(PARTNER_ID);
    ListCustomersResponse response = request.execute();

    // Print out the details of each customer.
    if (response.getCustomers() != null) {
      java.util.List<Company> customers = response.getCustomers();
      for (Company customer : customers) {
          System.out.format("Name:%s  ID:%d\n",
                customer.getCompanyName(),
                customer.getCompanyId());
      }
    } else {
      System.out.println("No customers found");
    }
  }
}

ID do parceiro

As chamadas de API normalmente precisam do ID do parceiro revendedor como argumento. Para encontrar seu ID do parceiro no portal do registro sem toque, siga as etapas abaixo:

Abra o portal. Talvez seja necessário fazer login.
Clique em Contas de serviço.
Copie o número do ID do parceiro da linha Seu ID de revendedor.

Etapa 5: 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 seu terminal:

gradle -q run

Solução de problemas

Conte o que deu errado no guia de início rápido para que possamos corrigir o problema. Para saber como o registro sem toque usa contas de serviço para autorizar chamadas de API, leia Autorização.