Administra 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 nuevas o actualizadas, preguntas y respuestas, cargas de contenido multimedia, actualizaciones de Google para su revisión, cambios de estado de la 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 credenciales de OAuth 2.0. Para obtener detalles sobre cómo comenzar a usar la API, consulta Configuración básica.

Configuración de Cloud Pub/Sub

Para configurar notificaciones de 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 al menos permisos de pubsub.topics.publish a mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Sigue la guía Descripción general de los suscriptores para configurar notificaciones push o pull.
  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 de Perfil de Negocio al tema.
  6. (Opcional) Repite el paso 5 para cada cuenta de 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 de notificaciones actual 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
}

Borra la configuración de notificaciones

Si llamas a accounts.updateNotificationSetting con un pubsubTopic vacío, se borrará 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