Quản lý nội dung cập nhật của Google

Để đảm bảo trang doanh nghiệp của bạn luôn chính xác nhất có thể, Google sử dụng thông tin từ các nguồn như báo cáo của người dùng và nội dung được cấp phép. Nếu thông tin do chủ doanh nghiệp cung cấp bị báo cáo là không chính xác, Google sẽ thông báo cho chủ sở hữu trang thông tin. Sau đó, chủ sở hữu trang thông tin có thể chấp nhận hoặc từ chối nội dung cập nhật.

Với tư cách là chủ sở hữu trang thông tin, API Thông tin doanh nghiệp của Doanh nghiệp của tôi cho phép bạn xem xét những nội dung cập nhật này để đảm bảo rằng thông tin doanh nghiệp của bạn là chính xác. Hướng dẫn này mô tả cách chấp nhận hoặc từ chối bản cập nhật.

Để quản lý Thông tin cập nhật của Google, hãy hoàn tất các bước sau:

1. Tìm những vị trí có thông tin cập nhật đang chờ xử lý
2. Xem lại các trường đã cập nhật
3. Chấp nhận hoặc từ chối nội dung cập nhật
4. Xem kết quả

Tìm những vị trí có thông tin cập nhật đang chờ xử lý

Trước khi có thể chấp nhận hoặc từ chối thông tin cập nhật, bạn phải tìm hiểu xem những vị trí nào có Thông tin cập nhật của Google. Cách tốt nhất để nhận Thông tin cập nhật của Google về vị trí là Quản lý thông báo theo thời gian thực bằng Cloud Pub/Sub. Nếu bạn nhận được thông báo GOOGLE_UPDATE về chủ đề Pub/Sub, thì có một thay đổi đã sẵn sàng để bạn xem xét. Trường locationName trên thông báo cung cấp tên tài nguyên của vị trí có Nội dung cập nhật của Google.

Ngoài ra, bạn có thể xem lệnh gọi locations.get và kiểm tra Metadata để xem có cờ hasGoogleUpdated hay không. Nếu là "isGoogleUpdated": true, thì mã địa điểm liên kết với vị trí này có nội dung cập nhật.

Yêu cầu

Sau đây là ví dụ về yêu cầu locations.get:

HTTP

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

Yêu cầu

Sau đây là ví dụ về phản hồi locations.get:

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

Xem xét các trường cập nhật

Để xem lại các trường cụ thể có Thông tin cập nhật của Google, hãy gọi locations.getGoogleUpdated. diffMask nêu chi tiết các trường mà Google đã cập nhật nằm trong phần nội dung phản hồi.

Yêu cầu

Sau đây là ví dụ về yêu cầu locations.getGoogleUpdated:

HTTP

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

Phản hồi

Sau đây là ví dụ về phản hồi locations.getGoogleUpdated. Trạng thái này cho biết có bản cập nhật trong trường phoneNumbers.primaryPhone. Giá trị trong phản hồi này là giá trị cập nhật được đề xuất:

{
  "location": {
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "[phone]"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

Chấp nhận hoặc từ chối nội dung cập nhật

Để chấp nhận hoặc từ chối bản cập nhật, hãy thực hiện locations.patch với các trường updateMask được đặt giống như trong diffMask mà bạn đã nhận được trước đó. Ngoài ra, hãy so khớp các giá trị ưu tiên cho từng trường.

Chấp nhận yêu cầu

Sau đây là ví dụ về yêu cầu locations.patch:

HTTP

PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "phoneNumbers": {
      "primaryPhone": "[phone]"
     },
}

Phản hồi

Sau đây là ví dụ về phản hồi locations.patch:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "[phone]"
     },
    ...
}

Từ chối yêu cầu

Sau đây là ví dụ về yêu cầu 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"
     },
    ...
}

Phản hồi

Sau đây là ví dụ về phản hồi locations.patch:

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

Xem lại kết quả

Nếu vị trí của bạn được vá thành công, trường diffMask trong phản hồi locations.getGoogleUpdated sẽ hiển thị các giá trị là "diffMask": "". Ngoài ra, cờ "hasGoogleUpdated" trong Metadata hiển thị giá trị là false hoặc không có giá trị nào.

Lưu ý: Bạn nên xây dựng logic để xác minh diffMask và Metadata.

Nếu các giá trị trường không rõ ràng, hãy liên hệ với nhóm hỗ trợ của chúng tôi để yêu cầu và phản hồi về getGoogleUpdated. Yêu cầu phải bao gồm phản hồi trước lệnh gọi locations.patch, lệnh gọi bản vá và lệnh gọi getGoogleUpdated.