Nhật ký thay đổi

v4.9

Tính năng mới

2026-10-09

Food Menus Dietary Restrictions: Giờ đây, enum DietaryRestriction hỗ trợ các thuộc tính GLUTEN_FREE và DAIRY_FREE cho các mục trong thực đơn bằng cách sử dụng accounts.locations.getFoodMenus và accounts.locations.updateFoodMenus.

2026-07-24

review_reply_url: Giờ đây, bạn có thể truy xuất reviewReplyUrl bằng cách sử dụng accounts.locations.reviews.get, accounts.locations.reviews.list và accounts.locations.batchGetReviews.

2026-07-01

Policy Violation: Trường PolicyViolation hiện có trong ReviewReply đối với các bài đánh giá. Bạn có thể truy xuất PolicyViolation bằng cách sử dụng accounts.locations.reviews.get, accounts.locations.reviews.list và accounts.locations.batchGetReviews. Nhờ đó, bạn có thể hiểu rõ hơn lý do một câu trả lời cho bài đánh giá bị từ chối trong quá trình kiểm duyệt.

2026-04-20

Review Media Items: Giờ đây, bạn có thể truy xuất ReviewMediaItems trong các bài đánh giá. Bạn có thể truy xuất ReviewMediaItems bằng cách sử dụng accounts.locations.reviews.get, accounts.locations.reviews.list và accounts.locations.batchGetReviews.

07/04/2026

Recurrence Info: Giờ đây, bạn có thể lên lịch đăng bài định kỳ bằng cách đặt RecurrenceInfo khi tạo một LocalPost

Food Menus: Giờ đây, bạn có thể quản lý tối đa 200 bức ảnh món ăn trong Thực đơn bằng accounts.locations.updateFoodMenus

2026-04-01

Review Reply State: Giờ đây, bạn có thể truy xuất ReviewReplyState trong phần bài đánh giá. Bạn có thể truy xuất ReviewReplyState bằng cách sử dụng accounts.locations.reviews.get, accounts.locations.reviews.list và accounts.locations.batchGetReviews. Nhờ đó, bạn có thể biết rõ hơn về trạng thái kiểm duyệt của các câu trả lời đánh giá mà bạn đã gửi.

2021-02-24

MoreHours : MoreHours hiện có thể được đặt 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

Không dùng nữa Tài khoản v4.x

accounts, accounts.admins, accounts.invitations và accounts.locations.admins hiện không được dùng nữa trong Google My Business API. Hãy xem nhật ký thay đổi về việc không dùng nữa để biết thêm thông tin.

Bài đăng kêu gọi hành động

Trong quý 2 năm 2021, CallToAction bài đăng có

GET_OFFER ActionType sẽ không còn hợp lệ.

v4.8

Tính năng mới

Tiện nghi của cơ sở lưu trú: Truy xuất và cập nhật 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 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: Thêm giá trị boolean canOperateHealthData vào LocationState

Mạng lưới bảo hiểm: Danh sách mạng lưới bảo hiểm được các đị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á đã được chuyển sang một đị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 của API áp dụng. Trong một khoảng thời gian ngắn, các mã nhận dạng bài đánh giá cũ vẫn sẽ phân giải khi được dùng để gọi API, nhưng bạn cần phải làm mới tất cả mã nhận dạng bài đánh giá được lưu trữ trên hệ thống trong vòng 30 ngày theo yêu cầu của chính sách 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 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: Truy xuất và cập nhật 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à doanh nghiệp cung cấp. Xem thêm thông tin

Thêm giá trị boolean canModifyServiceList vào LocationState

Cho biết một vị trí có đủ điều kiện để sửa đổi danh sách dịch vụ hay không Thô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 dưới dạng trong đối tượng danh mục. Xem thêm thông tin

CategoryView

Có thể chỉ định khung hiển thị BASIC hoặc FULL cho các danh mục. Khung hiển thị FULL sẽ trả về thông tin chi tiết bổ sung, chẳng hạn như các loại dịch vụ. Xem thêm thông tin

Categories.BatchGet Method

Phương thức mới này cho phép bạn nhập một danh sách các danh mục và chỉ trả về thông tin về những danh mục đó. Xem thêm thông tin

v4.5 Thông tin cập nhật lần 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 bằng API.

Thông tin khác.

v4.5 Thông tin 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 bằng API. Thông tin khác.

v4.5

Tính năng mới

Pub/Sub cho Hỏi và đáp

Giờ đây, bạn có thể nhận được 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 hoặc đã cập nhật về một địa điểm. 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 của Google Cloud Pub/Sub khi có thay đổi về 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ụ tại địa phương

Giờ đây, các doanh nghiệp cung cấp dịch vụ địa phương có thể được xác minh bằng API. 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. Xem thêm thông tin

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. Xem thêm thông tin

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 trang thông tin.

PointRadius : PointRadius hiện chỉ có thể đọc. Bạn cần sử dụng Places để 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

Lấy câu hỏi, đăng câu trả lời và cung cấp 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 hàng loạt bài đánh giá

Truy xuất bài đánh giá cho nhiều địa điểm trong một lệnh gọi duy nhất.

Thông tin khác.

GoogleLocations được đề xuất

Xem những địa điểm chưa được xác nhận quyền sở hữu mà Google cho rằng có thể thuộc về bạn. Thông tin khác.

Báo cáo vấn đề về GoogleLocation

Báo cáo vấn đề về kết quả RecommendedGoogleLocations hoặc GoogleLocations. Thông tin khác.

Loại enum dịch vụ cho các phần PriceList

Xác định một phần PriceList là chứa các mặt hàng THỰC PHẨM 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 chuỗi 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í

Những tài khoản được định cấu hình để nhận thông báo Pub/Sub hiện 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 người dùng nhóm hoặc Tài khoản 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í đã được xác nhận quyền sở hữu. Thông tin khác.

Bộ lọc vị trí mở rộng

Các lựa chọn khác để giới hạn số lượng kết quả trả về từ lệnh gọi Locations.List. Thông tin khác.

Hội viên của chuỗi

Cho biết địa điểm 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 cho Tài khoản tổ chức hiện sẽ hiển thị dưới dạng một phần của các đối tượng Tài khoản. Thông tin khác.

Ảnh hồ sơ của người đánh giá

URL cho ảnh hồ sơ của người đánh giá hiện có trong đối tượng đá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 cho những vị trí 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 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 khác.

openingDate Trường

Cung cấp ngày khai trương của địa điểm.

Thông tin khác.

Bài đăng về loại ư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 bằng API ngoài phương thức 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 những 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 để chọn nhận thay vì được 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

Google Doanh nghiệp của tôi API hiện hỗ trợ các tài khoản thuộc loại Nhóm người dùng.

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, hiện là một tài nguyên trong vị trí (accounts/<var>account_ID</var>/locations/<var>location_ID</var>/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, đồng sở hữu 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à những chủ sở hữu khác sẽ được cấp vai trò CO_OWNER.
• AccountType.BUSINESS nay có 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 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 dạng thức mà con người có thể đọc được nữa. Người dùng nên sử dụng dịch vụ danh mục của Google My Business API để nhận tên danh mục đã dịch, 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 thực đơn tại một vị trí nhất định
• Thêm nhiều danh mục món ăn vào một thực đơn
• Liệt kê các món ă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 tin cập nhật mới của Google.

Thay đổi không tương thích ngược

• Các trường languageCodes và platforms không dùng đến trước đây của UrlAttributeValue đã bị xoá.
• SAME trong enum Ownership 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 một phép 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 câu trả lời về vị trí, cho phép người dùng liên kết đến Google Maps.

Trạng thái vị trí

Các 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á, đang chờ xác minh.

Cờ mở lại

Cờ

canReopen cho biết những vị trí đã đóng cửa vĩnh viễn có thể mở cửa trở lại so với những vị trí không thể.

Thuộc tính

Hỗ trợ thuộc tính URL và Enum.

Điểm cuối danh mục

Nhận 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 theo danh mục cụ thể về vị trí.

Tìm vị trí trùng khớp

Tìm và liên kết thủ công các vị trí hiện có trên bản đồ với vị trí doanh nghiệp của bạn.

Vị trí chuyển

Hành động 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

Cho biết bức ảnh bạn muốn xuất hiện đầu tiên trên 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

Các trạng thái vị trí

hiện cũng bao gồm is_verified và needs_reverification.

Cải thiện URL của ảnh

Giờ đây, API này chấp nhận URL ảnh mà không có hậu tố định dạng hình ảnh.

Thay đổi không tương thích ngược

• Giờ đây, bạn phải chỉ định một 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 các 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í có mã yêu cầu trùng khớp với một vị trí đã tạo trước đó, thì hệ thống sẽ trả về vị trí hiện có và tránh tạo một 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.