Atenção: a v4.7 da API foi lançada. Consulte o registro de alterações. As postagens relacionadas à COVID-19 ainda estão permitidas temporariamente para redes.

Gerenciar vários locais ao mesmo tempo

À medida que sua organização cresce, gerenciar seus locais e suas permissões pode dar trabalho. Neste guia, detalhamos as práticas recomendadas para gerenciar vários locais ao mesmo tempo e descrevemos estes tipos de conta:

Tipos de conta

Cada tipo tem um papel no gerenciamento de locais. Uma conta pessoal pode administrar uma conta da organização e receber as permissões para os grupos de usuários e de locais da empresa. A conta pessoal gerencia os locais e as fichas por meio dos grupos de locais associados.

Conta pessoal

Uma conta pessoal é disponibilizada automaticamente quando você cria uma Conta do Google. As contas pessoais podem ser proprietárias e administradoras de fichas.

Conta da organização

A conta da organização é sobreposta e representa sua agência. Seu grupo de locais e de usuários são salvos nela, e todos os membros da organização têm acesso a eles. Os locais podem fazer parte de várias organizações.

Com a API, você pode usar o método accounts.admins.create e convidar contas pessoais para gerenciar ou serem proprietárias da conta da organização.

Conta do grupo de locais

Um grupo de locais é usado para gerenciar vários locais individuais ao mesmo tempo. Você pode usar um grupo para realizar tarefas em massa em vários locais. Quando você adiciona contas pessoais e grupos de usuários a um grupo de locais, eles herdam as mesmas permissões.

Você também pode criar grupos de locais para categorizar locais, por exemplo, por rede, região ou categoria. Os locais podem estar em vários grupos de uma só vez.

Com a API, você pode usar o método accounts.create para criar grupos de locais e transferir locais para um grupo. Com ela, também é possível convidar contas pessoais para gerenciar grupos de locais. Os grupos de usuários podem ser adicionados diretamente a grupos de locais na interface da Web.

Conta do grupo de usuários

Use um grupo de usuários para gerenciar as permissões em massa. Você pode adicionar contas pessoais a um grupo de usuários. Depois, conceda ao grupo de usuários acesso ao gerenciamento de vários grupos de locais. Assim, todas as contas pessoais do grupo poderão administrar os locais dentro dele.

Por exemplo, quando um novo membro entra em uma equipe operacional, você pode adicioná-lo diretamente a um grupo de usuários. Assim, ele tem acesso imediato a todos os locais a que seus colegas possuem. O acesso a cada local leva mais tempo e é mais difícil de gerenciar.

Use o método accounts.create da API para criar grupos de usuários. Também é possível usar a API e convidar contas pessoais para gerenciar os administradores das contas e dos locais.

Usar a API para chamar uma lista com todas as contas

Para listar todas as contas a que você tem acesso e os tipos associados a elas, chame o método accounts.list com suas credenciais do OAuth. A resposta contém uma lista com todas as contas, os IDs do campo name e os tipos de conta.

Solicitação

Veja a seguir um exemplo de solicitação accounts.list:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts
Authorization: Bearer <access_token>

Resposta

Veja a seguir um exemplo de resposta accounts.list:

{
    "accounts": [
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe",
            "type": "PERSONAL",
            "state": {
                "status": "UNVERIFIED"
            },
            "profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
        },
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe’s Location Group",
            "type": "LOCATION_GROUP",
            "role": "OWNER",
            "state": {
                "status": "UNVERIFIED"
            },
            "accountNumber": "{accountNumber}",
            "permissionLevel": "OWNER_LEVEL"
        }
    ]
}

Todos os tipos de conta detalhados neste guia podem ser incluídos na resposta à solicitação accounts.list. Revise a lista de contas e identifique aquela específica que tem acesso aos locais que você quer gerenciar. Depois, chame accounts.locations.list com o campo name da conta específica para recuperar uma lista de locais a que ela tem acesso.

Por exemplo, se você quer recuperar todos os locais que pertencem ao "Grupo de locais de João da Silva", faça a seguinte solicitação:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations
Authorization: Bearer <access_token>

A resposta retornará uma lista de locais aos quais o usuário tem acesso, da seguinte maneira:

{
    "locations": [
        {
            "name": "accounts/{accountId}/locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "accounts/{accountId}/locations/{locationId}",
            "locationName": "2nd Test Business",
            ...
         }
     ]
}

Diagrama de gerenciamento de locais

O diagrama a seguir mostra o seguinte:

  • As organizações podem ter vários grupos de usuários.
  • Os grupos de usuários conseguem gerenciar vários grupos de locais.
  • Os grupos de locais podem conter vários locais.
  • Os locais podem abranger vários grupos de locais em várias organizações.
Hierarquia do gerenciamento de locais
Figura 1. Hierarquia do gerenciamento de locais