ตรวจสอบสถานะการแก้ไขสถานที่และแอตทริบิวต์

เมื่อคุณอัปเดตข้อมูลทางธุรกิจผ่าน My Business Business Information API หรือ UI ของ Business Profile การแก้ไขจะผ่านไปป์ไลน์การกลั่นกรองและการยืนยันก่อนที่จะปรากฏใน Google Search และ Maps นอกจากนี้ Google อาจอัปเดตรายละเอียดธุรกิจตามรายงานของผู้ใช้หรือแหล่งข้อมูลที่ได้รับอนุญาต

ปลายทาง v1alpha Edit Status ช่วยให้คุณดึงข้อมูลมุมมองแบบรวมของสถานที่ตั้งหรือแอตทริบิวต์ของสถานที่ตั้งได้ในคำขอเดียว

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

ก่อนเริ่มต้น

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

ดึงข้อมูลตำแหน่งแบบขยาย

หากต้องการตรวจสอบข้อมูลตำแหน่งที่ผู้ขายระบุ ข้อมูลตำแหน่งสำหรับผู้บริโภค และสถานะการแก้ไขต่อช่องสำหรับสถานที่ตั้ง ให้เรียกใช้ locations.getExtended

locations.getExtended ไม่จำเป็นต้องใช้พารามิเตอร์ readMask และแสดงผลทรัพยากร ExtendedLocation ทั้งหมด ซึ่งต่างจาก locations.get

ส่งคำขอ

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

คำตอบ

การตอบกลับประกอบด้วยช่องระดับบนสุด 3 ช่อง ได้แก่

  • locationProvidedByMerchant: ข้อมูล Location ตามที่ผู้ขายจัดการ
  • locationSeenByConsumers: ข้อมูล Location ที่ผู้บริโภคเห็นใน Google Search และ Maps
  • extendedFieldData: แผนที่ของชื่อช่อง Location ระดับบนสุดใน snake_case (เช่น title, phone_numbers, website_uri, storefront_address หรือ regular_hours) ไปยังออบเจ็กต์ ExtendedFieldData คีย์จะเป็นชื่อฟิลด์ระดับบนสุดแบบธรรมดาเสมอ และจะไม่เป็นฟิลด์ย่อยที่ฝังอยู่
{
  "locationProvidedByMerchant": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters - Best Coffee in Sydney",
    "phoneNumbers": {
      "primaryPhone": "02 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "locationSeenByConsumers": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters",
    "phoneNumbers": {
      "primaryPhone": "+61 2 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "extendedFieldData": {
    "title": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_REJECTED",
      "rejectionReason": "MISREPRESENTATION",
      "updateTime": "2026-09-25T08:00:00Z",
      "source": "SOURCE_API"
    },
    "phone_numbers": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE",
      "updateTime": "2026-09-20T14:15:00Z",
      "source": "SOURCE_UI"
    },
    "website_uri": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
      "updateTime": "2026-09-15T10:30:00Z",
      "source": "SOURCE_API"
    }
  }
}

ดึงข้อมูลแอตทริบิวต์เพิ่มเติม

หากต้องการตรวจสอบค่าที่ผู้ขายระบุ ค่าที่แสดงต่อผู้บริโภค และสถานะการแก้ไขสำหรับแอตทริบิวต์ของสถานที่ตั้ง ให้เรียกใช้ locations.attributes.getExtended

ส่งคำขอ

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}/attributes:getExtended

คำตอบ

การตอบกลับจะแสดงผลทรัพยากร ExtendedAttributes ที่มีรายการ ExtendedAttribute แต่ละรายการจะจับคู่ attributeProvidedByMerchant และ attributeSeenByConsumers กับออบเจ็กต์ extendedFieldData สำหรับแอตทริบิวต์นั้นๆ ดังนี้

{
  "name": "locations/{locationId}/attributes",
  "extendedAttributes": [
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
        "updateTime": "2026-09-10T12:00:00Z",
        "source": "SOURCE_API"
      }
    },
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "free_wi_fi"
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "paid_wi_fi"
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_PENDING",
        "updateTime": "2026-09-28T16:45:00Z",
        "source": "SOURCE_API"
      }
    }
  ]
}

ทำความเข้าใจข้อมูลเมตาของช่องที่ขยาย

ออบเจ็กต์ ExtendedFieldData แต่ละรายการมีช่องต่อไปนี้

ช่อง ประเภท คำอธิบาย
lastEditLifecycleStage EditLifecycleStage สถานะการตรวจสอบหรือการแสดงผลของการแก้ไขล่าสุดในช่องหรือแอตทริบิวต์นี้
rejectionReason PolicyViolation การละเมิดนโยบายที่ทำให้การแก้ไขถูกปฏิเสธ ป้อนข้อมูลเมื่อ lastEditLifecycleStage เป็น EDIT_LIFECYCLE_STAGE_REJECTED
updateTime string (Timestamp) การประทับเวลาเมื่อส่งการแก้ไขล่าสุดไปยังช่องหรือแอตทริบิวต์นี้ (รูปแบบ RFC 3339)
source Source แพลตฟอร์มต้นทางที่ผู้ขายส่งการแก้ไข (SOURCE_API หรือ SOURCE_UI)

แก้ไขระยะของวงจร

EditLifecycleStage enum จะระบุว่าการแก้ไขอยู่ในขั้นตอนใดของวงจร ดังนี้

ค่า คำอธิบาย การดำเนินการที่แนะนำ
EDIT_LIFECYCLE_STAGE_ACCEPTED การแก้ไขของผู้ขายได้รับอนุมัติและมีสิทธิ์แสดงแล้ว ไม่ต้องแก้ไข
EDIT_LIFECYCLE_STAGE_PENDING การแก้ไขของผู้ขายอยู่ระหว่างตรวจสอบและยังไม่มีผลกับข้อมูลที่แสดงสำหรับผู้บริโภค รอให้การตรวจสอบเสร็จสมบูรณ์ อย่าส่งการแก้ไขที่เหมือนกันซ้ำๆ ขณะที่การแก้ไขรอดำเนินการอยู่
EDIT_LIFECYCLE_STAGE_REJECTED การแก้ไขของผู้ขายไม่ได้รับการยอมรับ ตรวจสอบ rejectionReason เพื่อดูค่า PolicyViolation ที่เฉพาะเจาะจง แก้ไขการละเมิดนโยบายที่เกี่ยวข้องและส่งการอัปเดตใหม่โดยใช้ locations.patch หรือ locations.updateAttributes
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE Google อัปเดตค่าสำหรับผู้บริโภค (เช่น จากรายงานของผู้ใช้หรือแหล่งที่มาภายนอก) และค่าดังกล่าวแตกต่างจากค่าที่ผู้ขายระบุ ตรวจสอบค่า locationSeenByConsumers หรือ attributeSeenByConsumers แล้วยอมรับหรือลบล้างค่าดังกล่าว โปรดดูหัวข้อจัดการการอัปเดตจาก Google
EDIT_LIFECYCLE_STAGE_DRAFT ระบบบันทึกการแก้ไขเป็นฉบับร่างแล้ว (เช่น ในสถานที่ที่ไม่ได้รับการยืนยัน) และไม่ได้เผยแพร่ใน Google Search และ Maps ดำเนินการยืนยันสถานที่ตั้งให้เสร็จสมบูรณ์เพื่อให้ข้อมูลแสดงต่อสาธารณะได้
EDIT_LIFECYCLE_STAGE_UNSPECIFIED ไม่ทราบหรือไม่ได้ระบุระยะวงจรการแก้ไข ไม่มี

แก้ไขแหล่งที่มา

Source enum จะระบุช่องทางที่ผู้ขายส่งการแก้ไข ดังนี้

  • SOURCE_API: มีการส่งการแก้ไขผ่าน My Business Business Information API
  • SOURCE_UI: มีการส่งการแก้ไขผ่าน UI บนเว็บหรือแอปบนอุปกรณ์เคลื่อนที่ของ Business Profile
  • SOURCE_UNSPECIFIED: ไม่ได้ระบุแหล่งที่มาของการแก้ไข

การละเมิดนโยบาย

เมื่อ lastEditLifecycleStage เป็น EDIT_LIFECYCLE_STAGE_REJECTED ช่อง rejectionReason จะระบุค่า enum PolicyViolation ที่อธิบายสาเหตุที่การแก้ไขถูกปฏิเสธ เหตุผลที่ปฏิเสธครอบคลุมด้านต่อไปนี้ (ตัวอย่าง)

  • สถานะโปรไฟล์และบัญชี: ACCOUNT_RESTRICTED_AND_SUSPENDED, ACCOUNT_RESTRICTED_AND_EDIT_REJECTED, ASSOCIATED_ACCOUNT_SUSPENDED, BUSINESS_INELIGIBLE, LOCATION_SUSPENDED, LOCATION_VERIFICATION_REQUIRED, OWNERSHIP_REVOKED, PO_BOX
  • ข้อจำกัดในการแก้ไข: EDITING_RESTRICTION, ILLEGAL_BUSINESS_HOURS_EDIT, IDENTITY_CHANGE, GEOGRAPHIC_LOCATION_CHANGE
  • นโยบายเนื้อหา: MISREPRESENTATION, OFF_TOPIC, PERSONAL_INFO, GIBBERISH_AND_REPETITIVE, OBSCENITY_AND_PROFANITY, GENERIC_QUALITY

ดูรายการค่าและคำอธิบาย enum ทั้งหมดได้ในเอกสารอ้างอิง PolicyViolation