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ść | Typ | Opis |
---|---|---|
Color | Color | Wyliczenie reprezentujące nazwane kolory dostępne w usłudze Kalendarz. |
EventColor | EventColor | Wyliczenie reprezentujące nazwane kolory wydarzeń dostępne w usłudze Kalendarz. |
GuestStatus | GuestStatus | Wyliczenie reprezentujące stany, jakie może mieć gość na wydarzeniu. |
Month | Month | Typ enum reprezentujący miesiące w roku. |
Visibility | Visibility | Typ enum reprezentujący widoczność zdarzenia. |
Weekday | Weekday | Typ enum reprezentujący dni tygodnia. |
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. |
createCalendar(name) | Calendar | Tworzy nowy kalendarz, którego właścicielem jest użytkownik. |
createCalendar(name, options) | Calendar | Tworzy nowy kalendarz, którego właścicielem jest użytkownik. |
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ń, |
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) | Calendar | Pobiera 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() | String | Pobiera kolor kalendarza. |
getDefaultCalendar() | Calendar | Pobiera domyślny kalendarz użytkownika. |
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ąpiły 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. |
getOwnedCalendarById(id) | Calendar | Pobiera 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() | 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. |
newRecurrence() | EventRecurrence | Tworzy nowy obiekt powtarzalności, który można wykorzystać do tworzenia reguł powtarzania zdarzeń. |
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. |
subscribeToCalendar(id) | Calendar | Subskrybuje kalendarz o podanym identyfikatorze, jeśli użytkownik ma do niego dostęp. |
subscribeToCalendar(id, options) | Calendar | Subskrybuje 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
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 zaproszeniami (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 zaproszeniami (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 (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
Nazwa | Typ | Opis |
---|---|---|
name | String | nazwę 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
Nazwa | Typ | Opis |
---|---|---|
name | String | nazwę nowego kalendarza. |
options | Object | obiekt JavaScript, który określa parametry zaawansowane, wymienione poniżej; |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
location | String | lokalizacja kalendarza, |
description | String | opis kalendarza; |
timeZone | String | strefę czasową, którą chcesz ustawić w kalendarzu, w formacie „długim” (np. „America/New_York” (wg Joda.org). |
color | String | szesnastkowy kod koloru („#rrggbb”) lub wartość z CalendarApp.Colors |
hidden | Boolean | czy kalendarz jest ukryty w interfejsie (domyślnie:false ). |
selected | Boolean | czy 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)
Utworzy 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)
Utworzy 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, który określa 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 (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
Nazwa | Typ | Opis |
---|---|---|
id | String | identyfikator 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
Nazwa | Typ | Opis |
---|---|---|
name | String | nazwa 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
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 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
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ąpiły 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ąpiły w danym dniu.
Ta metoda zwraca wydarzenia, 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ń.
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
Nazwa | Typ | Opis |
---|---|---|
date | Date | data, z której mają być pobierane zdarzenia (używamy tylko dnia, 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
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
Nazwa | Typ | Opis |
---|---|---|
id | String | identyfikator 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
Nazwa | Typ | Opis |
---|---|---|
name | String | nazwa 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
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
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
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
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
Nazwa | Typ | Opis |
---|---|---|
id | String | identyfikator kalendarza, który chcesz zasubskrybować; |
Powrót
Calendar
– kalendarz, który został właśnie subskrybowany.
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
Nazwa | Typ | Opis |
---|---|---|
id | String | Identyfikator kalendarza, do którego chcesz się zasubskrybować. |
options | Object | Obiekt JavaScriptu, który określa parametry zaawansowane, wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
color | String | Szesnastkowy kod koloru („#rrggbb”) lub wartość z CalendarApp.Colors . |
hidden | Boolean | Określa, czy kalendarz jest ukryty w interfejsie (domyślnie: false ). |
selected | Boolean | Okreś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