API Thông tin doanh nghiệp

Nhật ký thay đổi

v1

Quyền truy cập vào API

Bạn sẽ cần bật API Thông tin doanh nghiệp trong Bảng điều khiển GCP. Phạm vi OAuth vẫn giữ nguyên.

URL điểm cuối

Bạn có thể truy cập vào các điểm cuối để tìm kiếm tất cả thông tin doanh nghiệp, thuộc tính, danh mục, chuỗi và vị trí tại https://mybusinessbusinessinformation.googleapis.com/v1/ thay vì https://mybusiness.googleapis.com/v4/

Tên đường dẫn cho các điểm cuối của vị trí đã thay đổi từ accounts/accountId/locations/locationId thành locations/locationId

Thông tin cập nhật về vị trí

  • locationName đổi tên thành title
  • websiteUrl đổi tên thành websiteUri
  • accounts.locations.list và locations.get hiện yêu cầu readMask.
  • primaryPhone và additionalPhones hiện là một phần của PhoneNumbers.
  • primaryCategory và additionalCategories hiện đã thuộc Danh mục.
  • address đổi tên thành storefrontAddress
  • accounts.locations.clearAssociation đã được cập nhật thành locations.clearLocationAssociation.
  • serviceItems hiện được đọc và cập nhật trực tiếp từ đối tượng Vị trí.

Thuộc tính

  • Đối tượng Attributes mới và điểm cuối locations.attributes.getGoogleUpdated tương ứng để tải phiên bản cập nhật của Google.
  • attributes.list có một tham số show_all cho phép ứng dụng xem tất cả các thuộc tính có thể đặt cho một tổ hợp danh mục và khu vực cụ thể.

Doanh nghiệp phục vụ tận nơi

  • Các doanh nghiệp thuộc loại CUSTOMER_LOCATION_ONLY không còn phải điền địa chỉ.
  • Bổ sung regionCode trong ServiceAreaBusiness. Phải đặt chính sách này cho doanh nghiệp thuộc loại CUSTOMER_LOCATION_ONLY.

Điểm cuối và đối tượng không dùng nữa

  • Xoá đối tượng LocationKey. Các trường hiện có đã được di chuyển vào Siêu dữ liệu.
  • Xoá đối tượng PriceLists. Thay thế bằng FoodMenus và ServiceLists.
  • Xoá đối tượng LocationState. Hầu hết các trường hiện có đã được chuyển vào Siêu dữ liệu. Mặc dù Siêu dữ liệu có chứa giá trị boolean để biết người bán có toàn quyền kiểm soát doanh nghiệp (tiếng nói của người bán), nhưng các trường liên quan đến việc xác minh và tạm ngưng chi tiết hơn đã được chuyển sang Verifys API (API Xác minh). Hãy sử dụng phương thức locations.getVoiceOfMerchantState cho các bước tiếp theo để lấy ý kiến của người bán.
  • Ngừng sử dụng các điểm cuối googleLocations.report và accounts.locations.findMatchingLocations.
  • Điểm cuối TransferLocation đã được chuyển sang locations.transfer trong Account Management API (API Quản lý tài khoản).