จัดการการอัปเดตจาก Google

Google จะใช้ข้อมูลจากแหล่งที่มาต่างๆ เช่น รายงานของผู้ใช้และเนื้อหาที่ได้รับอนุญาต เพื่อให้ Business Profile มีความถูกต้องอยู่เสมอ หากมีการรายงานว่าข้อมูลที่เจ้าของธุรกิจให้ไว้ไม่ถูกต้อง Google จะแจ้งให้เจ้าของข้อมูลทราบ จากนั้นเจ้าของข้อมูลจะยอมรับหรือปฏิเสธการอัปเดตได้

ในฐานะเจ้าของรายชื่อ My Business Information API จะช่วยให้คุณตรวจสอบการอัปเดตเหล่านี้เพื่อให้แน่ใจว่าข้อมูลทางธุรกิจของคุณถูกต้อง คู่มือนี้อธิบายวิธียอมรับหรือปฏิเสธการอัปเดต

หากต้องการจัดการการอัปเดตจาก Google ให้ทำตามขั้นตอนต่อไปนี้

  1. ค้นหาสถานที่ที่มีการอัปเดตที่รอดำเนินการ
  2. ตรวจสอบช่องที่อัปเดต
  3. ยอมรับหรือปฏิเสธการอัปเดต
  4. ตรวจสอบผลลัพธ์

ค้นหาสถานที่ที่มีการอัปเดตที่รอดำเนินการ

ก่อนยอมรับหรือปฏิเสธการอัปเดต คุณต้องดูว่าตำแหน่งใดที่มีการอัปเดตจาก Google วิธีที่ดีที่สุดในการรับการอัปเดตจาก Google สำหรับสถานที่ต่างๆ คือจัดการการแจ้งเตือนแบบเรียลไทม์ด้วย Cloud Pub/Sub หากคุณได้รับการแจ้งเตือน GOOGLE_UPDATE ในหัวข้อ Pub/Sub แสดงว่าการเปลี่ยนแปลงพร้อมให้ตรวจสอบแล้ว ช่อง locationName ในการแจ้งเตือนจะระบุชื่อทรัพยากรของตำแหน่งดังกล่าวพร้อมการอัปเดตจาก Google

หรือจะดูการเรียก locations.get และตรวจดู Metadata เพื่อหาแฟล็ก hasGoogleUpdated ก็ได้ หากเป็น "isGoogleUpdated": true รหัสสถานที่ที่เชื่อมโยงกับสถานที่นี้มีการอัปเดต

ส่งคำขอ

ต่อไปนี้เป็นตัวอย่างคำขอ locations.get

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

ส่งคำขอ

ต่อไปนี้เป็นตัวอย่างการตอบกลับ locations.get

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

ตรวจสอบช่องอัปเดต

หากต้องการตรวจสอบช่องที่มีการอัปเดตจาก Google โปรดโทรไปที่ locations.getGoogleUpdated diffMask ที่มีรายละเอียดช่องที่ Google อัปเดตอยู่ในเนื้อหาการตอบกลับ

ส่งคำขอ

ต่อไปนี้เป็นตัวอย่างคำขอ locations.getGoogleUpdated

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

คำตอบ

ต่อไปนี้เป็นตัวอย่างการตอบสนอง locations.getGoogleUpdated โดยจะแสดงการอัปเดตที่พร้อมใช้งานในช่อง phoneNumbers.primaryPhone ค่าในการตอบกลับนี้คือค่าการอัปเดตที่แนะนํา ดังนี้

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

ยอมรับหรือปฏิเสธการอัปเดต

หากต้องการยอมรับหรือปฏิเสธการอัปเดต ให้ทำตามขั้นตอน locations.patch ด้วยการตั้งค่าช่อง updateMask เหมือนกับใน diffMask ที่คุณได้รับก่อนหน้านี้ นอกจากนี้ ให้จับคู่ค่าที่ต้องการสำหรับแต่ละฟิลด์ด้วย

ยอมรับคำขอ

ต่อไปนี้เป็นตัวอย่างคำขอ locations.patch

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

คำตอบ

ต่อไปนี้เป็นตัวอย่างการตอบกลับ locations.patch

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

ปฏิเสธคำขอ

ต่อไปนี้เป็นตัวอย่างคำขอ 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"
     },
    ...
}

คำตอบ

ต่อไปนี้เป็นตัวอย่างการตอบกลับ locations.patch

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

ดูผลลัพธ์

หากแพตช์ตำแหน่งสำเร็จ ช่อง diffMask ในการตอบกลับ locations.getGoogleUpdated จะแสดงค่าเป็น "diffMask": "" นอกจากนี้ แฟล็ก "hasGoogleUpdated" ภายใน Metadata แสดงค่าเป็น false หรือไม่มีค่าเลย

หากค่าในช่องไม่ชัดเจน โปรดติดต่อทีมสนับสนุนพร้อมส่งคำขอและคำตอบสำหรับ getGoogleUpdated คำขอต้องมีการตอบกลับก่อนการเรียกใช้ locations.patch, การเรียกใช้แพตช์ และการเรียก getGoogleUpdated