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:
- Recuperare le impostazioni di notifica.
- Aggiorna le impostazioni di notifica.
- Elimina le impostazioni di notifica.
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:
- Segui la guida di Cloud Pub/Sub per configurare la tua applicazione.
- Crea un argomento nel progetto Cloud Pub/Sub e prendi nota del nome dell'argomento creato.
- Concedi almeno le autorizzazioni
pubsub.topics.publish
a mybusiness-api-pubsub@system.gserviceaccount.com. - Segui la guida Panoramica degli iscritti per configurare le notifiche push o pull.
- 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. - (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:
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:
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:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic