Gerenciar as notificações em tempo real

Na API My Business Notifications, as notificações são publicadas no serviço Cloud Pub/Sub. Depois de configurar o Cloud Pub/Sub e criar um tópico, é possível realizar as seguintes operações nas notificações:

São compatíveis: avaliações novas ou atualizadas, perguntas e respostas, uploads de mídia, atualizações do Google para revisão, alterações do status do local e muito mais. O objeto NotificationType lista e descreve os tipos de notificação disponíveis.

Antes de começar

Para usar a API My Business Notifications, registre seu aplicativo e receba as credenciais do OAuth 2.0. Veja detalhes para começar a usar a API em Configuração básica.

Configuração do Cloud Pub/Sub

Para configurar notificações de API com o Cloud Pub/Sub, siga estas etapas:

  1. Veja o guia do Cloud Pub/Sub para configurar seu aplicativo.
  2. Crie um tópico no projeto do Cloud Pub/Sub e anote o nome atribuído a ele.
  3. Conceda pelo menos as permissões pubsub.topics.publish a mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Siga o guia Visão geral do assinante para configurar as notificações push ou pull.
  5. Para receber notificações, chame o endpoint accounts.updateNotificationSetting na API My Business Notifications. Na chamada, use o nome do tópico que você criou no Cloud Pub/Sub para vincular sua conta do Perfil da Empresa a ele.
  6. (Opcional) Repita a etapa 5 para cada conta do Perfil da empresa sobre a qual você quer receber notificações.

Recuperar as configurações de notificação

O endpoint accounts.getNotificationSetting retorna as configurações de notificação atuais do Cloud Pub/Sub de uma conta. Veja como chamá-lo na tabela a seguir:

HTTP
GET
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting

Atualizar as configurações de notificação

O endpoint accounts.updateNotificationSetting atualiza as configurações de notificação do Cloud Pub/Sub associadas a uma conta. Veja como chamá-lo na tabela a seguir:

HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate}

{
  pubsubTopic: your/pubsub/topicName
}

Excluir as configurações de notificação

Chamar o accounts.updateNotificationSetting com um pubsubTopic vazio exclui as configurações de notificação do Cloud Pub/Sub de uma conta. Veja como chamá-lo na tabela a seguir:

HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic