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 supportate recensioni nuove o aggiornate, domande e risposte, caricamenti di contenuti multimediali, aggiornamenti di Google per la revisione, modifiche dello stato della stazione di ricarica 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 la tua applicazione e ottieni le credenziali OAuth 2.0. Per informazioni dettagliate su come iniziare a utilizzare l'API, consulta la sezione Configurazione di base.

Configurazione di Cloud Pub/Sub

Per configurare le notifiche API con Cloud Pub/Sub, svolgi i seguenti passaggi:

  1. Segui la guida di Cloud Pub/Sub per configurare l'applicazione.
  2. Crea un argomento nel tuo progetto Cloud Pub/Sub e prendi nota del nome dell'argomento creato.
  3. Concedi almeno pubsub.topics.publish autorizzazioni a mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Segui la guida Panoramica degli abbonati per configurare le notifiche push o pull.
  5. Per ricevere notifiche, chiama l'endpoint accounts.updateNotificationSetting nell'API My Business Notifications. Nella chiamata, utilizza il nome dell'argomento che hai 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 notifiche.

Recuperare le impostazioni di notifica

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

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

Aggiornare le impostazioni di notifica

L'endpoint accounts.updateNotificationSetting aggiornate le impostazioni di notifica 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
}

Eliminare le impostazioni di notifica

La chiamata a accounts.updateNotificationSetting con un pubsubTopic vuoto elimina le impostazioni di notifica Cloud Pub/Sub da un account. La tabella seguente mostra come chiamarlo:

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