Aby profil Twojej firmy był jak dokładny, Google korzysta z informacji ze źródeł takich jak opinie użytkowników i licencjonowane treści. Jeśli informacje przekazane przez właścicieli firm zostaną zgłoszone jako nieprawidłowe, Google powiadomi ich o tym. Właściciele wizytówek mogą je zaakceptować lub odrzucić.
Jeśli jesteś właścicielem wizytówki, możesz za pomocą interfejsu My Business Information API sprawdzać te zmiany, aby mieć pewność, że informacje o Twojej firmie są prawidłowe. Z tego przewodnika dowiesz się, jak akceptować i odrzucać aktualizacje.
Aby zarządzać aktualizacjami Google, wykonaj te czynności:
- Znajdowanie lokalizacji z oczekującymi aktualizacjami
- Sprawdzanie zaktualizowanych pól
- Akceptowanie i odrzucanie aktualizacji
- Sprawdzanie wyników
Znajdowanie lokalizacji z oczekującymi aktualizacjami
Aby móc akceptować i odrzucać aktualizacje, musisz dowiedzieć się, dla których lokalizacji są dostępne aktualizacje Google. Najlepszym sposobem na otrzymywanie aktualizacji Google dotyczących lokalizacji jest zarządzanie powiadomieniami w czasie rzeczywistym za pomocą Cloud Pub/Sub. Jeśli otrzymasz powiadomienie GOOGLE_UPDATE
w temacie Pub/Sub, oznacza to, że zmiana jest gotowa do sprawdzenia. Pole locationName
w powiadomieniu zawiera nazwę zasobu lokalizacji z aktualizacjami Google.
Możesz też wyświetlić wywołanie locations.get
i sprawdzić, czy w Metadata
nie ma flagi hasGoogleUpdated
. Jeśli "isGoogleUpdated": true
, identyfikator miejsca powiązany z tą lokalizacją został zaktualizowany.
Prośba
Oto przykład żądania locations.get
:
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}
Prośba
Oto przykład odpowiedzi locations.get
:
{ "name": "locations/{locationId}", "title": "Test Business", "phoneNumbers": { "primaryPhone": "02 9374 4000" }, ... "metadata": { "hasGoogleUpdated": true, ... } ... }
Sprawdź pola aktualizacji
Aby sprawdzić konkretne pola z aktualizacjami Google, wywołaj locations.getGoogleUpdated
.
diffMask
ze szczegółowymi informacjami o polach zaktualizowanych przez Google znajduje się w treści odpowiedzi.
Prośba
Oto przykład żądania locations.getGoogleUpdated
:
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated
Odpowiedź
Poniżej znajdziesz przykład odpowiedzi locations.getGoogleUpdated
. Wyświetli się dostępna aktualizacja w polu phoneNumbers.primaryPhone. Wartość w tej odpowiedzi to sugerowana wartość aktualizacji:
{ "location": { "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, ... }, "diffMask": "phoneNumbers.primaryPhone" }
Akceptowanie i odrzucanie aktualizacji
Aby zaakceptować lub odrzucić aktualizację, wykonaj locations.patch
z polami updateMask ustawionymi tak samo jak w uzyskanych wcześniej diffMask
. Dopasuj też preferowane wartości dla każdego pola.
Akceptowanie prośby
Oto przykład żądania locations.patch
:
PATCH https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone { "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, }
Odpowiedź
Oto przykład odpowiedzi locations.patch
:
{ "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, ... }
Odrzucanie prośby
Oto przykład żądania locations.patch
:
PATCH https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone { "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "222 222 2222" }, ... }
Odpowiedź
Oto przykład odpowiedzi locations.patch
:
{ "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "222 222 2222" }, ... }
Sprawdzanie wyników
Jeśli poprawka została zainstalowana pomyślnie, pole diffMask
w odpowiedzi locations.getGoogleUpdated
zawiera wartości "diffMask": ""
. Dodatkowo flaga "hasGoogleUpdated"
w Metadata
pokazuje wartość false
lub nie ma żadnej wartości.
Jeśli wartości pól są niejasne, skontaktuj się z naszym zespołem pomocy, przesyłając żądanie i odpowiedź dotyczącą getGoogleUpdated
. Żądanie musi zawierać odpowiedź przed wywołaniem locations.patch
, wywołaniem poprawki i wywołaniem getGoogleUpdated
.