REST Resource: accounts.admins
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.
Tài nguyên: Quản trị viên
Quản trị viên của một Tài khoản hoặc một vị trí.
| Biểu diễn dưới dạng JSON |
{
"name": string,
"admin": string,
"account": string,
"role": enum (AdminRole),
"pendingInvitation": boolean
} |
| Trường |
name |
string
Bất biến. Tên tài nguyên. Đối với quản trị viên tài khoản, thông tin này sẽ có trong biểu mẫu: accounts/{account_id}/admins/{admin_id} Đối với quản trị viên vị trí, nội dung này có trong biểu mẫu: locations/{locationId}/admins/{admin_id} Trường này sẽ bị bỏ qua nếu bạn đặt trong quá trình tạo quản trị viên.
|
admin |
string
Không bắt buộc. Tên của quản trị viên. Khi gửi lời mời ban đầu, đây là địa chỉ email của người được mời. Trong các lệnh gọi GET, địa chỉ email của người dùng sẽ được trả về nếu lời mời vẫn đang chờ xử lý. Nếu không, tên này sẽ chứa họ và tên của người dùng. Bạn chỉ cần đặt trường này trong quá trình tạo quản trị viên.
|
account |
string
Bất biến. Tên của tài nguyên tài khoản mà Quản trị viên này đề cập. Được dùng khi gọi locations.admins.create để mời một LocationGroup làm quản trị viên. Nếu cả trường này và admin được đặt trong các yêu cầu CREATE, thì trường này sẽ được ưu tiên và địa chỉ email trong admin sẽ bị bỏ qua. Định dạng: accounts/{account}.
|
role |
enum (AdminRole)
Bắt buộc. Chỉ định vai trò mà quản trị viên này sử dụng với Tài khoản hoặc Vị trí được chỉ định.
|
pendingInvitation |
boolean
Chỉ có đầu ra. Cho biết liệu quản trị viên này có lời mời đang chờ xử lý đối với tài nguyên được chỉ định hay không.
|
AdminRole
| Enum |
ADMIN_ROLE_UNSPECIFIED |
Chưa chỉ định. |
PRIMARY_OWNER |
Quản trị viên có quyền truy cập ở cấp chủ sở hữu và là chủ sở hữu chính. (Hiển thị dưới dạng "Chủ sở hữu chính" trong giao diện người dùng). |
OWNER |
Quản trị viên có quyền truy cập ở cấp chủ sở hữu. (Hiển thị dưới dạng "Chủ sở hữu" trong giao diện người dùng). |
MANAGER |
Quản trị viên có quyền quản lý. |
SITE_MANAGER |
Quản trị viên có thể quản lý các trang mạng xã hội (Google+). (Hiển thị dưới dạng "Trình quản lý địa điểm" trong giao diện người dùng). API này không cho phép tạo quản trị viên tài khoản có vai tròSITE_MANAGER. |
Phương thức |
|
|
Mời người dùng được chỉ định trở thành quản trị viên của tài khoản được chỉ định. |
|
|
Xoá quản trị viên được chỉ định khỏi tài khoản được chỉ định. |
|
|
Liệt kê các quản trị viên của tài khoản đã chỉ định. |
|
|
Cập nhật Quản trị viên cho Quản trị viên tài khoản được chỉ định. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]
