Class CalendarApp

Ứng dụng Lịch

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 lịch bổ sung mà người dùng sở hữu hoặc đã đăng ký.

Thuộc tính

Thuộc tínhLoạiMô tả
ColorColorMột enum cho thấy các màu được đặt tên có trong dịch vụ Lịch.
EventColorEventColorMột enum đại diện cho các màu sự kiện có tên trong dịch vụ Lịch.
GuestStatusGuestStatusMột enum cho biết các trạng thái mà một khách có thể có trong một sự kiện.
MonthMonthMột enum đại diện cho các tháng trong năm.
VisibilityVisibilityEnum biểu thị chế độ hiển thị của một sự kiện.
WeekdayWeekdayMột enum cho biết các ngày trong tuần.

Phương pháp

Phương thứcLoại dữ liệu trả vềMô tả ngắn
createAllDayEvent(title, date)CalendarEventTạo một sự kiện kéo dài cả ngày.
createAllDayEvent(title, startDate, endDate)CalendarEventTạ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)CalendarEventTạ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)CalendarEventTạo một sự kiện kéo dài cả ngày.
createAllDayEventSeries(title, startDate, recurrence)CalendarEventSeriesTạo một chuỗi sự kiện kéo dài cả ngày.
createAllDayEventSeries(title, startDate, recurrence, options)CalendarEventSeriesTạo một chuỗi sự kiện kéo dài cả ngày.
createCalendar(name)CalendarTạo lịch mới, thuộc sở hữu của người dùng.
createCalendar(name, options)CalendarTạo lịch mới, thuộc sở hữu của người dùng.
createEvent(title, startTime, endTime)CalendarEventTạo một sự kiện mới.
createEvent(title, startTime, endTime, options)CalendarEventTạo một sự kiện mới.
createEventFromDescription(description)CalendarEventTạo một sự kiện từ phần mô tả biểu mẫu tuỳ ý.
createEventSeries(title, startTime, endTime, recurrence)CalendarEventSeriesTạo một chuỗi sự kiện mới.
createEventSeries(title, startTime, endTime, recurrence, options)CalendarEventSeriesTạo một chuỗi sự kiện mới.
getAllCalendars()Calendar[]Xem tất 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)CalendarLấy lịch bằng mã nhận dạng đã cho.
getCalendarsByName(name)Calendar[]Lấy tất cả lịch có tên cụ thể mà người dùng sở hữu hoặc đã đăng ký.
getColor()StringXem màu của lịch.
getDefaultCalendar()CalendarXem lịch mặc định của người dùng.
getDescription()StringXem nội dung mô tả về lịch.
getEventById(iCalId)CalendarEventXem sự kiện có mã nhận dạng đã cho.
getEventSeriesById(iCalId)CalendarEventSeriesXem chuỗi sự kiện có mã nhận dạng nhất định.
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 các tiêu chí được chỉ định.
getEventsForDay(date)CalendarEvent[]Lấy tất cả các sự kiện xảy ra vào một ngày cụ thể.
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í được chỉ định.
getId()StringLấy mã nhận dạng của lịch.
getName()StringLấy tên lịch.
getOwnedCalendarById(id)CalendarLấy lịch bằng mã nhận dạng nhất định, nếu người dùng sở hữu lịch.
getOwnedCalendarsByName(name)Calendar[]Lấy tất cả lịch có tên cụ thể mà người dùng sở hữu.
getTimeZone()StringXem múi giờ của lịch.
isHidden()BooleanXác định xem lịch có bị ẩn trong giao diện người dùng hay không.
isMyPrimaryCalendar()BooleanXác định xem lịch có phải là lịch mặc định cho người dùng hiệu quả hay không.
isOwnedByMe()BooleanXác định xem lịch có thuộc sở hữu của người dùng hiệu quả hay không.
isSelected()BooleanXác định xem các sự kiện trên lịch có hiển thị trong giao diện người dùng hay không.
newRecurrence()EventRecurrenceTạo một đối tượng lặp lại mới có thể dùng để 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 mô tả lịch.
setHidden(hidden)CalendarĐặt lịch có hiển thị trong giao diện người dùng hay không.
setName(name)CalendarĐặt tên cho lịch.
setSelected(selected)CalendarThiết lập liệu các sự kiện trên lịch có hiển thị trong giao diện người dùng hay không.
setTimeZone(timeZone)CalendarĐặt múi giờ của lịch.
subscribeToCalendar(id)CalendarĐăng ký người dùng với lịch bằng ID đã cho nếu người dùng được phép đăng ký.
subscribeToCalendar(id, options)CalendarĐăng ký người dùng với lịch bằng ID đã cho nếu người dùng được phép đăng ký.

Tài liệu chi tiết

createAllDayEvent(title, date)

Tạo một sự kiện kéo dà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ênLoạiMô tả
titleStringTiêu đề của sự kiện.
dateDateNgày diễn ra sự kiện (chỉ dùng ngày; thời gian bị bỏ qua).

Hai chiều

CalendarEvent — Sự kiện đã tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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ênLoạiMô tả
titleStringTiêu đề của sự kiện.
startDateDateNgày bắt đầu sự kiện (chỉ sử dụng ngày; thời gian bị bỏ qua).
endDateDateNgày kết thúc sự kiện (chỉ sử dụng ngày mà thời gian bỏ qua). Không có ngày kết thúc.

Hai chiều

CalendarEvent — Sự kiện đã tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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ênLoạiMô tả
titleStringTiêu đề của sự kiện.
startDateDateNgày bắt đầu sự kiện (chỉ sử dụng ngày; thời gian bị bỏ qua).
endDateDateNgày kết thúc sự kiện (chỉ sử dụng ngày mà thời gian bỏ qua). Không có ngày kết thúc.
optionsObjectĐố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ênLoạiMô tả
descriptionStringPhần mô tả sự kiện.
locationStringĐịa điểm diễn ra sự kiện.
guestsStringDanh sách các địa chỉ email được phân tách bằng dấu phẩy mà bạn sẽ thêm làm khách.
sendInvitesBooleanLiệu có gửi email lời mời hay không (mặc định: false).

Hai chiều

CalendarEvent — Sự kiện đã tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 kéo dà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ênLoạiMô tả
titleStringTiêu đề của sự kiện.
dateDateNgày diễn ra sự kiện (chỉ dùng ngày; thời gian bị bỏ qua).
optionsObjectĐố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ênLoạiMô tả
descriptionStringPhần mô tả sự kiện.
locationStringĐịa điểm diễn ra sự kiện.
guestsStringDanh sách các địa chỉ email được phân tách bằng dấu phẩy mà bạn sẽ thêm làm khách.
sendInvitesBooleanLiệu có gửi email lời mời hay không (mặc định: false).

Hai chiều

CalendarEvent — Sự kiện đã tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createAllDayEventSeries(title, startDate, recurrence)

Tạo một chuỗi sự kiện kéo dà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ênLoạiMô tả
titleStringtiêu đề của các sự kiện trong loạt sự kiện
startDateDatengày của sự kiện đầu tiên trong chuỗi (chỉ sử dụng ngày; thời gian bị bỏ qua)
recurrenceEventRecurrencechế độ cài đặt lặp lại của chuỗi sự kiện

Hai chiều

CalendarEventSeries — chuỗi sự kiện được tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createAllDayEventSeries(title, startDate, recurrence, options)

Tạo một chuỗi sự kiện kéo dà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ênLoạiMô tả
titleStringtiêu đề của các sự kiện trong loạt sự kiện
startDateDatengày của sự kiện đầu tiên trong chuỗi (chỉ sử dụng ngày; thời gian bị bỏ qua)
recurrenceEventRecurrencechế độ cài đặt lặp lại của chuỗi sự kiện
optionsObjectđối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

TênLoạiMô tả
descriptionStringnội dung mô tả về các sự kiện trong chuỗi sự kiện
locationStringvị trí của các sự kiện trong chuỗi sự kiện
guestsStringdanh sách các địa chỉ email được phân tách bằng dấu phẩy nên được thêm với tư cách khách vào các sự kiện trong chuỗi
sendInvitesBooleancó gửi email mời hay không (mặc định: false)

Hai chiều

CalendarEventSeries — chuỗi sự kiện được tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createCalendar(name)

Tạo lịch mới, thuộc sở hữu của người dùng.

// 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ênLoạiMô tả
nameStringtên lịch mới

Hai chiều

Calendar — lịch mới được tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createCalendar(name, options)

Tạo lịch mới, thuộc sở hữu của người dùng.

// 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ênLoạiMô tả
nameStringtên lịch mới
optionsObjectđối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

TênLoạiMô tả
locationStringvị trí của lịch
summaryStringnội dung mô tả của lịch
timeZoneStringmúi giờ để đặt lịch được chỉ định ở định dạng "dài" (ví dụ: "America/New_York", theo danh sách của Joda.org)
colorStringchuỗi màu thập lục phân ("#rrggbb") hoặc giá trị từ CalendarApp.Colors
hiddenBooleanlịch có bị ẩn trong giao diện người dùng hay không (mặc định: false)
selectedBooleancác sự kiện của lịch có được hiển thị trong giao diện người dùng hay không (mặc định: true)

Hai chiều

Calendar — lịch mới được tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEvent(title, startTime, endTime)

Tạo một sự kiện mới.

Nếu không chỉ định múi giờ, các giá trị thời gian sẽ được diễn giải theo múi giờ của tập lệnh, 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ênLoạiMô tả
titleStringtiêu đề của sự kiện
startTimeDatengày và giờ bắt đầu sự kiện
endTimeDatengày và giờ kết thúc sự kiện

Hai chiều

CalendarEvent — sự kiện đã tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEvent(title, startTime, endTime, options)

Tạo một sự kiện mới.

Nếu không chỉ định múi giờ, các giá trị thời gian sẽ được diễn giải theo múi giờ của tập lệnh, 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ênLoạiMô tả
titleStringtiêu đề của sự kiện
startTimeDatengày và giờ bắt đầu sự kiện
endTimeDatengày và giờ kết thúc sự kiện
optionsObjectđối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

TênLoạiMô tả
descriptionStringmô tả về sự kiện
locationStringvị trí của sự kiện
guestsStringdanh sách các địa chỉ email được phân tách bằng dấu phẩy nên được thêm làm khách
sendInvitesBooleancó gửi email mời hay không (mặc định: false)

Hai chiều

CalendarEvent — sự kiện đã tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEventFromDescription(description)

Tạo một sự kiện từ phần mô tả biểu mẫu tuỳ ý.

Phần 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ênLoạiMô tả
descriptionStringnội dung mô tả tự do về sự kiện

Hai chiều

CalendarEvent — sự kiện đã tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEventSeries(title, startTime, endTime, recurrence)

Tạo một 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ênLoạiMô tả
titleStringtiêu đề của các sự kiện trong loạt sự kiện
startTimeDatengày và giờ bắt đầu sự kiện đầu tiên trong chuỗi sự kiện
endTimeDatengày và giờ kết thúc sự kiện đầu tiên trong chuỗi sự kiện
recurrenceEventRecurrencechế độ cài đặt lặp lại của chuỗi sự kiện

Hai chiều

CalendarEventSeries — chuỗi sự kiện được tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEventSeries(title, startTime, endTime, recurrence, options)

Tạo một 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ênLoạiMô tả
titleStringtiêu đề của các sự kiện trong loạt sự kiện
startTimeDatengày và giờ bắt đầu sự kiện đầu tiên trong chuỗi sự kiện
endTimeDatengày và giờ kết thúc sự kiện đầu tiên trong chuỗi sự kiện
recurrenceEventRecurrencechế độ cài đặt lặp lại của chuỗi sự kiện
optionsObjectđối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

TênLoạiMô tả
descriptionStringnội dung mô tả về các sự kiện trong chuỗi sự kiện
locationStringvị trí của các sự kiện trong chuỗi sự kiện
guestsStringdanh sách các địa chỉ email được phân tách bằng dấu phẩy nên được thêm với tư cách khách vào các sự kiện trong chuỗi
sendInvitesBooleancó gửi email mời hay không (mặc định: false)

Hai chiều

CalendarEventSeries — chuỗi sự kiện được tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

getAllCalendars()

Xem tất 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);

Hai chiều

Calendar[] — tất 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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);

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 bằng 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ênLoạiMô tả
idStringmã lịch

Hai chiều

Calendar – lịch có mã nhận dạng nhất định 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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ả 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ênLoạiMô tả
nameStringtên lịch

Hai chiều

Calendar[] — tất cả những 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getColor()

Xem màu của lịch.

Hai chiều

String — một 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getDefaultCalendar()

Xem 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());

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getDescription()

Xem nội dung mô tả về lịch.

Hai chiều

String — phần mô tả của lịch này

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getEventById(iCalId)

Xem sự kiện có mã nhận dạng đã cho. Nếu chuỗi sự kiện thuộc về một lịch không phải là 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ột mã nhận dạng nếu các sự kiện đó 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 từ chuỗi đó.

Các tham số

TênLoạiMô tả
iCalIdStringMã sự kiện

Hai chiều

CalendarEvent – sự kiện có mã nhận dạng nhất định 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getEventSeriesById(iCalId)

Xem chuỗi sự kiện có mã nhận dạng nhất định. Nếu mã nhận dạng được cung cấp cho một CalendarEvent, thì CalendarEventSeries sẽ được trả về kèm theo 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ề 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 có trong lịch mặc định.

Các tham số

TênLoạiMô tả
iCalIdStringMã của chuỗi sự kiện

Hai chiều

CalendarEventSeries – bộ sách có mã nhận dạng nhất định 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 không chỉ định múi giờ, thì các giá trị thời gian sẽ được diễn giải trong ngữ cảnh của múi giờ của tập lệnh, 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ênLoạiMô tả
startTimeDatebắt đầu phạm vi thời gian
endTimeDatekết thúc phạm vi thời gian, không bao gồm

Hai chiều

CalendarEvent[] — những 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 các tiêu chí được 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 đã cho, kết thúc trong phạm vi thời gian đó hoặc bao gồm phạm vi thời gian. Nếu không chỉ định múi giờ, thì các giá trị thời gian sẽ được diễn giải trong ngữ cảnh của múi giờ của tập lệnh, có thể khác với múi giờ của lịch.

Xin lưu ý rằng quá trình lọc trên author, search hoặc statusFilters sẽ diễn ra sau khi áp dụng startmax. Đ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 đá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ênLoạiMô tả
startTimeDatebắt đầu phạm vi thời gian
endTimeDatekết thúc phạm vi thời gian, không bao gồm
optionsObjectđối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

TênLoạiMô tả
startIntegerchỉ mục của sự kiện đầu tiên để trả về
maxIntegersố sự kiện tối đa cần trả về
authorStringđịa chỉ email dùng để lọc kết quả theo người tạo sự kiện
searchStringcụm từ tìm kiếm dạng văn bản đầy đủ dùng để lọc kết quả
statusFilters[]GuestStatusmột loạt các trạng thái dùng để lọc kết quả

Hai chiều

CalendarEvent[] — những sự kiện diễn ra trong phạm vi thời gian 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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ả các sự kiện xảy ra vào một ngày cụ thể.

Phương thức này trả về các sự kiện nếu chúng bắt đầu vào ngày đã cho, kết thúc trong ngày hoặc bao gồm trong ngày.

Hãy lưu ý rằng chỉ sử dụng phần ngày của đối tượng Ngày, và phần thời gian sẽ bị bỏ qua. Ngày này được hiểu là nửa đêm của ngày hôm đó đế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ênLoạiMô tả
dateDatengày truy xuất sự kiện (chỉ sử dụng ngày; thời gian bị bỏ qua)

Hai chiều

CalendarEvent[] — các sự kiện xảy ra vào ngày cụ thể

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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í được chỉ định.

Phương thức này trả về các sự kiện nếu chúng bắt đầu vào ngày đã cho, kết thúc trong ngày hoặc bao gồm trong ngày.

Hãy lưu ý rằng chỉ sử dụng phần ngày của đối tượng Ngày, và phần thời gian sẽ bị bỏ qua. Ngày này được hiểu là nửa đêm của ngày hôm đó đế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 trên author, search hoặc statusFilters sẽ diễn ra sau khi áp dụng startmax. Đ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 đá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ênLoạiMô tả
dateDatengày truy xuất sự kiện (chỉ sử dụng ngày; thời gian bị bỏ qua)
optionsObjecttuỳ chọn lọc nâng cao

Thông số nâng cao

TênLoạiMô tả
startIntegerchỉ mục của sự kiện đầu tiên để trả về
maxIntegersố sự kiện tối đa cần trả về
authorStringđịa chỉ email dùng để lọc kết quả theo người tạo sự kiện
searchStringcụm từ tìm kiếm dạng văn bản đầy đủ dùng để lọc kết quả
statusFilters[]GuestStatusmột loạt các trạng thái dùng để lọc kết quả

Hai chiều

CalendarEvent[] — những sự kiện xảy ra vào ngày đã cho 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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ọ.

Hai chiều

String — mã nhận dạng của lịch

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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.

Hai chiều

String — tên lịch này

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 bằng mã nhận dạng nhất định, 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 rồi chọn Cài đặt lịch. Mã nhận dạng này sẽ xuất hiện ở 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ênLoạiMô tả
idStringmã lịch

Hai chiều

Calendar – lịch có mã nhận dạng nhất định 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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ả 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ênLoạiMô tả
nameStringtên lịch

Hai chiều

Calendar[] — tất cả những 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getTimeZone()

Xem múi giờ của lịch.

Hai chiều

String — múi giờ, được chỉ định ở định dạng "dài" (ví dụ: "America/New_York", theo danh sách của Joda.org)

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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.

Hai chiều

Booleantrue nếu lịch bị ẩn trong giao diện người dùng; false nếu không được ẩn

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 mặc định cho người dùng hiệu quả hay không.

Hai chiều

Booleantrue nếu lịch là lịch mặc định cho người dùng hiệu quả; false nếu không phải là lịch

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 lịch có thuộc sở hữu của người dùng hiệu quả hay không.

Hai chiều

Booleantrue nếu lịch đó thuộc sở hữu của người dùng có hiệu lực; false nếu không

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 trên lịch có hiển thị trong giao diện người dùng hay không.

Hai chiều

Booleantrue nếu các sự kiện trên lịch xuất hiện trong giao diện người dùng; false nếu không

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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 có thể dùng để 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());

Hai chiều

EventRecurrence — một đối tượng lặp lại mới chưa đặt quy tắc (hoạt động dưới dạng 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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.

Các tham số

TênLoạiMô tả
colorStringChuỗi màu thập lục phân ("#rrggbb") hoặc giá trị từ CalendarApp.Color.

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setDescription(description)

Đặt mô tả lịch.

Các tham số

TênLoạiMô tả
descriptionStringnội dung mô tả của lịch này

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setHidden(hidden)

Đặt lịch có hiển thị trong giao diện người dùng hay không.

Các tham số

TênLoạiMô tả
hiddenBooleantrue để ẩn lịch trong giao diện người dùng; false để hiện lịch

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setName(name)

Đặt tên cho lịch.

Các tham số

TênLoạiMô tả
nameStringtên mới

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setSelected(selected)

Thiết lập liệu các sự kiện trên lịch có hiển thị trong giao diện người dùng hay không.

Các tham số

TênLoạiMô tả
selectedBooleantrue để hiện các sự kiện của lịch trong giao diện người dùng; false để ẩn những sự kiện đó

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setTimeZone(timeZone)

Đặt múi giờ của lịch.

Các tham số

TênLoạiMô tả
timeZoneStringmúi giờ, được chỉ định ở định dạng "dài" (ví dụ: "America/New_York", theo danh sách của Joda.org)

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

subscribeToCalendar(id)

Đăng ký người dùng với lịch bằng ID đã cho nếu người dùng đượ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ênLoạiMô tả
idStringmã lịch mà bạn có thể đăng ký

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST 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ới lịch bằng ID đã cho nếu người dùng đượ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ênLoạiMô tả
idStringmã lịch mà bạn có thể đăng ký
optionsObjectđối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

TênLoạiMô tả
colorStringchuỗi màu thập lục phân ("#rrggbb") hoặc giá trị từ CalendarApp.Colors
hiddenBooleanlịch có bị ẩn trong giao diện người dùng hay không (mặc định: false)
selectedBooleancác sự kiện của lịch có được hiển thị trong giao diện người dùng hay không (mặc định: true)

Hai chiều

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc phạm vi thích hợp từ API REST liên quan:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds