Antes de começar
Antes de começar, você precisa do seguinte:
Acesso de superadministrador ao domínio do 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 poder usar a API, você deve aceitar os termos e condições 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ê precisa aceitar os Termos de Serviço do revendedor, se aplicável. Se você aceitou termos de serviço específicos off-line, essa etapa não se aplica a você.
Você pode aceitar Termos de Serviço adicionais na Página de Termos do Partner Sales Console.
Etapa 2: configurar seu projeto do Google Cloud
Para usar qualquer API do Google, você precisa ter um projeto do Google Cloud.
Criar um projeto do Google Cloud
Para criar um projeto, acesse a guia Projetos do console do Google Cloud e clique em Criar projeto:
Para instruções mais detalhadas sobre como criar um projeto e para uma lista das melhores consulte o guia Como criar e gerenciar projetos.
A maioria dos revendedores cria projetos do Google Cloud organização do Google Cloud em vez do domínio do revendedor. Acesso dados do domínio do revendedor são concedidos ao configurar 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 isso não afeta sua capacidade de chamar a API Cloud Channel.
Ativar a API
Acesse 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.
- Clique em Criar conta de serviço.
- Insira o Nome da conta de serviço (e a conta de serviço opcional descrição) e clique em Criar.
- Clique em Continuar para pular a etapa Conceder acesso à conta de serviço ao projeto. é a melhor opção.
- Pule a seção Conceda aos usuários acesso a essa conta de serviço e clique em Concluído para finalizar a criação da conta.
Depois de criar a conta, crie uma chave de conta de serviço:
- No console do Google Cloud, clique no endereço de e-mail do serviço. que você criou.
- Clique em Chaves.
- Clique em Adicionar chave e em Criar nova chave.
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.
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
Para esta seção, você precisa do ID do cliente da sua conta de serviço. Na guia
Ações no menu, selecione Gerencie os detalhes e copie seu ID exclusivo.Acesse a página de 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 o API Cloud Channel no contexto da sua conta do Channel Services.
Depois, 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, pode descobrir a API lendo a documentação da API Cloud Channel.