Tài liệu này chứa thông tin uỷ quyền và xác thực dành riêng cho Drive Labels API. Trước khi đọc tài liệu này, hãy nhớ đọc thông tin chung về việc xác thực và uỷ quyền của Google Workspace tại Tìm hiểu về việc xác thực và uỷ quyền.
Định cấu hình OAuth 2.0 để uỷ quyền
Định cấu hình màn hình đồng ý OAuth và chọn phạm vi để xác định thông tin nào sẽ hiển thị cho người dùng và người đánh giá ứng dụng, đồng thời đăng ký ứng dụng để bạn có thể xuất bản ứng dụng sau này.
Phạm vi Google Drive Labels API
Để xác định cấp truy cập được cấp cho ứng dụng của bạn, bạn cần xác định và khai báo phạm vi uỷ quyền. Phạm vi uỷ quyền là một chuỗi URI OAuth 2.0 chứa tên ứng dụng Google Workspace, loại dữ liệu mà ứng dụng đó truy cập và cấp độ truy cập. Phạm vi là yêu cầu của ứng dụng để xử lý dữ liệu trên Google Workspace, bao gồm cả dữ liệu Tài khoản Google của người dùng.
Khi ứng dụng của bạn được cài đặt, người dùng sẽ được yêu cầu xác thực các phạm vi mà ứng dụng sử dụng. Nói chung, bạn nên chọn phạm vi tập trung hẹp nhất có thể và tránh yêu cầu các phạm vi mà ứng dụng của bạn không cần. Người dùng sẵn sàng cấp quyền truy cập vào các phạm vi có giới hạn và được mô tả rõ ràng.
Nếu có thể, bạn nên sử dụng các phạm vi không nhạy cảm vì phạm vi này cấp quyền truy cập theo từng tệp và thu hẹp quyền truy cập vào chức năng cụ thể mà ứng dụng cần.
Bạn có thể dùng các phạm vi OAuth 2.0 sau đây để đọc, tìm kiếm và sửa đổi siêu dữ liệu nhãn được áp dụng cho các mục trên Drive:
| Phạm vi | Ý nghĩa |
|---|---|
|
Đọc, tìm kiếm và sửa đổi siêu dữ liệu nhãn được áp dụng cho các mục trên Drive. |
|
Đọc và tìm kiếm siêu dữ liệu nhãn được áp dụng cho các mục trên Drive mà ứng dụng được uỷ quyền. |
Để biết thêm thông tin, hãy xem Phạm vi truy cập OAuth 2.0 của Drive API và Uỷ quyền dành riêng cho Drive API.
Phạm vi cho nhãn
Bạn có thể sử dụng các phạm vi OAuth sau đây để xem và quản lý nhãn:
| Phạm vi | Ý nghĩa |
|---|---|
https://www.googleapis.com/auth/drive.labels
|
Xem, sử dụng và quản lý nhãn trên Drive.
|
https://www.googleapis.com/auth/drive.labels.readonly
|
Xem và sử dụng nhãn của Drive.
|
https://www.googleapis.com/auth/drive.admin.labels
|
Xem, chỉnh sửa, tạo và xoá tất cả các nhãn trên Drive trong tổ chức của bạn, cũng như xem các chính sách quản trị liên quan đến nhãn của tổ chức.
|
https://www.googleapis.com/auth/drive.admin.labels.readonly
|
Xem tất cả các nhãn trên Drive và các chính sách quản trị liên quan đến nhãn trong tổ chức của bạn.
|
Quyền quản trị
Để quản lý nhãn ADMIN, bạn phải chỉ định:
useAdminAccesslàtrueđể sử dụng thông tin đăng nhập quản trị viên của người dùng.- Quản trị viên tài khoản có đặc quyền Quản lý nhãn.
useAdminAccess
Quản trị viên phải đặt tham số useAdminAccess để thực thi đặc quyền quản trị. Chế độ cài đặt useAdminAccess cho phép xem và chỉnh sửa mọi nhãn thuộc sở hữu của khách hàng. Định mức này bao gồm cả Nhãn ADMIN và SHARED.
Khi useAdminAccess không được đặt, các yêu cầu ghi chỉ được phép đối với những nhãn có cả SHARED label type và đối với những người dùng có vai trò EDITOR phù hợp cho nhãn này.
Để biết thêm thông tin, hãy xem bài viết Tạo thông tin đăng nhập để truy cập.