Tài liệu này chứa thông tin uỷ quyền dành riêng cho API Trung tâm thông báo và thông tin xác thực. Trước khi đọc tài liệu này, hãy nhớ đọc Thông tin uỷ quyền và xác thực chung của Google Workspace tại Tìm hiểu về tính năng 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 nào sẽ hiển thị cho người dùng và người đánh giá ứng dụng, cũng như đăng ký ứng dụng của bạn để bạn có thể xuất bản sau này.
Phạm vi của API Báo cáo
Để 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 uỷ 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 trên Google Workspace, loại dữ liệu mà ứng dụng truy cập và cấp truy cập. Phạm vi là những yêu cầu mà ứng dụng của bạn yêu cầu để làm việc với dữ liệu trong Google Workspace, bao gồm cả của người dùng dữ liệu trong Tài khoản Google.
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 phạm vi đã sử dụng theo ứng dụng. Thông thường, bạn nên chọn phạm vi có độ tập trung hẹp nhất 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 có thêm 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 Báo cáo hỗ trợ các phạm vi sau:
| Phạm vi | Ý nghĩa |
|---|---|
https://www.googleapis.com/auth/admin.reports.audit.readonly |
Xem báo cáo kiểm tra cho miền Google Workspace của bạn |
https://www.googleapis.com/auth/admin.reports.usage.readonly |
Xem báo cáo sử dụng cho miền Google Workspace của bạn |