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ừ những 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 được 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 danh sách có thể chấp nhận hoặc từ chối bản cập nhật.

Là chủ sở hữu trang thông tin, API Thông tin doanh nghiệp của tôi cho phép bạn xem lại 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 nội dung cập nhật.

Để quản lý Google Updates, hãy hoàn tất các bước sau:

1. Tìm vị trí có nội dung cập nhật đang chờ xử lý
2. Xem 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. Kiểm tra kết quả

Tìm vị trí có nội dung cập nhật đang chờ xử lý

Trước khi có thể chấp nhận hoặc từ chối nội dung cập nhật, bạn phải tìm hiểu xem những vị trí nào có Nội dung cập nhật của Google sẵn có. Cách tốt nhất để tải Google Update cho 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 GOOGLE_UPDATE trên Chủ đề Pub/Sub, thì 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í với Google Updates.

Ngoài ra, bạn có thể thấy cuộc gọi locations.get và kiểm tra Metadata cho sự hiện diện của cờ hasGoogleUpdated. Nếu giá trị là "isGoogleUpdated": true, mã địa điểm liên kết với vị trí này đã cập nhật.

Yêu cầu

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

HTTP

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

Yêu cầu

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

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

Xem các trường thông tin cập nhật

Để xem lại các trường cụ thể có Nội dung 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 nội dung phản hồi.

Yêu cầu

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

HTTP

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

Phản hồi

Sau đây là một locations.getGoogleUpdated ví dụ về phản hồi. Trường này hiển thị bản cập nhật có sẵn trong trường phoneNumbers.primaryPhone. Giá trị trong câu trả lờ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 một 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 lấy được trước đó. Ngoài ra, hãy so khớp cả các giá trị ưu tiên cho mỗi trường.

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

Dưới đây là một locations.patch ví dụ về yêu cầu:

HTTP

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

Phản hồi

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

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

Từ chối yêu cầu

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

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à một locations.patch ví dụ về phản hồi:

{
    "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 locations.getGoogleUpdated phản hồi cho thấy các giá trị dưới dạng "diffMask": "". Ngoài ra, cờ "hasGoogleUpdated" trong Metadata hiển thị giá trị dưới dạng 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ị của trường không rõ ràng, liên hệ với nhóm hỗ trợ của chúng tôi về yêu cầu và phản hồi cho getGoogleUpdated. Chiến lược phát hành đĩa đơn phải bao gồm phản hồi trước khi locations.patch lệnh gọi bản vá, lệnh gọi getGoogleUpdated.