Dịch vụ Lịch nâng cao cho phép bạn sử dụng API Lịch Google công khai trong Apps Script. Tương tự như dịch vụ Lịch tích hợp của Apps Script, API này cho phép tập lệnh truy cập và sửa đổi Lịch Google của người dùng, bao gồm cả những lịch bổ sung mà người dùng đã đăng ký. Trong hầu hết các trường hợp, dịch vụ tích hợp sẵn sẽ dễ sử dụng hơn, nhưng dịch vụ nâng cao này cung cấp thêm một số tính năng, bao gồm cả việc đặt màu nền cho từng sự kiện.
Tài liệu tham khảo
Để biết thông tin chi tiết về dịch vụ này, hãy xem tài liệu tham khảo cho Google Calendar API công khai. Giống như tất cả các dịch vụ nâng cao trong Apps Script, dịch vụ Lịch nâng cao sử dụng cùng các đối tượng, phương thức và tham số như API công khai. Để biết thêm thông tin, hãy xem bài viết Cách xác định chữ ký phương thức.
Để báo cáo vấn đề và tìm thông tin hỗ trợ khác, hãy xem Hướng dẫn hỗ trợ về Lịch.
Tiêu đề yêu cầu HTTP
Dịch vụ Lịch nâng cao có thể chấp nhận các tiêu đề yêu cầu HTTP If-Match
và If-None-Match
. Để biết thông tin chi tiết, hãy xem tài liệu tham khảo.
Mã mẫu
Mã mẫu bên dưới sử dụng phiên bản 3 của API.
Tạo sự kiện
Ví dụ sau đây minh hoạ cách tạo một sự kiện trong lịch mặc định của người dùng.
Liệt kê lịch
Ví dụ sau đây minh hoạ cách truy xuất thông tin chi tiết về các lịch xuất hiện trong danh sách lịch của người dùng.
Liệt kê các sự kiện
Ví dụ sau đây minh hoạ cách liệt kê 10 sự kiện sắp tới tiếp theo trong lịch mặc định của người dùng.
Sửa đổi sự kiện có điều kiện
Ví dụ sau đây cho thấy cách cập nhật có điều kiện một sự kiện trên Lịch bằng tiêu đề If-Match
. Tập lệnh này sẽ tạo một sự kiện mới, đợi 30 giây, sau đó chỉ cập nhật sự kiện nếu không có thông tin chi tiết nào về sự kiện thay đổi kể từ khi sự kiện được tạo.
Truy xuất sự kiện có điều kiện
Ví dụ sau đây cho thấy cách tìm nạp có điều kiện một sự kiện trên Lịch bằng tiêu đề If-None-Match
. Tập lệnh này sẽ tạo một sự kiện mới, sau đó thăm dò sự kiện để tìm các thay đổi trong 30 giây. Bất cứ khi nào sự kiện thay đổi, phiên bản mới sẽ được tìm nạp.
Đồng bộ hoá sự kiện
Ví dụ sau đây minh hoạ cách truy xuất các sự kiện bằng mã đồng bộ hoá. Khi bạn đưa mã thông báo đồng bộ hoá vào yêu cầu dịch vụ nâng cao của Lịch, phản hồi nhận được sẽ chỉ bao gồm những mục đã thay đổi kể từ khi mã thông báo đó được tạo, giúp xử lý hiệu quả hơn. Hãy xem phần Đồng bộ hoá tài nguyên một cách hiệu quả để biết thêm thông tin chi tiết về quy trình đồng bộ hoá.
Ví dụ sau đây sử dụng cùng một phương thức getRelativeDate(daysOffset, hour)
được xác định trong các ví dụ trên.