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 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 biểu thị các màu được đặt tên có trong dịch vụ Lịch.
EventColorEventColorMột enum biểu thị màu sự kiện được đặt tên có trong dịch vụ Lịch.
GuestStatusGuestStatusMột giá trị enum thể hiện các trạng thái mà khách có thể có đối với một sự kiện.
MonthMonthMột giá trị enum đại diện cho các tháng trong năm.
VisibilityVisibilityMột giá trị enum thể hiện chế độ hiển thị của một sự kiện.
WeekdayWeekdayMột giá trị enum đại diện cho các ngày trong tuần.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
createAllDayEvent(title, date)CalendarEventTạo sự kiện cả ngày mới.
createAllDayEvent(title, startDate, endDate)CalendarEventTạo sự kiện cả ngày mới có thể kéo dài nhiều ngày.
createAllDayEvent(title, startDate, endDate, options)CalendarEventTạo sự kiện cả ngày mới có thể kéo dài nhiều ngày.
createAllDayEvent(title, date, options)CalendarEventTạo sự kiện cả ngày mới.
createAllDayEventSeries(title, startDate, recurrence)CalendarEventSeriesTạo chuỗi sự kiện mới kéo dài cả ngày.
createAllDayEventSeries(title, startDate, recurrence, options)CalendarEventSeriesTạo chuỗi sự kiện mới kéo dài cả ngày.
createCalendar(name)CalendarTạo lịch mới do người dùng sở hữu.
createCalendar(name, options)CalendarTạo lịch mới do người dùng sở hữu.
createEvent(title, startTime, endTime)CalendarEventTạo sự kiện mới.
createEvent(title, startTime, endTime, options)CalendarEventTạo sự kiện mới.
createEventFromDescription(description)CalendarEventTạo sự kiện từ nội dung mô tả dạng 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 có mã đã 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()CalendarLấy lịch mặc định của người dùng.
getDescription()StringXem nội dung mô tả của lịch.
getEventById(iCalId)CalendarEventLấy sự kiện có mã nhận dạng đã cho.
getEventSeriesById(iCalId)CalendarEventSeriesLấy chuỗi sự kiện có mã đã cho.
getEvents(startTime, endTime)CalendarEvent[]Lấy tất cả sự kiện xảy ra trong một phạm vi thời gian nhất định.
getEvents(startTime, endTime, options)CalendarEvent[]Lấy tất cả sự kiện xảy ra trong một phạm vi thời gian nhất định và đáp ứng tiêu chí đã chỉ định.
getEventsForDay(date)CalendarEvent[]Lấy tất cả sự kiện xảy ra vào một ngày 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 tiêu chí đã chỉ định.
getId()StringLấy mã lịch.
getName()StringXem tên lịch.
getOwnedCalendarById(id)CalendarLấ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 cụ thể mà người dùng sở hữu.
getTimeZone()StringLấy 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 chính cho người dùng hoạt động hiệu quả hay không.
isOwnedByMe()BooleanXác định xem lịch có phải do bạn sở hữu hay không.
isSelected()BooleanXá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()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 cho lịch.
setDescription(description)CalendarĐặt mô tả cho 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 xem các sự kiện của lịch có hiển thị trong giao diện người dùng hay không.
setTimeZone(timeZone)CalendarĐặt múi giờ cho lịch.
subscribeToCalendar(id)CalendarĐăng ký người dùng vào lịch bằng ID đã 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 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 sự kiện cả ngày mới. 

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

Tham số

TênLoạiMô tả
titleStringTiêu đề của sự kiện.
dateDateNgày của 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

createAllDayEvent(title, startDate, endDate)

Tạo sự kiện 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.
var 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ênLoạiMô tả
titleStringTiêu đề của sự kiện.
startDateDateNgày bắt đầu sự kiện (chỉ sử dụng ngày; bỏ qua thời gian).
endDateDateNgày kết thúc sự kiện (chỉ sử dụng ngày; bỏ qua thời gian). Chiến lược phát hành đĩa đơn chỉ có ngày kết thúc.

Cầu thủ trả bóng

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

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

createAllDayEvent(title, startDate, endDate, options)

Tạo sự kiện 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.
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());

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; bỏ qua thời gian).
endDateDateNgày kết thúc sự kiện (chỉ sử dụng ngày; bỏ qua thời gian). Chiến lược phát hành đĩa đơn chỉ 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ê bên dưới.

Thông số nâng cao

TênLoạiMô tả
descriptionStringNội dung mô tả về sự kiện.
locationStringĐịa điểm diễn ra sự kiện.
guestsStringDanh sách địa chỉ email được phân tách bằng dấu phẩy mà bạn nên thêm vào với tư cách khách.
sendInvitesBooleanLiệ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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

createAllDayEvent(title, date, options)

Tạo sự kiện cả ngày mới. 

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

Tham số

TênLoạiMô tả
titleStringTiêu đề của sự kiện.
dateDateNgày của sự kiện (chỉ sử dụng ngày; bỏ qua giờ).
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ề sự kiện.
locationStringĐịa điểm diễn ra sự kiện.
guestsStringDanh sách địa chỉ email được phân tách bằng dấu phẩy mà bạn nên thêm vào với tư cách khách.
sendInvitesBooleanLiệ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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

createAllDayEventSeries(title, startDate, recurrence)

Tạo chuỗi sự kiện mới 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());

Tham số

TênLoạiMô tả
titleStringtiêu đề của các sự kiện trong chuỗi 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 là bị bỏ qua)
recurrenceEventRecurrencechế độ cài đặt lặp lại của chuỗi sự kiện

Cầu thủ trả bóng

CalendarEventSeries — chuỗi sự kiện đã tạo

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

createAllDayEventSeries(title, startDate, recurrence, options)

Tạo chuỗi sự kiện mới 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());

Tham số

TênLoạiMô tả
titleStringtiêu đề của các sự kiện trong chuỗi 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 là 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
locationStringđịa điểm của các sự kiện trong chuỗi sự kiện
guestsStringdanh 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 khách mời tham dự các sự kiện trong chuỗi sự kiện
sendInvitesBooleancó 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 do người dùng sở hữu. 

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

Tham số

TênLoạiMô tả
nameStringtên của lịch mới

Cầu thủ trả bóng

Calendar — lịch mới tạo

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 do người dùng sở hữu. 

// Creates a new calendar named "Travel Plans" with a summary and color.
var calendar = CalendarApp.createCalendar('Travel Plans', {
  summary: 'A calendar to plan my travel schedule.',
  color: CalendarApp.Color.BLUE
});
Logger.log('Created the calendar "%s", with the ID "%s".',
    calendar.getName(), calendar.getId());

Tham số

TênLoạiMô tả
nameStringtên của 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 trong "long" định dạng (ví dụ: " America/New_New" (theo liệt kê của Joda.org)
colorStringmột chuỗi màu thập lục phân ("#rrggbb") hoặc một 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 tài khoản người dùng không giao diện (mặc định: true)

Cầu thủ trả bóng

Calendar — lịch mới tạo

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

createEvent(title, startTime, endTime)

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

Nếu không có múi giờ được chỉ định, giá trị thời gian được diễn giải theo ngữ cảnh của tập lệnh múi giờ, 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());

Tham số

TênLoạiMô tả
titleStringtiêu đề của sự kiện
startTimeDatengày và giờ khi sự kiện bắt đầu
endTimeDatengày và giờ khi sự kiện kết thúc

Cầu thủ trả bóng

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

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

createEvent(title, startTime, endTime, options)

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

Nếu không có múi giờ được chỉ định, giá trị thời gian được diễn giải theo ngữ cảnh của tập lệnh múi giờ, 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());

Tham số

TênLoạiMô tả
titleStringtiêu đề của sự kiện
startTimeDatengày và giờ khi sự kiện bắt đầu
endTimeDatengày và giờ khi sự kiện kết thúc
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ề sự kiện
locationStringđịa điểm diễn ra sự kiện
guestsStringdanh 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 với tư cách khách
sendInvitesBooleancó 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 biểu mẫu tuỳ ý.

Nội dung mô tả phải sử dụng cùng định dạng với 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());

Tham số

TênLoạiMô tả
descriptionStringnội dung mô tả dạng tự do về sự kiện

Cầu thủ trả bóng

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

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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());

Tham số

TênLoạiMô tả
titleStringtiêu đề của các sự kiện trong chuỗi sự kiện
startTimeDatengày và giờ khi sự kiện đầu tiên trong chuỗi sự kiện bắt đầu
endTimeDatengày và giờ khi sự kiện đầu tiên trong chuỗi sự kiện kết thúc
recurrenceEventRecurrencechế độ cài đặt lặp lại của chuỗi sự kiện

Cầu thủ trả bóng

CalendarEventSeries — chuỗi sự kiện đã tạo

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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());

Tham số

TênLoạiMô tả
titleStringtiêu đề của các sự kiện trong chuỗi sự kiện
startTimeDatengày và giờ khi sự kiện đầu tiên trong chuỗi sự kiện bắt đầu
endTimeDatengày và giờ khi sự kiện đầu tiên trong chuỗi sự kiện kết thúc
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
locationStringđịa điểm của các sự kiện trong chuỗi sự kiện
guestsStringdanh 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 khách mời tham dự các sự kiện trong chuỗi sự kiện
sendInvitesBooleancó 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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);

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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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);

Cầu thủ trả bóng

Calendar[] — tất cả lịch mà người dùng sở hữu

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 có mã đã 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());

Tham số

TênLoạiMô tả
idStringmã lịch

Cầu thủ trả bóng

Calendar — lịch có mã đã cho hoặc null nếu lịch không tồn tại, nếu người dùng không thể truy cập lịch hoặc nếu người dùng chưa đăng ký lịch

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 được chấp nhận 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);

Tham số

TênLoạiMô tả
nameStringtê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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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. 

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com');

// Gets the color of the calendar and logs it to the console.
// For the default calendar, you can use CalendarApp.getColor() instead.
const calendarColor = calendar.getColor();
console.log(calendarColor);

Cầu thủ trả bóng

String – Chuỗi màu thập lục phân ("#rrggbb").

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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()

Lấy lịch mặc định của người dùng. 

// Determines the time zone of the user's default calendar.
var calendar = CalendarApp.getDefaultCalendar();
Logger.log('My default calendar is set to the time zone "%s".',
    calendar.getTimeZone());

Cầu thủ trả bóng

Calendar — lịch mặc định của người dùng

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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ả của lịch. 

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com');

// Sets the description of the calendar to 'Test description.'
calendar.setDescription('Test description');

// Gets the description of the calendar and logs it to the console.
// For the default calendar, you can use CalendarApp.getDescription() instead.
const description = calendar.getDescription();
console.log(description);

Cầu thủ trả bóng

String — Mô tả của lịch này.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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)

Lấy sự kiện có mã nhận dạng đã cho. Nếu chuỗi chủ đề thuộc về một lịch không phải là lịch mặc định lịch, thì phương thức này phải được gọi từ lịch đó. Chỉ gọi cho getEventById(iCalId) trả về một sự kiện trong lịch mặc định.

Nhiều sự kiện có thể có cùng mã nếu chúng thuộc một chuỗi sự kiện. Trong trường hợp này, phương thức chỉ trả về sự kiện đầu tiên từ chuỗi đó. 

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com')

// Creates an event for the moon landing.
const event = calendar.createEvent('Apollo 11 Landing',
  new Date('July 20, 1969 20:05:00 UTC'),
  new Date('July 20, 1969 20:17:00 UTC'));

// Gets the calendar event ID and logs it to the console.
const iCalId = event.getId();
console.log(iCalId);

// Gets the event by its ID and logs the title of the event to the console.
// For the default calendar, you can use CalendarApp.getEventById(iCalId) instead.
const myEvent = calendar.getEventById(iCalId);
console.log(myEvent.getTitle());

Tham số

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

Cầu thủ trả bóng

CalendarEvent – Sự kiện có mã nhận dạng đã cho hoặc null nếu sự kiện không tồn tại hoặc người dùng không thể truy cập vào tệp đó.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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)

Lấy chuỗi sự kiện có mã đã cho. Nếu mã nhận dạng được cung cấp là dành cho một CalendarEvent đơn lẻ, thì CalendarEventSeries sẽ được trả về cùng với một sự kiện duy nhất trong chuỗi. Lưu ý rằng nếu chuỗi sự kiện thuộc về một lịch khác với lịch mặc định, thì phương thức này phải được gọi từ CalendarApp đó; đang gọi 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('222larabrown@gmail.com');

// Creates an event series for a daily team meeting from 1 PM to 2 PM.
// The series adds the daily event from January 1, 2023 through December 31, 2023.
const eventSeries = calendar.createEventSeries('Team meeting',
  new Date('Jan 1, 2023 13:00:00'),
  new Date('Jan 1, 2023 14:00:00'),
  CalendarApp.newRecurrence().addDailyRule().until(new Date('Jan 1, 2024')));

// Gets the ID of the event series.
const iCalId = eventSeries.getId();

// Gets the event series by its ID and logs the series title to the console.
// For the default calendar, you can use CalendarApp.getEventSeriesById(iCalId) instead.
console.log(calendar.getEventSeriesById(iCalId).getTitle());

Tham số

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

Cầu thủ trả bóng

CalendarEventSeries – Bộ sách có mã nhận dạng đã cho 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 tệp đó.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 một khoảng thời gian nhất định, kết thúc trong thời gian đó hoặc bao gồm phạm vi thời gian. Nếu không có múi giờ được chỉ định, giá trị thời gian sẽ được diễn giải theo ngữ cảnh múi giờ của tập lệnh, múi giờ này có thể khác với múi giờ của lịch. 

// Determines how many events are happening in the next two hours.
var now = new Date();
var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var events = CalendarApp.getDefaultCalendar().getEvents(now, twoHoursFromNow);
Logger.log('Number of events: ' + events.length);

Tham số

TênLoạiMô tả
startTimeDatethời điểm bắt đầu phạm vi thời gian
endTimeDatekết thúc của 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 tiêu chí đã chỉ định.

Phương thức này trả về các sự kiện bắt đầu trong một khoảng thời gian nhất định, kết thúc trong khoảng thời gian đó hoặc bao gồm phạm vi thời gian. Nếu không có múi giờ được chỉ định, giá trị thời gian sẽ được diễn giải theo ngữ cảnh 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 tính năng lọc trên author, search hoặc statusFilters sẽ lấy sau khi áp dụng start và max. Điều này có nghĩa là số lượng sự kiện 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".
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);

Tham số

TênLoạiMô tả
startTimeDatethời điểm bắt đầu phạm vi thời gian
endTimeDatekết thúc của 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ố lượng 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 toàn bộ văn bản dùng để lọc kết quả
statusFilters[]GuestStatusmột loạt 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à phù hợp với tiêu chí

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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ả 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 một ngày cụ thể, kết thúc vào ngày đó hoặc bao gồm ngày.

Xin lưu ý rằng chỉ sử dụng phần ngày của đối tượng Ngày và phần thời gian sẽ bị bỏ qua. Ngày được diễn giải là từ nửa đêm của ngày hôm đó đến nửa đêm của ngày tiếp theo theo giờ trong lịch vùng. 

// Determines how many events are happening today.
var today = new Date();
var events = CalendarApp.getDefaultCalendar().getEventsForDay(today);
Logger.log('Number of events: ' + events.length);

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)

Cầu thủ trả bóng

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

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 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 một ngày cụ thể, kết thúc vào ngày đó hoặc bao gồm ngày.

Xin lưu ý rằng chỉ sử dụng phần ngày của đối tượng Ngày và phần thời gian sẽ bị bỏ qua. Ngày được diễn giải là từ nửa đêm của ngày hôm đó đến nửa đêm của ngày tiếp theo theo giờ trong lịch vùng.

Xin lưu ý rằng tính năng lọc trên author, search hoặc statusFilters sẽ lấy sau khi áp dụng start và max. Điều này có nghĩa là số lượng sự kiện 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".
var today = new Date();
var events = CalendarApp.getDefaultCalendar().getEventsForDay(today, {search: 'meeting'});
Logger.log('Number of events: ' + events.length);

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ố lượng 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 toàn bộ văn bản dùng để lọc kết quả
statusFilters[]GuestStatusmột loạt 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à đáp ứng tiêu chí

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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ã lịch. Mã lịch mặc định của người dùng là địa chỉ email của họ. 

// Opens the calendar by its ID.
// To get the user's default calendar, use CalendarApp.getDefaultCalendar().
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com');

// Gets the ID of the calendar and logs it to the console.
const calendarId = calendar.getId();
console.log(calendarId);

Cầu thủ trả bóng

String — Mã lịch.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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()

Xem tên lịch. 

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com');

// Gets the name of the calendar and logs it to the console.
// For the default calendar, you can use CalendarApp.getName() instead.
const calendarName = calendar.getName();
console.log(calendarName);

Cầu thủ trả bóng

String — Tên lịch này.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 có mã nhận dạng đã cho nếu người dùng sở hữu lịch đó.

Để tìm ID lịch, hãy nhấp vào mũi tên bên cạnh tên lịch trong Lịch Google và chọn Cài đặt lịch. Mã nhận dạng xuất hiện gần cuối phần 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());

Tham số

TênLoạiMô tả
idStringmã lịch

Cầu thủ trả bóng

Calendar — lịch có mã đã cho hoặc null nếu lịch không tồn tại hoặc người dùng không sở hữu thông tin đó

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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);

Tham số

TênLoạiMô tả
nameStringtê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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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()

Lấy múi giờ của lịch. 

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com');

// Gets the time zone of the calendar and logs it to the console.
// For the default calendar, you can use CalendarApp.getTimeZone() instead.
const timeZone = calendar.getTimeZone();
console.log(timeZone);

Cầu thủ trả bóng

String — Múi giờ, được chỉ định bằng "long" định dạng (ví dụ: "Mỹ/New_ Được" như liệt kê của Joda.org).

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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. 

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com');

// Determines whether the calendar is hidden in the user interface and logs it to the console.
// For the default calendar, you can use CalendarApp.isHidden() instead.
const isHidden = calendar.isHidden();
console.log(isHidden);

Cầu thủ trả bóng

Boolean – true nếu lịch bị ẩn trong giao diện người dùng; false nếu thì không.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 chính cho người dùng hoạt độ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('222larabrown@gmail.com');

// Determines whether the calendar is the default calendar for
// the effective user and logs it to the console.
// For the default calendar, you can use CalendarApp.isMyPrimaryCalendar() instead.
const isMyPrimaryCalendar = calendar.isMyPrimaryCalendar();
console.log(isMyPrimaryCalendar);

Cầu thủ trả bóng

Boolean – true nếu lịch là lịch mặc định cho người dùng hoạt động hiệu quả; false nếu không.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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ó phải do bạn sở hữu hay không. 

// Gets a calendar by its ID. To get the user's default calendar, use
// CalendarApp.getDefault() instead.
// TODO(developer): Replace the ID with the calendar ID that you want to use.
const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com');

// Determines whether the calendar is owned by you and logs it.
console.log(calendar.isOwnedByMe());

Cầu thủ trả bóng

Boolean — true nếu lịch là của bạn; false nếu không.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 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 của lịch được hiển thị trong giao diện người dùng; false nếu không

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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());

Cầu thủ trả bóng

EventRecurrence — một đối tượng lặp lại mới chưa đặt quy tắc nào (hoạt động như một lần lặp lại hàng tuần)

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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 cho lịch. 

// Opens the calendar by its ID.
// TODO(developer): Replace the ID with your own.
const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com');

// Sets the color of the calendar to pink using the Calendar Color enum.
// For the default calendar, you can use CalendarApp.setColor() instead.
calendar.setColor(CalendarApp.Color.PINK);

Tham số

TênLoạiMô tả
colorStringCalendarApp.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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

setDescription(description)

Đặt mô tả cho 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ênLoạiMô tả
descriptionStringmô tả về lịch này

Cầu thủ trả bóng

Calendar — lịch này để tạo chuỗi

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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.

Tham số

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

Cầu thủ trả bóng

Calendar — lịch này để tạo chuỗi

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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. 

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

Cầu thủ trả bóng

Calendar — lịch này để tạo chuỗi

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

setSelected(selected)

Thiết lập 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ênLoạiMô tả
selectedBooleantrue để hiển thị các sự kiện của lịch trong giao diện người dùng; false để ẩn chúng

Cầu thủ trả bóng

Calendar — lịch này để tạo chuỗi

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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

setTimeZone(timeZone)

Đặt múi giờ cho lịch. 

// Gets the user's default calendar. To get a different calendar, use getCalendarById()
// instead.
const calendar = CalendarApp.getDefaultCalendar();

// Sets the time zone of the calendar to America/New York (US/Eastern) time.
calendar.setTimeZone('America/New_York');

Tham số

TênLoạiMô tả
timeZoneStringMúi giờ, được chỉ định bằng "long" (chẳng hạn như " America/New_ Được ", như do Joda.org liệt kê).

Cầu thủ trả bóng

Calendar — Lịch này để tạo chuỗi.

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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ào 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());

Tham số

TênLoạiMô tả
idStringmã lịch để đăng ký

Cầu thủ trả bóng

Calendar — lịch mới được đăng ký

Gửi

Error — nếu không có lịch nào có mã này

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong 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ào 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());

Tham số

TênLoạiMô tả
idStringMã của lịch để đă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 một giá trị từ CalendarApp.Colors.
hiddenBooleanLiệu lịch có bị ẩn trong giao diện người dùng hay không (mặc định: false).
selectedBooleanLiệu các sự kiện của lịch có hiển thị trong người dùng hay không giao diện (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 được đăng ký.

Gửi

Error — nếu không có lịch nào có mã này

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

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