Class CalendarApp

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 các 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 đại diện cho 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 tên có trong dịch vụ Lịch.
GuestStatus	GuestStatus	Một enum đại diện cho 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 enum đại diện cho chế độ hiển thị của một sự kiện.
Weekday	Weekday	Một enum đại diện cho các ngày trong tuần.

Phương thức

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 mới.
createAllDayEvent(title, startDate, endDate)	CalendarEvent	Tạo một sự kiện kéo dài cả ngày mới có thể kéo dài nhiều ngày.
createAllDayEvent(title, startDate, endDate, options)	CalendarEvent	Tạo một sự kiện kéo dài cả ngày mới 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 mới.
createAllDayEventSeries(title, startDate, recurrence)	CalendarEventSeries	Tạo một chuỗi sự kiện kéo dài cả ngày mới.
createAllDayEventSeries(title, startDate, recurrence, options)	CalendarEventSeries	Tạo một chuỗi sự kiện kéo dài cả ngày mới.
createCalendar(name)	Calendar	Tạo một lịch mới do người dùng sở hữu.
createCalendar(name, options)	Calendar	Tạo một lịch mới do người dùng sở hữu.
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 sự kiện từ nội dung mô tả ở dạng 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[]	Lấy 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 có mã được cung cấp.
getCalendarsByName(name)	Calendar[]	Lấy tất cả lịch có tên nhất định mà người dùng sở hữu hoặc đăng ký.
getColor()	String	Lấy 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 có mã nhận dạng đã cho.
getEventSeriesById(iCalId)	CalendarEventSeries	Lấy chuỗi sự kiện có 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 các 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 cụ thể.
getEventsForDay(date, options)	CalendarEvent[]	Lấy tất cả sự kiện xảy ra vào một ngày cụ thể và đáp ứng các tiêu chí đã chỉ định.
getId()	String	Lấy mã của lịch.
getName()	String	Lấy tên của lịch.
getOwnedCalendarById(id)	Calendar	Lấy lịch có 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ả lịch có tên nhất định 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 hiệu quả 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 định kỳ mới, có thể dùng để tạo quy tắc cho sự kiện định kỳ.
setColor(color)	Calendar	Đặt màu cho lịch.
setDescription(description)	Calendar	Đặt nội dung mô tả của lịch.
setHidden(hidden)	Calendar	Thiết lập xem 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	Đặ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ờ của lịch.
subscribeToCalendar(id)	Calendar	Đăng ký người dùng vào lịch có mã nhận dạng đã cho, nếu người dùng được phép đăng ký.
subscribeToCalendar(id, options)	Calendar	Đăng ký người dùng vào lịch có mã nhận dạng đã 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 mới.

// Creates an all-day event for the moon landing and logs the ID.
const event = CalendarApp.getDefaultCalendar().createAllDayEvent(
    'Apollo 11 Landing',
    new Date('July 20, 1969'),
);
Logger.log(`Event ID: ${event.getId()}`);

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ỉ sử dụng ngày; bỏ qua giờ).

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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 kéo dài cả ngày mới 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.
const event = CalendarApp.getDefaultCalendar().createAllDayEvent(
    'Woodstock Festival',
    new Date('August 15, 1969'),
    new Date('August 18, 1969'),
);
Logger.log(`Event ID: ${event.getId()}`);

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 sẽ bị bỏ qua).
endDate	Date	Ngày kết thúc sự kiện (chỉ sử dụng ngày; thời gian sẽ bị bỏ qua). Ngày kết thúc không bao gồm ngày đó.

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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 kéo dài cả ngày mới 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.
const 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()}`);

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 sẽ bị bỏ qua).
endDate	Date	Ngày kết thúc sự kiện (chỉ sử dụng ngày; thời gian sẽ bị bỏ qua). Ngày kết thúc không bao gồm ngày đó.
options	Object	Một đố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ả 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 muốn 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 kéo dài cả ngày mới.

// Creates an all-day event for the moon landing and logs the ID.
const event = CalendarApp.getDefaultCalendar().createAllDayEvent(
    'Apollo 11 Landing',
    new Date('July 20, 1969'),
    {location: 'The Moon'},
);
Logger.log(`Event ID: ${event.getId()}`);

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ỉ sử dụng ngày; bỏ qua giờ).
options	Object	Một đố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ả 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 muốn 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 một chuỗi sự kiện kéo dài cả ngày mới.

// Creates an event series for a no-meetings day, taking place every Wednesday
// in 2013.
const 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()}`);

Tham số

Tên	Loại	Mô tả
title	String	tiêu đề của các sự kiện trong chuỗi sự kiện
startDate	Date	ngày của sự kiện đầu tiên trong chuỗi sự kiện (chỉ sử dụng ngày; thời gian sẽ bị bỏ qua)
recurrence	EventRecurrence	chế độ cài đặt định kỳ của loạt 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 một chuỗi sự kiện kéo dài cả ngày mới.

// Creates an event series for a no-meetings day, taking place every Wednesday
// in 2013.
const 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: '[e-mail]'},
);
Logger.log(`Event Series ID: ${eventSeries.getId()}`);

Tham số

Tên	Loại	Mô tả
title	String	tiêu đề của các sự kiện trong chuỗi sự kiện
startDate	Date	ngày của sự kiện đầu tiên trong chuỗi sự kiện (chỉ sử dụng ngày; thời gian sẽ bị bỏ qua)
recurrence	EventRecurrence	chế độ cài đặt định kỳ của loạt sự kiện
options	Object	một đố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ả 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 địa chỉ email được phân tách bằng dấu phẩy mà bạn muốn thêm vào sự kiện trong chuỗi sự kiện với tư cách là khách
sendInvites	Boolean	có gửi email 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

---

createCalendar(name)

Tạo một lịch mới do người dùng sở hữu.

// Creates a new calendar named "Travel Plans".
const calendar = CalendarApp.createCalendar('Travel Plans');
Logger.log(
    'Created the calendar "%s", with the ID "%s".',
    calendar.getName(),
    calendar.getId(),
);

Tham số

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

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

---

createCalendar(name, options)

Tạo một lịch mới do người dùng sở hữu.

// Creates a new calendar named "Travel Plans" with a description and color.
const calendar = CalendarApp.createCalendar('Travel Plans', {
  description: '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(),
);

Tham số

Tên	Loại	Mô tả
name	String	tên của lịch mới
options	Object	một đố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
description	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	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	liệu 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 một sự kiện mới.

Nếu bạn không chỉ định múi giờ, thì các giá trị thời gian sẽ được diễn giải theo ngữ cảnh của 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.
const 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()}`);

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

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 một sự kiện mới.

Nếu bạn không chỉ định múi giờ, thì các giá trị thời gian sẽ được diễn giải theo ngữ cảnh của 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.
const 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()}`);

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	một đố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ả 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 muốn thêm vào dưới dạng khách
sendInvites	Boolean	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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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ừ nội dung mô tả ở dạng tuỳ ý.

Nội dung 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.
const event = CalendarApp.getDefaultCalendar().createEventFromDescription(
    'Lunch with Mary, Friday at 1PM',
);
Logger.log(`Event ID: ${event.getId()}`);

Tham số

Tên	Loại	Mô tả
description	String	nội dung mô tả sự kiện ở dạng tự do

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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 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.
const 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()}`);

Tham số

Tên	Loại	Mô tả
title	String	tiêu đề của các sự kiện trong chuỗi 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 định kỳ của loạt 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 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.
const 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()}`);

Tham số

Tên	Loại	Mô tả
title	String	tiêu đề của các sự kiện trong chuỗi 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 định kỳ của loạt sự kiện
options	Object	một đố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ả 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 địa chỉ email được phân tách bằng dấu phẩy mà bạn muốn thêm vào sự kiện trong chuỗi sự kiện với tư cách là khách
sendInvites	Boolean	có gửi email 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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ả lịch mà người dùng sở hữu hoặc đăng ký.

// Determines how many calendars the user can access.
const 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ả 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 các phạm vi thích hợp 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.
const calendars = CalendarApp.getAllOwnedCalendars();
Logger.log('This user owns %s calendars.', calendars.length);

Cầu thủ trả bóng

Calendar[] – tất 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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ã được cung cấp.

// Gets the public calendar "US Holidays" by ID.
const calendar = CalendarApp.getCalendarById(
    'en.usa#[e-mail]',
);
Logger.log('The calendar is named "%s".', calendar.getName());

Tham số

Tên	Loại	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 không đă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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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ả lịch có tên nhất định 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".
const calendars = CalendarApp.getCalendarsByName('US Holidays');
Logger.log('Found %s matching calendars.', calendars.length);

Tham số

Tên	Loại	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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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()

Lấy màu của lịch.

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('[e-mail]');

// 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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.
const 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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('[e-mail]');

// 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 có mã nhận dạng đã cho. Nếu chuỗi sự kiện thuộc một lịch khác với lịch mặc định, thì bạn phải gọi phương thức này 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 loạt 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 đó.

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('[e-mail]');

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

Tham số

Tên	Loại	Mô tả
iCalId	String	Mã 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 có mã nhận dạng đã cho. Nếu mã nhận dạng được cung cấp là cho một CalendarEvent, thì CalendarEventSeries sẽ được trả về với một sự kiện 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ì bạn phải gọi phương thức này từ CalendarApp đó; việc gọi trực tiếp getEventSeriesById(iCalId) 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('[e-mail]');

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

Tham số

Tên	Loại	Mô tả
iCalId	String	Mã của chuỗi sự kiện.

Cầu thủ trả bóng

CalendarEventSeries – Chuỗi có mã nhận dạng đã cho hoặc null nếu chuỗi không tồn tại hoặc người dùng không thể truy cập và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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 đã 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 bạn không chỉ định múi giờ, các giá trị thời gian sẽ được diễn giải theo ngữ cảnh của 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.
const now = new Date();
const twoHoursFromNow = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow);
Logger.log(`Number of events: ${events.length}`);

Tham số

Tên	Loại	Mô tả
startTime	Date	thời điểm bắt đầu của phạm vi thời gian
endTime	Date	thời điểm 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 các 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 đã 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 bạn không chỉ định múi giờ, các giá trị thời gian sẽ được diễn giải theo ngữ cảnh của 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 việc 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 khác đáp ứng tiêu chí.

// Determines how many events are happening in the next two hours that contain
// the term "meeting".
const now = new Date();
const twoHoursFromNow = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const events = CalendarApp.getDefaultCalendar().getEvents(
    now,
    twoHoursFromNow,
    {search: 'meeting'},
);
Logger.log(`Number of events: ${events.length}`);

Tham số

Tên	Loại	Mô tả
startTime	Date	thời điểm bắt đầu của phạm vi thời gian
endTime	Date	thời điểm kết thúc phạm vi thời gian, không bao gồm
options	Object	một đố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 cần trả về
max	Integer	số lượng 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 toàn bộ văn bản dùng để lọc kết quả
statusFilters[]	GuestStatus	một mảng trạng thái 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à 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 cụ thể.

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

Xin lưu ý rằng chỉ phần ngày của đối tượng Date được sử dụng và phần giờ sẽ bị bỏ qua. Ngày được diễn giải là từ 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.
const today = new Date();
const events = CalendarApp.getDefaultCalendar().getEventsForDay(today);
Logger.log(`Number of events: ${events.length}`);

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 sẽ bị bỏ qua)

Cầu thủ trả bóng

CalendarEvent[] – các sự kiện xảy ra vào ngày đã cho

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 chúng bắt đầu trong ngày đã cho, kết thúc trong ngày hoặc diễn ra trong ngày.

Xin lưu ý rằng chỉ phần ngày của đối tượng Date được sử dụng và phần giờ sẽ bị bỏ qua. Ngày được diễn giải là từ 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 việc 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 khác đáp ứng tiêu chí.

// Determines how many events are happening today and contain the term
// "meeting".
const today = new Date();
const events = CalendarApp.getDefaultCalendar().getEventsForDay(today, {
  search: 'meeting',
});
Logger.log(`Number of events: ${events.length}`);

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 sẽ bị bỏ qua)
options	Object	các 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 cần trả về
max	Integer	số lượng 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 toàn bộ văn bản dùng để lọc kết quả
statusFilters[]	GuestStatus	một mảng trạng thái 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 đã 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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ã 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('[e-mail]');

// 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ã 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 của lịch.

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('[e-mail]');

// 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 có 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 của lịch trong Lịch Google rồi chọn Cài đặt lịch. Mã này xuất hiện ở gần cuối trang cài đặt.

// Gets a (non-existent) private calendar by ID.
const calendar = CalendarApp.getOwnedCalendarById(
    '[e-mail]',
);
Logger.log('The calendar is named "%s".', calendar.getName());

Tham số

Tên	Loại	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 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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ả lịch có tên nhất định 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".
const calendars = CalendarApp.getOwnedCalendarsByName('Travel Plans');
Logger.log('Found %s matching calendars.', calendars.length);

Tham số

Tên	Loại	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 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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('[e-mail]');

// 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 "dài" (ví dụ: "Hoa Kỳ/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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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('[e-mail]');

// 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.

Ủy quyền

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

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('[e-mail]');

// 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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(
    '[e-mail]',
);

// 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 bạn sở hữu lịch; 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 các sự kiện trên lịch hiển thị 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 định kỳ mới, có thể dùng để tạo quy tắc cho sự kiện định kỳ.

// Creates an event series for a no-meetings day, taking place every Wednesday
// in 2013.
const recurrence = CalendarApp.newRecurrence()
                       .addWeeklyRule()
                       .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
                       .until(new Date('January 1, 2014'));
const 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 định kỳ mới chưa có quy tắc nào (hoạt động như một đối tượng định kỳ 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 cho lịch.

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('[e-mail]');

// 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);

Tham số

Tên	Loại	Mô tả
color	String	CalendarApp.Color hoặc 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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.');

Tham số

Tên	Loại	Mô tả
description	String	nội dung mô tả về lịch này

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

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

---

setHidden(hidden)

Thiết lập xem lịch có hiển thị trong giao diện người dùng hay không.

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 thị lịch

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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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');

Tham số

Tên	Loại	Mô tả
name	String	tên mới

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

Tham số

Tên	Loại	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 để 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 được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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ờ của 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');

Tham số

Tên	Loại	Mô tả
timeZone	String	Múi giờ, được chỉ định ở định dạng "dài" (chẳng hạn như "Hoa Kỳ/New_York", như được 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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 có mã nhận dạng đã cho, nếu người dùng được phép đăng ký.

// Subscribe to the calendar "US Holidays".
const calendar = CalendarApp.subscribeToCalendar(
    'en.usa#[e-mail]',
);
Logger.log('Subscribed to the calendar "%s".', calendar.getName());

Tham số

Tên	Loại	Mô tả
id	String	mã của lịch cần đăng ký

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 yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 có mã nhận dạng đã 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.
const calendar = CalendarApp.subscribeToCalendar(
    'en.usa#[e-mail]',
    {color: CalendarApp.Color.BLUE},
);
Logger.log('Subscribed to the calendar "%s".', calendar.getName());

Tham số

Tên	Loại	Mô tả
id	String	Mã của lịch cần đăng ký.
options	Object	Một đố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	Liệu lịch có bị ẩn trong giao diện người dùng hay không (mặc định: false).
selected	Boolean	Liệu 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 nếu color cũng được chỉ định, false nếu không).

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

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