カスタム検索作成ガイド

注： relatedToVideoIdパラメータが設定されている場合、他にサポートされているパラメータは以下のとおりです。 regionCode, relevanceLanguage, safeSearchそして fields.

• completed - 完了した放送のみを含む。
• live - アクティブな放送のみを含める。
• upcoming - 今後放送されるもののみ。

• について location パラメータ値は、領域の中心点を特定する。
• について locationRadius パラメータは、動画が検索結果に含まれるために、動画に関連付けられた場所がその地点から最大距離を指定します。

リクエストで location パラメータの値も指定しない。 locationRadius パラメータが必要だ。

パラメータ値は、浮動小数点数の後に測定単位を続けなければならない。有効な測定単位は m, km, ftそして mi.例えば、有効なパラメータ値には次のようなものがあります。 1500m, 5km, 10000ftそして 0.75mi.APIは以下をサポートしていません。 locationRadius パラメータの値が1000kmより大きい。

注： の定義を参照のこと。 location パラメータを使用する。

許容される値は以下の通り：

• date - リソースは、作成された日付に基づいて逆年代順にソートされます。
• rating - リソースは、評価の高いものから低いものへとソートされている。
• relevance - リソースは、検索クエリとの関連性に基づいてソートされます。これがこのパラメータのデフォルト値です。
• title - リソースはタイトル順にアルファベット順に並んでいます。
• viewCount - リソースは、再生回数の多いものから少ないものへとソートされます。ライブ放送の場合、ビデオは放送中の同時視聴者数でソートされます。

リクエストはまた、ブール値のNOT(-)とOR(|)演算子で動画を除外したり、複数の検索語のいずれかに関連する動画を検索したりすることができます。たとえば、"boating" または "sailing" のどちらかに一致する動画を検索するには q パラメータ値を boating|sailing.同様に、"fishing" ではなく、"boating" または "sailing" のどちらかにマッチするビデオを検索するには、次のように設定します。 q パラメータ値を boating|sailing -fishing.

許容される値は以下の通り：

• moderate - YouTubeは検索結果からいくつかのコンテンツをフィルタリングし、少なくとも、あなたのロケールで制限されているコンテンツをフィルタリングする。そのコンテンツに基づいて、検索結果が検索結果から削除されたり、検索結果で降格されたりする可能性があります。これはデフォルトのパラメータ値です。
• none - YouTubeは検索結果をフィルタリングしない。
• strict - YouTubeは、検索結果セットからすべての制限されたコンテンツを除外しようとします。そのコンテンツに基づいて、検索結果が検索結果から削除されたり、検索結果で降格されたりする可能性がある。

許容される値は以下の通り：

• any - キャプションの有無で結果をフィルタリングしない。
• closedCaption - キャプションのあるビデオのみを含める。
• none - キャプションのないビデオのみを含める。

許容される値は以下の通り：

• any - 解像度に関係なく、すべてのビデオを返す。
• high - HDビデオだけを取り出す。
• standard - 標準画質のビデオのみを検索します。

許容される値は以下の通り：

• 2d - 3Dビデオを除外するために検索結果を制限する。
• 3d - 検索結果を3Dビデオのみに制限する。
• any - 3D動画と非3D動画の両方を検索結果に含める。これはデフォルト値です。

許容される値は以下の通り：

• any - 動画の検索結果を再生時間に基づいてフィルタリングしない。これはデフォルト値です。
• long - 20分以上の動画に限ります。
• medium - 4分以上20分以内のビデオに限ります。
• short - 長さ4分以内のビデオのみを含めること。

許容される値は以下の通り：

• any - 埋め込み可能かどうかにかかわらず、すべての動画を返す。
• true - 埋め込み可能な動画のみを取得する。

許容される値は以下の通り：

• any - クエリパラメータに一致する動画を、ライセンスに関係なくすべて返します。
• creativeCommon - クリエイティブ・コモンズ・ライセンスを持つ動画のみを返します。ユーザーは、このライセンスを持つ動画を、作成した他の動画で再利用することができます。 さらに詳しく.
• youtube - YouTubeの標準ライセンスを持つ動画のみを返します。

許容される値は以下の通り：

• any - シンジケートの有無にかかわらず、すべてのビデオを返す。
• true - シンジケートされたビデオのみを取得する。

許容される値は以下の通り：

• any - すべてのビデオを返す。
• episode - 番組のエピソードだけを取り出す。
• movie - 映画だけを取り出す。