Trang này được dịch bởi Cloud Translation API.

Class CalendarApp

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ính	Loại	Mô tả
`Color`	`Color`	Một enum cho thấy các màu được đặt tên có trong dịch vụ Lịch.
`EventColor`	`EventColor`	Một enum đại diện cho các màu sự kiện có tên trong dịch vụ Lịch.
`GuestStatus`	`GuestStatus`	Mộ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.
`Month`	`Month`	Một enum đại diện cho các tháng trong năm.
`Visibility`	`Visibility`	Enum biểu thị chế độ hiển thị của một sự kiện.
`Weekday`	`Weekday`	Một enum cho biết các ngày trong tuần.

Phương pháp

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`createAllDayEvent(title, date)`	`CalendarEvent`	Tạo một sự kiện kéo dà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 kéo dài cả ngày.
`createAllDayEventSeries(title, startDate, recurrence)`	`CalendarEventSeries`	Tạo một chuỗi sự kiện kéo dài cả ngày.
`createAllDayEventSeries(title, startDate, recurrence, options)`	`CalendarEventSeries`	Tạo một chuỗi sự kiện kéo dài cả ngày.
`createCalendar(name)`	`Calendar`	Tạo lịch mới, thuộc sở hữu của người dùng.
`createCalendar(name, options)`	`Calendar`	Tạo lịch mới, thuộc sở hữu của người dùng.
`createEvent(title, startTime, endTime)`	`CalendarEvent`	Tạo một sự kiện mới.
`createEvent(title, startTime, endTime, options)`	`CalendarEvent`	Tạo một sự kiện mới.
`createEventFromDescription(description)`	`CalendarEvent`	Tạo một sự kiện từ phần mô tả biểu mẫu tuỳ ý.
`createEventSeries(title, startTime, endTime, recurrence)`	`CalendarEventSeries`	Tạo một chuỗi sự kiện mới.
`createEventSeries(title, startTime, endTime, recurrence, options)`	`CalendarEventSeries`	Tạ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)`	`Calendar`	Lấ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()`	`String`	Xem màu của lịch.
`getDefaultCalendar()`	`Calendar`	Xem lịch mặc định của người dùng.
`getDescription()`	`String`	Xem nội dung mô tả về lịch.
`getEventById(iCalId)`	`CalendarEvent`	Xem sự kiện có mã nhận dạng đã cho.
`getEventSeriesById(iCalId)`	`CalendarEventSeries`	Xem 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()`	`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 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()`	`String`	Xem 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 mặc định cho người dùng hiệu quả hay không.
`isOwnedByMe()`	`Boolean`	Xác định xem lịch có thuộc sở hữu của người dùng hiệu quả hay không.
`isSelected()`	`Boolean`	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.
`newRecurrence()`	`EventRecurrence`	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.
`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)`	`Calendar`	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.
`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ên	Loại	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; 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ên	Loại	Mô tả
`title`	`String`	Tiêu đề của sự kiện.
`startDate`	`Date`	Ngày bắt đầu sự kiện (chỉ sử dụng ngày; thời gian bị bỏ qua).
`endDate`	`Date`	Ngà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ên	Loại	Mô tả
`title`	`String`	Tiêu đề của sự kiện.
`startDate`	`Date`	Ngày bắt đầu sự kiện (chỉ sử dụng ngày; thời gian bị bỏ qua).
`endDate`	`Date`	Ngà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.
`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	Mô tả
`description`	`String`	Phần mô tả sự kiện.
`location`	`String`	Địa điểm diễn ra sự kiện.
`guests`	`String`	Danh 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.
`sendInvites`	`Boolean`	Liệ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ên	Loại	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; thời gian bị bỏ qua).
`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	Mô tả
`description`	`String`	Phần mô tả sự kiện.
`location`	`String`	Địa điểm diễn ra sự kiện.
`guests`	`String`	Danh 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.
`sendInvites`	`Boolean`	Liệ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ên	Loại	Mô tả
`title`	`String`	tiêu đề của các sự kiện trong loạt sự kiện
`startDate`	`Date`	ngày của sự kiện đầu tiên trong chuỗi (chỉ sử dụng ngày; thời gian bị bỏ qua)
`recurrence`	`EventRecurrence`	chế độ 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ên	Loại	Mô tả
`title`	`String`	tiêu đề của các sự kiện trong loạt sự kiện
`startDate`	`Date`	ngày của sự kiện đầu tiên trong chuỗi (chỉ sử dụng ngày; thời gian bị bỏ qua)
`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ê bên dưới

Thông số nâng cao

Tên	Loại	Mô tả
`description`	`String`	nội dung mô tả về các sự kiện trong chuỗi sự kiện
`location`	`String`	vị trí của các sự kiện trong chuỗi sự kiện
`guests`	`String`	danh 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
`sendInvites`	`Boolean`	có 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ên	Loại	Mô tả
`name`	`String`	tê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ên	Loại	Mô tả
`name`	`String`	tên lịch mới
`options`	`Object`	đố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ên	Loại	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ờ để đặt lịch được chỉ định ở định dạng "dài" (ví dụ: "America/New_York", theo danh sách của Joda.org)
`color`	`String`	chuỗi màu thập lục phân ("#rrggbb") hoặc giá trị từ `CalendarApp.Colors`
`hidden`	`Boolean`	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ó đượ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ên	Loại	Mô tả
`title`	`String`	tiêu đề của sự kiện
`startTime`	`Date`	ngày và giờ bắt đầu sự kiện
`endTime`	`Date`	ngà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ên	Loại	Mô tả
`title`	`String`	tiêu đề của sự kiện
`startTime`	`Date`	ngày và giờ bắt đầu sự kiện
`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ê bên dưới

Thông số nâng cao

Tên	Loại	Mô tả
`description`	`String`	mô tả về sự kiện
`location`	`String`	vị trí của sự kiện
`guests`	`String`	danh 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
`sendInvites`	`Boolean`	có 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ên	Loại	Mô tả
`description`	`String`	nộ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ên	Loại	Mô tả
`title`	`String`	tiêu đề của các sự kiện trong loạt sự kiện
`startTime`	`Date`	ngày và giờ bắt đầu sự kiện đầu tiên trong chuỗi sự kiện
`endTime`	`Date`	ngày và giờ kết thúc sự kiện đầu tiên trong chuỗi sự kiện
`recurrence`	`EventRecurrence`	chế độ 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ên	Loại	Mô tả
`title`	`String`	tiêu đề của các sự kiện trong loạt sự kiện
`startTime`	`Date`	ngày và giờ bắt đầu sự kiện đầu tiên trong chuỗi sự kiện
`endTime`	`Date`	ngày và giờ kết thúc sự kiện đầu tiên trong chuỗi sự kiện
`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ê bên dưới

Thông số nâng cao

Tên	Loại	Mô tả
`description`	`String`	nội dung mô tả về các sự kiện trong chuỗi sự kiện
`location`	`String`	vị trí của các sự kiện trong chuỗi sự kiện
`guests`	`String`	danh 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
`sendInvites`	`Boolean`	có 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ên	Loại	Mô tả
`id`	`String`	mã 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ên	Loại	Mô tả
`name`	`String`	tê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ên	Loại	Mô tả
`iCalId`	`String`	Mã 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ên	Loại	Mô tả
`iCalId`	`String`	Mã 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ên	Loại	Mô tả
`startTime`	`Date`	bắt đầu phạm vi thời gian
`endTime`	`Date`	kế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 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 đá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	Mô tả
`startTime`	`Date`	bắt đầu phạm vi 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ê bên dưới

Thông số nâng cao

Tên	Loại	Mô tả
`start`	`Integer`	chỉ mục của sự kiện đầu tiên để trả về
`max`	`Integer`	số sự kiện tối đa cần trả về
`author`	`String`	địa chỉ email dùng để lọc kết quả theo người tạo sự kiện
`search`	`String`	cụm từ tìm kiếm dạng văn bản đầy đủ dùng để lọc kết quả
`statusFilters[]`	`GuestStatus`	mộ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ên	Loại	Mô tả
`date`	`Date`	ngà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.

// 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	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	Mô tả
`start`	`Integer`	chỉ mục của sự kiện đầu tiên để trả về
`max`	`Integer`	số sự kiện tối đa cần trả về
`author`	`String`	địa chỉ email dùng để lọc kết quả theo người tạo sự kiện
`search`	`String`	cụm từ tìm kiếm dạng văn bản đầy đủ dùng để lọc kết quả
`statusFilters[]`	`GuestStatus`	mộ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ên	Loại	Mô tả
`id`	`String`	mã 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ên	Loại	Mô tả
`name`	`String`	tê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

Boolean – true 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

Boolean — true 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

Boolean — true 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

Boolean – true 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ên	Loại	Mô tả
`color`	`String`	Chuỗ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ên	Loại	Mô tả
`description`	`String`	nộ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ên	Loại	Mô tả
`hidden`	`Boolean`	`true` để ẩ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ên	Loại	Mô tả
`name`	`String`	tê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ên	Loại	Mô tả
`selected`	`Boolean`	`true` để 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ên	Loại	Mô tả
`timeZone`	`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)

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ên	Loại	Mô tả
`id`	`String`	mã 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ên	Loại	Mô tả
`id`	`String`	mã lịch mà bạn có thể đăng ký
`options`	`Object`	đố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ên	Loại	Mô tả
`color`	`String`	chuỗi màu thập lục phân ("#rrggbb") hoặc giá trị từ `CalendarApp.Colors`
`hidden`	`Boolean`	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ó đượ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