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 Lịch Google. 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 xem xét ứ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 API Lịch
Để xác định cấp quyền 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 quyền 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 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 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 hơn.
API Lịch hỗ trợ các phạm vi sau:
| Phạm vi | Ý nghĩa |
|---|---|
https://www.googleapis.com/auth/calendar |
Xem, chỉnh sửa, chia sẻ và xoá vĩnh viễn tất cả lịch mà bạn có thể truy cập bằng Lịch Google. |
https://www.googleapis.com/auth/calendar.readonly |
Xem và tải xuống bất kỳ lịch nào mà bạn có thể truy cập bằng Lịch. |
https://www.googleapis.com/auth/calendar.freebusy |
Xem tình trạng rảnh/bận của bạn trong lịch. |
https://www.googleapis.com/auth/calendar.events |
Xem và chỉnh sửa sự kiện trên tất cả các lịch. |
https://www.googleapis.com/auth/calendar.events.readonly |
Xem sự kiện trên tất cả các lịch. |
https://www.googleapis.com/auth/calendar.settings.readonly |
Xem chế độ cài đặt Lịch. |
https://www.googleapis.com/auth/calendar.addons.execute |
Chạy dưới dạng tiện ích bổ sung cho Lịch. |
https://www.googleapis.com/auth/calendar.addons.current.event.read |
Xem các sự kiện mà bạn mở trong Lịch Google. |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
Chỉnh sửa các sự kiện mà bạn mở trong Lịch Google. |
https://www.googleapis.com/auth/calendar.events.owned |
Xem, tạo, thay đổi và xoá các sự kiện trên lịch Google mà bạn sở hữu. |
https://www.googleapis.com/auth/calendar.events.owned.readonly |
Xem các sự kiện trên lịch Google mà bạn sở hữu. |
https://www.googleapis.com/auth/calendar.events.freebusy |
Xem tình trạng rảnh/bận trên lịch Google mà bạn có quyền truy cập. |
https://www.googleapis.com/auth/calendar.app.created |
Tạo lịch phụ trên Google và xem, tạo, thay đổi và xoá các sự kiện trên lịch. |
https://www.googleapis.com/auth/calendar.calendarlist |
Xem, thêm và xoá các lịch Google mà bạn đã đăng ký. |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
Xem danh sách lịch Google mà bạn đã đăng ký. |
https://www.googleapis.com/auth/calendar.calendars |
Xem, thay đổi các thuộc tính của lịch Google mà bạn có quyền truy cập và tạo lịch phụ. |
https://www.googleapis.com/auth/calendar.calendars.readonly |
Xem tiêu đề, nội dung mô tả, múi giờ mặc định và các thuộc tính khác của lịch Google mà bạn có quyền truy cập. |
https://www.googleapis.com/auth/calendar.acls |
Xem và thay đổi các quyền chia sẻ của lịch Google mà bạn sở hữu. |
https://www.googleapis.com/auth/calendar.acls.readonly |
Xem các quyền chia sẻ của lịch Google mà bạn sở hữu. |
https://www.googleapis.com/auth/calendar.events.public.readonly |
Xem các sự kiện trên lịch công khai. |