Google Cloud projeleri

Her Google Apps Komut Dosyası projesi, yetkilendirme, gelişmiş hizmetler ve diğer ayrıntıları yönetmek için Google Cloud'u kullanır. 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ı projeniz, Apps Komut Dosyası'nın otomatik olarak oluşturduğu bir varsayılan projeyi veya kendinizin oluşturduğu bir standart projeyi kullanabilir. Genel olarak, varsayılan projeler günlük komut dosyaları için uygundur ancak karmaşık, ticari kalitede olan veya yayınlamayı planladığınız tüm uygulamalar için standart proje kullanmanız gerekir.

Dilediğiniz zaman varsayılan projeden standart projeye geçebilirsiniz ancak varsayılan projeye geri dönemezsiniz. Komut dosyanızın kullandığı Cloud projesini geliştirme sürecinin başlarında seçmeniz önerilir. Daha sonra geçiş yapmak, kullanıcılarınızın yeniden yetkilendirme yapmasını gerektirmek gibi sorunlara 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örmeniz veya ayarlamanız gerekmez. Apps Komut Dosyası, Google Cloud ile gerekli etkileşimleri yönetir. Örneğin, Apps Komut Dosyası Düzenleyici'de gelişmiş bir hizmeti etkinleştirirseniz Apps Komut Dosyası, komut dosyası projesini kaydettiğinizde varsayılan Cloud projesinde gelişmiş hizmeti etkinleştirir.
  • Bazı komut dosyaları için Google Cloud Console ile etkileşimde bulunmanız gerekir. Bu durumlarda komut dosyanız standart bir Cloud projesi kullanmalıdır. Örneğin, Google Cloud Console'da Google Cloud günlüklerini görüntülemek için komut dosyanızın standart bir proje kullanması gerekir.

Varsayılan olarak Cloud projelerinde tek girişli bir Identity and Access Management (IAM) politikası bulunur. Bu giriş, varsayılan projenin sahibi olarak hareket eden bir Google hizmet hesabıdır. Google hizmet hesabı appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Varsayılan bulut 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 bir varsayılan proje kullanabilirsiniz. Varsayılan projeye erişmek için komut dosyası projesinin ayarlarına gidip proje numarasını tıklayın.

Varsayılan Cloud projelerini silme

Yöneticiyseniz varsayılan Cloud projelerini standart Cloud projelerini siler gibi silebilirsiniz. Varsayılan Cloud projelerini görüntüleme veya düzenleme başlıklı makaleyi inceleyin.

Yönetici olmayan kullanıcılar varsayılan projeleri manuel olarak silemez. Ancak komut dosyası projesini silerseniz veya standart bir projeye geçerseniz Apps Komut Dosyası, komut dosyasına eklenmiş varsayılan projeyi ayarları ve bilgileriyle birlikte siler.

Standart Cloud projeleri

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

Aşağıdaki bölümlerde, Apps Komut Dosyası'nın standart bir proje gerektirdiği durumlar, özellikleri ve yaygın görevler açıklanmaktadır. Bu görevleri yalnızca standart projelerde gerçekleştirin.

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

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

Standart Cloud proje ö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 proje kullanacak şekilde değiştirdiğinizde orijinal standart proje kalır ve yeniden kullanılabilir.
  • Bir komut dosyası projesinde gelişmiş bir hizmeti etkinleştirdiğinizde, standart projede ilgili API'yi manuel olarak etkinleştirmeniz gerekir.
  • Aynı standart projeyi birden fazla komut dosyası projesi ve başka uygulamalar paylaşabilir. Bir komut dosyası projesini Marketplace'te eklenti olarak yayınlamayı planlıyorsanız projenin kendi standart projesi olmalıdır. Yayınlanan uygulamalar, Cloud projelerini diğer uygulamalarla paylaşamaz.
  • Apps Komut Dosyası API'sinin scripts.run yöntemini kullanarak bir komut dosyası projesindeki işlevleri başka bir uygulamadan yürütmek istiyorsanız komut dosyası projesi ve çağıran uygulama aynı standart projeyi paylaşmalıdır.
  • Apps Komut Dosyası, bir kullanıcıdan standart proje kullanan bir komut dosyasını yetkilendirmesini istediğinde komut dosyasını tanımlamak için Cloud proje adı kullanılır (komut dosyası proje adı değil). Bu nedenle, uygun bir Cloud proje adı ayarladığınızdan emin olun.

Standart bir Cloud projesine erişme

Senaryo projenizle ilişkili standart projeye erişmek için:

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

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

Standart bir Cloud projesinde API'yi etkinleştirme

Bir Apps Komut Dosyası uygulamasına başka bir Google API'sine erişim vermek için API'yi ilgili Cloud projesinde etkinleştirin:

  1. Cloud projesini açın.
  2. Menü > 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ından API'yi ve ardından 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 panelinde API'yi seçerek yapılandırmanız gerekebilir.

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

Tüm Cloud projelerinin adı, kimliği ve numarası vardır. Hizmetleri yapılandırmak veya diğer görevleri tamamlamak için bu tanımlayıcılara ihtiyacınız olabilir.

Standart projenizin kimliğini ve numarasını belirlemek için:

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

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

Komut dosyası projeniz için Google Cloud Logging veya Error Reporting kullanıyorsanız aşağıdaki adımları uygulayarak bu günlükleri ve raporları Google Cloud Console'da görüntüleyebilirsiniz:

  1. Cloud projesini açın.
  2. Menü'yü tıklayın.
  3. İşlemler bölümünde 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ünde Hata Raporlama'yı tıklayın. Hata raporlamayı ayarlamanız isteniyorsa bu, komut dosyası projenizin henüz herhangi bir istisna kaydetmediği anlamına gelir.

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

Varsayılan Cloud projeleri, Apps Komut Dosyası proje ayrıntılarından otomatik olarak bir kullanıcı rızası ekranı oluşturur. Bu ayarları düzenleyemezsiniz. Standart Cloud projelerinde bu bilgileri özelleştirebilirsiniz. Komut dosyanızın kullanıcı rızası ekranını yapılandırmak için:

  1. Cloud projesini açın.
  2. Menü > API'ler ve Hizmetler > Kimlik Bilgileri'ni tıklayın.
  3. Kullanıcı rızası ekranını yapılandır'ı tıklayın.
  4. Kullanıcı rızası ekranı iş akışının her bölümünü doldurun.
  5. Her aşamada değişikliklerinizi kaydetmek için Kaydet ve devam et'i tıklayın.

OAuth kimlik bilgileri oluşturma

Apps Komut Dosyası 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şturun. Bu işlemi yalnızca standart projelerde yapın.

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

  1. Cloud projesini açın.
  2. Menü > API'ler ve Hizmetler > Kimlik Bilgileri'ni tıklayın.
  3. Kimlik bilgileri 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 formu doldurun. İşlemi tamamladığınızda Oluştur'u tıklayın.
  5. İletişim kutusunda JSON'ı indir'i tıklayın. OAuth'u yapılandırmak için bu dosyayı kullanın.

Standart bir Cloud projesine ek sahipler ekleme

Ekip üyelerinizden birinin her zaman komut dosyası projesinin Google Cloud ayarlarına erişebilmesi için standart bir projeye ek sahipler veya başka roller ekleyin.

Standart bir projeye ek sahipler veya başka roller eklemek için (düzenleme izni gerekir):

  1. Ortak çalışanlarınızı belirleyin. Google Grubu kullanmanızı öneririz. Bu alandaki tüm kullanıcıları dahil etmek için alanları belirtin.
  2. Komut dosyasının Cloud projesini açın.
  3. Menü > IAM ve yönetici > IAM'i tıklayın.
  4. Üst tarafta Ekle'yi tıklayın.
  5. Yeni üyeler ve rollerini eklemek için ekrandaki talimatları uygulayın. Kişisel e-posta adresleri, Google Grupları veya alanlar ekleyin.
  6. Kaydet'i tıklayın.

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

Birden fazla Apps Komut Dosyası projesi aynı standart Cloud projesini paylaşabilir. Bunu yapmak için standart bir proje oluşturun ve ardından her komut dosyası projesini bu projeyi kullanacak şekilde değiştirin. Varsayılan projelerde bu işlemi yapamazsınız.

Komut dosyası projenizi Marketplace'te eklenti olarak yayınlamak istiyorsanız projenin kendi standart projesi olmalıdır. Yayınlanan uygulamalar Cloud projelerini paylaşamaz.

Farklı bir standart Cloud projesi kullanma

Bir komut dosyası projesini farklı bir standart Cloud projesi kullanacak şekilde değiştirme Komut dosyanızın Cloud projesinin manuel olarak yapılandırılması gerekiyorsa varsayılan projeden standart projeye geçin. 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 görülür:

  • 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şkilendirilmiş uygulamaları daha önce yetkilendirmiş olan tüm kullanıcıların yeniden yetkilendirme yapması gerekir.
  • Komut dosyanız Google Workspace Marketplace'teki bir uygulama girişiyle ilişkiliyse 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 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üremezsiniz. 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 bulmak için projeye kolay hatırlanabilir bir ad verin. Apps Komut Dosyası, kullanıcılardan komut dosyasını yetkilendirmelerini isterken bu adı kullanır.
  2. Mevcut bir projeyi kullanmak istiyorsanız Google Cloud Console Kaynakları Yönetin sayfasını açın ve kullanmak istediğiniz mevcut projeyi bulun. Proje için Proje Tarayıcısı ve OAuth Yapılandırma Düzenleyicisi rollerine 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ı tıklayın.
  6. Google Cloud 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 drive'lar

Paylaşılan sürücüler yalnızca Google Workspace Business ve Google Workspace Enterprise müşterileri tarafından kullanılabilir.

Ortak Drive'lar (eski adıyla Ekip Drive'ları), Drive kullanıcı gruplarının Apps Komut Dosyası projeleri ve Drive dokümanları üzerinde ortak çalışabileceği paylaşılan alanlar sağlar. Paylaşılan Drive'lar, bir ekiple birlikte komut dosyaları, eklentiler ve web uygulamaları geliştirirken faydalı olsa da eski varsayılan Cloud projeleriyle yapabilecekleriniz konusunda bazı kısıtlamalar getirir.

Aşağıdaki listede, Cloud projelerinin paylaşılan sürücülerle nasıl etkileşime girdiği açıklanmaktadır:

  • Komut dosyası projeniz standart bir proje kullanıyorsa komut dosyası projesi ortak Drive'da bulunduğunda ek kısıtlama uygulanmaz.
  • Komut dosyası projeniz 8 Nisan 2019'da veya sonrasında oluşturulan varsayılan bir projeyi kullanıyorsa komut dosyası projesi ortak drive'da bulunduğunda ek kısıtlama uygulanmaz.
  • Komut dosyası projeniz 8 Nisan 2019'dan önce oluşturulmuş bir varsayılan proje kullanıyorsa komut dosyası projesi ortak drive'da bulunduğu sürece aşağıdaki kısıtlamalar geçerlidir:
    1. Apps Komut Dosyası kullanıcı arayüzünü veya Google Cloud Console'u kullanarak varsayılan projeye erişemezsiniz. Bu kısıtlama, projeye doğrudan erişim gerektiren işlemler 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 erişiminiz varsa varsayılan projeye erişmeye devam edebilirsiniz. Örneğin, Drive'ım klasörünüzde bir komut dosyası oluşturup bunu ortak Drive'a taşıdıysanız komut dosyasının Cloud projesine erişmeye devam edebilirsiniz. Ortak drive'daki ortak çalışanlarınız bu işlemi yapamayabilir.
    4. Bir komut dosyası, ortak sürücüye taşınmadan önce sahip olduğu 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örür.

Eski komut dosyaları için bu kısıtlamalardan kaçınmak istiyorsanız 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önetin sayfasını açın.
  2. Apps Komut Dosyası klasörünün yanındaki kimliği kopyalayın.
  3. Filtre > Üst öğe kimliği'ni tıklayın ve Apps Komut Dosyası klasör kimliğini yapıştırın.

Apps Komut Dosyası Cloud projelerini silme

Varsayılan projeleri silmek için yönetici olmanız gerekir.

Google Cloud Console'dan bir Apps Komut Dosyası projesini silmek için:

  1. Cloud projesini açın.
  2. Sağ üstte Diğer > Proje ayarları'nı tıklayın.
  3. Kapat / sil'i tıklayın.
  4. Projeyi kapatmak için ekrandaki talimatları uygulayı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.