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

Để đảm bảo hồ sơ 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 tôi cho phép bạn xem xét những nội dung cập nhật này để đảm bảo 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ý 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 thông tin cập nhật
  4. Xem xét kết quả

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

Trước khi 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. Cách tốt nhất để nhận Thông tin cập nhật của Google cho các địa điểm 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 trên chủ đề Pub/Sub, thì có nghĩa là một thay đổi đã sẵn sàng để bạn xem xét.GOOGLE_UPDATE Trường locationName trong 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ể thấy lệnh gọi locations.get và kiểm tra Metadata để biết có cờ hasGoogleUpdated hay không. Nếu "isGoogleUpdated": true, mã địa điểm liên kết với vị trí này có thông tin 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 lại các trường đã cập nhật

Để xem xét các trường cụ thể có Thông tin cập nhật của Google, hãy gọi locations.getGoogleUpdated.

Phương thức này trả về 2 mặt nạ quan trọng trong phần nội dung phản hồi:

  • diffMask: Cho biết những trường có dữ liệu phân phát (những gì khách hàng nhìn thấy trên Google Maps và Tìm kiếm) khác với các giá trị ưu tiên tại địa phương của bạn. Điều này thường là do các bản cập nhật của Google hoặc nội dung do người dùng tạo. Bạn phải chấp nhận hoặc từ chối các trường này để giải quyết sự khác biệt.
  • pendingMask: Cho biết những trường mà bạn đã gửi thông tin cập nhật trước đây, nhưng thông tin cập nhật đó vẫn đang được xử lý và chưa được chuyển đến Google Maps và Tìm kiếm. Bạn không cần làm gì đối với các trường này.

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. Nội dung này cho thấy một bản cập nhật có sẵn 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": "+1 111 111 1111"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

Chấp nhận hoặc từ chối thông tin cập nhật

Để giải quyết các trường có trong diffMask, bạn phải chấp nhận hoặc từ chối nội dung cập nhật bằng yêu cầu locations.patch:

  • Chấp nhận nội dung cập nhật: Vá vị trí bằng giá trị mới được trả về trong phản hồi getGoogleUpdated. Thao tác này sẽ cập nhật bản ghi cục bộ của bạn để khớp với dữ liệu phân phát.
  • Từ chối nội dung cập nhật: Vá vị trí bằng giá trị ưu tiên ban đầu. Thao tác này sẽ xác nhận lại dữ liệu bạn muốn thông qua quy trình cập nhật và ghi đè dữ liệu phân phát.

Trong cả hai trường hợp, hãy đặt updateMask để bao gồm các trường mà bạn muốn giải quyết.

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": "+1 111 111 1111"
     },
}

Phản hồi

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

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
}

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ẽ cho thấy các giá trị là "diffMask": "". Ngoài ra, cờ "hasGoogleUpdated" trong Metadata cho thấy giá trị là false hoặc không có giá trị nào.

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 kèm theo yêu cầu và phản hồi cho 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 vá và lệnh gọi getGoogleUpdated.