Gestire le notifiche in tempo reale

Nell'API My Business Notifications, le notifiche vengono pubblicate nel servizio Cloud Pub/Sub. Dopo aver configurato Cloud Pub/Sub e creato un argomento, puoi eseguire le seguenti operazioni sulle notifiche:

Sono supportati recensioni, domande e risposte, caricamenti di contenuti multimediali, aggiornamenti Google da esaminare, modifiche dello stato delle sedi e altro ancora. L'oggetto NotificationType elenca e descrive i tipi di notifiche disponibili.

Prima di iniziare

Per utilizzare l'API My Business Notifications, registra l'applicazione e ottieni le credenziali OAuth 2.0. Per maggiori dettagli su come iniziare a utilizzare l'API, consulta Configurazione di base.

Configurazione di Cloud Pub/Sub

Per configurare le notifiche API con Cloud Pub/Sub, procedi nel seguente modo:

  1. Segui la guida di Cloud Pub/Sub per configurare la tua applicazione.
  2. Crea un argomento nel progetto Cloud Pub/Sub e prendi nota del nome dell'argomento creato.
  3. Concedi almeno le autorizzazioni pubsub.topics.publish a mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Segui la guida Panoramica degli iscritti per configurare le notifiche push o pull.
  5. Per ricevere le notifiche, chiama l'endpoint accounts.updateNotificationSetting nell'API My Business Notifications. Nella chiamata, utilizza il nome dell'argomento creato in Cloud Pub/Sub per collegare il tuo account Profilo dell'attività all'argomento.
  6. (Facoltativo) Ripeti il passaggio 5 per ogni account Profilo dell'attività per cui vuoi ricevere le notifiche.

Recuperare le impostazioni di notifica

L'endpoint accounts.getNotificationSetting restituisce le impostazioni di notifica Cloud Pub/Sub attuali per un account. La tabella seguente mostra come chiamarlo:

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

Aggiorna impostazioni di notifica

L'endpoint accounts.updateNotificationSetting aggiorna le impostazioni di notifica di Cloud Pub/Sub associate a un account. La tabella seguente mostra come chiamarlo:

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

{
  pubsubTopic: your/pubsub/topicName
}

Elimina impostazioni di notifica

Se chiami accounts.updateNotificationSetting con un valore pubsubTopic vuoto, vengono eliminate le impostazioni di notifica di Cloud Pub/Sub da un account. La tabella seguente mostra come chiamarlo:

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