Gelişmiş Google hizmetleri

Apps Komut Dosyası'ndaki gelişmiş hizmetler, deneyimli geliştiricilerin herkese açık belirli Google API'lerini HTTP arayüzlerine göre daha az kuruluma tabi tutabilirler. Gelişmiş hizmetler, temelde bu Google API'lerinin etrafında yer alan ince sarmalayıcılardır. Onlar ve Google Apps Komut Dosyası'nın yerleşik hizmetler (örneğin, otomatik tamamlamayı sağlar ve Apps Komut Dosyası, yetkilendirme akışını otomatik olarak devre dışı bırakabilirsiniz. Ancak bunu yapmadan önce gelişmiş bir hizmeti etkinleştirmeniz gerekir ve komut dosyasında kullanabilirsiniz.

Hangi Google API'lerinin gelişmiş hizmet olarak kullanılabildiğini görmek için şuraya bakın: Gelişmiş Google Hizmetleri bölümü Referans. Aşağıdaki özelliklere sahip bir Google API'si hizmeti olarak kullanılamaz. Diğer herhangi bir hizmet olarak bağlanmanız harici API.

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 API isteklerini doğrudan UrlFetch.

Gelişmiş hizmet yöntemini kullanırsanız Apps Komut Dosyası, yetkilendirme akışı ve teklifler otomatik tamamlama desteği. Ancak şunu yapmanız gerekir: Google hizmetlerini kullanmaya başlamadan önce gelişmiş hizmeti etkinleştirin somut olarak ortaya koyar. Ayrıca bazı gelişmiş hizmetler, müşterilerin geri bildirim vermelidir.

API'ye doğrudan erişmek için UrlFetch yöntemini kullanıyorsanız Google API'sini, Google API'sini harici API. Bu yöntemde tüm bazı özellikleri kullanılabilir. Ancak bunun için API ile işlem yapmanız gerekir kendiniz yetkilendirebilirsiniz. Ayrıca, gerekli başlıkları oluşturmalı ve API yanıtları.

Genel olarak, mümkün olduğunda gelişmiş bir hizmeti kullanmak en kolay yöntemdir ve gelişmiş hizmet tarafından sağlanmadığında UrlFetch yöntemini kullanın. işlevlerinden yararlanabilirsiniz.

Şartlar

Gelişmiş bir hizmeti kullanabilmeniz için aşağıdaki şartları yerine getirmeniz gerekir koşullar:

  1. Gelişmiş hizmeti etkinleştirmeniz gerekir. inceleyebilirsiniz.

  2. Gelişmiş hizmete karşılık gelen API'nin etkinleştirildiğinden emin olmanız gerekir Cloud Platform (GCP) projesinde açıklayacağım.

    Komut dosyası projenizde varsayılan GCP projesi kullanılıyorsa API, 8 Nisan 2019 itibarıyla otomatik olarak etkinleştirilir. gelişmiş hizmeti etkinleştirip komut dosyası projesini kaydettikten sonra. Şu durumda: daha önce yapmadıysanız, şu soruları onayladı: Google Cloud ve Google API'leri Hizmet Şartları'na tabidir.

    Komut dosyası projenizde standart GCP projesi ya da daha eski bir varsayılan GCP projesi gelişmiş hizmetin ilgili API'sini etkinleştirmeniz gerekir inceleyebilirsiniz. GCP projesi için düzenleme erişiminiz olmalıdır yapmanız gerektiğini unutmayın.

Cloud Platform projelerini inceleyin konulu videomuzu izleyin.

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 aynı nesneleri, yöntem adlarını ve parametreleri kullanır karşılık gelen herkese açık API'ler olarak görünür, ancak yöntem imzaları Google Apps Komut Dosyası'nda kullanabilirsiniz. Komut dosyası düzenleyicisinin otomatik tamamlama işlevi genellikle başlangıç için yeterli bilgi sağlar. Ancak aşağıdaki kurallar, başlangıç için Apps Komut Dosyası'nın, herkese açık bir Google API'sinden nasıl yöntem imzası oluşturduğunu öğrenin.

Google API'lerine yapılan istekler farklı veri türlerini kabul edebilir. yol parametreleri, sorgu parametreleri, istek gövdesi ve/veya medya dahil ek yükleyin. Bazı gelişmiş hizmetler belirli HTTP isteklerini de kabul edebilir başlıkları (örneğin, Gelişmiş Takvim hizmeti).

Google Apps Komut Dosyası'ndaki ilgili yöntem imzası şu özelliklere sahiptir: bağımsız değişkenler:

  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. Medya yükleme eki (Blob olarak) bağımsız değişkeninin önüne geçer.
  4. İsteğe bağlı parametreler, değerler.
  5. Başlık adlarını başlığa göre eşleyen JavaScript nesnesi olarak HTTP istek başlıkları değerler.

Yöntem, belirli bir kategoride herhangi bir öğe içermiyorsa imza atlanır.

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

  • Medya yüklemesini kabul eden yöntemler için uploadType parametresi ayarlanır otomatik olarak oluşturur.
  • Google API'de delete adlı yöntemler Apps Komut Dosyası'nda remove olarak adlandırılır. çünkü delete, JavaScript'te ayrılmış bir kelimedir.
  • 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 tanımlarsanız, isteğe bağlı parametre JavaScript nesnesi (kullanmıyorsanız boş bir nesneye isteğe bağlı parametreler).

Gelişmiş hizmetler için destek

Gelişmiş hizmetler, Google Etiket Yöneticisi'nin kullanılmasını sağlayan Apps Komut Dosyası'ndaki API'ler. Bu nedenle, bu araçlar kullanılırken karşılaşılan sorunlar genellikle Apps Komut Dosyası'yla değil, temel API ile ilgili bir sorun vardır.

Gelişmiş bir hizmeti kullanırken bir sorunla karşılaşırsanız doğrudan temel alınan API'ye ilişkin destek talimatları kullanılarak raporlanır. Bu listeye bağlantılar destek talimatları, Apps Komut Dosyası Referans bölümüne göz atın.