Membuat dan mengonfigurasi koneksi Google Drive

Halaman ini menjelaskan cara membuat dan mengonfigurasi koneksi Google Drive di Integration Connectors. Untuk mengetahui informasi selengkapnya tentang konektor Google Drive, lihat Ringkasan konektor Google Drive.

Sebelum memulai

Di project Google Cloud Anda, lakukan tugas berikut:

  • Pastikan konektivitas jaringan telah disiapkan. Untuk mengetahui informasi tentang pola jaringan, lihat Konektivitas jaringan.
  • Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
  • Berikan peran IAM roles/secretmanager.viewer dan roles/secretmanager.secretAccessor ke akun layanan yang ingin Anda gunakan untuk konektor.
  • Aktifkan layanan berikut:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    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.

Membuat koneksi Google Drive

Untuk membuat koneksi Google Drive, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman Integration Connectors > Connections.

    Buka Koneksi

  2. Klik Buat Koneksi.

    Halaman Buat Koneksi akan muncul.

  3. Di bagian Lokasi:
    1. Klik Region, lalu pilih lokasi untuk koneksi Anda.

      Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

    2. Klik Berikutnya.
  4. Di bagian Connection Details, berikan detail berikut:
    1. Konektor: pilih Google Drive.
    2. Versi konektor: pilih versi konektor yang ingin Anda gunakan.

      Versi konektor yang Anda pilih bergantung pada versi Google Drive API yang ingin Anda gunakan. Untuk mengetahui informasi selengkapnya, lihat Versi koneksi Google Drive.

    3. Nama Koneksi: masukkan nama untuk koneksi.
    4. Deskripsi: (Opsional) masukkan deskripsi untuk koneksi.
    5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
    6. Service Account: Pilih akun layanan yang ingin Anda gunakan untuk koneksi. Pastikan akun layanan memiliki peran dan izin IAM yang relevan dan diperlukan.
    7. Mendukung Semua Drive: Centang kotak ini untuk mengaktifkan akses ke drive bersama. Opsi ini hanya tersedia untuk Google Drive v2.
    8. Setelan node koneksi: (Opsional) Konfigurasi setelan node koneksi.
      • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
      • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

      Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk 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.

    9. Klik Berikutnya.
  5. Di bagian Authentication, pilih dan konfigurasi jenis autentikasi untuk koneksi:

    Akun Layanan

    Pilih opsi ini jika aplikasi Anda berjalan di Virtual Machine Google Cloud dan harus menggunakan akun layanan yang terlampir di VM untuk autentikasi.

    Untuk menggunakan jenis autentikasi ini, Anda harus memiliki akun layanan dengan peran dan izin IAM yang relevan yang diperlukan untuk autentikasi.

    Untuk mengetahui informasi tentang cara membuat akun layanan, lihat Membuat dan mengelola akun layanan. Untuk mengetahui informasi tentang cara memberikan peran ke akun layanan, lihat Memberikan, mengubah, dan mencabut akses ke resource.

    Contoh detail koneksi untuk jenis autentikasi akun layanan

    Nama kolom Detail
    Lokasi us-central1
    Konektor Google Drive
    Versi konektor 2
    Nama Koneksi googledrive-ws-gcpaccount
    Mengaktifkan Cloud Logging Ya
    Akun Layanan 123456789012-compute@developer.gserviceaccount.com
    Jumlah minimum node 2
    Jumlah maksimum node 50
    Autentikasi Autentikasi Akun Layanan

    OAuth 2.0 - JWT Bearer

    Untuk mengonfigurasi jenis autentikasi JWT Bearer Oauth 2.0, lakukan hal berikut:

    1. Buat kunci JSON akun layanan dan download file kunci JSON. File kunci ini digunakan sebagai sertifikat JWT untuk koneksi.
    2. Buat secret untuk menyimpan file kunci JSON atau sertifikat JWT.
    3. Berikan detail rahasia saat Anda membuat koneksi di Integration Connectors:
      • JWT Cert: pilih secret yang berisi sertifikat JWT.
      • Versi secret: pilih versi secret untuk secret yang dipilih.
      • Subjek JWT: (Opsional) masukkan subjek JWT yang akan digunakan untuk koneksi. Ini digunakan sebagai kolom sub di token JWT.

    Detail koneksi contoh untuk jenis autentikasi OAuth 2.0 - JWT Bearer

    Nama kolom Detail
    Lokasi us-central1
    Konektor Google Drive
    Versi konektor 2
    Nama Koneksi googledrivejwt
    Mengaktifkan Cloud Logging Ya
    Akun Layanan 123456789012-compute@developer.gserviceaccount.com
    Jumlah minimum node 2
    Jumlah maksimum node 50
    Autentikasi OAuth 2.0 - JWT Bearer
    Sertifikat JWT 
    {
  "type": "service_account",
  "project_id": "sm****-****-******",
  "private_key_id": "0b***************************",
  "private_key": "-----BEGIN PRIVATE KEY-----\nO********************************************=\n-----END PRIVATE KEY-----\n",
  "client_email": "go**********************************8",
  "client_id": "10**********************",
  "auth_uri": "https:***********************",
  "token_uri": "https:************************",
  "auth_provider_x509_cert_url": "https:*********************",
  "client_x509_cert_url": "https:****************************************************",
  "universe_domain": "go********"
}
    Versi rahasia 2

    Kode Otorisasi Oauth 2.0

    Gunakan metode ini jika aplikasi Anda memerlukan interaksi pengguna akhir melalui login berbasis browser.

    Untuk mengonfigurasi jenis autentikasi Kode Otorisasi Oauth 2.0, lakukan hal berikut:

    1. Buat kredensial OAuth 2.0 untuk aplikasi web Anda. Proses ini akan membuat client ID dan file JSON rahasia klien.
    2. Identifikasi cakupan akses yang ingin Anda berikan ke aplikasi Anda.
    3. Buat rahasia untuk menyimpan kredensial OAuth 2.0 (client_secret.json).
    4. Berikan ID klien, cakupan, detail rahasia saat Anda membuat koneksi di Integration Connectors:
      • Client ID: masukkan client ID yang dibuat untuk aplikasi web Anda.
      • Cakupan: masukkan daftar cakupan yang diinginkan yang dipisahkan koma.
      • Rahasia Klien: pilih rahasia yang berisi kredensial OAuth 2.0.
      • Versi secret: pilih versi secret untuk secret yang dipilih.

    Contoh detail koneksi untuk jenis autentikasi Kode Otorisasi Oauth 2.0

    Nama kolom Detail
    Lokasi europe-west1
    Konektor Google Drive
    Versi konektor 2
    Nama Koneksi googledrive-wsconn-code
    Mengaktifkan Cloud Logging Ya
    Akun Layanan 123456789012-compute@developer.gserviceaccount.com
    Jumlah minimum node 2
    Jumlah maksimum node 50
    Autentikasi OAuth 2.0 - Kode otorisasi
    ID Klien CLIENT_ID
    Cakupan https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/drive.appdata, https://www.googleapis.com/auth/drive.appfolder, https://www.googleapis.com/auth/drive.install, https://www.googleapis.com/auth/drive.metadata, https://www.googleapis.com/auth/drive.metadata.readonly, https://www.googleapis.com/auth/drive.activity, https://www.googleapis.com/auth/drive.activity.readonly, https://www.googleapis.com/auth/drive.apps.readonly, https://www.googleapis.com/auth/drive.scripts, dan https://www.googleapis.com/auth/drive.meet.readonly
    Rahasia Klien CLIENT_SECRET
    Versi rahasia 2
  6. Aktifkan penggantian autentikasi: (Opsional) centang kotak ini untuk mengaktifkan koneksi agar menerima autentikasi yang berbeda secara dinamis selama runtime.
  7. Klik Berikutnya.
  8. Di bagian Tinjau, tinjau detail koneksi dan autentikasi Anda. Anda selalu dapat mengklik salah satu bagian sebelumnya untuk melakukan perubahan jika diperlukan.
  9. Klik Buat.

    Integration Connectors mulai membuat koneksi untuk konfigurasi yang diberikan. Proses ini membutuhkan waktu beberapa menit. Setelah koneksi dibuat, Anda akan dialihkan ke halaman Koneksi.

Menggunakan koneksi Google Drive 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.

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

Untuk mengetahui daftar operasi dan entitas yang didukung, lihat Entitas dan operasi yang didukung. Untuk mengetahui informasi tentang tindakan khusus konektor yang didukung, lihat Tindakan yang didukung.

Contoh kasus penggunaan di Application Integration

Contoh berikut menunjukkan cara menggunakan tugas Konektor di Integrasi Aplikasi untuk melakukan operasi menggunakan koneksi Google Drive yang telah dikonfigurasi.

Contoh - Mencantumkan semua file

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Files dari daftar Entity.
  3. Pilih operasi List, lalu klik Selesai.
  4. Di bagian Input Tugas pada tugas Konektor, Anda dapat menetapkan filterClause sesuai dengan persyaratan pelanggan.

    5. Nilai untuk filterClause harus selalu diteruskan dalam tanda kutip tunggal (') dalam format ini.

    Anda dapat menggunakan filterClause untuk memfilter kumpulan data tertentu berdasarkan kolom apa pun.

Contoh - Mendapatkan detail file

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Files dari daftar Entity.
  3. Pilih operasi Get, lalu klik Selesai.
  4. Tetapkan entityId ke "1wsHFAusizqFe5O2" yang merupakan kunci yang akan diteruskan. Untuk menyetel entityId, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "1wsHFAusizqFe5O2" di kolom Nilai Input dan pilih entityId sebagai Variabel lokal.

    5. Nilai untuk entityId harus diteruskan secara langsung, seperti "1wsHFAusizqFe5O2". Di sini, "1wsHFAusizqFe5O2" adalah nilai kunci utama unik yang diteruskan.

Contoh - Menghapus file

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Files dari daftar Entity.
  3. Pilih operasi Delete, lalu klik Selesai.
  4. Setel entityId ke "1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L" yang merupakan kunci yang akan diteruskan. Untuk menyetel entityId, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L" di kolom Nilai Input dan pilih entityId sebagai Variabel lokal.

    5. Jika entity memiliki dua kunci bisnis atau kunci utama gabungan, Anda juga dapat menyetel filterClause ke id='1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L' dan tidak perlu menentukan entityId.

Contoh - Membuat file

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Files dari daftar Entity.
  3. Pilih operasi Create, lalu klik Selesai.
  4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih entityId/connectorInputPayload sebagai Variabel lokal.
    5.   { "FileData": " ",
  "Name": "creategcpshareddrivedocxfile.docx", 
  "MIMEType": "application/vnd.google-apps.document",
  "Encoding": "BASE64"}

    Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

    { "Id": "1C48uLda6lyeakx2hOUdwnib-qtFOAhlpR_Ja2AmPvTU"}

Contoh - Membuat drive bersama

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Drives dari daftar Entity.
  3. Pilih operasi Create, lalu klik Selesai.
  4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih entityId/connectorInputPayload sebagai Variabel lokal.
    5.   {"Name": "SharedDrive7"}

    Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

      {"Id": "0AN6y5wEvVrmPUk9PVA"}

Contoh - Membuat izin untuk file, folder, atau drive bersama

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Permissions dari daftar Entity.
  3. Pilih operasi Create, lalu klik Selesai.
  4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih entityId/connectorInputPayload sebagai Variabel lokal.
    5.   {"ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L",
  "Role": "COMMENTER",
  "Type": "USER",
  "EmailAddress": "charlie@altostrat.com"}

    Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

      { "PermissionId": "10596783046483894074",
  "ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L"}

Contoh - Memperbarui detail file

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Files dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Pemetaan Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih entityId/connectorInputPayload/filterClause sebagai Variabel lokal. 
      {"Name": "New Updated file"}
  5. Menetapkan entityId file. Untuk menyetel entityId, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih entityId/connectorInputPayload/filterClause sebagai Variabel lokal.

    Daripada menentukan entityId, Anda juga dapat menyetel filterClause ke 1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm.

    6. Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:

    {"Id": "1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm">}

Contoh - Memperbarui izin untuk file, folder, atau drive bersama

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Permissions dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Pemetaan Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih entityId/connectorInputPayload/filterClause sebagai Variabel lokal.
    5. (PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA')
{ "Role": "READER"}
  5. Menetapkan entityId izin. Untuk menyetel entityId, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih entityId/connectorInputPayload/filterClause sebagai Variabel lokal.

    Selain menentukan entityId, Anda juga dapat menyetel filterClause ke PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA'.

    Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:

      {"PermissionId": "10596783046483894074",
  "ResourceId": "0AKfRSSy6kZbfUk9PVA"}