Guia de integração

Receber chave privada

Como usar a interface de integração

Para fazer a integração com a API, crie um projeto do Google Cloud. Depois disso, crie uma conta de serviço e receba uma chave privada. Para começar, clique no botão a seguir:

Criar uma conta de serviço

Gerar chave manualmente

Se a interface acima falhar, tente o seguinte:

  1. Acesse o console do Google Cloud.
  2. Escolha o projeto que será usado para acessar a API.
  3. No menu "IAM e administrador" à esquerda, encontre as contas de serviço e crie uma nova conta de serviço, que será a proprietária do projeto.
  4. Depois que a conta de serviço for criada, você vai receber uma chave privada.

Colocar conta de serviço na lista de permissões

Depois de criar uma conta de serviço:

  1. Entre em contato com a equipe do GTAF em mdp-support@google.com usando uma Conta do Google que seja proprietária do projeto. Vamos criar uma lista de permissões para a Conta do Google acessar os endpoints da API Mobile Data Plan Sharing.
  2. Associe a conta de serviço à operadora no Portal de ISPs do Google. Para fazer isso, acesse Acesso à API.

Ativar biblioteca

Depois que a lista de permissões for criada:

  1. Visite o Google Cloud Console.
  2. Verifique se você selecionou o projeto correto no menu suspenso na barra de menus superior.
  3. Ative a API Mobile Data Plan Sharing na biblioteca de APIs.
  4. Ative a API Mobile Data Plan Sharing de pré-produção na biblioteca de APIs.

Testar o acesso à API

Para testar seu acesso aos métodos do lado do Google:

  1. Instale oauth2l.

  2. Obtenha um token de acesso para sua conta de serviço da seguinte maneira. your-service-account-key-file.json é um arquivo de chave da sua conta de serviço.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    O token de acesso expira em cerca de uma hora. Antes de executar o comando acima de novo para um novo token de acesso, execute oauth2l reset para limpar o cache local.

  3. Faça chamadas de teste da seguinte maneira. YOUR-ASN precisa ser um dos ASNs que você nos envia quando configuramos o GTAF durante o processo de integração. ACCESS-TOKEN-OBTAINED é a saída do comando oauth2l fetch acima. PLAN_STATUS é o corpo da solicitação PlanStatus que você quer enviar para o GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Chamadas de API programáticas

Siga as instruções para fazer chamadas autorizadas aos métodos do lado do Google, com o seguinte escopo do OAuth:

https://www.googleapis.com/auth/dataplansharing

Compartilhar a propriedade do projeto

Embora a configuração inicial envolva uma única Conta do Google, é recomendável que um grupo de usuários autorizados seja proprietário do projeto. No Console do Google Cloud, no menu "IAM e administrador", é possível adicionar novos membros (incluindo contas do Google Grupos) como proprietários do projeto.