Projeleri Yönetme

Bu bölümde, Apps Komut Dosyası 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 isteklerinin örnekleri gösterilmektedir. Her yöntemin referans belgelerinde uygulama ayrıntıları verilmiştir.

API yöntemine genel bakış
Proje oluşturma	projects.create Sonuçlar: Proje dosyası ve varsayılan proje manifesti içermeyen, temel ve boş bir proje oluşturun. Seçenekler: Bir proje başlığı girebilirsiniz. Ayrıca, komut dosyasının üst öğesi olması için Google Dokümanlar, Google E-Tablolar, Google Formlar veya Slaytlar dosyasının Google Drive kimliğini sağlayarak bağlı bir 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, kullanıcı oluşturma, oluşturma zamanı ve diğer ayrıntılar yer alır.
Proje içeriğini okuyun	projects.getContent Sonuçlar: Projedeki her kod ve HTML dosyası için bir File nesne dizisi döndürür. Liste, JSON dosyası olarak proje manifestini de içerir. Dosya nesneleri, dosyanın kaynak içeriğini (File.source) ve dosyadaki işlevlerin listesi (File.functionSet) gibi diğer meta verileri içerir. Seçenekler: Bir sorgu parametresiyle içeriğin hangi sürümünün alınacağını belirtebilirsiniz.
Proje içeriğini güncelleme	project.updateContent Sonuçlar: Bir komut dosyası projesindeki dosya içeriğini değiştirir. Yeni içeriği File nesne dizisi olarak sağlarsınız. 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 depolanır. Komut dosyası tetikleyici olarak, komut dosyası düzenleyicide, eklenti önizleme modunda veya geliştirme modunda web uygulaması ya da Apps Script API olarak çalıştırıldığında kullanılır. Not: Komut dosyası proje içeriğini güncellerken, ilk olarak mevcut File öğelerinden bir dizi almak için project.getContent isteği göndermek, bu nesnelerde istekte bulunmak, ardından File değerlerini project.updateContent isteği için girdi olarak kullanmak gerekir. Uyarı: Yeni içerik, komut dosyası projesindeki tüm mevcut dosyaların yerini alır. İstek üzerine güncellenmeyen dosyalar kaldırılır.
Proje metriklerini okuyun	project.getMetrics Sonuçlar: Bir projeyle ilgili belirli metrikleri okuyabilirsiniz. Bu metrikler arasında kullanıcı sayısı, toplam yürütme sayısı, yürütme hatalarının toplam sayısı ve diğer ayrıntılar yer alır. İstediğiniz bilgileri belirtmek için bir MetricType kullanın. Seçenekler: Bir Metrik Filtresi kullanarak sonuçları belirli dağıtımlarla veya komut dosyası işlevleriyle sınırlandırın. MetricsIntervalConfig kullanarak belirli bir metrik aralığı da tanımlayabilirsiniz.