Configuração técnica

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.

Observação :você precisa do ID da conta, que está nas configurações do Partner Sales Console. para integração com a API.

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.

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 conta de serviço opcional descrição) e clique em Criar.
3. Clique em Continuar para pular a etapa Conceder acesso à conta de serviço ao projeto. é a melhor opção.
4. 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:

1. No console do Google Cloud, clique no endereço de e-mail do 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

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.

Observação: se você usar APIs adicionais na integração final, poderá ter mais de um escopo para o cliente da sua conta de serviço.

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.

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.

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.

Observação: se você também tiver um Partner Sales Console de teste, siga as etapas de um a quatro com seu domínio de revendedor de teste. Crie um projeto separado, já que As APIs do Google têm cotas por projeto. Como compartilhar um projeto entre ambientes pode fazer com que as contas de teste afetem as cotas da conta de produção.