Projeleri Yönetme

Bu bölümde, Apps Script projelerinizi oluşturmak, okumak, değiştirmek ve izlemek için kullanabileceğiniz Apps Script API yöntemlerine genel bir bakış sunulmaktadır. Proje Yönetimi örnekleri sayfasında API yönetimi isteklerine dair örnekler gösterilir. Her yöntemin referans dokümanında uygulama ayrıntıları sağlanır.

API yöntemine genel bakış
Proje oluşturma

projects.create

Sonuçlar: Proje dosyası ve varsayılan proje manifesti içermeyen temel, boş bir proje oluşturun.

Seçenekler: Proje başlığı girebilirsiniz. Ayrıca, komut dosyasının üst öğesi olarak görev yapacak bir Google Dokümanlar, Google E-Tablolar, Google Formlar veya Slaytlar dosyasının Google Drive kimliğini sağlayarak bağlı komut dosyası da oluşturabilirsiniz.

Proje meta verilerini okuma

projects.get

Sonuçlar: Proje meta verilerini temsil eden bir Project nesnesi alır. Bu veriler arasında proje başlığı, komut dosyası kimliği, projeyi oluşturan kullanıcı, projeyi oluşturma zamanı ve diğer ayrıntılar bulunur.

Proje içeriğini okuma

projects.getContent

Sonuçlar: Projedeki her kod ve HTML dosyası için birer File sınıfı nesnesi döndürür. Liste, JSON dosyası olarak proje manifestini de içerir. Dosya nesneleri, dosyanın kaynak içeriğini (File.source) ve dosyada bulunan işlevlerin listesini (File.functionSet) gibi diğer meta verileri içerir.

Seçenekler: Sorgu parametresi ile içeriğin hangi sürümünün alınacağını belirtebilirsiniz.

Proje içeriğini güncelleme

projects.updateContent

Sonuçlar: Senaryo projesindeki dosya içeriğini değiştirir. Yeni içeriği File nesneleri dizisi olarak gönderirsiniz. Bu File nesnelerinden biri JSON türüne sahip olmalı ve komut dosyası projesinin yeni proje manifestini temsil etmelidir. Yeni içerik, projenin HEAD sürümü olarak Komut dosyası tetikleyici olarak, komut dosyası düzenleyicide, eklenti önizleme modunda veya geliştirme modunda web uygulaması ya da Apps Komut Dosyası API'si olarak yürütüldüğünde kullanılır.

Not: Komut dosyası proje içeriği güncellenirken yaygın uygulama, mevcut File dizisini almak için önce bir projects.getContent isteğinde bulunmak, bu nesnelere istenen işlemleri yapmak ve ardından File'leri bir projects.updateContent isteği için giriş olarak kullanmaktır.

Uyarı: Yeni içerik, komut dosyası projesindeki tüm mevcut dosyaları değiştirir. İstekte bulunulan dosyaların güncellenmediği durumlarda bu dosyalar kaldırılır.

Proje metriklerini okuma

projects.getMetrics

Sonuçlar: Bir projeyle ilgili belirli metrikleri okuyun. Bu metrikler arasında kullanıcı sayısı, toplam çalıştırma sayısı, toplam yürütme hatası sayısı ve diğer ayrıntılar bulunur. İstediğiniz bilgileri belirtmek için bir MetricType kullanın.

Seçenekler: MetricsFilter kullanarak sonuçları belirli dağıtımlara veya komut dosyası işlevlerine göre kısıtlayın. Ayrıca MetricsIntervalConfig kullanarak belirli bir metrik aralığı da tanımlayabilirsiniz.