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.

Là chủ sở hữu trang thông tin, My Business Business Information API 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 nội dung cập nhật.

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

  1. Tìm các vị trí có thông tin 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 thông tin cập nhật
  4. Xem xét kết quả

Tìm những địa điểm 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 nội dung cập nhật, bạn phải tìm hiểu xem vị trí nào có Nội dung cập nhật của Google. Cách tốt nhất để nhận Nội dung cập nhật của Google cho các 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ì tức là 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 "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 xét các trường đã cập nhật

Để xem các trường cụ thể có Nội dung cập nhật của Google, hãy gọi locations.getGoogleUpdated.

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

  • diffMask: Cho biết những trường mà dữ liệu phân phát (nội dung khách hàng nhìn thấy trên Google Maps và Tìm kiếm) khác với giá trị ưu tiên tại địa phương của bạn. Điều này thường là do nội dung 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 đó, nhưng thông tin cập nhật vẫn đang được xử lý và chưa được đưa lê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. Trường 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 liệt kê trong diffMask, bạn phải chấp nhận hoặc từ chối nội dung cập nhật bằng cách sử dụng yêu cầu locations.patch:

  • Chấp nhận nội dung cập nhật: Sửa đổi 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 trên thiết bị của bạn cho khớp với dữ liệu phân phát.
  • Từ chối thông tin cập nhật: Sửa đổi địa điểm bằng giá trị ưu tiên ban đầu của bạn. 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ẽ hiển thị 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 giá trị của các 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 bản vá và lệnh gọi getGoogleUpdated.