Dropbox

Konektor Dropbox memungkinkan Anda terhubung ke instance Dropbox dan melakukan operasi yang didukung.

Sebelum memulai

Sebelum menggunakan konektor Dropbox, lakukan tugas berikut:

• Di project Google Cloud Anda:
  • Memberikan peran IAM roles/connectors.admin kepada pengguna mengonfigurasi konektor.
  • Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk konektor:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    Akun layanan adalah jenis Akun Google khusus yang dimaksudkan untuk mewakili pengguna yang perlu mengautentikasi dan diberi otorisasi untuk mengakses data di Google API. Jika tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk selengkapnya informasi, lihat Membuat akun layanan.

  • Aktifkan layanan berikut:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (API Konektor)

    Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan.

  Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

Mengonfigurasi konektor

Mengonfigurasi konektor mengharuskan Anda membuat koneksi ke sumber data (sistem backend). Koneksi bersifat khusus untuk sumber data. Ini berarti bahwa jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan langkah-langkah berikut:

1. Di Konsol Cloud, buka Integration Connectors > Halaman Koneksi lalu pilih atau buat project Google Cloud.

   Buka halaman Koneksi

2. Klik + Create new untuk membuka halaman Create Connection.
3. Di bagian Lokasi, pilih lokasi untuk koneksi.
   1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua wilayah yang didukung, lihat Lokasi.

   2. Klik NEXT.
4. Di bagian Connection Details, selesaikan langkah-langkah berikut:
   1. Konektor: Pilih Dropbox dari menu drop-down Konektor yang tersedia.
   2. Versi konektor: Pilih versi Konektor dari menu drop-down versi yang tersedia.
   3. Di kolom Connection Name, masukkan nama untuk instance Koneksi.

      Nama koneksi harus memenuhi kriteria berikut:

      • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
      • Huruf harus huruf kecil.
      • Nama koneksi harus dimulai dengan huruf dan diakhiri dengan huruf atau angka.
      • Nama koneksi tidak boleh lebih dari 63 karakter.
   4. Jika perlu, masukkan Description untuk instance koneksi.
   5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
   6. Anda juga dapat mengonfigurasi Setelan node koneksi:
      • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
      • Jumlah maksimum node: Masukkan jumlah maksimum node koneksi.

      Simpul adalah unit (atau replika) koneksi yang memproses transaksi. Diperlukan lebih banyak {i>node<i} untuk memproses lebih banyak transaksi untuk koneksi dan sebaliknya, lebih sedikit node yang diperlukan untuk memproses lebih sedikit transaksi. Untuk memahami pengaruh node terhadap harga konektor Anda, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

   Catatan: Anda dapat menyesuaikan nilai node koneksi hanya jika Anda pelanggan Bayar sesuai penggunaan.
   7. Meniru Identitas Pengguna:Secara opsional, menentukan ID Pengguna yang akan ditiru identitasnya.
   8. Meniru identitas Mode Pengguna:Secara opsional, menentukan jenis peniruan identitas pengguna. Harus menggunakan mode Pengguna atau mode Admin.
   9. Sertakan Sub Direktori:Secara opsional, jika Anda ingin menyertakan sub direktori saat mencantumkan file dan folder.
   10. Sertakan Referensi Tim:Opsional jika Anda ingin menyertakan file dan folder tim.
   11. Anda juga dapat mengklik + Add label untuk menambahkan label ke Koneksi dalam bentuk key-value pair.
   12. Klik Berikutnya.
5. Di bagian Authentication, masukkan detail autentikasi.
   1. Pilih Jenis autentikasi, lalu masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi dropbox:

      • Pemberian Kode Autentikasi OAuth 2.0

   Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

   2. Klik Berikutnya.
6. Peninjauan: Tinjau detail koneksi dan autentikasi Anda.
7. Klik Create.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

• Pemberian Kode Autentikasi OAuth 2.0
  • Client ID: Client ID yang digunakan untuk meminta token akses.
  • Scopes: Daftar cakupan yang diinginkan yang dipisahkan koma dari Portal izin dropbox.
  • Rahasia klien: Rahasia klien yang digunakan untuk meminta token akses.

Entity, operasi, dan tindakan

Semua Integration Connectors menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini diekspos kepada Anda sebagai entity, operasi, dan tindakan.

Catatan: Anda dapat melihat entitas, operasi, dan tindakan Connector di tugas Connectors.

• Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, di aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke entitas konektor 20%. Misalnya, dalam konektor {i>database<i}, tabel adalah entitas, dalam konektor server file, folder adalah entitas, dan dalam konektor sistem pesan, antrean adalah entitas.

  Namun, mungkin saja konektor tidak mendukung atau memiliki entitas apa pun. Dalam hal ini, Daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entitas. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Cantumkan
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih sebuah entitas dari daftar yang tersedia akan menghasilkan daftar yang tersedia untuk entity tersebut. Untuk deskripsi operasi yang terperinci, lihat tugas Konektor operasi entity. Namun, jika konektor tidak mendukung operasi entity apa pun, seperti operasi tidak tercantum dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada suatu entitas atau beberapa entitas, dan bervariasi dari satu konektor ke konektor lainnya. Biasanya, suatu tindakan akan memiliki beberapa parameter input, dan output . Namun, mungkin saja bahwa konektor tidak mendukung tindakan apa pun, dalam hal ini daftar Actions akan kosong.

Catatan: Semua entitas dan tindakan akan memiliki skema yang terkait dengannya. Misalnya, skema tindakan akan memiliki detail parameter seperti; parameter nama, dan tipe datanya yang sesuai. Skema (metadata) untuk entity dan tindakan diambil oleh koneksi di runtime dari backend Anda. Jika ada pembaruan pada skema, pembaruan tersebut tidak akan secara otomatis tercermin dalam koneksi Anda yang sudah ada; Anda harus memperbarui skema secara manual. Untuk memuat ulang skema untuk koneksi, buka halaman Connection details dari koneksi, lalu klik Muat ulang skema koneksi.

Keterbatasan sistem

Konektor {i>Dropbox<i} dapat memproses 18 transaksi per detik, per node, dan men-throttle semua transaksi di luar batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk sebuah koneksi.

Untuk informasi tentang batas yang berlaku bagi Konektor Integrasi, lihat Batas.

Catatan: Jumlah node Konektor Integrasi akan otomatis diskalakan secara dinamis berdasarkan penggunaan Anda. Namun, jika Anda ingin mencadangkan kapasitas untuk volume besar tanpa menunggu penskalaan otomatis, Anda dapat menyesuaikan nilai node minimum untuk koneksi. Selengkapnya {i>node<i} diperlukan untuk memproses lebih banyak transaksi untuk sebuah koneksi. Sebaliknya, lebih sedikit {i>node<i} diperlukan jika koneksi memproses lebih sedikit transaksi. Untuk mengonfigurasi node nilai tersebut, lakukan hal berikut:

• Jika Anda adalah pelanggan bayar sesuai penggunaan, konfigurasikan nilai node minimum dan maksimum di halaman edit koneksi.
• Jika Anda berbasis langganan pelanggan, hubungi dukungan.

Transaksi maksimum yang dapat ditangani node bergantung pada berbagai faktor. Jadi, sebelum menyesuaikan node minimum untuk throughput yang lebih baik, sebaiknya periksa apakah sistem backend Anda sudah disiapkan secara optimal untuk menangani traffic yang diperlukan.

Tindakan

Bagian ini mencantumkan tindakan yang didukung oleh konektor. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Catatan: Hasil dari semua tindakan akan tersedia sebagai Respons JSON dalam connectorOutputPayload tugas Connectors parameter respons setelah Anda menjalankan integrasi.

Tindakan CopyResource

Tindakan ini memungkinkan Anda menyalin file atau folder ke lokasi berbeda di Dropbox pengguna.

Parameter input tindakan CopyResource

Nama parameter	Jenis data	Wajib	Deskripsi
From_Path	String	Ya	Jalur di Dropbox pengguna yang akan disalin atau dipindahkan.
To_Path	String	Ya	Jalur tujuan di Dropbox pengguna untuk resource yang disalin.
Autorename	String	Tidak	Jika terjadi konflik, minta server Dropbox untuk mencoba mengganti nama file secara otomatis untuk menghindari konflik. Default untuk kolom ini adalah False.
Allow_Ownership_Transfer	String	Tidak	Izinkan pemindahan oleh pemilik meskipun hal tersebut akan menyebabkan transfer kepemilikan untuk konten yang dipindahkan. Hal ini tidak berlaku untuk salinan. Default untuk kolom ini adalah False.
ObjectPathsAggregate	String	Tidak	Agregat yang mewakili jalur objek. Bisa juga berupa nama tabel #TEMP.

Misalnya tentang cara mengonfigurasi tindakan CopyResource, lihat Contoh tindakan.

Tindakan CreateFolder

Tindakan ini memungkinkan Anda membuat folder di jalur tertentu.

Parameter input tindakan CreateFolder

Nama parameter	Jenis data	Wajib	Deskripsi
Jalur	String	Ya	Jalur di Dropbox pengguna yang akan dibuat.
AutoRename	Boolean	Tidak	Jika terjadi konflik, minta server Dropbox untuk mencoba mengganti nama folder secara otomatis untuk menghindari konflik. Nilai defaultnya adalah false.
ForceAsync	Boolean	Tidak	Apakah akan memaksa pembuatan agar terjadi secara asinkron. Hanya tersedia saat menggunakan ObjectPathsAggregate. Nilai defaultnya adalah false.
ObjectPathsAggregate	String	Tidak	Agregat JSON yang mewakili jalur. Bisa juga berupa nama tabel #TEMP.

Misalnya tentang cara mengonfigurasi tindakan CreateFolder, lihat Contoh tindakan.

Tindakan DeleteResource

Tindakan ini memungkinkan Anda menghapus file atau folder di jalur tertentu. Jika jalur adalah folder, semua isinya akan dihapus juga.

Parameter input tindakan DeleteResource

Nama parameter	Jenis data	Wajib	Deskripsi
Jalur	String	Ya	ID unik untuk file atau folder.
ObjectPathsAggregate	String	Tidak	Agregat yang mewakili jalur objek. Bisa juga berupa nama tabel #TEMP.

Misalnya tentang cara mengonfigurasi tindakan DeleteResource, lihat Contoh tindakan.

Tindakan MoveResource

Pindahkan file atau folder ke lokasi lain di Dropbox pengguna. Jika jalur sumber adalah folder, semua isinya akan dipindahkan. Perhatikan bahwa saat ini kami tidak mendukung penggantian nama kasus saja.

Parameter input tindakan MoveResource

Nama parameter	Jenis data	Wajib	Deskripsi
From_Path	String	Ya	Jalur di Dropbox pengguna yang akan disalin atau dipindahkan.
To_Path	String	Ya	Jalur di Dropbox pengguna yang merupakan tujuan.
Autorename	String	Tidak	Jika terjadi konflik, minta server Dropbox untuk mencoba mengganti nama file secara otomatis untuk menghindari konflik. Default untuk kolom ini adalah False.
Allow_Ownership_Transfer	String	Tidak	Izinkan pemindahan oleh pemilik meskipun hal tersebut akan menyebabkan transfer kepemilikan untuk konten yang dipindahkan. Hal ini tidak berlaku untuk salinan. Default untuk kolom ini adalah False.
ObjectPathsAggregate	String	Tidak	Agregat yang mewakili jalur objek. Bisa juga berupa nama tabel #TEMP.

Misalnya tentang cara mengonfigurasi tindakan MoveResource, lihat Contoh tindakan.

Tindakan RenameResource

Tindakan ini memungkinkan Anda mengganti nama resource dengan memberikan jalur dan nama baru.

Parameter input tindakan RenameResource

Nama parameter	Jenis data	Wajib	Deskripsi
Jalur	String	Ya	Jalur ke resource yang akan diganti namanya. Mis.: /myFolder/sample.txt
NewName	String	Ya	Nama baru untuk resource. Contoh: sampleDocument.txt

Misalnya tentang cara mengonfigurasi tindakan RenameResource, lihat Contoh tindakan.

Tindakan urungkanshareFolder

Tindakan ini memungkinkan Anda Membatalkan berbagi folder. Memerlukan cakupan sharing.write.

Parameter input tindakan UnshareFolder

Nama parameter	Jenis data	Wajib	Deskripsi
FolderId	String	Ya	ID folder bersama yang akan dibatalkan berbaginya.
LeaveCopy	String	Tidak	Jika true (benar), anggota folder bersama ini akan mendapatkan salinan folder ini setelah folder tersebut dibatalkan berbaginya. Nilai defaultnya adalah false.

Misalnya tentang cara mengonfigurasi tindakan UnshareFolder, lihat Contoh tindakan.

Tindakan DownloadFile

Tindakan ini memungkinkan Anda Mendownload File. Memerlukan cakupan files.content.read.

Parameter input tindakan DownloadFile

Nama parameter	Jenis data	Wajib	Deskripsi
ID	String	Ya	ID dokumen yang akan didownload.
Revisi	String	Tidak	Revisi dokumen yang akan didownload, misalnya 'rev:a1c10ce0dd78'.
Jalur	String	Tidak	Jalur file atau folder yang akan didownload.
AsZip	Boolean	Tidak	Download folder dalam format zip. Harus disetel ke true untuk mendownload folder.
FileStream	String	Tidak	Instance streaming output tempat data file ditulis. Hanya digunakan jika DownloadTo tidak disetel.
DownloadTo	String	Tidak	Jalur folder untuk mendownload file.
FileType	String	Ya	Jenis {i>file<i} ({i>file<i} atau kertas)

Misalnya mengenai cara mengonfigurasi Tindakan DownloadFile, lihat Contoh tindakan.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan di konektor ini.

Contoh - Menyalin resource

Contoh berikut menunjukkan cara menyalin resource dengan jalur yang ditentukan ke jalur yang berbeda:

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CopyResource, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut ini di Kolom Default Value:

   {
     "From_Path": "/DropboxFolder/pptxFile.pptx",
     "To_Path": "/DropBoxFolder2/Folder/pptFile.pptx"
   }

Jika tindakan berhasil, Respons connectorOutputPayload tugas CopyResource akan memiliki nilai yang mirip dengan yang berikut ini:

[ { "Success": "true", "metadata_.tag": "file", 
  "metadata_name": "pptxFile.pptx", 
  "metadata_path_lower": "/testingdropboxupdated/abcde/pptxfile.pptx", 
  "metadata_path_display": "/TestingDropBoxUpdated/abcde/pptxFile.pptx", 
  "metadata_parent_shared_folder_id": "3204685267", "metadata_id": "id:8-07A6kHAoIAAAAAAAAC1w",
  "metadata_client_modified": "2024-06-13T11:06:37Z", "metadata_server_modified": "2024-07-12T10:19:02Z",
  "metadata_rev": "61d0a3560ecb5bf039dd3", "metadata_size": "17052", 
  "metadata_sharing_info_read_only": "false", "metadata_sharing_info_parent_shared_folder_id": "3204685267",
  "metadata_sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A", 
  "metadata_is_downloadable": "true", 
  "metadata_content_hash": "0234f7d4eaf914cb276716c8b2a24e24655d1f6f39ee549207e33a4255e2fba2" } ]

Contoh - Membuat folder

Contoh berikut menunjukkan cara membuat folder di jalur tertentu:

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CreateFolder, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut ini di Kolom Default Value:

   {
     "Path": "/TestDrobBoxFolder/newFolder"
   }

Jika tindakan berhasil, respons connectorOutputPayload tugas CreateFolder akan memiliki nilai yang mirip dengan yang berikut ini:

[ { "Id": "id:8-07A6kHAoIAAAAAAAAC2Q" } ]

Contoh - Menghapus resource

Contoh berikut menunjukkan cara menghapus resource:

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan DeleteResource, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut ini di Kolom Default Value:

   {
     "Path": "/TestingDropBox/FolderToBeDeletedName"
   }

Jika tindakan berhasil, Respons connectorOutputPayload tugas DeleteResource akan memiliki nilai yang mirip dengan yang berikut ini:

[{
"Status": "Success"
}]

Contoh - Memindahkan resource

Contoh berikut menunjukkan cara memindahkan resource:

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan MoveResource, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut ini di Kolom Default Value:

   {
     "From_Path": "/TestDropBoxFolder/Folder1/dummypdf2.pdf",
     "To_Path": "/EmptyFolder/Folder1/dummypdf2.pdf"
   }

Jika tindakan berhasil, Respons connectorOutputPayload tugas MoveResource akan memiliki nilai yang mirip dengan yang berikut ini:

[{
  "Status": "Success"
  }]

Contoh - Mengganti nama resource

Contoh berikut menunjukkan cara mengganti nama resource:

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan RenameResource, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut ini di Kolom Default Value:

   {
     "Path": "/TestDropBox/abcd",
     "NewName": "abcded"
   }

Jika tindakan berhasil, Respons connectorOutputPayload tugas RenameResource akan memiliki nilai yang mirip dengan yang berikut ini:

[{
"Status": "Success"
}]

Contoh - Membatalkan berbagi folder

Contoh berikut menunjukkan cara membatalkan berbagi folder:

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan UnshareFolder, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut ini di Kolom Default Value:

   {
     "FolderId": "3336772979"
   }

Jika tindakan berhasil, Respons connectorOutputPayload tugas UnshareFolder akan memiliki nilai yang mirip dengan yang berikut ini:

[{
"Status": "Success"
}]

Contoh - Mendownload file

Contoh berikut menunjukkan cara mendownload file:

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan DownloadFile, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut ini di Kolom Default Value:

   {
     "Id": "id:8-07A6kHAoIAAAAAAAABcg",
     "FileType": "file"
   }

Jika tindakan berhasil, Respons connectorOutputPayload tugas DownloadFile akan memiliki nilai yang mirip dengan yang berikut ini:

[ { "Success": "true", "Name": "license.txt", 
  "Id": "id:8-07A6kHAoIAAAAAAAABcg", "ClientModified": "2024-07-09T09:52:41Z", 
  "ServerModified": "2024-07-09T09:52:41Z", "Revision": "61ccd7da2b987c0f52053", "Size": "11", 
  "LowerCasePath": "/sahil kapoor/testingdropboxupdated/uploadfolderwithnestedfolder/nestedfolder2/license.txt",
   "DisplayPath": "/Sahil Kapoor/TestingDropBoxUpdated/uploadFolderWithNestedFolder/NestedFolder2/license.txt",
    "PreviewURL": null, "IsDownloadable": "true", "HasExplicitSharedMembers": null, 
  "ContentHash": "f6dc724d119649460e47ce719139e521e082be8a9755c5bece181de046ee65fe", "Owner": null,
  "Title": null, "MimeType": null, "FileData": "SGVsbG8gd29ybGQ=", "parent_shared_folder_id": "3237290067",
  "sharing_info_read_only": "false", "sharing_info_parent_shared_folder_id": "3237290067", 
  "sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A" } ]

Menggunakan koneksi Dropbox dalam integrasi

Setelah dibuat, koneksi akan tersedia di Integrasi Apigee dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Connectors.

• Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Apigee, lihat Tugas konektor.
• Untuk memahami cara membuat dan menggunakan tugas Konektor di Application Integration, lihat Tugas konektor.

Dapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di Google Cloud di Forum Cloud.

Langkah selanjutnya

• Pahami cara menangguhkan dan melanjutkan koneksi.
• Pahami cara memantau penggunaan konektor.
• Memahami cara melihat log konektor.