Class Calendar

Reprezentuje kalendarz, którego użytkownik jest właścicielem lub subskrybentem.

Metody

Metoda	Zwracany typ	Krótki opis
`createAllDayEvent(title, date)`	`CalendarEvent`	Tworzy nowe wydarzenie całodniowe.
`createAllDayEvent(title, startDate, endDate)`	`CalendarEvent`	Tworzy nowe całodniowe wydarzenie, które może obejmować kilka dni.
`createAllDayEvent(title, startDate, endDate, options)`	`CalendarEvent`	Tworzy nowe całodniowe wydarzenie, które może obejmować kilka dni.
`createAllDayEvent(title, date, options)`	`CalendarEvent`	Tworzy nowe wydarzenie całodniowe.
`createAllDayEventSeries(title, startDate, recurrence)`	`CalendarEventSeries`	tworzy nową serię wydarzeń całodniowych.
`createAllDayEventSeries(title, startDate, recurrence, options)`	`CalendarEventSeries`	tworzy nową serię wydarzeń całodniowych.
`createEvent(title, startTime, endTime)`	`CalendarEvent`	Utworzy nowe zdarzenie.
`createEvent(title, startTime, endTime, options)`	`CalendarEvent`	Utworzy nowe zdarzenie.
`createEventFromDescription(description)`	`CalendarEvent`	Tworzy zdarzenie na podstawie opisu swobodnego.
`createEventSeries(title, startTime, endTime, recurrence)`	`CalendarEventSeries`	tworzy nową serię zdarzeń,
`createEventSeries(title, startTime, endTime, recurrence, options)`	`CalendarEventSeries`	tworzy nową serię zdarzeń,
`deleteCalendar()`	`void`	Trwale usuwa kalendarz.
`getColor()`	`String`	Pobiera kolor kalendarza.
`getDescription()`	`String`	Pobiera opis kalendarza.
`getEventById(iCalId)`	`CalendarEvent`	Pobiera wydarzenie o podanym identyfikatorze.
`getEventSeriesById(iCalId)`	`CalendarEventSeries`	Pobiera serię wydarzeń o podanym identyfikatorze.
`getEvents(startTime, endTime)`	`CalendarEvent[]`	Pobiera wszystkie zdarzenia, które wystąpiły 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()`	`String`	Pobiera identyfikator kalendarza.
`getName()`	`String`	Pobiera nazwę kalendarza.
`getTimeZone()`	`String`	Pobiera strefę czasową kalendarza.
`isHidden()`	`Boolean`	Określa, czy kalendarz jest ukryty w interfejsie.
`isMyPrimaryCalendar()`	`Boolean`	Określa, czy kalendarz jest kalendarzem głównym dla danego użytkownika.
`isOwnedByMe()`	`Boolean`	Określa, czy kalendarz należy do Ciebie.
`isSelected()`	`Boolean`	Określa, czy wydarzenia z kalendarza są wyświetlane w interfejsie.
`setColor(color)`	`Calendar`	Ustawia kolor kalendarza.
`setDescription(description)`	`Calendar`	Określa opis kalendarza.
`setHidden(hidden)`	`Calendar`	Określa, czy kalendarz jest widoczny w interfejsie.
`setName(name)`	`Calendar`	Ustawia nazwę kalendarza.
`setSelected(selected)`	`Calendar`	Określa, czy wydarzenia z kalendarza są wyświetlane w interfejsie.
`setTimeZone(timeZone)`	`Calendar`	Ustawia strefę czasową kalendarza.
`unsubscribeFromCalendar()`	`void`	anulowanie subskrypcji kalendarza przez użytkownika;

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

Nazwa	Typ	Opis
`title`	`String`	Nazwa zdarzenia.
`date`	`Date`	Data 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

Nazwa	Typ	Opis
`title`	`String`	Nazwa zdarzenia.
`startDate`	`Date`	Data rozpoczęcia wydarzenia (używany jest tylko dzień, godzina jest ignorowana).
`endDate`	`Date`	Data 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

Nazwa	Typ	Opis
`title`	`String`	Nazwa zdarzenia.
`startDate`	`Date`	Data rozpoczęcia wydarzenia (używany jest tylko dzień, godzina jest ignorowana).
`endDate`	`Date`	Data zakończenia wydarzenia (używamy tylko dnia, godzina jest ignorowana). Data zakończenia jest traktowana wyłącznie.
`options`	`Object`	Obiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
`description`	`String`	Opis zdarzenia.
`location`	`String`	Lokalizacja wydarzenia.
`guests`	`String`	Lista adresów e-mail rozdzielonych przecinkami, które powinny zostać dodane jako goście.
`sendInvites`	`Boolean`	Okreś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

Nazwa	Typ	Opis
`title`	`String`	Nazwa zdarzenia.
`date`	`Date`	Data zdarzenia (używany jest tylko dzień, godzina jest ignorowana).
`options`	`Object`	Obiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
`description`	`String`	Opis zdarzenia.
`location`	`String`	Lokalizacja wydarzenia.
`guests`	`String`	Lista adresów e-mail rozdzielonych przecinkami, które powinny zostać dodane jako goście.
`sendInvites`	`Boolean`	Okreś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

Nazwa	Typ	Opis
`title`	`String`	tytuły wydarzeń w serii,
`startDate`	`Date`	data pierwszego zdarzenia w serii (używamy tylko dnia, godzina jest ignorowana);
`recurrence`	`EventRecurrence`	ustawień 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

Nazwa	Typ	Opis
`title`	`String`	tytuły wydarzeń w serii,
`startDate`	`Date`	data pierwszego zdarzenia w serii (używamy tylko dnia, godzina jest ignorowana);
`recurrence`	`EventRecurrence`	ustawień powtarzania serii wydarzeń.
`options`	`Object`	obiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

Nazwa	Typ	Opis
`description`	`String`	opis wydarzeń w serii.
`location`	`String`	lokalizacja wydarzeń w serii.
`guests`	`String`	listę adresów e-mail rozdzielonych przecinkami, które mają zostać dodane jako goście do wydarzeń w serii.
`sendInvites`	`Boolean`	czy mają być wysyłane e-maile z zaproszeniem (domyślnie: `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

`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

Nazwa	Typ	Opis
`title`	`String`	tytuł wydarzenia,
`startTime`	`Date`	data i godzina rozpoczęcia zdarzenia.
`endTime`	`Date`	data 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

Nazwa	Typ	Opis
`title`	`String`	tytuł wydarzenia,
`startTime`	`Date`	data i godzina rozpoczęcia zdarzenia.
`endTime`	`Date`	data i godzina zakończenia zdarzenia.
`options`	`Object`	obiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

Nazwa	Typ	Opis
`description`	`String`	opis zdarzenia,
`location`	`String`	lokalizacja wydarzenia,
`guests`	`String`	listę adresów e-mail rozdzielonych przecinkami, które mają zostać dodane jako goście;
`sendInvites`	`Boolean`	czy 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

Nazwa	Typ	Opis
`description`	`String`	dowolny 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

Nazwa	Typ	Opis
`title`	`String`	tytuły wydarzeń w serii,
`startTime`	`Date`	data i godzina rozpoczęcia pierwszego wydarzenia w serii
`endTime`	`Date`	data i godzina zakończenia pierwszego zdarzenia w serii.
`recurrence`	`EventRecurrence`	ustawień 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

Nazwa	Typ	Opis
`title`	`String`	tytuły wydarzeń w serii,
`startTime`	`Date`	data i godzina rozpoczęcia pierwszego wydarzenia w serii
`endTime`	`Date`	data i godzina zakończenia pierwszego zdarzenia w serii.
`recurrence`	`EventRecurrence`	ustawień powtarzania serii wydarzeń.
`options`	`Object`	obiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

Nazwa	Typ	Opis
`description`	`String`	opis wydarzeń w serii.
`location`	`String`	lokalizacja wydarzeń w serii.
`guests`	`String`	listę adresów e-mail rozdzielonych przecinkami, które mają zostać dodane jako goście do wydarzeń w serii.
`sendInvites`	`Boolean`	czy mają być wysyłane e-maile z zaproszeniem (domyślnie: `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

`deleteCalendar()`

Trwale usuwa kalendarz. Użytkownik może usunąć tylko kalendarz, który należy do niego.

// Creates a calendar to delete.
const calendar = CalendarApp.createCalendar('Test');

// Deletes the 'Test' calendar permanently.
calendar.deleteCalendar();

Rzuty

Error – jeśli jest to zaimportowany 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

`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

`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 CalendarApp.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

Nazwa	Typ	Opis
`iCalId`	`String`	Identyfikator 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 Calendar; bezpośrednie wywołanie metody CalendarApp.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

Nazwa	Typ	Opis
`iCalId`	`String`	Identyfikator 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

Nazwa	Typ	Opis
`startTime`	`Date`	początek zakresu czasowego.
`endTime`	`Date`	koniec 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

Nazwa	Typ	Opis
`startTime`	`Date`	początek zakresu czasowego.
`endTime`	`Date`	koniec zakresu czasowego (bez uwzględnienia tej daty).
`options`	`Object`	obiekt JavaScript określający parametry zaawansowane, wymienione poniżej;

Parametry zaawansowane

Nazwa	Typ	Opis
`start`	`Integer`	indeks pierwszego zdarzenia, które ma zostać zwrócone
`max`	`Integer`	maksymalna liczba zwracanych zdarzeń.
`author`	`String`	adres e-mail służący do filtrowania wyników według twórcy wydarzenia;
`search`	`String`	zapytanie wyszukiwania pełnego tekstu służące do filtrowania wyników;
`statusFilters[]`	`GuestStatus`	tablica 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

Nazwa	Typ	Opis
`date`	`Date`	data, z której mają być pobierane zdarzenia (używamy tylko dnia, 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ń.

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

Nazwa	Typ	Opis
`date`	`Date`	data, z której mają być pobierane zdarzenia (używany jest tylko dzień, godzina jest ignorowana);
`options`	`Object`	zaawansowane opcje filtrowania.

Parametry zaawansowane

Nazwa	Typ	Opis
`start`	`Integer`	indeks pierwszego zdarzenia, które ma zostać zwrócone
`max`	`Integer`	maksymalna liczba zwracanych zdarzeń.
`author`	`String`	adres e-mail służący do filtrowania wyników według twórcy wydarzenia;
`search`	`String`	zapytanie wyszukiwania pełnego tekstu służące do filtrowania wyników;
`statusFilters[]`	`GuestStatus`	tablica 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

`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

Boolean – true, 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

Boolean – true, 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

Boolean – true, 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

`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

Nazwa	Typ	Opis
`color`	`String`	`CalendarApp.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

Nazwa	Typ	Opis
`description`	`String`	opis 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

Nazwa	Typ	Opis
`hidden`	`Boolean`	`true`, 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

Nazwa	Typ	Opis
`name`	`String`	nowa 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

Nazwa	Typ	Opis
`selected`	`Boolean`	`true` – 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

Nazwa	Typ	Opis
`timeZone`	`String`	Strefa 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

`unsubscribeFromCalendar()`

anulowanie subskrypcji kalendarza przez użytkownika; Użytkownik nie może anulować subskrypcji kalendarzy znajdujących się na liście Moje kalendarze. Mogą anulować subskrypcję kalendarzy wymienionych w sekcji Inne kalendarze.

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

// Unsubscribes the user from the calendar.
const result = calendar.unsubscribeFromCalendar();

Rzuty

Error – jeśli jest to Twój 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

Class Calendar Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Metody

Szczegółowa dokumentacja

createAllDayEvent(title, date)

Parametry

Powrót

Autoryzacja

createAllDayEvent(title, startDate, endDate)

Parametry

Powrót

Autoryzacja

createAllDayEvent(title, startDate, endDate, options)

Parametry

Parametry zaawansowane

Powrót

Autoryzacja

createAllDayEvent(title, date, options)

Parametry

Parametry zaawansowane

Powrót

Autoryzacja

createAllDayEventSeries(title, startDate, recurrence)

Parametry

Powrót

Autoryzacja

createAllDayEventSeries(title, startDate, recurrence, options)

Parametry

Parametry zaawansowane

Powrót

Autoryzacja

createEvent(title, startTime, endTime)

Parametry

Powrót

Autoryzacja

createEvent(title, startTime, endTime, options)

Parametry

Parametry zaawansowane

Powrót

Autoryzacja

createEventFromDescription(description)

Parametry

Powrót

Autoryzacja

createEventSeries(title, startTime, endTime, recurrence)

Parametry

Powrót

Autoryzacja

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

Parametry

Parametry zaawansowane

Powrót

Autoryzacja

deleteCalendar()

Rzuty

Autoryzacja

getColor()

Powrót

Autoryzacja

getDescription()

Powrót

Autoryzacja

getEventById(iCalId)

Parametry

Powrót

Autoryzacja

getEventSeriesById(iCalId)

Parametry

Powrót

Autoryzacja

getEvents(startTime, endTime)

Parametry

Powrót

Autoryzacja

getEvents(startTime, endTime, options)

Parametry

Parametry zaawansowane

Powrót

Autoryzacja

getEventsForDay(date)

Parametry

Class Calendar

`createAllDayEvent(title, date)`

`createAllDayEvent(title, startDate, endDate)`

`createAllDayEvent(title, startDate, endDate, options)`

`createAllDayEvent(title, date, options)`

`createAllDayEventSeries(title, startDate, recurrence)`

`createAllDayEventSeries(title, startDate, recurrence, options)`

`createEvent(title, startTime, endTime)`

`createEvent(title, startTime, endTime, options)`

`createEventFromDescription(description)`

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

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

`deleteCalendar()`

`getColor()`

`getDescription()`

`getEventById(iCalId)`

`getEventSeriesById(iCalId)`

`getEvents(startTime, endTime)`

`getEvents(startTime, endTime, options)`

`getEventsForDay(date)`

`getEventsForDay(date, options)`

`getId()`

`getName()`

`getTimeZone()`

`isHidden()`

`isMyPrimaryCalendar()`

`isOwnedByMe()`

`isSelected()`

`setColor(color)`

`setDescription(description)`

`setHidden(hidden)`

`setName(name)`

`setSelected(selected)`

`setTimeZone(timeZone)`

`unsubscribeFromCalendar()`