Administrar notificaciones en tiempo real

En la API de My Business Notifications, las notificaciones se publican en el servicio Cloud Pub/Sub. Después de configurar Cloud Pub/Sub y crear un tema, puedes realizar las siguientes operaciones en las notificaciones:

Se admiten opiniones, preguntas y respuestas nuevas o actualizadas, cargas de contenido multimedia, Actualizaciones de Google para revisión, cambios de estado de ubicación y mucho más. El objeto NotificationType enumera y describe los tipos de notificaciones disponibles.

Antes de comenzar

Para usar la API de My Business Notifications, registra tu aplicación y obtén las credenciales de OAuth 2.0. Si deseas obtener detalles para comenzar a usar la API, consulta Configuración básica.

Configuración de Cloud Pub/Sub

Para configurar notificaciones a la API con Cloud Pub/Sub, sigue estos pasos:

  1. Sigue la guía de Cloud Pub/Sub para configurar tu aplicación.
  2. Crea un tema en tu proyecto de Cloud Pub/Sub y anota el nombre del tema creado.
  3. Otorga permisos pubsub.topics.publish como mínimo a mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Sigue la guía de descripción general de los suscriptores para configurar las notificaciones push o de extracción.
  5. Para recibir notificaciones, llama al extremo accounts.updateNotificationSetting en la API de My Business Notifications. En la llamada, usa el nombre del tema que creaste en Cloud Pub/Sub para vincular tu cuenta del Perfil de Negocio al tema.
  6. (Opcional) Repite el paso 5 para cada cuenta del Perfil de Negocio de la que desees recibir notificaciones.

Cómo recuperar la configuración de notificaciones

El extremo accounts.getNotificationSetting muestra la configuración actual de notificaciones de Cloud Pub/Sub para una cuenta. En la siguiente tabla, se muestra cómo llamarlo:

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

Cómo actualizar la configuración de notificaciones

El extremo accounts.updateNotificationSetting actualiza la configuración de notificaciones de Cloud Pub/Sub asociada con una cuenta. En la siguiente tabla, se muestra cómo llamarlo:

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

{
  pubsubTopic: your/pubsub/topicName
}

Borrar configuración de notificaciones

Una llamada a accounts.updateNotificationSetting con un pubsubTopic vacío borra la configuración de notificaciones de Cloud Pub/Sub de una cuenta. En la siguiente tabla, se muestra cómo llamarlo:

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