Halaman ini diterjemahkan oleh Cloud Translation API.

Konektor Google Drive

Konektor Google Drive memungkinkan Anda membuat dan mengonfigurasi koneksi Google Drive di Integration Connectors. Anda dapat menggunakan koneksi ini di aplikasi bisnis untuk bertukar data dan melakukan operasi dengan Google Drive secara aman.

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.

Versi konektor Google Drive

Konektor Google Drive mendukung dua versi:

Google Drive v1: gunakan versi konektor ini untuk mengakses Google Drive API v3.
Google Drive v2: gunakan versi konektor ini untuk mengakses Google Drive API v2.

Untuk mengetahui informasi tentang cara membuat koneksi Google Drive, lihat Membuat dan mengonfigurasi konektor Google Drive.

Entitas dan operasi yang didukung

Konektor Google Drive mendukung entitas dan operasi berikut:

Entity	Deskripsi	Operasi
`File`	Mewakili file di Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Folder`	Mewakili folder di Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Permission`	Mewakili izin untuk file atau folder di Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Drive`	Mewakili drive di Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`

Untuk contoh kasus penggunaan Integrasi Aplikasi, lihat Contoh kasus penggunaan di Integrasi Aplikasi.

Tindakan yang didukung

Konektor Google Drive mendukung tindakan berikut:

CopyResource

Deskripsi: membuat salinan resource tertentu di Google Drive. Anda dapat menentukan nama baru untuk file yang disalin dan menentukan folder tujuannya dengan memberikan daftar ID folder induk .

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID resource yang akan disalin.
`NewName`	String	Ya	Nama baru file yang disalin.
`ParentIDs`	String	Tidak	Daftar ID folder induk yang dipisahkan koma tempat file yang disalin akan ditempatkan. Jika tidak ditentukan, file akan disalin ke folder yang sama dengan tempat file berada.
`IgnoreDefaultVisibility`	Boolean	Tidak	Menentukan apakah akan melewati setelan visibilitas default untuk file yang baru dibuat. Jika domain dikonfigurasi agar semua file yang diupload terlihat secara default, menyetel parameter ini ke benar (true) akan menggantikan perilaku tersebut untuk permintaan tertentu ini. Nilai defaultnya adalah false.
`IncludeLabels`	String	Tidak	Daftar ID label yang dipisahkan koma untuk disertakan dalam bagian labelInfo respons.
`IncludePermissionsForView`	String	Ya	Kolom ini menentukan izin tampilan tambahan mana yang akan disertakan dalam respons. Nilai yang didukung dipublikasikan.
`KeepRevisionForever`	Boolean	Tidak	Menunjukkan apakah revisi file akan disimpan selamanya. Fitur ini hanya berlaku untuk file dengan konten biner di Google Drive. Maksimum 200 revisi dapat disimpan selamanya per file. Jika batas tercapai, Anda harus menghapus revisi yang ada untuk menambahkan revisi baru. Nilai defaultnya adalah false.
`OCRLanguage`	String	Tidak	Kolom ini memberikan petunjuk bahasa untuk OCR (Optical Character Recognition) saat mengimpor file gambar. Tentukan bahasa menggunakan kode bahasa dua huruf ISO 639-1, seperti `en` untuk bahasa Inggris, `de` untuk bahasa Jerman.
`SupportsAllDrives`	Boolean	Ya	Parameter ini menunjukkan apakah akan melacak perubahan di Drive Saya dan drive bersama. Setel parameter ini ke benar (true) untuk mengaktifkan akses ke drive bersama. Nilai defaultnya adalah false.

Parameter output

Nama parameter	Jenis data	Deskripsi
`CopiedFileID`	String	ID file yang disalin.
`Success`	String	Parameter ini menunjukkan apakah operasi berhasil atau tidak.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan CopyResource di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan CopyResource, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}

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

        [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]

CreateFolder

Deskripsi: membuat folder baru dalam Google Drive Anda. Anda harus memberikan nama untuk folder baru dan menentukan lokasinya dengan memberikan ID folder induknya. Anda juga dapat menambahkan deskripsi opsional dan menandai folder sebagai berbintang.

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Name`	String	Ya	Judul untuk folder.
`Description`	String	Tidak	Deskripsi untuk folder.
`Starred`	Boolean	Tidak	Parameter ini menunjukkan apakah folder diberi bintang. Nilai defaultnya adalah false.
`ParentIds`	String	Ya	Daftar ID folder induk yang dipisahkan koma tempat folder baru akan dibuat.

Parameter output

Nama parameter	Jenis data	Deskripsi
`Success`	String	Parameter ini menunjukkan apakah operasi berhasil atau tidak.
`Id`	String	ID folder baru.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan CreateFolder di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan CreateFolder, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
        { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:
```
        [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

Deskripsi: menghapus file atau folder dari Google Drive secara permanen. Untuk menggunakan tindakan ini, Anda harus memberikan ID unik resource yang ingin dihapus.

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID resource yang akan dihapus.

Parameter output

Nama parameter	Jenis data	Deskripsi
`Success`	String	Parameter ini menunjukkan apakah operasi berhasil atau tidak.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan DeleteResource di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan DeleteResource, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
      
```
Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

Deskripsi: mendownload file dari Google Drive

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID file yang akan didownload.
`LocalFile`	String	Tidak	Jalur file dan nama file tempat file akan disimpan, biarkan kosong untuk menyimpan file dalam memori.
`Encoding`	String	Tidak	Jenis encoding untuk data file. Jika LocalFile kosong, data file akan ditampilkan dalam encoding yang ditentukan. Nilai yang diizinkan adalah NONE, dan BASE64. Nilai defaultnya adalah BASE64.
`Overwrite`	Boolean	Tidak	Parameter ini menentukan apakah file akan ditimpa jika sudah ada saat didownload. Nilai defaultnya adalah salah (false). Tetapkan parameter ke BENAR (TRUE) untuk menimpa file.
`FileFormat`	String	Tidak	Format file yang dapat didownload, ukuran maksimum file adalah 10 MB. Kosongkan parameter ini untuk mendownload dalam format aslinya. Format yang didukung adalah DOCX, ODT, RTF, HTML, TXT, dan PDF.

Parameter output

Nama parameter	Jenis data	Deskripsi
`FileData`	String	Jika LocalFile tidak disediakan, data file akan ditampilkan menggunakan Encoding yang ditentukan.
`Success`	String	Parameter ini menunjukkan apakah operasi berhasil atau tidak.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan DownloadFile di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan DownloadFile, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}

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

        [{"FileData": "This is a test file.", "Success": "TRUE"}]

MoveResource

Deskripsi: memindahkan file atau folder ke lokasi yang berbeda dalam Google Drive. Anda harus memberikan ID resource yang akan dipindahkan dan ID folder induk baru.

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID resource yang akan dipindahkan.
`ParentIDs`	String	Ya	Daftar ID yang dipisahkan koma untuk digunakan sebagai folder induk. Resource dalam drive bersama harus memiliki tepat satu folder induk, dan hanya pengguna dengan peran 'pengelola file' atau 'pengelola' yang dapat memindahkan file dan folder dalam drive bersama.

Parameter output

Nama parameter	Jenis data	Deskripsi
`Success`	String	Parameter ini menunjukkan apakah operasi berhasil atau tidak.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan MoveResource di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan MoveResource, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

Deskripsi: memperbarui metadata file atau folder di Google Drive. Anda dapat mengubah nama, deskripsi, jenis MIME, dan apakah file tersebut berbintang atau tidak.

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID resource yang akan diperbarui.
`Name`	String	Ya	Nama baru file yang diperbarui.
`Description`	String	Tidak	Deskripsi file atau folder.
`MIMEType`	String	Tidak	Jenis MIME file.
`Starred`	String	Tidak	Parameter ini menunjukkan apakah resource diberi bintang. Nilai defaultnya adalah false.

Parameter output

Nama parameter	Jenis data	Deskripsi
`Success`	String	Parameter ini menunjukkan apakah operasi berhasil atau tidak.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan UpdateResource di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan UpdateResource, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
      
```
Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:
```
        [{"Success": "TRUE"}]
      
```

UploadFile

Deskripsi: mengupload file ke Google Drive. Anda harus memberikan data file dan jenis MIME-nya. Anda juga dapat menentukan folder induk tempat file akan ditempatkan dan nama file untuk file yang diupload.

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID file yang akan diupload.
`FileData`	String	Ya	Data file yang akan diupload.
`MIMEType`	String	Ya	Jenis MIME file.
`ParentIDs`	String	Tidak	Daftar ID folder induk yang dipisahkan koma tempat file yang diupload akan ditempatkan. Jika tidak ditentukan, file akan diupload ke folder root Drive Saya milik pengguna.
`Filename`	String	Tidak	Nama file yang akan diupload.

Parameter output

Nama parameter	Jenis data	Deskripsi
`Success`	String	Parameter ini menunjukkan apakah operasi berhasil atau tidak.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan UploadFile di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan UploadFile, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}

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

        [{"Success": "TRUE"}]

SubscribeToFileChanges

Deskripsi: berlangganan notifikasi untuk perubahan pada file tertentu di Google Drive.

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID file yang akan didaftarkan.
`Token`	String	Ya	Token yang akan digunakan untuk berlangganan perubahan file.

Parameter output

Nama parameter	Jenis data	Deskripsi
`Success`	String	Parameter ini menunjukkan apakah operasi berhasil atau tidak.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan SubscribeToFileChanges di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan SubscribeToFileChanges, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

        {
          "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
          "Id": "Id11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

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

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

SubscribeToUserChanges

Deskripsi: berlangganan notifikasi untuk perubahan yang dilakukan oleh pengguna tertentu di Google Drive.

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID pengguna yang akan berlangganan.
`Token`	String	Ya	Token yang akan digunakan untuk berlangganan perubahan pengguna.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan SubscribeToUserChanges di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan SubscribeToUserChanges, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

        {
          "Id": "11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

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

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

StopWatchingResources

Deskripsi: menghentikan langganan Anda untuk menerima notifikasi untuk resource yang sebelumnya ditonton.

Parameter input

Nama parameter	Jenis data	Wajib	Deskripsi
`Id`	String	Ya	ID resource yang akan berhenti dipantau.
`Token`	String	Ya	Token yang akan digunakan untuk berhenti menonton resource.

Contoh kasus penggunaan

Contoh berikut menunjukkan cara mengonfigurasi tindakan StopWatchingResources di Integrasi Aplikasi:

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan StopWatchingResources, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

        {
          "Id": "Id11752060129918",
          "Token": "token"
        }

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

        [
          {
            "Kind": "api#channel",
            "Id": "stopid1751971586168",
            "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
            "Token": null,
            "Expiration": "1751975186000"
          }
        ]

Batasan sistem

Konektor Google Drive dapat memproses maksimum 2 transaksi QPS per detik, per node, 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.

Catatan: Jumlah node Integration Connectors akan diskalakan otomatis secara dinamis berdasarkan penggunaan Anda. Namun, jika ingin mencadangkan kapasitas untuk volume besar tanpa menunggu penskalaan otomatis, Anda dapat menyesuaikan nilai node minimum untuk koneksi. Jumlah node yang diperlukan meningkat saat jumlah transaksi yang diproses untuk koneksi bertambah. Sebaliknya, jumlah node yang diperlukan lebih sedikit jika koneksi memproses lebih sedikit transaksi. Untuk mengonfigurasi nilai node, lakukan hal berikut:

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

Jumlah transaksi maksimum yang dapat ditangani oleh sebuah node bergantung pada berbagai faktor. Jadi, sebelum menyesuaikan node minimum untuk mendapatkan throughput yang lebih baik, sebaiknya periksa apakah sistem backend Anda telah disiapkan secara optimal untuk menangani traffic yang diperlukan.

Langkah berikutnya

Pelajari cara membuat dan mengonfigurasi koneksi Google Drive.
Pahami cara menangguhkan dan melanjutkan koneksi.
Pahami cara memantau penggunaan konektor.
Pahami cara melihat log konektor.

Mendapatkan bantuan dari komunitas Google Cloud

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