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:
- Recupera la configuración de notificaciones.
- Actualiza la configuración de notificaciones.
- Borra la configuración de 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:
- Sigue la guía de Cloud Pub/Sub para configurar tu aplicación.
- Crea un tema en tu proyecto de Cloud Pub/Sub y anota el nombre del tema creado.
- Otorga permisos
pubsub.topics.publish
como mínimo a mybusiness-api-pubsub@system.gserviceaccount.com. - Sigue la guía de descripción general de los suscriptores para configurar las notificaciones push o de extracción.
- 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. - (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:
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:
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:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic