Khi tổ chức của bạn phát triển, việc quản lý vị trí và quyền của bạn có thể làm bạn choáng ngợp. Hướng dẫn này trình bày chi tiết các phương pháp hay nhất để quản lý nhiều địa điểm và mô tả các loại tài khoản sau:
Loại tài khoản
Mỗi loại tài khoản đều có một vai trò trong việc quản lý địa điểm. Tài khoản cá nhân có thể quản lý tài khoản tổ chức, sau đó nhận quyền đối với các nhóm người dùng và nhóm vị trí trong tổ chức đó. Sau đó, tài khoản cá nhân có thể quản lý vị trí và danh sách thông qua các nhóm vị trí được liên kết.
Tài khoản cá nhân
Khi bạn tạo một tài khoản cá nhân, Tài khoản Google. Tài khoản cá nhân có thể chủ sở hữu và người quản lý trang thông tin.
Tài khoản tổ chức
Một tài khoản tổ chức là tài khoản nằm ngoài đại diện cho đại lý. Nhóm vị trí và nhóm người dùng của bạn sẽ được lưu trong đó và tất cả thành viên của một tổ chức của bạn sẽ có quyền truy cập vào các công cụ đó. Các vị trí có thể là một phần của nhiều tổ chức.
Với API Quản lý tài khoản doanh nghiệp của tôi, bạn có thể sử dụng
accounts.admins.create
để mời các tài khoản cá nhân quản lý hoặc sở hữu tài khoản tổ chức.
Tài khoản nhóm địa điểm
Đáp nhóm vị trí được dùng để quản lý một nhóm các vị trí riêng lẻ. Bạn có thể dùng một nhóm vị trí để thực hiện nhiều tác vụ hàng loạt cho nhiều vị trí. Khi bạn thêm tài khoản cá nhân và vào một nhóm vị trí thì họ sẽ kế thừa các quyền của nhóm vị trí đó.
Bạn cũng có thể tạo các nhóm vị trí để phân loại vị trí, chẳng hạn như theo chuỗi, khu vực hoặc danh mục. Bạn có thể đưa các vị trí vào nhiều nhóm vị trí cùng một lúc.
Với API Quản lý tài khoản doanh nghiệp của tôi, bạn có thể sử dụng
Phương thức accounts.create để
tạo nhóm địa điểm và
chuyển vị trí đến một vị trí
nhóm. Bạn cũng có thể mời các tài khoản cá nhân
quản lý các nhóm vị trí bằng API. Người dùng
bạn có thể thêm trực tiếp nhóm địa điểm vào nhóm địa điểm từ giao diện web.
Tài khoản nhóm người dùng
Để quản lý quyền trên quy mô lớn, hãy sử dụng nhóm người dùng. Bạn có thể thêm tài khoản cá nhân vào một nhóm người dùng. Sau đó, bạn có thể cấp cho người dùng quyền truy cập quản lý nhóm vào nhiều nhóm vị trí trong tổ chức. Hiện đã có tất cả tài khoản cá nhân trong nhóm người dùng có thể thực hiện các hành động quản lý trên trong các nhóm địa điểm.
Ví dụ: khi một thành viên mới tham gia nhóm vận hành, bạn có thể thêm họ trực tiếp cho một nhóm người dùng và họ sẽ ngay lập tức có quyền truy cập vào tất cả các vị trí mà đồng nghiệp của họ có quyền truy cập. Mất nhiều thời gian hơn để cấp cho người dùng quyền truy cập vào từng vị trí riêng lẻ và khó quản lý theo cách đó.
Với API Quản lý tài khoản doanh nghiệp của tôi, bạn có thể sử dụng
Phương thức accounts.create để
tạo nhóm người dùng. Bạn cũng có thể sử dụng API này để mời tài khoản cá nhân
quản lý quản trị viên cho tài khoản và vị trí.
Sử dụng API để gọi danh sách tất cả tài khoản
Để liệt kê tất cả các tài khoản mà bạn có quyền truy cập và các loại tài khoản được liên kết,
gọi phương thức accounts.list
bằng thông tin đăng nhập OAuth của bạn. Chiến lược phát hành đĩa đơn
chứa danh sách tất cả các tài khoản, mã tài khoản của các tài khoản đó,
có trong trường name (tên) và trong các loại tài khoản.
Yêu cầu
Sau đây là một
Ví dụ về yêu cầu accounts.list:
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts Authorization: Bearer <access_token>
Phản hồi
Sau đây là một
Ví dụ về phản hồi accounts.list:
{
"accounts": [
{
"name": "accounts/{accountId}",
"accountName": "John Doe",
"type": "PERSONAL",
"state": {
"status": "UNVERIFIED"
},
"profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
},
{
"name": "accounts/{accountId}",
"accountName": "John Doe’s Location Group",
"type": "LOCATION_GROUP",
"role": "OWNER",
"state": {
"status": "UNVERIFIED"
},
"accountNumber": "{accountNumber}",
"permissionLevel": "OWNER_LEVEL"
}
]
}
Tất cả các loại tài khoản được nêu chi tiết trong hướng dẫn này có thể được đưa vào câu trả lời
đến
Yêu cầu accounts.list. Bài đánh giá
danh sách tài khoản và xác định tài khoản cụ thể có quyền truy cập vào
mà bạn muốn quản lý. Sau đó, gọi
accounts.locations.list
với trường name của tài khoản cụ thể để truy xuất danh sách
mà tài khoản đó có quyền truy cập.
Ví dụ: nếu bạn muốn truy xuất tất cả các vị trí thuộc về "trang web của John Doe Nhóm vị trí", thực hiện yêu cầu sau:
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>
Phản hồi trả về danh sách vị trí mà người dùng có quyền truy cập, như sau:
{
"locations": [
{
"name": "locations/{locationId}",
"locationName": "Test Business",
...
},
{
"name": "locations/{locationId}",
"locationName": "2nd Test Business",
...
}
]
}
Sơ đồ quản lý vị trí
Sơ đồ dưới đây minh hoạ những điều sau:
- Tổ chức có thể chứa nhiều nhóm người dùng.
- Các nhóm người dùng có thể quản lý nhiều nhóm địa điểm.
- Các nhóm địa điểm có thể chứa nhiều vị trí.
- Địa điểm có thể nằm trong nhiều nhóm địa điểm của các tổ chức.
