Class Calendar

Kalendarz

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

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.
createEvent(title, startTime, endTime)CalendarEventUtworzy nowe zdarzenie.
createEvent(title, startTime, endTime, options)CalendarEventUtworzy 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ń,
deleteCalendar()voidTrwale usuwa kalendarz.
getColor()StringPobiera kolor kalendarza.
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ą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()StringPobiera identyfikator kalendarza.
getName()StringPobiera nazwę kalendarza.
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.
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.
unsubscribeFromCalendar()voidanulowanie 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

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

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

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

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

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

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

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

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