Kueri & Paginasi Tautan Berbagi melalui API SearchShareLink - Drive and Photo Service

Kueri berbagi URL.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /v2/share_link/search HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
body	object	No	Parameter permintaan.
limit	integer	No	Jumlah maksimum hasil yang dikembalikan. Nilai yang valid: 1 hingga 100. Nilai default: 100. Jumlah hasil yang dikembalikan harus kurang dari atau sama dengan jumlah yang ditentukan.	50
marker	string	No	Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda tidak perlu menentukan parameter ini untuk permintaan pertama. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai marker. Secara default, parameter ini dibiarkan kosong.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
return_total_count	boolean	No	Menentukan apakah akan mengembalikan jumlah total hasil yang dikembalikan.	false
order_by	string	No	Bidang yang digunakan untuk mengurutkan hasil yang dikembalikan. Nilai default: created_at. Nilai yang valid: share_name: mengurutkan hasil berdasarkan nama berbagi. updated_at: mengurutkan hasil berdasarkan waktu saat berbagi dimodifikasi. description: mengurutkan hasil berdasarkan deskripsi berbagi. created_at: mengurutkan hasil berdasarkan waktu saat berbagi dibuat. Valid values: share_name : 分享名称 updated_at : 修改时间 description : 描述 created_at : 创建时间	created_at
order_direction	string	No	Arah pengurutan hasil yang dikembalikan. Secara default, order_direction diatur ke DESC jika order_by diatur ke created_at atau updated_at, dan diatur ke ASC jika order_by diatur ke nilai lainnya. Nilai yang valid: ASC: mengurutkan hasil secara ascending. DESC: mengurutkan hasil secara descending. Valid values: ASC : 升序 DESC : 降序	ASC
creators	array	No	Pembuat berbagi. Tetapkan parameter ini ke ID pengguna. Jika Anda tidak menentukan parameter ini, Drive and Photo Service secara otomatis menanyakan berbagi berdasarkan izin Anda. Jika Anda adalah administrator drive atau super administrator, berbagi yang dibuat oleh semua anggota akan ditanyakan. Jika Anda adalah administrator tim, berbagi yang dibuat oleh semua anggota tim akan ditanyakan. Jika Anda adalah pengguna biasa, hanya berbagi yang dibuat oleh Anda sendiri yang akan ditanyakan. Jika Anda menentukan parameter ini, parameter ini harus diatur ke ID super administrator, administrator drive, atau administrator tim.
	string	No	Pembuat berbagi.	c9b7a5aa04d14ae3867fdc886fa01da4
query	string	No	Kondisi kueri yang digunakan untuk mencari URL berbagi. Anda dapat menggunakan bidang berikut untuk menentukan kondisi kueri: created_at: menanyakan URL berbagi berdasarkan waktu pembuatan URL berbagi tersebut. updated_at: menanyakan URL berbagi berdasarkan waktu modifikasi URL berbagi tersebut. share_name_for_fuzzy: menanyakan URL berbagi berdasarkan nama berbagi. Mendukung Pencocokan kabur. status: menanyakan URL berbagi berdasarkan status berbagi. Nilai yang valid: enabled dan disabled. Nilai enabled menunjukkan bahwa berbagi tersebut valid. Nilai disabled menunjukkan bahwa berbagi tersebut dibatalkan. expired_time: menanyakan URL berbagi berdasarkan waktu kedaluwarsa berbagi. Jika berbagi tidak pernah kedaluwarsa, atur bidang ini ke 1970-01-01T00:00:00. Jika tidak, atur bidang ini ke 1970-01-02T00:00:00.	created_at>='2022-01-18T02:50:00' and created_at<'2022-01-19T09:45:28' and share_name_for_fuzzy match 'HD.mp4' and status in ['enabled', 'disabled'] and expired_time='1970-01-01T00:00:00'

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
items	array	URL berbagi.
	ShareLink	URL berbagi.
next_marker	string	Token paginasi. Dapat digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Jika next_marker kosong, berarti tidak ada halaman berikutnya.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
total_count	integer	Jumlah total entri yang dikembalikan.	101

Contoh

Respons sukses

JSONformat

{
  "items": [
    {
      "share_id": "7JQX1FswpQ8",
      "share_pwd": "abcF123x",
      "drive_id": "1",
      "file_id_list": [
        "[\"xx\"]"
      ],
      "expiration": "2020-06-28T11:33:00.000+08:00",
      "expired": false,
      "created_at": "2019-08-20T06:51:27.292Z",
      "updated_at": "2019-08-20T06:51:27.292Z",
      "description": "videos",
      "share_name": "video-1.MP4",
      "creator": "c9b7a5aa04d14ae3867fdc886fa01da4",
      "status": "enabled",
      "preview_count": 10,
      "save_count": 2,
      "download_count": 5,
      "report_count": 0,
      "video_preview_count": 1,
      "access_count": 4,
      "disable_preview": false,
      "disable_save": false,
      "disable_download": false,
      "preview_limit": 100,
      "save_limit": 100,
      "download_limit": 100,
      "require_login": false,
      "share_all_files": true,
      "share_msg": "pwd: 123",
      "save_download_limit": 100,
      "office_editable": true
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg",
  "total_count": 101
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.