Class CalendarApp

Kalendarzaplikacja

Umożliwia skryptowi odczytywanie i aktualizowanie Kalendarza Google użytkownika. Ta klasa zapewnia bezpośredni dostęp do domyślnego kalendarza użytkownika, a także możliwość pobierania dodatkowych kalendarzy, których użytkownik jest właścicielem lub do których jest subskrybentem.

Właściwości

WłaściwośćTypOpis
ColorColorWyliczenie reprezentujące nazwane kolory dostępne w usłudze Kalendarz.
EventColorEventColorWyliczenie reprezentujące nazwane kolory wydarzeń dostępne w usłudze Kalendarz.
EventTypeEventTypeWyliczenie EventType.
GuestStatusGuestStatusWyliczenie reprezentujące stany, jakie może mieć gość na wydarzeniu.
MonthMonthTyp enum reprezentujący miesiące w roku.
VisibilityVisibilityTyp enum reprezentujący widoczność zdarzenia.
WeekdayWeekdayTyp enum reprezentujący dni tygodnia.

Metody

MetodaZwracany typKrótki opis
createAllDayEvent(title, date)CalendarEventTworzy nowe wydarzenie całodniowe.
createAllDayEvent(title, startDate, endDate)CalendarEventTworzy nowe całodniowe wydarzenie, które może obejmować kilka dni.
createAllDayEvent(title, startDate, endDate, options)CalendarEventTworzy nowe całodniowe wydarzenie, które może obejmować 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 zdarzenie.
createEvent(title, startTime, endTime, options)CalendarEventTworzy nowe zdarzenie.
createEventFromDescription(description)CalendarEventTworzy zdarzenie na podstawie opisu swobodnego.
createEventSeries(title, startTime, endTime, recurrence)CalendarEventSeriestworzy nową serię zdarzeń,
createEventSeries(title, startTime, endTime, recurrence, options)CalendarEventSeriestworzy nową serię zdarzeń,
getAllCalendars()Calendar[]Pobiera wszystkie kalendarze należące do użytkownika lub do których jest on subskrybentem.
getAllOwnedCalendars()Calendar[]Pobiera wszystkie kalendarze należące do użytkownika.
getCalendarById(id)CalendarPobiera kalendarz o podanym identyfikatorze.
getCalendarsByName(name)Calendar[]Pobiera wszystkie kalendarze o podanej nazwie, które należą do użytkownika lub są przez niego subskrybowane.
getColor()StringPobiera kolor kalendarza.
getDefaultCalendar()CalendarPobiera domyślny kalendarz użytkownika.
getDescription()StringPobiera opis kalendarza.
getEventById(iCalId)CalendarEventPobiera wydarzenie o podanym identyfikatorze.
getEventSeriesById(iCalId)CalendarEventSeriesPobiera serię wydarzeń o podanym identyfikatorze.
getEvents(startTime, endTime)CalendarEvent[]Pobiera wszystkie zdarzenia, które występują w określonym zakresie czasowym.
getEvents(startTime, endTime, options)CalendarEvent[]Pobiera wszystkie zdarzenia, które wystąpiły w danym przedziale czasowym i spełniają określone kryteria.
getEventsForDay(date)CalendarEvent[]Pobiera wszystkie zdarzenia, które występują 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 on do użytkownika.
getOwnedCalendarsByName(name)Calendar[]Pobiera wszystkie należące do użytkownika kalendarze o podanej nazwie.
getTimeZone()StringPobiera strefę czasową kalendarza.
isHidden()BooleanOkreśla, czy kalendarz jest ukryty w interfejsie.
isMyPrimaryCalendar()BooleanOkreśla, czy kalendarz jest kalendarzem głównym dla danego użytkownika.
isOwnedByMe()BooleanOkreśla, czy kalendarz należy do Ciebie.
isSelected()BooleanOkreśla, czy wydarzenia z kalendarza są wyświetlane w interfejsie.
newRecurrence()EventRecurrenceTworzy nowy obiekt powtarzalności, który można wykorzystać do tworzenia reguł powtarzania zdarzeń.
setColor(color)CalendarUstawia kolor kalendarza.
setDescription(description)CalendarOkreśla 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.
setTimeZone(timeZone)CalendarUstawia strefę czasową kalendarza.
subscribeToCalendar(id)CalendarSubskrybuje kalendarz o podanym identyfikatorze, jeśli użytkownik ma do niego dostęp.
subscribeToCalendar(id, options)CalendarSubskrybuje kalendarz o podanym identyfikatorze, jeśli użytkownik ma do niego dostęp.

Szczegółowa dokumentacja

createAllDayEvent(title, date)

Tworzy nowe wydarzenie całodniowe.

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

Parametry

NazwaTypOpis
titleStringNazwa zdarzenia.
dateDateData zdarzenia (używany jest tylko dzień, godzina jest ignorowana).

Powrót

CalendarEvent – utworzone zdarzenie.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

createAllDayEvent(title, startDate, endDate)

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

// Creates an all-day event for the Woodstock festival (August 15th to 17th) and
// logs the ID.
const event = CalendarApp.getDefaultCalendar().createAllDayEvent(
    'Woodstock Festival',
    new Date('August 15, 1969'),
    new Date('August 18, 1969'),
);
Logger.log(`Event ID: ${event.getId()}`);

Parametry

NazwaTypOpis
titleStringNazwa zdarzenia.
startDateDateData rozpoczęcia wydarzenia (używany jest tylko dzień, godzina jest ignorowana).
endDateDateData zakończenia wydarzenia (używamy tylko dnia, godzina jest ignorowana). Data zakończenia jest traktowana wyłącznie.

Powrót

CalendarEvent – utworzone zdarzenie.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

createAllDayEvent(title, startDate, endDate, options)

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

// Creates an all-day event for the Woodstock festival (August 15th to 17th) and
// logs the ID.
const event = CalendarApp.getDefaultCalendar().createAllDayEvent(
    'Woodstock Festival',
    new Date('August 15, 1969'),
    new Date('August 18, 1969'),
    {location: 'Bethel, White Lake, New York, U.S.', sendInvites: true},
);
Logger.log(`Event ID: ${event.getId()}`);

Parametry

NazwaTypOpis
titleStringNazwa zdarzenia.
startDateDateData rozpoczęcia wydarzenia (używany jest tylko dzień, godzina jest ignorowana).
endDateDateData zakończenia wydarzenia (używamy tylko dnia, godzina jest ignorowana). Data zakończenia jest traktowana wyłącznie.
optionsObjectObiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
descriptionStringOpis zdarzenia.
locationStringLokalizacja wydarzenia.
guestsStringLista adresów e-mail rozdzielonych przecinkami, które powinny zostać dodane jako goście.
sendInvitesBooleanOkreśla, czy mają być wysyłane e-maile z zaproszeniem (domyślnie: false).

Powrót

CalendarEvent – utworzone zdarzenie.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.
const event = CalendarApp.getDefaultCalendar().createAllDayEvent(
    'Apollo 11 Landing',
    new Date('July 20, 1969'),
    {location: 'The Moon'},
);
Logger.log(`Event ID: ${event.getId()}`);

Parametry

NazwaTypOpis
titleStringNazwa zdarzenia.
dateDateData zdarzenia (używany jest tylko dzień, godzina jest ignorowana).
optionsObjectObiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
descriptionStringOpis zdarzenia.
locationStringLokalizacja wydarzenia.
guestsStringLista adresów e-mail rozdzielonych przecinkami, które powinny zostać dodane jako goście.
sendInvitesBooleanOkreśla, czy mają być wysyłane e-maile z zaproszeniem (domyślnie: false).

Powrót

CalendarEvent – utworzone zdarzenie.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.
const eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries(
    'No Meetings',
    new Date('January 2, 2013 03:00:00 PM EST'),
    CalendarApp.newRecurrence()
        .addWeeklyRule()
        .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
        .until(new Date('January 1, 2014')),
);
Logger.log(`Event Series ID: ${eventSeries.getId()}`);

Parametry

NazwaTypOpis
titleStringtytuły wydarzeń w serii,
startDateDatedata pierwszego zdarzenia w serii (używamy tylko dnia, godzina jest ignorowana);
recurrenceEventRecurrenceustawień powtarzania serii wydarzeń.

Powrót

CalendarEventSeries – utworzona seria zdarzeń

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.
const eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries(
    'No Meetings',
    new Date('January 2, 2013 03:00:00 PM EST'),
    CalendarApp.newRecurrence()
        .addWeeklyRule()
        .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
        .until(new Date('January 1, 2014')),
    {guests: 'everyone@example.com'},
);
Logger.log(`Event Series ID: ${eventSeries.getId()}`);

Parametry

NazwaTypOpis
titleStringtytuły wydarzeń w serii,
startDateDatedata pierwszego zdarzenia w serii (używamy tylko dnia, godzina jest ignorowana);
recurrenceEventRecurrenceustawień powtarzania serii wydarzeń.
optionsObjectobiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis wydarzeń w serii.
locationStringlokalizacja wydarzeń w serii.
guestsStringlistę adresów e-mail rozdzielonych przecinkami, które mają zostać dodane jako goście do wydarzeń w serii.
sendInvitesBooleanczy mają być wysyłane e-maile z zaproszeniem (wartość domyślna: false).

Powrót

CalendarEventSeries – utworzona seria zdarzeń

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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".
const calendar = CalendarApp.createCalendar('Travel Plans');
Logger.log(
    'Created the calendar "%s", with the ID "%s".',
    calendar.getName(),
    calendar.getId(),
);

Parametry

NazwaTypOpis
nameStringnazwę nowego kalendarza.

Powrót

Calendar – nowo utworzony kalendarz

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 description and color.
const calendar = CalendarApp.createCalendar('Travel Plans', {
  description: 'A calendar to plan my travel schedule.',
  color: CalendarApp.Color.BLUE,
});
Logger.log(
    'Created the calendar "%s", with the ID "%s".',
    calendar.getName(),
    calendar.getId(),
);

Parametry

NazwaTypOpis
nameStringnazwę nowego kalendarza.
optionsObjectobiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

NazwaTypOpis
locationStringlokalizacja kalendarza,
descriptionStringopis kalendarza;
timeZoneStringstrefę czasową, w której ma być ustawiony kalendarz, w formacie „długim” (np. „America/New_York” (według strony Joda.org).
colorStringszesnastkowy kod 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).

Powrót

Calendar – nowo utworzony kalendarz

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

createEvent(title, startTime, endTime)

Tworzy nowe zdarzenie.

Jeśli nie zostanie określona strefa czasowa, wartości czasu są interpretowane w kontekście strefy czasowej skryptu, która może być inna niż strefa czasowa kalendarza.

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

Parametry

NazwaTypOpis
titleStringtytuł wydarzenia,
startTimeDatedata i godzina rozpoczęcia zdarzenia.
endTimeDatedata i godzina zakończenia zdarzenia.

Powrót

CalendarEvent – utworzone zdarzenie

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

createEvent(title, startTime, endTime, options)

Tworzy nowe zdarzenie.

Jeśli nie zostanie określona strefa czasowa, wartości czasu są interpretowane w kontekście strefy czasowej skryptu, która może być inna niż strefa czasowa kalendarza.

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

Parametry

NazwaTypOpis
titleStringtytuł wydarzenia,
startTimeDatedata i godzina rozpoczęcia zdarzenia.
endTimeDatedata i godzina zakończenia zdarzenia.
optionsObjectobiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis zdarzenia,
locationStringlokalizacja wydarzenia,
guestsStringlistę adresów e-mail rozdzielonych przecinkami, które mają zostać dodane jako goście;
sendInvitesBooleanczy mają być wysyłane e-maile z zaproszeniem (wartość domyślna: false).

Powrót

CalendarEvent – utworzone zdarzenie

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

createEventFromDescription(description)

Tworzy zdarzenie na podstawie opisu swobodnego.

Opis powinien być w tym samym formacie co funkcja „Szybkie dodawanie” w interfejsie.

// Creates a new event and logs its ID.
const event = CalendarApp.getDefaultCalendar().createEventFromDescription(
    'Lunch with Mary, Friday at 1PM',
);
Logger.log(`Event ID: ${event.getId()}`);

Parametry

NazwaTypOpis
descriptionStringdowolny opis wydarzenia;

Powrót

CalendarEvent – utworzone zdarzenie

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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ę zdarzeń,

// Creates an event series for a team meeting, taking place every Tuesday and
// Thursday in 2013.
const eventSeries = CalendarApp.getDefaultCalendar().createEventSeries(
    'Team Meeting',
    new Date('January 1, 2013 03:00:00 PM EST'),
    new Date('January 1, 2013 04:00:00 PM EST'),
    CalendarApp.newRecurrence()
        .addWeeklyRule()
        .onlyOnWeekdays(
            [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY])
        .until(new Date('January 1, 2014')),
);
Logger.log(`Event Series ID: ${eventSeries.getId()}`);

Parametry

NazwaTypOpis
titleStringtytuły wydarzeń w serii,
startTimeDatedata i godzina rozpoczęcia pierwszego wydarzenia w serii
endTimeDatedata i godzina zakończenia pierwszego zdarzenia w serii.
recurrenceEventRecurrenceustawień powtarzania serii wydarzeń.

Powrót

CalendarEventSeries – utworzona seria zdarzeń

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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ę zdarzeń,

// Creates an event series for a team meeting, taking place every Tuesday and
// Thursday in 2013.
const eventSeries = CalendarApp.getDefaultCalendar().createEventSeries(
    'Team Meeting',
    new Date('January 1, 2013 03:00:00 PM EST'),
    new Date('January 1, 2013 04:00:00 PM EST'),
    CalendarApp.newRecurrence()
        .addWeeklyRule()
        .onlyOnWeekdays(
            [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY])
        .until(new Date('January 1, 2014')),
    {location: 'Conference Room'},
);
Logger.log(`Event Series ID: ${eventSeries.getId()}`);

Parametry

NazwaTypOpis
titleStringtytuły wydarzeń w serii,
startTimeDatedata i godzina rozpoczęcia pierwszego wydarzenia w serii
endTimeDatedata i godzina zakończenia pierwszego zdarzenia w serii.
recurrenceEventRecurrenceustawień powtarzania serii wydarzeń.
optionsObjectobiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

NazwaTypOpis
descriptionStringopis wydarzeń w serii.
locationStringlokalizacja wydarzeń w serii.
guestsStringlistę adresów e-mail rozdzielonych przecinkami, które mają zostać dodane jako goście do wydarzeń w serii.
sendInvitesBooleanczy mają być wysyłane e-maile z zaproszeniem (wartość domyślna: false).

Powrót

CalendarEventSeries – utworzona seria zdarzeń

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

getAllCalendars()

Pobiera wszystkie kalendarze należące do użytkownika lub do których jest on subskrybentem.

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

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.
const calendars = CalendarApp.getAllOwnedCalendars();
Logger.log('This user owns %s calendars.', calendars.length);

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.
const calendar = CalendarApp.getCalendarById(
    'en.usa#holiday@group.v.calendar.google.com',
);
Logger.log('The calendar is named "%s".', calendar.getName());

Parametry

NazwaTypOpis
idStringidentyfikator kalendarza.

Powrót

Calendar – kalendarz o podanym identyfikatorze lub null, jeśli kalendarz nie istnieje, użytkownik nie ma do niego dostępu lub użytkownik nie subskrybuje tego kalendarza;

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 podanej nazwie, które należą do użytkownika lub są przez niego subskrybowane. W nazwach nie jest rozróżniana wielkość liter.

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

Parametry

NazwaTypOpis
nameStringnazwa kalendarza.

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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);

Powrót

String – szesnastkowy kod koloru („#rrggbb”).

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.
const calendar = CalendarApp.getDefaultCalendar();
Logger.log(
    'My default calendar is set to the time zone "%s".',
    calendar.getTimeZone(),
);

Powrót

Calendar – domyślny kalendarz użytkownika,

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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);

Powrót

String – opis tego kalendarza.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 wydarzenie o podanym identyfikatorze. Jeśli seria należy do innego kalendarza niż domyślny, ta metoda musi być wywoływana z tego kalendarza. Wywołanie funkcji getEventById(iCalId) zwraca tylko wydarzenie w kalendarzu domyślnym.

Jeśli zdarzenia należą do serii, mogą mieć ten sam identyfikator. W tym przypadku zwraca tylko pierwsze zdarzenie z tej serii.

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

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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ę wydarzeń o podanym identyfikatorze. Jeśli podany identyfikator dotyczy pojedynczego zdarzenia CalendarEvent, zwracane jest zdarzenie CalendarEventSeries z jednego zdarzenia z serii. Pamiętaj, że jeśli seria wydarzeń należy do kalendarza innego niż domyślny, ta metoda musi być wywoływana z tego kalendarza CalendarApp; bezpośrednie wywołanie metody getEventSeriesById(iCalId) zwraca tylko serię wydarzeń, która istnieje 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ń.

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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ępują w określonym zakresie czasowym.

Ta metoda zwraca zdarzenia, które rozpoczynają się w danym zakresie czasowym, kończą się w danym zakresie czasowym lub obejmują cały zakres czasowy. Jeśli nie zostanie określona strefa czasowa, wartości czasu będą interpretowane w kontekście strefy czasowej skryptu, która może być inna niż strefa czasowa kalendarza.

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

Parametry

NazwaTypOpis
startTimeDatepoczątek zakresu czasowego.
endTimeDatekoniec zakresu czasowego (bez uwzględnienia tej daty).

Powrót

CalendarEvent[] – zdarzenia, które występują w wybranym zakresie czasu

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 czasowym i spełniają określone kryteria.

Ta metoda zwraca zdarzenia, które rozpoczynają się w danym przedziale czasowym, kończą się w danym przedziale czasowym lub obejmują dany przedział czasowy. Jeśli nie zostanie określona strefa czasowa, wartości czasu będą interpretowane w kontekście strefy czasowej skryptu, która może być inna niż strefa czasowa kalendarza.

Pamiętaj, że filtrowanie według atrybutów author, search lub statusFilters odbywa się po zastosowaniu filtrów start i max. Oznacza to, że zwrócona liczba 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".
const now = new Date();
const twoHoursFromNow = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const events = CalendarApp.getDefaultCalendar().getEvents(
    now,
    twoHoursFromNow,
    {search: 'meeting'},
);
Logger.log(`Number of events: ${events.length}`);

Parametry

NazwaTypOpis
startTimeDatepoczątek zakresu czasowego.
endTimeDatekoniec zakresu czasowego (bez uwzględnienia tej daty).
optionsObjectobiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

NazwaTypOpis
startIntegerindeks pierwszego zdarzenia, które ma zostać zwrócone
maxIntegermaksymalna liczba zwracanych zdarzeń.
authorStringadres e-mail służący do filtrowania wyników według twórcy wydarzenia;
searchStringzapytanie wyszukiwania pełnego tekstu służące do filtrowania wyników;
statusFilters[]GuestStatustablica stanów służących do filtrowania wyników

Powrót

CalendarEvent[] – zdarzenia, które mają miejsce w wybranym zakresie czasu i spełniają kryteria

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 występują w danym dniu.

Ta metoda zwraca zdarzenia, jeśli zaczynają się w danym dniu, kończą się w danym dniu lub obejmują cały dzień.

Pamiętaj, że używana jest tylko część daty obiektu Date, a część czasu jest ignorowana. Data jest interpretowana jako okres od północy danego dnia do północy następnego dnia według strefy czasowej kalendarza.

// Determines how many events are happening today.
const today = new Date();
const events = CalendarApp.getDefaultCalendar().getEventsForDay(today);
Logger.log(`Number of events: ${events.length}`);

Parametry

NazwaTypOpis
dateDatedata, z której mają być pobierane zdarzenia (używany jest tylko dzień, godzina jest ignorowana);

Powrót

CalendarEvent[] – zdarzenia występujące w określonym dniu.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 zaczynają się w danym dniu, kończą się w danym dniu lub obejmują cały dzień.

Pamiętaj, że używana jest tylko część daty obiektu Date, a część czasu jest ignorowana. Data jest interpretowana jako okres od północy danego dnia do północy następnego dnia według strefy czasowej kalendarza.

Pamiętaj, że filtrowanie według atrybutów author, search lub statusFilters odbywa się po zastosowaniu filtrów start i max. Oznacza to, że zwrócona liczba 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".
const today = new Date();
const events = CalendarApp.getDefaultCalendar().getEventsForDay(today, {
  search: 'meeting',
});
Logger.log(`Number of events: ${events.length}`);

Parametry

NazwaTypOpis
dateDatedata, z której mają być pobierane zdarzenia (używany jest tylko dzień, godzina jest ignorowana);
optionsObjectzaawansowane opcje filtrowania.

Parametry zaawansowane

NazwaTypOpis
startIntegerindeks pierwszego zdarzenia, które ma zostać zwrócone
maxIntegermaksymalna liczba zwracanych zdarzeń.
authorStringadres e-mail służący do filtrowania wyników według twórcy wydarzenia;
searchStringzapytanie wyszukiwania pełnego tekstu służące do filtrowania wyników;
statusFilters[]GuestStatustablica stanów służących do filtrowania wyników

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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. 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);

Powrót

String – identyfikator kalendarza.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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);

Powrót

String – nazwa tego kalendarza.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 on do użytkownika.

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

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

Parametry

NazwaTypOpis
idStringidentyfikator kalendarza.

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 należące do użytkownika kalendarze o podanej nazwie. W nazwach nie jest rozróżniana wielkość liter.

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

Parametry

NazwaTypOpis
nameStringnazwa kalendarza.

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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);

Powrót

String – strefa czasowa określona w formacie „długim” (np. „Ameryka/Nowy Jork”, zgodnie z informacjami na stronie Joda.org).

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.

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

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 dla danego 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);

Powrót

Booleantrue, jeśli jest to domyślny kalendarz użytkownika; false, jeśli nie.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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());

Powrót

Boolean – true, jeśli kalendarz należy do Ciebie, false w przeciwnym razie.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.

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

Powrót

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 powtarzalności, który można wykorzystać do tworzenia reguł powtarzania zdarzeń.

// Creates an event series for a no-meetings day, taking place every Wednesday
// in 2013.
const recurrence = CalendarApp.newRecurrence()
                       .addWeeklyRule()
                       .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
                       .until(new Date('January 1, 2014'));
const eventSeries = CalendarApp.getDefaultCalendar().createAllDayEventSeries(
    'No Meetings',
    new Date('January 2, 2013 03:00:00 PM EST'),
    recurrence,
);
Logger.log(`Event Series ID: ${eventSeries.getId()}`);

Powrót

EventRecurrence – nowy obiekt powtarzania bez ustawionych reguł (działa jak powtarzanie co tydzień)

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 kod koloru („#rrggbb”).

Powrót

Calendar – ten kalendarz do łańcucha.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

setDescription(description)

Określa 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,

Powrót

Calendar – ten kalendarz do łańcucha,

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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.

Parametry

NazwaTypOpis
hiddenBooleantrue, aby ukryć kalendarz w interfejsie, lub false, aby go pokazać.

Powrót

Calendar – ten kalendarz do łańcucha,

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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

Powrót

Calendar – ten kalendarz do łańcucha,

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 są wyświetlane w interfejsie.

// 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świetlać wydarzenia z kalendarza w interfejsie użytkownika; false – aby je ukryć.

Powrót

Calendar – ten kalendarz do łańcucha,

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z 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 „długim” formacie (np. „America/New_York”, zgodnie z danymi z witryny Joda.org).

Powrót

Calendar – ten kalendarz do łańcucha.

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

subscribeToCalendar(id)

Subskrybuje kalendarz o podanym identyfikatorze, jeśli użytkownik ma do niego dostęp.

// Subscribe to the calendar "US Holidays".
const calendar = CalendarApp.subscribeToCalendar(
    'en.usa#holiday@group.v.calendar.google.com',
);
Logger.log('Subscribed to the calendar "%s".', calendar.getName());

Parametry

NazwaTypOpis
idStringidentyfikator kalendarza, który chcesz zasubskrybować;

Powrót

Calendar – nowo dodany kalendarz.

Rzuty

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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

subscribeToCalendar(id, options)

Subskrybuje kalendarz o podanym identyfikatorze, jeśli użytkownik ma do niego dostęp.

// Subscribe to the calendar "US Holidays", and set it to the color blue.
const 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 którego chcesz się zasubskrybować.
optionsObjectObiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

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

Powrót

Calendar – nowo subskrybowany kalendarz.

Rzuty

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

Autoryzacja

Scenariusze, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

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