Kodlama seviyesi: Orta
Süre: 30 dakika
Proje türü: Google Workspace Eklentisi
Hedefler
- Eklentinin işlevini anlayın.
- Apps Komut Dosyası'nı kullanarak eklenti oluşturmayı ve Apps Komut Dosyası hizmetlerinin ne işe yaradığını öğrenin.
- Ortamınızı ayarlayın.
- Komut dosyasını ayarlayın.
- Komut dosyasını çalıştırın.
Bu Google Workspace eklentisi hakkında
Bu örnekte, Google Kitaplar'daki bağlantıları bir Google Dokümanlar dokümanında önizleyen bir Google Workspace eklentisi oluşturacaksınız. Bir dokümana Google Kitaplar URL'si yazdığınızda veya yapıştırdığınızda, eklenti bağlantıyı tanır ve bir bağlantı önizlemesini tetikler. Bağlantıyı önizlemek için bağlantıyı akıllı çipe dönüştürebilir ve işaretçiyi bağlantının üzerinde tutarak kitap hakkında daha fazla bilgi gösteren bir kart görüntüleyebilirsiniz.
Bu eklenti, Google Books API'ye bağlanmak ve Google Dokümanlar'da görüntülemek üzere Google Kitaplar hakkında bilgi almak için Apps Komut Dosyası'nın UrlFetch Hizmeti'ni kullanır.
İşleyiş şekli
Komut dosyası, Google Workspace Eklentisi'nin manifest dosyasında eklentiyi, Google Dokümanlar'ın kapsamını genişletecek ve Google Kitaplar web sitesindeki (https://books.google.com
) belirli kalıplarla eşleşen URL'ler için bağlantı önizlemelerini tetikleyecek şekilde yapılandırır.
Kod dosyasında, komut dosyası Google Books API'ye bağlanır ve kitap hakkında bilgi almak için URL'yi kullanır (bu, Volume
kaynağının bir örneğidir). Komut dosyası, bu bilgileri kullanarak kitabın başlığını görüntüleyen bir akıllı çip ve özet, sayfa sayısı, kitap kapağının resmini ve puan sayısını görüntüleyen bir önizleme kartı oluşturur.
Apps Komut Dosyası hizmetleri
Bu eklenti aşağıdaki hizmetleri kullanır:
- UrlFetch Hizmeti: Kitaplar hakkında bilgi almak için Google Books API'ye bağlanır (API'lerin
Volume
kaynağının örnekleridir). - 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ı.
İlişkili faturalandırma hesabı olan bir Google Cloud projesi. Proje için faturalandırmayı etkinleştirme bölümüne bakın.
Ortamınızı ayarlama
Aşağıdaki bölümler, eklentiyi oluşturmak için ortamınızı ayarlar.
Google Cloud Console'da Cloud projenizi açma
Henüz açık değilse bu örnek için kullanmayı düşündüğünüz Cloud projesini açın:
- Google Cloud konsolunda Proje seçin sayfasına gidin.
- Kullanmak istediğiniz Google Cloud projesini seçin. Dilerseniz Proje oluştur'u tıklayıp ekrandaki talimatları da uygulayabilirsiniz. Google Cloud projesi oluşturursanız proje için faturalandırmayı etkinleştirmeniz gerekebilir.
Google Books API'yi açma
Bu eklenti, Google Books API'ye bağlanı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 Books API'yi etkinleştirin.
OAuth izin ekranını yapılandırın
Bu eklenti, yapılandırılmış izin ekranı olan bir Cloud projesi gerektirir. OAuth izin ekranını yapılandırmak, Google'ın kullanıcılara neler göstereceğini tanımlar ve uygulamanızı daha sonra yayınlayabilmeniz için kaydeder.
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > OAuth izin ekranı'na gidin.
- Kullanıcı türü için Dahili'yi seçin ve ardından Oluştur'u tıklayın.
- Uygulama kayıt formunu doldurup Kaydet ve Devam Et'i tıklayın.
Şimdilik kapsam eklemeyi atlayıp Kaydet ve Devam Et'i tıklayabilirsiniz. Gelecekte, Google Workspace kuruluşunuzun dışında kullanım için bir uygulama oluşturduğunuzda, Kullanıcı türü'nü Harici olarak değiştirmeniz ve ardından uygulamanızın gerektirdiği yetkilendirme kapsamlarını eklemeniz gerekir.
- Uygulama kaydı özetinizi inceleyin. Değişiklik yapmak için Düzenle'yi tıklayın. Uygulama kaydında sorun yoksa Kontrol Paneline Dön'ü tıklayın.
Google Books API için API anahtarı alma
- Google Cloud Console'a gidin. Faturalandırmanın etkin olduğu projenizin açık olduğundan emin olun.
Google Cloud konsolunda Menü > API'ler ve Hizmetler > Kimlik bilgileri'ne gidin.
Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
Daha sonraki bir adımda kullanmak üzere API anahtarınızı not edin.
Komut dosyasını ayarlama
Aşağıdaki bölümlerde, eklentiyi oluşturmak için gereken komut dosyası oluşturulur.
Apps Komut Dosyası projesini oluşturma
- Google Kitaplar'dan bağlantıları önizle Apps Komut Dosyası projesini açmak için aşağıdaki düğmeyi tıklayın.
Projeyi açın - Genel Bakış'ı tıklayın.
- Genel bakış sayfasında Kopya oluştur'u tıklayın.
- Apps Komut Dosyası projesi kopyanızda
Code.gs
dosyasına gidin veYOUR_API_KEY
değerini bir önceki bölümde oluşturduğunuz API anahtarıyla değiştirin.
Cloud projesi numarasını kopyalayın
- Google Cloud konsolunda Menü > IAM ve Yönetici > Ayarlar'a gidin.
- Proje numarası alanına değeri kopyalayın.
Apps Komut Dosyası projesinin Cloud projesini ayarlayın
- Apps Komut Dosyası projenizde 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.
- GCP proje numarası alanına Google Cloud proje numarasını yapıştırın.
- Proje ayarla'yı tıklayın.
Eklentiyi test etme
Aşağıdaki bölümlerde, oluşturduğunuz eklenti test edilmektedir.
Test dağıtımı yükleme
- Apps Komut Dosyası projenizde Düzenleyici'yi tıklayın.
YOUR_API_KEY
kısmını, önceki bir bölümde oluşturulan Google Books API API anahtarıyla değiştirin.- Dağıt > Dağıtımları test et'i tıklayın.
- Yükle > Bitti'yi tıklayın.
Google Dokümanlar'da bir bağlantıyı önizleme
- docs.new adresinde Google Dokümanlar dokümanı oluşturun.
- Aşağıdaki URL'yi dokümana yapıştırın ve URL'yi akıllı çipe dönüştürmek için sekme tuşuna basın:
https://www.google.com/books/edition/Software_Engineering_at_Google/V3TTDwAAQBAJ
- İşaretçiyi akıllı çipin üzerinde tutun ve istendiğinde eklentiyi çalıştırmak için erişim yetkisi verin. Önizleme kartı, kitapla ilgili bilgileri görüntüler.
Aşağıdaki resimde bağlantı önizlemesi gösterilmektedir:
Kodu inceleyin
Bu eklentinin Apps Komut Dosyası kodunu incelemek için Kaynak kodunu görüntüle'yi tıklayarak bölümü genişletin: