Gelişmiş Google hizmetleri

Apps Komut Dosyası'ndaki gelişmiş hizmetler, deneyimli geliştiricilerin, belirli herkese açık Google API'lerine, HTTP arayüzlerini kullanmaya kıyasla daha az kurulumla bağlantı kurmasına olanak tanır. Gelişmiş hizmetler, temelde bu Google API'lerini çevreleyen ince sarmalayıcılardır. Bu uygulamalar, Apps Komut Dosyası'nın yerleşik hizmetlerine çok benzer. Örneğin, otomatik tamamlama özelliği sunarlar ve Apps Komut Dosyası, yetkilendirme akışını otomatik olarak yönetir. Ancak, bir komut dosyasında söz konusu hizmeti kullanabilmeniz için önce gelişmiş bir hizmeti etkinleştirmeniz gerekir.

Hangi Google API'lerinin gelişmiş hizmetler olarak kullanılabildiğini görmek için Referans'taki Gelişmiş Google Hizmetleri bölümüne bakın. Gelişmiş hizmet olarak kullanılamayan bir Google API'sini kullanmak istiyorsanız diğer herhangi bir harici API gibi bağlanmanı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ı işler ve otomatik tamamlama desteği sunar. Ancak, söz konusu hizmeti kullanabilmek için önce gelişmiş hizmeti etkinleştirmeniz gerekir. Ayrıca bazı gelişmiş hizmetler, API'de kullanılabilen işlevlerin yalnızca bir alt kümesini sağlar.

API'ye doğrudan erişmek için UrlFetch yöntemini kullanıyorsanız Google API'yi harici API olarak değerlendirmiş olursunuz. Bu yöntemle API'nin tüm yönleri kullanılabilir. Ancak API yetkilendirmesini sizin gerçekleştirmeniz gerekir. 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 kullanmak.

Koşullar

Gelişmiş bir hizmeti kullanabilmek için aşağıdaki gereksinimleri 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 tarihinde veya sonrasında oluşturulmuş bir varsayılan GCP projesi kullanıyorsa API, gelişmiş hizmeti etkinleştirmenizin ve komut dosyası projesini kaydetmenizin ardından otomatik olarak etkinleştirilir. Henüz yapmadıysanız Google Cloud ve Google API'leri Hizmet Şartları'nı kabul etmeniz de istenebilir.

    Komut dosyası projeniz standart GCP projesi veya daha eski bir varsayılan GCP projesi kullanı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 projelerine bakın.

Gelişmiş hizmetleri etkinleştir

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

  1. Apps Komut Dosyası projesini açın.
  2. Sol tarafta, Düzenleyici'yi tıklayın.
  3. Sol tarafta, 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 karşılık gelen herkese açık API'lerle aynı nesneleri, yöntem adlarını ve parametreleri kullanır ancak yöntem imzaları Apps Komut Dosyası'nda kullanılmak üzere çevrilir. Komut dosyası düzenleyicisinin otomatik tamamlama işlevi genellikle başlangıç için yeterli bilgi sağlar, ancak aşağıdaki kurallarda Apps Komut Dosyası'nın herkese açık bir Google API'sinden nasıl yöntem imzası oluşturduğu açıklanmaktadır.

Google API'lerine gönderilen istekler; yol parametreleri, sorgu parametreleri, istek gövdesi ve/veya medya yükleme eki gibi çeşitli veri türlerini kabul edebilir. Bazı gelişmiş hizmetler, belirli HTTP isteği üst bilgilerini de 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. Değerlere JavaScript nesne eşleme parametre adları olarak isteğe bağlı parametreler.
  5. Başlık değerleri ile JavaScript nesne eşleme başlık adları olarak HTTP istek üst bilgileri.

Yöntem, belirli bir kategoride hiçbir öğe içermiyorsa imzanın bu bölümü atlanır.

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

  • Medya yüklemesini 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 bir istek başlıkları JavaScript nesnesi ayarlarsanız isteğe bağlı parametreleri JavaScript nesnesi de ayarlamanız gerekir (isteğe bağlı parametre kullanmıyorsanız boş bir nesne olarak).

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. Dolayısıyla, bu API'leri kullanırken karşılaşılan herhangi bir sorun genellikle Apps Komut Dosyası'nın kendisinden değil, temel API'den kaynaklanır.

Gelişmiş bir hizmeti kullanırken sorunla karşılaşırsanız temel API'nin destek talimatları kullanılarak bu durum bildirilmelidir. Bu destek talimatlarının bağlantıları Apps Komut Dosyası Referans bölümündeki gelişmiş hizmet kılavuzlarının her birinde yer almaktadır.