Kitaplıklar

Kitaplık, işlevleri diğer komut dosyalarında yeniden kullanılabilecek bir komut dosyası projesidir.

Bir kitaplığa erişim elde etme

Projenize bir kitaplık eklemek için en az görüntüleme düzeyine sahip olmanız gerekir erişebilir. İstediğiniz kitaplığın yazarı değilseniz yazarla iletişim kurun ve erişim isteyin.

Dahil etmek istediğiniz kitaplığın komut dosyası kimliğine ihtiyacınız vardır. komut dosyası kimliğini Proje Ayarları bölümünde bulabilirsiniz sayfa.

Komut dosyası projenize kitaplık ekleyin

  1. Apps Komut Dosyası düzenleyicisinin solunda, "Kitaplıklar"ın yanında Ekle'yi tıklayın. kitaplığı.
  2. "Komut dosyası kimliği"nde alanına, kitaplığın komut dosyası kimliğini yapıştırın.
  3. Ara'yı tıklayın.
  4. Sürüm açılır menüsünü tıklayıp kitaplık sürümünü seçin tıklayın.
  5. Varsayılan "Tanımlayıcı"nın istediğiniz adı bu kitaplıkla kullanabilirsiniz. Bu, komut dosyanızın Google Ads'deki kitaplığına başvurur. Örneğin, bu değeri Test olarak ayarlarsanız söz konusu kitaplığın bir yöntemini şu şekilde çağırabilirsiniz: Test.libraryMethod().
  6. Ekle'yi tıklayın.

Kitaplık kullanma

Dahil edilen kitaplığınızı, varsayılan bir hizmet gibi kullanın. Örneğin, Örneğin, Test kitaplığınızın tanımlayıcısıysa Test hemen ardından bir nokta işaretiyle kitaplıktaki yöntemlerin listesini görüntüleyin.

Dahil edilen kitaplığa ait referans belgeleri aşağıdaki bağlantıdan açılabilir: şu adımları uygulayın:

Komut dosyası düzenleyicinin solunda, kitaplık adının yanındaki Diğer'i tıklayın. > Yeni sekmede açın.

Kitaplığı kaldırma

Komut dosyası düzenleyicinin sol tarafında, kitaplık adının yanındaki Diğer > Kaldır > Kitaplığı kaldır'ı tıklayın.

Kitaplığı güncelleme

Kitaplığın sürümünü değiştirebilir veya tanımlayıcısını güncelleyebilirsiniz.

  1. Editörün sol tarafındaki "Kütüphaneler"in altında kitaplığın adını tıklayın.
  2. Değişiklikleri yapıp Kaydet'i tıklayın.

Kitaplık oluşturma ve paylaşma

Komut dosyası projenizi kitaplık olarak kullanmak ve paylaşmak için aşağıdaki adımları uygulayın.

  1. Sürümü olan dağıtım oluşturma oluşturun.
  2. En azından görüntüleme düzeyinde erişimi, kitaplığın tüm potansiyel kullanıcılarıyla paylaşın.
  3. Bu kullanıcılara, Proje Ayarlar sayfası.

En iyi uygulamalar

Kitaplık yazarken uymanız gereken bazı kurallar şunlardır:

  1. Projeniz için anlamlı bir ad seçin çünkü varsayılan tanımlayıcıdır.
  2. Komut dosyanızdaki bir veya daha fazla yöntemin görünür olmasını istemiyorsanız (veya kullanılabilir) kullanıyorsanız, yöntemin adını alt çizgi. Örneğin, myPrivateMethod_().
  3. Kitaplık kullanıcıları yalnızca numaralandırılabilir genel özellikleri görebilir. Buna, fonksiyon bildirimleri, var ile işlevin dışında oluşturulan değişkenler ve özellikler açıkça ayarlanmış çift tıklayın. Örneğin, enumerable öğesine sahip Object.defineProperty(), false olarak ayarlanmıştır , kitaplığınızda kullanabileceğiniz bir simge oluşturuyor, ancak kullanıcılarınız bu simgeye erişemiyor.
  4. Kitaplığınızdaki kullanıcılarınızın, komut dosyası düzenleyicinin otomatik tamamlama ve dokümanları oluşturmak için JSDoc stilinde tüm işlevlerinizle ilgili dokümanlar da mevcuttur. Aşağıda bununla ilgili bir örnek verilmiştir:

    /**
     * Raises a number to the given power, and returns the result.
     *
     * @param {number} base the number we're raising to a power
     * @param {number} exp the exponent we're raising the base to
     * @return {number} the result of the exponential calculation
     */
    function power(base, exp) { ... }
    

Kaynak kapsamı

Kitaplıklarla çalışırken iki tür kaynak vardır: paylaşılan ve paylaşılmaz. Paylaşılan kaynak, hem kitaplığın hem de kapsayıcıdaki komut dosyasının aynı kaynak örneğine yerleşik erişimi vardır. İlgili içeriği oluşturmak için kullanılan aşağıdaki şemada paylaşılan kaynak örneği kullanılarak Kullanıcı Özellikleri:

Paylaşılan Kaynak

Paylaşılmayan kaynak, hem kitaplığın hem de dahil olan komut dosyasının yerleşik erişimleri vardır. Ancak kütüphaneler sahip olduğu açık işlevler sayesinde, paylaşılmayan kaynaklara yardımcı olmaktır. Bu örnekte, komut dosyası özelliklerini görmek için kitaplığınızın her yerinden açın:

  function getLibraryProperty(key) {
    return ScriptProperties.getProperty(key);
  }

Aşağıdaki şemada, Komut Dosyası Özellikleri:

Paylaşılmayan Kaynak

Referans olması amacıyla, paylaşılan ve paylaşılmayan kaynaklar aşağıdaki tabloda listelenmiştir:

Kaynak Paylaşıldı* Paylaşılmayan** Notlar
Kilitle Aynı örnek, emin olmanız gerekir.
Komut Dosyası Özellikleri Aynı örnek, emin olmanız gerekir.
Önbellek Aynı örnek, emin olmanız gerekir.
Tetikleyiciler Kitaplıkta oluşturulan basit tetikleyiciler aşağıdakiler tarafından tetiklenmez: komut dosyası.
ScriptApp
UiApp
Kullanıcı Özellikleri
Günlük kaydedici ve yürütme dökümü
Sites, E-Tablolar ve diğer kapsayıcılar getActive() için yapılan bir çağrı, bazı bilgiler var.
MailApp ve GmailApp
* Bu, kitaplığın kendisine ait bir özelliği/kaynak olduğunu tespit edip komut dosyası tarafından oluşturulan bir şeydir.
** Bu, kitaplığın kendi kaynak/özellik örneğinin olduğu anlamına gelir. ve kitaplığı kullanan tüm komut dosyalarının bu komut dosyalarına erişmesini anlamına gelir.

Kitaplığı test etme

Kitaplığınızı test etmek için başlık dağıtımını kullanın. Düzenleyici düzeyinde sahip olan herkes komut dosyasına erişmek için "head" dağıtımını kullanabilirsiniz.

Kitaplıkta hata ayıklama

Hata ayıklayıcıyı, mevcut kitaplığınız olan bir projede kullandığınızda dahil edilen kitaplığın bir işlevine geçebilir. Bu kod, hata ayıklayıcıyı salt görüntüleme modunda ve doğru sürümde çalıştırmalıdır.