Class CalendarApp

CalendarApp

Zezwala skryptowi na odczyt i aktualizowanie Kalendarza Google użytkownika. Te zajęcia zapewniają bezpośredni dostęp do domyślnego kalendarza użytkownika, a także pobieranie dodatkowych kalendarzy, które należą do użytkownika 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 stany wydarzenia gościa.
MonthMonthWyliczenie reprezentujące miesiące w roku.
VisibilityVisibilityWyliczenie reprezentujące widoczność zdarzenia.
WeekdayWeekdayWyliczenie reprezentujące dni tygodnia.

Metody

MetodaZwracany typKró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, których użytkownik jest właścicielem lub które subskrybuje.
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óry 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 w danym przedziale czasu i spełniające określone kryteria.
getEventsForDay(date)CalendarEvent[]Pobiera wszystkie zdarzenia mające 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 danej nazwie należącej do użytkownika.
getTimeZone()StringPobiera strefę czasową kalendarza.
isHidden()BooleanOkreśla, czy kalendarz jest ukryty w interfejsie.
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.
setName(name)CalendarUstawia nazwę kalendarza.
setSelected(selected)CalendarOkreśla, czy wydarzenia z kalendarza są wyświetlane w interfejsie użytkownika.
setTimeZone(timeZone)CalendarUstawia strefę czasową kalendarza.
subscribeToCalendar(id)CalendarSubskrybuje użytkownika kalendarza o podanym identyfikatorze, jeśli może on subskrybować kalendarz.
subscribeToCalendar(id, options)CalendarSubskrybuje użytkownika kalendarza o podanym identyfikatorze, jeśli może on subskrybować kalendarz.

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
titleStringTytuł wydarzenia.
dateDateData zdarzenia (stosowany jest tylko dzień; godzina jest ignorowana).

Powroty

CalendarEvent – utworzone wydarzenie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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
titleStringTytuł wydarzenia.
startDateDateData rozpoczęcia wydarzenia (stosowany jest tylko dzień; godzina jest ignorowana).
endDateDateData zakończenia wydarzenia (stosowany jest tylko dzień; godzina jest ignorowana). Data zakończenia nie jest dostępna.

Powroty

CalendarEvent – utworzone wydarzenie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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
titleStringTytuł wydarzenia.
startDateDateData rozpoczęcia wydarzenia (stosowany jest tylko dzień; godzina jest ignorowana).
endDateDateData zakończenia wydarzenia (stosowany 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 wydarzenie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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
titleStringTytuł wydarzenia.
dateDateData zdarzenia (stosowany jest tylko dzień; 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 wydarzenie.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 (stosowany jest tylko dzień; godzina jest ignorowana)
recurrenceEventRecurrenceustawienia powtarzania serii zdarzeń.

Powroty

CalendarEventSeries – utworzona seria wydarzeń

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 (stosowany jest tylko dzień; godzina jest ignorowana)
recurrenceEventRecurrenceustawienia powtarzania serii zdarzeń.
optionsObjectobiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis wydarzeń z serii,
locationStringmiejsce wydarzeń w serii,
guestsStringrozdzielaną przecinkami listę adresów e-mail, które należy dodać jako gości wydarzeń w serii
sendInvitesBooleanczy wysyłać e-maile z zaproszeniami (domyślnie: false).

Powroty

CalendarEventSeries – utworzona seria wydarzeń

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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, który określa parametry zaawansowane, jak opisano poniżej

Parametry zaawansowane

NazwaTypOpis
locationStringlokalizacja kalendarza
summaryStringopis kalendarza;
timeZoneStringStrefa czasowa, według której chcesz ustawić kalendarz, podana w formacie „długi” (np. „America/New_York”, zgodnie z listą Joda.org)
colorStringszesnastkowy ciąg koloru („#rrggbb”) lub wartość z CalendarApp.Colors
hiddenBooleanczy kalendarz jest ukryty w interfejsie (domyślnie: false),
selectedBooleanczy wydarzenia z kalendarza są wyświetlane w interfejsie (domyślnie: true).

Powroty

Calendar – nowo utworzony kalendarz

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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
startTimeDatedata i godzina rozpoczęcia wydarzenia;
endTimeDatedata i godzina zakończenia wydarzenia;

Powroty

CalendarEvent – utworzone wydarzenie,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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
startTimeDatedata i godzina rozpoczęcia wydarzenia;
endTimeDatedata i godzina zakończenia wydarzenia;
optionsObjectobiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis wydarzenia;
locationStringlokalizacja wydarzenia
guestsStringrozdzielaną przecinkami listę adresów e-mail, które należy dodać jako gości
sendInvitesBooleanczy wysyłać e-maile z zaproszeniami (domyślnie: false).

Powroty

CalendarEvent – utworzone wydarzenie,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 w przypadku funkcji „Szybkie dodawanie” w interfejsie.

// 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
descriptionStringdowolny opis wydarzenia;

Powroty

CalendarEvent – utworzone wydarzenie,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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, który określa parametry zaawansowane, jak opisano poniżej

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis wydarzeń z serii,
locationStringmiejsce wydarzeń w serii,
guestsStringrozdzielaną przecinkami listę adresów e-mail, które należy dodać jako gości wydarzeń w serii
sendInvitesBooleanczy wysyłać e-maile z zaproszeniami (domyślnie: false).

Powroty

CalendarEventSeries – utworzona seria wydarzeń

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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

getAllCalendars()

Pobiera wszystkie kalendarze, których użytkownik jest właścicielem lub które subskrybuje.

// 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 użytkownik nie subskrybuje kalendarza

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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óry subskrybuje. W nazwach nie jest rozróżniana wielkość liter.

// 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 koloru („#rrggbb”).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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, należy wywołać tę metodę z tego kalendarza. Wywołanie getEventById(iCalId) powoduje zwrócenie wydarzenia tylko w domyślnym kalendarzu.

Wiele wydarzeń może mieć ten sam identyfikator, jeśli należą do serii wydarzeń. W tym przypadku metoda 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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, tę metodę należy wywołać z poziomu tego kalendarza CalendarApp. Wywołanie getEventSeriesById(iCalId) zwraca tylko serię wydarzeń w kalendarzu domyślnym.

// 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 seria nie istnieje lub użytkownik nie ma do niej dostępu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 nim lub obejmują ten okres. Jeśli nie określisz strefy czasowej, wartości czasowe są 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 czasowego
endTimeDatekoniec zakresu czasowego, niezawierający

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 w danym przedziale czasu i spełniające określone kryteria.

Ta metoda zwraca zdarzenia, które rozpoczęły się w danym okresie, zakończyły się w nim lub obejmuje ten okres. Jeśli nie określisz strefy czasowej, wartości czasowe są 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, mimo że 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 czasowego
endTimeDatekoniec zakresu czasowego, niezawierający
optionsObjectobiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej

Parametry zaawansowane

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

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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

getEventsForDay(date)

Pobiera wszystkie zdarzenia mające miejsce w danym dniu.

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

Stosowana jest tylko część dotycząca daty obiektu Date, a część czasu jest ignorowana. Data jest interpretowana 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ń; czas nie jest brany pod uwagę)

Powroty

CalendarEvent[] – wydarzenia, które mają miejsce w danym dniu;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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ń.

Stosowana jest tylko część dotycząca daty obiektu Date, a część czasu jest ignorowana. Data jest interpretowana 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, mimo że 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ń; czas nie jest brany pod uwagę)
optionsObjectzaawansowane opcje filtrowania

Parametry zaawansowane

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

Powroty

CalendarEvent[] – wydarzenia w danym dniu, które spełniają kryteria.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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

getId()

Pobiera identyfikator kalendarza. Identyfikatorem domyślnego kalendarza użytkownika jest 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 danej 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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” (np. „Ameryka/Nowy_Jork” według nazwy Joda.org).

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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

// 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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; jeśli nie są wyświetlane: false.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 – kalendarz do tworzenia łańcuszków.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 do tworzenia łańcuszków

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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

setHidden(hidden)

Określa, czy kalendarz jest widoczny w interfejsie.

Parametry

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

Powroty

Calendar – ten kalendarz do tworzenia łańcuszków

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 do tworzenia łańcuszków

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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

setSelected(selected)

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

// 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 pokazać wydarzenia z kalendarza w interfejsie, false, aby je ukryć

Powroty

Calendar – ten kalendarz do tworzenia łańcuszków

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

  • 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 – kalendarz do tworzenia łańcuszków.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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

subscribeToCalendar(id)

Subskrybuje użytkownika kalendarza o podanym identyfikatorze, jeśli może on subskrybować kalendarz.

// 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 korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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

subscribeToCalendar(id, options)

Subskrybuje użytkownika kalendarza o podanym identyfikatorze, jeśli może on subskrybować kalendarz.

// 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, który określa parametry zaawansowane, jak opisano poniżej

Parametry zaawansowane

NazwaTypOpis
colorStringszesnastkowy ciąg koloru („#rrggbb”) lub wartość z CalendarApp.Colors
hiddenBooleanczy kalendarz jest ukryty w interfejsie (domyślnie: false),
selectedBooleanczy wydarzenia z kalendarza są wyświetlane w interfejsie (domyślnie: true).

Powroty

Calendar – nowo zasubskrybowany kalendarz

Rzuty

Error – jeśli nie istnieje kalendarz o tym identyfikatorze

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:

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