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, consulte 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, é necessário aceitar os Termos e Condições da plataforma Channel Services.

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

Você pode aceitar outros Termos de Serviço na página de Termos do Partner Sales Console.

Observação: para a integração da API, você precisa do ID da conta, que está na página de configurações 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, navegue até a área Projects do console do Google Cloud e clique em Create Project.

Para instruções mais detalhadas sobre como criar um projeto e uma lista de práticas recomendadas, consulte nosso guia 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

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.

Acesse as Contas de serviço

Observação: as chaves de conta de serviço poderão causar problemas de segurança se não forem gerenciadas corretamente. Sempre que possível, escolha uma alternativa mais segura do que as chaves de conta de serviço. Caso seja necessário autenticar com uma chave de conta de serviço, você será responsável pela segurança da chave privada e por outras operações descritas em Práticas recomendadas para gerenciar chaves de contas de serviço. Se não for possível criar uma chave de conta de serviço, a criação pode ser desativada para sua organização. Para mais informações, consulte Gerenciar recursos da organização com segurança por padrã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 de conta de serviço ao projeto.
4. Ignore a seção Conceda aos usuários acesso a essa conta de serviço e clique em Concluído para terminar a criação da conta.

Depois de criar a 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.

Você pode excluir e criar arquivos de chaves privadas 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 de delegação em todo o domínio usando a conta de superadministrador do domínio do revendedor.

• Clique em Adicionar novo e insira o ID da sua 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 a conta de serviço use a API Cloud Channel no contexto da sua conta do serviço de canais.

Observação: se você usar outras APIs na integração final, talvez tenha mais de um escopo para o cliente da conta de serviço.

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

Observação: talvez seja necessário ativar mais APIs e adicionar mais escopos em outros codelabs. A integração final pode ter mais de um escopo para o cliente da sua conta de serviço.

Próximas etapas

Agora que você tem uma integração técnica inicial, é possível descobrir a API lendo a documentação da API Cloud Channel.

Observação: se você também tiver um Partner Sales Console de teste, siga as etapas de 1 a 4 com o domínio de revendedor de teste. Crie um projeto separado, porque as APIs do Google têm cotas por projeto. O compartilhamento de um projeto entre ambientes pode fazer com que as contas de teste afetem as cotas da sua conta de produção.