Class CalendarApp

CalendarApp

Umożliwia skrypt do odczytu i aktualizacji Kalendarza Google użytkownika. Ta klasa zapewnia bezpośredni dostęp do domyślnego kalendarza użytkownika oraz pobieranie dodatkowych kalendarzy, które należą do niego lub które subskrybuje.

Właściwości

WłaściwośćTypOpis
ColorColorWyliczenie reprezentujące nazwane kolory dostępne w usłudze Kalendarz.
EventColorEventColorWyliczenie reprezentujące kolory nazwanych wydarzeń dostępne w usłudze Kalendarz.
GuestStatusGuestStatusWyliczenie reprezentujące statusy gościa w wydarzeniu.
MonthMonthWyliczenie reprezentujące miesiące w roku.
VisibilityVisibilityWyliczenie reprezentujące widoczność zdarzenia.
WeekdayWeekdayWyliczenie reprezentujące dni tygodnia.

Metody

MetodaTyp zwracanej wartościKrótki opis
createAllDayEvent(title, date)CalendarEventTworzy nowe wydarzenie całodniowe.
createAllDayEvent(title, startDate, endDate)CalendarEventTworzy nowe wydarzenie całodniowe, które może trwać kilka dni.
createAllDayEvent(title, startDate, endDate, options)CalendarEventTworzy nowe wydarzenie całodniowe, które może trwać kilka dni.
createAllDayEvent(title, date, options)CalendarEventTworzy nowe wydarzenie całodniowe.
createAllDayEventSeries(title, startDate, recurrence)CalendarEventSeriesTworzy nową serię wydarzeń całodniowych.
createAllDayEventSeries(title, startDate, recurrence, options)CalendarEventSeriesTworzy nową serię wydarzeń całodniowych.
createCalendar(name)CalendarTworzy nowy kalendarz, którego właścicielem jest użytkownik.
createCalendar(name, options)CalendarTworzy nowy kalendarz, którego właścicielem jest użytkownik.
createEvent(title, startTime, endTime)CalendarEventTworzy nowe wydarzenie.
createEvent(title, startTime, endTime, options)CalendarEventTworzy nowe wydarzenie.
createEventFromDescription(description)CalendarEventTworzy wydarzenie na podstawie dowolnego opisu.
createEventSeries(title, startTime, endTime, recurrence)CalendarEventSeriesTworzy nową serię wydarzeń.
createEventSeries(title, startTime, endTime, recurrence, options)CalendarEventSeriesTworzy nową serię wydarzeń.
getAllCalendars()Calendar[]Pobiera wszystkie kalendarze posiadane lub subskrybowane przez użytkownika.
getAllOwnedCalendars()Calendar[]Pobiera wszystkie kalendarze należące do użytkownika.
getCalendarById(id)CalendarPobiera kalendarz o podanym identyfikatorze.
getCalendarsByName(name)Calendar[]Pobiera wszystkie kalendarze o danej nazwie, których użytkownik jest właścicielem lub które subskrybuje.
getColor()StringPobiera kolor kalendarza.
getDefaultCalendar()CalendarPobiera domyślny kalendarz użytkownika.
getDescription()StringPobiera opis kalendarza.
getEventById(iCalId)CalendarEventPobiera zdarzenie o podanym identyfikatorze.
getEventSeriesById(iCalId)CalendarEventSeriesPobiera serię zdarzeń o podanym identyfikatorze.
getEvents(startTime, endTime)CalendarEvent[]Pobiera wszystkie zdarzenia, które wystąpiły w danym przedziale czasu.
getEvents(startTime, endTime, options)CalendarEvent[]Pobiera wszystkie zdarzenia, które wystąpiły w danym przedziale czasu i spełniają określone kryteria.
getEventsForDay(date)CalendarEvent[]Pobiera wszystkie zdarzenia, które miały miejsce w danym dniu.
getEventsForDay(date, options)CalendarEvent[]Pobiera wszystkie zdarzenia, które wystąpiły w danym dniu i spełniają określone kryteria.
getId()StringPobiera identyfikator kalendarza.
getName()StringPobiera nazwę kalendarza.
getOwnedCalendarById(id)CalendarPobiera kalendarz o podanym identyfikatorze, jeśli należy do użytkownika.
getOwnedCalendarsByName(name)Calendar[]Pobiera wszystkie kalendarze o nazwie należącej do użytkownika.
getTimeZone()StringPobiera strefę czasową kalendarza.
isHidden()BooleanOkreśla, czy kalendarz jest ukryty w interfejsie użytkownika.
isMyPrimaryCalendar()BooleanOkreśla, czy kalendarz jest kalendarzem głównym rzeczywistego użytkownika.
isOwnedByMe()BooleanOkreśla, czy kalendarz należy do Ciebie.
isSelected()BooleanOkreśla, czy wydarzenia z kalendarza są wyświetlane w interfejsie użytkownika.
newRecurrence()EventRecurrenceTworzy nowy obiekt powtarzania, którego można używać do tworzenia reguł powtarzania zdarzeń.
setColor(color)CalendarUstawia kolor kalendarza.
setDescription(description)CalendarUstawia opis kalendarza.
setHidden(hidden)CalendarOkreśla, czy kalendarz jest widoczny w interfejsie użytkownika.
setName(name)CalendarUstawia nazwę kalendarza.
setSelected(selected)CalendarOkreśla, czy wydarzenia z kalendarza mają być wyświetlane w interfejsie użytkownika.
setTimeZone(timeZone)CalendarUstawia strefę czasową kalendarza.
subscribeToCalendar(id)CalendarSubskrybuje użytkownika kalendarza o podanym identyfikatorze, jeśli ma on uprawnienia do subskrybowania.
subscribeToCalendar(id, options)CalendarSubskrybuje użytkownika kalendarza o podanym identyfikatorze, jeśli ma on uprawnienia do subskrybowania.

Szczegółowa dokumentacja

createAllDayEvent(title, date)

Tworzy nowe wydarzenie całodniowe.

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

Parametry

NazwaTypOpis
titleStringNazwa wydarzenia.
dateDateData zdarzenia (uwzględniana jest tylko data; godzina jest ignorowana).

Powroty

CalendarEvent – utworzone zdarzenie.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createAllDayEvent(title, startDate, endDate)

Tworzy nowe wydarzenie całodniowe, które może trwać kilka dni.

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

Parametry

NazwaTypOpis
titleStringNazwa wydarzenia.
startDateDateData rozpoczęcia wydarzenia (użyty jest tylko dzień; godzina jest ignorowana).
endDateDateData zakończenia wydarzenia (uwzględniany jest tylko dzień; godzina jest ignorowana). Data zakończenia nie jest dostępna.

Powroty

CalendarEvent – utworzone zdarzenie.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createAllDayEvent(title, startDate, endDate, options)

Tworzy nowe wydarzenie całodniowe, które może trwać kilka dni.

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

Parametry

NazwaTypOpis
titleStringNazwa wydarzenia.
startDateDateData rozpoczęcia wydarzenia (użyty jest tylko dzień; godzina jest ignorowana).
endDateDateData zakończenia wydarzenia (uwzględniany jest tylko dzień; godzina jest ignorowana). Data zakończenia nie jest dostępna.
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
descriptionStringOpis zdarzenia.
locationStringLokalizacja wydarzenia.
guestsStringRozdzielona przecinkami lista adresów e-mail, które należy dodać jako gości.
sendInvitesBooleanOkreśla, czy wysyłać e-maile z zaproszeniami (domyślnie: false).

Powroty

CalendarEvent – utworzone zdarzenie.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createAllDayEvent(title, date, options)

Tworzy nowe wydarzenie całodniowe.

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

Parametry

NazwaTypOpis
titleStringNazwa wydarzenia.
dateDateData zdarzenia (uwzględniana jest tylko data; godzina jest ignorowana).
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
descriptionStringOpis zdarzenia.
locationStringLokalizacja wydarzenia.
guestsStringRozdzielona przecinkami lista adresów e-mail, które należy dodać jako gości.
sendInvitesBooleanOkreśla, czy wysyłać e-maile z zaproszeniami (domyślnie: false).

Powroty

CalendarEvent – utworzone zdarzenie.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createAllDayEventSeries(title, startDate, recurrence)

Tworzy nową serię wydarzeń całodniowych.

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

Parametry

NazwaTypOpis
titleStringtytuły wydarzeń w serii;
startDateDatedata pierwszego zdarzenia w serii (używany jest tylko dzień; godzina jest ignorowana)
recurrenceEventRecurrenceustawienia powtarzania serii zdarzeń.

Powroty

CalendarEventSeries – utworzona seria wydarzeń

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createAllDayEventSeries(title, startDate, recurrence, options)

Tworzy nową serię wydarzeń całodniowych.

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

Parametry

NazwaTypOpis
titleStringtytuły wydarzeń w serii;
startDateDatedata pierwszego zdarzenia w serii (używany jest tylko dzień; godzina jest ignorowana)
recurrenceEventRecurrenceustawienia powtarzania serii zdarzeń.
optionsObjectobiekt JavaScript z parametrami zaawansowanymi, które są wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis wydarzeń w serii.
locationStringmiejsce wydarzeń w serii
guestsStringoddzieloną przecinkami listę adresów e-mail, które powinny zostać dodane jako goście do wydarzeń w serii
sendInvitesBooleanopcja wysyłania e-maili z zaproszeniami (domyślnie: false),

Powroty

CalendarEventSeries – utworzona seria wydarzeń

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createCalendar(name)

Tworzy nowy kalendarz, którego właścicielem jest użytkownik.

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

Parametry

NazwaTypOpis
nameStringnazwa nowego kalendarza

Powroty

Calendar – nowo utworzony kalendarz

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createCalendar(name, options)

Tworzy nowy kalendarz, którego właścicielem jest użytkownik.

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

Parametry

NazwaTypOpis
nameStringnazwa nowego kalendarza
optionsObjectobiekt JavaScript z parametrami zaawansowanymi, które są wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
locationStringlokalizacja kalendarza
summaryStringopis kalendarza;
timeZoneStringStrefa czasowa, w której chcesz ustawić kalendarz, podana w formacie „long” (np. „America/New_York” (lista organizacji Joda.org)
colorStringszesnastkowy ciąg koloru („#rrggbb”) lub wartość z CalendarApp.Colors
hiddenBooleanczy kalendarz jest ukryty w interfejsie (domyślnie: false),
selectedBooleanOkreśla, czy wydarzenia z kalendarza są wyświetlane w interfejsie (domyślnie: true).

Powroty

Calendar – nowo utworzony kalendarz

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createEvent(title, startTime, endTime)

Tworzy nowe wydarzenie.

Jeśli nie określisz strefy czasowej, wartości będą interpretowane w kontekście strefy czasowej skryptu, która może się różnić od strefy czasowej kalendarza.

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

Parametry

NazwaTypOpis
titleStringnazwa wydarzenia
startTimeDatedatę i godzinę rozpoczęcia wydarzenia;
endTimeDatedatę i godzinę zakończenia wydarzenia;

Powroty

CalendarEvent – utworzone wydarzenie,

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createEvent(title, startTime, endTime, options)

Tworzy nowe wydarzenie.

Jeśli nie określisz strefy czasowej, wartości będą interpretowane w kontekście strefy czasowej skryptu, która może się różnić od strefy czasowej kalendarza.

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

Parametry

NazwaTypOpis
titleStringnazwa wydarzenia
startTimeDatedatę i godzinę rozpoczęcia wydarzenia;
endTimeDatedatę i godzinę zakończenia wydarzenia;
optionsObjectobiekt JavaScript z parametrami zaawansowanymi, które są wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis wydarzenia;
locationStringlokalizacja wydarzenia;
guestsStringoddzielona przecinkami lista adresów e-mail, które należy dodać jako gości
sendInvitesBooleanopcja wysyłania e-maili z zaproszeniami (domyślnie: false),

Powroty

CalendarEvent – utworzone wydarzenie,

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createEventFromDescription(description)

Tworzy wydarzenie na podstawie dowolnego opisu.

Opis powinien mieć ten sam format co funkcja „Szybkie dodawanie” interfejsu użytkownika.

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

Parametry

NazwaTypOpis
descriptionStringswobodny opis wydarzenia;

Powroty

CalendarEvent – utworzone wydarzenie,

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

createEventSeries(title, startTime, endTime, recurrence)

Tworzy nową serię wydarzeń.

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

Parametry

NazwaTypOpis
titleStringtytuły wydarzeń w serii;
startTimeDatedata i godzina rozpoczęcia pierwszego wydarzenia w serii.
endTimeDatedata i godzina zakończenia pierwszego wydarzenia w serii
recurrenceEventRecurrenceustawienia powtarzania serii zdarzeń.

Powroty

CalendarEventSeries – utworzona seria wydarzeń

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

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

Tworzy nową serię wydarzeń.

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

Parametry

NazwaTypOpis
titleStringtytuły wydarzeń w serii.
startTimeDatedata i godzina rozpoczęcia pierwszego wydarzenia w serii.
endTimeDatedata i godzina zakończenia pierwszego wydarzenia w serii
recurrenceEventRecurrenceustawienia powtarzania serii zdarzeń.
optionsObjectobiekt JavaScript z parametrami zaawansowanymi, które są wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis wydarzeń w serii.
locationStringmiejsce wydarzeń w serii
guestsStringoddzieloną przecinkami listę adresów e-mail, które powinny zostać dodane jako goście do wydarzeń w serii
sendInvitesBooleanopcja wysyłania e-maili z zaproszeniami (domyślnie: false),

Powroty

CalendarEventSeries – utworzona seria wydarzeń

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getAllCalendars()

Pobiera wszystkie kalendarze posiadane lub subskrybowane przez użytkownika.

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

Powroty

Calendar[] – wszystkie kalendarze, do których użytkownik ma dostęp

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getAllOwnedCalendars()

Pobiera wszystkie kalendarze należące do użytkownika.

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

Powroty

Calendar[] – wszystkie kalendarze należące do użytkownika

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getCalendarById(id)

Pobiera kalendarz o podanym identyfikatorze.

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

Parametry

NazwaTypOpis
idStringidentyfikator kalendarza

Powroty

Calendar – kalendarz o podanym identyfikatorze lub null, jeśli kalendarz nie istnieje, użytkownik nie może uzyskać do niego dostępu lub nie subskrybuje kalendarza

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getCalendarsByName(name)

Pobiera wszystkie kalendarze o danej nazwie, których użytkownik jest właścicielem lub które subskrybuje. Wielkość liter w nazwach nie ma znaczenia.

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

Parametry

NazwaTypOpis
nameStringnazwa kalendarza

Powroty

Calendar[] – wszystkie kalendarze o tej nazwie, do których użytkownik ma dostęp

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getColor()

Pobiera kolor kalendarza.

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

Powroty

String – szesnastkowy ciąg znaków dotyczący koloru („#rrggbb”).

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getDefaultCalendar()

Pobiera domyślny kalendarz użytkownika.

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

Powroty

Calendar – domyślny kalendarz użytkownika,

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getDescription()

Pobiera opis kalendarza.

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

Powroty

String – opis kalendarza.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getEventById(iCalId)

Pobiera zdarzenie o podanym identyfikatorze. Jeśli seria należy do kalendarza innego niż domyślny, metodę tę należy wywołać z tego kalendarza. Wywołanie getEventById(iCalId) powoduje zwrócenie wydarzenia tylko z kalendarza domyślnego.

Kilka wydarzeń może mieć ten sam identyfikator, jeśli należą do serii wydarzeń. W tym przypadku metoda ta zwraca tylko pierwsze zdarzenie z tego ciągu.

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

Parametry

NazwaTypOpis
iCalIdStringIdentyfikator wydarzenia.

Powroty

CalendarEvent – zdarzenie o podanym identyfikatorze lub null, jeśli zdarzenie nie istnieje lub użytkownik nie ma do niego dostępu.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getEventSeriesById(iCalId)

Pobiera serię zdarzeń o podanym identyfikatorze. Jeśli podany identyfikator dotyczy pojedynczego zdarzenia CalendarEvent, zwracana jest wartość CalendarEventSeries z jednym zdarzeniem w serii. Pamiętaj, że jeśli seria wydarzeń należy do kalendarza innego niż kalendarz domyślny, musisz wywołać tę metodę z poziomu tego kalendarza CalendarApp. Wywołanie bezpośrednio getEventSeriesById(iCalId) zwraca tylko serię wydarzeń z kalendarza domyślnego.

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

Parametry

NazwaTypOpis
iCalIdStringIdentyfikator serii zdarzeń.

Powroty

CalendarEventSeries – seria o podanym identyfikatorze lub null, jeśli nie istnieje lub użytkownik nie ma do niej dostępu.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getEvents(startTime, endTime)

Pobiera wszystkie zdarzenia, które wystąpiły w danym przedziale czasu.

Ta metoda zwraca zdarzenia, które rozpoczęły się w danym przedziale czasu, zakończyły się w tym przedziale czasu lub obejmują ten okres. Jeśli nie określisz strefy czasowej, wartości będą interpretowane w kontekście strefy czasowej skryptu, która może się różnić od strefy czasowej kalendarza.

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

Parametry

NazwaTypOpis
startTimeDatepoczątek zakresu czasu
endTimeDatekoniec zakresu czasu, niewłącznie

Powroty

CalendarEvent[] – zdarzenia, które wystąpiły w wybranym przedziale czasu;

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getEvents(startTime, endTime, options)

Pobiera wszystkie zdarzenia, które wystąpiły w danym przedziale czasu i spełniają określone kryteria.

Ta metoda zwraca zdarzenia, które rozpoczęły się w danym przedziale czasu, zakończyły się w tym przedziale czasu lub obejmuje ten okres. Jeśli nie określisz strefy czasowej, wartości będą interpretowane w kontekście strefy czasowej skryptu, która może się różnić od strefy czasowej kalendarza.

Pamiętaj, że filtrowanie według author, search lub statusFilters działa po zastosowaniu start i max. Oznacza to, że liczba zwróconych zdarzeń może być mniejsza niż max, nawet jeśli dodatkowe zdarzenia spełniają kryteria.

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

Parametry

NazwaTypOpis
startTimeDatepoczątek zakresu czasu
endTimeDatekoniec zakresu czasu, niewłącznie
optionsObjectobiekt JavaScript z parametrami zaawansowanymi, które są wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
startIntegerindeks pierwszego zdarzenia do zwrócenia
maxIntegermaksymalną liczbę zdarzeń do zwrócenia
authorStringadres e-mail używany do filtrowania wyników według twórcy wydarzenia;
searchStringpełnotekstowe zapytanie służące do filtrowania wyników
statusFilters[]GuestStatustablica stanów służąca do filtrowania wyników

Powroty

CalendarEvent[] – zdarzenia mające miejsce w wybranym przedziale czasu i spełniające kryteria;

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getEventsForDay(date)

Pobiera wszystkie zdarzenia, które miały miejsce w danym dniu.

Ta metoda zwraca zdarzenia, jeśli rozpoczynają się w danym dniu, kończą w ciągu dnia lub obejmują dzień.

Zauważ, że używana jest tylko data w obiekcie Date (Data), a część związana z godziną jest ignorowana. Data jest traktowana jako okres od północy tego dnia do północy następnego dnia w strefie czasowej kalendarza.

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

Parametry

NazwaTypOpis
dateDatedata, z której chcesz pobrać zdarzenia (użyty jest tylko dzień; godzina jest ignorowana)

Powroty

CalendarEvent[] – zdarzenia, które miały miejsce w danym dniu;

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getEventsForDay(date, options)

Pobiera wszystkie zdarzenia, które wystąpiły w danym dniu i spełniają określone kryteria.

Ta metoda zwraca zdarzenia, jeśli rozpoczynają się w danym dniu, kończą w ciągu dnia lub obejmują dzień.

Zauważ, że używana jest tylko data w obiekcie Date (Data), a część związana z godziną jest ignorowana. Data jest traktowana jako okres od północy tego dnia do północy następnego dnia w strefie czasowej kalendarza.

Pamiętaj, że filtrowanie według author, search lub statusFilters działa po zastosowaniu start i max. Oznacza to, że liczba zwróconych zdarzeń może być mniejsza niż max, nawet jeśli dodatkowe zdarzenia spełniają kryteria.

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

Parametry

NazwaTypOpis
dateDatedata, z której chcesz pobrać zdarzenia (użyty jest tylko dzień; godzina jest ignorowana)
optionsObjectzaawansowane opcje filtrowania

Parametry zaawansowane

NazwaTypOpis
startIntegerindeks pierwszego zdarzenia do zwrócenia
maxIntegermaksymalną liczbę zdarzeń do zwrócenia
authorStringadres e-mail używany do filtrowania wyników według twórcy wydarzenia;
searchStringpełnotekstowe zapytanie służące do filtrowania wyników
statusFilters[]GuestStatustablica stanów służąca do filtrowania wyników

Powroty

CalendarEvent[] – wydarzenia, które wystąpiły w określonym dniu i spełniają określone kryteria.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getId()

Pobiera identyfikator kalendarza. Identyfikator domyślnego kalendarza użytkownika to jego adres e-mail.

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

Powroty

String – identyfikator kalendarza.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getName()

Pobiera nazwę kalendarza.

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

Powroty

String – nazwa kalendarza.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getOwnedCalendarById(id)

Pobiera kalendarz o podanym identyfikatorze, jeśli należy do użytkownika.

Aby znaleźć identyfikator kalendarza, kliknij strzałkę obok jego nazwy w Kalendarzu Google i wybierz Ustawienia kalendarza. Identyfikator jest widoczny u dołu strony ustawień.

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

Parametry

NazwaTypOpis
idStringidentyfikator kalendarza

Powroty

Calendar – kalendarz o podanym identyfikatorze lub null, jeśli kalendarz nie istnieje lub nie należy do użytkownika

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getOwnedCalendarsByName(name)

Pobiera wszystkie kalendarze o nazwie należącej do użytkownika. W nazwach nie jest rozróżniana wielkość liter.

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

Parametry

NazwaTypOpis
nameStringnazwa kalendarza

Powroty

Calendar[] – wszystkie kalendarze o tej nazwie należące do użytkownika

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

getTimeZone()

Pobiera strefę czasową kalendarza.

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

Powroty

String – strefa czasowa podana w formacie „long” (na przykład „Ameryka/Nowy_Jork” według organizacji Joda.org).

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

isHidden()

Określa, czy kalendarz jest ukryty w interfejsie użytkownika.

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

Powroty

Booleantrue, jeśli kalendarz jest ukryty w interfejsie; false, jeśli nie jest.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

isMyPrimaryCalendar()

Określa, czy kalendarz jest kalendarzem głównym rzeczywistego użytkownika.

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

Powroty

Booleantrue, jeśli kalendarz jest domyślnym kalendarzem użytkownika; w przeciwnym razie false.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

isOwnedByMe()

Określa, czy kalendarz należy do Ciebie.

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

Powroty

Booleantrue, jeśli kalendarz należy do Ciebie; jeśli nie jest to false.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

isSelected()

Określa, czy wydarzenia z kalendarza są wyświetlane w interfejsie użytkownika.

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

Powroty

Booleantrue, jeśli wydarzenia z kalendarza są wyświetlane w interfejsie; false, jeśli nie jest.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

newRecurrence()

Tworzy nowy obiekt powtarzania, którego można używać do tworzenia reguł powtarzania zdarzeń.

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

Powroty

EventRecurrence – nowy obiekt powtarzania bez ustawionych reguł (powtarza się co tydzień);

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

setColor(color)

Ustawia kolor kalendarza.

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

Parametry

NazwaTypOpis
colorStringCalendarApp.Color lub szesnastkowy ciąg koloru („#rrggbb”).

Powroty

Calendar – ten kalendarz na potrzeby tworzenia łańcuchów.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

setDescription(description)

Ustawia opis kalendarza.

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

Parametry

NazwaTypOpis
descriptionStringopis tego kalendarza

Powroty

Calendar – ten kalendarz na potrzeby łańcuchów

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

setHidden(hidden)

Określa, czy kalendarz jest widoczny w interfejsie użytkownika.

Parametry

NazwaTypOpis
hiddenBooleantrue, aby ukryć kalendarz w interfejsie użytkownika; false, aby go wyświetlić

Powroty

Calendar – ten kalendarz na potrzeby łańcuchów

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

setName(name)

Ustawia nazwę kalendarza.

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

Parametry

NazwaTypOpis
nameStringNowa nazwa

Powroty

Calendar – ten kalendarz na potrzeby łańcuchów

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

setSelected(selected)

Określa, czy wydarzenia z kalendarza mają być wyświetlane w interfejsie użytkownika.

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

Parametry

NazwaTypOpis
selectedBooleantrue, aby wyświetlić wydarzenia z kalendarza w interfejsie użytkownika; false, aby je ukryć

Powroty

Calendar – ten kalendarz na potrzeby łańcuchów

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

setTimeZone(timeZone)

Ustawia strefę czasową kalendarza.

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

Parametry

NazwaTypOpis
timeZoneStringStrefa czasowa podana w formacie „long” (np. „Ameryka/Nowy_Jork” podana przez Joda.org).

Powroty

Calendar – ten kalendarz na potrzeby tworzenia łańcuchów.

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

subscribeToCalendar(id)

Subskrybuje użytkownika kalendarza o podanym identyfikatorze, jeśli ma on uprawnienia do subskrybowania.

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

Parametry

NazwaTypOpis
idStringidentyfikator kalendarza do zasubskrybowania,

Powroty

Calendar – nowo zasubskrybowany kalendarz

Rzuty

Error – jeśli nie istnieje kalendarz o tym identyfikatorze,

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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

subscribeToCalendar(id, options)

Subskrybuje użytkownika kalendarza o podanym identyfikatorze, jeśli ma on uprawnienia do subskrybowania.

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

Parametry

NazwaTypOpis
idStringIdentyfikator kalendarza do zasubskrybowania.
optionsObjectObiekt JavaScript określający parametry zaawansowane, jak opisano poniżej.

Parametry zaawansowane

NazwaTypOpis
colorStringSzesnastkowy ciąg koloru („#rrggbb”) lub wartość z CalendarApp.Colors.
hiddenBooleanOkreśla, czy kalendarz jest ukryty w interfejsie (domyślnie: false).
selectedBooleanOkreśla, czy wydarzenia z kalendarza są wyświetlane w interfejsie (domyślnie: true, jeśli określono również color, lub false, w przeciwnym razie).

Powroty

Calendar – nowo zasubskrybowany kalendarz.

Rzuty

Error – jeśli nie istnieje kalendarz o tym identyfikatorze,

Upoważnienie

Skrypty używające tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami powiązanego interfejsu API REST:

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