Gelişmiş Takvim hizmeti, Apps Komut Dosyası'nda herkese açık Google Takvim API'sini kullanmanıza olanak tanır. Apps Komut Dosyası'nın yerleşik Takvim hizmetine benzer şekilde, bu API de komut dosyalarının kullanıcının abone olduğu ek takvimler dahil olmak üzere kullanıcının Google Takvimine erişmesine ve bu verileri değiştirmesine olanak tanır. Yerleşik hizmetin kullanımı çoğu durumda daha kolaydır. Ancak bu gelişmiş hizmet, tek tek etkinlikler için arka plan rengini ayarlama gibi 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? bölümüne bakın.
Sorunları bildirmek ve diğer desteğe ulaşmak için Takvim destek kılavuzuna göz atı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 belgelerini inceleyin.
Örnek kod
Aşağıdaki örnek kod, API'nin 3. sürümünü kullanmaktadır.
Etkinlik oluşturma
Aşağıdaki örnek, kullanıcının varsayılan takviminde nasıl etkinlik oluşturulacağı gösterilmektedir.
Takvimleri listeleme
Aşağıdaki örnek, kullanıcının takvim listesinde gösterilen takvimlerle ilgili ayrıntıların nasıl alınacağını göstermektedir.
Etkinlikleri listeleme
Aşağıdaki örnek, kullanıcının varsayılan takviminde yaklaşan 10 etkinliğin nasıl listeleneceğini gösterir.
Bir etkinliği koşullu olarak değiştirme
Aşağıdaki örnekte, If-Match
üstbilgisi kullanılarak bir Takvim etkinliğinin nasıl koşullu olarak güncelleneceği gösterilmektedir. Komut dosyası yeni bir etkinlik oluşturur, 30 saniye bekler ve ardından, yalnızca etkinlik oluşturulduktan sonra hiçbir etkinlik ayrıntısı değişmediyse 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, ardından değişiklikler için etkinliği 30 saniye boyunca yoklar. 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 jeton oluşturulduktan sonra değişen öğeleri içerir ve işlemenin daha verimli olmasını sağlar. Senkronizasyon işlemi hakkında daha fazla bilgi için Kaynakları Verimli Bir Ş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.