Node.js çalışma zamanını kullanarak Cloud Functions'ta Google Workspace Eklentileri oluşturun.
Hedefler
- Ortamınızı ayarlayın.
- Cloud Functions işlevi oluşturup dağıtın.
- Eklentiyi oluşturun ve dağıtın.
- Eklentiyi yükleyin.
Ön koşullar
- Bir Google Cloud projesi.
- Cloud projeniz için faturalandırmayı etkinleştirdiğinizden emin olun. Projelerinizin faturalandırma durumunu nasıl doğrulayacağınızı öğrenin.
- Cloud projesiyle yapılandırılan Google Cloud SDK.
Ortamınızı ayarlama
Google Cloud Console'da Cloud projenizi açma
- Google Cloud konsolunda 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ı da uygulayabilirsiniz. Bir Google Cloud projesi oluşturursanız proje için faturalandırmayı etkinleştirmeniz gerekebilir.
OAuth izin ekranını yapılandırın
Google Workspace eklentileri için izin ekranı yapılandırması gerekir. Eklentinizin OAuth izin ekranının yapılandırılması, Google'ın kullanıcılara ne göstereceğini tanımlar.
- Google Cloud konsolunda Menü > API'ler ve Hizmetler > OAuth izin ekranı'na gidin.
- Kullanıcı türü için Dahili'yi seçin ve Oluştur'u tıklayın.
- Uygulama kayıt formunu doldurun, ardından 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 kullanmak için bir uygulama oluşturduğunuzda Kullanıcı türü'nü Harici olarak değiştirmeniz ve 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ı sorunsuz görünüyorsa Kontrol Paneline Dön'ü tıklayın.
Cloud Functions işlevi oluşturma ve dağıtma
Yerel bir terminalde Cloud Functions, Cloud Build ve Google Workspace Add-ons API'yi etkinleştirin:
gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com
Boş bir dizinde, aşağıdaki örnek kodu kullanarak
function.js
dosyasını oluşturun:/** * Cloud Function that loads the homepage for a * Google Workspace Add-on. * * @param {Object} req Request sent from Google * @param {Object} res Response to send back */ exports.loadHomePage = function addonsHomePage (req, res) { res.send(createAction()); }; /** Creates a card with two widgets. */ function createAction() { return { "action": { "navigations": [ { "pushCard": { "header": { "title": "Cats!" }, "sections": [ { "widgets": [ { "textParagraph": { "text": "Your random cat:" } }, { "image": { "imageUrl": "https://cataas.com/cat" } } ] } ] } } ] } }; }
İşlevi dağıtın:
gcloud functions deploy loadHomePage --runtime nodejs12 --trigger-http
İstenirse işlevin kimliği doğrulanmayan çağrılarına izin vermediğinizi belirtin. İşlevin dağıtılması birkaç dakika sürebilir.
Eklenti dağıtımı oluşturma
Eklentinin hizmet hesabı e-postasını bulun:
gcloud workspace-add-ons get-authorization
Hizmet hesabına
cloudfunctions.invoker
rolünü verin:gcloud functions add-iam-policy-binding loadHomePage \ --role roles/cloudfunctions.invoker \ --member serviceAccount:SERVICE_ACCOUNT_EMAIL
Dağıtılan işlevin URL'sini alın. URL'yi almak için aşağıdaki komutu çalıştırın ve
httpsTrigger
bölümü altındakiurl
alanını bulun:gcloud functions describe loadHomePage
Aşağıdaki örnek kodu kullanarak
deployment.json
dosyasını oluşturun.URL
değerini önceki adımda kullanılan dağıtılan işlevin URL'siyle değiştirin.{ "oauthScopes": ["https://www.googleapis.com/auth/gmail.addons.execute"], "addOns": { "common": { "name": "My HTTP Add-on", "logoUrl": "https://raw.githubusercontent.com/webdog/octicons-png/main/black/beaker.png", "homepageTrigger": { "runFunction": "URL" } }, "gmail": {}, "drive": {}, "calendar": {}, "docs": {}, "sheets": {}, "slides": {} } }
Dağıtımı oluşturun:
gcloud workspace-add-ons deployments create quickstart \ --deployment-file=deployment.json
Eklentiyi yükleme
Dağıtımı geliştirme modunda yükleyin:
gcloud workspace-add-ons deployments install quickstart
Eklentiyi görüntülemek için Gmail'i açın veya yeniden yükleyin. Sağdaki araç çubuğunda deney şişesi simgesini bulun.
Eklentiyi açmak için simgeyi tıklayın. İstenirse eklentiyi yetkilendirin.
İsteğe bağlı: Temizleme
Hesabınızın ücretlendirilmesini önlemek için oluşturduğunuz kaynakları silin:
Eklentiyi Google Hesabınızdan kaldırın:
gcloud workspace-add-ons deployments uninstall quickstart
Bu hızlı başlangıç kılavuzunda kullanılan kaynaklar için ücret alınmasını önlemek amacıyla Cloud projesini silin:
gcloud projects delete PROJECT_ID
PROJECT_ID kısmını hızlı başlangıç için kullandığınız Cloud projesinin kimliğiyle değiştirin. Cloud projesi kimliğini Google Cloud Console'daki Kontrol paneli sayfasında bulabilirsiniz.
Sonraki adımlar
Google Workspace Eklentinize daha fazla işlev eklemek için aşağıdaki kılavuzlara bakın: