Method: claims.list

現時点で認証されているユーザーに関連付けられたコンテンツ所有者が管理している申し立てのリストを取得します。結果は作成時刻の降順に並べ替えられます。

HTTP リクエスト

GET https://youtubepartner.googleapis.com/youtube/partner/v1/claims

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
assetId

string

claimSearch.list メソッドの assetId パラメータを使用し、申し立てのスニペットをアセット ID で検索します。このメソッドの id パラメータを使用してクレーム ID のカンマ区切りリストを指定することで、これらのクレームの claim リソースを取得できます。
id

string

id パラメータには、取得する YouTube 申し立て ID のカンマ区切りのリストを指定します。
onBehalfOfContentOwner

string

onBehalfOfContentOwner パラメータは、ユーザーが代理を務めるコンテンツ所有者を示します。このパラメータは、アカウントが複数のコンテンツ所有者に関連付けられているユーザーをサポートします。
pageToken

string

pageToken パラメータには、返される特定のページを識別するトークンを指定します。たとえば、このパラメータを前の API レスポンスの nextPageToken 値に設定して、検索結果の次のページを取得します。
q

string

claimSearch.list メソッドの q パラメータを使用して、特定のクエリ文字列に一致する申し立てスニペットを検索します。このメソッドの id パラメータを使用してクレーム ID のカンマ区切りリストを指定することで、これらのクレームの claim リソースを取得できます。
videoId

string

claimSearch.list メソッドの videoId パラメータを使用して、動画 ID で申し立ての抜粋を検索します。このメソッドの id パラメータを使用してクレーム ID のカンマ区切りリストを指定することで、これらのクレームの claim リソースを取得できます。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

claims.list 呼び出しに応答して返される、ページ分けされたクレームのリスト。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "kind": string,
  "pageInfo": {
    object (PageInfo)
  },
  "items": [
    {
      object (Claim)
    }
  ],
  "nextPageToken": string,
  "previousPageToken": string
}
フィールド
kind

string

API レスポンスのタイプ。このオペレーションの場合、値は youtubePartner#claimList です。
pageInfo

object (PageInfo)

pageInfo オブジェクトは、結果セットのページング情報をカプセル化します。
items[]

object (Claim)

リクエスト条件に一致する申し立てのリスト。
nextPageToken

string

結果セットで次のページを取得するために pageToken パラメータの値として使用できるトークン。
previousPageToken

string

結果セットで前のページを取得するために、pageToken パラメータの値として使用できるトークン。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/youtubepartner

詳細については、OAuth 2.0 の概要をご覧ください。