Nhật ký thay đổi

v4.9

Tính năng mới

MoreHours
Bạn hiện có thể đặt
MoreHours trong trang thông tin doanh nghiệp.
MoreHourTypes có thể được truy xuất cho từng danh mục bằng categories.batchGet.

Thay đổi về hành vi

Ngừng sử dụng tài khoản phiên bản 4.x
tài khoản, accounts.admins, accounts.invitations và accounts.locations.admins hiện đã ngừng hoạt động trong API Google Doanh nghiệp của tôi. Hãy xem nhật ký thay đổi về tình trạng ngừng sử dụng để biết thêm thông tin.
Bài đăng kêu gọi hành động
Vào 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 của phòng lưu trú
Thu hồi và cập nhật các tiện nghi của phòng lưu trú. Thông tin khác
Bổ sung điểm cuối GetGoogleUpdated cho Phòng nghỉ.
Bổ sung giá trị boolean canOperateLodgingData trong LocationState
Thuộc tính của nhà cung cấp dịch vụ y tế
Truy xuất và cập nhật HealthProviderAttributes. Thông tin khác
Bổ sung giá trị boolean canOperateHealthData trong LocationState
Mạng bảo hiểm
Danh sách mạng bảo hiểm mà các địa điểm chấp nhận. Thông tin chi tiết

Thay đổi về hành vi

Mã bài đánh giá
Mã bài đánh giá đã được 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ả phản hồi hiện có của API. Trong một khoảng thời gian ngắn, mã bài đánh giá cũ sẽ vẫn được phân giải khi được dùng để gọi API. Tuy nhiên, bạn cần phải làm mới tất cả mã bài đánh giá được lưu trữ trên hệ thống của bạn 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
Vào Quý 1 năm 2021, các doanh nghiệp có CUSTOMER_LOCATION_ONLY sẽ không còn được trả về Address trong đối tượng Vị trí.

v4.7

Tính năng mới

Thực đơn món ăn
Truy xuất và cập nhật FoodMenus. Thông tin chi tiết

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à doanh nghiệp cung cấp. Thông tin khác
Bổ sung giá trị boolean canModifyServiceList trong LocationState
Cho biết một vị trí có đủ điều kiện để sửa đổi danh sách dịch vụ hay khôngThông tin chi tiết
ServiceTypes được xác định trước cho danh mục
Các loại dịch vụ được xác định trước giờ đây được đưa vào dưới dạng đối tượng danh mục.Thông tin chi tiết
CategoryView
Khả năng chỉ định khung hiển thị BASIC hoặc FULL cho các danh mục. Chế độ xem FULL sẽ trả về thông tin chi tiết bổ sung như loại dịch vụ. Thông tin khác
Phương thứccategory.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 chi tiết

v4.5 COVID-19 Cập nhật 2

Tính năng mới

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

v4.5 COVID-19 Cập nhật 1

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 chi tiết.

v4.5

Tính năng mới

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

v4.4

Tính năng mới

Xác minh doanh nghiệp cung cấp dịch vụ địa phương
API hiện có thể xác minh các doanh nghiệp cung cấp dịch vụ địa phương. Thông tin chi tiết.
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 chi tiết.
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
Bổ sung trường hasPendingEdits trong LocationState
Cho biết các cơ sở lưu trú của một Vị trí có ở trạng thái đang chờ chỉnh sửa hay không. Thông tin chi tiết

Thay đổi về hành vi

Vé chọn trước ngày
Bây giờ, 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ế độ chỉ có thể đọc. Bạn bắt buộc phải 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 của doanh nghiệp. Thông tin chi tiết.
Đọc bài đánh giá hàng loạt
Truy xuất bài đánh giá cho nhiều địa điểm trong một cuộc gọi. Thông tin chi tiết.
Vị trí được đề xuất trên Google
Xem các vị trí chưa được xác nhận quyền sở hữu mà Google cho rằng có thể bạn đang sở hữu. Thông tin chi tiết.
Báo cáo vấn đề về GoogleVị trí
Báo cáo vấn đề liên quan đến kết quả của RecommendedGoogleLocations hoặc GoogleLocations. Thông tin chi tiết.
Enum dịch vụ cho PriceList mục
Xác định mục PriceList chứa các mặt hàng Ẩm thực hoặc DỊCH VỤ được cung cấp. Thông tin chi tiết.
Nội dung mô tả về nội dung nghe nhìn
Thêm phụ đề khi tải nội dung nghe nhìn mới lên. Thông tin chi tiết.
Thông tin chi tiết về CHAINS_QUERIES
Truy xuất số lần một vị trí được hiển thị khi tìm kiếm chuỗi của vị trí đó. Thông tin chi tiết.

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 đã thiết lập để nhận thông báo của Pub/Sub cũng sẽ nhận được thông báo của 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í
Giờ đây,
accounts.locations.list được gọi bằng tài khoản Nhóm người dùng hoặc Tài khoản tổ chức sẽ hiển thị tất cả cá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 chi tiết.
API vị trí của Google
Tì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í đã được xác nhận quyền sở hữu. Thông tin chi tiết.
Bộ lọc vị trí mở rộng
Các tuỳ chọn bổ sung để giới hạn kết quả được trả về từ lệnh gọi Locations.List. Thông tin khác.
Thành viên của chuỗi
Cho biết trạng thái thành viên của một địa điểm thuộc chuỗi cửa hàng (ví dụ: Walmart, Target, v.v.). Thông tin chi tiết.
Thông tin tổ chức
Thông tin cho Tài khoản tổ chức giờ đây sẽ hiển thị như một phần của các đối tượng Tài khoản. Thông tin chi tiết.
Ảnh hồ sơ của người đánh giá
URL cho ảnh hồ sơ của người đánh giá nay được đưa vào đối tượng đánh giá. Thông tin chi tiết.

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 cho các địa điểm mà bạn sở hữu và quản lý. Thông tin chi tiết.
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 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 chi tiết.
Profile (Nội dung mô tả do người bán cung cấp)
Mô tả doanh nghiệp bằng giọng điệu của riêng bạn và chia sẻ với người dùng câu chuyện độc đáo về doanh nghiệp cũng như sản phẩm/dịch vụ của bạn. Thông tin chi tiết.
openingDate Trường
Cung cấp ngày mà địa điểm của bạn mở cửa kinh doanh. Thông tin chi tiết.
Bài đăng loại ưu đãi
Đây là 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 hiện có tại các địa điểm của bạn. Thông tin chi tiết.

v4

Tính năng mới

Đăng tin trên Google
Giờ đây, bạn có thể trực tiếp tạo Bài đăng trên Google thông qua API.
Tải ảnh lên
Giờ đây, bạn có thể tải ảnh lên trực tiếp thông qua API ngoài việc tải lên URL hiện có.
Lọc thông báo/Chọn nhận
Giờ đây, bạn có thể lọc những thông báo được gửi đến các chủ đề của pubsub. Các thông báo trong tương lai sẽ sử dụng cơ chế này để chọn nhận thay vì gửi cho 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 để biết thông tin cập nhật về 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 đối tượng location, giờ đây 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 đây.

  • Người đồng sở hữu của các tài khoản và vị trí trước đây không thể phân biệt được 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 chỉ định vai trò OWNER và các chủ sở hữu khác sẽ được chỉ định vai trò CO_OWNER.

  • AccountType.BUSINESS hiện có tên là AccountType.LOCATION_GROUP.

  • Khi sử dụng mặt nạ cho trường (field mask) để cập nhật vị trí, hãy cung cấp update_mask thay cho 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 bản dịch tên danh mục mà con người có thể đọc đượ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 ở một vị trí nhất định

  • Thêm nhiều mục trình đơn vào một trình đơn

  • Liệt kê các mục trong trình đơn cùng với 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à chỉ số 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ề Thông tin 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 được sử dụng trước đó của UrlAttributeValue đã bị xoá.

  • Giờ đây, SAME trong enum Quyền sở hữu không được dùng nữa sẽ chỉ áp dụng nếu vị trí mà tệp trùng lặp này có cùng chủ sở hữu chính. Trước đây, hành vi này dựa trên phép tính toán 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ó trong các câu trả lời về vị trí, nhờ đó, người dùng có thể dễ dàng liên kết với Google Maps.
Trạng thái của vị trí
Trạng thái của 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á và đang chờ xác minh.
Cờ mở lại
Cờ canReopen chỉ ra các vị trí đã đóng cửa vĩnh viễn có thể mở cửa lại so với các vị trí không thể mở cửa lại.
Thuộc tính
Hỗ trợ các thuộc tính URL và Enum.
Thiết bị đầu cuối danh mục
Xem 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ông tin bổ sung, cụ thể theo từng danh mục về các 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 bản đồ với địa điểm của doanh nghiệp theo cách thủ công.
Chuyển vị trí
Hành động mới trên Location :transfer. Cho phép chuyển thông tin 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
Hãy cho biết ảnh bạn muốn hiển thị đầu 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 mới của vị trí
Trạng thái vị trí hiện cũng bao gồm cả is_verified và needs_reverification.
Cải tiến URL ảnh
API hiện chấp nhận các 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 các vị trí có trang Google+ (những vị trí này đã được chấp nhận và bị ngầm loại bỏ trước đây).

  • Các trường location_name và category_name hiện chỉ có đầu ra. Chỉ sử dụng mã danh mục khi đặt danh mục.

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

  • Giờ đây, các thao tác tạo/cập nhật sẽ 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.

v2

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

  • Bây giờ, bạn phải chỉ định request_id trong các lệnh gọi CreateLocation. Mã nhận dạng này phải là duy nhất cho từng vị trí để tránh việc tạo các vị trí trùng lặp trong tài khoản của bạn. Việc cố gắng tạo một vị trí có mã yêu cầu khớp với vị trí đã tạo trước đó sẽ chỉ trả về vị trí hiện có và tránh tạo 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.