Cho phép tập lệnh đọc và cập nhật Lịch Google của người dùng. Lớp này cung cấp quyền truy cập trực tiếp vào lịch mặc định của người dùng, cũng như khả năng truy xuất thêm các lịch mà người dùng sở hữu hoặc đã đăng ký.
Thuộc tính
Tài sản | Loại | Nội dung mô tả |
---|---|---|
Color | Color | Một giá trị enum đại diện cho các màu được đặt tên có trong dịch vụ Lịch. |
EventColor | EventColor | Một giá trị enum đại diện cho các màu của sự kiện được đặt tên có trong dịch vụ Lịch. |
GuestStatus | GuestStatus | Một giá trị enum thể hiện các trạng thái mà khách có thể có đối với một sự kiện. |
Month | Month | Một enum đại diện cho các tháng trong năm. |
Visibility | Visibility | Một giá trị enum thể hiện chế độ hiển thị của một sự kiện. |
Weekday | Weekday | Một giá trị enum đại diện cho các ngày trong tuần. |
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
createAllDayEvent(title, date) | CalendarEvent | Tạo một sự kiện mới cả ngày. |
createAllDayEvent(title, startDate, endDate) | CalendarEvent | Tạo một sự kiện mới cả ngày có thể kéo dài nhiều ngày. |
createAllDayEvent(title, startDate, endDate, options) | CalendarEvent | Tạo một sự kiện mới cả ngày có thể kéo dài nhiều ngày. |
createAllDayEvent(title, date, options) | CalendarEvent | Tạo một sự kiện mới cả ngày. |
createAllDayEventSeries(title, startDate, recurrence) | CalendarEventSeries | Tạo chuỗi sự kiện mới cả ngày. |
createAllDayEventSeries(title, startDate, recurrence, options) | CalendarEventSeries | Tạo chuỗi sự kiện mới cả ngày. |
createCalendar(name) | Calendar | Tạo lịch mới do người dùng sở hữu. |
createCalendar(name, options) | Calendar | Tạo lịch mới do người dùng sở hữu. |
createEvent(title, startTime, endTime) | CalendarEvent | Tạo sự kiện mới. |
createEvent(title, startTime, endTime, options) | CalendarEvent | Tạo sự kiện mới. |
createEventFromDescription(description) | CalendarEvent | Tạo sự kiện từ phần mô tả dạng biểu mẫu tuỳ ý. |
createEventSeries(title, startTime, endTime, recurrence) | CalendarEventSeries | Tạo chuỗi sự kiện mới. |
createEventSeries(title, startTime, endTime, recurrence, options) | CalendarEventSeries | Tạo chuỗi sự kiện mới. |
getAllCalendars() | Calendar[] | Lấy tất cả các lịch mà người dùng sở hữu hoặc đã đăng ký. |
getAllOwnedCalendars() | Calendar[] | Lấy tất cả lịch mà người dùng sở hữu. |
getCalendarById(id) | Calendar | Lấy lịch có mã nhận dạng đã cho. |
getCalendarsByName(name) | Calendar[] | Lấy tất cả các lịch có tên cụ thể mà người dùng sở hữu hoặc đã đăng ký. |
getColor() | String | Nhận màu của lịch. |
getDefaultCalendar() | Calendar | Lấy lịch mặc định của người dùng. |
getDescription() | String | Lấy nội dung mô tả của lịch. |
getEventById(iCalId) | CalendarEvent | Lấy sự kiện bằng mã nhận dạng đã cho. |
getEventSeriesById(iCalId) | CalendarEventSeries | Lấy chuỗi sự kiện bằng mã nhận dạng đã cho. |
getEvents(startTime, endTime) | CalendarEvent[] | Lấy tất cả sự kiện xảy ra trong một phạm vi thời gian nhất định. |
getEvents(startTime, endTime, options) | CalendarEvent[] | Lấy tất cả sự kiện xảy ra trong một phạm vi thời gian nhất định và đáp ứng tiêu chí đã chỉ định. |
getEventsForDay(date) | CalendarEvent[] | Lấy tất cả sự kiện xảy ra vào một ngày nhất định. |
getEventsForDay(date, options) | CalendarEvent[] | Lấy tất cả sự kiện xảy ra vào một ngày nhất định và đáp ứng các tiêu chí đã chỉ định. |
getId() | String | Lấy mã nhận dạng của lịch. |
getName() | String | Lấy tên lịch. |
getOwnedCalendarById(id) | Calendar | Lấy lịch theo mã nhận dạng đã cho, nếu người dùng sở hữu lịch đó. |
getOwnedCalendarsByName(name) | Calendar[] | Lấy tất cả các lịch có tên cụ thể mà người dùng sở hữu. |
getTimeZone() | String | Lấy múi giờ của lịch. |
isHidden() | Boolean | Xác định xem lịch có bị ẩn trong giao diện người dùng hay không. |
isMyPrimaryCalendar() | Boolean | Xác định xem lịch có phải là lịch chính của người dùng có hiệu lực hay không. |
isOwnedByMe() | Boolean | Xác định xem bạn có sở hữu lịch hay không. |
isSelected() | Boolean | Xác định xem các sự kiện của lịch có hiển thị trong giao diện người dùng hay không. |
newRecurrence() | EventRecurrence | Tạo một đối tượng lặp lại mới. Bạn có thể dùng đối tượng này để tạo quy tắc lặp lại sự kiện. |
setColor(color) | Calendar | Đặt màu của lịch. |
setDescription(description) | Calendar | Đặt nội dung mô tả của lịch. |
setHidden(hidden) | Calendar | Đặt có hiển thị lịch trong giao diện người dùng hay không. |
setName(name) | Calendar | Đặt tên cho lịch. |
setSelected(selected) | Calendar | Đặt xem các sự kiện của lịch có hiển thị trong giao diện người dùng hay không. |
setTimeZone(timeZone) | Calendar | Đặt múi giờ cho lịch. |
subscribeToCalendar(id) | Calendar | Đăng ký người dùng vào lịch bằng mã nhận dạng được cung cấp nếu họ được phép đăng ký. |
subscribeToCalendar(id, options) | Calendar | Đăng ký người dùng vào lịch bằng mã nhận dạng được cung cấp nếu họ được phép đăng ký. |
Tài liệu chi tiết
createAllDayEvent(title, date)
Tạo một sự kiện mới cả ngày.
// Creates an all-day event for the moon landing and logs the ID. var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Apollo 11 Landing', new Date('July 20, 1969')); Logger.log('Event ID: ' + event.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | Tiêu đề của sự kiện. |
date | Date | Ngày diễn ra sự kiện (chỉ dùng ngày; bỏ qua thời gian). |
Cầu thủ trả bóng
CalendarEvent
– Sự kiện đã tạo.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createAllDayEvent(title, startDate, endDate)
Tạo một sự kiện mới cả ngày có thể kéo dài nhiều ngày.
// Creates an all-day event for the Woodstock festival (August 15th to 17th) and logs the ID. var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Woodstock Festival', new Date('August 15, 1969'), new Date('August 18, 1969')); Logger.log('Event ID: ' + event.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | Tiêu đề của sự kiện. |
startDate | Date | Ngày bắt đầu sự kiện (chỉ dùng ngày; bỏ qua thời gian). |
endDate | Date | Ngày kết thúc sự kiện (chỉ dùng ngày; bỏ qua thời gian). Không có ngày kết thúc cụ thể. |
Cầu thủ trả bóng
CalendarEvent
– Sự kiện đã tạo.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createAllDayEvent(title, startDate, endDate, options)
Tạo một sự kiện mới cả ngày có thể kéo dài nhiều ngày.
// Creates an all-day event for the Woodstock festival (August 15th to 17th) and logs the ID. var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Woodstock Festival', new Date('August 15, 1969'), new Date('August 18, 1969'), {location: 'Bethel, White Lake, New York, U.S.', sendInvites: true}); Logger.log('Event ID: ' + event.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | Tiêu đề của sự kiện. |
startDate | Date | Ngày bắt đầu sự kiện (chỉ dùng ngày; bỏ qua thời gian). |
endDate | Date | Ngày kết thúc sự kiện (chỉ dùng ngày; bỏ qua thời gian). Không có ngày kết thúc cụ thể. |
options | Object | Đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây. |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
description | String | Nội dung mô tả về sự kiện. |
location | String | Địa điểm diễn ra sự kiện. |
guests | String | Danh sách địa chỉ email được phân tách bằng dấu phẩy mà bạn sẽ thêm vào dưới dạng khách. |
sendInvites | Boolean | Liệu có gửi email mời hay không (mặc định: false ). |
Cầu thủ trả bóng
CalendarEvent
– Sự kiện đã tạo.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createAllDayEvent(title, date, options)
Tạo một sự kiện mới cả ngày.
// Creates an all-day event for the moon landing and logs the ID. var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Apollo 11 Landing', new Date('July 20, 1969'), {location: 'The Moon'}); Logger.log('Event ID: ' + event.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | Tiêu đề của sự kiện. |
date | Date | Ngày diễn ra sự kiện (chỉ dùng ngày; bỏ qua thời gian). |
options | Object | Đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây. |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
description | String | Nội dung mô tả về sự kiện. |
location | String | Địa điểm diễn ra sự kiện. |
guests | String | Danh sách địa chỉ email được phân tách bằng dấu phẩy mà bạn sẽ thêm vào dưới dạng khách. |
sendInvites | Boolean | Liệu có gửi email mời hay không (mặc định: false ). |
Cầu thủ trả bóng
CalendarEvent
– Sự kiện đã tạo.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createAllDayEventSeries(title, startDate, recurrence)
Tạo chuỗi sự kiện mới cả ngày.
// Creates an event series for a no-meetings day, taking place every Wednesday in 2013. var eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries('No Meetings', new Date('January 2, 2013 03:00:00 PM EST'), CalendarApp.newRecurrence().addWeeklyRule() .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY) .until(new Date('January 1, 2014'))); Logger.log('Event Series ID: ' + eventSeries.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề của các sự kiện trong chuỗi |
startDate | Date | ngày diễn ra sự kiện đầu tiên trong chuỗi (chỉ sử dụng ngày; bỏ qua thời gian) |
recurrence | EventRecurrence | chế độ cài đặt lặp lại của chuỗi sự kiện |
Cầu thủ trả bóng
CalendarEventSeries
– chuỗi sự kiện đã tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createAllDayEventSeries(title, startDate, recurrence, options)
Tạo chuỗi sự kiện mới cả ngày.
// Creates an event series for a no-meetings day, taking place every Wednesday in 2013. var eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries('No Meetings', new Date('January 2, 2013 03:00:00 PM EST'), CalendarApp.newRecurrence().addWeeklyRule() .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY) .until(new Date('January 1, 2014')), {guests: 'everyone@example.com'}); Logger.log('Event Series ID: ' + eventSeries.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề của các sự kiện trong chuỗi |
startDate | Date | ngày diễn ra sự kiện đầu tiên trong chuỗi (chỉ sử dụng ngày; bỏ qua thời gian) |
recurrence | EventRecurrence | chế độ cài đặt lặp lại của chuỗi sự kiện |
options | Object | đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
description | String | mô tả các sự kiện trong chuỗi |
location | String | vị trí của các sự kiện trong chuỗi sự kiện |
guests | String | danh sách địa chỉ email được phân tách bằng dấu phẩy mà bạn nên thêm làm khách trong các sự kiện trong chuỗi |
sendInvites | Boolean | liệu có gửi email lời mời hay không (mặc định: false ) |
Cầu thủ trả bóng
CalendarEventSeries
– chuỗi sự kiện đã tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createCalendar(name)
Tạo lịch mới do người dùng sở hữu.
// Creates a new calendar named "Travel Plans". var calendar = CalendarApp.createCalendar('Travel Plans'); Logger.log('Created the calendar "%s", with the ID "%s".', calendar.getName(), calendar.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên của lịch mới |
Cầu thủ trả bóng
Calendar
— lịch mới tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createCalendar(name, options)
Tạo lịch mới do người dùng sở hữu.
// Creates a new calendar named "Travel Plans" with a summary and color. var calendar = CalendarApp.createCalendar('Travel Plans', { summary: 'A calendar to plan my travel schedule.', color: CalendarApp.Color.BLUE }); Logger.log('Created the calendar "%s", with the ID "%s".', calendar.getName(), calendar.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên của lịch mới |
options | Object | đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
location | String | vị trí của lịch |
summary | String | nội dung mô tả của lịch |
timeZone | String | múi giờ cần đặt lịch, được chỉ định ở định dạng "dài" (ví dụ: "Châu Mỹ/New_NY", như liệt kê của Joda.org) |
color | String | một chuỗi màu thập lục phân ("#rrggbb") hoặc một giá trị từ CalendarApp.Colors |
hidden | Boolean | liệu lịch có bị ẩn trong giao diện người dùng hay không (mặc định:
false ) |
selected | Boolean | các sự kiện của lịch có hiển thị trong giao diện
người dùng hay không (mặc định: true ) |
Cầu thủ trả bóng
Calendar
— lịch mới tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createEvent(title, startTime, endTime)
Tạo sự kiện mới.
Nếu bạn không chỉ định múi giờ, thì giá trị thời gian sẽ được diễn giải theo múi giờ của tập lệnh. Múi giờ này có thể khác với múi giờ của lịch.
// Creates an event for the moon landing and logs the ID. var event = CalendarApp.getDefaultCalendar().createEvent('Apollo 11 Landing', new Date('July 20, 1969 20:00:00 UTC'), new Date('July 21, 1969 21:00:00 UTC')); Logger.log('Event ID: ' + event.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề của sự kiện |
startTime | Date | ngày và giờ khi sự kiện bắt đầu |
endTime | Date | ngày và giờ kết thúc sự kiện |
Cầu thủ trả bóng
CalendarEvent
– sự kiện đã tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createEvent(title, startTime, endTime, options)
Tạo sự kiện mới.
Nếu bạn không chỉ định múi giờ, thì giá trị thời gian sẽ được diễn giải theo múi giờ của tập lệnh. Múi giờ này có thể khác với múi giờ của lịch.
// Creates an event for the moon landing and logs the ID. var event = CalendarApp.getDefaultCalendar().createEvent('Apollo 11 Landing', new Date('July 20, 1969 20:00:00 UTC'), new Date('July 20, 1969 21:00:00 UTC'), {location: 'The Moon'}); Logger.log('Event ID: ' + event.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề của sự kiện |
startTime | Date | ngày và giờ khi sự kiện bắt đầu |
endTime | Date | ngày và giờ kết thúc sự kiện |
options | Object | đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
description | String | nội dung mô tả sự kiện |
location | String | địa điểm diễn ra sự kiện |
guests | String | danh sách địa chỉ email được phân tách bằng dấu phẩy mà bạn sẽ thêm vào làm khách |
sendInvites | Boolean | liệu có gửi email lời mời hay không (mặc định: false ) |
Cầu thủ trả bóng
CalendarEvent
– sự kiện đã tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createEventFromDescription(description)
Tạo sự kiện từ phần mô tả dạng biểu mẫu tuỳ ý.
Mô tả phải sử dụng định dạng giống như tính năng "Thêm nhanh" của giao diện người dùng.
// Creates a new event and logs its ID. var event = CalendarApp.getDefaultCalendar() .createEventFromDescription('Lunch with Mary, Friday at 1PM'); Logger.log('Event ID: ' + event.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
description | String | nội dung mô tả sự kiện dạng biểu mẫu tuỳ ý |
Cầu thủ trả bóng
CalendarEvent
– sự kiện đã tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createEventSeries(title, startTime, endTime, recurrence)
Tạo chuỗi sự kiện mới.
// Creates an event series for a team meeting, taking place every Tuesday and Thursday in 2013. var eventSeries = CalendarApp.getDefaultCalendar().createEventSeries('Team Meeting', new Date('January 1, 2013 03:00:00 PM EST'), new Date('January 1, 2013 04:00:00 PM EST'), CalendarApp.newRecurrence().addWeeklyRule() .onlyOnWeekdays([CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]) .until(new Date('January 1, 2014'))); Logger.log('Event Series ID: ' + eventSeries.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề của các sự kiện trong chuỗi |
startTime | Date | ngày và giờ khi sự kiện đầu tiên trong chuỗi bắt đầu |
endTime | Date | ngày và giờ khi sự kiện đầu tiên trong chuỗi kết thúc |
recurrence | EventRecurrence | chế độ cài đặt lặp lại của chuỗi sự kiện |
Cầu thủ trả bóng
CalendarEventSeries
– chuỗi sự kiện đã tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createEventSeries(title, startTime, endTime, recurrence, options)
Tạo chuỗi sự kiện mới.
// Creates an event series for a team meeting, taking place every Tuesday and Thursday in 2013. var eventSeries = CalendarApp.getDefaultCalendar().createEventSeries('Team Meeting', new Date('January 1, 2013 03:00:00 PM EST'), new Date('January 1, 2013 04:00:00 PM EST'), CalendarApp.newRecurrence().addWeeklyRule() .onlyOnWeekdays([CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]) .until(new Date('January 1, 2014')), {location: 'Conference Room'}); Logger.log('Event Series ID: ' + eventSeries.getId());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề của các sự kiện trong chuỗi |
startTime | Date | ngày và giờ khi sự kiện đầu tiên trong chuỗi bắt đầu |
endTime | Date | ngày và giờ khi sự kiện đầu tiên trong chuỗi kết thúc |
recurrence | EventRecurrence | chế độ cài đặt lặp lại của chuỗi sự kiện |
options | Object | đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
description | String | mô tả các sự kiện trong chuỗi |
location | String | vị trí của các sự kiện trong chuỗi sự kiện |
guests | String | danh sách địa chỉ email được phân tách bằng dấu phẩy mà bạn nên thêm làm khách trong các sự kiện trong chuỗi |
sendInvites | Boolean | liệu có gửi email lời mời hay không (mặc định: false ) |
Cầu thủ trả bóng
CalendarEventSeries
– chuỗi sự kiện đã tạo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
getAllCalendars()
Lấy tất cả các lịch mà người dùng sở hữu hoặc đã đăng ký.
// Determines how many calendars the user can access. var calendars = CalendarApp.getAllCalendars(); Logger.log('This user owns or is subscribed to %s calendars.', calendars.length);
Cầu thủ trả bóng
Calendar[]
— tất cả các lịch mà người dùng có thể truy cập
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getAllOwnedCalendars()
Lấy tất cả lịch mà người dùng sở hữu.
// Determines how many calendars the user owns. var calendars = CalendarApp.getAllOwnedCalendars(); Logger.log('This user owns %s calendars.', calendars.length);
Cầu thủ trả bóng
Calendar[]
— tất cả các lịch mà người dùng sở hữu
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getCalendarById(id)
Lấy lịch có mã nhận dạng đã cho.
// Gets the public calendar "US Holidays" by ID. var calendar = CalendarApp.getCalendarById( 'en.usa#holiday@group.v.calendar.google.com'); Logger.log('The calendar is named "%s".', calendar.getName());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
id | String | mã lịch |
Cầu thủ trả bóng
Calendar
— lịch có mã nhận dạng đã cho, hoặc null
nếu lịch không tồn tại, nếu người dùng không thể truy cập vào lịch hoặc nếu người dùng chưa đăng ký lịch
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getCalendarsByName(name)
Lấy tất cả các lịch có tên cụ thể mà người dùng sở hữu hoặc đã đăng ký. Tên không phân biệt chữ hoa chữ thường.
// Gets the public calendar named "US Holidays". var calendars = CalendarApp.getCalendarsByName('US Holidays'); Logger.log('Found %s matching calendars.', calendars.length);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên lịch |
Cầu thủ trả bóng
Calendar[]
— tất cả lịch có tên này mà người dùng có thể truy cập
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getColor()
Nhận màu của lịch.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the color of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getColor() instead. const calendarColor = calendar.getColor(); console.log(calendarColor);
Cầu thủ trả bóng
String
– Chuỗi màu thập lục phân ("#rrggbb").
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getDefaultCalendar()
Lấy lịch mặc định của người dùng.
// Determines the time zone of the user's default calendar. var calendar = CalendarApp.getDefaultCalendar(); Logger.log('My default calendar is set to the time zone "%s".', calendar.getTimeZone());
Cầu thủ trả bóng
Calendar
— lịch mặc định của người dùng
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getDescription()
Lấy nội dung mô tả của lịch.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Sets the description of the calendar to 'Test description.' calendar.setDescription('Test description'); // Gets the description of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getDescription() instead. const description = calendar.getDescription(); console.log(description);
Cầu thủ trả bóng
String
— Nội dung mô tả về lịch này.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEventById(iCalId)
Lấy sự kiện bằng mã nhận dạng đã cho. Nếu chuỗi dữ liệu thuộc về một lịch khác với lịch mặc định, thì phương thức này phải được gọi từ lịch đó. Việc gọi getEventById(iCalId)
chỉ trả về một sự kiện trong lịch mặc định.
Nhiều sự kiện có thể có cùng mã nhận dạng nếu thuộc một chuỗi sự kiện. Trong trường hợp này, phương thức này chỉ trả về sự kiện đầu tiên trong chuỗi sự kiện đó.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com') // Creates an event for the moon landing. const event = calendar.createEvent('Apollo 11 Landing', new Date('July 20, 1969 20:05:00 UTC'), new Date('July 20, 1969 20:17:00 UTC')); // Gets the calendar event ID and logs it to the console. const iCalId = event.getId(); console.log(iCalId); // Gets the event by its ID and logs the title of the event to the console. // For the default calendar, you can use CalendarApp.getEventById(iCalId) instead. const myEvent = calendar.getEventById(iCalId); console.log(myEvent.getTitle());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
iCalId | String | Mã của sự kiện. |
Cầu thủ trả bóng
CalendarEvent
– Sự kiện có mã nhận dạng đã cho hoặc null
nếu sự kiện không tồn tại hoặc người dùng không thể truy cập vào sự kiện đó.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEventSeriesById(iCalId)
Lấy chuỗi sự kiện bằng mã nhận dạng đã cho. Nếu mã nhận dạng được cung cấp là dành cho một CalendarEvent
, thì CalendarEventSeries
sẽ được trả về cùng với một sự kiện duy nhất trong chuỗi. Xin lưu ý rằng nếu chuỗi sự kiện thuộc về một lịch khác với lịch mặc định, thì phương thức này phải được gọi từ CalendarApp
đó; việc gọi getEventSeriesById(iCalId)
trực tiếp chỉ trả về một chuỗi sự kiện tồn tại trong lịch mặc định.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Creates an event series for a daily team meeting from 1 PM to 2 PM. // The series adds the daily event from January 1, 2023 through December 31, 2023. const eventSeries = calendar.createEventSeries('Team meeting', new Date('Jan 1, 2023 13:00:00'), new Date('Jan 1, 2023 14:00:00'), CalendarApp.newRecurrence().addDailyRule().until(new Date('Jan 1, 2024'))); // Gets the ID of the event series. const iCalId = eventSeries.getId(); // Gets the event series by its ID and logs the series title to the console. // For the default calendar, you can use CalendarApp.getEventSeriesById(iCalId) instead. console.log(calendar.getEventSeriesById(iCalId).getTitle());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
iCalId | String | Mã của chuỗi sự kiện. |
Cầu thủ trả bóng
CalendarEventSeries
– Bộ sách có mã nhận dạng được cung cấp, hoặc null
nếu bộ sách không tồn tại hoặc người dùng không thể truy cập vào bộ sách.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEvents(startTime, endTime)
Lấy tất cả sự kiện xảy ra trong một phạm vi thời gian nhất định.
Phương thức này trả về các sự kiện bắt đầu trong phạm vi thời gian nhất định, kết thúc trong phạm vi thời gian hoặc bao gồm phạm vi thời gian. Nếu bạn không chỉ định múi giờ, thì giá trị thời gian sẽ được diễn giải theo múi giờ của tập lệnh. Múi giờ này có thể khác với múi giờ của lịch.
// Determines how many events are happening in the next two hours. var now = new Date(); var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000)); var events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow); Logger.log('Number of events: ' + events.length);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startTime | Date | điểm bắt đầu của khoảng thời gian |
endTime | Date | kết thúc phạm vi thời gian, không bao gồm |
Cầu thủ trả bóng
CalendarEvent[]
— các sự kiện xảy ra trong phạm vi thời gian
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEvents(startTime, endTime, options)
Lấy tất cả sự kiện xảy ra trong một phạm vi thời gian nhất định và đáp ứng tiêu chí đã chỉ định.
Phương thức này trả về các sự kiện bắt đầu trong phạm vi thời gian nhất định, kết thúc trong phạm vi thời gian hoặc bao gồm phạm vi thời gian. Nếu bạn không chỉ định múi giờ, thì giá trị thời gian sẽ được diễn giải theo múi giờ của tập lệnh. Múi giờ này có thể khác với múi giờ của lịch.
Xin lưu ý rằng quá trình lọc theo author
, search
hoặc statusFilters
diễn ra sau khi áp dụng start
và max
. Điều này có nghĩa là số lượng sự kiện được trả về có thể ít hơn max
, mặc dù các sự kiện bổ sung đều đáp ứng tiêu chí.
// Determines how many events are happening in the next two hours that contain the term // "meeting". var now = new Date(); var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000)); var events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow, {search: 'meeting'}); Logger.log('Number of events: ' + events.length);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
startTime | Date | điểm bắt đầu của khoảng thời gian |
endTime | Date | kết thúc phạm vi thời gian, không bao gồm |
options | Object | đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
start | Integer | chỉ mục của sự kiện đầu tiên cần trả về |
max | Integer | số lượng sự kiện tối đa cần trả về |
author | String | địa chỉ email mà người tạo sự kiện dùng để lọc kết quả |
search | String | cụm từ tìm kiếm toàn bộ văn bản được dùng để lọc kết quả |
statusFilters[] | GuestStatus | một loạt trạng thái được dùng để lọc kết quả |
Cầu thủ trả bóng
CalendarEvent[]
– các sự kiện diễn ra trong phạm vi thời gian và phù hợp với tiêu chí
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEventsForDay(date)
Lấy tất cả sự kiện xảy ra vào một ngày nhất định.
Phương thức này trả về các sự kiện nếu các sự kiện bắt đầu trong một ngày nhất định, kết thúc trong ngày hoặc bao gồm ngày đó.
Xin lưu ý rằng chỉ sử dụng phần ngày của đối tượng Ngày và bỏ qua phần giờ. Ngày được hiểu là nửa đêm của ngày đó đến nửa đêm của ngày tiếp theo theo múi giờ của lịch.
// Determines how many events are happening today. var today = new Date(); var events = CalendarApp.getDefaultCalendar().getEventsForDay(today); Logger.log('Number of events: ' + events.length);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
date | Date | ngày truy xuất sự kiện (chỉ sử dụng ngày; thời gian bị bỏ qua) |
Cầu thủ trả bóng
CalendarEvent[]
– các sự kiện xảy ra vào ngày đã chọn
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEventsForDay(date, options)
Lấy tất cả sự kiện xảy ra vào một ngày nhất định và đáp ứng các tiêu chí đã chỉ định.
Phương thức này trả về các sự kiện nếu các sự kiện bắt đầu trong một ngày nhất định, kết thúc trong ngày hoặc bao gồm ngày đó.
Xin lưu ý rằng chỉ sử dụng phần ngày của đối tượng Ngày và bỏ qua phần giờ. Ngày được hiểu là nửa đêm của ngày đó đến nửa đêm của ngày tiếp theo theo múi giờ của lịch.
Xin lưu ý rằng quá trình lọc theo author
, search
hoặc statusFilters
diễn ra sau khi áp dụng start
và max
. Điều này có nghĩa là số lượng sự kiện được trả về có thể ít hơn max
, mặc dù các sự kiện bổ sung đều đáp ứng tiêu chí.
// Determines how many events are happening today and contain the term "meeting". var today = new Date(); var events = CalendarApp.getDefaultCalendar().getEventsForDay(today, {search: 'meeting'}); Logger.log('Number of events: ' + events.length);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
date | Date | ngày truy xuất sự kiện (chỉ sử dụng ngày; thời gian bị bỏ qua) |
options | Object | tuỳ chọn lọc nâng cao |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
start | Integer | chỉ mục của sự kiện đầu tiên cần trả về |
max | Integer | số lượng sự kiện tối đa cần trả về |
author | String | địa chỉ email mà người tạo sự kiện dùng để lọc kết quả |
search | String | cụm từ tìm kiếm toàn bộ văn bản được dùng để lọc kết quả |
statusFilters[] | GuestStatus | một loạt trạng thái được dùng để lọc kết quả |
Cầu thủ trả bóng
CalendarEvent[]
– các sự kiện xảy ra vào ngày đã chọn và khớp với tiêu chí
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getId()
Lấy mã nhận dạng của lịch. Mã nhận dạng cho lịch mặc định của người dùng là địa chỉ email của họ.
// Opens the calendar by its ID. // To get the user's default calendar, use CalendarApp.getDefaultCalendar(). // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the ID of the calendar and logs it to the console. const calendarId = calendar.getId(); console.log(calendarId);
Cầu thủ trả bóng
String
— Mã lịch.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getName()
Lấy tên lịch.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the name of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getName() instead. const calendarName = calendar.getName(); console.log(calendarName);
Cầu thủ trả bóng
String
— Tên của lịch này.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getOwnedCalendarById(id)
Lấy lịch theo mã nhận dạng đã cho, nếu người dùng sở hữu lịch đó.
Để tìm mã lịch, hãy nhấp vào mũi tên bên cạnh tên lịch trong Lịch Google và chọn Cài đặt lịch. Mã nhận dạng nằm ở gần cuối trang cài đặt.
// Gets a (non-existent) private calendar by ID. var calendar = CalendarApp.getOwnedCalendarById( '123456789@group.calendar.google.com'); Logger.log('The calendar is named "%s".', calendar.getName());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
id | String | mã lịch |
Cầu thủ trả bóng
Calendar
– lịch có mã đã cho hoặc null
nếu lịch không tồn tại hoặc người dùng không sở hữu lịch
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getOwnedCalendarsByName(name)
Lấy tất cả các lịch có tên cụ thể mà người dùng sở hữu. Tên không phân biệt chữ hoa chữ thường.
// Gets a private calendar named "Travel Plans". var calendars = CalendarApp.getOwnedCalendarsByName('Travel Plans'); Logger.log('Found %s matching calendars.', calendars.length);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên lịch |
Cầu thủ trả bóng
Calendar[]
— tất cả các lịch có tên này mà người dùng sở hữu
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getTimeZone()
Lấy múi giờ của lịch.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the time zone of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getTimeZone() instead. const timeZone = calendar.getTimeZone(); console.log(timeZone);
Cầu thủ trả bóng
String
– Múi giờ được chỉ định ở định dạng "long" (ví dụ: "America/New_Quốc", như liệt kê của Joda.org).
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isHidden()
Xác định xem lịch có bị ẩn trong giao diện người dùng hay không.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Determines whether the calendar is hidden in the user interface and logs it to the console. // For the default calendar, you can use CalendarApp.isHidden() instead. const isHidden = calendar.isHidden(); console.log(isHidden);
Cầu thủ trả bóng
Boolean
– true
nếu lịch bị ẩn trong giao diện người dùng; false
nếu không bị ẩn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isMyPrimaryCalendar()
Xác định xem lịch có phải là lịch chính của người dùng có hiệu lực hay không.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Determines whether the calendar is the default calendar for // the effective user and logs it to the console. // For the default calendar, you can use CalendarApp.isMyPrimaryCalendar() instead. const isMyPrimaryCalendar = calendar.isMyPrimaryCalendar(); console.log(isMyPrimaryCalendar);
Cầu thủ trả bóng
Boolean
– true
nếu lịch là lịch mặc định cho người dùng có hiệu lực; false
nếu không phải.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isOwnedByMe()
Xác định xem bạn có sở hữu lịch hay không.
// Gets a calendar by its ID. To get the user's default calendar, use // CalendarApp.getDefault() instead. // TODO(developer): Replace the ID with the calendar ID that you want to use. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Determines whether the calendar is owned by you and logs it. console.log(calendar.isOwnedByMe());
Cầu thủ trả bóng
Boolean
— true
nếu lịch thuộc sở hữu của bạn; false
nếu không phải.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isSelected()
Xác định xem các sự kiện của lịch có hiển thị trong giao diện người dùng hay không.
// Gets the user's default calendar. To get a different calendar, use getCalendarById() // instead. const calendar = CalendarApp.getDefaultCalendar(); // Determines whether the calendar's events are displayed in the user interface and logs it. console.log(calendar.isSelected());
Cầu thủ trả bóng
Boolean
– true
nếu sự kiện trong lịch được hiển thị trong giao diện người dùng; false
nếu không hiển thị
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
newRecurrence()
Tạo một đối tượng lặp lại mới. Bạn có thể dùng đối tượng này để tạo quy tắc lặp lại sự kiện.
// Creates an event series for a no-meetings day, taking place every Wednesday in 2013. var recurrence = CalendarApp.newRecurrence().addWeeklyRule() .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY) .until(new Date('January 1, 2014')); var eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries('No Meetings', new Date('January 2, 2013 03:00:00 PM EST'), recurrence); Logger.log('Event Series ID: ' + eventSeries.getId());
Cầu thủ trả bóng
EventRecurrence
— một đối tượng lặp lại mới không có quy tắc nào được thiết lập (coi như lặp lại hàng tuần)
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
setColor(color)
Đặt màu của lịch.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Sets the color of the calendar to pink using the Calendar Color enum. // For the default calendar, you can use CalendarApp.setColor() instead. calendar.setColor(CalendarApp.Color.PINK);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | String | Một CalendarApp.Color hoặc một chuỗi màu thập lục phân ("#rrggbb"). |
Cầu thủ trả bóng
Calendar
— Lịch này để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setDescription(description)
Đặt nội dung mô tả của lịch.
// Gets the user's default calendar. To get a different calendar, use getCalendarById() // instead. const calendar = CalendarApp.getDefaultCalendar(); // Sets the description of the calendar. // TODO(developer): Update the string with the description that you want to use. calendar.setDescription('Updated calendar description.')
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
description | String | mô tả của lịch này |
Cầu thủ trả bóng
Calendar
— lịch này để sắp xếp theo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setHidden(hidden)
Đặt có hiển thị lịch trong giao diện người dùng hay không.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
hidden | Boolean | true để ẩn lịch trong giao diện người dùng; false để hiển thị lịch |
Cầu thủ trả bóng
Calendar
— lịch này để sắp xếp theo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setName(name)
Đặt tên cho lịch.
// Gets the user's default calendar. To get a different calendar, use getCalendarById() // instead. const calendar = CalendarApp.getDefaultCalendar(); // Sets the name of the calendar. // TODO(developer): Update the string with the name that you want to use. calendar.setName('Example calendar name');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên mới |
Cầu thủ trả bóng
Calendar
— lịch này để sắp xếp theo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setSelected(selected)
Đặt xem các sự kiện của lịch có hiển thị trong giao diện người dùng hay không.
// Gets the user's default calendar. To get a different calendar, use getCalendarById() // instead. const calendar = CalendarApp.getDefaultCalendar(); // Selects the calendar so that its events are displayed in the user interface. To // unselect the calendar, set the parameter to false. calendar.setSelected(true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
selected | Boolean | true để hiển thị các sự kiện của lịch trong giao diện người dùng; false
để ẩn các sự kiện đó |
Cầu thủ trả bóng
Calendar
— lịch này để sắp xếp theo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setTimeZone(timeZone)
Đặt múi giờ cho lịch.
// Gets the user's default calendar. To get a different calendar, use getCalendarById() // instead. const calendar = CalendarApp.getDefaultCalendar(); // Sets the time zone of the calendar to America/New York (US/Eastern) time. calendar.setTimeZone('America/New_York');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
timeZone | String | Múi giờ được chỉ định ở định dạng "dài" (chẳng hạn như "America/New_ York", như do Joda.org liệt kê). |
Cầu thủ trả bóng
Calendar
— Lịch này để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
subscribeToCalendar(id)
Đăng ký người dùng vào lịch bằng mã nhận dạng được cung cấp nếu họ được phép đăng ký.
// Subscribe to the calendar "US Holidays". var calendar = CalendarApp.subscribeToCalendar( 'en.usa#holiday@group.v.calendar.google.com'); Logger.log('Subscribed to the calendar "%s".', calendar.getName());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
id | String | mã lịch để đăng ký |
Cầu thủ trả bóng
Calendar
— lịch mới được đăng ký
Gửi
Error
— nếu không có lịch nào có mã nhận dạng này
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
subscribeToCalendar(id, options)
Đăng ký người dùng vào lịch bằng mã nhận dạng được cung cấp nếu họ được phép đăng ký.
// Subscribe to the calendar "US Holidays", and set it to the color blue. var calendar = CalendarApp.subscribeToCalendar( 'en.usa#holiday@group.v.calendar.google.com', { color: CalendarApp.Color.BLUE }); Logger.log('Subscribed to the calendar "%s".', calendar.getName());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
id | String | mã lịch để đăng ký |
options | Object | đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
color | String | một chuỗi màu thập lục phân ("#rrggbb") hoặc một giá trị từ CalendarApp.Colors |
hidden | Boolean | liệu lịch có bị ẩn trong giao diện người dùng hay không (mặc định:
false ) |
selected | Boolean | các sự kiện của lịch có hiển thị trong giao diện
người dùng hay không (mặc định: true ) |
Cầu thủ trả bóng
Calendar
— lịch mới đăng ký
Gửi
Error
— nếu không có lịch nào có mã nhận dạng này
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds