Lihat konektor yang didukung untuk Application Integration.
Tugas Apps Script
Tugas Apps Script memungkinkan Anda menjalankan Google Apps Script dari integrasi Anda. Google Apps Script adalah platform pengembangan aplikasi cepat yang mempercepat dan mempermudah pembuatan aplikasi bisnis. Untuk mengetahui informasi selengkapnya, lihat Google Apps Script. Tugas ini berguna saat Anda ingin menjalankan skrip kustom atau menggunakan kembali skrip yang sudah ada dalam integrasi.
Sebelum memulai
Sebelum menggunakan tugas Apps Script, pastikan Anda menyelesaikan langkah-langkah berikut:
- Mengaktifkan AppsScript API
- Membuat Client ID OAuth 2.0
- Menyiapkan profil autentikasi
- Pastikan Kontrol Layanan VPC TIDAK disiapkan untuk Application Integration di project Google Cloud Anda.
Aktifkan AppsScript API
Anda harus mengaktifkan AppsScript API di project Google Cloud dan akun pengguna AppsScript agar dapat menggunakan tugas ini. Untuk mengetahui informasi tentang cara mengaktifkan AppsScript API di project Google Cloud, lihat Mengaktifkan API dalam project Google Cloud standar.
Untuk mengaktifkan API di akun pengguna Anda, klik Setelan dan tetapkan
Google Apps Script API
ke On
.
Membuat client ID OAuth 2.0
Jika client ID OAuth 2.0 tersedia, Anda dapat melewati langkah ini dan melanjutkan ke Menyiapkan profil autentikasi.
Untuk informasi tentang membuat client ID OAuth baru, lihat Membuat client ID OAuth.
Menyiapkan profil autentikasi
Application Integration menggunakan profil autentikasi untuk terhubung ke Google Cloud guna men-deploy dan menjalankan project Apps Script. Untuk menyiapkan profil autentikasi, lakukan langkah-langkah berikut:
Menambahkan tugas Apps Script
- Di konsol Google Cloud, buka halaman Application Integration.
- Di menu navigasi, klik Integrasi.
Halaman Integrations akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.
- Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.
Jika Anda membuat integrasi baru:
- Masukkan nama dan deskripsi di panel Create Integration.
- Pilih region untuk integrasi.
- Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
- Klik Create.
Tindakan ini akan membuka integrasi di editor integrasi.
- Di menu navigasi editor integrasi, klik Tasks untuk melihat daftar tugas yang tersedia.
- Klik dan tempatkan elemen Apps Script di editor integrasi.
Membuat profil autentikasi
- Klik elemen Apps Script pada desainer untuk melihat panel konfigurasi tugas Apps Script.
- Di panel konfigurasi tugas pada tugas Apps Script, klik +New authentication profile.
- Pada dialog Authentication profile, masukkan nama dan deskripsi profil, lalu tetapkan properti berikut:
- Jenis autentikasi: Pilih Kode otorisasi OAuth 2.0
- Endpoint autentikasi: Masukkan
https://accounts.google.com/o/oauth2/auth
- Endpoint token: Masukkan
https://oauth2.googleapis.com/token
- Client-ID: Masukkan client ID.
Client ID tersedia di dasbor project Google Cloud Anda di bagian Credentials > OAuth 2.0 Client ID.
- Rahasia: Masukkan rahasia klien
Rahasia klien tersedia di dasbor project Google Cloud Anda pada bagian Credentials > OAuth 2.0 Client ID.
- Cakupan: Masukkan info berikut:
https://www.googleapis.com/auth/script.projects https://www.googleapis.com/auth/script.deployments https://www.googleapis.com/auth/script.deployments.readonly https://www.googleapis.com/auth/drive.scripts https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/script.external_request https://www.googleapis.com/auth/userinfo.email
Catatan: Beberapa cakupan dapat dipisahkan dengan satu karakter spasi (" ").
- Klik Generate Access Token and Save.
Anda akan dialihkan ke layar otorisasi. Login dan berikan izin ke izin yang tercantum di layar untuk membuat token akses Anda. Jika pembuatan token akses berhasil, profil autentikasi Anda akan disimpan, dan Anda dapat terus mengedit integrasi Anda.
Mengonfigurasi tugas Apps Script
Untuk mengonfigurasi project Apps Script dalam tugas Apps Script, lakukan langkah-langkah berikut:
- Di panel konfigurasi tugas, klik Configure Apps Script Project.
Dialog Apps Script Configuration akan muncul.
- Anda dapat memilih untuk menautkan ke
project Apps Script yang sudah ada atau membuat project Apps Script baru.
Mengonfigurasi project Apps Script akan mengaitkan project Apps Script dengan integrasi Anda dalam Application Integration.
- Klik Simpan.
- Klik Buka Project Apps Script.
Di editor Apps Script, Anda dapat melihat file berikut:
Run.gs
: Berisi kode yang dapat dieksekusi. Tulis skrip Anda di dalam fungsirun
. Fungsi ini dipanggil saat tugas Apps Script dieksekusi. Dalam skrip, Anda dapat menggunakan variabel yang ditentukan pada tingkat integrasi. Untuk informasi tentang penggunaan variabel integrasi, lihat Menggunakan variabel integrasi.Main.gs
: Berisi kode inisialisasi untuk menjalankan Apps Script dari integrasi Anda. Jangan edit atau ubah file ini.Test.gs
: Berisi kode yang dapat dieksekusi untuk pengujian. Anda dapat menulis skrip di dalam fungsitestRun
untuk menguji skrip.
Pastikan untuk men-deploy project dalam format aplikasi Web. Untuk mengetahui informasi lebih lanjut mengenai berbagai mode deployment, lihat Membuat dan mengelola deployment.
Mengakses variabel integrasi
Tugas Apps Script menggunakan library AppsScriptTask, yang memungkinkan Anda
menggunakan variabel integrasi dalam skrip. Library AppsScriptTask
otomatis diimpor dan tersedia untuk digunakan dalam fungsi
run
.
Untuk mengakses variabel integrasi di Apps Script, Anda harus meneruskan variabel dalam bentuk parameter tugas ke tugas Apps Script. Parameter tugas adalah key-value pair dengan Key adalah nama variabel dalam tugas AppsScript dan Value adalah nama variabel integrasi yang sesuai. Anda dapat menambahkan satu atau beberapa parameter tugas di bagian Task Parameters pada panel konfigurasi tugas.
Misalnya, jika Anda memiliki variabel integrasi bernama Product yang ingin
digunakan dalam Apps Script, Anda dapat menentukan Key sebagai
ProductKey dan nilainya sebagai Product. Di Apps Script, Anda dapat menggunakan AppsScriptTask.getTaskParameter('ProductKey')
untuk membaca variabel Product.
Library AppsScriptTask menyediakan metode berikut untuk mengakses variabel integrasi:
Function name | Deskripsi | Penggunaan | |
---|---|---|---|
|
Menetapkan nilai yang diberikan ke variabel. |
Sintaksis: Contoh: // Write to an Integer variable AppsScriptTask.setIntegrationVariable('EmployeeIDKey','456'); |
|
|
Mendapatkan nilai variabel. |
Sintaksis: Contoh: // Read an integration variable AppsScriptTask.getTaskParameter('EmployeeIDKey'); |
Untuk melihat semua fungsi yang tersedia di library AppsScriptTask, arahkan kursor ke item menu AppsScriptTask di editor Apps Script, klik Lainnya
> Buka di tab baru.Menguji Apps Script
Sebelum memublikasikan integrasi, Anda dapat menguji skrip menggunakan fungsi testRun yang tersedia dalam file Test.gs. Tulis kode pengujian Anda dalam fungsi testRun, menggunakan library AppsScriptTaskTest. Library ini memungkinkan Anda menjalankan kasus pengujian berbasis pernyataan dan secara otomatis diimpor untuk digunakan dalam fungsi testRun.
Untuk melihat semua fungsi yang tersedia di library AppsScriptTaskTest, arahkan kursor ke item menu AppsScriptTaskTest di editor Apps Script, klik Lainnya
> Buka di tab baru.Contoh berikut menunjukkan penggunaan fungsi library AppsScriptTaskTest.
function testRun(){ // Create a new request let req = AppsScriptTaskTest.createNewTestRequest('myCustomTest'); // Add a task parameter that references an integration variable with the value 5 AppsScriptTaskTest.setIntegrationVariableAndCreateReference(req, 'input', '$input$', 5); // Add a task parameter that references an integration variable AppsScriptTaskTest.createReference(req, 'output', '$output$'); // Run the task(assuming the task increments the input by 1) and get the response let res = AppsScriptTaskTest.runTest(req, executeScript); // Check the response for the expected integration variable and its corresponding values AppsScriptTaskTest.containsIntegrationVariable(res, 'output', true); AppsScriptTaskTest.containsIntegrationVariable(res, 'someOtherIntegrtionVariable', false); AppsScriptTaskTest.containsIntegrationVariableWithValue(res, 'output', 6); }
Contoh berikut menunjukkan cara mengakses variabel array dan JSON dalam metode testRun:
function testRun(){ // Create a new request let req = AppsScriptTaskTest.createNewTestRequest('json-test'); // Add a task parameter that references a JSON integration variable AppsScriptTaskTest.setIntegrationVariableAndCreateReference(req, "emp", "employee", {name:"snape", age:35}); // Add a task parameter that references an array integration variable AppsScriptTaskTest.setIntegrationVariableAndCreateReference(req, "arr", "array", ["A", "B", "C"]); // Run the task and get the response // Assume that the run method increases the age of the employee by 5 and appends a new element in the array let res = AppsScriptTaskTest.runTest(req, executeScript); // Check the response for the expected integration variable and its corresponding values AppsScriptTaskTest.containsIntegrationVariableWithValue(res, "employee", {name:"snape", age:40}); AppsScriptTaskTest.containsIntegrationVariable(res, "array", true); AppsScriptTaskTest.containsIntegrationVariableWithValue(res, "array", ["A", "B", "C", "D"]); }
Setelah menjalankan kasus pengujian, Anda dapat melihat pernyataan di Log eksekusi. Untuk melihat log, klik Execution log dari menu.
Praktik terbaik
Sebaiknya jangan gunakan tugas Apps Script jika Anda memerlukan latensi kurang dari 1 hingga 2 detik untuk tugas dalam integrasi Anda.
Selain itu, sebaiknya coding semua logika dalam satu tugas Apps Script, bukan merangkai beberapa tugas Apps Script, untuk meminimalkan bottleneck performa.
Untuk mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas Apps Script, lihat Batas penggunaan.
Pertimbangan
Saat menyertakan tugas Apps Script dalam desain integrasi Anda, pertimbangkan batasan sistem berikut:
- Deployment aktif maksimum untuk AppsScript: 50
- Kueri per detik (QPS) untuk API yang dapat dieksekusi: 5.000/mnt
- Kueri per detik (QPS) untuk deployment Aplikasi Web: 5.000/mnt
- Latensi untuk API yang dapat dieksekusi: 1,5 dtk
- Latensi untuk Webapp: 2.5d
- Ukuran kumulatif maksimum semua variabel integrasi dalam AppsScript: 15 MB
Strategi penanganan error
Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk mendapatkan informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.
Pengecualian SLA
Tugas Apps Script memiliki dependensi pada produk Google Apps Script.
Karena dependensi ini berada di luar Integrasi Aplikasi, semua eksekusi integrasi
active
yang gagal karena kegagalan dalam
tugas Apps Script, dikecualikan dari
persyaratan dan ketentuan Perjanjian Tingkat Layanan
Integrasi Aplikasi (SLA).