Nhật ký thay đổi

v4.9

Tính năng mới

MoreHours
Giờ đây, bạn có thể đặt
MoreHours trong trang thông tin doanh nghiệp.
Bạn có thể truy xuất
MoreHourTypes cho từng danh mục bằng cách sử dụng categories.batchGet.

Thay đổi về hành vi

Ngừng sử dụng Tài khoản phiên bản 4.x
accounts, accounts.admins, accounts.invitationsaccounts.locations.admins hiện không còn được dùng trong API Google Doanh nghiệp của tôi. Hãy xem nhật ký thay đổi về việc ngừng sử dụng để biết thêm thông tin.
Bài đăng CallToAction
Kể từ quý 2 năm 2021, CallToAction Bài đăng có ActionType GET_OFFER sẽ không còn hợp lệ nữa.

v4.8

Tính năng mới

Tiện nghi tại cơ sở lưu trú
Truy xuấtcập nhật các tiện nghi của cơ sở lưu trú. Thông tin khác
Thêm điểm cuối GetGoogleUpdated cho cơ sở lưu trú.
Thêm giá trị boolean canOperateLodgingData trong LocationState
Thuộc tính nhà cung cấp dịch vụ y tế
Truy xuấtcập nhật HealthProviderAttributes. Thông tin khác
Thêm giá trị boolean canOperateHealthData trong LocationState
Mạng lưới bảo hiểm
Danh sách các mạng lưới bảo hiểm mà địa điểm chấp nhận. Thông tin khác

Thay đổi về hành vi

Mã bài đánh giá
Mã bài đánh giá đã chuyển sang định dạng mới. Giờ đây, mã nhận dạng mới này sẽ được trả về trong tất cả các phản hồi API hiện hành. Trong một khoảng thời gian ngắn, mã bài đánh giá cũ vẫn sẽ phân giải khi được dùng để gọi API. Tuy nhiên, bạn cần làm mới tất cả mã bài đánh giá được lưu trữ trên hệ thống của mình trong vòng 30 ngày theo yêu cầu của chính sách của chúng tôi bằng cách gọi điểm cuối listReviews.
Doanh nghiệp phục vụ tận nơi
Trong quý 1 năm 2021, Address sẽ không còn được trả về trong đối tượng Vị trí cho các doanh nghiệp CUSTOMER_LOCATION_ONLY.

v4.7

Tính năng mới

Thực đơn đồ ăn
Truy xuấtcập nhật của FoodMenus. Thông tin khác

v4.6

Tính năng mới

Danh sách dịch vụ
Giờ đây, bạn có thể truy xuấtcập nhật các dịch vụ mà một doanh nghiệp cung cấp. Thông tin khác
Thêm giá trị boolean canModifyServiceList trong LocationState
Cho biết liệu một vị trí có đủ điều kiện để sửa đổi danh sách dịch vụ hay khôngThông tin khác
ServiceTypes được xác định trước cho Danh mục
Các loại dịch vụ được xác định trước hiện được đưa vào như trong đối tượng danh mục.Thông tin khác
CategoryView
Khả năng chỉ định chế độ xem BASIC hoặc FULL cho các danh mục. Khung hiển thị FULL sẽ trả về các thông tin chi tiết bổ sung như loại dịch vụ. Thông tin khác
Phương thức Categories.BatchGet
Phương thức mới này cho phép bạn nhập danh sách danh mục và chỉ trả về thông tin về các danh mục đó. Thông tin khác

v4.5 Bản cập nhật 2 về COVID-19

Tính năng mới

Loại bài đăng cảnh báo về COVID-19
Giờ đây, bạn có thể tạo bài đăng COVID_19 thông qua API. Thông tin khác.

v4.5 Bản cập nhật 1 về COVID-19

Tính năng mới

Tạm thời đóng cửa
Giờ đây, bạn có thể đặt một doanh nghiệp thành CLOSED_TEMPORARILY thông qua API. Thông tin khác.

v4.5

Tính năng mới

Pub/Sub cho phần Hỏi và đáp
Giờ đây, bạn có thể nhận thông báo của Google Cloud Pub/Sub về các câu hỏi và câu trả lời mới/đã cập nhật về một vị trí. Thông tin khác.
Pub/Sub cho trạng thái trang thông tin
Giờ đây, bạn có thể nhận thông báo Google Cloud Pub/Sub về thay đổi trạng thái trang thông tin. Thông tin khác.

v4.4

Tính năng mới

Quy trình xác minh doanh nghiệp cung cấp dịch vụ địa phương
Giờ đây, API có thể xác minh các doanh nghiệp cung cấp dịch vụ địa phương. Thông tin khác.
Số người theo dõi
Giờ đây, bạn có thể truy xuất siêu dữ liệu về người theo dõi. Thông tin khác.
Nhóm người dùng và nhóm vị trí
Giờ đây, bạn có thể tạo nhóm người dùng và nhóm vị trí thông qua API. Thông tin khác
Thêm trường hasPendingEdits trong LocationState
Cho biết liệu các thuộc tính của một Vị trí có ở trạng thái đang chờ chỉnh sửa hay không. Thông tin khác

Thay đổi về hành vi

Vé chọn trước ngày
Giờ đây, bạn có thể đặt ngày khai trương trong tương lai cho một trang thông tin.
PointRadius
PointRadius hiện chỉ có thể đọc. Bạn cần sử dụng Địa điểm để chỉnh sửa hoặc tạo doanh nghiệp dịch vụ địa phương.

v4.3

Tính năng mới

API Hỏi và đáp
Truy xuất câu hỏi, đăng câu trả lời và cung cấp các câu hỏi thường gặp về địa điểm doanh nghiệp của bạn. Thông tin khác.
Đọc nhiều bài đánh giá cùng lúc
Truy xuất bài đánh giá cho nhiều vị trí trong một lệnh gọi. Thông tin khác.
GoogleLocations được đề xuất
Xem những vị trí chưa được xác nhận quyền sở hữu mà Google cho rằng có thể thuộc quyền sở hữu của bạn. Thông tin khác.
Báo cáo vấn đề về GoogleLocation
Báo cáo vấn đề với kết quả RecommendedGoogleLocations hoặc GoogleLocations. Thông tin khác.
Enum dịch vụ cho các phần PriceList
Xác định một mục PriceList chứa các MÓN ĂN hoặc DỊCH VỤ được cung cấp. Thông tin khác.
Nội dung mô tả nội dung nghe nhìn
Cung cấp chú thích khi tải nội dung nghe nhìn mới lên. Thông tin khác.
CHAINS_QUERIES Thông tin chi tiết
Truy xuất số lần một vị trí xuất hiện trong kết quả tìm kiếm theo chuỗi cửa hàng mà vị trí đó thuộc về. Thông tin khác.

Thay đổi về hành vi

Thông báo cho Tài khoản tổ chức và Nhóm vị trí
Giờ đây, những tài khoản được định cấu hình để nhận thông báo Pub/Sub cũng sẽ nhận được những thông báo đó cho mọi trang thông tin có trong Tài khoản tổ chức hoặc Nhóm vị trí mà họ là quản trị viên.
ListLocations cho Tài khoản tổ chức và Nhóm vị trí
accounts.locations.list được gọi bằng tài khoản Nhóm người dùng hoặc Tổ chức hiện hiển thị tất cả vị trí mà tài khoản đó có thể truy cập.

v4.2

Tính năng mới

API Xác minh
Liệt kê và kích hoạt các phương thức xác minh hiện có cho những vị trí chưa được xác minh. Thông tin khác.
GoogleLocations API
Tìm kiếm các vị trí hiện có trên Google để xác nhận quyền sở hữu hoặc truy xuất đường liên kết để yêu cầu quyền truy cập vào các vị trí đã xác nhận quyền sở hữu. Thông tin khác.
Mở rộng bộ lọc vị trí
Các tuỳ chọn khác để giới hạn kết quả được trả về từ lệnh gọi Locations.List. Thông tin thêm.
Hội viên của chuỗi
Cho biết một vị trí là thành viên của một chuỗi (ví dụ: Walmart, Target, v.v.). Thông tin khác.
Thông tin Tổ chức
Thông tin về Tài khoản tổ chức hiện sẽ hiển thị trong các đối tượng Tài khoản. Thông tin khác.
Ảnh hồ sơ của người đánh giá
URL của ảnh hồ sơ của người đánh giá hiện được đưa vào đối tượng bài đánh giá. Thông tin khác.

v4.1

Tính năng mới

Nội dung nghe nhìn do khách hàng cung cấp
Giờ đây, bạn có thể truy xuất và xem thông tin chi tiết về ảnh và video do người dùng tạo tại những địa điểm mà bạn sở hữu và quản lý. Thông tin khác.
API quản lý dành cho quản trị viên
Giờ đây, bạn có thể liệt kê, chấp nhận và từ chối các lời mời liên quan đến tài khoản và vị trí cho tài khoản của mình. Thông tin khác.
Profile (Nội dung mô tả do người bán cung cấp)
Mô tả doanh nghiệp của bạn bằng giọng điệu riêng và chia sẻ với người dùng câu chuyện độc đáo về doanh nghiệp và sản phẩm/dịch vụ của bạn. Thông tin khác.
Trường openingDate
Cung cấp ngày mà địa điểm của bạn bắt đầu hoạt động kinh doanh. Thông tin khác.
Bài đăng về chương trình ưu đãi
Một loại bài đăng mới trên Google, giúp người dùng tìm thấy các ưu đãi tại địa điểm của bạn. Thông tin khác.

v4

Tính năng mới

Đăng tin trên Google
Giờ đây, bạn có thể tạo Bài đăng trên Google ngay thông qua API.
Tải ảnh lên
Giờ đây, bạn có thể tải ảnh lên trực tiếp qua API, ngoài cách tải lên bằng URL hiện có.
Lọc/Chọn nhận thông báo
Giờ đây, bạn có thể lọc thông báo được gửi đến các chủ đề pubsub. Các thông báo trong tương lai sẽ sử dụng cơ chế này để người dùng chọn nhận thay vì gửi đến tất cả người dùng.
UPDATED_REVIEW Thông báo
Giờ đây, bạn có thể đăng ký nhận thông báo theo thời gian thực về nội dung cập nhật đối với bài đánh giá của khách hàng.
Hỗ trợ Nhóm người dùng
API Google Doanh nghiệp của tôi hiện hỗ trợ các tài khoản thuộc loại Nhóm người dùng.

Các thay đổi không tương thích ngược

  • Ảnh, trước đây là một trường của các đối tượng location, hiện là một tài nguyên trong vị trí (accounts/account_ID/locations/location_ID/photos).

  • Trường địa chỉ Country hiện là region_codesub_locality hiện là sublocality.

  • Xoá trường Ownership không dùng nữa trước đó.

  • Trước đây, các chủ sở hữu chung của tài khoản và vị trí không thể phân biệt với chủ sở hữu chính thông qua API (tất cả đều xuất hiện dưới dạng OWNER). Giờ đây, chủ sở hữu chính sẽ được cấp vai trò OWNER và các chủ sở hữu khác sẽ được cấp vai trò CO_OWNER.

  • AccountType.BUSINESS hiện được đặt tên là AccountType.LOCATION_GROUP.

  • Khi sử dụng mặt nạ trường để cập nhật vị trí, hãy cung cấp update_mask thay vì field_mask hiện có.

  • Thông báo danh mục dùng cho primary_categoryadditional_categories không còn chứa biểu mẫu mà con người có thể đọc được. Người dùng nên sử dụng dịch vụ danh mục của API Google Doanh nghiệp của tôi để nhận tên danh mục được dịch và dễ đọc.

v3.3

Tính năng mới

Trình đơn có cấu trúc

Giờ đây, bạn có thể thêm, cập nhật hoặc xoá:

  • Nhiều trình đơn tại một vị trí nhất định

  • Thêm nhiều mục trong thực đơn

  • Liệt kê các món trong thực đơn kèm theo tên, nội dung mô tả, giá và ảnh

v3.2

Tính năng mới

Thông tin chi tiết
Giờ đây, bạn có thể truy xuất thông tin chi tiết về vị trí và các chỉ số về hoạt động lái xe thông qua API.
Thông báo
Giờ đây, bạn có thể đăng ký nhận thông báo theo thời gian thực về các bản cập nhật mới của Google.

Các thay đổi không tương thích ngược

  • Các trường languageCodesplatforms không dùng đến trước đó của UrlAttributeValue đã bị xoá.

  • SAME trong enum Quyền sở hữu không dùng nữa hiện chỉ áp dụng nếu vị trí mà vị trí này trùng lặp có cùng chủ sở hữu chính. Trước đây, hành vi này dựa trên cách tính quyền sở hữu phức tạp hơn.

v3.1

Tính năng mới

Thông báo
Giờ đây, bạn có thể đăng ký nhận thông báo theo thời gian thực về các bài đánh giá mới.
URL của Maps
URL của Google Maps được đưa vào các phản hồi về vị trí để người dùng dễ dàng liên kết đến Google Maps.
Trạng thái vị trí
Trạng thái vị trí bổ sung cho biết thời điểm trang thông tin được xuất bản, bị vô hiệu hoá hoặc đang chờ xác minh.
Cờ mở lại
Cờ
canReopen cho biết những địa điểm đã đóng cửa vĩnh viễn có thể mở lại và những địa điểm không thể mở lại.
Thuộc tính
Hỗ trợ các thuộc tính URL và Enum.
Điểm cuối của danh mục
Tải danh sách các danh mục được hỗ trợ theo quốc gia và ngôn ngữ (thay thế tệp CSV).

v3

Tính năng mới

Bài đánh giá
Giờ đây, bạn có thể truy xuất và trả lời các bài đánh giá về doanh nghiệp thông qua API.
Thuộc tính
Cung cấp thêm thông tin theo danh mục về vị trí.
Tìm vị trí trùng khớp
Tìm và liên kết các địa điểm hiện có trên Maps với địa điểm của doanh nghiệp theo cách thủ công.
Vị trí chuyển
Thao tác mới trên Location :transfer. Cho phép chuyển một vị trí từ tài khoản này (doanh nghiệp hoặc cá nhân) sang tài khoản khác.
Ảnh ưa thích
Chỉ định ảnh mà bạn muốn xuất hiện trước tiên trong Google Maps và Tìm kiếm.
Bộ lọc tìm kiếm mới
Các bộ lọc tìm kiếm mới bao gồm any_google_updates, is_suspendedis_duplicate.
Trạng thái vị trí mới
Trạng thái vị trí hiện cũng bao gồm is_verifiedneeds_reverification.
Cải tiến URL của ảnh
API hiện chấp nhận URL ảnh không có hậu tố định dạng hình ảnh.

Các thay đổi không tương thích ngược

  • Giờ đây, bạn chỉ có thể cập nhật ảnh cho những vị trí có trang Google+ (trước đây, những vị trí này đã được chấp nhận và bị loại bỏ một cách âm thầm).

  • Các trường location_namecategory_name hiện chỉ có đầu ra. Chỉ sử dụng mã danh mục khi thiết lập danh mục.

  • Mặt nạ trường không được chứa tiền tố location. cho các trường được đưa vào.

  • Các thao tác tạo/cập nhật hiện lấy vị trí làm tải trọng nội dung; các tham số khác được chuyển sang chuỗi truy vấn.

phiên bản 2

Các thay đổi không tương thích ngược

  • Giờ đây, bạn phải chỉ định request_id trong các lệnh gọi CreateLocation. Mã này phải là duy nhất cho từng vị trí; mã này giúp ngăn việc tạo vị trí trùng lặp trong tài khoản của bạn. Nếu bạn cố gắng tạo một vị trí mà mã yêu cầu khớp với một vị trí đã tạo trước đó, thì hệ thống sẽ chỉ trả về vị trí hiện có và tránh tạo vị trí trùng lặp trong tài khoản của bạn.

    • business_hours trong Vị trí đã được đổi tên thành regular_hours.