REST Resource: locations.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.
|
Phương thức |
|
Mời người dùng được chỉ định trở thành quản trị viên của vị trí được chỉ định. |
|
Xóa vai trò quản trị viên được chỉ định làm người quản lý của vị trí được chỉ định. |
|
Liệt kê tất cả quản trị viên của vị trí đã chỉ định. |
|
Cập nhật Bảng điều khiển dành cho quản trị viên cho vị trí đượ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 an immutable resource name and a role specifying their access level.\u003c/p\u003e\n"],["\u003cp\u003eAdmins can be invited, removed, listed, and updated for specific locations using provided methods.\u003c/p\u003e\n"],["\u003cp\u003eAdmin creation requires the \u003ccode\u003erole\u003c/code\u003e field, while optional fields include the admin's name/email and associated account.\u003c/p\u003e\n"],["\u003cp\u003eA pending invitation status is indicated for each admin, along with whether it's for an Account or Location.\u003c/p\u003e\n"],["\u003cp\u003eAdmins for Accounts are in the form \u003ccode\u003eaccounts/{account_id}/admins/{admin_id}\u003c/code\u003e and for Locations are in the form \u003ccode\u003elocations/{locationId}/admins/{admin_id}\u003c/code\u003e.\u003c/p\u003e\n"]]],["Admins, representing administrators of an Account or location, are managed via various methods. Key actions include: `create`, which invites a user to be a location administrator; `delete`, which removes an admin; `list`, to view all location admins; and `patch`, to update admin details. An admin's JSON representation includes their name, role, account affiliation, and pending invitation status. Fields such as `name`, `admin`, `account`, `role`, and `pendingInvitation` are described with their type and usage.\n"],null,["# REST Resource: locations.admins\n\n- [Resource: Admin](#Admin)\n - [JSON representation](#Admin.SCHEMA_REPRESENTATION)\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| Methods ------- ||\n|----------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|\n| ### [create](/my-business/reference/accountmanagement/rest/v1/locations.admins/create) | Invites the specified user to become an administrator for the specified location. |\n| ### [delete](/my-business/reference/accountmanagement/rest/v1/locations.admins/delete) | Removes the specified admin as a manager of the specified location. |\n| ### [list](/my-business/reference/accountmanagement/rest/v1/locations.admins/list) | Lists all of the admins for the specified location. |\n| ### [patch](/my-business/reference/accountmanagement/rest/v1/locations.admins/patch) | Updates the Admin for the specified location. |"]]