Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan aplikasi desktop

Google Picker API adalah cara untuk memungkinkan pengguna memilih atau mengupload file Google Drive. Pengguna dapat memberikan izin kepada aplikasi desktop Anda untuk mengakses data Drive mereka, sehingga memberikan cara yang aman dan sah untuk berinteraksi dengan file mereka.

Pemilih Google berfungsi sebagai dialog "Buka File" untuk file yang disimpan di Drive dan memiliki beberapa fitur:

Tampilan dan nuansa yang serupa dengan UI Google Drive.
Beberapa tampilan yang menampilkan pratinjau dan gambar thumbnail file Drive.
Pengalihan ke Pemilih Google dalam tab baru di browser default pengguna.

Perhatikan bahwa Pemilih Google tidak mengizinkan pengguna untuk mengatur, memindahkan, atau menyalin file dari satu folder ke folder lain. Untuk mengelola file, Anda harus menggunakan Google Drive API atau UI Drive.

Prasyarat

Aplikasi yang menggunakan Google Picker harus mematuhi semua Persyaratan Layanan yang ada. Yang terpenting, Anda harus mengidentifikasi diri Anda dengan benar dalam permintaan Anda.

Anda juga harus memiliki project Google Cloud.

Menyiapkan lingkungan Anda

Untuk mulai menggunakan Google Picker API, Anda harus menyiapkan lingkungan Anda.

Mengaktifkan API

Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.

Di konsol Google Cloud, aktifkan Google Picker API.

Mengaktifkan API

Membuat kunci API

Kunci API adalah string panjang yang berisi huruf besar dan kecil, angka, garis bawah, dan tanda hubung, seperti AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe. Metode autentikasi ini digunakan untuk mengakses data yang tersedia secara publik secara anonim, seperti file Google Workspace yang dibagikan menggunakan setelan berbagi "Siapa saja di Internet dengan link ini". Untuk mengetahui detail selengkapnya, lihat Mengelola kunci API.

Untuk membuat kunci API:

Di Konsol Google Cloud, buka Menu > APIs & Services > Credentials.
Buka Kredensial
Klik Create credentials > API key.
Kunci API baru Anda akan ditampilkan.
- Klik Salin untuk menyalin kunci API Anda untuk digunakan dalam kode aplikasi Anda. Kunci API juga dapat ditemukan di bagian "API Keys" pada kredensial project Anda.
- Untuk mencegah penggunaan tanpa izin, sebaiknya batasi tempat dan API yang dapat menggunakan kunci API. Untuk mengetahui detail selengkapnya, lihat Menambahkan pembatasan API.

Mengizinkan kredensial untuk aplikasi desktop

Untuk mengautentikasi pengguna akhir dan mengakses data pengguna di aplikasi Anda, Anda perlu membuat satu atau beberapa ID Klien OAuth 2.0. Client ID digunakan untuk mengidentifikasi aplikasi tunggal ke server OAuth Google. Jika aplikasi Anda berjalan di beberapa platform, Anda harus membuat client ID terpisah untuk setiap platform.

Di Konsol Google Cloud, buka Menu > Google Auth platform > Clients.
Buka Klien
Klik Buat Klien.
Klik Jenis aplikasi > Aplikasi desktop.
Di kolom Name, ketik nama untuk kredensial. Nama ini hanya ditampilkan di konsol Google Cloud.
Klik Buat.
Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Agar aplikasi mendapatkan otorisasi ke file yang sebelumnya diberikan kepadanya, Anda harus menggunakan langkah-langkah berikut:

Anda harus mendapatkan token OAuth 2.0 dengan cakupan drive.file, drive, atau drive.readonly menggunakan petunjuk berikut: Menggunakan OAuth 2.0 untuk Mengakses Google API. Untuk mengetahui informasi selengkapnya tentang cakupan, lihat Memilih cakupan Google Drive API.
Teruskan token OAuth 2.0 ke Drive API untuk membaca dan mengubah file yang sebelumnya diberi akses oleh pengguna.

Menampilkan Pemilih Google

Google Picker API untuk aplikasi desktop mengalihkan ke Google Picker dalam tab baru di browser default pengguna. Setelah pengguna memberikan akses dan memilih file yang relevan, Pemilih Google akan kembali ke aplikasi yang memanggil melalui URL callback. Agar Google Picker API terbuka di halaman klien, gunakan Google Picker API untuk aplikasi web. Untuk mengetahui informasi selengkapnya, lihat Ringkasan aplikasi web.

Untuk mengizinkan pengguna memberikan akses ke file tambahan atau memilih file untuk digunakan dalam alur aplikasi desktop Anda, ikuti langkah-langkah berikut:

Minta akses ke cakupan drive.file untuk membuka halaman akses OAuth 2.0 di tab browser baru menggunakan petunjuk berikut: Menggunakan OAuth 2.0 untuk Mengakses Google API. Untuk mengetahui informasi selengkapnya tentang cakupan, lihat Memilih cakupan Google Drive API.

Perhatikan bahwa hanya cakupan drive.file yang diizinkan untuk aplikasi desktop dan cakupan ini tidak dapat digabungkan dengan cakupan lainnya.

URL untuk tab browser baru menerima semua parameter string kueri OAuth standar.

Anda harus menambahkan parameter URL prompt dan trigger_onepick ke permintaan URL otorisasi OAuth 2.0 Anda. Anda juga dapat menyesuaikan Pemilih Google dengan beberapa parameter opsional:

Parameter	Deskripsi	Status
`prompt=consent`	Minta akses file.	Wajib
`trigger_onepick=true`	Aktifkan Pemilih Google.	Wajib
`allow_multiple=true`	Jika benar (true), izinkan pengguna memilih beberapa file.	Opsional
`mimetypes=MIMETYPES`	Daftar jenis MIME yang dipisahkan koma untuk memfilter hasil penelusuran. Jika tidak disetel, file untuk semua jenis MIME akan ditampilkan dalam tampilan.	Opsional
`file_ids=FILE_IDS`	Daftar ID file yang dipisahkan koma untuk memfilter hasil penelusuran. Jika tidak ditetapkan, semua file ditampilkan dalam tampilan.	Opsional

Contoh berikut menunjukkan permintaan URL otorisasi OAuth 2.0:

https://accounts.google.com/o/oauth2/v2/auth? \
client_id=CLIENT_ID \
&scope=https://www.googleapis.com/auth/drive.file \
&redirect_uri=REDIRECT_URI \
&response_type=code \
&access_type=offline \
&prompt=consent \
&trigger_onepick=true

Ganti kode berikut:

CLIENT_ID: ID klien aplikasi desktop Anda.
REDIRECT_URI: Tempat server otorisasi mengalihkan browser pengguna setelah autentikasi berhasil. Contoh, https://www.cymbalgroup.com/oauth2callback.

redirect_uri yang ditentukan harus berupa URL HTTPS publik. Jika Anda ingin menggunakan URL localhost atau protokol kustom untuk redirect_uri, Anda harus menggunakan URL HTTPS publik yang kemudian dialihkan ke URL localhost atau protokol kustom.

Setelah pengguna memberikan akses dan memilih file yang relevan, OAuth akan mengalihkan ke redirect_uri yang ditentukan dalam permintaan dengan parameter URL berikut ditambahkan:
- picked_file_ids: Jika pengguna memberikan akses dan memilih file, daftar ID file yang dipilih dipisahkan koma.
- code: Token akses atau kode akses berdasarkan kumpulan parameter response_type yang ditetapkan dalam permintaan. Parameter ini mencakup kode otorisasi baru.
- scope: Cakupan yang disertakan dalam permintaan.
- error: Jika pengguna membatalkan permintaan dalam alur izin, error akan ditampilkan.
Contoh berikut menunjukkan respons URL otorisasi OAuth 2.0:
```
https://REDIRECT_URI?picked_file_ids=PICKED_FILE_IDS&code=CODE&scope=SCOPES
```
Aplikasi harus menukar kode otorisasi dari langkah 3 dengan token OAuth 2.0 baru. Untuk mengetahui informasi selengkapnya, lihat Menukarkan kode otorisasi dengan token refresh dan akses.
Aplikasi kemudian dapat menggunakan ID file dari parameter URL pada langkah 3 dan token OAuth 2.0 yang diperoleh pada langkah 4 untuk memanggil Drive API. Untuk informasi selengkapnya, lihat Ringkasan Google Drive API.