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.invitations và accounts.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ất và cậ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ất và cậ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ệpCUSTOMER_LOCATION_ONLY
.
v4.7
Tính năng mới
- Thực đơn đồ ăn
- Truy xuất và cậ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ất và cậ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ặcFULL
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ặcGoogleLocations
. 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_code
vàsub_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_category
vàadditional_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
languageCodes
vàplatforms
không dùng đến trước đó củaUrlAttributeValue
đã 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_suspended
vàis_duplicate
. - Trạng thái vị trí mới
- Trạng thái vị trí hiện cũng bao gồm
is_verified
vàneeds_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_name
vàcategory_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ànhregular_hours
.