Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
REST Resource: accounts.admins
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: 관리자
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
변경할 수 없습니다. 이 관리자가 참조하는 계정 리소스의 이름입니다. locations.admins.create를 호출하여 LocationGroup을 관리자로 초대할 때 사용됩니다. 이 필드와 admin 이 모두 CREATE 요청에서 설정된 경우 이 필드가 우선하며 admin 의 이메일 주소는 무시됩니다. 형식: accounts/{account}
|
role |
enum (AdminRole )
필수 항목입니다. 이 관리자가 지정된 계정 또는 위치에 사용하는 역할을 지정합니다.
|
pendingInvitation |
boolean
출력 전용입니다. 지정된 리소스에 대해 대기 중인 초대가 이 관리자에게 있는지 여부를 나타냅니다.
|
AdminRole
관리자가 갖는 액세스 수준을 나타냅니다. 자세한 내용은 고객센터 도움말을 참고하세요.
열거형 |
ADMIN_ROLE_UNSPECIFIED |
지정되지 않음 |
PRIMARY_OWNER |
관리자는 소유자 수준의 액세스 권한을 가지며 기본 소유자입니다. (UI에서 '기본 소유자'로 표시됩니다.) |
OWNER |
관리자에게 소유자 수준의 액세스 권한이 있습니다. (UI에서 '소유자'로 표시됩니다.) |
MANAGER |
관리자에게 관리 액세스 권한이 있습니다. |
SITE_MANAGER |
관리자는 소셜 (Google+) 페이지를 관리할 수 있습니다. UI에 '사이트 관리자'로 표시됩니다. 이 API에서는 SITE_MANAGER 역할이 있는 계정 관리자를 만들 수 없습니다. |
메서드 |
|
지정된 사용자를 지정된 계정의 관리자로 초대합니다. |
|
지정된 계정에서 지정된 관리자를 삭제합니다. |
|
지정된 계정의 관리자를 나열합니다. |
|
지정된 계정 관리자의 관리자를 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\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. |"]]