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

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

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

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

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

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

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

เมธอดนี้จะแสดงมาสก์ที่สำคัญ 2 รายการในเนื้อหาการตอบกลับ ดังนี้

  • diffMask: ระบุฟิลด์ที่ข้อมูลการแสดง (สิ่งที่ลูกค้าเห็นใน Google Maps และ Search) แตกต่างจากค่าที่ต้องการในพื้นที่ โดยปกติแล้วการเปลี่ยนแปลงนี้เกิดจากการอัปเดตของ Google หรือเนื้อหาที่ผู้ใช้สร้างขึ้น คุณต้องยอมรับหรือปฏิเสธช่องเหล่านี้เพื่อแก้ไขความคลาดเคลื่อน
  • pendingMask: แสดงช่องที่คุณเคยส่งการอัปเดต แต่การอัปเดตยังคงประมวลผลและยังไม่ได้ส่งไปยัง Google Maps และ Search คุณไม่จำเป็นต้องดำเนินการใดๆ กับช่องเหล่านี้

ส่งคำขอ

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

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

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

  • ยอมรับการอัปเดต: แก้ไขตำแหน่งโดยใช้ค่าใหม่ที่ส่งคืนในการตอบกลับ getGoogleUpdated ซึ่งจะอัปเดตระเบียนในเครื่องให้ตรงกับข้อมูลการแสดงโฆษณา
  • ปฏิเสธการอัปเดต: แก้ไขตำแหน่งโดยใช้ค่าที่ต้องการเดิม ซึ่งจะยืนยันข้อมูลที่คุณต้องการอีกครั้งผ่านไปป์ไลน์การอัปเดตและเขียนทับข้อมูลการแสดง

ในทั้ง 2 กรณี ให้ตั้งค่า updateMask ให้ครอบคลุมช่องที่ต้องการแก้ไข

ยอมรับคำขอ

ต่อไปนี้เป็นตัวอย่างคำขอ 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 การเรียกใช้ Patch และการเรียกใช้ getGoogleUpdated