Google Cloud projeleri

Her Apps Komut Dosyası projesi; yetkilendirme, 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 proje veya kendi oluşturduğunuz bir standart proje kullanabilir. Genel olarak, varsayılan projeler günlük veya basit komut dosyaları için uygundur ancak karmaşık, ticari kalitede ya da yayınlamayı planladığınız herhangi bir uygulama için standart bir proje kullanmalısınız.

İstediğiniz zaman varsayılan bir projeden standart bir projeye geçiş yapabilirsiniz ancak varsayılan bir projeyi kullanmak için geri dönemezsiniz. Komut dosyanızın geliştirmenin başlarında kullandığı Cloud projesini seçmeniz önerilir. Daha sonra geçiş yapmak, kullanıcılarınızın yeniden yetkilendirmeyi gerektirmesi 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üzenleyicisinde gelişmiş bir hizmeti etkinleştirirseniz komut dosyası projesini kaydettiğinizde Apps Komut Dosyası, 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ın 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 projeleri, tek girişli bir Identity and Access Management (IAM) politikasına sahiptir ve bu politika, varsayılan projenin sahibi olarak görev yapan 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ı varsayılan projeleri doğrudan Google Cloud Console'da 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 projeyi 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 varsayılan Cloud projelerini, standart Cloud projelerinde olduğu 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ı, aşağıdaki senaryolarda varsayılan projeleri siler:

  • Komut dosyası projesini siler veya projeyi standart bir proje 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 gerekmedikçe çoğu komut dosyası projesi için en iyi seçenektir. Bu durumlarda, komut dosyası projenizi standart 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 yapılan yaygın görevler açıklanmaktadır. Standart projelerle yalnızca aşağıdaki görevleri gerçekleştirebilirsiniz.

Apps Komut Dosyası, standart Cloud projeleri gerektirdiğinde

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

Standart Cloud projesi özellikleri

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

  • Proje için tüm Google Cloud ayarlarına doğrudan Google Cloud Console'dan erişebilirsiniz. Böylece 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. Bir komut dosyası projesini Google Workspace Marketplace'te bir 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 Script API'nin scripts.run yöntemini kullanarak başka bir uygulamadan komut dosyası projesindeki işlevleri yürütmek istiyorsanız komut dosyası projesi ve çağıran uygulama aynı standart projeyi paylaşmalıdır.
  • Apps Komut Dosyası, 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ı proje adı değil). Bu nedenle, uygun bir Cloud projesi adı belirlediğinizden emin olun.

Standart bir Cloud projesine erişme

Komut dosyası projenizle ilişkili 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 (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 etkinleştirme

Genellikle bir Apps Komut Dosyası uygulamasının başka bir Google API'ye erişmesi gerekir. Bunu yapmak 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 girip Enter tuşuna basın.
  5. Arama sonuçlarından API'yi 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 için Hizmet Şartları'nı kabul etmeniz istenebilir. Hizmet Şartları'nı kabul etmeden önce dikkatlice inceleyin.

Uygulamaya bağlı olarak API'yi API'ler ve Hizmetler kontrol panelinden 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. Bazı durumlarda 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. Açılan Ayarlar panelinde Proje adı, Proje kimliği ve Proje numarası bilgilerini görüntüleyin. Proje numarası yalnızca rakamlardan oluşurken Proje Kimliği alfasayısaldır. Yetkilendirme istemleri sırasında kullanıcılara gösterilen Proje adı'nı düzenleyebilirsiniz.

Google Cloud konsolunda 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 raporu kullanıyorsanız bu günlükleri ve raporları Google Cloud Console'da aşağıdakileri yaparak görüntüleyebilirsiniz:

  1. Cloud projesini açın.
  2. Menü'yü tıklayın.
  3. İşlemler bölümüne ilerleyin 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 Bildirimi'ni tıklayın. Hata raporlamayı ayarlamanız istenirse komut dosyası projenizin henüz istisna kaydetmediği anlamına gelir.

OAuth gerektiren hizmetler kullanılırken Google, kullanıcılardan bu hizmetleri yetkilendirmelerini ister. OAuth izin ekranı ayarları, Google'ın kullanıcılara sunduğu uygulama adı ve Hizmet Şartları URL'si gibi bazı bilgileri 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ştirmenizi sağlar. Komut dosyanızın izin ekranını aşağıdakileri yaparak 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 yaptığınız değişiklikleri kaydetmek için Kaydet ve devam et'i tıklayın.

OAuth kimlik bilgileri oluştur

Apps Komut Dosyası, genellikle komut dosyanızın kullandığı hizmetler için OAuth'u kurar. 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 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ü altında uygulama türünüzü seçin ve gerekirse görüntülenen 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 ek sahip ekleme

Standart projelere ek sahipler veya başka roller ekleyebilirsiniz. Bir proje üzerinde ortak çalışıyorsanız bu işlem, ekibinizdeki bir kullanıcının komut dosyası projesinin Google Cloud ayarlarına her zaman erişebilmesini sağlar.

Aşağıdakileri yaparak standart bir projeye başka sahipler veya başka roller ekleyebilirsiniz. Aşağıdaki 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. Ayrıca, ortak çalışan listesinde alanları belirterek bu alandaki tüm kullanıcıları dahil edebilirsiniz.
  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 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.

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

Aynı standart Cloud projesini paylaşan birden fazla Apps Komut Dosyası projeniz olabilir. Bunu yapmak için bir standart proje oluşturun ve daha sonra her komut dosyası projesini bunu kullanacak şekilde değiştirin. Bu işlemi varsayılan projelerle yapamazsınız.

Farklı bir standart Cloud projesi kullan

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 projeye geçmeniz gerekir. Standart projeleri 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 projeden veya farklı bir standart projeye geçirirseniz aşağıdaki etkileri olur:

  • Komut dosyanız için gelişmiş hizmetleri etkinleştirdiyseniz yeni Cloud projesinde ilgili API'leri etkinleştirmeniz gerekir. Önceki Cloud projesinde bulunan gelişmiş hizmetlere bağlı 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

  • Komut dosyasını daha önce yetkilendirmiş olan tüm kullanıcıların yeniden yetkilendirme yapması 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şkiliyse uygulama girişiniz, kullanıcılarınız ve yorumlarınız yeni projeye taşınmaz. Yeni proje içinde bir uygulama girişi oluşturmanız ve kullanıcılarınızın uygulamanızı yeniden yüklemeleri gerekir. Yeni bir 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 projeyi kullanacak şekilde ayarlamanızdan 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 şu 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ı belirleyin. 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 kullanmak istediğiniz mevcut bir proje bulun. Proje için Proje Tarayıcı ve OAuth Yapılandırması Düzenleyicisi rollerine veya eşdeğer izinlere sahip rollere sahip olmanız gerekir. Apps Komut Dosyası tarafından otomatik olarak oluşturulmuş 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) Project (Google Cloud Platform (GCP) Projesi) bölümünde Change project (Projeyi değiştir) seçeneğini tıklayın.
  7. Yeni proje numarasını girin ve Proje 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 Drive'lar; bir ekiple komut dosyası, eklenti ve web uygulamaları geliştirirken değerlidir ancak eski varsayılan Cloud projelerinde yapabileceklerinize bazı kısıtlamalar getirir.

Aşağıdaki kısıtlamalar 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 bulunduğunda ek kısıtlamalar uygulanmaz.
  • Komut dosyası projeniz, 8 Nisan 2019'da veya sonrasında oluşturulmuş bir varsayılan proje kullanıyorsa komut dosyası projesi bir ortak Drive'da bulunduğunda ek kısıtlamalar uygulanmaz.
  • 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 uygulanır:
    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 öncesinde erişiminiz varsa varsayılan projeye yine erişebilirsiniz. Örneğin, Drive'ım klasörünüzde bir komut dosyası oluşturduktan sonra bunu bir ortak Drive'a taşıdıysanız komut dosyasının Cloud projesine yine erişebilirsiniz. Ortak Drive'daki ortak çalışanlarınız bu işlemi yapamayabilir.
    4. Komut dosyası, ortak Drive'a taşınmadan önce 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ında yukarıdaki kısıtlamalardan kaçınmak için standart bir projeye geçin.

Apps Komut Dosyası Bulut projelerinin listesini alma

Kuruluşunuzun Apps Komut Dosyası proje klasörü için resourcemanager.projects.list izniniz varsa bu klasör içindeki 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 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 silin

Bir Apps Komut Dosyası Bulut 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 edinmek için Projeleri kapatma (silme) bölümüne bakın.