Reprezentuje kalendarz, którego użytkownik jest właścicielem lub który subskrybuje.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createAllDayEvent(title, date) | CalendarEvent | Tworzy nowe wydarzenie całodniowe. |
createAllDayEvent(title, startDate, endDate) | CalendarEvent | Tworzy nowe wydarzenie całodniowe, które może trwać kilka dni. |
createAllDayEvent(title, startDate, endDate, options) | CalendarEvent | Tworzy nowe wydarzenie całodniowe, które może trwać kilka dni. |
createAllDayEvent(title, date, options) | CalendarEvent | Tworzy nowe wydarzenie całodniowe. |
createAllDayEventSeries(title, startDate, recurrence) | CalendarEventSeries | Tworzy nową serię wydarzeń całodniowych. |
createAllDayEventSeries(title, startDate, recurrence, options) | CalendarEventSeries | Tworzy nową serię wydarzeń całodniowych. |
createEvent(title, startTime, endTime) | CalendarEvent | Tworzy nowe wydarzenie. |
createEvent(title, startTime, endTime, options) | CalendarEvent | Tworzy nowe wydarzenie. |
createEventFromDescription(description) | CalendarEvent | Tworzy wydarzenie na podstawie dowolnego opisu. |
createEventSeries(title, startTime, endTime, recurrence) | CalendarEventSeries | Tworzy nową serię wydarzeń. |
createEventSeries(title, startTime, endTime, recurrence, options) | CalendarEventSeries | Tworzy nową serię wydarzeń. |
deleteCalendar() | void | Trwale usuwa kalendarz. |
getColor() | String | Pobiera kolor kalendarza. |
getDescription() | String | Pobiera opis kalendarza. |
getEventById(iCalId) | CalendarEvent | Pobiera zdarzenie o podanym identyfikatorze. |
getEventSeriesById(iCalId) | CalendarEventSeries | Pobiera serię zdarzeń o podanym identyfikatorze. |
getEvents(startTime, endTime) | CalendarEvent[] | Pobiera wszystkie zdarzenia, które wystąpiły w danym przedziale czasu. |
getEvents(startTime, endTime, options) | CalendarEvent[] | Pobiera wszystkie zdarzenia w danym przedziale czasu i spełniające określone kryteria. |
getEventsForDay(date) | CalendarEvent[] | Pobiera wszystkie zdarzenia mające miejsce w danym dniu. |
getEventsForDay(date, options) | CalendarEvent[] | Pobiera wszystkie zdarzenia, które wystąpiły w danym dniu i spełniają określone kryteria. |
getId() | String | Pobiera identyfikator kalendarza. |
getName() | String | Pobiera nazwę kalendarza. |
getTimeZone() | String | Pobiera strefę czasową kalendarza. |
isHidden() | Boolean | Określa, czy kalendarz jest ukryty w interfejsie. |
isMyPrimaryCalendar() | Boolean | Określa, czy kalendarz jest kalendarzem głównym rzeczywistego 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 użytkownika. |
setColor(color) | Calendar | Ustawia kolor kalendarza. |
setDescription(description) | Calendar | Ustawia 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 użytkownika. |
setTimeZone(timeZone) | Calendar | Ustawia strefę czasową kalendarza. |
unsubscribeFromCalendar() | void | Anuluje subskrypcję kalendarza dla użytkownika. |
Szczegółowa dokumentacja
createAllDayEvent(title, date)
Tworzy nowe wydarzenie całodniowe.
// Creates an all-day event for the moon landing and logs the ID. var event = CalendarApp.getDefaultCalendar().createAllDayEvent('Apollo 11 Landing', new Date('July 20, 1969')); Logger.log('Event ID: ' + event.getId());
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Tytuł wydarzenia. |
date | Date | Data zdarzenia (stosowany jest tylko dzień; godzina jest ignorowana). |
Powroty
CalendarEvent
– utworzone wydarzenie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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. var 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 | Tytuł wydarzenia. |
startDate | Date | Data rozpoczęcia wydarzenia (stosowany jest tylko dzień; godzina jest ignorowana). |
endDate | Date | Data zakończenia wydarzenia (stosowany jest tylko dzień; godzina jest ignorowana). Data zakończenia nie jest dostępna. |
Powroty
CalendarEvent
– utworzone wydarzenie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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. var 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 | Tytuł wydarzenia. |
startDate | Date | Data rozpoczęcia wydarzenia (stosowany jest tylko dzień; godzina jest ignorowana). |
endDate | Date | Data zakończenia wydarzenia (stosowany jest tylko dzień; godzina jest ignorowana). Data zakończenia nie jest dostępna. |
options | Object | Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
description | String | Opis zdarzenia. |
location | String | Lokalizacja wydarzenia. |
guests | String | Rozdzielona przecinkami lista adresów e-mail, które należy dodać jako gości. |
sendInvites | Boolean | Określa, czy wysyłać e-maile z zaproszeniami (domyślnie: false ). |
Powroty
CalendarEvent
– utworzone wydarzenie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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. var 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 | Tytuł wydarzenia. |
date | Date | Data zdarzenia (stosowany jest tylko dzień; godzina jest ignorowana). |
options | Object | Obiekt JavaScript określający parametry zaawansowane, jak opisano poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
description | String | Opis zdarzenia. |
location | String | Lokalizacja wydarzenia. |
guests | String | Rozdzielona przecinkami lista adresów e-mail, które należy dodać jako gości. |
sendInvites | Boolean | Określa, czy wysyłać e-maile z zaproszeniami (domyślnie: false ). |
Powroty
CalendarEvent
– utworzone wydarzenie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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. var 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 (stosowany jest tylko dzień; godzina jest ignorowana) |
recurrence | EventRecurrence | ustawienia powtarzania serii zdarzeń. |
Powroty
CalendarEventSeries
– utworzona seria wydarzeń
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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. var 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 (stosowany jest tylko dzień; godzina jest ignorowana) |
recurrence | EventRecurrence | ustawienia powtarzania serii zdarzeń. |
options | Object | obiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
description | String | opis wydarzeń z serii, |
location | String | miejsce wydarzeń w serii, |
guests | String | rozdzielaną przecinkami listę adresów e-mail, które należy dodać jako gości wydarzeń w serii |
sendInvites | Boolean | czy wysyłać e-maile z zaproszeniami (domyślnie: false ). |
Powroty
CalendarEventSeries
– utworzona seria wydarzeń
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createEvent(title, startTime, endTime)
Tworzy nowe wydarzenie.
Jeśli nie określisz strefy czasowej, wartości będą interpretowane w kontekście strefy czasowej skryptu, która może się różnić od strefy czasowej kalendarza.
// Creates an event for the moon landing and logs the ID. var 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 | nazwa wydarzenia |
startTime | Date | data i godzina rozpoczęcia wydarzenia; |
endTime | Date | data i godzina zakończenia wydarzenia; |
Powroty
CalendarEvent
– utworzone wydarzenie,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createEvent(title, startTime, endTime, options)
Tworzy nowe wydarzenie.
Jeśli nie określisz strefy czasowej, wartości będą interpretowane w kontekście strefy czasowej skryptu, która może się różnić od strefy czasowej kalendarza.
// Creates an event for the moon landing and logs the ID. var 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 | nazwa wydarzenia |
startTime | Date | data i godzina rozpoczęcia wydarzenia; |
endTime | Date | data i godzina zakończenia wydarzenia; |
options | Object | obiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
description | String | opis wydarzenia; |
location | String | lokalizacja wydarzenia |
guests | String | rozdzielaną przecinkami listę adresów e-mail, które należy dodać jako gości |
sendInvites | Boolean | czy wysyłać e-maile z zaproszeniami (domyślnie: false ). |
Powroty
CalendarEvent
– utworzone wydarzenie,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createEventFromDescription(description)
Tworzy wydarzenie na podstawie dowolnego opisu.
Opis powinien mieć ten sam format co w przypadku funkcji „Szybkie dodawanie” w interfejsie.
// Creates a new event and logs its ID. var 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; |
Powroty
CalendarEvent
– utworzone wydarzenie,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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. var 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 wydarzenia w serii |
recurrence | EventRecurrence | ustawienia powtarzania serii zdarzeń. |
Powroty
CalendarEventSeries
– utworzona seria wydarzeń
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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. var 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 wydarzenia w serii |
recurrence | EventRecurrence | ustawienia powtarzania serii zdarzeń. |
options | Object | obiekt JavaScript, który określa parametry zaawansowane, jak opisano poniżej |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
description | String | opis wydarzeń z serii, |
location | String | miejsce wydarzeń w serii, |
guests | String | rozdzielaną przecinkami listę adresów e-mail, które należy dodać jako gości wydarzeń w serii |
sendInvites | Boolean | czy wysyłać e-maile z zaproszeniami (domyślnie: false ). |
Powroty
CalendarEventSeries
– utworzona seria wydarzeń
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
deleteCalendar()
Trwale usuwa kalendarz. Użytkownik może usunąć tylko swój kalendarz.
// Creates a calendar to delete. const calendar = CalendarApp.createCalendar('Test'); // Deletes the 'Test' calendar permanently. calendar.deleteCalendar();
Rzuty
Error
– jeśli jest to zaimportowany kalendarz.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
getColor()
Pobiera kolor kalendarza.
// Opens the calendar by its ID. // TODO(developer): Replace the ID with your own. const calendar = CalendarApp.getCalendarById('222larabrown@gmail.com'); // Gets the color of the calendar and logs it to the console. // For the default calendar, you can use CalendarApp.getColor() instead. const calendarColor = calendar.getColor(); console.log(calendarColor);
Powroty
String
– szesnastkowy ciąg koloru („#rrggbb”).
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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);
Powroty
String
– opis kalendarza.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEventById(iCalId)
Pobiera zdarzenie o podanym identyfikatorze. Jeśli seria należy do kalendarza innego niż domyślny, należy wywołać tę metodę z tego kalendarza. Wywołanie CalendarApp.getEventById(iCalId)
powoduje zwrócenie wydarzenia tylko w domyślnym kalendarzu.
Wiele wydarzeń może mieć ten sam identyfikator, jeśli należą do serii wydarzeń. W tym przypadku metoda zwraca tylko pierwsze zdarzenie z tego ciągu.
// 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. |
Powroty
CalendarEvent
– zdarzenie o podanym identyfikatorze lub null
, jeśli zdarzenie nie istnieje lub użytkownik nie ma do niego dostępu.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEventSeriesById(iCalId)
Pobiera serię zdarzeń o podanym identyfikatorze. Jeśli podany identyfikator dotyczy pojedynczego zdarzenia CalendarEvent
, zwracana jest wartość CalendarEventSeries
z jednym zdarzeniem w serii. Pamiętaj, że jeśli seria wydarzeń należy do kalendarza innego niż kalendarz domyślny, tę metodę należy wywołać z poziomu tego kalendarza Calendar
. Wywołanie CalendarApp.getEventSeriesById(iCalId)
zwraca tylko serię wydarzeń 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ń. |
Powroty
CalendarEventSeries
– seria o podanym identyfikatorze lub null
, jeśli seria nie istnieje lub użytkownik nie ma do niej dostępu.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 rozpoczęły się w danym przedziale czasu, zakończyły się w nim lub obejmują ten okres. Jeśli nie określisz strefy czasowej, wartości czasowe są interpretowane w kontekście strefy czasowej skryptu, która może się różnić od strefy czasowej kalendarza.
// Determines how many events are happening in the next two hours. var now = new Date(); var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000)); var 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, niezawierający |
Powroty
CalendarEvent[]
– zdarzenia, które wystąpiły w wybranym okresie;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 w danym przedziale czasu i spełniające określone kryteria.
Ta metoda zwraca zdarzenia, które rozpoczęły się w danym okresie, zakończyły się w nim lub obejmuje ten okres. Jeśli nie określisz strefy czasowej, wartości czasowe są interpretowane w kontekście strefy czasowej skryptu, która może się różnić od strefy czasowej kalendarza.
Pamiętaj, że filtrowanie według author
, search
lub statusFilters
działa po zastosowaniu start
i max
. Oznacza to, że liczba zwróconych 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". var now = new Date(); var twoHoursFromNow = new Date(now.getTime() + (2 * 60 * 60 * 1000)); var 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, niezawierający |
options | Object | obiekt JavaScript, który określa parametry zaawansowane, jak opisano 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 | pełnotekstowe zapytanie używane do filtrowania wyników |
statusFilters[] | GuestStatus | tablica stanów służących do filtrowania wyników |
Powroty
CalendarEvent[]
– zdarzenia mające miejsce w wybranym przedziale czasu i spełniające kryteria;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getEventsForDay(date)
Pobiera wszystkie zdarzenia mające miejsce w danym dniu.
Ta metoda zwraca zdarzenia, jeśli rozpoczynają się w danym dniu, kończą w ciągu dnia lub obejmują dzień.
Stosowana jest tylko część dotycząca daty obiektu Date, a część czasu jest ignorowana. Data jest interpretowana jako okres od północy tego dnia do północy następnego dnia w strefie czasowej kalendarza.
// Determines how many events are happening today. var today = new Date(); var events = CalendarApp.getDefaultCalendar().getEventsForDay(today); Logger.log('Number of events: ' + events.length);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | data, z której chcesz pobrać zdarzenia (użyty jest tylko dzień; czas nie jest brany pod uwagę) |
Powroty
CalendarEvent[]
– wydarzenia, które mają miejsce w danym dniu;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 rozpoczynają się w danym dniu, kończą w ciągu dnia lub obejmują dzień.
Stosowana jest tylko część dotycząca daty obiektu Date, a część czasu jest ignorowana. Data jest interpretowana jako okres od północy tego dnia do północy następnego dnia w strefie czasowej kalendarza.
Pamiętaj, że filtrowanie według author
, search
lub statusFilters
działa po zastosowaniu start
i max
. Oznacza to, że liczba zwróconych 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". var today = new Date(); var events = CalendarApp.getDefaultCalendar().getEventsForDay(today, {search: 'meeting'}); Logger.log('Number of events: ' + events.length);
Parametry
Nazwa | Typ | Opis |
---|---|---|
date | Date | data, z której chcesz pobrać zdarzenia (użyty jest tylko dzień; czas nie jest brany pod uwagę) |
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 | pełnotekstowe zapytanie używane do filtrowania wyników |
statusFilters[] | GuestStatus | tablica stanów służących do filtrowania wyników |
Powroty
CalendarEvent[]
– wydarzenia w danym dniu, które spełniają kryteria.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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);
Powroty
String
– identyfikator kalendarza.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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);
Powroty
String
– nazwa kalendarza.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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);
Powroty
String
– strefa czasowa podana w formacie „long” (np. „Ameryka/Nowy_Jork” według nazwy Joda.org).
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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);
Powroty
Boolean
– true
, jeśli kalendarz jest ukryty w interfejsie; false
, jeśli nie jest.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 rzeczywistego 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);
Powroty
Boolean
– true
, jeśli kalendarz jest domyślnym kalendarzem użytkownika; w przeciwnym razie false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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());
Powroty
Boolean
– true
, jeśli kalendarz należy do Ciebie; jeśli nie jest to false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 użytkownika.
// 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());
Powroty
Boolean
– true
, jeśli wydarzenia z kalendarza są wyświetlane w interfejsie; jeśli nie są wyświetlane: false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 ciąg koloru („#rrggbb”). |
Powroty
Calendar
– kalendarz do tworzenia łańcuszków.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 |
Powroty
Calendar
– ten kalendarz do tworzenia łańcuszków
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 użytkownika; false , aby go wyświetlić |
Powroty
Calendar
– ten kalendarz do tworzenia łańcuszków
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 |
Powroty
Calendar
– ten kalendarz do tworzenia łańcuszków
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 użytkownika.
// 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 pokazać wydarzenia z kalendarza w interfejsie, false ,
aby je ukryć |
Powroty
Calendar
– ten kalendarz do tworzenia łańcuszków
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
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 formacie „long” (np. „Ameryka/Nowy_Jork” podana przez Joda.org). |
Powroty
Calendar
– kalendarz do tworzenia łańcuszków.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
unsubscribeFromCalendar()
Anuluje subskrypcję kalendarza dla użytkownika. Użytkownik nie może anulować subskrypcji kalendarzy na liście Moje kalendarze. Mogą oni anulować subskrypcję kalendarzy wymienionych w sekcji Inne kalendarze.
// Gets the calendar by its ID. // TODO(developer): Replace the calendar ID with the calendar ID that you want to get. const calendar = CalendarApp.getCalendarById('abc123456@group.calendar.google.com'); // Unsubscribes the user from the calendar. const result = calendar.unsubscribeFromCalendar();
Rzuty
Error
– jeśli kalendarz należy do Ciebie
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds