Gestionar notificaciones en tiempo real

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

Se permite escribir o actualizar reseñas, hacer preguntas y responderlas, subir contenido multimedia, revisar actualizaciones de Google, cambiar estados de ubicaciones y mucho más. El objeto NotificationType muestra y describe los tipos de notificación disponibles.

Antes de empezar

Para usar la API Notifications de My Business, registra tu aplicación y obtén las credenciales de OAuth 2.0. Consulta cómo empezar a usar la API en la sección Configuración básica.

Configuración de Cloud Pub/Sub

Para configurar las notificaciones de la API Notifications de My Business con Cloud Pub/Sub, sigue estos pasos:

  1. Sigue la guía de Cloud Pub/Sub para configurar la aplicación.
  2. Crea un tema en tu proyecto de Cloud Pub/Sub y anota el nombre del tema creado.
  3. Concede al menos permisos pubsub.topics.publish a mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Sigue las instrucciones de la guía de información general sobre los suscriptores para configurar notificaciones push o pull.
  5. Para recibir notificaciones, haz una llamada al endpoint accounts.updateNotificationSetting en la API Notifications de My Business. En la llamada, usa el nombre del tema que hayas creado en Cloud Pub/Sub para vincular tu cuenta de Perfil de Empresa con el tema.
  6. (Opcional) Repite el paso 5 con cada cuenta de Perfil de Empresa sobre las que quieras recibir notificaciones.

Recuperar los ajustes de notificaciones

El endpoint accounts.getNotificationSetting devuelve los ajustes de notificaciones de Cloud Pub/Sub de una cuenta. En la tabla siguiente se muestra cómo hacer una llamada a este endpoint:

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

Actualizar los ajustes de notificaciones

El endpoint accounts.updateNotificationSetting actualiza los ajustes de notificaciones de Cloud Pub/Sub asociados a una cuenta. En la tabla siguiente se muestra cómo hacer una llamada a este endpoint:

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

{
  pubsubTopic: your/pubsub/topicName
}

Eliminar los ajustes de notificaciones

Al hacer una llamada a accounts.updateNotificationSetting con un elemento pubsubTopic vacío, se eliminan los ajustes de notificaciones de Cloud Pub/Sub de una cuenta. En la tabla siguiente se muestra cómo hacer la llamada:

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