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ğlar ve kullanıcının sahibi olduğu veya abone olduğu ek takvimleri alma olanağı sunar.
Özellikler
Mülk | Tür | Açıklama |
---|---|---|
Color | Color | Takvim hizmetinde kullanılabilen adlandırılmış renkleri temsil eden bir enum. |
EventColor | EventColor | Takvim hizmetinde bulunan adlandırılmış etkinlik renklerini temsil eden bir enum. |
EventType | EventType | EventType numaralandırması. |
GuestStatus | GuestStatus | Bir davetlinin etkinlikle ilgili sahip olabileceği durumları temsil eden bir enum. |
Month | Month | Yılın aylarını temsil eden bir enum. |
Visibility | Visibility | Bir etkinliğin görünürlüğünü temsil eden bir enum. |
Weekday | Weekday | Haftanın günlerini temsil eden bir enum. |
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
createAllDayEvent(title, date) | CalendarEvent | Yeni bir tüm gün etkinliği oluşturur. |
createAllDayEvent(title, startDate, endDate) | CalendarEvent | Birden fazla gün boyunca devam edebilecek yeni bir tüm gün etkinliği oluşturur. |
createAllDayEvent(title, startDate, endDate, options) | CalendarEvent | Birden fazla gün boyunca devam edebilecek yeni bir tüm gün etkinliği oluşturur. |
createAllDayEvent(title, date, options) | CalendarEvent | Yeni bir tüm gün etkinliği oluşturur. |
createAllDayEventSeries(title, startDate, recurrence) | CalendarEventSeries | Yeni bir tüm gün etkinlik serisi oluşturur. |
createAllDayEventSeries(title, startDate, recurrence, options) | CalendarEventSeries | Yeni bir tüm gün etkinlik serisi oluşturur. |
createCalendar(name) | Calendar | Kullanıcıya ait yeni bir takvim oluşturur. |
createCalendar(name, options) | Calendar | Kullanıcıya ait yeni bir takvim oluşturur. |
createEvent(title, startTime, endTime) | CalendarEvent | Yeni bir etkinlik oluşturur. |
createEvent(title, startTime, endTime, options) | CalendarEvent | Yeni bir etkinlik oluşturur. |
createEventFromDescription(description) | CalendarEvent | Serbest biçimli bir açıklamadan etkinlik oluşturur. |
createEventSeries(title, startTime, endTime, recurrence) | CalendarEventSeries | Yeni bir etkinlik serisi oluşturur. |
createEventSeries(title, startTime, endTime, recurrence, options) | CalendarEventSeries | Yeni 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 | Belirtilen 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() | String | Takvim rengini alır. |
getDefaultCalendar() | Calendar | Kullanıcının varsayılan takvimini alır. |
getDescription() | String | Takvim açıklamasını alır. |
getEventById(iCalId) | CalendarEvent | Belirtilen kimliğe sahip etkinliği alır. |
getEventSeriesById(iCalId) | CalendarEventSeries | Belirtilen 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() | String | Takvim kimliğini alır. |
getName() | String | Takvimin adını alır. |
getOwnedCalendarById(id) | Calendar | Kullanıcının sahibi olduğu takdirde, 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() | String | Takvimin saat dilimini alır. |
isHidden() | Boolean | Takvim'in kullanıcı arayüzünde gizli olup olmadığını belirler. |
isMyPrimaryCalendar() | Boolean | Takvim etkin kullanıcı için birincil takvim olup olmadığını belirler. |
isOwnedByMe() | Boolean | Takviminizin size ait olup olmadığını belirler. |
isSelected() | Boolean | Takvim etkinliklerinin kullanıcı arayüzünde gösterilip gösterilmeyeceğini belirler. |
newRecurrence() | EventRecurrence | Etkinlik tekrarı için kurallar oluşturmak üzere kullanılabilecek yeni bir tekrar nesnesi oluşturur. |
setColor(color) | Calendar | Takvim rengini ayarlar. |
setDescription(description) | Calendar | Bir takvimin açıklamasını belirler. |
setHidden(hidden) | Calendar | Takvim'in kullanıcı arayüzünde görünür olup olmayacağını belirler. |
setName(name) | Calendar | Takvim adını ayarlar. |
setSelected(selected) | Calendar | Takvim etkinliklerinin kullanıcı arayüzünde gösterilip gösterilmeyeceğini belirler. |
setTimeZone(timeZone) | Calendar | Takvimin saat dilimini ayarlar. |
subscribeToCalendar(id) | Calendar | Kullanıcının abone olmasına izin veriliyorsa kullanıcıyı belirtilen kimliğe sahip takvime abone eder. |
subscribeToCalendar(id, options) | Calendar | Kullanıcının abone olmasına izin veriliyorsa kullanıcıyı belirtilen kimliğe sahip takvime abone eder. |
Ayrıntılı dokümanlar
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. const event = CalendarApp.getDefaultCalendar().createAllDayEvent( 'Apollo 11 Landing', new Date('July 20, 1969'), ); Logger.log(`Event ID: ${event.getId()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Etkinliğin başlığı. |
date | Date | Etkinliğ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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
createAllDayEvent(title, startDate, endDate)
Birden fazla gün boyunca devam edebilecek 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. const event = CalendarApp.getDefaultCalendar().createAllDayEvent( 'Woodstock Festival', new Date('August 15, 1969'), new Date('August 18, 1969'), ); Logger.log(`Event ID: ${event.getId()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Etkinliğin başlığı. |
startDate | Date | Etkinliğin başladığı tarih (yalnızca gün kullanılır, saat yoksayılır). |
endDate | Date | Etkinliğ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 bir veya daha fazlasıyla veya ilgili REST API'deki 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 boyunca devam edebilecek 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. 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
Ad | Tür | Açıklama |
---|---|---|
title | String | Etkinliğin başlığı. |
startDate | Date | Etkinliğin başladığı tarih (yalnızca gün kullanılır, saat yoksayılır). |
endDate | Date | Etkinliğin sona erdiği tarih (yalnızca gün kullanılır, saat yoksayılır). Bitiş tarihi hariçtir. |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | Etkinliğin açıklaması. |
location | String | Etkinlik konumu. |
guests | String | Misafir olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi. |
sendInvites | Boolean | Davetiye 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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. const event = CalendarApp.getDefaultCalendar().createAllDayEvent( 'Apollo 11 Landing', new Date('July 20, 1969'), {location: 'The Moon'}, ); Logger.log(`Event ID: ${event.getId()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Etkinliğin başlığı. |
date | Date | Etkinliğin tarihi (yalnızca gün kullanılır, saat yoksayılır). |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | Etkinliğin açıklaması. |
location | String | Etkinlik konumu. |
guests | String | Misafir olarak eklenmesi gereken e-posta adreslerinin virgülle ayrılmış listesi. |
sendInvites | Boolean | Davetiye 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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. 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
Ad | Tür | Açıklama |
---|---|---|
title | String | Serideki etkinliklerin başlığı |
startDate | Date | Serideki ilk etkinliğin tarihi (yalnızca gün kullanılır, saat yoksayılır) |
recurrence | EventRecurrence | Etkinlik serisinin tekrarlama ayarları |
Return
CalendarEventSeries
: Oluşturulan etkinlik serisi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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. 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
Ad | Tür | Açıklama |
---|---|---|
title | String | Serideki etkinliklerin başlığı |
startDate | Date | Serideki ilk etkinliğin tarihi (yalnızca gün kullanılır, saat yoksayılır) |
recurrence | EventRecurrence | Etkinlik serisinin tekrarlama ayarları |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | Serideki etkinliklerin açıklaması |
location | String | Serideki etkinliklerin konumu |
guests | String | Serideki etkinliklere davetli olarak eklenecek e-posta adreslerinin virgülle ayrılmış listesi |
sendInvites | Boolean | davetiye 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
name | String | yeni takvimin adı |
Return
Calendar
: Yeni oluşturulan takvim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
name | String | yeni takvimin adı |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
location | String | takvimin konumu |
description | String | takvimin açıklaması |
timeZone | String | Takvim için ayarlanacak saat dilimi. "Uzun" biçimde belirtilir (ör. Joda.org tarafından listelenen "America/New_York") |
color | String | on altılı renk dizesi ("#rrggbb") veya CalendarApp.Colors içindeki bir değer |
hidden | Boolean | Takvim'in kullanıcı arayüzünde gizlenip gizlenmeyeceği (varsayılan:
false ) |
selected | Boolean | Takvim 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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 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
Ad | Tür | Açıklama |
---|---|---|
title | String | etkinliğin başlığı |
startTime | Date | Etkinliğin başladığı tarih ve saat |
endTime | Date | Etkinliğin sona erdiği tarih ve saat |
Return
CalendarEvent
: Oluşturulan etkinlik
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 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
Ad | Tür | Açıklama |
---|---|---|
title | String | etkinliğin başlığı |
startTime | Date | Etkinliğin başladığı tarih ve saat |
endTime | Date | Etkinliğin sona erdiği tarih ve saat |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | Etkinliğin açıklaması |
location | String | Etkinliğin konumu |
guests | String | Konuk olarak eklenecek e-posta adreslerinin virgülle ayrılmış listesi |
sendInvites | Boolean | davetiye 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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çimi kullanmalı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
Ad | Tür | Açıklama |
---|---|---|
description | String | Etkinliğin serbest biçimli açıklaması |
Return
CalendarEvent
: Oluşturulan etkinlik
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
title | String | Serideki etkinliklerin başlığı |
startTime | Date | Serideki ilk etkinliğin başladığı tarih ve saat |
endTime | Date | Serideki ilk etkinliğin sona erdiği tarih ve saat |
recurrence | EventRecurrence | Etkinlik serisinin tekrarlama ayarları |
Return
CalendarEventSeries
: Oluşturulan etkinlik serisi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
title | String | Serideki etkinliklerin başlığı |
startTime | Date | Serideki ilk etkinliğin başladığı tarih ve saat |
endTime | Date | Serideki ilk etkinliğin sona erdiği tarih ve saat |
recurrence | EventRecurrence | Etkinlik serisinin tekrarlama ayarları |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | Serideki etkinliklerin açıklaması |
location | String | Serideki etkinliklerin konumu |
guests | String | Serideki etkinliklere davetli olarak eklenecek e-posta adreslerinin virgülle ayrılmış listesi |
sendInvites | Boolean | davetiye 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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şebildiği tüm takvimler
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
id | String | takvim kimliği |
Return
Calendar
: Belirtilen kimliğe sahip takvim veya takvim mevcut değilse, kullanıcı takvime erişemiyorsa ya da kullanıcı takvime abone değilse null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
name | String | takvim adı |
Return
Calendar[]
: Kullanıcının erişebildiği, bu ada sahip tüm takvimler
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getColor()
Takvim 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
: On altılık renk dizesi ("#rrggbb").
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getDescription()
Takvim 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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 takvim dışında bir takvime aitse bu yöntem ilgili takvimden çağrılmalıdır. getEventById(iCalId)
çağrısı yalnızca varsayılan takvimdeki bir etkinliği döndürü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
Ad | Tür | Açıklama |
---|---|---|
iCalId | String | Etkinliğin kimliği. |
Return
CalendarEvent
: Belirtilen kimliğe sahip etkinlik veya etkinlik mevcut değilse ya da kullanıcı erişemiyorsa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 etkinliğin bulunduğu bir CalendarEventSeries
döndürülür. Etkinlik serisinin varsayılan takvim dışında bir takvime ait olması durumunda bu yöntemin ilgili CalendarApp
üzerinden çağrılması gerektiğini unutmayın. getEventSeriesById(iCalId)
doğrudan çağrılırsa 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
Ad | Tür | Açıklama |
---|---|---|
iCalId | String | Etkinlik serisinin kimliği. |
Return
CalendarEventSeries
: Belirtilen kimliğe sahip seri veya seri mevcut değilse ya da kullanıcı serinull
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 diliminde 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
Ad | Tür | Açıklama |
---|---|---|
startTime | Date | Zaman aralığının başlangıcı |
endTime | Date | Zaman aralığının bitiş tarihi (dahil değildir) |
Return
CalendarEvent[]
: Zaman aralığında gerçekleşen etkinlikler
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 diliminde farklı olabilir.
author
, search
veya statusFilters
'de filtrelemenin start
ve max
uygulandıktan sonra gerçekleştiğini unutmayın. Bu, ek etkinlikler ölçütleri karşılasa bile döndürülen etkinlik sayısının max
'ten az olabileceği anlamına gelir.
// 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
Ad | Tür | Açıklama |
---|---|---|
startTime | Date | Zaman aralığının başlangıcı |
endTime | Date | Zaman aralığının bitiş tarihi (dahil değildir) |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Döndürülecek ilk etkinliğin dizini |
max | Integer | döndürülecek maksimum etkinlik sayısı |
author | String | Sonuçları etkinlik oluşturucuya göre filtrelemek için kullanılan e-posta adresi |
search | String | Sonuçları filtrelemek için kullanılan tam metin arama sorgusu |
statusFilters[] | GuestStatus | Sonuç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 bir veya daha fazlasıyla veya ilgili REST API'deki 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, belirtilen gün içinde başlayan, biten veya günü kapsayan etkinlikleri döndürür.
Date nesnesinin yalnızca tarih kısmının kullanıldığını ve saat kısmının yok sayıldığını unutmayın. Tarih, takvimin saat dilimine göre o günün gece yarısından sonraki günün gece yarısına kadar olan 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
Ad | Tür | Açıklama |
---|---|---|
date | Date | 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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, belirtilen gün içinde başlayan, biten veya günü kapsayan etkinlikleri döndürür.
Date nesnesinin yalnızca tarih kısmının kullanıldığını ve saat kısmının yok sayıldığını unutmayın. Tarih, takvimin saat dilimine göre o günün gece yarısından sonraki günün gece yarısına kadar olan süre olarak yorumlanır.
author
, search
veya statusFilters
'de filtrelemenin start
ve max
uygulandıktan sonra gerçekleştiğini unutmayın. Bu, ek etkinlikler ölçütleri karşılasa bile döndürülen etkinlik sayısının max
'ten az olabileceği anlamına gelir.
// 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
Ad | Tür | Açıklama |
---|---|---|
date | Date | Etkinliklerin alınacağı tarih (yalnızca gün kullanılır, saat yoksayılır) |
options | Object | gelişmiş filtreleme seçenekleri |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Döndürülecek ilk etkinliğin dizini |
max | Integer | döndürülecek maksimum etkinlik sayısı |
author | String | Sonuçları etkinlik oluşturucuya göre filtrelemek için kullanılan e-posta adresi |
search | String | Sonuçları filtrelemek için kullanılan tam metin arama sorgusu |
statusFilters[] | GuestStatus | Sonuçları filtrelemek için kullanılan bir durum dizisi |
Return
CalendarEvent[]
: Belirtilen tarihte gerçekleşen ve ölçütlere uyan etkinlikler
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
getId()
Takvim kimliğini alır. Kullanıcının varsayılan takviminin kimliği, 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
: Takvim kimliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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ının sahibi olduğu takdirde, belirtilen kimliğe sahip takvimi alır.
Takvim kimliğini bulmak için Google Takvim'de takvimin 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
Ad | Tür | Açıklama |
---|---|---|
id | String | takvim kimliği |
Return
Calendar
: Belirtilen kimliğe sahip takvim veya takvim mevcut değilse ya da kullanıcının sahip olmadığı takdirde null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
name | String | takvim 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 bir veya daha fazlasıyla veya ilgili REST API'deki 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 (ör. Joda.org tarafından listelenen "America/New_York").
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isHidden()
Takvim'in kullanıcı arayüzünde gizli 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
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isMyPrimaryCalendar()
Takvim etkin 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, etkin kullanıcı için varsayılan takvimse true
, değilse false
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.googleapis.com/auth/calendar.readonly
-
https://www.google.com/calendar/feeds
isOwnedByMe()
Takviminizin 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
, aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Boolean
: Takvim etkinlikleri kullanıcı arayüzünde gösteriliyorsa true
, aksi takdirde false
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 yineleme nesnesi (haftalık yineleme gibi davranır)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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)
Takvim 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
Ad | Tür | Açıklama |
---|---|---|
color | String | CalendarApp.Color veya on altılık renk dizesi ("#rrggbb"). |
Return
Calendar
: Zincirleme için bu takvim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setDescription(description)
Bir takvimin açıklamasını belirler.
// 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
Ad | Tür | Açıklama |
---|---|---|
description | String | Bu takvimin açıklaması |
Return
Calendar
: zincirleme için bu takvim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setHidden(hidden)
Takvim'in kullanıcı arayüzünde görünür olup olmayacağını belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
hidden | Boolean | true ile kullanıcı arayüzünde takvimi gizleyebilir, false ile de gösterebilirsiniz. |
Return
Calendar
: zincirleme için bu takvim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
setName(name)
Takvim 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
Ad | Tür | Açıklama |
---|---|---|
name | String | yeni ad |
Return
Calendar
: zincirleme için bu takvim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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 belirler.
// 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
Ad | Tür | Açıklama |
---|---|---|
selected | Boolean | true , takvimin etkinliklerini kullanıcı arayüzünde göstermek için; false
ise gizlemek için kullanılır. |
Return
Calendar
: zincirleme için bu takvim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
timeZone | String | "Uzun" biçimde belirtilen saat dilimi (ör. Joda.org tarafından listelenen "America/New_York"). |
Return
Calendar
: Zincirleme için bu takvim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
id | String | Abone olunacak takvimin kimliği |
Return
Calendar
: Yeni abone olunan takvim
Atışlar
Error
: Bu kimliğe sahip bir takvim yoksa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki 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
Ad | Tür | Açıklama |
---|---|---|
id | String | Abone olunacak takvimin kimliği. |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | On altılı renk dizesi ("#rrggbb") veya CalendarApp.Colors içindeki bir değer. |
hidden | Boolean | Takvim'in kullanıcı arayüzünde gizlenip gizlenmeyeceği (varsayılan:
false ). |
selected | Boolean | Takvim 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.
Atışlar
Error
: Bu kimliğe sahip bir takvim yoksa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla veya ilgili REST API'deki uygun kapsamlarla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds