Chọn phạm vi API Nhãn Google Drive

Tài liệu này chứa thông tin xác thực và uỷ quyền 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 xác thực và uỷ quyền chung của Google Workspace tại bài viết Tìm hiểu về quy trình 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 xin phép bằng OAuth và chọn phạm vi để xác định thông tin 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 sau này.

Phạm vi của Google Drive Labels API

Để xác định cấp truy cập được cấp cho ứng dụng, 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 để hoạt động với dữ liệu Google Workspace, bao gồm cả dữ liệu trong Tài khoản Google của người dùng.

Khi ứng dụng đượ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. Thông thường, bạn nên chọn phạm vi hẹp nhất có thể và tránh yêu cầu các phạm vi mà ứng dụng 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 mô tả rõ ràng và có giới hạn.

Khi 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ể sử 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
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
Đọ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.
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.metadata.readonly
Đọ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 được uỷ quyền cho ứng dụng.

Để biết thêm thông tin, hãy xem Phạm vi OAuth 2.0 của API Drive và Uỷ quyền dành riêng cho API Drive.

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.
  • Phạm vi này cho phép người dùng truy cập và là bắt buộc đối với các thao tác ghi khi use_admin_access không được đặt.
  • Các thao tác ghi có phạm vi này hợp lệ đối với nhãn có SHARED loại nhãn.
https://www.googleapis.com/auth/drive.labels.readonly Xem và sử dụng nhãn trên Drive.
  • Phạm vi này cho phép người dùng truy cập và là bắt buộc đối với các thao tác đọc khi use_admin_access không được đặt.
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 thuộc 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.
  • Phạm vi này cho phép quản trị viên truy cập và là bắt buộc đối với các thao tác ghi khi use_admin_access được đặt. Phạm vi này cũng cấp quyền truy cập để đọc.
  • Các thao tác ghi có phạm vi này hợp lệ đối với nhãn có loại nhãn SHARED hoặc ADMIN .
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 thuộc tổ chức của bạn.
  • Phạm vi này cho phép quyền quản trị và là bắt buộc đối với các thao tác đọc khi use_admin_access được đặt.

Quyền truy cập của quản trị viên

Để quản lý nhãn ADMIN, bạn phải chỉ định:

  • useAdminAccess là true để sử dụng thông tin xác thực của 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 để gọi đặc quyền của quản trị viên. Việc đặt useAdminAccess cho phép xem và chỉnh sửa mọi nhãn do khách hàng sở hữu. Điều này bao gồm cả nhãn ADMIN và SHARED.

Khi useAdminAccess không được đặt, chỉ những nhãn có cả SHARED label type và người dùng có vai trò EDITOR phù hợp cho nhãn này mới được phép thực hiện yêu cầu ghi.

Để biết thêm thông tin, hãy xem bài viết Tạo thông tin xác thực truy cập.