Interfejs
Google Business Performance API udostępnia
NOWĄ metodę interfejsu API, która umożliwia pobieranie wielu parametrów „DailyMetrics” w jednym żądaniu API.
Zapoznaj się z
harmonogramem wycofywania i instrukcjami, jak przejść z metody raportu API w wersji 4 na interfejs Google Business Profile Performance API.
NotificationSetting
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Temat Google Pub/Sub, w którym mogą być publikowane powiadomienia, gdy lokalizacja zostanie zaktualizowana lub opublikowana nowa opinia. Na każdym koncie będzie tylko 1 zasób z ustawieniami powiadomień.
| Zapis JSON |
{
"name": string,
"pubsubTopic": string,
"notificationTypes": [
enum (NotificationType)
]
} |
| Pola |
name |
string
Wymagane. Nazwa zasobu, którego dotyczy to ustawienie. To ma postać accounts/{account_id}/notificationSetting.
|
pubsubTopic |
string
Opcjonalnie: Temat Google Pub/Sub, który będzie otrzymywać powiadomienia o aktualizacji lokalizacji zarządzanych przez to konto. Jeśli nie jest skonfigurowana, żadne powiadomienia nie są publikowane. Konto mybusiness-api-pubsub@system.gserviceaccount.com musi mieć co najmniej uprawnienia do publikowania w temacie Pub/Sub.
|
notificationTypes[] |
enum (NotificationType)
Typy powiadomień, które będą wysyłane do tematu Pub/Sub. Aby całkowicie przestać otrzymywać powiadomienia, użyj pola NotificationSettings.Update NotificationSetting z pustego pola notificationTypes lub wpisz pusty temat w polu pubsubTopic.
|
NotificationType
Typ powiadomienia wysłanego do tematu Pub/Sub.
| Wartości w polu enum |
NOTIFICATION_TYPE_UNSPECIFIED |
Brak typu powiadomienia. Nie pasuje do żadnych powiadomień. |
GOOGLE_UPDATE |
Lokalizacja ma do sprawdzenia aktualizacje Google. Pole location_name w powiadomieniu zawiera nazwę zasobu lokalizacji z aktualizacjami Google. |
NEW_REVIEW |
Do lokalizacji dodano nową opinię. Pole review_name w powiadomieniu będzie zawierać nazwę zasobu dodanej opinii, a lokalizacja_name będzie zawierać nazwę zasobu lokalizacji. |
UPDATED_REVIEW |
Zaktualizowaliśmy opinię na temat lokalizacji. Pole review_name w powiadomieniu będzie zawierać nazwę zasobu dodanej opinii, a lokalizacja_name będzie zawierać nazwę zasobu lokalizacji. |
NEW_CUSTOMER_MEDIA |
Użytkownik Map Google dodał do lokalizacji nowy element multimedialny. Powiadomienie będzie zawierać nazwę zasobu nowego elementu multimedialnego. |
NEW_QUESTION |
Do lokalizacji zostanie dodane nowe pytanie. W powiadomieniu znajdziesz nazwę zasobu pytania. |
UPDATED_QUESTION |
Zaktualizowano pytanie o lokalizację. W powiadomieniu znajdziesz nazwę zasobu pytania. |
NEW_ANSWER |
Nowa odpowiedź zostanie dodana do lokalizacji. Powiadomienie będzie zawierać nazwę zasobu pytania i odpowiedzi. |
UPDATED_ANSWER |
Zaktualizowano odpowiedź dotyczącą lokalizacji. Powiadomienie będzie zawierać nazwę zasobu pytania i odpowiedzi. |
DUPLICATE_LOCATION |
Wskazuje, czy wystąpiła zmiana w polu zduplikowanej lokalizacji w metadanych lokalizacji. |
LOSS_OF_VOICE_OF_MERCHANT |
Wycofane: przenieś obecne przypadki użycia tej wartości do bardziej rozwiniętej wersji „VOICE_OF_MERCHANT_UPDATED”. |
VOICE_OF_MERCHANT_UPDATED |
Wskazuje, czy lokalizacja ma zaktualizowany stan Voice of Merchant (VOM). Wskaźnik VOM określa, czy lokalizacja ma dobrą opinię, a sprzedawca ma kontrolę nad firmą w Google. Wszelkie zmiany wprowadzone w tej lokalizacji zostaną zastosowane w Mapach po przejściu etapu weryfikacji. Aby dowiedzieć się więcej, wywołaj wywołanie RPC GetVoiceOfMerchantState. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eGoogle Pub/Sub notifications can be configured for location updates and new reviews.\u003c/p\u003e\n"],["\u003cp\u003eA single notification setting exists per account, directing notifications to a specified Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eNotification types include Google updates, new/updated reviews, new customer media, new/updated Q&A, duplicate location and Voice of Merchant updates.\u003c/p\u003e\n"],["\u003cp\u003eAccount must grant \u003ccode\u003emybusiness-api-pubsub@system.gserviceaccount.com\u003c/code\u003e publish permissions on the designated Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eTo disable notifications, clear the \u003ccode\u003enotificationTypes\u003c/code\u003e list or set \u003ccode\u003epubsubTopic\u003c/code\u003e to an empty string in the notification settings.\u003c/p\u003e\n"]]],[],null,["# NotificationSetting\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [NotificationType](#NotificationType)\n\nA Google Pub/Sub topic where notifications can be published when a location is updated or has a new review. There will be only one notification setting resource per-account.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"pubsubTopic\": string, \"notificationTypes\": [ enum (/my-business/reference/notifications/rest/v1/NotificationSetting#NotificationType) ] } ``` |\n\n| Fields ||\n|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The resource name this setting is for. This is of the form `accounts/{account_id}/notificationSetting`. |\n| `pubsubTopic` | `string` Optional. The Google Pub/Sub topic that will receive notifications when locations managed by this account are updated. If unset, no notifications will be posted. The account [mybusiness-api-pubsub@system.gserviceaccount.com](mailto:mybusiness-api-pubsub@system.gserviceaccount.com) must have at least Publish permissions on the Pub/Sub topic. |\n| `notificationTypes[]` | `enum (`[NotificationType](/my-business/reference/notifications/rest/v1/NotificationSetting#NotificationType)`)` The types of notifications that will be sent to the Pub/Sub topic. To stop receiving notifications entirely, use NotificationSettings.UpdateNotificationSetting with an empty notificationTypes or set the pubsubTopic to an empty string. |\n\nNotificationType\n----------------\n\nType of notification sent to the Pub/Sub topic.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `NOTIFICATION_TYPE_UNSPECIFIED` | No notification type. Will not match any notifications. |\n| `GOOGLE_UPDATE` | The location has Google updates for review. The location_name field on the notification will provide the resource name of the location with Google updates. |\n| `NEW_REVIEW` | A new review has been added to the location. The review_name field on the notification will provide the resource name of the review that was added, and location_name will have the location's resource name. |\n| `UPDATED_REVIEW` | A review on the location has been updated. The review_name field on the notification will provide the resource name of the review that was added, and location_name will have the location's resource name. |\n| `NEW_CUSTOMER_MEDIA` | A new media item has been added to the location by a Google Maps user. The notification will provide the resource name of the new media item. |\n| `NEW_QUESTION` | A new question is added to the location. The notification will provide the resource name of question. |\n| `UPDATED_QUESTION` | A question of the location is updated. The notification will provide the resource name of question. |\n| `NEW_ANSWER` | A new answer is added to the location. The notification will provide the resource name of question and answer. |\n| `UPDATED_ANSWER` | An answer of the location is updated. The notification will provide the resource name of question and answer. |\n| `DUPLICATE_LOCATION` | Indicates whether there is a change in location metadata's duplicate location field. |\n| `LOSS_OF_VOICE_OF_MERCHANT` | Deprecated: Migrate the existing usages of this value to the more expanded \"VOICE_OF_MERCHANT_UPDATED\". | This item is deprecated! |\n| `VOICE_OF_MERCHANT_UPDATED` | Indicates whether the location has an update in Voice of Merchant (VOM) status. VOM dictates whether the location is in good standing and the merchant has control over the business on Google. Any edits made to the location will propagate to Maps after passing the review phase. Call GetVoiceOfMerchantState rpc for more details. |"]]
