Google Takvim API’si nedir?
Bununla Nasıl Çalışırsınız
Takvim API v3’ü kullanmanın birkaç yolu var. İşte bazıları.<br><br>
- Etkinlikler Oluşturun. Google Takvim, kullanıcıların düzenli kalmasına yardımcı olan harika bir araçtır. Bunu kullanarak örneğin bir yürüyüş rotasını takvim etkinliği olarak ekleyebilir ve her katılımcıya hatırlatacak şekilde onları bilgilendirebilirsiniz; böylece stres yaşamadan hazırlıklı olabilirler.
- Tekrarlayan Etkinlikler. Bazı etkinlikler birkaç kez tekrarlanır – günlük toplantılar, doğum günleri veya tatiller. Genelde aynı içeriklere sahiptir ve aynı başlangıç ile bitiş saatlerini paylaşır.
- <strong>Kaynakları Eşitleyin.</strong> Tüm takvim koleksiyonlarındaki verileri senkronize tutabilir, bant genişliğini tasarruf edebilirsiniz.
- Push Bildirimlerini Etkinleştir. Uygulamanıza bir kaynağın değiştiğini bildiren push bildirimlerini kullanma imkanı vardır.
- Kaynakları Eşitleyin. Google Takvim API’si, tüm takvim koleksiyonlarındaki verileri senkronize ederken bant genişliğini de tasarruf etmenize yardımcı olur.
Google Takvim API’si ayrıca şu kaynakları kullanır:
- Etkinlik – Takvimde başlık, başlangıç ve bitiş saatleri ile katılımcıları içeren bir özelliktir.
- Takvim – olayların bir koleksiyonudur.
- Calendar list – Takvim Arayüzündeki tüm takvimlerin listesi
- Ayar – Takvim arayüzünden bir tercih; örneğin kullanıcıların saat dilimi.
- ACL – bir kullanıcıya takvim üzerinde özel bir erişim düzeyi veren bir erişim kontrol kuralı.
- Renk – Takvim arayüzünde sunulan renk
- Boş/Dolu – takvimde etkinlikler planlandığında “meşgul” olarak görülen veya etkinlik yokken “boş” olarak kabul edilen zamanlar.
Takvim API’sini Kullanın
Her uygulamanız Calendar API v3’e gönderdiği her istek için bir yetkilendirme belirteci gerekir. Bu belirteç aynı zamanda Google için uygulamayı tanımlar. İstekleri yetkilendirmek için uygulamanın OAuth 2.0 kullanması gerekir — desteklenen başka yetkilendirme protokolleri yoktur.
- Uygulamayı oluştururken Google Calendar API Console yardımıyla kaydedin. Google size bir istemci kimliği ve bir istemci sırrı verecek. Bu bilgilere daha sonra ihtiyacınız olacak.
- Google Takvim API’sini API Konsolu’nda etkinleştirin. Orada listelenmiyorsa bu adımı atlayın.
- Uygulamanız kullanıcı verilerine erişim gerektiğinde, Google’dan belirli bir erişim kapsamı talep eder.
- Sonra Google, kullanıcıya bazı bilgilerini talep etmek için uygulamanıza yetki vermesini isteyen bir onay ekranı gösterir.
- Kullanıcı onay verirse Google, uygulamanıza kısa ömürlü bir erişim belirteci verir.
- Daha sonra uygulamanız kullanıcı verilerini talep eder ve isteğe bu jetonu ekler.
- Google isteğinizi ve belirtecinizi geçerli olarak doğrularsa istenen verileri döndürür.
Bazen yeni erişim jetonları elde etmek için ek adımlara ihtiyaç duyabilirsiniz; örneğin yenileme jetonlarını kullanarak. Farklı türde uygulamalar için süreçleri buraya bakın.
Şansınız yaver gider ve onaylanırsanız, entegre yazılımınızın geliştirmesine başlayabilmeniz için Takvim API belgelerine erişim elde edersiniz.
Web sitenize basit ve hızlı bir Takvim eklemenin yolunu mu arıyorsunuz? Elfsight’in Etkinlik Takvimi aracı kullanmayı düşünün. Etkinliklerinizi Google arama sonuçlarında zahmetsizce görünür kılmanıza olanak tanır.
Takvim API’si: Örnekler
Google Takvim API ile Etkinlik Oluştur
- calendarId – Bu, üzerinde bir etkinlik oluşturacağınız takvimin e-posta adresi olabilecek bir takvim tanımlayıcısıdır veya oturum açmış kullanıcının birincil takvimini kullanacak özel anahtar kelime ‘primary’ olabilir.
- Etkinliği Oluştur Oluşturulacak etkinlik başlangıç ve bitiş gibi gerekli tüm bilgilerle bir etkinliktir. Buradaki tek iki zorunlu alan başlangıç ve bitiş saatleridir.
Aşağıdaki örnek, bir etkinlik oluşturma ve meta verisini ayarlama sürecini gösterir:
Örnek: Etkinlik Oluşturma Süreci
// Refer to the JavaScript quickstart on how to setup the environment:<br><br>
// https://developers.google.com/calendar/quickstart/js<br><br>
// Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any<br><br>
// stored credentials.<br><br><br><br>
var event = {<br><br>
'summary': 'Google I/O 2015',<br><br>
'location': '800 Howard St., San Francisco, CA 94103',<br><br>
'description': 'A chance to hear more about Google's developer products.',<br><br>
'start': {<br><br>
'dateTime': '2015-05-28T09:00:00-07:00',<br><br>
'timeZone': 'America/Los_Angeles'<br><br>
},<br><br>
'end': {<br><br>
'dateTime': '2015-05-28T17:00:00-07:00',<br><br>
'timeZone': 'America/Los_Angeles'<br><br>
},<br><br>
'recurrence': [<br><br>
'RRULE:FREQ=DAILY;COUNT=2'<br><br>
],<br><br>
'attendees': [<br><br>
{'email': 'lpage@example.com'},<br><br>
{'email': 'sbrin@example.com'}<br><br>
],<br><br>
'reminders': {<br><br>
'useDefault': false,<br><br>
'overrides': [<br><br>
{'method': 'email', 'minutes': 24 * 60},<br><br>
{'method': 'popup', 'minutes': 10}<br><br>
]<br><br>
}<br><br>
};<br><br><br><br>
var request = gapi.client.calendar.events.insert({<br><br>
'calendarId': 'primary',<br><br>
'resource': event<br><br>
});<br><br><br><br>
request.execute(function(event) {<br><br>
appendPre('Event created: ' + event.htmlLink);<br><br>
});<br><br>
Tekrarlı Etkinlikler API
Bu etkinlikler düzenli bir program kapsamında birkaç kez tekrarlanır; örneğin günlük toplantılar, doğum günleri veya tatiller olabilir. İşte 15 Eylül 2015’ten başlayıp 29 Eylül’de beşinci kez gerçekleşene kadar Salı ve Cuma günleri 06:00–07:00 saatlerinde olan bir etkinliğin örneği:
Örnek: Tekrarlayan Etkinlikler
Burada, 1 Haziran 2015’te başlayan ve ay boyunca her 3 günde bir tekrarlanan, tüm gün süren bir etkinliği görebiliriz; 10 Haziran hariç, 9 Haziran ve 11 Haziran dahil.
Örnek: tüm gün yinelenen etkinlik
Kaynakları Eşitle
Bu yöntem, tüm takvim koleksiyonlarındaki verileri senkronize tutmanıza yardımcı olur. Artımlı senkronizasyon iki aşamadan oluşur:
- İlk tam eşitleme, istemci durumunu ve sunucu durumunu tamamen senkronize etmek amacıyla başlangıçta bir kez gerçekleştirilir.
- Artımlı eşitleme tekrarlı olarak gerçekleştirilir ve önceki güncellemeden bu yana meydana gelen tüm değişiklikler istemciye iletilir.
Senkronizasyon belirteci için bir örnek:
Örnek: Senkronizasyon Belirteci
Push Bildirimleri
Google Calendar API v3, kaynaklardaki değişiklikleri izlemenizi sağlayan push bildirimleri almanıza olanak tanır. Bu özellik, uygulamanızı geliştirmek için kullanılabilir.
Push bildirimlerini kullanmaya başlamak için üç şeye ihtiyacınız var:
- Alıcı URL’inizin alan adını kaydedin.
- Alım URL’nizi veya “Webhook” geri çağrı alıcısını ayarlayın.
- İzleyeceğiniz her kaynak uç noktası için bildirim kanalı kurun.
Aşağıdaki örnek, bir dizi etkinlikte değişiklikleri izlemeye nasıl başlayabileceğinizi gösterir:
Örnek: Bir etkinlik koleksiyonundaki değişiklikleri izleme
Takvim API sınırları
- Bir faturalandırma hesabı oluşturun; hesabınız yoksa.
- Google Konsolu’ndaki API Kitaplığı’nın Etkinleştirilmiş API’ler sayfasına gidin ve listeden bir API seçin.
- Görüntülemek ve kota ile ilgili ayarları değiştirmek için kotaları seçin.
Kullanım istatistiklerinizi ayrıca Kullanım bölümünde görebilirsiniz.
Platform verilerini kullanmanıza yardımcı olan başka widget’lar da var. Her işletme için en faydalı olanlardan biri Google Yorumlar widget’ı. Çok geniş işlevselliğe sahip ve yalnızca <a href=”http://tr.elfsight.com/blog/how-to-embed-google-reviews-on-website/”>Google yorumlarını sitenize eklemekle kalmaz</a>, ayrıca arama sonuçları için zengin snippet’ler de oluşturur.
SSS (Sık Sorulan Sorular)
Google Takvim API ücretsiz mi?
Evet, Google Takvim API kullanımı ücretsizdir. Ancak bazı sınırlamalar vardır.
Takvim API’si yardımıyla bir etkinlik nasıl oluşturulur?
events.insert() metodunu çağırmanız gerekiyor; calendarId ve event parametrelerini sağlamalısınız. Ayrıca OAuth kapsamınızı https://www.googleapis.com/auth/calendar olarak ayarlayın ve doğrulanmış kullanıcının sağladığınız calendarId ile takvime yazma erişimine sahip olduğundan emin olun.
Google Takvim’den verileri nasıl alabilirim?
Takvimini açın, sonra “Takvimlerim” bölümüne tıklayın. Dışa aktarmak istediğiniz takvimi seçin ve “Daha Fazla”ya tıklayın. Takvim ayarları altında “Takvimi Dışa Aktar”ı tıklayın. Böylece etkinliklerinizi içeren ICS indirmeye başlayacaktır.
Takvimimi otomatik olarak yedekleyebilir miyim?
Elbette. Bunu yapmak için Takvim sekmesini açın, ardından “Daha Fazla” düğmesine tıklayın ve açılır listeden “Yedekle” seçeneğini seçin; yedekleme otomatik olarak başlayacaktır.
Google Takvim API’nizi nasıl bulabilirsiniz?
Google Geliştirici Konsolu’na gidin ve yeni bir proje oluşturun. Projede yan menüden API’ler ve Kimlik Doğrulama > API’ler bölümüne geçin. Ardından listede Takvim API’si’ni bulun.
Sonuç
