API Hiệu suất kinh doanh của Google có phương thức API MỚI cho phép tìm nạp nhiều `DailyMetrics` trong một yêu cầu API. Hãy xem lại lịch biểu không dùng nữa và các hướng dẫn để chuyển từ phương pháp API báo cáo v4 sang API Hiệu suất Trang doanh nghiệp trên Google.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
GoogleLocations API cho phép bạn xem trước xem một vị trí có được xác nhận quyền sở hữu trong Trang doanh nghiệp hay không. Bằng cách này, nếu vị trí đã được xác nhận quyền sở hữu, bạn có thể yêu cầu quyền truy cập vào vị trí đó ngay lập tức. Ngoài ra, nếu quản lý các tài khoản đã xác minh hàng loạt, bạn có thể chọn trước các kết quả trùng khớp tiềm năng một cách chính xác hơn và tránh tạo vị trí trùng lặp.
Điểm cuối API trả về một URL cho biết liệu một vị trí đã được xác nhận quyền sở hữu hay chưa. Nếu URL đó đã được xác nhận quyền sở hữu, thì bạn có thể bắt đầu quy trình yêu cầu quyền truy cập bằng chính URL đó.
Hình ảnh sau đây cung cấp thông tin tổng quan về quy trình để có được quyền sở hữu đối với một vị trí.
Hình 1. Sơ đồ luồng công việc về quyền sở hữu địa điểm trên Trang doanh nghiệp
Các bước sau đây cho phép bạn sử dụng API GoogleLocations:
Thu thập dữ liệu vị trí từ người bán.
Gọi điểm cuối googleLocations.search. Cung cấp dữ liệu vị trí trong phần nội dung của lệnh gọi. Ngoài ra, bạn có thể cung cấp thông tin này trong một chuỗi truy vấn, tương tự như nội dung mà người dùng sẽ nhập vào Tìm kiếm hoặc Maps. Ví dụ: "Starbucks 5th ave NYC".
API này trả về danh sách các vị trí có thể khớp và thông tin về từng vị trí, chẳng hạn như locationName và địa chỉ.
Chọn vị trí khớp với vị trí của bạn. Nếu không có kết quả trùng khớp, hãy gọi accounts.locations.create và chuyển sang bước 5.
Dựa trên trạng thái của requestAdminRightsUrl trong phản hồi, hãy thực hiện các thao tác sau:
Nếu requestAdminRightsUrl tồn tại, thì một người dùng khác có quyền sở hữu trang thông tin.
Hướng dẫn người bán truy cập vào URL để bắt đầu yêu cầu quyền truy cập và quyền sở hữu vị trí hiện có trong Trang doanh nghiệp.
Nếu requestAdminRightsUrl không tồn tại, hãy gọi accounts.locations.create và tạo một trang thông tin mới sẽ được xác minh sau.
Nếu đã tạo trang thông tin mới trong quy trình này, bạn có thể sử dụng các API xác minh để bắt đầu xác minh trang thông tin. Để biết thêm thông tin, hãy xem phần Quản lý quy trình xác minh.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eThe GoogleLocations API helps determine if a Business Profile location has been claimed, allowing for access requests or creation of new listings.\u003c/p\u003e\n"],["\u003cp\u003eUse the API to search for existing locations, initiate access requests if claimed, or create new listings if unclaimed.\u003c/p\u003e\n"],["\u003cp\u003eIf a new listing is created, leverage verification APIs to complete the setup process.\u003c/p\u003e\n"],["\u003cp\u003eThis API is intended for managing locations with existing business relationships and should not be used for lead generation or competitive analysis.\u003c/p\u003e\n"]]],["The GoogleLocations API determines if a location is claimed in Business Profile. Using the `googleLocations.search` endpoint, provide location data to find matching locations. If a match exists, check `requestAdminRightsUrl`; if present, initiate an access request via the provided URL. If not, or if no match is found, create a new location with `accounts.locations.create`. New listings require verification through the verification APIs. This API is for merchants with business relationships, not lead generation.\n"],null,["# GoogleLocations\n\nThe GoogleLocations API allows you to see in advance whether a location has been\nclaimed in Business Profile. This way, if the location has been claimed, you can immediately\nrequest access to the location. Also, if you manage bulk-verified accounts, you can more accurately\nselect potential matches in advance and avoid the creation of duplicate locations.\n\nThe API endpoint returns a URL that indicates if a location has already been claimed. If it has\nbeen claimed, the same URL allows you to start the access request process.\n\nThe following image provides an overview of the process to gain ownership of a location.\n**Figure 1.** Swimlane diagram of Business Profile location ownership\n\nThe following steps allow you to use the `GoogleLocations` API:\n\n1. Collect location data from the merchant.\n2. Call the\n [`googleLocations.search`](/my-business/reference/businessinformation/rest/v1/googleLocations)\n endpoint. Provide the location data within the body of the call. Alternatively, you can provide\n it in a query string, similar to what a user would enter in Search or Maps. For example,\n \"Starbucks 5th ave NYC.\"\n\n The API returns a list of potentially matching locations and information about each location,\n such as `locationName` and address.\n3. Select the location that matches your location. If there are no matches, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create), and skip to step 5.\n4. Based on the state of `requestAdminRightsUrl` in the response, take the following\n actions:\n\n 1. If `requestAdminRightsUrl` exists, another user has ownership of the listing. Direct the merchant to the URL to start a request for access and ownership of the existing location in Business Profile.\n 2. If `requestAdminRightsUrl` doesn't exist, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create) and create a new listing that will be verified later.\n5. If you created new listings as part of this process, you can utilize the verification APIs to begin verification of the listings. For more information, see [Manage verification](/my-business/content/manage-verification).\n\n| **Note:** The GoogleLocations API is intended to find the status of locations for which your company has a business relationship with the merchant. The use of the endpoints for the purposes of lead generation or competitive analysis is against [Google's policies](/my-business/content/policies#prohibited_practices) and will result in revocation of API access."]]
