Google Cloud projeleri

Her Apps Komut Dosyası projesi yetkilendirmeyi, gelişmiş hizmetleri 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 sizin oluşturduğunuz bir standart projeyi kullanabilir. Genel olarak varsayılan projeler günlük veya basit komut dosyaları için uygundur ancak karmaşık, ticari kalitede olan veya yayınlamayı planladığınız uygulamalar için standart bir proje kullanmanız gerekir.

İstediğiniz zaman varsayılan projeden standart projeye geçiş yapabilirsiniz ancak varsayılan projeyi kullanmaya geri dönemezsiniz. En iyi seçenek, komut dosyanızın geliştirme sürecinin başında kullandığı Cloud projesini seçmektir. Daha sonra geçiş yapmak, kullanıcılarınızın yeniden yetkilendirmesini gerektirme gibi sorunlara yol açabilir.

Varsayılan Cloud projeleri

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

  • Çoğu komut dosyası için bu varsayılan projeyi hiçbir zaman görmeniz veya ayarlamanız gerekmez. Apps Komut Dosyası, Google Cloud ile gerekli etkileşimleri gerçekleştirir. Örneğin, Apps Komut Dosyası düzenleyicisinde bir gelişmiş hizmeti etkinleştirirseniz komut dosyası projesini kaydettiğinizde Apps Komut Dosyası, varsayılan Cloud projesindeki gelişmiş hizmeti etkinleştirir.
  • Bazı komut dosyaları için Google Cloud konsoluyla etkileşimde bulunmanız gerekir. Bu tür durumlarda komut dosyanızın bunun yerine standart bir Cloud projesi kullanması gerekir. Örneğin, Google Cloud günlüklerini Google Cloud konsolunda 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 politika, varsayılan projenin sahibi olan 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 konsolunda erişebileceğiniz bir varsayılan 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 silin

Yöneticiyseniz standart Cloud projelerinde olduğu gibi varsayılan Cloud projelerini silebilirsiniz. Apps Komut Dosyası Bulut projelerini silme başlıklı makaleyi inceleyin.

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

  • Komut dosyası projesini siler veya standart bir projeyi kullanacak şekilde değiştirirseniz Apps Komut Dosyası, komut dosyasına eklenen varsayılan projeyi, içerdiği tüm ayarlar veya bilgilerle birlikte siler.
  • Bir komut dosyası 180 gün veya daha uzun süre çalışmazsa Apps Komut Dosyası ilişkili varsayılan projesini siler. Komut dosyası, Apps Komut Dosyası varsayılan projesini sildikten sonra çalışırsa Apps Komut Dosyası, komut dosyası için bir proje oluşturur.

Standart Cloud projeleri

Varsayılan Cloud projeleri, projeyi manuel olarak yapılandırmanız gerekmiyorsa çoğu komut dosyası projesi için en iyi seçenektir. Böyle 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 projelerin özellikleri ve bunlarla yapılan genel görevler açıklanmaktadır. Aşağıdaki görevleri yalnızca standart projelerle gerçekleştirebilirsiniz.

Apps Komut Dosyası, standart Cloud projeleri gerektirdiğinde

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

Standart Cloud projesi özellikleri

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

  • Projeyle ilgili tüm Google Cloud ayarlarına doğrudan Google Cloud konsolundan 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ş hizmeti etkinleştirdiğinizde, standart projede ilgili API'yi manuel olarak etkinleştirmeniz gerekir.
  • Birden fazla komut dosyası projesi ve diğer uygulamalar aynı standart projeyi paylaşabilir. 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 başka bir uygulamadaki bir komut dosyası projesinde işlevler yürütmek istiyorsanız komut dosyası projesi ve çağrı yapan uygulamanın aynı standart projeyi paylaşması gerekir.
  • 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 projesinin adı kullanılır (komut dosyası projesinin adı değil). Bu nedenle, uygun bir Cloud projesi adı belirlediğinizden emin olun.

Standart bir Cloud projesine erişim

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

  1. Apps Komut Dosyası projesini açın.
  2. Solda Proje Ayarları'nı tıklayın.
  3. Google Cloud Platform (GCP) Project altında proje numarasını tıklayın.

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

Standart Cloud projesinde bir API'yi etkinleştirme

Genellikle Apps Komut Dosyası uygulamasının başka bir Google API'sine erişmesi gerekir. Bunun için ilgili Cloud projesinde API'yi etkinleştirmeniz gerekir. Aşağıdakileri yaparak bir API'yi 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 tıklayın ve 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. Kabul etmeden önce Hizmet Şartları'nı dikkatlice inceleyin.

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

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

Tüm Cloud projelerinin bir proje adı, proje kimliği ve proje numarası bulunur. Hizmetleri yapılandırmak veya diğer görevleri tamamlamak için bazen bu tanımlayıcıların olması 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 > Proje ayarları'nı tıklayın.
  3. Çıkan 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ümerik bir değerdir. 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 Logging veya Error Reporting 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ü 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 gidin ve Error Reporting'i tıklayın. Hata raporlamayı ayarlamanızın istenmesi, komut dosyası projenize henüz herhangi bir istisna kaydetmediği anlamına gelir.

OAuth gerektiren hizmetleri kullanırken Google, 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ı projesinin 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ü > API'ler ve Hizmetler > Kimlik bilgileri'ni tıklayın.
  3. Configure consent screen (İzin ekranını yapılandır) seçeneğini tıklayın.
  4. İzin ekranı iş akışının her bölümünü doldurun.
  5. İş akışının her aşamasında 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 ayarlar. Bazı uygulamalar için ek OAuth kimlik bilgileri (istemci kimlikleri ve istemci gizli anahtarları) oluşturmanız gerekir. Bunu yalnızca standart projelerle yapabilirsiniz.

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

  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 gerekirse açılan 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 Cloud projesine ek sahipler ekleme

Standart bir projeye ek sahipler veya başka roller ekleyebilirsiniz. Bir proje üzerinde ortak çalışma yapıyorsanız ekibinizdeki bir kişinin her zaman komut dosyası projesinin Google Cloud ayarlarına erişebilmesini sağlarsınız.

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

  1. Ortak çalışanlarınızın kim olması gerektiğini belirleyin. Bir Google Grubu oluşturmanızı veya mevcut bir Google Grubu'nu kullanmanızı öneririz. Ortak çalışan listesinde alan adlarını, ilgili alandaki tüm kullanıcıları kapsayacak şekilde de belirtebilirsiniz.
  2. Komut dosyasının Cloud projesini açın.
  3. Menü > IAM ve yönetici > IAM'yi tıklayın.
  4. Üst tarafta Ekle'yi tıklayın.
  5. Cloud projesine bir veya daha fazla yeni üye ve rollerini eklemek için ekrandaki talimatları uygulayın. Tek tek e-postaları, Google Gruplarını veya alanları yeni üye olarak ekleyebilirsiniz.
  6. Kaydet'i tıklayın.

Tek bir Cloud projesiyle birden fazla komut dosyasını gruplandırma

Aynı standart Cloud projesini paylaşan birden fazla Apps Komut Dosyası projeniz olabilir. Bunu yapmak için standart bir proje oluşturun ve ardından her bir komut dosyası projesini kullanacak şekilde geçiş yapın. Bu işlemi varsayılan projelerle yapamazsınız.

Farklı bir standart Cloud projesi kullanın

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 projeye geçmeniz gerekir. Standart bir projeyi ne zaman kullanmanız gerektiği hakkında daha fazla bilgi edinmek için standart Cloud projelerine bakın.

Farklı bir standart Cloud projesine geçmenin etkileri

Komut dosyanızı varsayılan bir projeden veya farklı bir standart projeye değiştirirseniz bunun aşağıdaki etkileri olur:

  • Komut dosyanız için gelişmiş hizmetleri etkinleştirdiyseniz yeni Cloud projesinde karşılık gelen API'leri etkinleştirmeniz gerekir. Önceki Cloud projesinde 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 bölümüne bakın.
  • 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ı için yetki veren tüm kullanıcıların yeniden yetkilendirmesi gerekir. Çoğu durumda, daha önce yeni projeyle ilişkili uygulamaları 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şkilendirilirse uygulama girişiniz, kullanıcılarınız ve yorumlarınız yeni projeye taşınmaz. 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 için Uygulama yayınlama bölümüne bakın.
  • Bir komut dosyasını tekrar varsayılan projeye döndüremezsiniz. Apps Komut Dosyası, komut dosyasını standart bir proje kullanacak şekilde ayarlamanızın ardından varsayılan projeleri siler.

Farklı bir standart Cloud projesine geçin

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

  1. Uygun bir Cloud projeniz yoksa Proje oluşturma talimatlarını uygulayarak proje oluşturun. Akılda kalıcı bir proje adı belirleyin. Böylece projeyi Google Cloud Console Kaynakları Yönet sayfasında bulabilirsiniz. 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önet sayfasını açın ve kullanılacak mevcut bir projeyi bulun. Projede 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. Solda, Proje Ayarları'nı tıklayın.
  6. Google Cloud Platform (GCP) Project bölümünde Projeyi değiştir seçeneğini tıklayın.
  7. Yeni proje numarasını girin ve Set project (Proje ayarla) seçeneğini tıklayın.

Bulut projeleri ve ortak Drive'lar

Ortak Drive'lar (eski adıyla Ekip Drive'ları), Drive kullanıcı gruplarının Apps Komut Dosyası projeleri ve Drive dokümanlarında ortak çalışma yapabileceği ortak alanlar sağlar. Ortak Drive'lar, bir ekiple komut dosyası, eklenti ve web uygulamaları geliştirirken değerlidir ancak eski varsayılan Cloud projeleriyle yapabilecekleriniz konusunda bazı kısıtlamalar uygular.

Aşağıdaki kısıtlama listesinde, Cloud projelerinin ortak Drive'larla nasıl etkileşimde bulunduğu açıklanmaktadır:

  • Komut dosyası projeniz standart bir proje kullanıyorsa komut dosyası projesi bir ortak Drive'da yer aldığında ek kısıtlamalar olmaz.
  • Komut dosyası projeniz, 8 Nisan 2019'da veya sonrasında oluşturulan bir varsayılan proje kullanıyorsa komut dosyası projesi bir ortak Drive'da yer alıyorsa herhangi bir ek kısıtlama söz konusu değildir.
  • Komut dosyası projeniz, 8 Nisan 2019'dan önce oluşturulmuş bir varsayılan proje kullanıyorsa komut dosyası projesi bir ortak drive'da bulunduğu sürece aşağıdaki kısıtlamalar geçerli olur:
    1. Apps Komut Dosyası kullanıcı arayüzünü veya Google Cloud konsolunu 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 bir ortak Drive'a taşıdığınızda Google, varsayılan Cloud projesine erişimi kısıtlar. Taşıma işleminden önce zaten erişiminiz varsa varsayılan projeye erişebilirsiniz. Örneğin, Drive'ım klasörünüzde bir komut dosyası oluşturup bunu bir ortak Drive'a taşıdıysanız bu komut dosyasının Cloud projesine erişmeye devam edebilirsiniz. Ortak Drive'daki ortak çalışanlarınız bunu yapamayabilir.
    4. Komut dosyası, ortak Drive'a taşınmadan önceki Cloud projesinin adını korur. Ortak Drive'daki proje adını değiştirseniz bile, komut dosyasını yetkilendiren kullanıcılar yetkilendirme iletişim kutularında eski adı görmeye devam eder.

Eski komut dosyaları için yukarıdaki kısıtlamalardan kaçınmak amacıyla 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 bu klasördeki tüm standart ve varsayılan Apps Komut Dosyası projelerini görüntüleyebilirsiniz.

  1. Google Cloud Console Kaynakları Yönet sayfasını açın.
  2. Apps Komut Dosyası 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ı Bulut projelerini silin

Bir Apps Komut Dosyası Cloud projesini silmek için Apps Komut Dosyası Bulut 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) bölümüne göz atın.