Zezwala skryptowi na 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 które subskrybuje.
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
Color | Color | Wyliczenie reprezentujące nazwane kolory dostępne w usłudze Kalendarz. |
Event | Event | Wyliczenie reprezentujące nazwane kolory wydarzeń dostępne w usłudze Kalendarz. |
Event | Event | Wyliczenie Event. |
Event | Event | Wyliczenie Event. |
Guest | Guest | Wyliczenie reprezentujące stany, w jakich gość może znajdować się w przypadku wydarzenia. |
Month | Month | Wyliczenie reprezentujące miesiące roku. |
Visibility | Visibility | Wyliczenie reprezentujące widoczność wydarzenia. |
Weekday | Weekday | Wyliczenie reprezentujące dni tygodnia. |
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
create | Calendar | Tworzy nowe wydarzenie całodniowe. |
create | Calendar | Tworzy nowe wydarzenie całodniowe, które może trwać kilka dni. |
create | Calendar | Tworzy nowe wydarzenie całodniowe, które może trwać kilka dni. |
create | Calendar | Tworzy nowe wydarzenie całodniowe. |
create | Calendar | Tworzy nową serię wydarzeń całodniowych. |
create | Calendar | Tworzy nową serię wydarzeń całodniowych. |
create | Calendar | Tworzy nowy kalendarz należący do użytkownika. |
create | Calendar | Tworzy nowy kalendarz należący do użytkownika. |
create | Calendar | Utworzy nowe wydarzenie. |
create | Calendar | Utworzy nowe wydarzenie. |
create | Calendar | Tworzy wydarzenie na podstawie opisu swobodnego. |
create | Calendar | Tworzy nową serię wydarzeń. |
create | Calendar | Tworzy nową serię wydarzeń. |
get | Calendar[] | Pobiera wszystkie kalendarze, które należą do użytkownika lub które subskrybuje. |
get | Calendar[] | Pobiera wszystkie kalendarze należące do użytkownika. |
get | Calendar|null | Pobiera kalendarz o podanym identyfikatorze. |
get | Calendar[] | Pobiera wszystkie kalendarze o podanej nazwie, które należą do użytkownika lub które subskrybuje. |
get | String | Pobiera kolor kalendarza. |
get | Calendar | Pobiera domyślny kalendarz użytkownika. |
get | String | Pobiera opis kalendarza. |
get | Calendar | Pobiera wydarzenie o podanym identyfikatorze. |
get | Calendar | Pobiera serię wydarzeń o podanym identyfikatorze. |
get | Calendar | Pobiera wszystkie zdarzenia, które wystąpiły w danym przedziale czasu. |
get | Calendar | Pobiera wszystkie zdarzenia, które występują w danym przedziale czasu i spełniają określone kryteria. |
get | Calendar | Pobiera wszystkie zdarzenia, które mają miejsce w danym dniu. |
get | Calendar | Pobiera wszystkie wydarzenia, które mają miejsce w danym dniu i spełniają określone kryteria. |
get | String | Pobiera identyfikator kalendarza. |
get | String | Pobiera nazwę kalendarza. |
get | Calendar|null | Pobiera kalendarz o podanym identyfikatorze, jeśli należy on do użytkownika. |
get | Calendar[] | Pobiera wszystkie kalendarze o podanej nazwie, które należą do użytkownika. |
get | String | Pobiera strefę czasową kalendarza. |
is | Boolean | Określa, czy kalendarz jest ukryty w interfejsie. |
is | Boolean | Określa, czy kalendarz jest kalendarzem głównym użytkownika. |
is | Boolean | Określa, czy kalendarz należy do Ciebie. |
is | Boolean | Określa, czy wydarzenia z kalendarza są wyświetlane w interfejsie. |
new | Event | Tworzy nowy obiekt powtarzania, który może być używany do tworzenia reguł powtarzania zdarzeń. |
set | Calendar | Ustawia kolor kalendarza. |
set | Calendar | Ustawia opis kalendarza. |
set | Calendar | Określa, czy kalendarz jest widoczny w interfejsie. |
set | Calendar | Ustawia nazwę kalendarza. |
set | Calendar | Określa, czy wydarzenia z kalendarza są wyświetlane w interfejsie. |
set | Calendar | Ustawia strefę czasową kalendarza. |
subscribe | Calendar | Subskrybuje kalendarz o podanym identyfikatorze, jeśli użytkownik ma uprawnienia do subskrypcji. |
subscribe | Calendar | Subskrybuje kalendarz o podanym identyfikatorze, jeśli użytkownik ma uprawnienia do subskrypcji. |
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 wydarzenia. |
date | Date | Data wydarzenia (używany jest tylko dzień, godzina jest ignorowana). |
Powrót
CalendarEvent – utworzone wydarzenie.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 wydarzenie całodniowe, które może trwać kilka dni.
// Creates an all-day event for the Woodstock festival (August 15th to 17th) and // logs the ID. 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 wydarzenia. |
start | Date | Data rozpoczęcia wydarzenia (używany jest tylko dzień, godzina jest ignorowana). |
end | Date | Data zakończenia wydarzenia (używany jest tylko dzień, godzina jest ignorowana). Data zakończenia nie jest uwzględniana. |
Powrót
CalendarEvent – utworzone wydarzenie.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 wydarzenie całodniowe, które może trwać kilka dni.
// Creates an all-day event for the Woodstock festival (August 15th to 17th) and // logs the ID. 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 wydarzenia. |
start | Date | Data rozpoczęcia wydarzenia (używany jest tylko dzień, godzina jest ignorowana). |
end | Date | Data zakończenia wydarzenia (używany jest tylko dzień, godzina jest ignorowana). Data zakończenia nie jest uwzględniana. |
options | Object | Obiekt JavaScriptu, który określa parametry zaawansowane wymienione poniżej. |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
description | String | Opis wydarzenia. |
location | String | Lokalizacja wydarzenia. |
guests | String | Lista adresów e-mail rozdzielona przecinkami, które należy dodać jako gości. |
send | Boolean | Określa, czy wysyłać e-maile z zaproszeniami (domyślnie: false). |
Powrót
CalendarEvent – utworzone wydarzenie.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 wydarzenia. |
date | Date | Data wydarzenia (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 wydarzenia. |
location | String | Lokalizacja wydarzenia. |
guests | String | Lista adresów e-mail rozdzielona przecinkami, które należy dodać jako gości. |
send | Boolean | Określa, czy wysyłać e-maile z zaproszeniami (domyślnie: false). |
Powrót
CalendarEvent – utworzone wydarzenie.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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, |
start | Date | data pierwszego wydarzenia w serii (używany jest tylko dzień, godzina jest ignorowana); |
recurrence | Event | ustawienia cykliczności serii wydarzeń, |
Powrót
CalendarEventSeries – utworzona seria wydarzeń;
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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, |
start | Date | data pierwszego wydarzenia w serii (używany jest tylko dzień, godzina jest ignorowana); |
recurrence | Event | ustawienia cykliczności serii wydarzeń, |
options | Object | obiekt JavaScriptu, który określa parametry zaawansowane wymienione poniżej; |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
description | String | opis wydarzeń w serii, |
location | String | lokalizację wydarzeń w serii, |
guests | String | lista adresów e-mail rozdzielona przecinkami, które należy dodać jako gości do wydarzeń w serii; |
send | Boolean | czy wysyłać e-maile z zaproszeniami (domyślnie: false); |
Powrót
CalendarEventSeries – utworzona seria wydarzeń;
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 należący do użytkownika.
// 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 należący do użytkownika.
// 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 JavaScriptu, który określa parametry zaawansowane wymienione poniżej; |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
location | String | lokalizację kalendarza, |
description | String | opis kalendarza, |
time | String | strefa czasowa, w której ma być ustawiony kalendarz, podana w formacie „long” (np. „America/New_York”, zgodnie z listą na stronie Joda.org); |
color | String | szesnastkowy ciąg znaków koloru („#rrggbb”) lub wartość z Calendar. |
hidden | Boolean | czy kalendarz jest ukryty w interfejsie (domyślnie:false) |
selected | Boolean | czy wydarzenia z kalendarza są wyświetlane w interfejsie użytkownika (domyślnie: true); |
Powrót
Calendar – nowo utworzony kalendarz.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 wydarzenie.
Jeśli nie określono strefy czasowej, 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 | nazwę wydarzenia, |
start | Date | data i godzina rozpoczęcia wydarzenia; |
end | Date | data i godzina zakończenia wydarzenia; |
Powrót
CalendarEvent – utworzone wydarzenie.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 wydarzenie.
Jeśli nie określono strefy czasowej, 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 | nazwę wydarzenia, |
start | Date | data i godzina rozpoczęcia wydarzenia; |
end | Date | data i godzina zakończenia wydarzenia; |
options | Object | obiekt JavaScriptu, który określa parametry zaawansowane wymienione poniżej; |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
description | String | opis wydarzenia; |
location | String | lokalizację wydarzenia, |
guests | String | lista adresów e-mail rozdzielona przecinkami, które mają zostać dodane jako goście |
send | Boolean | czy wysyłać e-maile z zaproszeniami (domyślnie: false); |
Powrót
CalendarEvent – utworzone wydarzenie.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 wydarzenie na podstawie opisu swobodnego.
Opis powinien mieć taki sam format jak 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 zdarzenia; |
Powrót
CalendarEvent – utworzone wydarzenie.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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ę wydarzeń.
// 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, |
start | Date | datę i godzinę rozpoczęcia pierwszego wydarzenia z serii, |
end | Date | data i godzina zakończenia pierwszego wydarzenia z serii. |
recurrence | Event | ustawienia cykliczności serii wydarzeń, |
Powrót
CalendarEventSeries – utworzona seria wydarzeń;
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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ę wydarzeń.
// 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, |
start | Date | datę i godzinę rozpoczęcia pierwszego wydarzenia z serii, |
end | Date | data i godzina zakończenia pierwszego wydarzenia z serii. |
recurrence | Event | ustawienia cykliczności serii wydarzeń, |
options | Object | obiekt JavaScriptu, który określa parametry zaawansowane wymienione poniżej; |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
description | String | opis wydarzeń w serii, |
location | String | lokalizację wydarzeń w serii, |
guests | String | lista adresów e-mail rozdzielona przecinkami, które należy dodać jako gości do wydarzeń w serii; |
send | Boolean | czy wysyłać e-maile z zaproszeniami (domyślnie: false); |
Powrót
CalendarEventSeries – utworzona seria wydarzeń;
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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, które należą do użytkownika lub które subskrybuje.
// 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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|null – kalendarz o podanym identyfikatorze lub null, jeśli kalendarz nie istnieje, użytkownik nie ma do niego dostępu lub nie subskrybuje go.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 które subskrybuje. 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 | nazwę kalendarza, |
Powrót
Calendar[] – wszystkie kalendarze o tej nazwie, do których użytkownik ma dostęp.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 ciąg znaków koloru („#rrggbb”).
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 kalendarza innego niż domyślny, tę metodę należy wywołać z tego kalendarza. Wywołanie getEventById(iCalId) tylko
zwraca wydarzenie w kalendarzu domyślnym.
Wiele wydarzeń może mieć ten sam identyfikator, jeśli należą do serii wydarzeń. W tym przypadku ta metoda zwraca tylko pierwsze wydarzenie 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 wydarzenia. |
Powrót
CalendarEvent – wydarzenie o podanym identyfikatorze lub null, jeśli wydarzenie nie istnieje lub użytkownik nie ma do niego dostępu.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 CalendarEvent, zwracana jest wartość CalendarEventSeries z pojedynczym wydarzeniem w serii. Pamiętaj, że jeśli seria wydarzeń należy do kalendarza innego niż domyślny, tę metodę należy wywołać z tego CalendarApp. Bezpośrednie wywołanie 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 wydarzeń. |
Powrót
CalendarEventSeries – seria o podanym identyfikatorze lub null, jeśli seria nie istnieje lub użytkownik nie ma do niej dostępu.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 danym przedziale czasu.
Ta metoda zwraca zdarzenia, które rozpoczynają się w podanym zakresie czasowym, kończą się w tym zakresie lub obejmują ten zakres. Jeśli nie podasz strefy czasowej, 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 |
|---|---|---|
start | Date | początek zakresu czasu, |
end | Date | koniec zakresu czasu (wyłącznie); |
Powrót
CalendarEvent[] – zdarzenia, które występują w określonym zakresie czasu.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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ępują w danym przedziale czasu i spełniają określone kryteria.
Ta metoda zwraca zdarzenia, które rozpoczynają się w podanym zakresie czasu, kończą się w tym zakresie lub obejmują ten zakres. Jeśli nie podasz strefy czasowej, 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 author, search lub statusFilters następuje po zastosowaniu start i max. Oznacza to, że liczba zwróconych zdarzeń może być mniejsza niż max, nawet jeśli 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 |
|---|---|---|
start | Date | początek zakresu czasu, |
end | Date | koniec zakresu czasu (wyłącznie); |
options | Object | obiekt JavaScriptu, który określa parametry zaawansowane wymienione poniżej; |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
start | Integer | indeks pierwszego zdarzenia do zwrócenia; |
max | Integer | maksymalna liczba zdarzeń do zwrócenia; |
author | String | adres e-mail używany do filtrowania wyników według twórcy wydarzenia; |
search | String | zapytanie wyszukiwania pełnotekstowego używane do filtrowania wyników; |
status | Guest | tablica stanów używana do filtrowania wyników; |
Powrót
CalendarEvent[] – zdarzenia, które mają miejsce w danym zakresie czasu i spełniają kryteria.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 mają miejsce w danym dniu.
Ta metoda zwraca wydarzenia, które rozpoczynają się w danym dniu, kończą się w danym dniu lub obejmują ten 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 w danym dniu do północy następnego dnia w strefie 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, dla której mają zostać pobrane zdarzenia (używany jest tylko dzień, godzina jest ignorowana); |
Powrót
CalendarEvent[] – zdarzenia, które mają miejsce w danym dniu.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 wydarzenia, które mają miejsce w danym dniu i spełniają określone kryteria.
Ta metoda zwraca wydarzenia, które rozpoczynają się w danym dniu, kończą się w danym dniu lub obejmują ten 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 w danym dniu do północy następnego dnia w strefie czasowej kalendarza.
Pamiętaj, że filtrowanie według author, search lub statusFilters następuje po zastosowaniu start i max. Oznacza to, że liczba zwróconych zdarzeń może być mniejsza niż max, nawet jeśli 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, dla której mają zostać pobrane zdarzenia (używany jest tylko dzień, godzina jest ignorowana); |
options | Object | zaawansowane opcje filtrowania, |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
start | Integer | indeks pierwszego zdarzenia do zwrócenia; |
max | Integer | maksymalna liczba zdarzeń do zwrócenia; |
author | String | adres e-mail używany do filtrowania wyników według twórcy wydarzenia; |
search | String | zapytanie wyszukiwania pełnotekstowego używane do filtrowania wyników; |
status | Guest | tablica stanów używana do filtrowania wyników; |
Powrót
CalendarEvent[] – zdarzenia, które wystąpiły w danym dniu i spełniają kryteria.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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. Identyfikator domyślnego kalendarza użytkownika to 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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, kliknij strzałkę obok nazwy kalendarza w Kalendarzu Google 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|null – kalendarz o podanym identyfikatorze lub null, jeśli kalendarz nie istnieje lub użytkownik nie jest jego właścicielem.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 kalendarze o podanej nazwie, które należą do użytkownika. 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 | nazwę kalendarza, |
Powrót
Calendar[] – wszystkie kalendarze o tej nazwie, których użytkownik jest właścicielem;
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 podana w formacie „long” (np. „America/New_York”, zgodnie z listą na stronie Joda.org).
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 jest.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 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 kalendarz jest domyślnym kalendarzem użytkownika; false, jeśli nie jest.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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, jeśli nie.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 powtarzania, który może być używany 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
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 | Calendar lub szesnastkowy ciąg znaków koloru („#rrggbb”). |
Powrót
Calendar – ten kalendarz do łączenia.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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)
Ustawia opis kalendarza.
// Gets the user's default calendar. To get a different calendar, // use getCalendarById() instead. const calendar = CalendarApp.getDefaultCalendar(); // Sets the description of the calendar. // TODO(developer): Update the string with the description that you want to use. calendar.setDescription('Updated calendar description.');
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
description | String | opis tego kalendarza, |
Powrót
Calendar – ten kalendarz do łączenia w łańcuch
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 – ukrywanie kalendarza w interfejsie; false – wyświetlanie kalendarza. |
Powrót
Calendar – ten kalendarz do łączenia w łańcuch
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 łączenia w łańcuch
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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świetlić wydarzenia z kalendarza w interfejsie; false
– aby je ukryć. |
Powrót
Calendar – ten kalendarz do łączenia w łańcuch
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 |
|---|---|---|
time | String | Strefa czasowa podana w formacie „long” (np. „America/New_York”, zgodnie z Joda.org). |
Powrót
Calendar – ten kalendarz do łączenia.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 uprawnienia do subskrypcji.
// 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 – nowo zasubskrybowany kalendarz.
Rzuty
Error – jeśli nie istnieje kalendarz o tym identyfikatorze.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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 uprawnienia do subskrypcji.
// 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, który chcesz zasubskrybować. |
options | Object | Obiekt JavaScriptu, który określa parametry zaawansowane wymienione poniżej. |
Parametry zaawansowane
| Nazwa | Typ | Opis |
|---|---|---|
color | String | Szesnastkowy ciąg znaków koloru („#rrggbb”) lub wartość z Calendar. |
hidden | Boolean | Określa, czy kalendarz jest ukryty w interfejsie (domyślnie:false). |
selected | Boolean | Określa, czy wydarzenia z kalendarza są wyświetlane w interfejsie użytkownika (domyślnie: true, jeśli określono też color, w przeciwnym razie false). |
Powrót
Calendar – nowo zasubskrybowany kalendarz.
Rzuty
Error – jeśli nie istnieje kalendarz o tym identyfikatorze.
Autoryzacja
Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego 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