Projeleri Yönetme

Bu bölümde, Apps Komut Dosyası projelerinizi oluşturmak, okumak, değiştirmek ve izlemek için kullanabileceğiniz Apps Komut Dosyası API yöntemlerine genel bir bakış sunulmaktadır. Proje Yönetimi örnekleri sayfasında API yönetim istekleriyle ilgili örnekler gösterilir. Her yöntemin referans belgelerinde uygulama ayrıntıları yer alır.

API yöntemine genel bakış
Proje oluşturma	projects.create Sonuçlar: Proje dosyası içermeyen ve varsayılan proje manifestosu olan temel, boş bir proje oluşturun. Seçenekler: Proje başlığı sağlayabilirsiniz. Ayrıca, komut dosyasının üst öğesi olarak kullanılacak bir 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 nesnesini alır. Bu veriler arasında proje başlığı, komut dosyası kimliği, oluşturma kullanıcısı, oluşturma zamanı ve diğer ayrıntılar yer alır.
Proje içeriğini okuma	projects.getContent Sonuçlar: Projedeki her kod ve HTML dosyası için bir tane olmak üzere File nesnelerinden oluşan bir dizi döndürür. Liste, proje manifestini JSON dosyası olarak da 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: Sorgu parametresiyle 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 sağlarsınız. Bu File nesnelerinden biri JSON türünde olmalı ve komut dosyası projesinin yeni proje manifestosunu temsil etmelidir. Yeni içerik, projenin HEAD sürümü olarak saklanır. Komut dosyası tetikleyici olarak, komut dosyası düzenleyicide, eklenti önizleme modunda veya geliştirme modunda bir web uygulaması ya da Apps Komut Dosyası API'si olarak yürütüldüğünde kullanılır. Not: Komut dosyası projesi içeriğini güncellerken, önce mevcut File dizisini almak için projects.getContent isteği göndermek, bu nesnelerde değişiklik yapmak ve ardından File'leri projects.updateContent isteği için giriş olarak kullanmak yaygın bir uygulamadır. Uyarı: Yeni içerik, komut dosyası projesindeki tüm mevcut dosyaların yerini alır. İstekle güncellenmeyen dosyalar kaldırılır.
Proje metriklerini okuma	projects.getMetrics Sonuçlar: Bir projeyle ilgili belirli metrikleri okuma 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 yer alır. İstediğiniz bilgileri belirtmek için MetricType kullanın. Seçenekler: MetricsFilter kullanarak sonuçları belirli dağıtımlarla veya komut dosyası işlevleriyle kısıtlayın. Ayrıca MetricsIntervalConfig kullanarak belirli bir metrik aralığı da tanımlayabilirsiniz.