Class CalendarApp

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

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

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

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

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

Parametry zaawansowane

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

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

Parametry zaawansowane

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

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

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

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

Parametry zaawansowane

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

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

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

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

Parametry zaawansowane

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

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

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

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

Parametry zaawansowane

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

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

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

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

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

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

Parametry zaawansowane

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

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

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

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

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

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

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

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

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

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

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

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

Pobiera serię wydarzeń o podanym identyfikatorze. Jeśli podany identyfikator dotyczy pojedynczego zdarzenia CalendarEvent, zwracane jest zdarzenie CalendarEventSeries z jednego zdarzenia w 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

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

Pobiera wszystkie zdarzenia, które występują w określonym zakresie czasowym.

Ta metoda zwraca zdarzenia, które rozpoczynają się w danym zakresie czasowym, kończą się w danym zakresie czasowym lub obejmują cały zakres czasowy. Jeśli nie zostanie określona strefa czasowa, wartości czasu są 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

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

Pobiera wszystkie zdarzenia, które występują w danym zakresie 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 są 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

Parametry zaawansowane

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

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

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

Pobiera wszystkie zdarzenia, które wystąpiły w danym dniu i spełniają określone kryteria.

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.

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

Parametry zaawansowane

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Określa, czy kalendarz jest widoczny w interfejsie.

Parametry

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

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

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

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

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

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

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

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

Powrót

Calendar – nowo dodany 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

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

Parametry zaawansowane

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