Configuração básica

Para continuar, verifique se você seguiu as instruções em Pré-requisitos e se o projeto foi aprovado para acessar as APIs do Perfil da Empresa.

Ativar as APIs

Existem oito APIs associadas ao Perfil da empresa que precisam ser ativadas no Console de APIs do Google:

  • API Google My Business
  • API My Business Account Management
  • API My Business Lodging
  • API My Business Place Actions
  • API My Business Notifications
  • API My Business Verifications
  • API My Business Business Information
  • API My Business Q&A

Ativar uma API

Se você concluiu todos os pré-requisitos e recebeu acesso à API, mas não conseguiu usar o atalho fornecido, é possível ativar a API manualmente com as etapas a seguir.

Para ativar uma API no seu projeto, faça o seguinte:

  1. Abra a biblioteca de APIs no Console de APIs do Google. Se solicitado, selecione um projeto ou crie um novo. A biblioteca de APIs lista todas as APIs disponíveis agrupadas por família de produtos e popularidade.
  2. Se a API que você quer ativar não estiver visível na lista, use a pesquisa para encontrá-la.
  3. Selecione aquela que você quer habilitar e clique no botão Ativar.
  4. Se solicitado, ative o faturamento.
  5. Aceite os Termos de Serviço da API, se for o caso.

Se você é usuário do Google Workspace, confirme se o Perfil da Empresa no Google está ativado na conta da sua organização no Workspace. Você vai receber a mensagem "Erro 403: PERMISSÃO NEGADA" ao usar as APIs do GBP se o Perfil da Empresa estiver desativado nessa conta.

Solicitar um ID do cliente do OAuth 2.0

Como seu app acessa dados protegidos e não públicos, é necessário ter um ID do cliente do OAuth 2.0. Isso permite que seu app peça autorização para acessar os dados de local da sua organização em nome dos usuários do aplicativo.

Seu app precisa enviar um token do OAuth 2.0 com todas as solicitações de APIs do Perfil da Empresa que acessem dados privados do usuário.

Se você ainda não tiver feito isso, acesse a seção "Credenciais" do Console de APIs do Google e clique em Criar credenciais > ID do cliente OAuth para gerá-las no OAuth 2.0. Depois, você verá seu ID de cliente na página Credenciais. Clique nele para ver detalhes, como a chave secreta do cliente, URIs de redirecionamento, endereço de origem JavaScript e endereço de e-mail.

Conhecer os fundamentos do REST

Há duas maneiras invocar as APIs:

Se você decidir não usar bibliotecas de cliente, precisará entender os princípios básicos da REST

REST é um estilo de arquitetura de software que fornece uma abordagem simples e consistente para solicitar e modificar dados.

O termo REST significa "Representational State Transfer" (Transferência Representacional de Estado). No contexto das APIs do Google, ele se refere ao uso de verbos HTTP para recuperar e modificar representações de dados armazenados pelo Google.

Em um sistema RESTful, os recursos ficam em um armazenamento de dados. Um cliente envia uma solicitação para o servidor realizar uma ação específica, como criar, recuperar, atualizar ou excluir um recurso, e o servidor executa a ação e envia uma resposta. Essa resposta geralmente está na forma de uma representação do recurso especificado.

Nas APIs RESTful do Google, o cliente especifica uma ação com um verbo HTTP, como GET, POST, PUT ou DELETE. O cliente especifica um recurso por um identificador uniforme de recurso (URI, na sigla em inglês) globalmente exclusivo no seguinte formato:

https://apiName.googleapis.com/apiVersion/resourcePath?parameters

Como todos os recursos da API têm URIs exclusivos acessíveis por HTTP, a REST permite o armazenamento em cache dos dados e é otimizada para funcionar na infraestrutura distribuída da Web.

As definições de método, encontradas na documentação de padrões do HTTP 1.1, podem ser úteis. Elas incluem especificações para GET, POST, PUT e DELETE.

REST nas APIs do Perfil da empresa

As operações das APIs do Perfil da Empresa são mapeadas diretamente para os verbos HTTP REST.

O formato específico das APIs do Perfil da empresa é mostrado no seguinte URI:

https://apiName.googleapis.com/apiVersion/resourcePath?parameters

O conjunto completo de URIs usados em cada operação compatível nas APIs aparece na documentação de referência das APIs do Perfil da Empresa.

Os caminhos dos recursos variam de acordo com o endpoint.

Por exemplo, o caminho do recurso para uma conta aparece como neste exemplo:

accounts/accountId

O caminho para um local aparece no seguinte formato:

locations/locationId

Conhecer os fundamentos do JSON

As APIs do Perfil da empresa retornam dados no formato JSON.

O JavaScript Object Notation (JSON) é um formato de dados comum e independente de linguagem que oferece uma representação de texto simples de estruturas de dados arbitrárias. Para mais informações, acesse json.org (em inglês).

Fazer uma solicitação HTTP simples

Use o OAuth 2.0 Playground para testar as APIs do Perfil da Empresa. Como elas não são públicas, você precisa seguir algumas etapas adicionais para usá-las no Playground. É necessário ter um ID do cliente para um aplicativo da Web.

  1. Acesse o Console de APIs do Google e abra seu projeto. Se você não tiver um ID do cliente OAuth para aplicativos da Web, crie um agora:
    1. Na lista suspensa Criar credenciais, selecione ID do cliente OAuth.
    2. Em Tipo de aplicativo, clique em Aplicativo da Web.
    3. Adicione o seguinte como um URI de redirecionamento válido:

       https://developers.google.com/oauthplayground
       
    4. Clique em Criar.
  2. Copie o ID do cliente para a área de transferência.
  3. Acesse o OAuth 2.0 Playground.
  4. Clique no ícone de engrenagem para abrir as opções de configuração e faça o seguinte:
    1. Defina o OAuth Flow como Client-side.
    2. Selecione Use your own OAuth credentials.
    3. Cole seu ID do cliente OAuth.
  5. Feche as opções de configuração.
  6. Em "Step 1 - Select & authorize APIs" (Etapa 1: selecionar e autorizar APIs), cole o seguinte escopo para as APIs do Perfil da Empresa no campo Input your own scopes (Inserir seus próprios escopos).

    https://www.googleapis.com/auth/business.manage
    
  7. Clique em Authorize APIs.
  8. Clique em Accept quando solicitado.
  9. Em "Step 2 - Configure request to API", cole o seguinte URI no campo Request URI:

    https://mybusinessaccountmanagement.googleapis.com/v1/accounts
    
  10. Clique em Send the request. A resposta vai mostrar o status 200 OK.

Para mais informações sobre como fazer vários tipos de solicitação, consulte a Referência das APIs do Perfil da empresa.

Bibliotecas de cliente

As bibliotecas de cliente das APIs do Perfil da Empresa são compatíveis com a funcionalidade dessas APIs. Elas oferecem recursos comuns para todas as APIs do Google, como transporte HTTP, tratamento de erros, autenticação e análise em JSON.

Para fazer o download de bibliotecas de cliente, consulte Bibliotecas.