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. Giống như dịch vụ Lịch tích hợp sẵn 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ả các lịch bổ sung mà người dùng đã đăng ký. Trong hầu hết trường hợp, dịch vụ tích hợp sẵn dễ sử dụng hơn. Tuy nhiên, 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 về API Lịch Google 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ác đối tượng, phương thức và tham số giống 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 sự cố và tìm sự hỗ trợ khác, hãy xem Hướng dẫn hỗ trợ về Lịch.
Tiêu đề của yêu cầu HTTP
Dịch vụ Lịch nâng cao có thể chấp nhận các tiêu đề của yêu cầu HTTP If-Match
và If-None-Match
. Để biết thông tin chi tiết, vui lòng 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 minh hoạ cách tạo một sự kiện trong lịch mặc định của người dùng.
Lịch danh sách
Ví dụ sau minh hoạ cách truy xuất thông tin chi tiết về lịch xuất hiện trong danh sách lịch của người dùng.
Sự kiện trang thông tin
Ví dụ sau 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 biết cách cập nhật có điều kiện một sự kiện trên Lịch bằng cách sử dụng tiêu đề If-Match
. Tập lệnh 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 có điều kiện một sự 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 sẽ tạo một sự kiện mới, sau đó thăm dò sự kiện để biết 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.
Sự kiện đồng bộ hoá
Ví dụ sau minh hoạ cách truy xuất các sự kiện bằng mã thông báo đồ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 thu được chỉ bao gồm các mục đã thay đổi kể từ khi mã thông báo đó được tạo, giúp xử lý hiệu quả hơn. Xem phần Đồng bộ hoá tài nguyên hiệu quả để biết thêm thông tin chi tiết về quy trình đồng bộ hoá.
Ví dụ sau 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.