Gelişmiş Takvim hizmeti, Apps Komut Dosyası'ndaki herkese açık Google Calendar API'yi kullanmanıza olanak tanır. Apps Komut Dosyası'nın yerleşik Takvim hizmetine çok benzer şekilde bu API de komut dosyalarının, kullanıcının abone olduğu ek takvimler dahil, kullanıcının Google Takvimine erişmesine ve değişiklik yapmasına olanak tanır. Yerleşik hizmetin kullanımı çoğu durumda daha kolaydır. Ancak bu gelişmiş hizmet, her etkinlik için arka plan renginin ayarlanmasını da içeren birkaç ekstra özellik sunar.
Referans
Bu hizmet hakkında ayrıntılı bilgi edinmek için herkese açık Google Calendar API'nin referans belgelerini inceleyin. Apps Komut Dosyası'ndaki tüm gelişmiş hizmetler gibi gelişmiş Takvim hizmeti de genel API ile aynı nesneleri, yöntemleri ve parametreleri kullanır. Daha fazla bilgi için Yöntem imzaları nasıl belirlenir? başlıklı makaleye bakın.
Sorunları bildirmek ve diğer destek seçeneklerini bulmak için Takvim destek kılavuzuna bakın.
HTTP istek başlıkları
Gelişmiş Takvim hizmeti If-Match
ve If-None-Match
HTTP istek başlıklarını kabul edebilir. Ayrıntılı bilgi için referans belgeleri inceleyin.
Örnek kod
Aşağıdaki örnek kod, API'nin sürüm 3'ünü kullanmaktadır.
Etkinlik oluşturma
Aşağıdaki örnekte, kullanıcının varsayılan takviminde nasıl etkinlik oluşturulacağı gösterilmektedir.
Takvimleri listeleme
Aşağıdaki örnekte, kullanıcının takvim listesinde gösterilen takvimlerle ilgili ayrıntıların nasıl alınacağı gösterilmektedir.
Etkinlikleri listeleme
Aşağıdaki örnekte, kullanıcının varsayılan takviminde sonraki 10 etkinliğin nasıl listeleneceği gösterilmektedir.
Bir etkinliği koşullu olarak değiştirme
Aşağıdaki örnekte, If-Match
üstbilgisini kullanarak bir Takvim etkinliğinin koşullu olarak nasıl güncelleneceği gösterilmektedir. Komut dosyası yeni bir etkinlik oluşturur, 30 saniye bekler, ardından etkinliği yalnızca etkinlik oluşturulduktan sonra hiçbir etkinlik ayrıntısı değişmediyse günceller.
Bir etkinliği koşullu olarak alma
Aşağıdaki örnekte, If-None-Match
üst bilgisi kullanılarak bir Takvim etkinliğinin koşullu olarak nasıl getirileceği gösterilmektedir. Komut dosyası yeni bir etkinlik oluşturur, ardından
etkinliği değişiklikler için 30 saniye boyunca sorgular. Etkinlik her değiştiğinde yeni sürüm
getirilir.
Etkinlikleri senkronize etme
Aşağıdaki örnekte, senkronizasyon jetonları kullanılarak etkinliklerin nasıl alınacağı gösterilmektedir. Takvim gelişmiş hizmet isteğine bir senkronizasyon jetonu eklediğinizde, sonuçta ortaya çıkan yanıt yalnızca bu jetonun oluşturulmasından bu yana değişen öğeleri içererek daha verimli işlemeye olanak tanır. Senkronizasyon işlemi hakkında daha fazla bilgi edinmek için Kaynakları Verimli Şekilde Senkronize Etme bölümüne bakın.
Aşağıdaki örnekte, yukarıdaki örneklerde tanımlanan aynı getRelativeDate(daysOffset, hour)
yöntemi kullanılmaktadır.