Google Business Performance API 的新 API 方法可通过单个 API 请求提取多个 `DailyMetrics`。 请查看弃用时间表和相关说明,并从 v4 reportInsights API 方法迁移至 Google Business Profile Performance API。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[[["\u003cp\u003eThis guide outlines best practices for managing multiple business locations and user permissions within the Google My Business ecosystem.\u003c/p\u003e\n"],["\u003cp\u003eFour account types are key to managing locations: Personal, Organization, Location Group, and User Group accounts.\u003c/p\u003e\n"],["\u003cp\u003eLocation Groups allow for bulk management of individual locations and categorization by chain, region, or category.\u003c/p\u003e\n"],["\u003cp\u003eUser Groups enable efficient permission management by granting access to multiple location groups for personal accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe My Business Account Management API allows programmatic creation, management, and retrieval of account information and related locations.\u003c/p\u003e\n"]]],["This document outlines managing multiple business locations using different account types: personal, organization, location group, and user group. Personal accounts manage organization accounts, gaining access to user and location groups. Organization accounts house location and user groups. Location groups manage multiple locations, allowing bulk actions and permission inheritance. User groups enable scalable permission management by granting access to location groups, simplifying team management. The API allows creation, management, and listing of all account types and their associated locations.\n"],null,["# Manage locations at scale\n\n\u003cbr /\u003e\n\nAs your organization grows, management of your locations and permissions can\noverwhelm you. This guide details the best practices to manage multiple\nlocations, and describes the following account types:\n\n- [Personal account](#personal_account)\n- [Organization account](#organization_account)\n- [Location group account](#location_group_account)\n- [User group account](#user_group_account)\n\nAccount types\n-------------\n\nEach account type has a role in the management of locations. A personal account\ncan manage an organization account, and then gain permissions to the user groups\nand locations groups in that organization. The personal account can then manage\nlocations and listings through the associated location groups.\n\n### Personal account\n\nA personal account is automatically available to you when you create a\n[Google account](https://myaccount.google.com/). Personal accounts\ncan be\n[owners and managers of listings](https://support.google.com/business/answer/9178945).\n\n### Organization account\n\nAn\n[organization account](https://support.google.com/business/answer/7663063)\nis the overlying account that represents your\n[agency](https://support.google.com/business/answer/9199701).\nYour location group and user groups are saved in it, and all members of an\norganization have access to them. Locations can be part of multiple\norganizations.\n\nWith the My Business Account Management API, you can use the\n[`accounts.admins.create`](/my-business/reference/accountmanagement/rest/v1/accounts.admins/create)\nmethod to invite personal accounts to manage or own the organization account.\n\n### Location group account\n\nA\n[location group](https://support.google.com/business/answer/7655842)\nis used to manage a group of individual locations. You can use a location group\nto perform bulk tasks to multiple locations. When you add personal accounts and\nuser groups to a location group, they inherit the location group's permissions.\n\nYou can also create location groups to categorize locations, such as by chain,\nregion, or category. Locations can be in multiple location groups at once.\n| **Note:** A personal account that belongs to an organization or user group isn't eligible to directly own a location or location group.\n\nWith the My Business Account Management API, you can use the\n[`accounts.create`](/my-business/reference/accountmanagement/rest/v1/accounts/create) method to\ncreate location groups, and\n[transfer locations](/my-business/content/transfer-locations) to a location\ngroup. You can also invite personal accounts to\n[manage location groups](/my-business/content/manage-admins) with the API. User\ngroups can be directly added to location groups from the web interface.\n\n### User group account\n\nTo manage permissions at scale, use a\n[user group](https://support.google.com/business/answer/7655731).\nYou can add personal accounts to a user group. Then, you can grant the user\ngroup management access to multiple location groups in the organization. Now all\nthe personal accounts in the user group can perform managerial actions on the\nlocations under the location groups.\n| **Note:** It's best not to add personal accounts to a location group. Instead, grant user groups access directly. This is an easier way to manage at scale.\n\nFor example, when a new member joins an operations team, you can add them\ndirectly to a user group and they immediately have access to all the locations\nthat their peers have access to. It takes longer to grant users access to each\nindividual location, and is more difficult to manage that way.\n\nWith the My Business Account Management API, you can use the\n[`accounts.create`](/my-business/reference/accountmanagement/rest/v1/accounts/create) method to\ncreate user groups. You can also use the API to invite personal accounts to\n[manage admins for accounts and locations](/my-business/content/manage-admins).\n\nUse the API to call a list of all accounts\n------------------------------------------\n\nTo list all accounts that you have access to, and their associated account types,\ncall the [`accounts.list`](/my-business/reference/accountmanagement/rest/v1/accounts/list) method\nwith your [OAuth credentials](/my-business/content/implement-oauth). The\nresponse contains a list of all the accounts, their account IDs,\nwhich are present in the *name* field, and the account types.\n\n### Request\n\nThe following is an\n[`accounts.list`](/my-business/reference/accountmanagement/rest/v1/accounts/list) request example:\nHTTP \n\n```\nGET\nhttps://mybusinessaccountmanagement.googleapis.com/v1/accounts\nAuthorization: Bearer \u003caccess_token\u003e\n```\n\n### Response\n\nThe following is an\n[`accounts.list`](/my-business/reference/accountmanagement/rest/v1/accounts/list) response example: \n\n```carbon\n{\n \"accounts\": [\n {\n \"name\": \"accounts/\u003cvar translate=\"no\"\u003e{accountId}\u003c/var\u003e\",\n \"accountName\": \"John Doe\",\n \"type\": \"PERSONAL\",\n \"state\": {\n \"status\": \"UNVERIFIED\"\n },\n \"profilePhotoUrl\": \"//lh5.googleusercontent.com/REDACTED\"\n },\n {\n \"name\": \"accounts/\u003cvar translate=\"no\"\u003e{accountId}\u003c/var\u003e\",\n \"accountName\": \"John Doe's Location Group\",\n \"type\": \"LOCATION_GROUP\",\n \"role\": \"OWNER\",\n \"state\": {\n \"status\": \"UNVERIFIED\"\n },\n \"accountNumber\": \"\u003cvar translate=\"no\"\u003e{accountNumber}\u003c/var\u003e\",\n \"permissionLevel\": \"OWNER_LEVEL\"\n }\n ]\n}\n```\n\nAll the account types detailed in this guide might be included in the response\nto your\n[`accounts.list`](/my-business/reference/accountmanagement/rest/v1/accounts/list) request. Review\nthe account list and identify the specific account that has access to the\nlocations that you want to manage. Then, call\n[`accounts.locations.list`](/my-business/reference/businessinformation/rest/v1/accounts.locations/list)\nwith the *name* field of the specific account in order to retrieve a list of\nlocations that that account has access to.\n\nFor instance, if you want to retrieve all locations that belong to \"John Doe's\nLocation Group,\" make the following request:\nHTTP \n\n```\nGET\nhttps://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations\nAuthorization: Bearer \u003caccess_token\u003e\n```\n\nThe response returns a list of locations that the user has access to, as\nfollows: \n\n```text\n{\n \"locations\": [\n {\n \"name\": \"locations/{locationId}\",\n \"locationName\": \"Test Business\",\n ...\n },\n {\n \"name\": \"locations/{locationId}\",\n \"locationName\": \"2nd Test Business\",\n ...\n }\n ]\n}\n```\n\nLocation management diagram\n---------------------------\n\nThe following diagram illustrates the following:\n\n- Organizations can contain multiple user groups.\n- User groups can manage multiple location groups.\n- Location groups can contain multiple locations.\n- Locations can span multiple location groups across organizations.\n\n**Figure 1.** Location management hierarchy"]]