Google Cloud projeleri

Her Apps Komut Dosyası projesinde yetkilendirme, gelişmiş hizmetler ve diğer ayrıntıları yönetmek için Google Cloud kullanılı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 proje veya kendinizin oluşturduğu bir standart proje kullanabilir. Genel olarak, varsayılan projeler günlük veya basit senaryolar için uygundur ancak karmaşık, ticari kalitede olan ya da 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 en iyisidir. Daha sonra geçiş yapmak, kullanıcılarınızın yeniden yetkilendirme yapmasını gerektirmek gibi sorunlara neden olabilir.

Varsayılan Cloud projeleri

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

  • Ç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 bir gelişmiş hizmeti etkinleştirirseniz Apps Komut Dosyası, komut dosyası projesini kaydettiğinizde gelişmiş hizmeti varsayılan Cloud projesinde etkinleştirir.
  • Bazı komut dosyaları için Google Cloud Console ile etkileşimde bulunmanız gerekir. Bu gibi durumlarda, komut dosyanız bunun yerine 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 değilseniz varsayılan projeleri manuel olarak silemezsiniz. Ancak komut dosyası projesini silerseniz veya standart bir proje kullanacak şekilde değiştirirseniz Apps Komut Dosyası, komut dosyasına eklenen varsayılan projeyi ve içerdiği tüm ayarları ya da bilgileri siler.

Standart Cloud projeleri

Projeyi manuel olarak yapılandırmanız gerekmediği sürece, çoğu komut dosyası projesi için varsayılan Cloud projeleri en iyi seçenektir. 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 ne zaman standart bir proje gerektirdiği, bu tür projelerin özellikleri ve bunlarla yapılan 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 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 projeyi 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.
  • 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ı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ı, standart bir proje kullanan bir komut dosyasını yetkilendirmesini istediğinde komut dosyasını tanımlamak için Cloud projesi 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

Komut dosyanızla ilişkili standart projeye erişmek için aşağıdakileri yapın: project, do the following:

  1. Apps Komut Dosyası projesini açın.
  2. Sol tarafta Proje Ayarları'nı 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önetin 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ğıdaki adımları uygulayarak 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. Hizmet Şartları'nı kabul etmeden önce dikkatlice inceleyin.

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

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

Tüm Cloud projelerinin proje adı, proje kimliği ve proje numarası vardır. Zaman zaman hizmetleri yapılandırmak veya diğer 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 > Proje ayarları'nı tıklayın.
  3. Sonuç olarak elde edilen Ayarlar panelinde Proje adı, Proje kimliği ve Proje numarası'nı görüntüleyin. Proje numarası yalnızca rakamlardan, proje kimliği ise alfanümerik karakterlerden oluşur. 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ğı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ü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 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 onay ekranı ayarları, Google'ın kullanıcılara sunduğu bilgilerin bir kısmını (ö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ğıdaki adımları uygulayarak 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. İ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 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şturmanız gerekir. Bu işlemi 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ü > 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 sonuçta ortaya çıkan 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. Bu dosyayı OAuth'u yapılandırmak için kullanabilirsiniz.

Standart bir Cloud projesine ek sahipler ekleme

Standart bir projeye ek sahipler veya başka roller ekleyebilirsiniz. Bir proje üzerinde ortak çalışıyorsanız bu ayar, ekibinizden birinin her zaman komut dosyası projesinin Google Cloud ayarlarına erişebilmesini sağlar.

Aşağıdaki adımları uygulayarak standart bir projeye ek sahipler veya başka roller ekleyebilirsiniz. Aşağıdaki değişiklikleri yapabilmek için projeyle ilgili düzenleme izniniz olmalıdır:

  1. İçerik sağlayıcı çalışanlarınızın kimler olacağını belirleyin. Bir Google Grubu oluşturmanızı veya mevcut bir grubu kullanmanızı öneririz. Ayrıca, iş ortakları 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ü > IAM ve yönetici > IAM'i 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 bireysel e-postalar, Google Grupları veya alanlar ekleyebilirsiniz.
  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.

Farklı bir standart Cloud projesi kullanma

Bir komut dosyası projesini farklı bir standart Cloud projesi kullanacak şekilde değiştirebilirsiniz. Komut dosyanızın Cloud projesinin manuel olarak yapılandırılması gerekiyorsa varsayılan bir projeden standart bir projeye geçmeniz gerekir. Standart proje kullanmanız gereken durumlar 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 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ını yetkilendirmiş olan tüm kullanıcıların yeniden yetkilendirme yapması 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 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ü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 bulabilmek için projenize 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 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 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ı üzerinde ortak çalışma yapabileceği paylaşılan alanlar sağlar. Ortak sürücüler, 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 kısıtlama listesinde, Cloud projelerinin ortak sürücülerle nasıl etkileşim kurduğu 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ş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 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'da proje adını değiştirseniz bile, komut dosyasını yetkilendiren kullanıcılar yetkilendirme iletişim kutularında eski adı görür.

Eski senaryolarla ilgili yukarıdaki kısıtlamalardan kaçınmak 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önetin 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ı Cloud projelerini silme

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.