Kiểm tra trạng thái chỉnh sửa của vị trí và thuộc tính

Khi bạn cập nhật thông tin doanh nghiệp thông qua My Business Business Information API hoặc giao diện người dùng của Trang doanh nghiệp, nội dung chỉnh sửa sẽ trải qua quy trình kiểm duyệt và xác minh trước khi xuất hiện trên Google Tìm kiếm và Maps. Ngoài ra, Google có thể cập nhật thông tin doanh nghiệp dựa trên báo cáo của người dùng hoặc các nguồn dữ liệu được cấp phép.

Điểm cuối v1alpha Edit Status cho phép bạn truy xuất chế độ xem hợp nhất của một vị trí hoặc các thuộc tính của vị trí đó trong một yêu cầu:

  • Dữ liệu do người bán cung cấp: Giá trị mà người bán gửi gần đây nhất.
  • Dữ liệu dành cho người tiêu dùng: Các giá trị xuất hiện trên Google Tìm kiếm và Maps.
  • Siêu dữ liệu trường mở rộng: Trạng thái chỉnh sửa theo từng trường hoặc từng thuộc tính, bao gồm cả giai đoạn trong vòng đời của nội dung chỉnh sửa mới nhất, nguồn gốc (API hoặc UI), dấu thời gian của nội dung chỉnh sửa gần đây nhất và lý do vi phạm chính sách (nếu nội dung chỉnh sửa bị từ chối).

Trước khi bắt đầu

Trước khi bạn sử dụng My Business Business Information API, hãy đăng ký ứng dụng của bạn và lấy thông tin đăng nhập OAuth 2.0. Để biết thông tin chi tiết về cách bắt đầu, hãy xem phần Thiết lập cơ bản.

Truy xuất dữ liệu vị trí mở rộng

Để kiểm tra dữ liệu vị trí do người bán cung cấp, dữ liệu vị trí dành cho người tiêu dùng và trạng thái chỉnh sửa theo từng trường cho một vị trí, hãy gọi locations.getExtended.

Không giống như locations.get, locations.getExtended không yêu cầu tham số readMask và trả về toàn bộ tài nguyên ExtendedLocation.

Yêu cầu

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

Phản hồi

Nội dung phản hồi chứa 3 trường cấp cao nhất:

  • locationProvidedByMerchant: Dữ liệu Location do người bán quản lý.
  • locationSeenByConsumers: Dữ liệu Location mà người tiêu dùng có thể thấy trên Google Tìm kiếm và Maps.
  • extendedFieldData: Bản đồ tên trường Location cấp cao nhất trong snake_case (chẳng hạn như title, phone_numbers, website_uri, storefront_address hoặc regular_hours) cho các đối tượng ExtendedFieldData. Khoá luôn là tên trường cấp cao nhất dạng văn bản thuần tuý, không bao giờ là trường con lồng nhau.
{
  "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"
    }
  }
}

Truy xuất dữ liệu thuộc tính mở rộng

Để kiểm tra các giá trị do người bán cung cấp, giá trị dành cho người tiêu dùng và trạng thái chỉnh sửa cho các thuộc tính của một vị trí, hãy gọi locations.attributes.getExtended.

Yêu cầu

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

Phản hồi

Phản hồi trả về một tài nguyên ExtendedAttributes chứa danh sách các mục ExtendedAttribute. Mỗi mục nhập sẽ ghép nối attributeProvidedByMerchant và attributeSeenByConsumers với một đối tượng extendedFieldData cho thuộc tính đó:

{
  "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"
      }
    }
  ]
}

Tìm hiểu về siêu dữ liệu trường mở rộng

Mỗi đối tượng ExtendedFieldData chứa các trường sau:

Trường Loại Mô tả
lastEditLifecycleStage EditLifecycleStage Trạng thái kiểm duyệt hoặc phân phát của nội dung chỉnh sửa gần đây nhất đối với trường hoặc thuộc tính này.
rejectionReason PolicyViolation Lỗi vi phạm chính sách khiến nội dung chỉnh sửa bị từ chối. Được điền sẵn khi lastEditLifecycleStage là EDIT_LIFECYCLE_STAGE_REJECTED.
updateTime string (Timestamp) Dấu thời gian khi nội dung chỉnh sửa gần đây nhất cho trường hoặc thuộc tính này được gửi (định dạng RFC 3339).
source Source Nền tảng gốc nơi người bán gửi nội dung chỉnh sửa (SOURCE_API hoặc SOURCE_UI).

Chỉnh sửa các giai đoạn trong vòng đời

Enum EditLifecycleStage cho biết vị trí của một bản chỉnh sửa trong vòng đời của bản chỉnh sửa đó:

Giá trị Mô tả Hành động được đề xuất
EDIT_LIFECYCLE_STAGE_ACCEPTED Nội dung chỉnh sửa của người bán đã được phê duyệt và đủ điều kiện để phân phát. Bạn không cần phải làm gì.
EDIT_LIFECYCLE_STAGE_PENDING Nội dung chỉnh sửa của người bán đang được xem xét và chưa được áp dụng cho trang thông tin dành cho người tiêu dùng. Chờ quá trình kiểm duyệt hoàn tất. Đừng gửi lại nhiều lần cùng một nội dung chỉnh sửa trong khi nội dung chỉnh sửa đó đang chờ xử lý.
EDIT_LIFECYCLE_STAGE_REJECTED Nội dung chỉnh sửa của người bán không được chấp nhận. Kiểm tra rejectionReason để biết giá trị PolicyViolation cụ thể. Khắc phục lỗi vi phạm chính sách cơ bản và gửi bản cập nhật mới bằng locations.patch hoặc locations.updateAttributes.
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE Giá trị dành cho người tiêu dùng đã được Google cập nhật (ví dụ: từ báo cáo của người dùng hoặc nguồn bên ngoài) và khác với giá trị do người bán cung cấp. Xem xét giá trị locationSeenByConsumers hoặc attributeSeenByConsumers rồi chấp nhận hoặc ghi đè giá trị đó. Xem bài viết Quản lý nội dung cập nhật của Google.
EDIT_LIFECYCLE_STAGE_DRAFT Nội dung chỉnh sửa đã được lưu dưới dạng bản nháp (ví dụ: trên một vị trí chưa được xác minh) và chưa xuất hiện trên Google Tìm kiếm và Maps. Hãy hoàn tất quy trình xác minh địa điểm để trang thông tin có thể xuất hiện.
EDIT_LIFECYCLE_STAGE_UNSPECIFIED Giai đoạn trong vòng đời của nội dung chỉnh sửa không xác định hoặc không được chỉ định. Không có.

Chỉnh sửa nguồn

Enum Source xác định kênh mà người bán đã gửi nội dung chỉnh sửa:

  • SOURCE_API: Nội dung chỉnh sửa được gửi thông qua My Business Business Information API.
  • SOURCE_UI: Nội dung chỉnh sửa được gửi thông qua giao diện người dùng web hoặc ứng dụng di động của Trang doanh nghiệp.
  • SOURCE_UNSPECIFIED: Nguồn của nội dung chỉnh sửa không được chỉ định.

Vi phạm chính sách

Khi lastEditLifecycleStage là EDIT_LIFECYCLE_STAGE_REJECTED, trường rejectionReason sẽ cung cấp một giá trị enum PolicyViolation giải thích lý do nội dung chỉnh sửa bị từ chối. Lý do từ chối bao gồm các khía cạnh sau (ví dụ):

  • Trạng thái hồ sơ và tài khoản: ACCOUNT_RESTRICTED_AND_SUSPENDED, ACCOUNT_RESTRICTED_AND_EDIT_REJECTED, ASSOCIATED_ACCOUNT_SUSPENDED, BUSINESS_INELIGIBLE, LOCATION_SUSPENDED, LOCATION_VERIFICATION_REQUIRED, OWNERSHIP_REVOKED, PO_BOX.
  • Các quy định hạn chế về việc chỉnh sửa: EDITING_RESTRICTION, ILLEGAL_BUSINESS_HOURS_EDIT, IDENTITY_CHANGE, GEOGRAPHIC_LOCATION_CHANGE.
  • Chính sách nội dung: MISREPRESENTATION, OFF_TOPIC, PERSONAL_INFO, GIBBERISH_AND_REPETITIVE, OBSCENITY_AND_PROFANITY, GENERIC_QUALITY.

Để xem danh sách đầy đủ các giá trị enum và nội dung mô tả, hãy xem tài liệu tham khảo PolicyViolation.