Class CalendarApp

Tạo một 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());

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

Thông số

Thông số nâng cao

Cầu thủ trả bóng

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

Ủy quyền

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

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

Tạo một 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());

Thông số

Thông số nâng cao

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

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

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

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

Thông số

Thông số nâng cao

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

Thông số

Cầu thủ trả bóng

Calendar — lịch mới tạo

Ủy quyền

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

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

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

Thông số

Thông số nâng cao

Cầu thủ trả bóng

Calendar — lịch mới tạo

Ủy quyền

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

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

Tạo 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 múi giờ của tập lệnh. Múi giờ này có thể khác với múi giờ của lịch.

// Creates an event for the moon landing and logs the ID.
var event = CalendarApp.getDefaultCalendar().createEvent('Apollo 11 Landing',
    new Date('July 20, 1969 20:00:00 UTC'),
    new Date('July 21, 1969 21:00:00 UTC'));
Logger.log('Event ID: ' + event.getId());

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

Tạo 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 múi giờ của tập lệnh. Múi giờ này có thể khác với múi giờ của lịch.

// Creates an event for the moon landing and logs the ID.
var event = CalendarApp.getDefaultCalendar().createEvent('Apollo 11 Landing',
    new Date('July 20, 1969 20:00:00 UTC'),
    new Date('July 20, 1969 21:00:00 UTC'),
    {location: 'The Moon'});
Logger.log('Event ID: ' + event.getId());

Thông số

Thông số nâng cao

Cầu thủ trả bóng

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

Ủy quyền

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

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

Tạo sự kiện từ nội dung mô tả dạng tự do.

Nội dung mô tả phải có cùng định dạng với tính năng "Thêm nhanh" trên 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());

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

Thông số

Thông số nâng cao

Cầu thủ trả bóng

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

Ủy quyền

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

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

Lấy tất cả các lịch mà người dùng sở hữu hoặc đã đăng ký.

// Determines how many calendars the user can access.
var calendars = CalendarApp.getAllCalendars();
Logger.log('This user owns or is subscribed to %s calendars.',
    calendars.length);

Cầu thủ trả bóng

Calendar[] — tất cả các lịch mà người dùng có thể truy cập

Ủy quyền

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

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

Lấy tất cả các lịch mà người dùng sở hữu.

// Determines how many calendars the user owns.
var calendars = CalendarApp.getAllOwnedCalendars();
Logger.log('This user owns %s calendars.', calendars.length);

Cầu thủ trả bóng

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

Ủy quyền

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

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

Lấy lịch bằng mã nhận dạng đã cho.

// Gets the public calendar "US Holidays" by ID.
var calendar = CalendarApp.getCalendarById(
    'en.usa#holiday@group.v.calendar.google.com');
Logger.log('The calendar is named "%s".', calendar.getName());

Thông số

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 truy cập được hoặc nếu người dùng chưa đăng ký lịch

Ủy quyền

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

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

Lấy tất cả các lịch có tên cụ thể mà người dùng sở hữu hoặc đăng ký. Tên không phân biệt chữ hoa chữ thường.

// Gets the public calendar named "US Holidays".
var calendars = CalendarApp.getCalendarsByName('US Holidays');
Logger.log('Found %s matching calendars.', calendars.length);

Thông số

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 sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

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

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('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 sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

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

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 sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

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

Lấy nội dung mô tả về lịch.

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

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

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

Cầu thủ trả bóng

String — Nội dung mô tả về lịch này.

Ủy quyền

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

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

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

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

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

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

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

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

Thông số

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 truy cập được vào sự kiện đó.

Ủy quyền

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

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

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

Thông số

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 truy cập được vào bộ sách đó.

Ủy quyền

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

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

Lấy tất cả sự kiện xảy ra trong một khoảng thời gian nhất định.

Phương thức này trả về những sự kiện bắt đầu trong một phạm vi thời gian nhất định, kết thúc trong phạm vi thời gian đó hoặc bao gồm phạm vi thời gian. Nếu bạn không chỉ định múi giờ, thì các giá trị thời gian sẽ được diễn giải theo múi giờ của tập lệnh. Múi giờ này có thể khác với múi giờ của lịch.

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

Thông số

Cầu thủ trả bóng

CalendarEvent[] — các sự kiện xảy ra trong khoảng thời gian

Ủy quyền

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

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

Nhận tất cả sự kiện xảy ra trong một khoảng thời gian nhất định và đáp ứng tiêu chí được chỉ định.

Phương thức này trả về những sự kiện bắt đầu trong một phạm vi thời gian nhất định, kết thúc trong một phạm vi thời gian hoặc bao gồm phạm vi thời gian đó. Nếu bạn không chỉ định múi giờ, thì các giá trị thời gian sẽ được diễn giải theo múi giờ của tập lệnh. Múi giờ này có thể khác với múi giờ của lịch.

Xin lưu ý rằng 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, ngay cả khi 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);

Thông số

Thông số nâng cao

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 sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

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

Nhận 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 sự kiện bắt đầu trong một ngày nhất định, kết thúc trong ngày hoặc bao gồm ngày đó.

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

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

Nhận tất cả sự kiện xảy ra vào một ngày nhất định và đáp ứng tiêu chí cụ thể.

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

Xin lưu ý rằng chỉ phần ngày của đối tượng Ngày được sử dụng và phần giờ sẽ bị bỏ qua. Ngày được hiểu 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, ngay cả khi 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);

Thông số

Thông số nâng cao

Cầu thủ trả bóng

CalendarEvent[] — sự kiện xảy ra vào ngày cụ thể và phù hợp với tiêu chí

Ủy quyền

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

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

Lấy mã nhận dạng của lịch. Mã cho lịch mặc định của người dùng là địa chỉ email của họ.

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

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

Cầu thủ trả bóng

String — Mã của lịch.

Ủy quyền

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

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

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('222larabrown@gmail.com');

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

Cầu thủ trả bóng

String — Tên của lịch này.

Ủy quyền

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

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

Lấy lịch bằng mã nhận dạng đã cho, nếu người dùng sở hữu lịch đó.

Để tìm mã lịch, hãy nhấp vào mũi tên bên cạnh tên lịch trong Lịch Google và chọn phần Cài đặt lịch. Mã nhận dạng xuất hiện ở gần cuối trang cài đặt.

// Gets a (non-existent) private calendar by ID.
var calendar = CalendarApp.getOwnedCalendarById(
    '123456789@group.calendar.google.com');
Logger.log('The calendar is named "%s".', calendar.getName());

Thông số

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

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

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

Lấy tất cả các lịch có tên cụ thể mà người dùng sở hữu. Tên không phân biệt chữ hoa chữ thường.

// Gets a private calendar named "Travel Plans".
var calendars = CalendarApp.getOwnedCalendarsByName('Travel Plans');
Logger.log('Found %s matching calendars.', calendars.length);

Thông số

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 sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

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

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 theo định dạng "dài" (ví dụ: "Mỹ/New_New_ tắc" như liệt kê trong Joda.org).

Ủy quyền

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

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

Xác định xem lịch có bị ẩn trong giao diện người dùng hay không.

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

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

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('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 của người dùng có hiệu lực; false nếu không phải lịch.

Ủy quyền

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

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

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 thuộc sở hữu của bạn; false nếu không phải.

Ủy quyền

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

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

Xác định xem các sự kiện của lịch có hiển thị trong giao diện người dùng hay không.

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

// Determines whether the calendar's events are displayed in the user interface and logs it.
console.log(calendar.isSelected());

Cầu thủ trả bóng

Boolean — true nếu sự kiện của lịch được hiển thị trong giao diện người dùng; false nếu không hiển thị

Ủy quyền

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

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

Tạo đố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 — đối tượng lặp lại mới không có quy tắc nào được thiết lập (hoạt động như lặp lại hàng tuần)

Ủy quyền

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

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

Đặ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);

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

Đặ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.')

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

Đặ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');

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

Đặ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);

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

Đặ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');

Thông số

Cầu thủ trả bóng

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

Ủy quyền

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

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

Đăng ký người dùng vào lịch bằng mã nhận dạng đã 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());

Thông số

Cầu thủ trả bóng

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

Gửi

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

Ủy quyền

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

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

Đăng ký người dùng vào lịch bằng 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.
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());

Thông số

Thông số nâng cao

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

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

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