Configuração técnica

Antes de começar

Antes de começar, precisa do seguinte:

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

• Acesso à Google Cloud consola e à Partner Sales Console.

Passo 1: prepare a Partner Sales Console

Antes de poder usar a API, tem de aceitar os termos e as condições da plataforma de serviços de canais.

Inicie sessão na Partner Sales Console, pelo menos, uma vez como administrador do domínio do revendedor. Na primeira vez que iniciar sessão, tem de aceitar os termos de utilização do revendedor, se aplicável. Se aceitou termos de utilização específicos offline, este passo não se aplica a si.

Pode aceitar Termos de Utilização adicionais na página Termos da Partner Sales Console.

Nota: precisa do ID da conta, que se encontra na página de definições da Partner Sales Console, para a integração da API.

Passo 2: configure o seu Google Cloud projeto

Para usar qualquer API Google, tem de ter um Google Cloud projeto.

Crie um Google Cloud projeto

Para criar um projeto, navegue para a área Projetos da sua Google Cloud consola e clique em Criar projeto.

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

A maioria dos revendedores cria Google Cloud projetos na respetiva organizaçãoGoogle Cloud principal, em vez de no domínio do revendedor. O acesso aos dados do domínio do revendedor é concedido através da configuração da delegação ao nível do domínio para permitir que uma conta de serviço aceda aos dados do domínio do revendedor.

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

Ative a API

Navegue para a secção Biblioteca de APIs na Google Cloud consola e ative a API Cloud Channel.

Criar uma conta de serviço

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

Aceda a Contas de serviço

Nota: As chaves de contas de serviço representam um risco de segurança se não forem geridas corretamente. Deve escolher uma alternativa mais segura às chaves de contas de serviço sempre que possível. Se tiver de fazer a autenticação com uma chave de conta de serviço, é responsável pela segurança da chave privada e por outras operações descritas nas Práticas recomendadas de gestão de chaves de contas de serviço. Se não conseguir criar uma chave de conta de serviço, a criação de chaves de contas de serviço pode estar desativada para a sua organização. Para mais informações, consulte o artigo Gerir recursos da organização seguros por predefinição.

Se adquiriu a chave da conta de serviço a partir de uma fonte externa, tem de a validar antes de a usar. Para mais informações, consulte os Requisitos de segurança para credenciais de origem externa.

1. Clique em Criar conta de serviço.
2. Introduza o Nome da conta de serviço (e a Descrição da conta de serviço opcional) e, de seguida, clique em Criar.
3. Clique em Continuar para ignorar a opção Conceder acesso da conta de serviço ao projeto.
4. Ignore a secção Conceder aos utilizadores acesso a esta 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. Na Google Cloud consola, clique no endereço de email da conta de serviço que criou.
2. Clique em Chaves.
3. Clique em Adicionar chave e, de seguida, em Criar nova chave.

4. Clique em Criar. É transferido um ficheiro de chave JSON para o seu computador.

   Certifique-se de que armazena o ficheiro de chave em segurança, uma vez que pode ser usado para autenticar como a sua conta de serviço. Pode mover e mudar o nome deste ficheiro como quiser.

5. Clique em Fechar.

Pode eliminar e criar ficheiros de chaves privadas na página Contas de serviço.

Passo 3: autorize a conta de serviço para o domínio do revendedor

Precisa do ID de cliente da sua conta de serviço para esta secção. No menu Ações, selecione Gerir detalhes e copie o seu ID único.

Aceda à página Delegação ao nível do domínio com a conta de superadministrador do domínio do revendedor.

• Clique em Adicionar novo e introduza o ID da conta de serviço no campo ID de cliente.
• Introduza https://www.googleapis.com/auth/apps.order no campo Âmbitos de OAuth.
• Clique em Autorizar para permitir que a sua conta de serviço use a API Cloud Channel no contexto da sua conta dos serviços de canal.

Nota: se usar APIs adicionais na integração final, pode ter mais do que um âmbito para o cliente da sua conta de serviço.

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

Nota: pode ter de ativar mais APIs e adicionar mais âmbitos noutros codelabs. A integração final pode ter mais do que um âmbito para o cliente da sua conta de serviço.

Passos seguintes

Agora que tem uma integração técnica inicial, pode descobrir a API lendo a documentação da API Cloud Channel.

Nota: se também tiver uma Partner Sales Console de teste, siga os passos um a quatro com o domínio do revendedor de teste. Certifique-se de que cria um projeto separado, uma vez que as APIs Google têm quotas por projeto. A partilha de um projeto em vários ambientes pode fazer com que as suas contas de teste afetem as quotas da sua conta de produção.