Chọn phạm vi API Google Trang trình bày

Tài liệu này chứa thông tin uỷ quyền và xác thực dành riêng cho Google Slides 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 Slides 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 các tính năng cụ thể mà ứng dụng cần.

Slides API hỗ trợ các phạm vi sau:

Mã phạm vi Mô tả Cách sử dụng
https://www.googleapis.com/auth/presentations Xem, chỉnh sửa, tạo và xoá tất cả bản trình bày của bạn trên Google Trang trình bày. Nhạy cảm
https://www.googleapis.com/auth/presentations.readonly Xem tất cả bản trình bày của bạn trên Google Trang trình bày. Nhạy cảm
https://www.googleapis.com/auth/spreadsheets Xem, chỉnh sửa, tạo và xoá tất cả bảng tính của bạn trên Google Trang tính. Nhạy cảm
https://www.googleapis.com/auth/spreadsheets.readonly Xem tất cả bảng tính của bạn trên Google Trang tính. Nhạy cảm
https://www.googleapis.com/auth/drive.file Chỉ xem, chỉnh sửa, tạo và xoá các tệp trên Google Drive mà bạn sử dụng với ứng dụng này. Nên dùng
Không nhạy cảm
https://www.googleapis.com/auth/drive Xem, chỉnh sửa, tạo và xoá tất cả tệp của bạn trên Google Drive. Bị hạn chế
https://www.googleapis.com/auth/drive.readonly Xem và tải tất cả tệp của bạn trên Google Drive xuống. Bị hạn chế

Cột Mức sử dụng trong bảng cho biết mức độ nhạy cảm của từng phạm vi, theo các định nghĩa sau:

  • Không nhạy cảm: Các phạm vi này cung cấp phạm vi nhỏ nhất cho quyền truy cập uỷ quyền và chỉ yêu cầu xác minh ứng dụng cơ bản. Để biết thông tin về yêu cầu này, hãy xem bài viết Gửi ứng dụng để xác minh.

  • Nhạy cảm: Các phạm vi này cung cấp quyền truy cập vào Dữ liệu người dùng cụ thể trên Google mà người dùng cho phép ứng dụng của bạn truy cập. Bạn cần phải trải qua quy trình xác minh ứng dụng bổ sung. Để biết thông tin về yêu cầu này, hãy xem bài viết Yêu cầu về phạm vi nhạy cảm và bị hạn chế.

  • Bị hạn chế: Các phạm vi này cung cấp quyền truy cập rộng rãi vào Dữ liệu người dùng trên Google và yêu cầu bạn phải trải qua quy trình xác minh phạm vi bị hạn chế. Để biết thông tin về yêu cầu này, hãy xem Chính sách dữ liệu người dùng của các dịch vụ API của Google và Các yêu cầu bổ sung đối với phạm vi API cụ thể. Nếu lưu trữ dữ liệu thuộc phạm vi bị hạn chế trên máy chủ (hoặc truyền dữ liệu), thì bạn phải trải qua quy trình đánh giá bảo mật.

Nếu ứng dụng của bạn cần có quyền truy cập vào bất kỳ API nào khác của Google, bạn cũng có thể thêm các phạm vi đó. Để biết thêm thông tin về các phạm vi API của Google, hãy xem bài viết Sử dụng OAuth 2.0 để truy cập vào các API của Google.

Để biết thêm thông tin về các phạm vi OAuth 2.0 cụ thể, hãy xem Phạm vi OAuth 2.0 cho các API của Google.