動画の検索 | YouTube Data API v2

• 検索
• 動画のアップロード
• 動画の更新と削除
• コミュニティ機能

• 検索

feeds/api/standardfeeds/FeedId

feeds/api/videos

feeds/api/channels

feeds/api/playlists/snippets

feeds/api/users/username

feeds/api/users/username/uploads

feeds/api/users/username/favorites

feeds/api/users/username/playlists

feeds/api/users/username/subscriptions

feeds/api/users/username/contacts

feeds/api/videos/videoid

feeds/api/videos/videoid/responses

feeds/api/videos/videoid/related

feeds/api/videos/videoid/comments

feeds/api/videos/videoid/ratings

feeds/api/videos/videoid/complaints

• atom (既定)
• rss
• json
• json-in-script^※1
• jsonc^※1※2

検索リクエストでは、検索範囲を特定のYouTubeユーザーがアップロードした動画に制限する

標準フィードのリクエストでは、標準フィードを取得してから、特定の投稿者がアップロードした動画にのみレスポンスをフィルタリングする

ユーザー アクティビティ フィードのリクエストでは、authorパラメータには、最大20件のYouTubeユーザー名をカンマで区切ったリストを含める。レスポンスには、それらのユーザーのいずれかが行ったアクティビティが含まれる

1をベースとしたインデックス。つまり最初の結果が1で、2番目の結果が2

APIのデフォルトの動作では、無効なリクエスト パラメータを無視する

APIのバージョンを指定しないと、YouTubeではそのリクエストの処理にAPIバージョン1を使用する。APIのバージョン指定については、APIのバージョン指定セクションにある

このパラメータは値を指定しない。さもなくばAPIはHTTP 400レスポンスを返す。

• 特定の場所を指定する地理座標 (緯度,経度) を指定する。そのときにはlocation-radiusパラメータと組み合わせて、地域を定義する

  地名に関連付けられていて、特定の地理座標には関連付けられていない動画をAPIレスポンスから除外するには、感嘆符 (「!」) をパラメータ値の最後に追加する。これによりAPIレスポンス内のすべての動画を、必ず地図上にプロットできるようになる。

  このパラメータの使用例を次に示す。

  location=37.42307,-122.08427&location-radius=100km

  location=37.42307,-122.08427!&location-radius=100km

  特定の座標に関連付けられたフィード エントリには<georss:where>タグが含まれ、さらに<yt:location>タグが含まれることもある。

  地名に関連付けられ、特定の地理座標には関連付けられてはいないフィード エントリは、<yt:location>タグを使って場所を指定する。

• 空にするか、または感嘆符を1つ指定する。そのときパラメータには値は必要ない。

  パラメータを指定すると地理的場所が指定された動画に検索結果が限定されるが、特定の地理的場所の動画を検索することはできない。

  地理的場所が指定された動画では、そのメタデータに<georss:where>タグが含まれる。

パラメータ値は、浮動小数点数の後に単位を付けて指定する必要がある。有効な単位は、m、km、ft、mi。有効なパラメータ値の例は、「1500m」、「5km」、「10000ft」、「0.75mi」。この半径の値が、1,000kmより大きいと、APIはエラーを返す。

動画で利用できるキャプション トラックのリストを取得するリクエストで、lrパラメータはキャプション トラックのリストをフィルタリングして、指定した言語のみを含むようにする。lrパラメータの有効値は、ISO 639-1の2文字の言語コード

このパラメータの有効値は、

• relevance (関連度)
• published (投稿日時)
• viewCount (再生回数)
• rating (評価)
• relevance_lang_languageCode

relevance_lang_languageCodeに設定すると、特定の言語に最も関連性の高い結果を要求できる。ここでlanguageCodeはISO 639-1の2文字の言語コード。言語コードを指定した場合でも、検索キーワードとの関連性が高い場合には他の言語の結果も返されることがある。

デフォルト値は、検索結果フィードの場合relevance (関連性)

動画のすべての動画メタデータ (タイトル、キーワード、説明、投稿者のユーザー名、カテゴリ) をこのキーワードと照合して検索する。

パラメータ値の中に空白、引用符などの区切り文字を含めるには、URLエスケープが必要。

• 完全一致を検索 … キーワードを引用符 (") で囲む。たとえば「spy plane」に一致する動画を検索するには、「%22spy+plane%22」とする。

リクエストにブール型演算子のNOT (-) とOR (|) を使って、動画を除外したり、複数の検索キーワードのいずれかに関連する動画を検索したりすることもできる。(パイプ (|) 文字はURLエスケープし、「%7C」とする)

• 「boating」または「sailing」に一致する動画を検索するには、「boating%7Csailing」とする。
• 「boating」か「sailing」のいずれかに一致し、「fishing」には一致しない動画を検索するには、「boating%7Csailing+-fishing」とする。

≫Data API v3での動画検索

このパラメータを常に使用して、エンド ユーザーのIPアドレスを指定することが望ましい (デフォルトでは、クライアント アプリケーションのIPアドレスに基づいて、APIリクエストを送信している国で再生できない動画が除外される)。

再生可能な動画を個々のコンピュータからリクエストするには、リクエストにrestrictionパラメータを含め、パラメータ値を、動画を再生するコンピュータのIPアドレスに設定する (例:restriction=255.255.255.255)。

特定の国で再生できる動画をリクエストするには、リクエストにrestrictionパラメータを含め、パラメータ値を、動画を再生する国のISO 3166の2文字の国コードに設定する (例:restriction=DE)。

検索結果、再生リスト、お気に入りの動画、動画レスポンスなど、動画のリストを取得するどのリクエストにも、このパラメータを含める。APIレスポンス内の動画が、指定している地域で再生できず、コンテンツの利用が制限されている場合、そのタグの<entry>には<media:content>タグは含まれないが、その動画が制限されていることを示す<yt:state>タグが含まれる。

YouTubeでコンテンツを制限するかどうかの判断は、APIリクエストにrestrictionパラメータを使って指定したユーザーのIPアドレスや場所に基づく。制限コンテンツをリクエストすると、制限コンテンツを含む動画のフィード エントリには、<media:rating>要素が含まれる。

このパラメータの有効な値は次の通り

このパラメータの有効な値は、

• today (1日)
• this_week (7日)
• this_month (1か月)
• all_time (すべての期間) (既定値)

このパラメータは、検索フィードと、top_rated、top_favorites、most_viewed、most_popular、most_discussed、most_respondedの各標準フィードに対してサポートされる。

YouTubeパートナーとは、YouTubeパートナー プログラムに承認され、参加している個人または組織のこと。uploaderパラメータの値にはpartnerを指定する。

APIレスポンスのフィード エントリには、<media:credit>タグのyt:type属性値がpartnerである場合、エントリにパートナー動画が含まれる。

<media:credit role="uploader" scheme="urn:youtube yt:type="partner">
  partner_name
</media:credit>