Geliştirici Kılavuzu'na Genel Bakış

Uyarı: Bu sayfa, Google'ın eski API'leri olan Google Veri API'leriyle ilgilidir. Bu sayfalar, çoğu yeni API'lerle değiştirilen Google Veri API'leri dizininde listelenen API'lerle ilgilidir. Belirli bir yeni API ile ilgili bilgi edinmek için yeni API'nin belgelerine bakabilirsiniz. Yeni bir API ile istekleri yetkilendirme hakkında bilgi için Google Hesaplarında Kimlik Doğrulama ve Yetkilendirme başlıklı makaleyi inceleyin.

Google'ın misyonu, dünyadaki bilgileri organize edip herkes tarafından erişilebilir ve yararlı kılmaktır. Buna, web tarayıcı dışındaki bağlamlarda ve Google dışındaki hizmetler için de erişilebilir olmak da dahildir.

Google Veri Protokolü, harici geliştiricilerin birçok Google ürününde depolanan verilere erişmesine ve bunları güncellemesine olanak tanıyan yeni uygulamalar yazması için güvenli bir yol sağlar. Harici geliştiriciler Google Veri Protokolü'nü doğrudan kullanabilir veya istemci kitaplıklarının sağladığı desteklenen programlama dillerinden herhangi birini kullanabilir.

Kitle

Bu belge grubu, Google Veri Protokolü'nü anlamak isteyen herkes için hazırlanmıştır. Dile özel istemci kitaplıkları kullanan bir kod yazmak istiyor olsanız bile, istemci kitaplığı soyutlama katmanı altında neler olduğunu anlamak için bu doküman grubundan yararlanabilirsiniz.

Belirli bir API'nin Geliştirici Kılavuzu'nu arıyorsanız Google Veri Protokolü API Directory'yi ziyaret edin.

Bir API'ye en sevdiğiniz programlama dilinde erişmek istiyorsanız İstemci Kitaplıkları indirme sayfasını ziyaret edin.

Arka plan

Takvim ve E-Tablolar gibi çeşitli Google ürünleri, Google Veri Protokolü'nü temel alan API'ler sağlar. Geliştirici olarak bu API'leri, son kullanıcılara söz konusu Google ürünlerinde depoladığı verilere erişmeleri ve verileri değiştirmeleri için yeni yollar sağlayan istemci uygulamaları yazmak amacıyla kullanabilirsiniz.

Not: API'ler sağlayan Google ürünleri bazen bu ve ilgili dokümanlarda hizmet olarak anılır.

Doğrudan Google Veri Protokolü'nü kullanan bir kod yazarsanız söz konusu kod, GET veya POST gibi HTTP istekleri kullanarak API'ye erişir. Bu isteklerle birlikte, Google ürünü tarafından depolanan veriler, veri feed'leri biçiminde telin üzerinden karşılıklı olarak aktarılır. Veri feed'leri, verileri içeren yapılandırılmış listelerdir. Geçmişte, birincil feed biçimi AtomPub XML'siydi ancak artık JSON veya JavaScript Nesne Gösterimi de alternatif biçim olarak kullanılabilir.

Doğrudan HTTP isteklerinde bulunan kod yazmayı tercih etmiyorsanız istemci uygulamanızı, sağlanan istemci kitaplıkları grubunda bulunan programlama dillerinden birini kullanarak programlayabilirsiniz. Bunu yaptığınızda HTTP isteklerinin ayrıntıları istemci kitaplığı tarafından işlenir. Kodunuzu, istemci kitaplığı tarafından sağlanan dile özgü yöntemleri ve sınıfları kullanarak daha kavramsal bir düzeyde yazarsınız.

API veya kullandığınız API sürümü için kullanılabilen belirli diller hakkında daha fazla bilgi için ürüne özel belgelere bakın.

Protokol sürümleri

Protokol Sürümü 2.0 - Protokol Sürümü 1.0

Google Veri Protokolü'nün ilk sürümü, Atom Yayınlama Protokolü kesinleşmeden önce geliştirilmiştir. Google Veri Protokolü'nün ikinci sürümü, AtomPub RFC 5023 standardıyla tamamen uyumludur.

Google Veri Protokolü Sürüm 2.0 aşağıdakiler için de destek içermektedir:

  • HTTP EEtiketler. İstemci uygulamalarınızın HTTP önbelleğe alma özelliğini daha iyi kullanmasına yardımcı olan bir web standardı. Protokol v2.0'ı destekleyen istemci kitaplıklarına dahil olan hizmetler, ETag'leri otomatik olarak işler.
  • Kısmi Yanıt ve Kısmi Güncelleme (Deneysel). Daha az veri aktaran isteklerde bulunmanıza olanak tanıyan özellikler. İstemci uygulamanız, gerçekten ihtiyacınız olan bilgileri isteyerek veya yalnızca değiştirmek istediğiniz verileri içeren güncellemeleri göndererek ağ, CPU ve bellek kaynaklarını çok daha verimli bir şekilde kullanabilir. Kısmi yanıt ve kısmi güncelleme şu anda yalnızca bazı ürünler için kullanılabilir. API'nizin destekleyip desteklemediğini öğrenmek için ürüne özel belgelere göz atın.

Başvurunuz güncelleniyor

Kullandığınız API, protokolün en son sürümü temel alınarak oluşturulmuşsa Protokol v2.0 işlevi dokümanlarına dahil edilmiştir. Genel olarak, istemci uygulamanızı API'niz için mevcut en son sürüme yükseltmenizi öneririz.

İstemci kitaplığı tabanlı bir istemciyi güncelleme

İstemci uygulamanız Java istemci kitaplığı veya .NET istemci kitaplığı gibi bir istemci kitaplığı kullanıyorsa API'nin v2.0 özelliklerini destekleyen bir sürümünü içerebilir. Bunu öğrenmek için, aşağıdaki iki sorunun da doğru olup olmadığını öğrenmek amacıyla kullandığınız Google ürününün API dokümanlarını inceleyin:

  • Google Veri Protokolü v2.0 özelliklerini destekleyen bir API sürümü mevcuttur.
  • Kullandığınız istemci kitaplığı da bu API sürümünü destekliyor.

İstemci kitaplığı destekliyorsa ve mevcut uygulamanızı güncellemek istiyorsanız istemci kitaplığının en son sürümünü indirip kullanın. Kodunuzun tamamı çalışmaya devam eder ve arka plandaki v2.0 Protokolü değişikliklerini istemci kitaplığı halleder.

Ham HTTP istemcisini güncelleme

İstemci uygulamanızı doğrudan Google Veri Protokolü'nü kullanarak yazdıysanız şu değişiklikleri yapmanız gerekir:

  • Varsayılan olmayan sürüm istekleri. Gönderdiğiniz her HTTP isteğine HTTP sürüm başlığı (GData-Version: X.0) ekleyin. Burada X, Google Veri Protokolü v2.0 özelliklerini destekleyen API sürümüdür. Alternatif olarak, her isteğin URL'sine bir sorgu parametresi (v=X.0) ekleyebilirsiniz. Buradaki X yine API'nin doğru sürümüdür. Daha yeni bir sürüm belirtmezseniz istekleriniz, varsayılan olarak API'nin desteklenen en eski sürümüne gönderilir.
  • İyimser eşzamanlılık. İyimser eşzamanlılığı destekleyen bir API sürümü kullanıyorsanız ETag'leri kullanmak için güncellemenizi değiştirmeniz ve kodu silmeniz gerekebilir. Daha fazla bilgi edinmek için Google Veri Protokolü başvuru dokümanlarının ETag'ler bölümünü ve istemci uygulamanızın kullandığı hizmet için Protokol geliştirici kılavuzunun Güncelleme ve Silme bölümlerini okuyun.
  • URI'leri yönetin veya düzenleyin. İstemciniz, özet akışları veya girişler için kendi kendine izleme veya URI'larını düzenliyorsa bu URI'lerin değişmiş olabileceğini unutmayın. Yeni URI'yi almak için eski URI'yi kullanarak öğeyi yeniden isteyin ancak isteği sürüm X.0 isteği olarak işaretleyin. Buradaki X, Google Veri Protokolü v2.0 özelliklerini destekleyen API sürümüdür. Sunucu, eski URI'lerin yerine depolayabileceğiniz yeni URI'ler de dahil olmak üzere girişin yeni temsilini döndürür.
  • Ad alanı URI'leri. İstemciniz Google Data Protocol API ad alanı URI'lerini yerel olarak depoluyorsa veya sabit kodluysa bunları güncellemeniz gerekir:
    • AtomPub ad alanı (app ön eki) http://purl.org/atom/app iken http://www.w3.org/2007/app olarak değiştirildi.
    • OpenSearch ad alanı (önek openSearch) http://a9.com/-/spec/opensearchrss/1.0/ iken http://a9.com/-/spec/opensearch/1.1/ olarak değiştirildi.