Membuka klien desktop - Drive and Photo Service

Catatan

Topik ini menjelaskan cara menggunakan skema URL untuk membuka klien desktop dan melakukan operasi tertentu.

1 Skema URL

Nama protokol untuk skema URL klien desktop BasicUI adalah pds diikuti oleh ID domain.

Sebagai contoh, jika ID domain adalah hz65, nama protokol untuk skema URL adalah pdshz65:.

Contoh Membuka URL:

window.open("pdshz65:open?opt=%7B%22seq_id%22%3A%22x3hug4qu1xn%22%2C%22pathname%22%3A%22%2Findex%22%7D")

2 Parameter URL

<protocol>:<action>?opt=[opt]

Parameter	Deskripsi
protocol	Nama protokol. Nilainya adalah pds diikuti oleh ID domain.
action	Pathname dari URL. Nilainya adalah kata kerja. Nilai yang valid: `open` dan `download`.
opt	String yang dihasilkan setelah string JSON yang ditentukan dikodekan dengan menggunakan fungsi `encodeURIComponent(JSON.stringify(opt))`.

2.1 Membuka URL Tertentu

Bidang Parameter opt:

Bidang	Deskripsi
seq_id	ID urutan. ID harus unik dalam sesi. Sesi berlangsung dari pembukaan hingga penutupan klien desktop.
pathname	Pathname dari URL ke mana Anda dialihkan setelah klien diaktifkan.

Contoh:

let domainId='hz65'
let action='open'
let opt ={
  "seq_id": Math.random().toString(36).substring(2),
  "pathname":"/drive"
}
let url = `pds${domainId}:${action}?opt=${encodeURIComponent(JSON.stringify(opt))}`
window.open(url)

2.2 Mengunduh File Tertentu

Bidang Parameter opt:

Bidang	Deskripsi
seq_id	ID urutan. ID harus unik dalam sesi. Sesi berlangsung dari pembukaan hingga penutupan klien desktop.
pathname	`pathname` dari URL ke mana Anda dialihkan setelah klien diaktifkan.
loc_type	Tipe lokasi penyimpanan. Nilai yang valid: `drive` dan `share`.
loc_id	ID lokasi penyimpanan. Jika bidang `loc_type` disetel ke `drive`, nilai bidang ini adalah `drive_id`. Jika bidang loc_type disetel ke `share`, nilai bidang ini adalah `share_id`.
file_keys	File yang akan diunduh. Jika penyimpanan dalam mode standar, nilainya adalah array dari `file_id`. Jika penyimpanan dalam mode hosting, nilainya adalah array dari `file_path`. Contoh: `["file_id1","file_id2"]`.

Contoh:

let domainId='hz65'
let action='download'
let opt ={
  "seq_id": Math.random().toString(36).substring(2),
  "loc_type": "drive",
  "loc_id": "1",
  "pathname":"/drive/folders/5e9d2e02570e5a973cd64b648cbf97ac2ebb26dc",
  "file_keys":["5faebd028e8365fef08b4a019308765631e179e0"]
}
let url = `pds${domainId}:${action}?opt=${encodeURIComponent(JSON.stringify(opt))}`
window.open(url)