Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
REST Resource: accounts.admins
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:Admin
JSON 表示法 |
{
"name": string,
"admin": string,
"account": string,
"role": enum (AdminRole ),
"pendingInvitation": boolean
} |
欄位 |
name |
string
不可變動。資源名稱。如果您是帳戶管理員,請填寫下方表單:accounts/{account_id}/admins/{admin_id} 如果是營業地點管理員,請使用下列格式:locations/{locationId}/admins/{admin_id} 如果在管理員建立過程中設定,系統會忽略這個欄位。
|
admin |
string
選用設定。管理員的名稱。最初發出邀請時,這是邀請對象的電子郵件地址。在 GET 呼叫中,如果邀請仍待處理,系統會傳回使用者的電子郵件地址。否則會包含使用者的姓名。 只有在管理員建立時,才需要設定這個欄位。
|
account |
string
不可變動。此管理員參照的帳戶資源名稱。呼叫 location.admins.create 以邀請 LocationGroup 為管理員。 如果 CREATE 要求中同時設定這個欄位和 admin ,則系統會優先採用這個欄位,並忽略 admin 中的電子郵件地址。 格式:accounts/{account} 。
|
role |
enum (AdminRole )
必要欄位。指定這位管理員用於指定帳戶或位置的角色。
|
pendingInvitation |
boolean
僅供輸出。指出此管理員是否有待處理的指定資源的邀請。
|
AdminRole
列舉 |
ADMIN_ROLE_UNSPECIFIED |
不指定。 |
PRIMARY_OWNER |
管理員具備擁有者層級存取權,且是主要擁有者。(在 UI 中顯示為「主要擁有者」)。 |
OWNER |
管理員具備擁有者層級存取權。(在 UI 中顯示為「擁有者」)。 |
MANAGER |
管理員具備管理員權限。 |
SITE_MANAGER |
管理員可以管理社交 (Google+) 專頁。(在使用者介面中顯示為「網站管理員」。這個 API 不允許建立具備「SITE_MANAGER」角色的帳戶管理員。 |
方法 |
|
邀請指定使用者成為指定帳戶的管理員。 |
|
從指定帳戶中移除指定的管理員。 |
|
列出指定帳戶的管理員。 |
|
更新指定帳戶管理員的管理員。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eAn Admin is an administrator of an Account or a location with different access levels defined by \u003ccode\u003eAdminRole\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAdmins can have roles like Primary Owner, Owner, Manager, and Site Manager, each with varying permissions.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage Admins by inviting, removing, listing, and updating them using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eAdmin details include name, role, account association, and pending invitation status, represented in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAdminRole\u003c/code\u003e enum defines the access level of an admin, impacting their capabilities within the account or location.\u003c/p\u003e\n"]]],["Account and location administrators, identified by a resource name, have roles like `PRIMARY_OWNER`, `OWNER`, `MANAGER`, or `SITE_MANAGER`. Admins can be created by inviting a user via email, and roles are set during creation. The `pendingInvitation` field shows if an invite is pending. Available actions include: creating, deleting, listing, and updating admin access. `Admin` field contains the invitee's email address initially or user details after accepting.\n"],null,["# REST Resource: accounts.admins\n\n- [Resource: Admin](#Admin)\n - [JSON representation](#Admin.SCHEMA_REPRESENTATION)\n - [AdminRole](#Admin.AdminRole)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Admin\n---------------\n\nAn administrator of an Account or a location.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"admin\": string, \"account\": string, \"role\": enum (/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin.AdminRole), \"pendingInvitation\": boolean } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Immutable. The resource name. For account admins, this is in the form: `accounts/{account_id}/admins/{admin_id}` For location admins, this is in the form: `locations/{locationId}/admins/{admin_id}` This field will be ignored if set during admin creation. |\n| `admin` | `string` Optional. The name of the admin. When making the initial invitation, this is the invitee's email address. On `GET` calls, the user's email address is returned if the invitation is still pending. Otherwise, it contains the user's first and last names. This field is only needed to be set during admin creation. |\n| `account` | `string` Immutable. The name of the Account resource that this Admin refers to. Used when calling locations.admins.create to invite a LocationGroup as an admin. If both this field and `admin` are set on `CREATE` requests, this field takes precedence and the email address in `admin` will be ignored. Format: `accounts/{account}`. |\n| `role` | `enum (`[AdminRole](/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin.AdminRole)`)` Required. Specifies the role that this admin uses with the specified Account or Location. |\n| `pendingInvitation` | `boolean` Output only. Indicates whether this admin has a pending invitation for the specified resource. |\n\n### AdminRole\n\nIndicates the access level that an admin has. For more information, see the [help center article](https://support.google.com/business/answer/3403100)\n\n| Enums ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ADMIN_ROLE_UNSPECIFIED` | Not specified. |\n| `PRIMARY_OWNER` | The admin has owner-level access and is the primary owner. (Displays as 'Primary Owner' in UI). |\n| `OWNER` | The admin has owner-level access. (Displays as 'Owner' in UI). |\n| `MANAGER` | The admin has managerial access. |\n| `SITE_MANAGER` | The admin can manage social (Google+) pages. (Displays as 'Site Manager' in UI). This API doesn't allow creating an account admin with a SITE_MANAGER role. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|\n| ### [create](/my-business/reference/accountmanagement/rest/v1/accounts.admins/create) | Invites the specified user to become an administrator for the specified account. |\n| ### [delete](/my-business/reference/accountmanagement/rest/v1/accounts.admins/delete) | Removes the specified admin from the specified account. |\n| ### [list](/my-business/reference/accountmanagement/rest/v1/accounts.admins/list) | Lists the admins for the specified account. |\n| ### [patch](/my-business/reference/accountmanagement/rest/v1/accounts.admins/patch) | Updates the Admin for the specified Account Admin. |"]]