Configuração técnica

Antes de começar

Antes de começar, você precisa do seguinte:

  • Acesso de superadministrador ao seu domínio de revendedor. Para mais informações, veja como acessar a API Cloud Channel.

  • Acesso ao console do Google Cloud e ao Partner Sales Console.

Etapa 1: preparar o Partner Sales Console

Antes de usar a API, você precisa aceitar os Termos e Condições da plataforma do Channel Services.

Faça login no Partner Sales Console pelo menos uma vez como administrador do domínio do revendedor. Na primeira vez que fizer login, você precisará aceitar os Termos de Serviço do revendedor, se aplicável. Se você aceitou os Termos de Serviço específicos off-line, esta etapa não se aplica a você.

Você pode aceitar outros termos na página Termos do Partner Sales Console.

Etapa 2: configurar o projeto do Google Cloud

Para usar qualquer API do Google, é preciso ter um projeto do Google Cloud.

Criar um projeto do Google Cloud

Para criar um projeto, navegue até a área Projetos do console do Google Cloud e clique em Criar projeto.

Para instruções mais detalhadas sobre como criar um projeto e uma lista de práticas recomendadas, consulte nosso guia Como criar e gerenciar projetos.

A maioria dos revendedores cria projetos do Google Cloud na organização principal do Google Cloud, e não no domínio do revendedor. O acesso a dados do domínio do revendedor é concedido configurando a delegação em todo o domínio para permitir que uma conta de serviço acesse dados do domínio do revendedor.

Dê um nome descritivo ao projeto. O ID do projeto é um identificador arbitrário que não afeta sua capacidade de chamar a API Cloud Channel.

Ativar a API

Navegue até a seção Biblioteca de APIs no console do Google Cloud e ative a API Cloud Channel.

Crie uma conta de serviço

Para criar sua conta de serviço, acesse a página Contas de serviço.

Acesse as Contas de serviço

  1. Clique em Criar conta de serviço.
  2. Insira o Nome da conta de serviço (e a Descrição da conta de serviço opcional) e clique em Criar.
  3. Clique em Continuar para pular a opção Conceder acesso à conta de serviço ao projeto.
  4. Pule a seção Conceda aos usuários acesso a essa conta de serviço e clique em Concluído para concluir a criação da conta.

Depois de criar sua conta, crie uma chave de conta de serviço:

  1. No console do Google Cloud, clique no endereço de e-mail da conta de serviço que você criou.
  2. Clique em Chaves.
  3. Clique em Adicionar chave e em Criar nova chave.

  4. Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.

    Armazene o arquivo de chave com segurança, porque ele pode ser usado para autenticar como sua conta de serviço. Mova e renomeie esse arquivo como quiser.

  5. Clique em Fechar.

É possível excluir e criar arquivos de chave privada na página "Contas de serviço".

Etapa 3: autorizar a conta de serviço para o domínio do revendedor

Você precisa do ID do cliente da sua conta de serviço para esta seção. No menu Ações, selecione Gerenciar detalhes e copie o ID exclusivo.

Acesse a página Delegação em todo o domínio usando a conta de superadministrador do domínio de revendedor.

  • Clique em Adicionar novo e digite o ID da conta de serviço no campo ID do cliente.
  • Insira https://www.googleapis.com/auth/apps.order no campo Escopos do OAuth.
  • Clique em Autorizar para permitir que sua conta de serviço use a API Cloud Channel no contexto da sua conta do Channel Services.

Em seguida, clique em Autorizar para que sua conta de serviço possa usar a API Cloud Channel no contexto da sua conta do Channel Services.

Próximas etapas

Agora que você tem uma integração técnica inicial, leia a documentação da API Cloud Channel para descobrir a API.