Her Apps Komut Dosyası projesinin kullandığı Google Cloud ile yetkilendirmeyi, gelişmiş hizmetleri ve diğer ayrıntıları belirtin. Bu ayarları yapılandırmak ve yönetmek için her Apps Komut Dosyası projesinin bir ilişkili Google Cloud projesi Komut dosyası projenizde Apps Komut Dosyası'nın kullanıldığı varsayılan proje otomatik olarak oluşturur veya oluşturduğunuz standart proje kendiniz. Genel olarak varsayılan projeler günlük veya basit projeler için uygundur ancak bu komut dosyalarını içeren herhangi bir uygulama için standart karmaşık, ticari kalitede olması veya yayınlamayı amaçladığınız içerikler.
Varsayılan projeden standart projeye geçiş yapabilirsiniz kullanabilirsiniz, ancak varsayılan projeyi kullanmaya geri dönemezsiniz. En iyisi komut dosyanızın geliştirmenin başlarında kullandığı Cloud projesini seçin. Daha sonra geçiş yapmak, kullanıcılarınızın yeniden yetkilendirin.
Varsayılan Cloud projeleri
Bir Apps Komut Dosyası projesi oluşturduğunuzda Apps Komut Dosyası varsayılan Arka planda çalışan bir bulut projesi.
- Çoğu komut dosyası için bu varsayılan projeyi hiçbir zaman görmeniz veya ayarlamanız gerekmez. Uygulamalar Komut dosyası, Google Cloud ile gerekli etkileşimleri gerçekleştirir. Örneğin, Apps Komut Dosyası düzenleyicisi, Apps Komut Dosyası'nda gelişmiş bir hizmeti etkinleştirirseniz tıkladığınızda varsayılan Cloud projesinde gelişmiş hizmeti etkinleştirir. komut dosyası projesini kaydedin.
- Bazı komut dosyaları için Google Cloud konsoluyla etkileşimde bulunmanız gerekir. Bu durumlarda komut dosyanızın standart bir Cloud projesi kullanması gerekir. Örneğin, Örneğin, Google Cloud günlüklerini Google Cloud konsolunda görüntülemek için komut dosyanızın en iyi uygulamaları paylaşacağım.
Cloud projelerinde varsayılan olarak Kimlik ve Erişim Yönetimi bulunur
hesabı sahibi olan Google hizmet hesabı, tek girişli bir (IAM) politikası
varsayılan projedir. 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ı, Chrome Tarayıcı'da varsayılan projeleri doğrudan bulamaz, görüntüleyemez veya Google Cloud konsolunu kullanın. 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 varsayılan proje. Şuna erişmek için: komut dosyası projesinin ayarlarına gidip projeyi tıklayın sayı.
Varsayılan Cloud projelerini silin
Yöneticiyseniz varsayılan Cloud projelerini istediğiniz gibi silebilirsiniz standart Cloud projeleri için geçerlidir. 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 proje kullanacak şekilde değiştirirseniz Apps Komut dosyası, komut dosyasına eklenen varsayılan projeyi, veya bilgi içerir.
- 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 siler. Apps Komut Dosyası, komut dosyası.
Standart Cloud projeleri
Varsayılan Cloud projeleri, çoğu komut dosyası projesi için en iyi seçenektir. Projeyi manuel olarak yapılandırmanız gerekmiyorsa. Böyle durumlarda komut dosyası projenizi standart bir proje kullanacak şekilde değiştirin.
Aşağıdaki bölümlerde Apps Komut Dosyası'nın ne zaman standart bir proje gerektirdiği, proje özelliklerini ve bunlarla yapılan ortak görevleri gözden geçirmeyi öğreteceğim. Yalnızca aşağıdaki görevleri standart projelerle nasıl gerçekleştireceğinizi öğreneceksiniz.
Apps Komut Dosyası, standart Cloud projeleri gerektirdiğinde
Aşağıdaki durumlarda standart bir proje kullanmanız gerekir:
- Komut dosyası projenizi eklenti Google Workspace Marketplace'ten edinebilirsiniz.
- Komut dosyası projenizin OAuth istemcisini doğrulamak için:
- İşlevleri çalıştırması gereken bir uygulamanız varsa
komut dosyası projesinin
Apps Script API'nin
scripts.run
yöntemi. - Komut dosyası projenizin Google Cloud günlüklerini Google Cloud konsolunu kullanın. Google Cloud Console, filtreleme ve performans için basitleştirilmiş bir görünüm sunar ve Apps Komut Dosyası kontrol paneli.
- Komut dosyası projenizin hata raporlarını aşağıdakileri kullanarak görüntülemek için: Error Reporting.
- Dosya açma iletişim kutusu oluşturmak için.
- Projenin kalite yönetimi üzerinde manuel kontrole ihtiyaç Google Cloud ayarları.
Standart Cloud projesi özellikleri
Standart projeler aşağıdaki özelliklere sahiptir:
- Projenin tüm Google Cloud ayarlarına doğrudan erişebilirsiniz Google Cloud Console'dan indirebilirsiniz. Bu sayede API'leri etkinleştirebilir, yetkilendirmeyi ayarlayabilirsiniz. kimlik bilgilerini girin ve diğer ayrıntıları yapılandırın.
- Bir komut dosyası projesini sildiğinizde veya başka bir standart proje kullanırsanız orijinal standart proje kalır ve yeniden kullanıldı.
- Bir gelişmiş hizmeti etkinleştirdiğinizde bir komut dosyası projesinde kullanmak istiyorsanız standart bir projedir.
- Birden fazla komut dosyası projesi ve diğer uygulamalar aynı şeyi paylaşabilir standart bir projedir. Bir komut dosyası projesi yayınlamayı planlıyorsanız değerini Google Workspace Marketplace eklenti olarak kendine ait standart bir projesi olmalıdır. Yayınlanan uygulamalar paylaşılamaz Diğer uygulamalarla bulut projeleri.
- İşlevleri bir komut dosyası projesinde çalıştırmak istiyorsanız
Apps Script API'nin
scripts.run
yöntemini kullanıyorsanız komut dosyası projesi ve çağrı uygulama, aynı standardı paylaşmalıdır. belirler. - Apps Komut Dosyası, bir kullanıcıdan standart projesi için Cloud projesinin adı, komut dosyasını tanımlamak için kullanılır ( komut dosyası proje adı) kaldırın. Bu nedenle, soruna yol açabilecek bir Cloud projesinin adı.
Standart bir Cloud projesine erişim
Komut dosyanızla ilişkilendirilmiş standart projeye erişmek için projeyi tamamlamak için aşağıdakileri yapın:
- Apps Komut Dosyası projesini açın.
- Solda Proje Ayarları'nı tıklayın.
- 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. Bunu yapmak için ilgili Cloud projesinde API'yi etkinleştirmeniz gerekir. Aşağıdakileri yaparak bir API'yi etkinleştirin:
- Cloud projesini açın.
- Menü'yü > API'lar ve Hizmetler. tıklayın.
- API'leri ve Hizmetleri Etkinleştir'i tıklayın.
- Arama kutusuna etkinleştirmek istediğiniz API'yi girin ve Enter tuşuna basın.
- Arama sonuçlarından API'yi tıklayın ve ardından etkinleştirmek için Etkinleştir'i tıklayın. API'yi kullanabilirsiniz.
Hizmet Şartları'nı kabul etmeniz istenebilir: Google API'leri veya Google Cloud. Şartları gözden geçirin Hizmetleri'nin koşullarını kabul etmeden önce dikkatlice gözden geçirin.
Uygulamaya bağlı olarak API'yi API'ler ve Hizmetler kontrol paneline gidin.
Kimliği ve standart bir Cloud projesinin numarası
Tüm Cloud projelerinin bir proje adı, proje kimliği ve proje numarası bulunur. Bazen bu tanımlayıcıların olması gerekir. hizmetleri yapılandırabilir veya diğer görevleri tamamlayabilir.
Standart projenizin kimliğini ve numarasını belirlemek için aşağıdakileri yapın:
- Cloud projesini açın.
- Sağ üstte Diğer'i > Proje ayarları'nı tıklayın. tıklayın
- Proje adı, Proje kimliği ve Proje numarası'nı görüntüleyin. Ayarlar panelinde görünür. Proje numarası yalnızca şunlardan oluşur: rakamlardır; Proje Kimliği ise alfanümerik bir değerdir. Bu sayfada Yetkilendirme istemleri sırasında kullanıcılara gösterilen proje adı.
Google Cloud günlüklerini ve Google Cloud konsolundaki hata raporları
Google Cloud Logging kullanıyorsanız veya hata bildirimi bu günlükleri ve raporları şurada görüntüleyebilirsiniz: Google Cloud Console'da şunları yapabilirsiniz:
- Cloud projesini açın.
- Menü'yü tıklayın.
- İşlemler bölümüne ilerleyin ve Günlük Kaydı > Günlük gezgini'ni tıklayın.
- Hata raporlarını görüntülemek için İşlemler bölümüne ilerleyin ve Error Reporting'i tıklayın. Sizden Bu, komut dosyası projenizin hata raporlamaya henüz herhangi bir istisna kaydetmedi.
OAuth izin ekranını tamamlayın
OAuth gerektiren hizmetler kullanılırken Google, kullanıcılardan bu hizmetleri yetkilendirmelerini ister. kullanıma sunuyoruz. OAuth izin ekranı ayarları, bilgilerinizin bir kısmını ayarlamanıza olanak tanır. Google'ın kullanıcılara sunduğu olanaklar, örneğin Uygulama adı ve Hizmet Şartları URL'si.
Varsayılan Cloud projeleri, Apps Komut Dosyası projesinin ayrıntıları; bu ayarları değiştiremezsiniz. Standart Cloud projeleri bu bilgileri özelleştirebilirsiniz. Komut dosyanızın iznini yapılandırabilirsiniz şunları yapın:
- Cloud projesini açın.
- Menü'yü > API'lar ve Hizmetler > Kimlik bilgileri. tıklayın.
- Configure consent screen (İzin ekranını yapılandır) seçeneğini tıklayın.
- İzin ekranı iş akışının her bölümünü doldurun.
- İş akışının her aşamasında değişikliklerinizi kaydetmek için Kaydet ve devam et.
OAuth kimlik bilgileri oluşturma
Apps Komut Dosyası, kullandığınız hizmetler için OAuth'u genellikle ayarlar açıklayacağım. Bazı uygulamalarda, OAuth kimlik bilgileri (istemci kimlikleri ve istemci gizli anahtarları). Bu işlemi yalnızca standart projelerdir.
Komut dosyası projeniz için bir istemci kimliği ve istemci gizli anahtarı oluşturmak üzere takip etmek için:
- Cloud projesini açın.
- Menü'yü > API'lar ve Hizmetler > Kimlik bilgileri. tıklayın.
- Kimlik bilgileri oluştur > seçeneğini tıklayın. OAuth istemci kimliği.
- 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.
- Açılan iletişim kutusunda JSON'u indir'i tıklayın. Şunları yapabilirsiniz: OAuth'u yapılandırmak için bu dosyayı kullanın.
Standart Cloud projesine ek sahipler ekleme
Standart bir projeye ek sahipler veya başka roller ekleyebilirsiniz. Bir proje üzerinde iş birliği yapıyorsanız bu, ekibinizdeki birinin ekibinin her zaman komut dosyası projesinin Google Cloud ayarlarına erişimi vardır.
Şu adımları uygulayarak standart bir projeye ek sahipler veya başka roller ekleyebilirsiniz: takip ediliyor. Aşağıdakilerden herhangi birini yapabilmek için projede düzenleme izinlerine sahip olmanız gerekir: şu değişiklikler var:
- Ortak çalışanlarınızın kim olması gerektiğini belirleyin. Önerilerimiz: Google Grubu oluşturun veya mevcut bir Google Grubu'nu kullanın. Şunları yapabilirsiniz: aynı zamanda ortak çalışan listesinde, bu gruptaki tüm kullanıcıları alan.
- Komut dosyasının Cloud projesini açın.
- Menü'yü > IAM ve yönetici > IAM. tıklayın.
- Üst tarafta Ekle'yi tıklayın.
- Bir veya daha fazla yeni üye eklemek için ekrandaki talimatları uygulayın. rolleri açıkladık. E-postaları ayrı ayrı ekleyebilirsiniz, Google Gruplarını alanları yeni üye olarak kabul eder.
- Kaydet'i tıklayın.
Tek bir Cloud projesiyle birden fazla komut dosyasını gruplandırma
Aynı standardı paylaşan birden fazla Apps Komut Dosyası projeniz olabilir Cloud projesi. Bunu yapmak için standart bir proje oluşturun ve her komut dosyası projesini değiştirin sahip olacaksınız. Bu işlemi varsayılan projelerle yapamazsınız.
Farklı bir standart Cloud projesi kullanın
Komut dosyası projesini, farklı bir standart kullanacak şekilde değiştirebilirsiniz Cloud projesi. Komut dosyanız Cloud projesi için varsayılan projeden standart belirler. Öğrenmek için standart bir projeyi ne zaman kullanacağınızla ilgili daha fazla bilgi için standart bulut projeleri için geçerlidir.
Farklı bir standart Cloud projesine geçmenin etkileri
Komut dosyanızı varsayılan projeden farklı bir standarda geçirirseniz aşağıdaki etkileri olur:
- Komut dosyanız için gelişmiş hizmetleri etkinleştirdiyseniz İlgili API'ler, yeni Cloud projesinde yer alıyor. Gelişmiş Ayarlar'a bağlı tüm verileri kullanıma sunulmasını isteyebilir. API'leri nasıl etkinleştireceğinizi öğrenmek için Cloud projenizde 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'si.
Standart Cloud projenizde Drive API'yi etkinleştirin:
- Daha önce komut dosyası için yetki veren tüm kullanıcıların yeniden yetkilendirmesi gerekir. İçinde ile ilişkili uygulamaları daha önce yetkilendirmiş tüm kullanıcılar, yeni projenin yeniden yetkilendirilmesi 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 üzerine konuşacağız. Yeni projede bir uygulama girişi oluşturmanız ve kullanıcıların uygulamanızı yeniden yüklemesi gerekir. Yeni bir Uygulama yayınlama bölümüne bakın.
- Bir komut dosyasını tekrar varsayılan projeye döndüremezsiniz. Apps Komut Dosyası silme işlemleri komut dosyasını standart proje kullanacak şekilde ayarladıktan sonra varsayılan projelere öncelik vermektir.
Farklı bir standart Cloud projesine geçin
Bir komut dosyasının mevcut Cloud projesini başka bir Cloud projesine geçirmek için Cloud projesi için aşağıdaki adımları uygulayın:
- Uygun bir Cloud projeniz yoksa yeni bir Proje oluşturma bakın. Akılda kalıcı bir proje adı belirleyin. Google Cloud Console Kaynakları Yönet sayfasında bulabilirsiniz. Apps Komut Dosyası, aşağıdaki durumlarda bu adı kullanır: kullanıcılardan komut dosyasını yetkilendirmelerini isteme.
- Mevcut bir projeyi kullanmak istiyorsanız Google Cloud Console Kaynakları Yönet sayfasını açın. ve kullanılacak mevcut bir projeyi bulabilirsiniz. Her bir Proje Tarayıcısı ve OAuth Yapılandırması Düzenleyici rolleri veya eşdeğer olan roller ve izinler belirler. Apps tarafından otomatik olarak oluşturulan bir projeyi kullanamazsınız Komut dosyası.
- Cloud projenizin Proje numarasını belirleyin.
- Cloud projesini değiştirmek istediğiniz komut dosyasını açın.
- Solda Proje Ayarları'nı tıklayın. .
- Google Cloud Platform (GCP) Project bölümünde Projeyi değiştir seçeneğini tıklayın.
- 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ı üzerinde ortak çalışma yapabileceği paylaşılan alanlar Drive dokümanları için de geçerlidir. Ortak drive'lar, geliştirme eklentilerin ve web uygulamalarının yer aldığı bir ekiple çalışır, ancak neler yapabileceğinizi açıklayacağım.
Aşağıdaki kısıtlama listesinde Cloud projelerinin nasıl etkileşimde bulunduğu açıklanmaktadır ortak drive'larla:
- Komut dosyası projeniz standart bir proje kullanıyorsa komut dosyası projesi bir ortak drive'da bulunuyorsa ek kısıtlamalar söz konusudur.
- Komut dosyası projeniz, 8 Nisan 2019'dan sonra ise komut dosyası yer aldığına benzer.
- Komut dosyası projeniz, önceden oluşturulmuş bir varsayılan proje kullanıyorsa
8 Nisan 2019 itibarıyla komut dosyasıyla ilgili aşağıdaki kısıtlamalar geçerli olur:
projenin ortak drive’da bulunması:
- Varsayılan projeye Apps Komut Dosyası kullanıcı arayüzünü kullanarak veya Google Cloud Console'da oturum açın. Bu kısıtlama, projeye doğrudan erişimi gerektiren işlemlerdir.
- Gelişmiş hizmetleri etkinleştiremezsiniz. Gelişmiş hizmetleri etkinleştirmek için standart bir hizmete geçiş yapın belirler.
- Mevcut bir Apps Komut Dosyası projesini ortak Drive'a taşıdığınızda, Google varsayılan Cloud projesine erişimi kısıtlar. Hâlâ Taşıma işleminden önce erişiminiz varsa varsayılan projeye erişebilirsiniz. Örneğin, Örneğin, Drive'ım klasörünüzde bir komut dosyası oluşturduysanız ve daha sonra ortak drive'a aktarmayı tercih ederseniz, Cloud projesi. Ortak Drive'daki ortak çalışanlarınız bunu yapamayabilir.
- Komut dosyası, oluşturulmadan önceki Cloud projesinin adını korur şu konuma taşındı: bir ortak drive'a dokunun. Ortak drive'da proje adını değiştirseniz bile komut dosyasını yetkilendiren kullanıcılar, yetkilendirme sırasında eski adı görmeye devam eder tıklayın.
Eski komut dosyaları için yukarıdaki kısıtlamalardan kaçınmak amacıyla daha fazla bilgi edinin.
Apps Komut Dosyası Cloud projelerinin listesini alma
resourcemanager.projects.list
Apps Komut Dosyası proje klasörünü paylaştığında, tüm standart ve
varsayılan Apps Komut Dosyası Bulutu projelerini kapsar.
- Google Cloud Console Kaynakları Yönet sayfasını açın.
- Apps Komut Dosyası klasörünün yanındaki kimliği kopyalayın.
- Filtre > Ebeveyn kimliği'ni tıklayıp yapıştırın Apps Komut Dosyası klasör kimliği.
Apps Komut Dosyası Bulut projelerini silin
Bir Apps Komut Dosyası Cloud projesini silmek için Apps Komut Dosyası Cloud projelerinin listesini oluştur silmek istediğiniz projeyi seçin ve tıklayın Sil.
gcloud
kullanarak bir Apps Komut Dosyası projesini silmek için aşağıdaki komutu kullanın:
komutlarının ikisine katlanır.
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 Kapatmak üzere inceleyin. (silinmesi) gereken başka işlemler de vardır..