Mengupload dan mendownload integrasi

Anda dapat mendownload integrasi sebagai file JSON dan menyimpannya di sistem lokal. Akibatnya, seluruh integrasi Anda tersedia dalam file, yang dapat langsung Anda upload di project integrasi lain tanpa modifikasi apa pun. Mengupload integrasi akan membuat versi baru integrasi di project tempat file diupload.

Memiliki seluruh integrasi dalam format file akan memberi Anda keuntungan berikut:

Anda dapat menyalin integrasi dari satu project ke project lain tanpa banyak usaha.
Anda dapat memperbarui file integrasi secara terprogram untuk perubahan berulang, seperti mengganti nama tugas atau mengubah nama variabel secara dinamis.

Mendownload integrasi

Untuk mendownload integrasi, pilih salah satu opsi berikut:

Konsol

Di konsol Google Cloud, buka halaman Integrasi Aplikasi.
Buka Application Integration
Di menu navigasi, klik Integrations. Halaman Integrations akan muncul.
Pilih integrasi yang ada. Tindakan ini akan membuka integrasi di editor integrasi.
Klik dropdown Versi, lalu pilih versi yang ingin didownload.
Di toolbar desainer, klik (menu Tindakan) dan pilih Download.
File INTEGRATION_NAME.json akan otomatis disimpan di folder download default browser web Anda.

Catatan: File JSON yang didownload akan memiliki struktur jenis DownloadIntegrationVersionResponse. Jika Anda mengubah file JSON, pastikan file yang diubah mematuhi struktur DownloadIntegrationVersionResponse.

API

Untuk mendownload integrasi, buat permintaan GET ke API berikut: GET https://integrations.googleapis.com/v1/projects/*/locations/*/integrations/*/versions/*:download

https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

Contoh berikut menunjukkan cara mendownload versi integrasi tertentu:

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

Catatan: Pada contoh sebelumnya, nomor versi integrasi adalah 0e90d453-5fcf-4aae-b164-2e8344d1ac11. Untuk mendapatkan versi integrasi, buka versi integrasi yang diperlukan di UI dan salin string ID unik yang dibuat secara otomatis setelah ../integrations/integration/INTEGRATION_NAME/ dari URL.

Untuk informasi selengkapnya, lihat projects.locations.integrations.versions.download.

Mengupload integrasi

Mengupload integrasi akan membuat versi baru integrasi di project tempat file diupload. Misalnya, jika Anda memiliki integrasi dengan nama IP-Test di versi 5, dan Anda mengupload file integrasi di IP-Test, versi 6 baru akan dibuat untuk integrasi tersebut.

Jika tidak memiliki integrasi yang dapat digunakan untuk mengupload file, Anda harus membuat integrasi baru terlebih dahulu, lalu menguploadnya. Dalam hal ini, integrasi baru yang Anda buat akan berada di versi 1 dan integrasi yang diupload akan berada di versi 2.

Jika Anda memiliki integrasi yang sudah ada dan ingin diupload, pilih salah satu opsi berikut:

Konsol

Di konsol Google Cloud, buka halaman Integrasi Aplikasi.
Buka Application Integration
Di menu navigasi, klik Integrations. Halaman Integrations akan muncul.
Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat integrasi.
Jika Anda membuat integrasi baru:
1. Masukkan nama dan deskripsi di dialog Buat Integrasi.
2. Pilih region untuk integrasi.
  Catatan: Drop-down Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk informasi selengkapnya.
3. Klik Create.
Tindakan ini akan membuka integrasi di editor integrasi.
Di toolbar desainer, klik (menu Tindakan) dan pilih Upload.
Di dialog file browser, pilih file yang ingin Anda upload, lalu klik Open.
Versi baru integrasi dibuat menggunakan file yang diupload.

API

Untuk mengupload integrasi, berikan permintaan POST ke API berikut:

  https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload

Contoh berikut menunjukkan cara mengupload integrasi:

  curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
  -X POST -d '{"content": 
    "{\"name\":\"projects/450954726404/locations/us-east1/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
    \"origin\":\"UI\",
    \"snapshotNumber\":\"3\",
    \"updateTime\":\"2022-01-06T04:26:58.137Z\",
    \"lockHolder\":\"abc@test.com\",
    \"createTime\":\"2022-01-06T04:26:42.734Z\",
    \"lastModifierEmail\":\"abc@test.com\",
    \"state\":\"DRAFT\",
    \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
    \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}' 
    \https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions:upload

Untuk informasi selengkapnya, lihat projects.locations.integrations.versions.upload.

Langkah selanjutnya

Pelajari cara mengelola integrasi.
Pelajari cara menguji dan memublikasikan integrasi.
Pelajari semua tugas dan pemicu.