Kodlama seviyesi: Orta
Süre: 30 dakika
Proje türü: Google Workspace eklentisi
Hedefler
- Çözümün ne yaptığını anlayın.
- Apps Script hizmetlerinin çözümde ne yaptığını anlayın.
- Ortamı ayarlayın.
- Komut dosyasını ayarlayın.
- Komut dosyasını çalıştırın.
Bu çözüm hakkında
Google E-Tablolar makrolarını bir e-tablodan diğerine manuel olarak kopyalamak zaman alıcı ve hataya açık bir işlem olabilir. Bu Google Workspace eklentisi, bir komut dosyası projesini otomatik olarak kopyalayıp kullanıcı tarafından belirtilen bir e-tabloya ekler. Bu çözüm E-Tablolar makrolarına odaklansa da kapsayıcıya bağlı herhangi bir komut dosyasını kopyalamak ve paylaşmak için kullanabilirsiniz.
İşleyiş şekli
Komut dosyası, orijinal e-tabloya bağlı Apps Komut Dosyası projesini kopyalar ve kullanıcı tarafından belirtilen e-tabloya bağlı yinelenen bir Apps Komut Dosyası projesi oluşturur.
Apps Komut Dosyası hizmetleri
Bu çözüm aşağıdaki hizmetleri kullanır:
- URL Fetch hizmeti: Kaynak projeyi kopyalamak ve bir kopya oluşturmak için Apps Script API'ye bağlanır.
- Komut dosyası hizmeti: İkinci bir yetkilendirme istemi gösterilmemesi için Apps Script API'yi yetkilendirir.
- E-Tablo hizmeti: Kopyalanan Apps Komut Dosyası projesini eklemek için hedef e-tabloyu açar.
- Kart hizmeti: Eklentinin kullanıcı arayüzünü oluşturur.
Ön koşullar
Bu örneği kullanmak için aşağıdaki ön koşullara sahip olmanız gerekir:
- Google Hesabı (Google Workspace hesapları için yönetici onayı gerekebilir).
İnternete erişimi olan bir web tarayıcısı.
Google Apps Script API, Apps Script kontrol paneli ayarlarında etkinleştirilmelidir.
Ortamınızı ayarlama
Cloud projenizi Google Cloud Console'da açma
Henüz açık değilse bu örnek için kullanmayı planladığınız Cloud projesini açın:
- Google Cloud Console'da Proje seçin sayfasına gidin.
- Kullanmak istediğiniz Google Cloud projesini seçin. Alternatif olarak Proje oluştur'u tıklayıp ekrandaki talimatları uygulayın. Google Cloud projesi oluşturursanız proje için faturalandırmayı etkinleştirmeniz gerekebilir.
Google Apps Script API'yi etkinleştirme
Bu hızlı başlangıç kılavuzunda Google Apps Script API'si kullanılmaktadır.
Google API'lerini kullanmadan önce bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API'yi etkinleştirebilirsiniz.Cloud projenizde Google Apps Komut Dosyası API'sini etkinleştirin.
OAuth izin ekranını yapılandırma
Google Workspace eklentileri için izin ekranı yapılandırması gerekir. Eklentinizin OAuth kullanıcı rızası ekranını yapılandırarak Google'ın kullanıcılara ne göstereceğini belirleyebilirsiniz.
- Google Cloud Console'da Menü > > Markalaşma'ya gidin.
- 'ü zaten yapılandırdıysanız Marka, Kitle ve Veri Erişimi'nde aşağıdaki OAuth kullanıcı rızası ekranı ayarlarını yapılandırabilirsiniz. Henüz yapılandırılmadı yazan bir mesaj görürseniz Başlayın'ı tıklayın:
- Uygulama bilgileri bölümündeki Uygulama adı alanına uygulamanın adını girin.
- Kullanıcı destek e-postası bölümünde, kullanıcıların izinleriyle ilgili soruları için sizinle iletişime geçebileceği bir destek e-posta adresi seçin.
- İleri'yi tıklayın.
- Kitle bölümünde Dahili'yi seçin.
- İleri'yi tıklayın.
- İletişim bilgileri bölümünde, projenizde yapılan değişikliklerle ilgili bildirim alabileceğiniz bir e-posta adresi girin.
- İleri'yi tıklayın.
- Son bölümünde Google API Hizmetleri Kullanıcı Verileri Politikası'nı inceleyin ve kabul ediyorsanız Google API Hizmetleri: Kullanıcı Verileri Politikası'nı kabul ediyorum'u seçin.
- Devam'ı tıklayın.
- Oluştur'u tıklayın.
- Şu anda kapsam eklemeyi atlayabilirsiniz. Gelecekte, Google Workspace kuruluşunuzun dışında kullanılacak bir uygulama oluşturduğunuzda Kullanıcı türü'nü Harici olarak değiştirmeniz gerekir. Ardından, uygulamanızın ihtiyaç duyduğu yetkilendirme kapsamlarını ekleyin. Daha fazla bilgi edinmek için OAuth iznini yapılandırma kılavuzunun tamamını inceleyin.
Komut dosyasını ayarlama
Apps Komut Dosyası projesini oluşturma
- Makro paylaşma Apps Script projesini açmak için aşağıdaki düğmeyi tıklayın.
Projeyi açma - Genel bakış'ı tıklayın.
- Genel bakış sayfasında Kopya oluştur'u
tıklayın.
Cloud proje numarasını kopyalama
- Google Cloud Console'da Menü > IAM ve Yönetici > Ayarlar'a gidin.
- Proje numarası alanındaki değeri kopyalayın.
Apps Komut Dosyası projesinin Cloud projesini ayarlama
- Kopyalanan Apps Komut Dosyası projenizde Proje Ayarları'nı
tıklayın.
- Google Cloud Platform (GCP) Projesi bölümünde Projeyi değiştir'i tıklayın.
- GCP proje numarası alanına Google Cloud proje numarasını yapıştırın.
- Proje ayarla'yı tıklayın.
Test dağıtımı yükleme
- Kopyalanan Apps Komut Dosyası projenizde Düzenleyici'yi tıklayın .
UI.gs
dosyasını açın ve Çalıştır'ı tıklayın. İstendiğinde komut dosyasını yetkilendirin.- Dağıt > Dağıtım testleri'ni tıklayın.
- Yükle > Bitti'yi tıklayın.
Makro komut dosyasını ve e-tablo bilgilerini alma
- Makro içeren ve düzenleme izniniz olan bir E-Tablolar e-tablosunu açın. Örnek e-tabloyu kullanmak için Örnek makro e-tablosunun bir kopyasını oluşturun.
- Uzantılar > Apps Komut Dosyası'nı tıklayın.
- Apps Komut Dosyası projesinde Proje ayarları'nı
tıklayın.
- Komut dosyası kimliğinin altında Kopyala'yı tıklayın.
- Komut dosyası kimliğini daha sonraki bir adımda kullanmak üzere bir kenara koyun.
- Makroyu eklemek istediğiniz e-tabloyu açın veya yeni bir e-tablo oluşturun. E-tabloyu düzenleme izniniz olmalıdır.
- E-tablo URL'sini kopyalayıp daha sonraki bir adımda kullanmak üzere bir kenara koyun.
Komut dosyasını çalıştırma
Kontrol paneli ayarlarınızda Google Apps Script API'nin etkinleştirildiğinden emin olun. Komut dosyanızı çalıştırmak için aşağıdaki bölümlerdeki adımları uygulayın.
Makroyu kopyalama
- E-Tablolar'da, sağ kenar çubuğundaki Makroyu Paylaş eklentisini
açın.
- Kaynak makrosu'nun altına komut dosyası kimliğini yapıştırın.
- Hedef e-tablo alanına e-tablo URL'sini yapıştırın.
- Makroyu paylaş'ı tıklayın.
- Erişimi yetkilendir'i tıklayın ve eklentiyi yetkilendirin.
- 2-4 arasındaki adımları tekrarlayın.
Kopyalanan makroyu açma
- Henüz açık değilse makroyu kopyaladığınız e-tabloyu açın.
- Uzantılar > Apps Komut Dosyası'nı tıklayın.
- Kopyalanan Apps Script projesini görmüyorsanız kontrol paneli ayarlarında Google Apps Script API'nin etkinleştirildiğinden emin olun ve Makroyu kopyala bölümünde listelenen adımları tekrarlayın.
Kodu inceleme
Bu çözümün Apps Komut Dosyası kodunu incelemek için aşağıdaki Kaynak kodunu görüntüle'yi tıklayın:
Kaynak kodu göster
Code.gs
UI.gs
appsscript.json
Katkıda bulunanlar
Bu örnek, Google Geliştirici Uzmanları'nın yardımıyla Google tarafından yönetilir.
Sonraki adımlar
- Google Workspace'i eklentilerle genişletin
- Google Workspace eklentileri oluşturma
- Uygulama yayınlama