Class CalendarApp

TakvimUygulaması

Bir komut dosyasının, kullanıcının Google Takvim'ini okumasına ve güncellemesine izin verir. Bu sınıf, kullanıcının varsayılan takvimine doğrudan erişim sağlamanın yanı sıra kullanıcının sahip olduğu veya abone olduğu ek takvimleri alabilme olanağı sunar.

Özellikler

MülkTürAçıklama
ColorColorTakvim hizmetinde kullanılabilen adlandırılmış renkleri temsil eden bir enum.
EventColorEventColorTakvim hizmetinde kullanılabilen adlandırılmış etkinlik renklerini temsil eden bir enum.
EventTransparencyEventTransparencyEventTransparency numaralandırması.
EventTypeEventTypeEventType numaralandırması.
GuestStatusGuestStatusBir davetlinin bir etkinlikteki durumlarını temsil eden bir enum.
MonthMonthYılın aylarını temsil eden bir enum.
VisibilityVisibilityBir etkinliğin görünürlüğünü temsil eden enum.
WeekdayWeekdayHaftanın günlerini temsil eden bir enum.

Yöntemler

YöntemDönüş türüKısa açıklama
createAllDayEvent(title, date)CalendarEventYeni bir tüm gün süren etkinlik oluşturur.
createAllDayEvent(title, startDate, endDate)CalendarEventBirden fazla gün sürebilen yeni bir tüm gün süren etkinlik oluşturur.
createAllDayEvent(title, startDate, endDate, options)CalendarEventBirden fazla gün sürebilen yeni bir tüm gün süren etkinlik oluşturur.
createAllDayEvent(title, date, options)CalendarEventYeni bir tüm gün süren etkinlik oluşturur.
createAllDayEventSeries(title, startDate, recurrence)CalendarEventSeriesYeni bir tüm gün süren etkinlik serisi oluşturur.
createAllDayEventSeries(title, startDate, recurrence, options)CalendarEventSeriesYeni bir tüm gün süren etkinlik serisi oluşturur.
createCalendar(name)CalendarKullanıcıya ait yeni bir takvim oluşturur.
createCalendar(name, options)CalendarKullanıcıya ait yeni bir takvim oluşturur.
createEvent(title, startTime, endTime)CalendarEventYeni bir etkinlik oluşturur.
createEvent(title, startTime, endTime, options)CalendarEventYeni bir etkinlik oluşturur.
createEventFromDescription(description)CalendarEventSerbest biçimli bir açıklamadan etkinlik oluşturur.
createEventSeries(title, startTime, endTime, recurrence)CalendarEventSeriesYeni bir etkinlik serisi oluşturur.
createEventSeries(title, startTime, endTime, recurrence, options)CalendarEventSeriesYeni bir etkinlik serisi oluşturur.
getAllCalendars()Calendar[]Kullanıcının sahip olduğu veya abone olduğu tüm takvimleri alır.
getAllOwnedCalendars()Calendar[]Kullanıcının sahip olduğu tüm takvimleri alır.
getCalendarById(id)Calendar|nullBelirtilen kimliğe sahip takvimi alır.
getCalendarsByName(name)Calendar[]Kullanıcının sahip olduğu veya abone olduğu, belirli bir ada sahip tüm takvimleri alır.
getColor()StringTakvimin rengini alır.
getDefaultCalendar()CalendarKullanıcının varsayılan takvimini alır.
getDescription()StringTakvimin açıklamasını alır.
getEventById(iCalId)CalendarEventBelirtilen kimliğe sahip etkinliği alır.
getEventSeriesById(iCalId)CalendarEventSeriesBelirtilen kimliğe sahip etkinlik serisini alır.
getEvents(startTime, endTime)CalendarEvent[]Belirli bir zaman aralığında gerçekleşen tüm etkinlikleri alır.
getEvents(startTime, endTime, options)CalendarEvent[]Belirli bir zaman aralığında gerçekleşen ve belirtilen ölçütleri karşılayan tüm etkinlikleri alır.
getEventsForDay(date)CalendarEvent[]Belirli bir günde gerçekleşen tüm etkinlikleri alır.
getEventsForDay(date, options)CalendarEvent[]Belirli bir günde gerçekleşen ve belirtilen ölçütleri karşılayan tüm etkinlikleri alır.
getId()StringTakvimin kimliğini alır.
getName()StringTakvimin adını alır.
getOwnedCalendarById(id)Calendar|nullKullanıcıya aitse belirtilen kimliğe sahip takvimi alır.
getOwnedCalendarsByName(name)Calendar[]Kullanıcının sahip olduğu, belirli bir ada sahip tüm takvimleri alır.
getTimeZone()StringTakvimin saat dilimini alır.
isHidden()BooleanTakvimin kullanıcı arayüzünde gizlenip gizlenmeyeceğini belirler.
isMyPrimaryCalendar()BooleanTakvimin, etkili kullanıcının birincil takvimi olup olmadığını belirler.
isOwnedByMe()BooleanTakvimin size ait olup olmadığını belirler.
isSelected()BooleanTakvim etkinliklerinin kullanıcı arayüzünde gösterilip gösterilmeyeceğini belirler.
newRecurrence()EventRecurrenceEtkinlik tekrarı için kurallar oluşturmak üzere kullanılabilecek yeni bir tekrar nesnesi oluşturur.
setColor(color)CalendarTakvimin rengini ayarlar.
setDescription(description)CalendarTakvimin açıklamasını ayarlar.
setHidden(hidden)CalendarTakvimin kullanıcı arayüzünde görünür olup olmayacağını ayarlar.
setName(name)CalendarTakvimin adını ayarlar.
setSelected(selected)CalendarTakvim etkinliklerinin kullanıcı arayüzünde gösterilip gösterilmeyeceğini ayarlar.
setTimeZone(timeZone)CalendarTakvimin saat dilimini ayarlar.
subscribeToCalendar(id)CalendarKullanıcının abone olmasına izin veriliyorsa kullanıcıyı, belirtilen kimliğe sahip takvime abone eder.
subscribeToCalendar(id, options)CalendarKullanıcının abone olmasına izin veriliyorsa kullanıcıyı, belirtilen kimliğe sahip takvime abone eder.

Ayrıntılı belgeler

createAllDayEvent(title, date)

Yeni bir tüm gün süren etkinlik oluşturur.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringEtkinliğin başlığı.
dateDateEtkinliğin tarihi (yalnızca gün kullanılır, saat dikkate alınmaz).

Return

CalendarEvent: Oluşturulan etkinlik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createAllDayEvent(title, startDate, endDate)

Birden fazla gün sürebilen yeni bir tüm gün süren etkinlik oluşturur.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringEtkinliğin başlığı.
startDateDateEtkinliğin başladığı tarih (yalnızca gün kullanılır, saat dikkate alınmaz).
endDateDateEtkinliğin sona erdiği tarih (yalnızca gün kullanılır, saat dikkate alınmaz). Bitiş tarihi dahil değildir.

Return

CalendarEvent: Oluşturulan etkinlik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createAllDayEvent(title, startDate, endDate, options)

Birden fazla gün sürebilen yeni bir tüm gün süren etkinlik oluşturur.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringEtkinliğin başlığı.
startDateDateEtkinliğin başladığı tarih (yalnızca gün kullanılır, saat dikkate alınmaz).
endDateDateEtkinliğin sona erdiği tarih (yalnızca gün kullanılır, saat dikkate alınmaz). Bitiş tarihi hariçtir.
optionsObjectAşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
descriptionStringEtkinliğin açıklaması.
locationStringEtkinlik konumu.
guestsStringKonuk olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi.
sendInvitesBooleanDavetiye e-postalarının gönderilip gönderilmeyeceği (varsayılan: false).

Return

CalendarEvent: Oluşturulan etkinlik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createAllDayEvent(title, date, options)

Yeni bir tüm gün süren etkinlik oluşturur.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringEtkinliğin başlığı.
dateDateEtkinliğin tarihi (yalnızca gün kullanılır, saat dikkate alınmaz).
optionsObjectAşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
descriptionStringEtkinliğin açıklaması.
locationStringEtkinlik konumu.
guestsStringKonuk olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi.
sendInvitesBooleanDavetiye e-postalarının gönderilip gönderilmeyeceği (varsayılan: false).

Return

CalendarEvent: Oluşturulan etkinlik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createAllDayEventSeries(title, startDate, recurrence)

Yeni bir tüm gün süren etkinlik serisi oluşturur.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringSerideki etkinliklerin başlığı
startDateDateSerideki ilk etkinliğin tarihi (yalnızca gün kullanılır, saat dikkate alınmaz)
recurrenceEventRecurrenceEtkinlik serisinin tekrarlama ayarları

Return

CalendarEventSeries: Oluşturulan etkinlik serisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createAllDayEventSeries(title, startDate, recurrence, options)

Yeni bir tüm gün süren etkinlik serisi oluşturur.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringSerideki etkinliklerin başlığı
startDateDateSerideki ilk etkinliğin tarihi (yalnızca gün kullanılır, saat dikkate alınmaz)
recurrenceEventRecurrenceEtkinlik serisinin tekrarlama ayarları
optionsObjectAşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
descriptionStringSerideki etkinliklerin açıklaması
locationStringSerideki etkinliklerin konumu
guestsStringSerideki etkinliklere davetli olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi
sendInvitesBooleanDavetiye e-postaları gönderilip gönderilmeyeceği (varsayılan: false)

Return

CalendarEventSeries: Oluşturulan etkinlik serisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createCalendar(name)

Kullanıcıya ait yeni bir takvim oluşturur.

// 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(),
);

Parametreler

AdTürAçıklama
nameStringYeni takvimin adı

Return

Calendar: Yeni oluşturulan takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createCalendar(name, options)

Kullanıcıya ait yeni bir takvim oluşturur.

// 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(),
);

Parametreler

AdTürAçıklama
nameStringYeni takvimin adı
optionsObjectAşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
locationStringTakvimin konumu
descriptionStringTakvimin açıklaması
timeZoneStringTakvimin ayarlanacağı saat dilimi, "long" biçiminde belirtilir (ör. "America/New_York" (Joda.org tarafından listelendiği şekliyle)
colorStringonaltılık renk dizesi ("#rrggbb") veya CalendarApp.Colors değerlerinden biri
hiddenBooleanTakvimin kullanıcı arayüzünde gizlenip gizlenmediği (varsayılan: false)
selectedBooleanTakvim etkinliklerinin kullanıcı arayüzünde gösterilip gösterilmeyeceği (varsayılan: true)

Return

Calendar: Yeni oluşturulan takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEvent(title, startTime, endTime)

Yeni bir etkinlik oluşturur.

Saat dilimi belirtilmezse zaman değerleri, komut dosyasının saat dilimi bağlamında yorumlanır. Bu saat dilimi, takvimin saat diliminden farklı olabilir.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringEtkinliğin adı
startTimeDateEtkinliğin başladığı tarih ve saat
endTimeDateEtkinliğin sona erdiği tarih ve saat

Return

CalendarEvent: Oluşturulan etkinlik

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEvent(title, startTime, endTime, options)

Yeni bir etkinlik oluşturur.

Saat dilimi belirtilmezse zaman değerleri, komut dosyasının saat dilimi bağlamında yorumlanır. Bu saat dilimi, takvimin saat diliminden farklı olabilir.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringEtkinliğin adı
startTimeDateEtkinliğin başladığı tarih ve saat
endTimeDateEtkinliğin sona erdiği tarih ve saat
optionsObjectAşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
descriptionStringEtkinliğin açıklaması
locationStringEtkinliğin konumu
guestsStringkonuk olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi
sendInvitesBooleanDavetiye e-postaları gönderilip gönderilmeyeceği (varsayılan: false)

Return

CalendarEvent: Oluşturulan etkinlik

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEventFromDescription(description)

Serbest biçimli bir açıklamadan etkinlik oluşturur.

Açıklama, kullanıcı arayüzünün "Hızlı Ekle" özelliğiyle aynı biçimde olmalıdır.

// 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()}`);

Parametreler

AdTürAçıklama
descriptionStringEtkinliğin serbest biçimli açıklaması

Return

CalendarEvent: Oluşturulan etkinlik

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEventSeries(title, startTime, endTime, recurrence)

Yeni bir etkinlik serisi oluşturur.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringSerideki etkinliklerin başlığı
startTimeDateSerideki ilk etkinliğin başladığı tarih ve saat
endTimeDateSerideki ilk etkinliğin sona erdiği tarih ve saat
recurrenceEventRecurrenceEtkinlik serisinin tekrarlama ayarları

Return

CalendarEventSeries: Oluşturulan etkinlik serisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

createEventSeries(title, startTime, endTime, recurrence, options)

Yeni bir etkinlik serisi oluşturur.

// 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()}`);

Parametreler

AdTürAçıklama
titleStringSerideki etkinliklerin başlığı
startTimeDateSerideki ilk etkinliğin başladığı tarih ve saat
endTimeDateSerideki ilk etkinliğin sona erdiği tarih ve saat
recurrenceEventRecurrenceEtkinlik serisinin tekrarlama ayarları
optionsObjectAşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
descriptionStringSerideki etkinliklerin açıklaması
locationStringSerideki etkinliklerin konumu
guestsStringSerideki etkinliklere davetli olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi
sendInvitesBooleanDavetiye e-postaları gönderilip gönderilmeyeceği (varsayılan: false)

Return

CalendarEventSeries: Oluşturulan etkinlik serisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

getAllCalendars()

Kullanıcının sahip olduğu veya abone olduğu tüm takvimleri alır.

// 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,
);

Return

Calendar[]: Kullanıcının erişebileceği tüm takvimler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getAllOwnedCalendars()

Kullanıcının sahip olduğu tüm takvimleri alır.

// Determines how many calendars the user owns.
const calendars = CalendarApp.getAllOwnedCalendars();
Logger.log('This user owns %s calendars.', calendars.length);

Return

Calendar[]: Kullanıcının sahip olduğu tüm takvimler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getCalendarById(id)

Belirtilen kimliğe sahip takvimi alır.

// 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());

Parametreler

AdTürAçıklama
idStringTakvim kimliği

Return

Calendar|null: Belirtilen kimliğe sahip takvim veya takvim mevcut değilse, kullanıcı takvime erişemiyorsa ya da takvime abone değilse null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getCalendarsByName(name)

Kullanıcının sahip olduğu veya abone olduğu, belirli bir ada sahip tüm takvimleri alır. Adlar büyük/küçük harfe duyarlı değildir.

// Gets the public calendar named "US Holidays".
const calendars = CalendarApp.getCalendarsByName('US Holidays');
Logger.log('Found %s matching calendars.', calendars.length);

Parametreler

AdTürAçıklama
nameStringtakvim adı

Return

Calendar[]: Kullanıcının erişebileceği, bu ada sahip tüm takvimler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getColor()

Takvimin rengini alır.

// 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);

Return

String: Onaltılık renk dizesi ("#rrggbb").

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getDefaultCalendar()

Kullanıcının varsayılan takvimini alır.

// 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(),
);

Return

Calendar: Kullanıcının varsayılan takvimi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getDescription()

Takvimin açıklamasını alır.

// 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);

Return

String: Bu takvimin açıklaması.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getEventById(iCalId)

Belirtilen kimliğe sahip etkinliği alır. Dizi, varsayılan takvim dışında bir takvime aitse bu yöntem söz konusu takvimden çağrılmalıdır. Yalnızca getEventById(iCalId) takvimini çağırdığınızda varsayılan takvimdeki bir etkinlik döndürülür.

Bir etkinlik serisinin parçası olan birden fazla etkinlik aynı kimliğe sahip olabilir. Bu durumda bu yöntem, yalnızca söz konusu serideki ilk etkinliği döndürür.

// 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());

Parametreler

AdTürAçıklama
iCalIdStringEtkinliğin kimliği.

Return

CalendarEvent: Belirtilen kimliğe sahip etkinlik veya etkinlik mevcut değilse ya da kullanıcı etkinliğe erişemiyorsa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getEventSeriesById(iCalId)

Belirtilen kimliğe sahip etkinlik serisini alır. Verilen kimlik tek bir CalendarEvent içinse serideki tek bir etkinlikle birlikte CalendarEventSeries döndürülür. Etkinlik serisi varsayılan takvimden farklı bir takvime aitse bu yöntemin CalendarApp üzerinden çağrılması gerektiğini unutmayın. getEventSeriesById(iCalId) doğrudan çağrıldığında yalnızca varsayılan takvimde bulunan bir etkinlik serisi döndürülür.

// 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());

Parametreler

AdTürAçıklama
iCalIdStringEtkinlik serisinin kimliği.

Return

CalendarEventSeries: Belirtilen kimliğe sahip dizi veya dizi mevcut değilse ya da kullanıcı erişemiyorsa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getEvents(startTime, endTime)

Belirli bir zaman aralığında gerçekleşen tüm etkinlikleri alır.

Bu yöntem, belirtilen zaman aralığında başlayan, zaman aralığında sona eren veya zaman aralığını kapsayan etkinlikleri döndürür. Saat dilimi belirtilmezse saat değerleri, komut dosyasının saat dilimi bağlamında yorumlanır. Bu saat dilimi, takvimin saat diliminden farklı olabilir.

// 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}`);

Parametreler

AdTürAçıklama
startTimeDatezaman aralığının başlangıcı
endTimeDateTarih aralığının bitişi (dahil değildir)

Return

CalendarEvent[]: Zaman aralığında gerçekleşen etkinlikler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getEvents(startTime, endTime, options)

Belirli bir zaman aralığında gerçekleşen ve belirtilen ölçütleri karşılayan tüm etkinlikleri alır.

Bu yöntem, belirtilen zaman aralığında başlayan, zaman aralığında sona eren veya zaman aralığını kapsayan etkinlikleri döndürür. Saat dilimi belirtilmezse saat değerleri, komut dosyasının saat dilimi bağlamında yorumlanır. Bu saat dilimi, takvimin saat diliminden farklı olabilir.

author, search veya statusFilters üzerinde filtrelemenin start ve max uygulandıktan sonra gerçekleştiğini unutmayın. Bu nedenle, ek etkinlikler ölçütleri karşılasa bile döndürülen etkinlik sayısı max değerinden az olabilir.

// 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}`);

Parametreler

AdTürAçıklama
startTimeDatezaman aralığının başlangıcı
endTimeDateTarih aralığının bitişi (dahil değildir)
optionsObjectAşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
startIntegerDöndürülecek ilk etkinliğin dizini
maxIntegerDöndürülecek maksimum etkinlik sayısı
authorStringSonuçları etkinlik oluşturucuya göre filtrelemek için kullanılan bir e-posta adresi
searchStringSonuçları filtrelemek için kullanılan tam metin arama sorgusu
statusFilters[]GuestStatusSonuçları filtrelemek için kullanılan bir durum dizisi

Return

CalendarEvent[]: Zaman aralığında gerçekleşen ve ölçütlerle eşleşen etkinlikler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getEventsForDay(date)

Belirli bir günde gerçekleşen tüm etkinlikleri alır.

Bu yöntem, etkinlikler belirtilen gün içinde başlıyor, gün içinde bitiyor veya günü kapsıyorsa etkinlikleri döndürür.

Date nesnesinin yalnızca tarih kısmının kullanıldığını ve saat kısmının yoksayıldığını unutmayın. Tarih, takvimin saat diliminde o gün gece yarısından sonraki gün gece yarısına kadar geçen süre olarak yorumlanır.

// Determines how many events are happening today.
const today = new Date();
const events = CalendarApp.getDefaultCalendar().getEventsForDay(today);
Logger.log(`Number of events: ${events.length}`);

Parametreler

AdTürAçıklama
dateDateEtkinliklerin alınacağı tarih (yalnızca gün kullanılır, saat dikkate alınmaz)

Return

CalendarEvent[]: Belirli bir tarihte gerçekleşen etkinlikler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getEventsForDay(date, options)

Belirli bir günde gerçekleşen ve belirtilen ölçütleri karşılayan tüm etkinlikleri alır.

Bu yöntem, etkinlikler belirtilen gün içinde başlıyor, gün içinde bitiyor veya günü kapsıyorsa etkinlikleri döndürür.

Date nesnesinin yalnızca tarih kısmının kullanıldığını ve saat kısmının yoksayıldığını unutmayın. Tarih, takvimin saat diliminde o gün gece yarısından sonraki gün gece yarısına kadar geçen süre olarak yorumlanır.

author, search veya statusFilters üzerinde filtrelemenin start ve max uygulandıktan sonra gerçekleştiğini unutmayın. Bu nedenle, ek etkinlikler ölçütleri karşılasa bile döndürülen etkinlik sayısı max değerinden az olabilir.

// 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}`);

Parametreler

AdTürAçıklama
dateDateEtkinliklerin alınacağı tarih (yalnızca gün kullanılır, saat dikkate alınmaz)
optionsObjectgelişmiş filtreleme seçenekleri

Gelişmiş parametreler

AdTürAçıklama
startIntegerDöndürülecek ilk etkinliğin dizini
maxIntegerDöndürülecek maksimum etkinlik sayısı
authorStringSonuçları etkinlik oluşturucuya göre filtrelemek için kullanılan bir e-posta adresi
searchStringSonuçları filtrelemek için kullanılan tam metin arama sorgusu
statusFilters[]GuestStatusSonuçları filtrelemek için kullanılan bir durum dizisi

Return

CalendarEvent[] — Belirli bir tarihte gerçekleşen ve ölçütlerle eşleşen etkinlikler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getId()

Takvimin kimliğini alır. Kullanıcının varsayılan takviminin kimliği, kullanıcının e-posta adresidir.

// 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);

Return

String: Takvimin kimliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getName()

Takvimin adını alır.

// 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);

Return

String: Bu takvimin adı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getOwnedCalendarById(id)

Kullanıcıya aitse belirtilen kimliğe sahip takvimi alır.

Takvim kimliği bulmak için Google Takvim'de takvim adının yanındaki oku tıklayın ve Takvim ayarları'nı seçin. Kimlik, ayarlar sayfasının alt kısmında gösterilir.

// 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());

Parametreler

AdTürAçıklama
idStringTakvim kimliği

Return

Calendar|null: Belirtilen kimliğe sahip takvim veya takvim mevcut değilse ya da kullanıcının takvimin sahibi değilse null

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getOwnedCalendarsByName(name)

Kullanıcının sahip olduğu, belirli bir ada sahip tüm takvimleri alır. Adlar büyük/küçük harfe duyarlı değildir.

// Gets a private calendar named "Travel Plans".
const calendars = CalendarApp.getOwnedCalendarsByName('Travel Plans');
Logger.log('Found %s matching calendars.', calendars.length);

Parametreler

AdTürAçıklama
nameStringtakvim adı

Return

Calendar[]: Kullanıcının sahip olduğu, bu ada sahip tüm takvimler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

getTimeZone()

Takvimin saat dilimini alır.

// 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);

Return

String: "Uzun" biçimde belirtilen saat dilimi (örneğin, Joda.org tarafından listelenen "America/New_York").

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

isHidden()

Takvimin kullanıcı arayüzünde gizlenip gizlenmeyeceğini belirler.

// 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);

Return

Boolean: Takvim, kullanıcı arayüzünde gizliyse; true: Takvim gizli değilse.false

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

isMyPrimaryCalendar()

Takvimin, etkili kullanıcının birincil takvimi olup olmadığını belirler.

// 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);

Return

Boolean: Takvim, etkin kullanıcının varsayılan takvimi ise true, değilse false.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

isOwnedByMe()

Takvimin size ait olup olmadığını belirler.

// 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());

Return

Takvim size aitse Boolean, değilse true.false

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

isSelected()

Takvim etkinliklerinin kullanıcı arayüzünde gösterilip gösterilmeyeceğini belirler.

// 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());

Return

Takvim etkinlikleri kullanıcı arayüzünde gösteriliyorsa Boolean, gösterilmiyorsa truefalse

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

newRecurrence()

Etkinlik tekrarı için kurallar oluşturmak üzere kullanılabilecek yeni bir tekrar nesnesi oluşturur.

// 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()}`);

Return

EventRecurrence: Kural ayarlanmamış yeni bir yinelenme nesnesi (haftalık yinelenme gibi davranır)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.google.com/calendar/feeds

setColor(color)

Takvimin rengini ayarlar.

// 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);

Parametreler

AdTürAçıklama
colorStringCalendarApp.Color veya onaltılık renk dizesi ("#rrggbb").

Return

Calendar: Zincirleme için kullanılan takvim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setDescription(description)

Takvimin açıklamasını ayarlar.

// 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.');

Parametreler

AdTürAçıklama
descriptionStringBu takvimin açıklaması

Return

Calendar: Zincirleme için bu takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setHidden(hidden)

Takvimin kullanıcı arayüzünde görünür olup olmayacağını ayarlar.

Parametreler

AdTürAçıklama
hiddenBooleantrue simgesini tıklayarak takvimi kullanıcı arayüzünde gizleyin, false simgesini tıklayarak gösterin.

Return

Calendar: Zincirleme için bu takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setName(name)

Takvimin adını ayarlar.

// 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');

Parametreler

AdTürAçıklama
nameStringyeni ad

Return

Calendar: Zincirleme için bu takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setSelected(selected)

Takvim etkinliklerinin kullanıcı arayüzünde gösterilip gösterilmeyeceğini ayarlar.

// 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);

Parametreler

AdTürAçıklama
selectedBooleantrue: Takvim etkinliklerini kullanıcı arayüzünde göstermek için; false : Etkinlikleri gizlemek için

Return

Calendar: Zincirleme için bu takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

setTimeZone(timeZone)

Takvimin saat dilimini ayarlar.

// 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');

Parametreler

AdTürAçıklama
timeZoneString"Uzun" biçimde belirtilen saat dilimi (ör. Joda.org tarafından listelenen "America/New_York").

Return

Calendar: Zincirleme için kullanılan takvim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

subscribeToCalendar(id)

Kullanıcının abone olmasına izin veriliyorsa kullanıcıyı, belirtilen kimliğe sahip takvime abone eder.

// 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());

Parametreler

AdTürAçıklama
idStringAbone olunacak takvimin kimliği

Return

Calendar: Yeni abone olunan takvim

Verdiği hatalar

Error: Bu kimliğe sahip bir takvim yoksa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

subscribeToCalendar(id, options)

Kullanıcının abone olmasına izin veriliyorsa kullanıcıyı, belirtilen kimliğe sahip takvime abone eder.

// 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());

Parametreler

AdTürAçıklama
idStringAbone olunacak takvimin kimliği.
optionsObjectAşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
colorStringOnaltılık renk dizesi ("#rrggbb") veya CalendarApp.Colors değerlerinden biri.
hiddenBooleanTakvimin kullanıcı arayüzünde gizlenip gizlenmediği (varsayılan: false).
selectedBooleanTakvim etkinliklerinin kullanıcı arayüzünde gösterilip gösterilmeyeceği (varsayılan: color da belirtilmişse true, aksi takdirde false).

Return

Calendar: Yeni abone olunan takvim.

Verdiği hatalar

Error: Bu kimliğe sahip bir takvim yoksa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds