Gelişmiş Google hizmetleri

Apps Komut Dosyası'ndaki gelişmiş hizmetler, deneyimli geliştiricilerin HTTP arayüzlerini kullanmaktan daha az kurulumla belirli herkese açık Google API'lerine bağlanmasını sağlar. Gelişmiş hizmetler, temelde bu Google API'lerinin etrafında yer alan ince sarmalayıcılardır. Apps Komut Dosyası'nın yerleşik hizmetleri gibi çalışırlar. Örneğin, otomatik tamamlama sunarlar ve Apps Komut Dosyası, yetkilendirme akışını otomatik olarak yönetir. Ancak, komut dosyasında kullanabilmek için bir gelişmiş hizmeti etkinleştirmeniz gerekir.

Hangi Google API'lerinin gelişmiş hizmet olarak kullanılabildiğini görmek için Referansta Gelişmiş Google Hizmetleri bölümüne bakın. Gelişmiş hizmet olarak sunulmayan bir Google API'sini kullanmak isterseniz ona diğer herhangi bir harici API gibi bağlamanız yeterlidir.

Gelişmiş hizmetler mi HTTP mi?

Gelişmiş Google hizmetlerinin her biri herkese açık bir Google API'si ile ilişkilendirilir. Apps Komut Dosyası'nda, bu API'lere gelişmiş hizmetler aracılığıyla veya doğrudan UrlFetch ile API istekleri oluşturarak erişebilirsiniz.

Gelişmiş hizmet yöntemini kullanıyorsanız Apps Komut Dosyası, yetkilendirme akışını yürütür ve otomatik tamamlama desteği sunar. Ancak, hizmeti kullanabilmek için gelişmiş hizmeti etkinleştirmeniz gerekir. Ayrıca bazı gelişmiş hizmetler, API'de bulunan işlevlerin yalnızca bir kısmını sunar.

API'ye doğrudan erişmek için UrlFetch yöntemini kullanıyorsanız Google API'yi harici API olarak kabul etmiş olursunuz. Bu yöntemle API'nin tüm özellikleri kullanılabilir. Ancak bu, API yetkilendirmesini sizin gerçekleştirmenizi gerektirir. Ayrıca gerekli başlıkları oluşturmanız ve API yanıtlarını ayrıştırmanız gerekir.

Genellikle en kolay yöntem, mümkün olduğunda gelişmiş bir hizmet kullanmak ve UrlFetch yöntemini yalnızca gelişmiş hizmet ihtiyacınız olan işlevi sunmadığında kullanmaktır.

Koşullar

Gelişmiş bir hizmeti kullanabilmeniz için aşağıdaki koşulları karşılamanız gerekir:

  1. Komut dosyası projenizde gelişmiş hizmeti etkinleştirmeniz gerekir.

  2. Komut dosyanızın kullandığı Cloud Platform (GCP) projesinde gelişmiş hizmete karşılık gelen API'nin etkinleştirildiğinden emin olmanız gerekir.

    Komut dosyası projeniz, 8 Nisan 2019'da veya sonrasında oluşturulmuş bir varsayılan GCP projesi kullanıyorsa gelişmiş hizmeti etkinleştirip komut dosyası projesini kaydetmenizin ardından API otomatik olarak etkinleştirilir. Henüz yapmadıysanız Google Cloud ve Google API'leri Hizmet Şartları'nı da kabul etmeniz istenebilir.

    Komut dosyası projenizde standart GCP projesi veya daha eski bir varsayılan GCP projesi kullanılıyorsa GCP projesinde gelişmiş hizmetin ilgili API'sini manuel olarak etkinleştirmeniz gerekir. Bu değişikliği yapmak için GCP projesinde düzenleme erişimine sahip olmanız gerekir.

Daha fazla bilgi için Cloud Platform projelerini inceleyin.

Gelişmiş hizmetleri etkinleştirme

Gelişmiş bir Google hizmetini kullanmak için aşağıdaki talimatları uygulayın:

  1. Apps Komut Dosyası projesini açın.
  2. Sol kısımdan Düzenleyici'yi tıklayın.
  3. Solda, Hizmetler'in yanındaki Hizmet ekle'yi tıklayın.
  4. Gelişmiş bir Google hizmeti seçin ve Ekle'yi tıklayın.

Gelişmiş bir hizmet etkinleştirildikten sonra otomatik tamamlamada kullanılabilir.

Yöntem imzaları nasıl belirlenir?

Gelişmiş hizmetler genellikle ilgili herkese açık API'lerle aynı nesneleri, yöntem adlarını ve parametreleri kullanır. Bununla birlikte, yöntem imzaları Apps Komut Dosyası'nda kullanılmak üzere çevrilir. Komut dosyası düzenleyicisinin otomatik tamamlama işlevi genellikle başlamak için yeterli bilgi sağlar ancak aşağıdaki kurallar Apps Komut Dosyası'nın herkese açık bir Google API'sinden nasıl yöntem imzası oluşturduğunu açıklamaktadır.

Google API'lerine yapılan istekler; yol parametreleri, sorgu parametreleri, istek gövdesi ve/veya medya yükleme eki gibi çeşitli farklı veri türlerini kabul edebilir. Bazı gelişmiş hizmetler, belirli HTTP istek başlıklarını da kabul edebilir (örneğin, Takvim gelişmiş hizmeti).

Google Apps Komut Dosyası'ndaki ilgili yöntem imzası için aşağıdaki bağımsız değişkenler bulunur:

  1. JavaScript nesnesi olarak istek gövdesi (genellikle bir kaynak).
  2. Bağımsız bağımsız değişkenler olarak yol veya gerekli parametreler.
  3. Blob bağımsız değişkeni olarak medya yükleme eki.
  4. İsteğe bağlı parametreler (JavaScript nesne eşleme parametresi adları olarak).
  5. Başlık adlarını başlık değerleriyle eşleştiren bir JavaScript nesnesi olarak HTTP istek başlıkları.

Yöntemde belirli bir kategoride herhangi bir öğe yoksa imzanın söz konusu bölümü atlanır.

Dikkat edilmesi gereken bazı özel istisnalar vardır:

  • Medya yüklemeyi kabul eden yöntemler için uploadType parametresi otomatik olarak ayarlanır.
  • delete, JavaScript'te ayrılmış bir kelime olduğundan Google API'de delete adlı yöntemler Apps Komut Dosyası'nda remove olarak adlandırılmıştır.
  • Gelişmiş bir hizmet, HTTP istek başlıklarını kabul edecek şekilde yapılandırılmışsa ve istek başlıkları JavaScript nesnesini ayarlarsanız isteğe bağlı parametreler JavaScript nesnesini de (isteğe bağlı parametre kullanmıyorsanız boş bir nesne olarak) ayarlamanız gerekir.

Gelişmiş hizmetler için destek

Gelişmiş hizmetler, Apps Komut Dosyası'nda Google API'lerinin kullanılmasına olanak tanıyan ince sarmalayıcılardır. Bu nedenle, bu araçları kullanırken karşılaşılan sorunlar Apps Komut Dosyası'yla değil, genellikle temel alınan API'den kaynaklanmaktadır.

Gelişmiş bir hizmeti kullanırken sorunla karşılaşırsanız ilgili API'nin destek talimatları aracılığıyla bu durumu bildirmeniz gerekir. Bu destek talimatlarının bağlantıları, Apps Komut Dosyası'nın Referans bölümündeki her gelişmiş hizmet rehberinde sağlanmıştır.