簡介
版本2使用的視頻搜索版本 CMS API 簡化了語法並使其更易於使用。
選擇要使用的語法是選擇適當的URL參數的簡單問題:
- 要使用新的v2搜索,請執行以下操作:
.../videos?query={search_string}
- 要使用原始搜索:
.../videos?q={search_string}
基礎知識
搜索字符串的基本元素是 搜索詞,可以以字段名作為前綴。 如果包括字段名稱,則僅搜索該元數據字段。 否則,將搜索幾個字段(下面列出)。
例如:
搜索字符串 | 將會退還什麼 |
---|---|
bird |
帶有“bird 在下面列出的字段中 |
name:bird |
帶有“bird “ 在裡面 name (標題)將被返回。 |
當您不提供要搜索的字段名稱時,請求將在以下字段中搜索該值:
id
name
description
long_description
text
(不是真正的元數據字段,而是可用於搜索name
,description
和long_description
-例如text:bird
)tags
reference_id
custom_fields
(搜索所有自定義字段)custom_field_name
(搜索特定的命名自定義字段)
支持的搜索字段包括:
場 | 法律價值 |
---|---|
name |
字符串或帶引號的字符串 |
文本 | 字符串或帶引號的字符串(搜索 name , description 和 long_description ) |
tags |
字符串或帶引號的字符串(多個標籤應以逗號分隔) |
custom_fields |
字符串或帶引號的字符串(搜索所有自定義字段-您還可以使用特定的自定義字段 內部 名稱) |
reference_id |
字符串或帶引號的字符串 |
state |
ACTIVE , INACTIVE , PENDING , DELETED (僅返回在過去10天內刪除的視頻) |
updated_at |
日期時間或範圍(詳情如下) |
created_at |
日期時間或範圍(詳情如下) |
schedule.starts_at |
日期時間或範圍(詳情如下) |
schedule.ends_at |
日期時間或範圍(詳情如下) |
published_at |
日期時間或範圍(詳情如下) |
complete |
true or false |
在上面顯示的兩個示例中,未包含“bird
”仍可能會返回。在下一部分中,說明瞭如何將搜索結果限制為僅包含指定字詞的視頻。
高級搜索
有一些修飾符可幫助您將搜索結果限制為所需的視頻。
改變 | 產品描述 | 範例檔案 |
---|---|---|
+ |
在搜索字詞前加上加號(+)表示返回的視頻 必須的, 有指定的期限 |
|
- or NOT |
在搜索詞前加上減號(-)或 NOT 表示返回的視頻 不得 有指定的期限 |
|
(term) AND (term) or (term) OR (term) |
邏輯上 AND 以及 OR 運算符允許您組合多個搜索詞以進行複雜查詢 |
|
詞組搜索
您可以通過用引號將短語(而不是單個單詞)搜索:
"blue heron"
name:"blue heron"
日期/時間
您可以使用以下方法按日期時間間隔進行搜索:
[{start} TO {end}]
要搜索單個日期/時間,請設置 start
以及 end
值相同:
[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z]
日期時間值使用ISO 8601格式指定:
約會時間 | 格式 | 例 |
---|---|---|
約會時間 | yyyy-MM-ddThh:mm:ss.sssZ |
2019-09-30T14:24:33.512Z |
通配符(可用於開始或結束日期/時間) | * |
|
以下是一些示例日期/時間搜索字符串。
搜索字符串 | 產品描述 |
---|---|
+updated_at:[2019-09-30T00:00:00.000Z TO 2019-10-07T00:00:00.000Z] |
視頻更新時間為30年2019月7日至2019年XNUMX月XNUMX日 |
+created_at:[2019-09-30T00:00:00.000Z TO 2019-09-30T00:00:00.000Z] |
視頻添加於30年2019月XNUMX日 |
+created_at:[2019-09-30T14:00:00.000Z TO 2019-09-30T16:30:00.000Z] |
在2年00月4日30:30 PM至2019:XNUMX PM(UTC)之間添加的視頻 |
+created_at:[* TO 2019-09-30T00:00:00.000Z] |
在30年2019月XNUMX日之前添加的視頻 |