Tài liệu này chứa thông tin xác thực và uỷ quyền dành riêng cho API Đại lý. 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 trong 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 để ủy 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 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 của bạn để bạn có thể phát hành sau.
Phạm vi API của đại lý
Để xác định cấp truy cập được cấp cho ứng dụng của mình, bạn cần xác định và khai báo phạm vi cấp quyền. Phạm vi uỷ quyền là một chuỗi URI OAuth 2.0 có 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à các yêu cầu mà ứng dụng của bạn yêu cầu để 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 cài đặt ứng dụng, người dùng sẽ được yêu cầu xác thực các phạm vi mà ứng dụng dùng. Nhìn 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 không cần. Người dùng dễ dàng cấp quyền truy cập vào các phạm vi giới hạn, được mô tả rõ ràng.
API Đại lý hỗ trợ các phạm vi sau:
| Phạm vi | Ý nghĩa |
|---|---|
https://www.googleapis.com/auth/apps.order |
Phạm vi toàn cầu để truy cập vào tất cả các hoạt động của API Đại lý. |
https://www.googleapis.com/auth/admin.directory.user |
Phạm vi chung để truy cập vào tất cả các thao tác của người dùng và email đại diện của người dùng. |
https://www.googleapis.com/auth/siteverification |
Phạm vi toàn cầu cho quyền đọc đầy đủ đối với trang web đã xác minh hiện có và khả năng xác minh các trang web mới. |