Os provedores que oferecem gerenciamento de fichas de empresa diretamente na plataforma deles podem verificar os dados empresas em seu site. Isso elimina a necessidade de redirecionar o comerciante para a Interface do Perfil da Empresa.
Obter o estado atual
Os usuários podem ligar para locations.getVoiceOfMerchantState
em um local para recuperar o status atual. Se o
hasVoiceOfMerchant
o booleano é true
, então a localização já está em situação regular e nenhuma ação adicional é necessária. Caso contrário, se a ação gain_voice_of_merchant
na resposta contiver verify
, será necessário concluir a verificação. Para mais informações, siga as instruções abaixo.
Buscar opções de verificação
Os provedores podem usar o
locations.fetchVerificationOptions
para solicitar que os comerciantes escolham uma forma de contato preferida em uma lista de
métodos de verificação.
Para buscar as opções de verificação, use o seguinte:
POST https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions { "languageCode": "en" }
Iniciar o processo de verificação
Depois de escolher um método de verificação, inicie o processo com
locations.verify
Como resultado dessa chamada, a localização passa para um estado verificado, ou um status de erro é retornado.
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} :verify // Use only one of the below verification methods // For postcard verification: { "method": "ADDRESS", "languageCode": "en", "addressInput": { "mailerContactName": "Ann Droyd" } } // For phone verification: { "method": "PHONE_CALL", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For SMS verification: { "method": "SMS", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For email verification: { "method": "EMAIL", "languageCode": "en", "emailInput": { "emailAddress": "ex@google.com" } }
Recuperar as verificações atuais
A
locations.verifications.list
chamada recupera o histórico de solicitações de verificação, juntamente com seu status para o local especificado na chamada.
Para recuperar todas as solicitações de verificação, use o seguinte:
GET https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications
Concluir uma verificação pendente
Um código PIN e o
locations.verifications.complete
método geralmente é necessário para concluir a verificação de uma empresa.
Para concluir uma verificação pendente, faça o seguinte:
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications/{verificationId}:complete { "pin": "123456" }
Práticas recomendadas para a verificação com o GBP usando a API
Criação de local
Com a API GBP Business Information, é possível incorporar sua plataforma para fornecer a funcionalidade de criação de local. Quando você pedir a um comerciante para adicionar uma nova unidade, siga estas etapas:
Colete as informações da localização, como nome, endereço e categoria da empresa do comerciante.
- Chame o endpoint
googleLocations.search
. - Forneça os dados do local, como nome, categoria, endereço, número de telefone e site da empresa, na solicitação de API.
Você também pode pesquisar um possível local correspondente seguindo estas etapas:
- Consulte possíveis correspondências de local.
- Peça ao comerciante para escolher o local correto.
- Se
requestAdminRightsUrl
estiver presente na resposta, ajude o comerciante a solicitar acesso e propriedade do local no Perfil da Empresa no Google. - Se
requestAdminRightsUrl
não existir, crie um novo local com o ID de lugar na resposta. - Verifique o novo local.
Observação:se você não receber possíveis correspondências na consulta inicial, use um ID de lugar em branco para criar uma nova unidade. Em seguida, verifique essa nova unidade.
Verificação de local
Para iniciar o processo de verificação usando a API GBP, siga estas etapas:
- Chame o método
accounts.locations.list
para listar todos os locais de uma Conta do Google. - Selecione um local para verificar.
- Chame o método
GetVoiceOfMerchant
da API para confirmar se a unidade requer verificação. - Se a resposta retornar "verificar", chame
fetchVerificationOptions
para acessar uma lista de métodos disponíveis para verificar esse local. - Confira se os dados de
verificationOption
incluem o endereço, o número de telefone e o e-mail corretos. - Depois que o comerciante selecionar a melhor opção de verificação disponível, chame o método
locations.verify
para iniciar a verificação apropriada. Para confirmar que o início está em andamento, chame o métodolocations.verifications.list.
- Chame o método
locations.verification.complete
com o alfinete do comerciante. - Chame o método de API
GetVoiceOfMerchant
. SeHasVoiceOfMerchant = true
, a unidade foi verificada.
Observação:se a verificação de AUTO
estiver disponível para a unidade, o comerciante não vai precisar seguir nenhuma etapa de verificação.
Para mais informações sobre a verificação no GBP, consulte nosso artigo de suporte da Central de Ajuda.