OneDrive (original) (raw)

Langsung ke konten utama

Konektor OneDrive memungkinkan Anda melakukan operasi penyisipan, penghapusan, pembaruan, dan pembacaan di OneDrive.

Sebelum memulai

Sebelum menggunakan konektor OneDrive, lakukan tugas berikut:

Mengonfigurasi konektor

Koneksi khusus untuk sumber data. Artinya, jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan hal berikut:

  1. Di Konsol Cloud, buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud.
    Buka halaman Koneksi
  2. Klik + BUAT BARU untuk membuka halaman Buat Koneksi.
  3. Di bagian Location, pilih lokasi untuk koneksi.
    1. Region: Pilih lokasi dari menu drop-down.
      Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.
    2. Klik NEXT.
  4. Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
    1. Konektor: Pilih OneDrive dari daftar drop-down Konektor yang tersedia.
    2. Versi konektor: Pilih Versi konektor dari daftar 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 berupa huruf kecil.
      • Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
      • Nama koneksi tidak boleh melebihi 63 karakter.
    4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
    5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
    6. Tingkat Panjang Informasi: Tingkat panjang informasi untuk koneksi, bervariasi dari 1-5. Tingkat kejelasan yang lebih tinggi akan mencatat semua detail komunikasi (permintaan,respons & sertifikat SSL).
    7. Tenant Azure: Tenant Microsoft Online yang digunakan untuk mengakses data. Jika tidak ditentukan, tenant default Anda akan digunakan.
    8. ID Drive: ID drive yang ingin Anda gunakan.
    9. Mencantumkan Drive Grup Secara opsional, Anda dapat memilih untuk mencantumkan drive grup saat membuat kueri drive.
    10. Jika perlu, konfigurasikan Setelan node koneksi:
      • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
      • Jumlah node maksimum: Masukkan jumlah maksimum node koneksi.
        Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk suatu koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, 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.
    11. Klik NEXT.
    12. Di bagian Otorisasi, masukkan detail ID klien dan rahasia klien.
      • Client ID: Client ID yang digunakan untuk meminta token akses.
      • Cakupan: Daftar cakupan yang diinginkan yang dipisahkan koma dari Microsoft Azure Portal.
      • Rahasia Klien: Secret Manager Secret yang berisi rahasia klien untuk aplikasi terhubung yang Anda buat.
      • Versi secret: Versi secret untuk secret yang dipilih di atas.
      • URL otorisasi: URL otorisasi yang Anda buat saat membuat klien OAuth. Masukkan URL dalam format berikut: https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent. Misalnya, https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent.
    13. Klik NEXT.
    14. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
    15. Klik Buat.
      Untuk jenis autentikasi Authorization code, setelah membuat koneksi, Anda harus melakukan beberapa langkah tambahan untuk mengonfigurasi autentikasi. Untuk mengetahui informasi selengkapnya, lihat Langkah tambahan setelah pembuatan koneksi.

Langkah tambahan setelah pembuatan koneksi

Jika Anda memilih OAuth 2.0 - Authorization code untuk autentikasi, Anda harus melakukan langkah-langkah tambahan berikut setelah membuat koneksi:

  1. Di halaman Koneksi, temukan koneksi yang baru dibuat.
    Perhatikan bahwa Status untuk konektor baru akan menjadi Otorisasi diperlukan.
  2. Klik Otorisasi diperlukan.
    Tindakan ini akan menampilkan panel Edit otorisasi.
  3. Salin nilai Redirect URI ke aplikasi eksternal Anda.
  4. Verifikasi detail otorisasi.
  5. Klik Otorisasi.
    Jika otorisasi berhasil, status koneksi akan disetel ke Aktif dihalaman Koneksi.

Otorisasi ulang untuk kode otorisasi

Jika Anda menggunakan jenis autentikasi Authorization code dan telah melakukan perubahan konfigurasi apa pun di aplikasi Anda, Anda harus mengotorisasi ulang koneksi OneDrive Anda. Untuk memberikan kembali otorisasi koneksi, lakukan langkah-langkah berikut:

  1. Klik koneksi yang diperlukan di halaman Koneksi.
    Tindakan ini akan membuka halaman detail koneksi.
  2. Klik Edit untuk mengedit detail koneksi.
  3. Verifikasi detail OAuth 2.0 - Authorization code di bagian Authentication.
    Jika diperlukan, lakukan perubahan yang diperlukan.
  4. Klik Simpan. Tindakan ini akan mengarahkan Anda ke halaman detail koneksi.
  5. Klik Edit otorisasi di bagian Autentikasi. Tindakan ini akan menampilkan panel Authorize.
  6. Klik Otorisasi.
    Jika otorisasi berhasil, status koneksi akan disetel ke Aktif di halaman Koneksi.

Batasan sistem

Konektor OneDrive dapat memproses maksimum 15 transaksi per menit, pernode, dan membatasi transaksi apa pun yang melampaui batas ini:
Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.
Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Menggunakan koneksi Onedrive dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

Entity, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihatoperasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.

Tindakan

Koneksi OneDrive mendukung tindakan berikut:

Tindakan CopyResource

Tabel berikut menjelaskan parameter input tindakan CopyResource.

Parameter input tindakan CopyResource

Nama parameter Wajib Jenis data Deskripsi
ParentID Ya String ID folder tempat Anda ingin menyalin resource.
ID resource Ya String ID resource.

Tindakan CreateFolder

Tabel berikut menjelaskan parameter input tindakan CreateFolder.

Parameter input tindakan CreateFolder

Nama parameter Wajib Jenis data Deskripsi
FolderName Ya String Nama folder yang akan dibuat.
queueName Tidak String Pesan yang akan dikirim ke antrean TIBCO EMS. Ukuran pesan maksimum yang didukung adalah 10 MB.

Tindakan DeleteResource

Tabel berikut menjelaskan parameter input tindakan DeleteResource.

Parameter input tindakan DeleteResource

Nama parameter Wajib Jenis data Deskripsi
ID resource Ya String ID resource.

Tindakan MoveResource

Tabel berikut menjelaskan parameter input tindakan MoveResource.

Parameter input tindakan MoveResource

Nama parameter Wajib Jenis data Deskripsi
ID resource Ya String ID resource.
DestinationID Ya String ID folder tempat Anda ingin memindahkan resource.

Tindakan RenameResource

Tabel berikut menjelaskan parameter input tindakan RenameResource.

Parameter input tindakan RenameResource

Nama parameter Wajib Jenis data Deskripsi
ID resource Ya String ID resource.
Nama Ya String Nama baru resource.

Tindakan UploadFile

Tabel berikut menjelaskan parameter input tindakan UploadFile.

Parameter input tindakan UploadFile

Nama parameter Wajib Jenis data Deskripsi
ParentId Ya String Induk tempat file akan diupload.
FileName Ya String Nama file yang akan Anda gunakan untuk mengupload konten.

Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.

Terakhir diperbarui pada 2026-06-18 UTC.