Mengelola Update Google

Untuk menjaga profil bisnis seakurat mungkin, Google menggunakan informasi dari sumber seperti laporan pengguna dan konten berlisensi. Jika informasi yang diberikan oleh pemilik bisnis dilaporkan sebagai tidak benar, Google akan memberi tahu pemilik listingan. Pemilik listingan kemudian dapat menerima atau menolak update.

Sebagai pemilik listingan, My Business Business Information API memungkinkan Anda meninjau update ini untuk memastikan bahwa informasi bisnis Anda tetap akurat. Panduan ini menjelaskan cara menyetujui atau menolak update.

Untuk mengelola Update Google Anda, selesaikan langkah-langkah berikut:

  1. Menemukan lokasi dengan update yang menunggu keputusan
  2. Meninjau kolom yang diupdate
  3. Menyetujui atau menolak update
  4. Meninjau hasil

Menemukan lokasi dengan update yang menunggu keputusan

Sebelum dapat menerima atau menolak update, Anda harus mencari tahu lokasi mana yang memiliki Update Google. Cara terbaik untuk mendapatkan Update Google untuk lokasi adalah Mengelola notifikasi real-time dengan Cloud Pub/Sub. Jika Anda menerima notifikasi GOOGLE_UPDATE di Pub/Sub topic, sebuah perubahan siap untuk Anda tinjau. Kolom locationName pada notifikasi memberikan nama referensi lokasi yang memiliki Update Google.

Atau, Anda dapat melihat panggilan locations.get dan memeriksa Metadata untuk mengetahui apakah ada flag hasGoogleUpdated. Jika "isGoogleUpdated": true, ID tempat yang terkait dengan lokasi ini memiliki pembaruan.

Permintaan

Berikut adalah locations.get contoh permintaan:

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}

Permintaan

Berikut adalah locations.get contoh respons:

{
  "name": "locations/{locationId}",
  "title": "Test Business",
  "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
   },
  ...
  "metadata": {
    "hasGoogleUpdated": true,
    ...
  }
  ...
}

Meninjau kolom update

Untuk meninjau kolom tertentu yang memiliki Update Google, panggil locations.getGoogleUpdated. diffMask yang menjelaskan kolom Google yang diupdate ada di isi respons.

Permintaan

Berikut adalah locations.getGoogleUpdated contoh permintaan:

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated

Respons

Berikut adalah contoh respons locations.getGoogleUpdated. Ini menunjukkan update yang tersedia di kolom phoneNumbers.primaryPhone. Nilai dalam respons ini adalah nilai update yang disarankan:

{
  "location": {
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

Menyetujui atau menolak update

Untuk menyetujui atau menolak update, lakukan locations.patch dengan kolom updateMask ditetapkan sama seperti di diffMask yang Anda dapatkan sebelumnya. Selain itu, cocokkan juga nilai pilihan untuk setiap kolom.

Menyetujui permintaan

Berikut adalah locations.patch contoh permintaan:

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
}

Respons

Berikut adalah locations.patch contoh respons:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
}

Menolak permintaan

Berikut adalah locations.patch contoh permintaan:

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

Respons

Berikut adalah contoh respons locations.patch:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

Meninjau hasil

Jika lokasi Anda berhasil diberi patch, kolom diffMask di respons locations.getGoogleUpdated menunjukkan nilai sebagai "diffMask": "". Selain itu, flag "hasGoogleUpdated" dalam Metadata menunjukkan nilai sebagai false, atau tidak ada nilai sama sekali.

Jika nilai kolom tidak jelas, hubungi tim dukungan kami dengan permintaan dan respons untuk getGoogleUpdated. Permintaan harus menyertakan respons sebelum panggilan locations.patch, panggilan patch, dan panggilan getGoogleUpdated.