Zarządzanie aktualizacjami Google

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:

  1. Znajdowanie lokalizacji z oczekującymi aktualizacjami
  2. Sprawdzanie zaktualizowanych pól
  3. Akceptowanie i odrzucanie aktualizacji
  4. 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:

HTTP
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:

HTTP
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:

HTTP
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:

HTTP
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.