サポート サポート問い合わせ先 | システムステータス システムステータス
ページ内容

    ラベルを使った作業

    このトピックでは、を使用してラベルを作成、管理、および使用する方法を学習します。 CMS API.

    賃貸システムの概要

    ラベルはタグに似ています。 それらをビデオに追加し、それらを使用してビデオのグループを検索することができますが、いくつかの明確な利点があります。

    • ラベルはアカウントレベルで作成され、動画に適用されます。

      これは、ビデオライブラリの整理を目的とする場合に特に重要です。たとえば、タグを使用して動画を整理しようとしている場合は、次のようなタグを作成できます。 birds, fishおよび insects。 次に、すべての鳥のビデオを簡単に検索して見つけ、それらのスマートプレイリストを作成します。 しかし、ユーザーが新しいビデオを誤って追加した場合、 bird birds、あなたは今新しいタグを持っており、ビデオはあなたに属していません birds コレクション。

      というラベルを作成した場合 birds 代わりに、そのラベルのみを動画に追加できます。 誤って存在しないラベルを追加することはできません birds 代わりに。

    • ラベルは、次のような階層パスとして作成されます /nature/birds/shore_birds.

      つまり、部分パスまたは完全パスを検索(またはそれに基づいてプレイリストを作成)できます。

      • q=labels:/nature -ラベルが付いているすべての動画を返します nature
      • q=labels:/nature/birds -を返します birds のサブグループ nature ビデオ
      • q=labels:/nature/birds/shore_birds -を返します shore_birds のサブグループ /nature/birds ビデオ

    ラベルの作成と管理

    アカウントのラベルは、 CMS API /v1/accounts/{account_id}/labels エンドポイント

    以下に示すすべてのAPIエンドポイントがCMSベースURLに追加されることに注意してください。

    https://cms.api.brightcove.com

    ラベルを作成する

    新しいラベルを作成するには、フルパスを POST リクエスト:

    サンプルリクエストエンドポイント

    /v1/accounts/1234567890/labels

    サンプルリクエストボディ

    {
      "path": "/nature/birds/shore_birds/"
    }

    注意してください パスに存在しないラベルが作成されます。 別のグループを追加したい場合 forest_birds、あなたは送るでしょう:

    {
      "path": "/nature/birds/forest_birds/"
    }

    今回は、 forest_birds サブラベルが作成されます。 naturebirds すでに存在しています。

    同様に、新しいサブグループを追加したい場合 sandpipers 〜へ shore_birds、あなたは送るでしょう:

    {
      "path": "/nature/birds/shore_birds/sandpipers"
    }

    サンプルレスポンス

    {
      "path": "/nature/birds/shore_birds/sandpipers/"
    }

    ラベルを取得する

    アカウントのすべてのラベルを取得するには、 GET リクエスト:

    サンプルリクエストエンドポイント

    /v1/accounts/1234567890/labels

    サンプルレスポンス

    {
      "account_id": "57838016001",
      "labels": [
        "/nature/birds/",
        "/nature/birds/shore_birds/",
        "/nature/birds/forest_birds/",
        "/nature/mammals/seamammals/"
      ],
      "version": 4
    }

    ラベルを更新する

    ラベルを更新するには、 PATCH リクエストを実行してあなたのアカウント内のプレイリストの数を取得することもできます:

    /v1/accounts/{account_id}/labels/by_path/{path}

    サンプルリクエストエンドポイント

    /v1/accounts/1234567890/labels/by_path//nature/birds/shore_birds

    サンプルリクエストボディ

    {
      "new_label": "coastal_birds"
    }

    なお、 new_label 値は、 {path} リクエストに含まれています。 だから代わりにあなたが交換したかったら /birds   /avian、リクエストと本文は次のようになります。

    エンドポイント
    /v1/accounts/1234567890/labels/by_path//nature/birds/
    ボディをリクエストする
    {
      "new_label": "avian"
    }

    このリクエストの後、 coastal_birds パスがなる /nature/wildlife/avian/coastal_birds。 階層内の追加のサブラベルのパスは変わるため、 /nature/birds/forest_birds になる /nature/wildlife/avian/forest_birds

    応答には、更新されたラベルの数が含まれます。

    サンプルレスポンス
    {
      "path": "/nature/avian",
      "labels_updated": "2"
    }

    ラベルを削除する

    ラベルを削除するには、 DELETE 更新リクエストと同じエンドポイントに送信されたリクエスト。 そのサブラベルで終わるパス(および追加のサブラベルを持つパス)のみが削除され、上位レベルのラベルは保持されます。

    たとえば、次のXNUMXつのラベルパスがあるとします。

    
          /nature/wildlife/avian/coastal_birds
          /nature/wildlife/avian/coastal_birds/sandpipers
          /nature/wildlife/avian/forest_birds
        

    を送信しています DELETE 要求する /v1/accounts/1234567890/labels/by_path//nature/wildlife/avian/coastal_birds 上記の最初のパスは削除されますが、XNUMX番目のパスには影響しません。

    ビデオへのラベルの追加と更新

    ラベルをフルラベルパスの配列として動画に追加します。

    [
          "/nature/wildlife/avian/coastal_birds",
          "/nature/wildlife/avian/coastal_birds/sandpipers"
    ]

    labels配列は、 ビデオの作成(POST)リクエスト または ビデオの更新(PATCH)リクエスト.

    動画ラベルを更新するには、更新された完全な動画配列を ビデオの更新(PATCH)リクエスト。 したがって、たとえば、 /nature/wildlife/avian/forest_birds、あなたは配列を送るでしょう:

    [
          "/nature/wildlife/avian/coastal_birds",
          "/nature/wildlife/avian/coastal_birds/sandpipers",
          "/nature/wildlife/avian/forest_birds"
    ]

    ラベルによる動画の検索

    あなたはビデオを検索することができます labels 検索でサポートされている他のフィールドと同じように。 概要で述べたように、検索パスにサブラベルを追加すると、検索結果がフィルタリングされます。

    ラベルの例で検索
    サンプル検索 それが返すもの
    q=labels:/nature で始まるラベルパスを持つすべての動画 /nature
    q=labels:/nature/wildlife で始まるラベルパスを持つすべての動画 /nature/wildlife
    q=labels:/nature/wildlife/avian で始まるラベルパスを持つすべての動画 /nature/wildlife/avian

    制限事項

    • アカウントには最大10,000個のラベルを追加できます
    • ラベルによる検索は現在、 v1検索構文のみ
    • ラベルは Studio上ではサポートされていません。 を使用してアフィリエイトに共有されるビデオメタデータに含まれています メディアの共有.

    ページの最終更新日:28年2020月XNUMX日