Projeleri yönetme

Bu bölümde, Google Apps Komut Dosyası projelerinizi oluşturmak, okumak, değiştirmek ve izlemek için kullanabileceğiniz Google Apps Komut Dosyası API yöntemlerine genel bir bakış sunulmaktadır. Proje Yönetimi örnekleri sayfasında API yönetimi 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 bir boş 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 Google 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, Google Workspace eklentisi ö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ı projesi içeriğini güncellemek için önce projects.getContent isteği göndererek mevcut File dizisini alın, bu nesnelerde istediğiniz değişiklikleri yapın, ardından File'leri projects.updateContent isteği için giriş olarak kullanın.

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 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 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.