Nhật ký thay đổi

v4.9

Tính năng mới

2026-04-07

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

2026-04-01

Review Reply State: Giờ đây, bạn có thể truy xuất ReviewReplyState trong phần đánh giá. ReviewReplyState có thể được truy xuất bằ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 cho bài đánh giá mà bạn đã gửi.

2021-02-24

MoreHours : Giờ hoạt động 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

Ngừng sử dụng 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 Doanh nghiệp của tôi 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

Health Provider Attributes (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 API có thể áp dụng. Trong một khoảng thời gian ngắn, các mã nhận dạng cũ của bài đánh giá 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ã nhận dạng 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 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 món ă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à một doanh nghiệp cung cấp. Thông tin khác

Thêm giá trị boolean canModifyServiceList vào 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ô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. Thông tin khác

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 khác, chẳng hạn như các loại dịch vụ. Thông tin khác

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 đó. Thông tin khác

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 về COVID-19 lần 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 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 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ụ đị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 địa điểm thông qua API. Thông tin khác

Thêm trường hasPendingEdits vào LocationState

Cho biết liệu các thuộc tính của 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 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á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 hàng loạt bài đánh giá

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

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 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 PriceList phần

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 cho chuỗi mà vị trí đó thuộc về. Thông tin khác.

Thay đổi về hành vi

Thông báo dành 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 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 những 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 những 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á

Giờ đây, URL cho ảnh hồ sơ của người đánh giá sẽ đượ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 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 Đăng tin 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

API Google Doanh nghiệp của tôi hiện hỗ trợ 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/<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ười đồng sở hữu tài khoản và vị trí 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 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 biểu mẫu 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 API Google Doanh nghiệp của tôi để nhận tên danh mục đã dịch, 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 thực đơn tại một địa điểm 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à 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ề các nội dung 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 đâ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 phức tạp hơn về quyền sở hữu.

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.

Reopen Flag

Cờ

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

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 địa điểm của doanh nghiệp 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 (tài khoản doanh nghiệp hoặc tài khoản cá nhân) sang tài khoản khác.

Ảnh ưa thích

Cho biết ảnh mà 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.

Các 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. Khi 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 đó, 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.