YouTube Data API Searchリソースの使い方｜APIクエリパラメーター・レスポンス結果の解説【初心者向け】

この記事で扱う内容

この記事では、YouTube Data APIのSearchリソースについて、メソッドごとのAPIクエリパラメータ・レスポンス結果の解説をします。

前提と基本用語

必要な知識・スキル

ブラウザの基本操作ができる人

ブラウザとは、インターネット上のWebサイトを表示・操作するためのアプリケーションです。

以下が代表的なブラウザです。

Microsoft Edge
Safari
Google Chrome
Mozilla FireFox

必要な環境

PC
Googleアカウントが作成済みであること
Googleにログイン済みであること
Google Cloud ConsoleでYouTube Data APIが有効なプロジェクトが存在すること

Googleアカウント作成方法【初心者向け】

この記事で扱う内容この記事では、Googleアカウントを作成する方法についてご紹介します。前提前提知識・前提スキルブラウザの基本操作ができる人前提環境PCGoogleアカウントとはGoogleアカウントとは、GmailやGoogleドライブ...

Googleアカウントで二段階認証を設定する方法【初心者向け】

この記事で扱う内容この記事では、Googleアカウントで二段階認証を設定する方法についてご紹介します。前提前提知識・前提スキルブラウザの基本操作ができる人前提環境PCスマートフォンを持っていることスマートフォンに認証アプリをインストールして...

Google Cloud ConsoleでYouTube Data APIを有効にする方法【初心者向け】

この記事で扱う内容この記事では、Google Cloud ConsoleでYouTube Data APIを有効にする方法についてご紹介します。前提前提知識・前提スキルブラウザの基本操作ができる人前提環境PCGoogleアカウントが作成済み...

YouTube Data APIのリソースとメソッドとは

YouTube Data APIのリソースとは、動画やチャンネルなどの対象（データの種類）のことです。

YouTube Data APIのメソッドとは、そのリソース（動画やチャンネルなど）に対して行える操作（検索・取得・更新など）のことです。

このリソースとメソッドを組み合わせることで、欲しい情報を取得したり変更したりできます。

YouTube Data APIのプロパティとは

YouTube Data APIのプロパティとは、レスポンス結果の中に含まれる個々の情報項目のことです。

一般的に、フィールドや項目と表現されることもあります。

例えば、動画のタイトルやID、公開日時などがプロパティとして返されます。

YouTube Data APIのSearchリソースとは

YouTube Data APIのSearchリソースとは、YouTube上の検索対象（動画・チャンネル・再生リスト）のことです。

このリソースのメソッドを使うことで、自作のプログラムなどから、キーワードや条件を指定して目的の動画・チャンネル・再生リストを効率的に探すことができます。

Searchリソースの使い方

Searchリソースでは、以下のメソッドが提供されています。

No	メソッド名	概要
1	list	APIクエリパラメータで指定した条件に合う動画・チャンネル・再生リストを検索し、それらの情報を取得できる。

listメソッド

APIリクエストURL

https://www.googleapis.com/youtube/v3/search

APIクエリパラメータの解説

APIを使うためには、APIリクエストURLにクエリパラメータを付けて送信する必要があります。

必須パラメータ

設定は必須です。

パラメータ	設定値	概要
part （レスポンス結果に含める情報の種類）	以下から1つ以上を設定。・snippet （動画タイトル、動画概要、チャンネル名、公開日時などを含める）	検索結果に「どの種類の情報を含めるか」を指定するパラメータ。

このパラメータを設定しないと、エラーになり正常な結果が取得できません。

フィルタパラメータ

設定は任意です。

もし設定する場合、「いずれか1つだけ」を設定します。

パラメータ	設定値	概要
forContentOwner （コンテンツ所有者用の検索）	以下のどちらかを設定。・true ・false	特定のチャンネル全体に限定して検索したいときに指定するパラメータ。 true：限定する false：限定しない
forDeveloper （開発者用の検索）	以下のどちらかを設定。・true ・false	特定のアプリやWebサービスからアップロードされた動画に限定して検索したいときに指定するパラメータ。 true：限定する false：限定しない
forMine （YouTubeチャンネル所有者用の検索）	以下のどちらかを設定。・true ・false	特定のYouTubeチャンネルの動画に限定して検索したいときに指定するパラメータ。 true：限定する false：限定しない

いずれも、OAuth 2.0認証が必須です。
（APIキーでは利用できません）

オプションパラメータ

設定は任意です。

もし設定する場合、中には「他のパラメータと組み合わせないと使えないもの」や「自動的に他パラメータと組み合わせられるもの」があるので注意が必要です。

パラメータ	設定値	概要
channelId （チャンネルID）	任意のチャンネルID 例：UCrXUsMBcfTVqwAS7DKg9C0Q （YouTube Japan 公式チャンネルのチャンネルID）	検索対象のチャンネルIDを指定するパラメータ。
channelType （チャンネル種類）	以下のいずれか1つを設定。・any （すべて）・show （番組のみ） ※既定値は「any」。	検索対象のチャンネル種類を指定するパラメータ。 ※番組とは、公式番組提供者向けの番組チャンネルが提供する動画のこと。通常のチャンネルの動画やライブ配信とは異なる。
eventType （ライブ配信の状態）	以下のいずれか1つを設定。・completed （ライブ配信完了）・live （ライブ配信中）・upcoming （ライブ配信予定）	検索対象のライブ配信の状態を指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
location （地理的な中心位置）	任意の緯度と経度の座標例：37.42307,-122.08427	検索対象の地理的な中心位置を指定するパラメータ。 ※あわせて「locationRadius」パラメータを指定し、「type」パラメータに「video」を指定する必要あり。
locationRadius （地理的な中心位置からの半径）	任意の1,000km以下の距離例：5.5km	検索対象の位置情報の半径を指定するパラメータ。 ※浮動小数点数の後に測定単位（有効はm、km、ft、mi）を付けて指定する。 ※あわせて「location」パラメータを指定し、「type」パラメータに「video」を指定する必要あり。
maxResults （検索結果の取得件数）	0～50 ※既定値は「5」。	検索結果の件数を指定するパラメータ。
onBehalfOfContentOwner （コンテンツ所有者アカウントID）	任意のコンテンツ所有者アカウントID 例：abcd1234 （Googleから付与されるID）	特定のコンテンツ所有者アカウントIDを指定するパラメータ。 ※YouTubeコンテンツパートナー専用パラメータ。 ※OAuth 2.0 認証が必須（APIキーでは利用できない）。
order （検索結果の並び順）	以下のいずれか1つを設定。・date （作成日時の新しい順）・rating （評価の高い順）・relevance （関連性の高い順）・title （タイトルのアルファベット順）・videoCount （アップロードされた動画数の多い順）・viewCount （動画は表示回数の多い順、ライブ配信は同時視聴者数の多い順） ※既定値は「relevance」。	検索結果の並び順を指定するパラメータ。
pageToken （ページトークン）	任意のページトークン例：ABCDEF	検索結果の特定ページを指定するパラメータ。 ※検索結果が多い場合、検索結果はページ単位に分割され、それぞれにページトークンが割り振られる。
publishedAfter （公開日時の下限（これ以降））	任意のRFC 3339形式の日時例：2024-12-31T15:00:00Z （日本時間の2025-01-01 00:00:00）	検索対象の公開日時の下限（これ以降）を指定するパラメータ。 ※UTC（世界協定時刻）で解釈されるため、日本時間を指定する場合は、日本時間から9時間引いた日時を指定する。
publishedBefore （公開日時の上限（これ以前））	任意のRFC 3339形式の日時例：2025-12-31T14:59:59Z （日本時間の2025-12-31 23:59:59）	検索対象の公開日時の上限（これ以前）を指定するパラメータ。 ※UTC（世界協定時刻）で解釈されるため、日本時間を指定する場合は、日本時間から9時間引いた日時を指定する。
q （検索キーワード）	任意のキーワード例：猫例：猫\|犬例：猫\|犬 -鳥	検索キーワードを指定するパラメータ。 ※「-（否定）」や「\|（または）」記号をキーワード前に付けることで、特定のキーワードを除外したり、複数の検索キーワードで検索したりできる。
regionCode （動画を視聴できる国のコード）	任意のISO 3166-1 alpha-2形式の国コード例：JP （日本の国コード）	検索対象の動画を視聴できる国のコードを指定するパラメータ。 ※ユーザーの視聴可能性をもとに選別するだけで、動画投稿元の国を指定するものではない。
relevanceLanguage （関連性の高い言語コード）	任意のISO 639-1（2文字）の言語コード例：ja （日本の言語コード）	検索対象と関連性の高い言語のコードを指定するパラメータ。
safeSearch （検索の安全レベル）	以下のいずれか1つを設定。・moderate （一部のコンテンツを除外（少なくとも、ユーザーの言語・地域で制限されているコンテンツは除外））・none （何も除外しない）・strict （すべての制限付きコンテンツを除外） ※既定値は「moderate」	検索結果の安全レベルを指定するパラメータ。
topicId （FreebaseトピックID）	任意のFreebaseのトピックID 例：/m/04rlf （Music）	検索対象と関連性の高いFreebaseのトピックIDを指定するパラメータ。 ※Freebase は既に公式に非推奨。使用可能なFreebaseトピックIDは不明。
type （検索対象の種類）	以下から1つ以上を設定。・channel （チャンネル）・playlist （再生リスト）・video （動画） ※既定値は、「video,channel,playlist」。	検索するリソースの種類（動画、チャンネル、再生リスト）を指定するパラメータ。
videoCaption （動画の字幕有無）	以下のいずれか1つを設定。・any （すべて）・closedCaption （字幕有りのみ）・none （字幕無しのみ）	検索対象の動画の字幕有無を指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoCategoryId （動画カテゴリーID）	任意の動画カテゴリー例：22 （ブログ）	検索対象の動画のカテゴリーIDを指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoDefinition （動画の解像度）	以下のいずれか1つを設定。・any （すべて）・high （高画質（HD）の動画のみ）・standard （標準画質（SD）の動画のみ）	検索対象の動画の解像度を指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoDimension （動画の画面次元）	以下のいずれか1つを設定。・2d （2D動画のみ）・3d （3D動画のみ）・any （すべて） ※既定値は「any」。	検索対象の動画の画面次元を指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoDuration （動画の再生時間）	以下のいずれか1つを設定。・any （すべて）・long （20分超）・medium （4～20分）・short （4分未満） ※既定値は「any」。	検索対象の動画の再生時間を指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoEmbeddable （動画の埋め込み可否）	以下のいずれか1つを設定。・any （すべて）・true （埋め込み可能な動画のみ）	検索対象の動画の埋め込み可否を指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoLicense （動画のライセンス種別）	以下のいずれか1つを設定。・any （すべて）・creativeCommon （クリエイティブ・コモンズライセンスを持つ動画のみ）・youtube （標準のYouTubeライセンスを持つ動画のみ）	検索対象の動画のライセンス種別を指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoPaidProductPlacement （動画の商品プロモーション表示有無）	以下のいずれか1つを設定。・any （すべて）・true （有料プロモーションを含む動画のみ）	検索対象の動画内の商品プロモーション有無を指定するパラメータ。 ※YouTube広告の有無ではない。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoSyndicated （動画の配信範囲）	以下のいずれか1つを設定。・any （すべて）・true （シンジケーション動画（youtube.com以外でも再生できる動画）のみ）	検索対象の動画の配信範囲を指定するパラメータ。 ※あわせて「type」パラメータに「video」を指定する必要あり。
videoType （動画種類）	以下のいずれか1つを設定。・any （すべて）・episode （番組エピソードのみ）・movie （映画のみ）	検索対象の動画種類を指定するパラメータ。 ※映画とは、YouTubeが公式に提供している映画動画のこと。通常の動画とは異なる。 ※あわせて「type」パラメータに「video」を指定する必要あり。

オプションパラメータの使用頻度別一覧

個人的な使用感ですが、オプションパラメータを使用頻度別に分けしてみました。

もちろん、APIの利用用途によって変わる部分なので、すべての方に当てはまるとは思いませんが、初学者の方でしたら、以下の優先順位で覚えるのも良いのではないかと思います。

よく使う

maxResults（検索結果の取得件数）
order（検索結果の並び順）
pageToken（ページトークン）
q（検索キーワード）
type（検索対象の種類）

まあまあ使う

channelId（チャンネルID）
publishedAfter（公開日時の下限（これ以降））
publishedBefore（公開日時の上限（これ以前））
videoCategoryId（動画カテゴリーID）
videoDuration（動画の再生時間）

たまに使う

eventType（ライブ配信の状態）
regionCode（動画を視聴できる国のコード）
relevanceLanguage（関連性の高い言語コード）

ほぼ使わない

channelType（チャンネル種類）
location（地理的な中心位置）
locationRadius（地理的な中心位置からの半径）
onBehalfOfContentOwner（コンテンツ所有者アカウントID）
safeSearch（検索の安全レベル）
topicId（FreebaseトピックID）
videoCaption（動画の字幕有無）
videoDefinition（動画の解像度）
videoDimension（動画の画面次元）
videoEmbeddable（動画の埋め込み可否）
videoLicense（動画のライセンス種別）
videoPaidProductPlacement（動画の商品プロモーション表示有無）
videoSyndicated（動画の配信範囲）
videoType（動画種類）

APIレスポンス結果の解説

APIリクエストURLを送信すると、レスポンス結果が返ってきます。

レスポンス結果

APIリクエストに成功すると以下のようにレスポンス結果が返ってきます。

レスポンス結果は大きく分けて、以下の要素で構成されています。

レスポンス結果全体（youtube#searchListResponseという種類のリソース）
検索結果（youtube#searchResultという種類のリソース）

1つのレスポンス結果全体の中に、1つ～複数の検索結果が含まれます。

{
  "kind": "youtube#searchListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "regionCode": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    {
      "kind": "youtube#searchResult",
      "etag": etag,
      "id": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      },
      "snippet": {
        "publishedAt": datetime,
        "channelId": string,
        "title": string,
        "description": string,
        "thumbnails": {
          "default": {
            "url": string,
            "width": unsigned integer,
            "height": unsigned integer
          },
          "medium": {
            "url": string,
            "width": unsigned integer,
            "height": unsigned integer
          },
          "high": {
            "url": string,
            "width": unsigned integer,
            "height": unsigned integer
          },
          "standard": {
            "url": string,
            "width": unsigned integer,
            "height": unsigned integer
          },
          "maxres": {
            "url": string,
            "width": unsigned integer,
            "height": unsigned integer
          },
        },
        "channelTitle": string,
        "liveBroadcastContent": string
      }
    }
  ]
}

youtube#searchListResponseリソースのプロパティ

プロパティ	値の型と例	概要
kind	文字列（string）例：”youtube#searchListResponse”	レスポンス結果全体のリソース種類。固定値。
etag	文字列（string）例：”pV8eQZStdeClPWW92xVaB4piKe8″	リソースのEtag。 ※Etagは、キャッシュ制御や変更検出に使う識別子のこと。
nextPageToken	文字列（string）例：”CGQQAA”	次のページを取得するときに指定するトークン。
prevPageToken	文字列（string）例：”CDIQAQ”	前のページを取得するときに指定するトークン。
regionCode	文字列（string）例：”JP” ※既定値は「US」。	検索時に指定された国コード。オプションパラメータ「regionCode」に指定した値。
pageInfo	オブジェクト（object）例： { “totalResults”: 1000000, “resultsPerPage”: 50 }	ページ情報。以下のプロパティを含むオブジェクト。・totalResults ・resultsPerPage
pageInfo.totalResults	数値（integer）例：1000000	検索結果の総件数（近似値）。最大値は、1,000,000。
pageInfo.resultsPerPage	数値（integer）例：50	検索結果1ページあたりの件数。 APIリクエストURLに付けたオプションパラメータ「maxResults」で制御される。
items	リスト（list）例： [ { “kind”: “youtube#searchResult”, （省略） }, { “kind”: “youtube#searchResult”, （省略） }, （省略） ]	検索結果（youtube#searchResultリソース）のリスト。動画／チャンネル／再生リストごとの情報が含まれる。

youtube#searchResultリソースのプロパティ

プロパティ	値の型と例	概要
kind	文字列（string）例：”youtube#searchResult”	検索結果のリソース種類。固定値。
etag	文字列（string）例：”hcqmUk7eiRuvRxF9tP89uH4c4NA”	リソースのEtag。 ※Etagは、キャッシュ制御や変更検出に使う識別子のこと。
id	オブジェクト（object）例： { “kind”: “youtube#video”, “videoId”: “p6h57WqRRl8” }	ID情報。以下のプロパティを含むオブジェクト。・kind ・videoId、channelId、playlistIdのいずれか
id.kind	文字列（string）例：”youtube#video” 例：”youtube#channel” 例：”youtube#playlist”	検索結果のリソース種類。固定値。動画、チャンネル、再生リストごとに値が変わる。
id.videoId	文字列（string）例：”p6h57WqRRl8″	動画ID。 ※このプロパティは、id.kindプロパティの値が「”youtube#video”」の場合に存在する。
id.channelId	文字列（string）例：”UCTDMT3aL30noTVFgNPA9XtQ”	チャンネルID。 ※このプロパティは、id.kindプロパティの値が「”youtube#channel”」の場合に存在する。
id.playlistId	文字列（string）例：”PLmnMiSXtJEB1MLExnImqhHsHG6MevUrG-“	再生リストID。 ※このプロパティは、id.kindプロパティの値が「”youtube#playlist”」の場合に存在する。
snippet	オブジェクト（object）例： { “publishedAt”: “2024-12-04T15:00:58Z”, “channelId”: “UCTDMT3aL30noTVFgNPA9XtQ”, “title”: “劇場版『名探偵コナン隻眼の残像(せきがんのフラッシュバック)』特報【2025年4月18日(金)公開】”, “description”: “ついてくるな、遊びじゃねえんだー。劇場版『名探偵コナン』シリーズ28作目、遂に始動…！！見えない左眼を押さえ …”, “thumbnails”: { “default”: { “url”: “https://i.ytimg.com/vi/p6h57WqRRl8/default.jpg”, “width”: 120, “height”: 90 }, “medium”: { “url”: “https://i.ytimg.com/vi/p6h57WqRRl8/mqdefault.jpg”, “width”: 320, “height”: 180 }, “high”: { “url”: “https://i.ytimg.com/vi/p6h57WqRRl8/hqdefault.jpg”, “width”: 480, “height”: 360 } }, “channelTitle”: “東宝MOVIEチャンネル”, “liveBroadcastContent”: “none”, “publishTime”: “2024-12-04T15:00:58Z” }	検索結果の基本情報。以下のプロパティを含むオブジェクト。・publishedAt ・channelId ・title ・description ・thumbnails ・channelTitle ・liveBroadcastContent ・publishTime
snippet.publishedAt	RFC 3339形式の日時（datetime）例：2024-12-31T15:00:00Z （日本時間の2025-01-01 00:00:00）	公開日時。
snippet.channelId	文字列（string）例：”UCTDMT3aL30noTVFgNPA9XtQ”	チャンネルID。
snippet.title	文字列（string）例：”劇場版『名探偵コナン隻眼の残像(せきがんのフラッシュバック)』特報【2025年4月18日(金)公開】”	タイトル。
snippet.description	文字列（string）例：”ついてくるな、遊びじゃねえんだー。劇場版『名探偵コナン』シリーズ28作目、遂に始動…！！見えない左眼を押さえ …”	説明。
snippet.thumbnails	オブジェクト（object）例： { “default”: { “url”: “https://i.ytimg.com/vi/p6h57WqRRl8/default.jpg”, “width”: 120, “height”: 90 }, “medium”: { “url”: “https://i.ytimg.com/vi/p6h57WqRRl8/mqdefault.jpg”, “width”: 320, “height”: 180 }, “high”: { “url”: “https://i.ytimg.com/vi/p6h57WqRRl8/hqdefault.jpg”, “width”: 480, “height”: 360 } }	サムネイル情報。以下のプロパティを含むオブジェクト。・default ・medium ・high ・standard ・maxres ※default・medium・highは必ず含まれるが、standard・maxresは高解像度サムネイルがアップロードされている場合のみ含まれる。
snippet.thumbnails.default	オブジェクト（object）例： { “url”: “https://i.ytimg.com/vi/p6h57WqRRl8/default.jpg”, “width”: 120, “height”: 90 }	既定のサムネイル情報。
snippet.thumbnails.default.url	文字列（string）例：”https://i.ytimg.com/vi/p6h57WqRRl8/default.jpg”	既定のサムネイルのURL。
snippet.thumbnails.default.width	符号なし整数値（unsigned integer）例：120 例：88	既定のサムネイルの横幅。 ※動画とチャンネルでサイズが異なる。動画は120px、チャンネルは88px。
snippet.thumbnails.default.height	符号なし整数値（unsigned integer）例：90 例：88	既定のサムネイルの高さ。 ※動画とチャンネルでサイズが異なる。動画は90px、チャンネルは88px。
snippet.thumbnails.medium.url	文字列（string）例：”https://i.ytimg.com/vi/4Uh02uy3Tlk/mqdefault.jpg”	中画質のサムネイルのURL。
snippet.thumbnails.medium.width	符号なし整数値（unsigned integer）例：320 例：240	中画質のサムネイルの横幅。 ※動画とチャンネルでサイズが異なる。動画は320px、チャンネルは240px。
snippet.thumbnails.medium.height	符号なし整数値（unsigned integer）例：180 例：240	中画質のサムネイルの高さ。 ※動画とチャンネルでサイズが異なる。動画は90px、チャンネルは88px。
snippet.thumbnails.high.url	文字列（string）例：”https://i.ytimg.com/vi/4Uh02uy3Tlk/hqdefault.jpg”	高画質のサムネイルのURL。
snippet.thumbnails.high.width	符号なし整数値（unsigned integer）例：480 例：800	高画質のサムネイルの横幅。 ※動画とチャンネルでサイズが異なる。動画は480px、チャンネルは800px。
snippet.thumbnails.high.height	符号なし整数値（unsigned integer）例：360 例：800	高画質のサムネイルの横幅。 ※動画とチャンネルでサイズが異なる。動画は360px、チャンネルは800px。
snippet.thumbnails.standard.url	文字列（string）例：”https://i.ytimg.com/vi/Ks-_Mh1QhMc/sddefault.jpg”	標準画質のサムネイルのURL。 ※高解像度サムネイルがアップロードされている場合のみ含まれる。 ※動画のみ。
snippet.thumbnails.standard.width	符号なし整数値（unsigned integer）例：640	標準画質のサムネイルの横幅。 ※高解像度サムネイルがアップロードされている場合のみ含まれる。 ※動画のみ。640px。
snippet.thumbnails.standard.height	符号なし整数値（unsigned integer）例：480	標準画質のサムネイルの横幅。 ※高解像度サムネイルがアップロードされている場合のみ含まれる。 ※動画のみ。480px。
snippet.thumbnails.maxres.url	文字列（string）例：”https://i.ytimg.com/vi/Ks-_Mh1QhMc/maxresdefault.jpg”	最高画質のサムネイルのURL。 ※高解像度サムネイルがアップロードされている場合のみ含まれる。 ※動画のみ。
snippet.thumbnails.maxres.width	符号なし整数値（unsigned integer）例：1280	最高画質のサムネイルの横幅。 ※高解像度サムネイルがアップロードされている場合のみ含まれる。 ※動画のみ。1,280px。
snippet.thumbnails.maxres.height	符号なし整数値（unsigned integer）例：720	最高画質のサムネイルの横幅。 ※高解像度サムネイルがアップロードされている場合のみ含まれる。 ※動画のみ。720px。
snippet.channelTitle	文字列（string）例：”東宝MOVIEチャンネル”	チャンネルのタイトル。
snippet.liveBroadcastContent	文字列（string）以下のいずれかの値が含まれる。・upcoming （動画の場合はライブ配信予定の動画、チャンネルの場合はライブ配信予定の動画があること）・live （動画の場合はライブ配信中の動画、チャンネルの場合はライブ配信中の動画があること）・none （ライブ配信との関連性なし）	ライブ配信コンテンツとの関連性を示す。
publishTime	RFC 3339形式の日時（datetime）例：2024-12-31T15:00:00Z （日本時間の2025-01-01 00:00:00）	公開時間（？）。 publishedAtプロパティと同値（？）。 ※APIを実行すると含まれていることが確認できるが、公式リファレンスに明記なし。 ※将来的にどうなるか不明なため、使わない方が良いと思います。

無料かつコードなしでAPIを試す

Googleは、APIを無料かつコードなしで試せるように公式ツールを用意してくれています。

その名も「API Explorer」。

YouTube Data APIに限らず、Googleが提供している各種APIを無料かつコードなしで試すことができます。

無制限にAPIを実行できるわけではないですが、お試しやテストに最適のツールなので、ぜひ利用していきましょう。

このブログでも使い方の記事を書いているので、見て試してみてください。

YouTube Data APIを無料かつコードなしで試す方法｜API Explorerの使い方

この記事で扱う内容この記事では、YouTube Data APIにおけるAPI Explorerの使い方をご紹介します。前提と基本用語必要な知識・スキルブラウザの基本操作ができる人必要な環境PCGoogleアカウントが作成済みであることGo...

参考

Google for Developers公式サイト（ホーム > プロダクト > YouTube > Data API > ガイド）
Google for Developers公式サイト（ホーム > プロダクト > YouTube > Data API > リファレンス > Search）
Google for Developers公式サイト（ホーム >プロダクト > Google APIs Explorer）
IETF Datatracker（RFC 3339）
Wikipedia（ISO 8601）
ISO公式サイト（ISO 3166 Country Codes）
ISO公式サイト（Online Browsing Platform (OBP)）
※Country codesラジオボタンを選択後、検索テキストボックスに右側の言語プルダウンに合う言語を入力し、SEARCHボタンを押して検索する。
Wikipedia（ISO 3166-1）
ISO公式サイト（ISO 639 Language code）
アメリカ合衆国議会図書館公式サイト（ISO 639-2 Codes for the Representation of Names of Languages）
Wikipedia（ISO 639-1コード一覧）