Gelişmiş Takvim hizmeti, Apps Komut Dosyası'nda herkese açık Google Calendar API'yi kullanmanıza olanak tanır. Apps Komut Dosyası'nın yerleşik Takvim hizmeti gibi bu API de komut dosyalarının, kullanıcının abone olduğu ek takvimler dahil olmak üzere kullanıcının Google Takvim'ine erişmesine ve takvimi değiştirmesine olanak tanır. Çoğu durumda yerleşik hizmet daha kolay kullanılır ancak bu gelişmiş hizmet, etkinliklerin arka plan rengini ayarlama gibi birkaç ek özellik sunar.
Referans
Bu hizmet hakkında ayrıntılı bilgi için herkese açık Google Calendar API'nin referans belgelerine bakın. Apps Komut Dosyası'ndaki tüm gelişmiş hizmetler gibi gelişmiş Takvim hizmeti de herkese açık API ile aynı nesneleri, yöntemleri ve parametreleri kullanır. Daha fazla bilgi için Metod imzaları nasıl belirlenir? başlıklı makaleyi inceleyin.
Sorunları bildirmek ve diğer destek seçeneklerini görmek için Takvim destek kılavuzuna göz atın.
HTTP istek üstbilgileri
Gelişmiş Takvim hizmeti, If-Match
ve If-None-Match
HTTP istek başlıklarını kabul edebilir. Ayrıntılar için referans dokümanlarını inceleyin.
Örnek kod
Aşağıdaki örnek kodda API'nin 3. sürümü kullanılmaktadır.
Etkinlik oluşturma
Aşağıdaki örnekte, kullanıcının varsayılan takviminde nasıl etkinlik oluşturulacağı gösterilmektedir.
Takvim listelemesi
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 yaklaşan 10 etkinliğin nasıl listeleneceği gösterilmektedir.
Bir etkinliği koşullu olarak değiştirme
Aşağıdaki örnekte, If-Match
üstbilgisi kullanılarak bir takvim etkinliğinin koşullu olarak nasıl güncelleneceği gösterilmektedir. Komut dosyası yeni bir etkinlik oluşturur, 30 saniye bekler ve yalnızca etkinlik oluşturulduktan sonra etkinlik ayrıntılarında değişiklik yapılmadıysa etkinliği günceller.
Bir etkinliği koşullu olarak alma
Aşağıdaki örnekte, If-None-Match
üstbilgisi kullanılarak bir Takvim etkinliğinin koşullu olarak nasıl getirileceği gösterilmektedir. Komut dosyası yeni bir etkinlik oluşturur ve ardından 30 saniye boyunca etkinlikte değişiklik olup olmadığını kontrol eder. 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. Bir Takvim gelişmiş hizmet isteğine senkronizasyon jetonu eklediğinizde, elde edilen yanıt yalnızca jeton oluşturulduktan sonra değişen öğeleri içerir. Bu sayede daha verimli bir işlem gerçekleştirilir. Senkronizasyon süreciyle ilgili daha fazla bilgi için Kaynakları Verimli Bir Şekilde Senkronize Etme başlıklı makaleyi inceleyin.
Aşağıdaki örnekte, yukarıdaki örneklerde tanımlanan getRelativeDate(daysOffset, hour)
yöntemi kullanılmaktadır.