Google Cloud projeleri

Her Apps Komut Dosyası projesinde yetkilendirme, gelişmiş hizmetler ve diğer ayrıntılar Google Cloud tarafından yönetilir. Bu ayarları yapılandırmak ve yönetmek için her Apps Komut Dosyası projesinin ilişkili bir Google Cloud projesi vardır. Komut dosyası projenizde, Apps Komut Dosyası'nın otomatik olarak oluşturduğu bir varsayılan proje veya kendiniz oluşturduğunuz bir standart proje kullanabilirsiniz. Varsayılan projeler genel olarak günlük veya basit komut dosyaları için iyidir ancak karmaşık, ticari kalitede veya yayınlamayı düşündüğünüz uygulamalar için standart bir proje kullanmanız gerekir.

İstediğiniz zaman varsayılan projeden standart projeye geçebilirsiniz ancak varsayılan projeyi kullanmaya geri dönemezsiniz. Komut dosyanızın kullanacağı Bulut projesini geliştirmenin başlarında seçmeniz önerilir. Daha sonra geçiş yapmak, kullanıcılarınızın yeniden yetkilendirme yapması gibi komplikasyonlara neden olabilir.

Varsayılan Cloud projeleri

Apps Komut Dosyası projesi oluşturduğunuzda, arka planda çalışan varsayılan bir Cloud projesi oluşturulur.

• Çoğu komut dosyası için bu varsayılan projeyi görmenize veya düzenlemenize gerek yoktur. Apps Komut Dosyası, Google Cloud ile gerekli etkileşimleri yönetir. Örneğin, Apps Komut Dosyası düzenleyicisinde bir gelişmiş hizmeti etkinleştirirseniz Apps Komut Dosyası, komut dosyası projesini kaydettiğinizde varsayılan Cloud projesinde gelişmiş hizmeti etkinleştirir.
• Bazı komut dosyalarında Google Cloud Console ile etkileşim kurmanız gerekir. Bu durumlarda, komut dosyanızda standart bir Cloud projesi kullanılmalıdır. Örneğin, Google Cloud günlüklerini Google Cloud Console'da görüntülemek için komut dosyanızın standart bir proje kullanması gerekir.

Cloud projeleri varsayılan olarak bir giriş içeren bir Identity and Access Management (IAM) politikasına sahiptir. Bu giriş, varsayılan projenin sahibi olarak çalışan bir Google hizmet hesabıdır. Google hizmet hesabı appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Varsayılan Cloud projelerini görüntüleme veya güncelleme

Çoğu kullanıcı, Google Cloud Console'da varsayılan projeleri doğrudan bulamaz, görüntüleyemez veya düzenleyemez. Yöneticiyseniz Varsayılan Google Cloud projelerini görüntüleme başlıklı makaleyi inceleyin.

Komut dosyası projenizi 8 Nisan 2019'dan önce oluşturduysanız Google Cloud Console'da erişebileceğiniz varsayılan bir proje kullanabilirsiniz. Varsayılan projeye erişmek için komut dosyası projesinin ayarlarına gidin ve proje numarasını tıklayın.

Varsayılan Cloud projelerini silme

Yöneticiyseniz varsayılan Cloud projelerini standart Cloud projelerini sildiğiniz gibi silebilirsiniz. Apps Komut Dosyası Cloud projelerini silme başlıklı makaleyi inceleyin.

Yönetici değilseniz varsayılan projeleri silemezsiniz. Ancak Apps Komut Dosyası, varsayılan projeleri aşağıdaki senaryolarda siler:

• Komut dosyası projesini silerseniz veya standart bir proje kullanmaya geçerseniz Apps Komut Dosyası, komut dosyasına bağlı varsayılan projeyi ve içerdiği tüm ayarları veya bilgileri siler.
• Bir komut dosyası 180 gün veya daha uzun süre çalıştırılmazsa Apps Komut Dosyası, ilişkili varsayılan projesini siler. Apps Komut Dosyası, varsayılan projesini sildikten sonra komut dosyası çalıştırılırsa komut dosyası için bir proje oluşturur.

Standart Cloud projeleri

Projeyi manuel olarak yapılandırmanız gerekmediği sürece varsayılan Cloud projeleri, çoğu komut dosyası projesi için en iyi seçenektir. Bu durumlarda komut dosyası projenizi standart bir proje kullanacak şekilde değiştirmeniz gerekir.

Aşağıdaki bölümlerde, Apps Komut Dosyası'nın ne zaman standart bir proje gerektirdiği, bu tür projelerin özellikleri ve bu projelerde gerçekleştirilen yaygın görevler açıklanmaktadır. Aşağıdaki görevleri yalnızca standart projelerde gerçekleştirebilirsiniz.

Apps Komut Dosyası'nın standart Cloud projeleri gerektirdiği durumlar

Aşağıdaki durumlarda standart bir proje kullanmanız gerekir:

• Komut dosyası projenizi Google Workspace Marketplace'te eklenti olarak yayınlamak için
• Komut dosyası projenizin OAuth istemcisini doğrulamak için.
• Apps Script API'nin scripts.run yöntemini kullanarak komut dosyası projenizde işlevleri yürütmesi gereken bir uygulamanız varsa
• Komut dosyası projenizin Google Cloud Console'daki Google Cloud günlüklerini görüntülemek için Google Cloud Console, günlükleri filtrelemek ve görüntülemek için daha fazla araç sunar ve Apps Script kontrol paneli tarafından sağlanan basitleştirilmiş görünümden daha yararlı olabilir.
• Error Reporting'i kullanarak komut dosyası projenizin hata raporlarını görüntülemek için
• Dosya açma iletişim kutusu oluşturmak için.
• Projenin Google Cloud ayarları üzerinde manuel kontrol sahibi olmanız gerektiğinde

Standart Cloud projesi özellikleri

Standart projeler aşağıdaki özelliklere sahiptir:

• Projenin tüm Google Cloud ayarlarına doğrudan Google Cloud Console'dan erişebilirsiniz. Bu sayede API'leri etkinleştirebilir, yetkilendirme kimlik bilgilerini ayarlayabilir ve diğer ayrıntıları yapılandırabilirsiniz.
• Bir komut dosyası projesini sildiğinizde veya başka bir standart projeyi kullanmaya geçtiğinizde orijinal standart proje kalır ve yeniden kullanılabilir.
• Bir komut dosyası projesinde gelişmiş bir hizmeti etkinleştirdiğinizde, ilgili API'yi standart projede manuel olarak etkinleştirmeniz gerekir.
• Birden fazla komut dosyası projesi ve diğer uygulamalar aynı standart projeyi paylaşabilir. Bir komut dosyası projesini Google Workspace Marketplace'te eklenti olarak yayınlamak istiyorsanız bu projenin kendi standart projesi olmalıdır. Yayınlanan uygulamalar, Cloud projelerini diğer uygulamalarla paylaşamaz.
• Apps Script API'nin scripts.run yöntemini kullanarak bir komut dosyası projesindeki işlevleri başka bir uygulamadan yürütmek istiyorsanız komut dosyası projesi ile çağıran uygulamanın aynı standart projeyi paylaşması gerekir.
• Apps Komut Dosyası, kullanıcıdan standart bir proje kullanan bir komut dosyasını yetkilendirmesini istediğinde, komut dosyasını tanımlamak için komut dosyası proje adı değil Cloud proje adı kullanılır. Bu nedenle, uygun bir Cloud projesi adı belirlediğinizden emin olun.

Standart bir Cloud projesine erişim

Komut dosyası projenizle ilişkili standart projeye erişmek için aşağıdakileri yapın:

1. Apps Komut Dosyası projesini açın.
2. Sol tarafta Proje Ayarları'nı settings tıklayın.
3. Google Cloud Platform (GCP) Projesi bölümünde proje numarasını tıklayın.

Standart bir projeyi doğrudan Google Cloud Console Kaynakları Yönet sayfasında da bulabilirsiniz.

Standart bir Cloud projesinde API'yi etkinleştirme

Apps Script uygulamalarının genellikle başka bir Google API'sine erişmesi gerekir. Bunu yapmak için API'yi ilgili Cloud projesinde etkinleştirmeniz gerekir. Aşağıdakileri yaparak bir API'yi etkinleştirin:

1. Cloud projesini açın.
2. Menü menu > API'ler ve Hizmetler'i tıklayın.
3. API'leri ve Hizmetleri Etkinleştir'i tıklayın.
4. Arama kutusuna etkinleştirmek istediğiniz API'yi girin ve Enter tuşuna basın.
5. Arama sonuçlarında API'yi, ardından bu Cloud projesi için API'yi etkinleştirmek üzere Etkinleştir'i tıklayın.

Google API'leri veya Google Cloud Hizmet Şartları'nı kabul etmeniz istenebilir. Hizmet Şartları'nı kabul etmeden önce dikkatlice inceleyin.

Uygulamaya bağlı olarak, API'ler ve Hizmetler kontrol panelinden API'yi seçerek yapılandırmanız da gerekebilir.

Standart bir Cloud projesinin kimliğini ve numarasını belirleme

Tüm Cloud projelerinin bir proje adı, proje kimliği ve proje numarası vardır. Bazen hizmetleri yapılandırmak veya başka görevleri tamamlamak için bu tanımlayıcılara sahip olmanız gerekir.

Standart projenizin kimliğini ve numarasını belirlemek için aşağıdakileri yapın:

1. Cloud projesini açın.
2. Sağ üstte Diğer more_vert > Proje ayarları'nı tıklayın.
3. Açılan Ayarlar panelinde Proje adı, Proje kimliği ve Proje numarası'nı görüntüleyin. Proje numarası yalnızca rakamlardan oluşurken proje kimliği alfanümeriktir. Yetkilendirme istemleri sırasında kullanıcılara gösterilen proje adını düzenleyebilirsiniz.

Google Cloud Console'da Google Cloud günlüklerini ve hata raporlarını görüntüleme

Komut dosyası projeniz için Google Cloud günlük kaydı veya hata raporlama kullanıyorsanız aşağıdakileri yaparak bu günlükleri ve raporları Google Cloud Console'da görüntüleyebilirsiniz:

1. Cloud projesini açın.
2. Menü'yü menu tıklayın.
3. İşlemler bölümüne gidin ve Günlük kaydı > Günlük gezgini'ni tıklayın.
4. Hata raporlarını görüntülemek için İşlemler bölümüne gidip Hata Raporlama'yı tıklayın. Hata raporlamayı ayarlamanızı istersek komut dosyası projeniz henüz istisna kaydetmemiş demektir.

OAuth kullanıcı rızası ekranını tamamlama

Google, OAuth gerektiren hizmetleri kullanırken kullanıcılardan bu hizmetleri yetkilendirmelerini ister. OAuth izin ekranı ayarları, Google'ın kullanıcılara sunduğu bazı bilgileri (ör. uygulama adı ve Hizmet Şartları URL'si) ayarlamanıza olanak tanır.

Varsayılan Cloud projeleri, Apps Komut Dosyası proje ayrıntılarından otomatik olarak bir izin ekranı oluşturur. Bu ayarları düzenleyemezsiniz. Standart Cloud projeleri bu bilgileri özelleştirmenize olanak tanır. Aşağıdakileri yaparak komut dosyanızın izin ekranını yapılandırabilirsiniz:

1. Cloud projesini açın.
2. Menü menu > API'ler ve Hizmetler > Kimlik bilgileri'ni tıklayın.
3. İzin ekranını yapılandır'ı tıklayın.
4. İzin ekranı iş akışının her bölümünü doldurun.
5. İş akışının her aşamasında yaptığınız değişiklikleri kaydetmek için Kaydet ve devam et'i tıklayın.

OAuth kimlik bilgileri oluşturma

Apps Script genellikle komut dosyanızın kullandığı hizmetler için OAuth'u ayarlar. Bazı uygulamalar için ek OAuth kimlik bilgileri (istemci kimlikleri ve istemci gizli anahtarları) oluşturmanız gerekir. Bunu yalnızca standart projelerde yapabilirsiniz.

Komut dosyası projeniz için istemci kimliği ve istemci gizli anahtarı oluşturmak üzere aşağıdakileri yapın:

1. Cloud projesini açın.
2. Menü menu > API'ler ve Hizmetler > Kimlik bilgileri'ni tıklayın.
3. Kimlik bilgisi oluştur > OAuth istemci kimliği'ni tıklayın.
4. Uygulama türü bölümünde uygulama türünüzü seçin ve gerekirse oluşturulan formu doldurun. İşlemi tamamladığınızda Oluştur'u tıklayın.
5. Açılan iletişim kutusunda JSON'u indir'i tıklayın. OAuth'u yapılandırmak için bu dosyayı kullanabilirsiniz.

Standart bir Cloud projesine başka sahipler ekleme

Standart bir projeye başka sahipler veya başka roller ekleyebilirsiniz. Bir projede ortak çalışıyorsanız bu, ekibinizdeki bir kişinin komut dosyası projesinin Google Cloud ayarlarına her zaman erişebilmesini sağlar.

Aşağıdaki adımları uygulayarak standart bir projeye başka sahipler veya başka roller ekleyebilirsiniz. Projede aşağıdaki değişikliklerden herhangi birini yapmak için düzenleme izinlerine sahip olmanız gerekir:

1. İçerik sağlayıcı çalışanlarınızın kimler olması gerektiğini belirleyin. Mevcut bir Google grubu oluşturmanızı veya kullanmanızı öneririz. Ayrıca, ortak çalışan listesinde alanları belirterek söz konusu alandaki tüm kullanıcıları dahil edebilirsiniz.
2. Komut dosyasının Cloud projesini açın.
3. Menü menu > IAM ve yönetici > IAM'ı tıklayın.
4. Üst tarafta Ekle'yi tıklayın.
5. Bulut projesine bir veya daha fazla yeni üye ve rollerini eklemek için ekrandaki talimatları uygulayın. Yeni üye olarak e-posta adresleri, Google Gruplar veya alanlar ekleyebilirsiniz.
6. Kaydet'i tıklayın.

Birden fazla komut dosyasını tek bir Cloud projesinde gruplandırma

Aynı standart Cloud projesini birden fazla Apps Komut Dosyası projesinin paylaşmasını sağlayabilirsiniz. Bunu yapmak için standart bir proje oluşturun ve ardından her komut dosyası projesini bu projeye geçişin. Bunu varsayılan projelerde yapamazsınız.

Farklı bir standart Cloud projesi kullanma

Bir komut dosyası projesini, farklı bir standart Cloud projesi kullanacak şekilde değiştirebilirsiniz. Komut dosyanız Cloud projesinin manuel olarak yapılandırılmasını gerektiriyorsa varsayılan projeden standart bir projeye geçmeniz gerekir. Standart bir projeyi ne zaman kullanmanız gerektiği hakkında daha fazla bilgi edinmek için standart Cloud projeleri başlıklı makaleyi inceleyin.

Farklı bir standart Cloud projesine geçmenin etkileri

Komut dosyanızı varsayılan bir projeden farklı bir standart projeye geçirirseniz aşağıdaki etkiler ortaya çıkar:

• Komut dosyanız için gelişmiş hizmetleri etkinleştirdiyseniz yeni Cloud projesinde ilgili API'leri etkinleştirmeniz gerekir. Önceki Cloud projesindeki gelişmiş hizmetlere bağlı tüm verileri kaybedersiniz. Cloud projenizde API'leri nasıl etkinleştireceğinizi öğrenmek için Google Workspace API'lerini etkinleştirme başlıklı makaleyi inceleyin.
• Komut dosyanız yerleşik Google Drive hizmetini kullanıyorsa standart Cloud projelerinde Drive API'yi etkinleştirmeniz gerekir.

  Standart Cloud projenizde Drive API'yi etkinleştirin:

  Drive API'yi etkinleştirme

• Daha önce komut dosyasına yetki veren tüm kullanıcıların yeniden yetki vermesi gerekir. Çoğu durumda, yeni projeyle ilişkili uygulamaları daha önce yetkilendirmiş olan tüm kullanıcıların da yeniden yetkilendirme yapması gerekir.
• Komut dosyanız Google Workspace Marketplace'teki bir uygulama girişiyle ilişkilendirilmişse uygulama girişiniz, kullanıcılarınız ve yorumlarınız yeni projeye aktarılmaz. Yeni projede bir uygulama girişi oluşturmanız ve kullanıcılarınızın uygulamanızı yeniden yüklemesi gerekir. Yeni bir uygulama girişi oluşturma hakkında bilgi edinmek için Uygulama yayınlama başlıklı makaleyi inceleyin.
• Bir komut dosyasını varsayılan projeye geri döndüremeyiz. Apps Komut Dosyası, komut dosyasını standart bir proje kullanacak şekilde ayarladıktan sonra varsayılan projeleri siler.

Farklı bir standart Cloud projesine geçme

Bir komut dosyasının mevcut Cloud projesini başka bir Cloud projesine geçirmek için aşağıdaki adımları uygulayın:

1. Uygun bir Cloud projeniz yoksa Proje oluşturma talimatlarını uygulayarak bir proje oluşturun. Google Cloud Console Kaynakları Yönet sayfasında bulabilmek için akılda kalıcı bir proje adı ayarlayın. Apps Komut Dosyası, kullanıcılardan komut dosyasını yetkilendirmelerini istediğinde bu adı kullanır.
2. Mevcut bir projeyi kullanmak istiyorsanız Google Cloud Console Kaynakları Yönet sayfasını açın ve kullanmak istediğiniz mevcut bir projeyi bulun. Proje için Proje Tarayıcısı ve OAuth Yapılandırma Düzenleyicisi rolüne veya eşdeğer izinlere sahip rollere sahip olmanız gerekir. Apps Komut Dosyası tarafından otomatik olarak oluşturulan bir projeyi kullanamazsınız.
3. Cloud projenizin proje numarasını belirleyin.
4. Cloud projesini değiştirmek istediğiniz komut dosyasını açın.
5. Sol tarafta Proje Ayarları'nı settings tıklayın.
6. Google Cloud Platform (GCP) Projesi bölümünde Projeyi değiştir'i tıklayın.
7. Yeni proje numarasını girin ve Projeyi ayarla'yı tıklayın.

Bulut projeleri ve ortak sürücüler

Ortak Drive'lar (eski adıyla Ekip Drive'ları), Drive kullanıcısı gruplarının Apps Script projeleri ve Drive dokümanları üzerinde ortak çalışabileceği ortak alanlar sağlar. Ortak Drive'lar, bir ekiple komut dosyası, eklenti ve web uygulaması geliştirirken değerlidir ancak eski varsayılan Cloud projeleriyle neler yapabileceğiniz konusunda bazı kısıtlamalar getirir.

Aşağıdaki kısıtlama listesi, Cloud projelerinin ortak Drive'larla nasıl etkileşime geçtiğini açıklar:

• Komut dosyası projeniz standart bir proje kullanıyorsa komut dosyası projesi ortak Drive'da bulunduğunda ek kısıtlama yoktur.
• Komut dosyası projeniz 8 Nisan 2019'da veya sonrasında oluşturulan bir varsayılan projeyi kullanıyorsa komut dosyası projesi ortak Drive'da bulunduğunda ek kısıtlama yoktur.
• Komut dosyası projeniz 8 Nisan 2019'dan önce oluşturulmuş bir varsayılan proje kullanıyorsa komut dosyası projesi ortak bir sürücüdeyken aşağıdaki kısıtlamalar geçerli olur:
  1. Varsayılan projeye Apps Komut Dosyası kullanıcı arayüzünü veya Google Cloud Console'u kullanarak erişemezsiniz. Bu kısıtlama, projeye doğrudan erişim gerektiren işlemleri yapmanızı engeller.
  2. Gelişmiş hizmetleri etkinleştiremezsiniz. Gelişmiş hizmetleri etkinleştirmek için standart bir projeye geçin.
  3. Mevcut bir Apps Komut Dosyası projesini ortak Drive'a taşıdığınızda Google, varsayılan Cloud projesine erişimi kısıtlar. Taşıma işleminden önce varsayılan projeye erişebiliyorsanız bu projeye erişmeye devam edebilirsiniz. Örneğin, Drive'ım klasörünüzde bir komut dosyası oluşturup bunu ortak Drive'a taşırsanız komut dosyanızın Bulut projesine erişmeye devam edebilirsiniz. Ortak Drive'daki ortak çalışanlarınız bu işlemi yapamaz.
  4. Komut dosyaları, paylaşılan bir Drive'a taşınmadan önceki Cloud projesi adını korur. Ortak Drive'daki proje adını değiştirseniz bile komut dosyasına yetki veren kullanıcılar, yetkilendirme iletişim kutularında eski adı görmeye devam eder.

Eski komut dosyalarında yukarıdaki kısıtlamaları önlemek için standart bir projeye geçin.

Apps Komut Dosyası Cloud projelerinin listesini alma

Kuruluşunuzun Apps Komut Dosyası proje klasörü için resourcemanager.projects.list izniniz varsa klasördeki tüm standart ve varsayılan Apps Komut Dosyası Cloud projelerini görüntüleyebilirsiniz.

1. Google Cloud Console Kaynakları Yönet sayfasını açın.
2. Apps Script klasörünün yanındaki kimliği kopyalayın.
3. Filtre > Üst Kimlik'i tıklayın ve Apps Komut Dosyası klasör kimliğini yapıştırın.

Apps Komut Dosyası Cloud projelerini silme

Bir Apps Komut Dosyası Cloud projesini silmek için Apps Komut Dosyası Cloud projelerinin listesini alma bölümündeki adımları uygulayın, silmek istediğiniz projeyi seçin ve Sil'i tıklayın.

gcloud'ü kullanarak bir Apps Komut Dosyası projesini silmek için aşağıdaki komutları kullanın.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

Cloud projelerini silme hakkında daha fazla bilgi için Projeleri kapatma (silme) başlıklı makaleyi inceleyin.