支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    CMS API：視頻搜索v2

    本主題說明了使用視頻搜索第2版的語法， CMS API.

    簡介

    版本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”仍可能會返回。在下一部分中，說明瞭如何將搜索結果限制為僅包含指定字詞的視頻。

    有一些修飾符可幫助您將搜索結果限制為所需的視頻。

    搜索修飾符
    改變 產品描述 實例
    + 在搜索字詞前加上加號（+）表示返回的視頻 必須的， 有指定的期限
    • +bird （返回 只能 帶有“bird“在上面列出的字段中）
    • +tags:bird （返回 只能 帶有“bird“ 在裡面 tags)
    - or NOT 在搜索詞前加上減號（-）或 NOT 表示返回的視頻 不得 有指定的期限
    • -birds or NOT birds （僅返回符合條件的視頻 不 有“bird“在上面列出的字段中）
    • -name:birds or NOT name:birds （僅返回符合條件的視頻 不 有“bird“ 在裡面 name)
    (term) AND (term)
    or
    (term) OR (term)    		 邏輯上 AND 和 OR 運算符允許您組合多個搜索詞以進行複雜查詢
    • (+name:heron) AND (+tags:bird) （將返回包含 都 "heron“ 在裡面 name 和“bird“ 在裡面 tags)
    • (+name:heron) OR (+tags:bird) （將返回包含 或 "heron“ 在裡面 name 和“bird“ 在裡面 tags)
    • ((+name:heron) AND (+tags:bird)) AND (NOT tags:internal) （將返回包含 都 "heron“ 在裡面 name 和“bird“ 在裡面 tags，但 不 標籤“internal")

    詞組搜索

    您可以通過用引號將短語（而不是單個單詞）搜索：

    • "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
    通配符（可用於開始或結束日期/時間） *
    • 2019-09-30T14:24:33.512Z TO *
    • * TO 2019-09-30T14:24:33.512-4:00Z

    以下是一些示例日期/時間搜索字符串。

    樣本數據/時間搜索
    搜索字符串 產品描述
    +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日之前添加的視頻
    頁面最後更新於15年2020月XNUMX日