Class Calendar

Takvim

Kullanıcının sahip olduğu veya abone olduğu bir takvimi temsil eder.

Yöntemler

YöntemDönüş türüKısa açıklama
createAllDayEvent(title, date)CalendarEventYeni bir tüm gün etkinliği oluşturur.
createAllDayEvent(title, startDate, endDate)CalendarEventBirden çok günü kapsayabilecek yeni bir tüm gün etkinliği oluşturur.
createAllDayEvent(title, startDate, endDate, options)CalendarEventBirden çok günü kapsayabilecek yeni bir tüm gün etkinliği oluşturur.
createAllDayEvent(title, date, options)CalendarEventYeni bir tüm gün etkinliği oluşturur.
createAllDayEventSeries(title, startDate, recurrence)CalendarEventSeriesYeni bir tüm gün etkinlik serisi oluşturur.
createAllDayEventSeries(title, startDate, recurrence, options)CalendarEventSeriesYeni bir tüm gün etkinlik serisi 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.
deleteCalendar()voidTakvimi kalıcı olarak siler.
getColor()StringTakvimin rengini 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.
getTimeZone()StringTakvimin saat dilimini alır.
isHidden()BooleanTakvimin kullanıcı arayüzünde gizlenmiş olup olmadığını belirler.
isMyPrimaryCalendar()BooleanTakvimin, etkili kullanıcı için birincil takvim olup olmadığını belirler.
isOwnedByMe()BooleanTakvimin size ait olup olmadığını belirler.
isSelected()BooleanTakvim etkinliklerinin kullanıcı arayüzünde görüntülenip görüntülenmeyeceğini belirler.
setColor(color)CalendarTakvimin rengini ayarlar.
setDescription(description)CalendarBir takvimin açıklamasını ayarlar.
setHidden(hidden)CalendarTakvimin kullanıcı arayüzünde görünüp görünmeyeceğini belirler.
setName(name)CalendarTakvimin adını belirler.
setSelected(selected)CalendarTakvim etkinliklerinin kullanıcı arayüzünde görüntülenip görüntülenmeyeceğini ayarlar.
setTimeZone(timeZone)CalendarTakvimin saat dilimini ayarlar.
unsubscribeFromCalendar()voidKullanıcının takvim aboneliğini iptal eder.

Ayrıntılı belgeler

createAllDayEvent(title, date)

Yeni bir tüm gün etkinliği oluşturur.

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

Parametreler

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

Return

CalendarEvent: Oluşturulan etkinlik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 çok günü kapsayabilecek yeni bir tüm gün etkinliği oluşturur.

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

Parametreler

AdTürAçıklama
titleStringEtkinliğin başlığı.
startDateDateEtkinliğin başladığı tarih (yalnızca gün kullanılır, saat yoksayılır).
endDateDateEtkinliğin sona erdiği tarih (yalnızca gün kullanılır, saat yoksayılır). Bitiş tarihi hariçtir.

Return

CalendarEvent: Oluşturulan etkinlik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 çok günü kapsayabilecek yeni bir tüm gün etkinliği oluşturur.

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

Parametreler

AdTürAçıklama
titleStringEtkinliğin başlığı.
startDateDateEtkinliğin başladığı tarih (yalnızca gün kullanılır, saat yoksayılır).
endDateDateEtkinliğin sona erdiği tarih (yalnızca gün kullanılır, saat yoksayılır). 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.
guestsStringDavetli olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi.
sendInvitesBooleanDavetiye e-postalarının gönderilip gönderilmeyeceğini belirler (varsayılan: false).

Return

CalendarEvent: Oluşturulan etkinlik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 etkinliği oluşturur.

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

Parametreler

AdTürAçıklama
titleStringEtkinliğin başlığı.
dateDateEtkinliğin tarihi (yalnızca gün kullanılır, saat yoksayılır).
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.
guestsStringDavetli olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi.
sendInvitesBooleanDavetiye e-postalarının gönderilip gönderilmeyeceğini belirler (varsayılan: false).

Return

CalendarEvent: Oluşturulan etkinlik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 etkinlik serisi oluşturur.

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

Parametreler

AdTürAçıklama
titleStringserideki etkinliklerin başlığı
startDateDateserideki ilk etkinliğin tarihi (yalnızca gün kullanılır; saat yoksayılır)
recurrenceEventRecurrenceetkinlik serisinin yinelenme ayarları

Return

CalendarEventSeries: oluşturulan etkinlik serisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 etkinlik serisi oluşturur.

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

Parametreler

AdTürAçıklama
titleStringserideki etkinliklerin başlığı
startDateDateserideki ilk etkinliğin tarihi (yalnızca gün kullanılır; saat yoksayılır)
recurrenceEventRecurrenceetkinlik serisinin yinelenme ayarları
optionsObjectaşağıda listelendiği gibi, gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
descriptionStringserideki olayların açıklaması
locationStringserideki etkinliklerin konumu
guestsStringserideki etkinliklere davetli olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi
sendInvitesBooleandavetiye e-postaları gönderip göndermeme (varsayılan: false)

Return

CalendarEventSeries: oluşturulan etkinlik serisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 saat değerleri, komut dosyasının saat dilimi bağlamında yorumlanır. Bu saat, takvimin saat diliminden farklı olabilir.

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

Parametreler

AdTürAçıklama
titleStringetkinliğin başlığı
startTimeDateetkinliğin başlayacağı 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 en az biriyle 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 saat değerleri, komut dosyasının saat dilimi bağlamında yorumlanır. Bu saat, takvimin saat diliminden farklı olabilir.

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

Parametreler

AdTürAçıklama
titleStringetkinliğin başlığı
startTimeDateetkinliğin başlayacağı 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 yeri
guestsStringdavetli olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi
sendInvitesBooleandavetiye e-postaları gönderip göndermeme (varsayılan: false)

Return

CalendarEvent: Oluşturulan etkinlik

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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.
var 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 bir açıklaması

Return

CalendarEvent: Oluşturulan etkinlik

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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.
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());

Parametreler

AdTürAçıklama
titleStringserideki etkinliklerin başlığı
startTimeDateserideki ilk etkinliğin başlayacağı tarih ve saat
endTimeDateserideki ilk etkinliğin sona erdiği tarih ve saat
recurrenceEventRecurrenceetkinlik serisinin yinelenme ayarları

Return

CalendarEventSeries: oluşturulan etkinlik serisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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.
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());

Parametreler

AdTürAçıklama
titleStringserideki etkinliklerin başlığı
startTimeDateserideki ilk etkinliğin başlayacağı tarih ve saat
endTimeDateserideki ilk etkinliğin sona erdiği tarih ve saat
recurrenceEventRecurrenceetkinlik serisinin yinelenme ayarları
optionsObjectaşağıda listelendiği gibi, gelişmiş parametreleri belirten bir JavaScript nesnesi

Gelişmiş parametreler

AdTürAçıklama
descriptionStringserideki olayların açıklaması
locationStringserideki etkinliklerin konumu
guestsStringserideki etkinliklere davetli olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi
sendInvitesBooleandavetiye e-postaları gönderip göndermeme (varsayılan: false)

Return

CalendarEventSeries: oluşturulan etkinlik serisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

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

deleteCalendar()

Takvimi kalıcı olarak siler. Bir kullanıcı yalnızca sahip olduğu bir takvimi silebilir.

// Creates a calendar to delete.
const calendar = CalendarApp.createCalendar('Test');

// Deletes the 'Test' calendar permanently.
calendar.deleteCalendar();

Dekoratif yastıklar

Error - Bu içe aktarılmış bir takvimse.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/calendar
  • 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 en az biriyle 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ıdır.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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. Seri, varsayılan takvimden farklı bir takvime aitse bu yöntem söz konusu takvimden çağrılmalıdır. CalendarApp.getEventById(iCalId) çağrıldığında yalnızca 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 ilgili 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. Etkinlik yoksa veya kullanıcı etkinliğe erişemiyorsa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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. Sağlanan kimlik tek bir CalendarEvent içinse serideki tek bir etkinlikle birlikte bir CalendarEventSeries döndürülür. Etkinlik serisi varsayılan takvimden farklı bir takvime aitse bu yöntemin söz konusu Calendar içinden çağrılması gerektiğini unutmayın. CalendarApp.getEventSeriesById(iCalId) çağrısının doğrudan yalnızca varsayılan takvimde bulunan bir etkinlik serisini döndürmesi gerekir.

// 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 seri. Seri yoksa veya kullanıcı seriye erişemiyorsa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 belirli bir 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 da takvimin saat diliminden farklı olabilir.

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

Parametreler

AdTürAçıklama
startTimeDatezaman aralığının başlangıcı
endTimeDatezaman aralığının sonu, dahil değil

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 belirli bir zaman aralığı içinde başlayan, zaman aralığı sırası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 da takvimin saat diliminden farklı olabilir.

author, search veya statusFilters için filtrelemenin start ve max uygulandıktan sonra yapıldığını unutmayın. Bu nedenle, ek etkinlikler kriterleri karşılasa bile döndürülen etkinliklerin sayısı max değerinden az olabilir.

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

Parametreler

AdTürAçıklama
startTimeDatezaman aralığının başlangıcı
endTimeDatezaman aralığının sonu, dahil değil
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ı
authorStringEtkinliği oluşturan kullanıcının sonuçlarını 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ığı içinde gerçekleşen ve ölçütlerle eşleşen etkinlikler.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 belirli bir gün içinde başlıyor, gün içinde bitiyor veya günü kapsıyorsa etkinlikleri döndürür.

Tarih nesnesinin yalnızca tarih bölümünün kullanıldığını ve saat bölümünün yok sayıldığını unutmayın. Tarih, takvimin saat diliminde o günün gece yarısından sonraki günün gece yarısına kadar yorumlanır.

// Determines how many events are happening today.
var today = new Date();
var events = CalendarApp.getDefaultCalendar().getEventsForDay(today);
Logger.log('Number of events: ' + events.length);

Parametreler

AdTürAçıklama
dateDateile ilgili etkinliklerin alınacağı tarih (yalnızca gün kullanılır; saat yoksayılır)

Return

CalendarEvent[]: Belirtilen tarihte gerçekleşen etkinlikler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 belirli bir gün içinde başlıyor, gün içinde bitiyor veya günü kapsıyorsa etkinlikleri döndürür.

Tarih nesnesinin yalnızca tarih bölümünün kullanıldığını ve saat bölümünün yok sayıldığını unutmayın. Tarih, takvimin saat diliminde o günün gece yarısından sonraki günün gece yarısına kadar yorumlanır.

author, search veya statusFilters için filtrelemenin start ve max uygulandıktan sonra yapıldığını unutmayın. Bu nedenle, ek etkinlikler kriterleri karşılasa bile döndürülen etkinliklerin sayısı max değerinden az olabilir.

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

Parametreler

AdTürAçıklama
dateDateile ilgili etkinliklerin alınacağı tarih (yalnızca gün kullanılır; saat yoksayılır)
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ı
authorStringEtkinliği oluşturan kullanıcının sonuçlarını 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[]: Belirtilen tarihte gerçekleşen ve ölçütlerle eşleşen etkinlikler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 en az biriyle 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 en az biriyle 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 "Amerika/New_York").

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 gizlenmiş 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 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; gizli değilse false.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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ı için birincil takvim 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, etkili kullanıcı için varsayılan takvimse true; değilse false.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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

Boolean — Takvim size aitse true; takvim size ait değilse false.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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örüntülenip görüntülenmeyeceğ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

Boolean — Takvimin etkinlikleri kullanıcı arayüzünde gösteriliyorsa true; görüntülenmiyorsa false

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 bu takvim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

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

setDescription(description)

Bir 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 bağlantı için bu takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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üp görünmeyeceğini belirler.

Parametreler

AdTürAçıklama
hiddenBooleanTakvimi kullanıcı arayüzünde gizlemek için true; göstermek için false

Return

Calendar — zincirleme bağlantı için bu takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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ı belirler.

// 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 bağlantı için bu takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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örüntülenip görüntülenmeyeceğ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
selectedBooleanTakvim etkinliklerini kullanıcı arayüzünde göstermek için true; gizlemek için false

Return

Calendar — zincirleme bağlantı için bu takvim

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle 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 (Joda.org tarafından listelendiği şekliyle "Amerika/New_York" gibi).

Return

Calendar — Zincirleme için bu takvim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

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

unsubscribeFromCalendar()

Kullanıcının takvim aboneliğini iptal eder. Kullanıcılar Takvimlerim listesinde yer alan takvimler için aboneliği iptal edemez. Kullanıcılar, Diğer takvimler altında listelenen takvimlerin aboneliklerini iptal edebilir.

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

Dekoratif yastıklar

Error - Bu sahip olduğunuz bir takvimse

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan en az biriyle ya da ilgili REST API'den uygun kapsamlarla yetkilendirme gerektirir:

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