Apps Komut Dosyası, size ve diğer geliştiricilere komut dosyaları, eklentiler ve web uygulamaları oluşturmanıza ve bunları birlikte yönetmenize yardımcı olan bazı özellikler sunar.
Ortak çalışmayla ilgili temel bilgiler
Bir projede ortak çalışmak için sizin ve ortak çalışanlarınızın Apps Script proje dosyasına (ve bağlı komut dosyası ise kapsayıcısına) düzenleyici erişimi olması gerekir. Bu sayede ekibinizdeki herkes Apps Komut Dosyası kodunu görebilir ve değişiklik yapabilir. Düzenleyiciler ayrıca yeni kod sürümleri oluşturabilir, eklentiler yayınlayabilir ve komut dosyalarını web uygulamaları veya Apps Script API için yürütülebilir dosyalar olarak dağıtabilir.
Projenizin, eklentinizin veya web uygulamanızın düzenleme, inceleme, sürüm oluşturma ve (varsa) dağıtım ve yayınlama işlemlerini nasıl yapacağınızı önceden planlayarak ekibinize yardımcı olabilirsiniz. Bağımsız projeler, doğrudan Google Drive'da göründükleri ve eklenti ile web uygulaması geliştirme için önerilen proje türü olduklarından genellikle birlikte çalışmanın en kolay yoludur.
Ortak çalışmada sık karşılaşılan bir sorun, komut dosyası projesinin sahibi projenin sahipliğini ekipteki başka bir kullanıcıya aktarmadan ekipten ayrıldığında ortaya çıkar. Bu durum, projeyi sürdürememenize veya güncellemenize engel olabilir. Ortak Drive'daki dosyaların belirli sahipleri olmadığı için komut dosyası projenizi bir ortak Drive'a yerleştirmek bu sorunu önler.
clasp komut satırı aracını kullanarak ortak çalışma
clasp, projeleri script.google.com ile yerel dosya sisteminiz arasında senkronize etmenizi sağlar. Bu sayede, siz ve ortak çalışanlarınız git gibi kaynak kontrolü yönetimi yazılımları kullanıyorsanız kod geliştirme sürecinizi kolaylaştırabilir ve otomatikleştirebilirsiniz.
Daha fazla bilgi için clasp komutunu kullanarak Komut Satırı Arayüzü kılavuzunu inceleyin.
Ortak Drive'larla ortak çalışın
Ortak Drive'lar (eski adıyla "Ekip Drive'ları"), Drive kullanıcısı gruplarının daha verimli bir şekilde ortak çalışabileceği bir Google Drive alanı sağlar. Ortak drive'a yerleştirilen dosyaların sahibi bireysel değil, grubun tamamına aittir. Bu, ortak çalışanlar gruptan ayrıldığında dosya sahipliğini ve kontrolünü de beraberinde götürmez.
Ortak Drive'lar, alanları arasında dosya taşımanıza da olanak tanır. Bir alandaki ortak Drive'da, başka bir alandan ortak Drive'lar, ilgili alandan ortak Drive'a dosya taşıyabilir. Bu özellik, ekibin farklı alanlardaki müşteriler için eklentiler, web uygulamaları veya başka kodlar geliştirmesine olanak sağladığından Apps Komut Dosyası geliştiricileri için son derece değerli olabilir.
Apps Komut Dosyası projelerinde ortak çalışmak için ortak Drive'ları kullanırken aşağıdakileri göz önünde bulundurun:
- Ortak Drive'a düzenleyen erişimi olan ortak çalışanlar, ortak Drive'da yeni dosya oluşturabilir veya ortak Drive'a dosya taşıyabilir. Komut dosyası düzenleyicileri, komut dosyası projelerini görüntüleyip düzenleyebilir, komut dosyası kodunu çalıştırabilir, yeni komut dosyası sürümleri oluşturabilir ve eklentiler yayınlayabilir.
- Komut dosyalarını Apps Script API için web uygulaması veya yürütülebilir dosya olarak dağıtmak istiyorsanız dağıtımı oluşturan hesabın, komut dosyasının bulunduğu paylaşılan sürücüyle aynı alana ait olması gerekir.
- Ortak Drive'lar, ortak Drive'daki belirli dosyaları grup dışındaki kullanıcılarla paylaşmanıza ve bu dosyalardaki düzenleme ve görüntüleme izinlerini diğer Drive dosyalarında olduğu gibi güncellemenize olanak tanır. Ancak, bir kullanıcı ortak Drive'ın ait olduğu ekibin bir üyesiyse bu kullanıcının belirli dosyalara erişimini azaltamazsınız. Örneğin, bir kullanıcının ortak Drive'a düzenleme erişimi varsa bu erişimi, ortak Drive'daki belirli bir dosya için salt görüntüleme erişimine dönüştüremezsiniz.
- Ortak Drive'a tam erişimi olan ortak çalışanlar, dosyaları ve Apps Script projelerini silebilir, ayrıca dosyaları ortak Drive'dan başka bir yere taşıyabilir.
- Tüm kapsayıcıya bağlı komut dosyaları, kapsayıcı dosyası için tanımlanan aynı görüntüleyen ve düzenleyici erişim listelerini kullanır. Örneğin, bir Google E-Tablosu'nda düzenleme erişiminiz varsa bu e-tabloya bağlı tüm Apps Script proje kodlarında da düzenleme erişiminiz olur. Bu tür bir kapsayıcı dosyasını ortak Drive'a yerleştirdiğinizde, ortak Drive'ın ortak çalışanları, komut dosyası koduna kapsayıcıyla aynı erişime sahip olur.
- Bir komut dosyası projesi ortak Drive'da yer aldığında, projenin Cloud Platform (GCP) projesine erişim kısıtlanabilir. Ayrıntılar için GCP projeleri ve ortak Drive'lar kılavuz bölümünü inceleyin.
- Bir alanda dağıtılan web uygulamaları, sahiplikleri farklı bir alandaki paylaşılan bir Drive'a veya hesaba değişirse çalışmayı durdurur. Bu sorun, komut dosyasını orijinal alanına geri taşıyarak düzeltilebilir.
- Benzer şekilde, Apps Script API yürütülebilir dosyası olarak dağıtılan komut dosyası projeleri, ortak Drive üzerinden bir alandan diğerine taşınırsa API tarafından çağrıldığında çalışmayı durdurur. Bu durum, komut dosyası orijinal alanına geri taşınarak düzeltilebilir.
Paylaşılan bir klasörle ortak çalışma
Ortak Drive'da ortak çalışma yapamıyorsanız bunun yerine ortak klasör kullanabilirsiniz. Bir Apps Komut Dosyası projesi oluşturduğunuzda veya diğer kullanıcıların erişebileceği bir Google Drive klasörüne taşıdığınızda, bu kullanıcılar klasör için sahip oldukları Apps Komut Dosyası projesine erişimi devralır. Örneğin:
- Klasöre düzenleme erişimi olan kullanıcılar, Apps Komut Dosyası projesini düzenleyebilir veya silebilir ve komut dosyasını çalıştırabilir.
- Klasöre yalnızca görüntüleme erişimi olan kullanıcılar Apps Script projesini görüntüleyebilir ve komut dosyasını çalıştırabilir.
Proje paylaşımıyla ortak çalışma
Projeyi doğrudan tüm ortak çalışanlarla paylaşarak proje üzerinde ortak çalışma yapabilirsiniz. Normal Google Drive klasörlerinde veya ortak Drive'larda bulunan komut dosyası projelerini doğrudan paylaşabilirsiniz. Bu yöntemi kullanıyorsanız komut dosyasının sahibinin ve zaman içinde komut dosyasını kimin yöneteceğini dikkatlice planlamanız önerilir.
Bağımsız projeler, Google Drive'ınızda dosya olarak görünür ve diğer dosyalar gibi paylaşabilirsiniz. Daha fazla bilgi için Dosya ve klasör paylaşımı başlıklı makaleyi inceleyin.
Kapsüllere bağlı projeler Google Drive'ınızda görünmez. Kapsayıcıya bağlı bir projeyi paylaşmak için üst kapsayıcı dosyasını paylaşın. Örneğin, bir Google E-Tablolar e-tablosuna bağlı bir komut dosyanız varsa kullanıcıyı e-tablonun düzenleyicisi yaparak komut dosyasının da düzenleyicisi yapabilirsiniz. Kapsüllere bağlı projeler, kapsayıcı dosyalarının görüntüleyen ve düzenleyici erişim ayarlarını devralır.
Kapsayıcıya bağlı tüm komut dosyaları, kapsayıcı dosyası için tanımlanan aynı sahip, görüntüleyen ve düzenleyici erişim listesini kullanır. Kapsayıcı sahibi, yeni bir komut dosyası projesinin sahibi olur.
İş birliği ve proje kaynakları
Kaynaklar, projenizle ilişkili ancak kodundan bağımsız olarak var olan öğelerdir. Bu bölümde, bir projede ortak çalışmanın kaynakları (özellikle Cloud Platform projesi, tetikleyiciler, kitaplıklar ve kullanıcı mülkleri) nasıl etkilediği açıklanmaktadır.
Ortak çalışma ve Google Cloud projeleri
Her Apps Komut Dosyası projesinin ilişkili bir Google Cloud projesi vardır. Google Cloud projelerinin kendi sahip, düzenleyici ve diğer rolleri vardır. Bu roller, komut dosyası projesine erişebilen kullanıcılardan farklı olabilir.
Komut dosyası projenizin eklenti olarak yayınlanması gerekiyorsa standart bir Google Cloud projesi kullanmalıdır. Standart bir Google Cloud projesi kullanan bir uygulamada ortak çalışma yaparken, ortak çalışanlarınızın tümünün uygun erişim düzeylerine sahip olmasını sağlamak için Google Cloud sahiplerini ve rollerini yapılandırmanızı öneririz. Bu sayede, projenin sahipleri artık kuruluşunuzda olmadığı için projenin Cloud ayarlarına erişimi kaybetmeniz gibi durumları önleyebilirsiniz. Bu durum, özellikle eklentiler için önemlidir.
Ortak çalışma ve tetikleyiciler
Bir proje üzerinde ortak çalışma yaparken, oluşturduğunuz yüklenebilir tetikleyiciler projenize erişimi olanlarla paylaşılmaz. Tüm ortak çalışanlar için tutarlı bir tetikleyici ayarına ihtiyacınız varsa tetikleyicileri çalışma zamanında programatik olarak oluşturmak için Komut dosyası hizmetini kullanabilirsiniz. Daha fazla bilgi için Tetikleyicileri Programatik Olarak Yönetme başlıklı makaleyi inceleyin.
Ortak çalışma ve kitaplıklar
Projenize dahil edilen kitaplıklar, proje ortak çalışanları tarafından kullanılabilir. Ancak, dahil edilen bir kitaplığa en az okuma düzeyinde erişimi yoksa bu kitaplıkları kullanamaz. Bu durumda komut dosyası hata verir. Kitaplıklar hakkında daha fazla bilgi için Kitaplıkları yönetme başlıklı makaleyi inceleyin.
Ortak çalışma ve kullanıcı özellikleri
Kullanıcı özellikleri, bunları oluşturan kullanıcıya özgüdür. Bu durumda, projedeki ortak çalışanlar kullanıcı mülklerinizi göremez veya bunlara erişemez, siz de onların kullanıcı mülklerine erişemezsiniz. Projeye özgü özellikleri ortak çalışanlarla paylaşmak istiyorsanız komut dosyası özelliklerini kullanın. Daha fazla bilgi için Tesisler rehberine göz atın.