テンプレート:YouTube/docのソースを表示

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
{{For|YouTube関連のナビゲーションテンプレート|Template:YouTube navbox}}
{{Template shortcut|ytl}}
{{Lua|モジュール:Check for unknown parameters}}
{{Notice|'''[[著作権法]]に違反するコンテンツへリンクしないでください。'''<br />そのようなリンクを見つけた場合、速やかに除去するか、法的に問題のないコンテンツへのリンクに置き換えてください。||stop}}
{{COinS safe|n}}
<includeonly>{{使用箇所の多いテンプレート|39,000以上}}</includeonly>
[[YouTube]]にある動画、チャンネル、YouTube show（公式配信の映画やテレビ番組）、プレイリストにリンクするテンプレートです。基本的に外部リンク節で使用します。{{tl|External media}}の内部で使うこともできます。

このテンプレートは'''[[Wikipedia:出典テンプレート|出典テンプレート]]ではありません'''。動画を出典とする場合は{{tl|cite video}}・{{tl|cite AV media}}・{{tl|cite AV media ja}}が使用可能です。動画がニュース番組である場合は{{tl|cite news}}を、エピソード形式である場合は{{tl|cite episode}}を使用することもできます。

== 使用方法 ==
=== 動画へのリンク ===
{{Wikidata property|P1651|YouTube動画識別子}}
'''書式'''（引数1個）：
*{{tlc|YouTube|''VIDEOID''}}
*{{tlc|YouTube|id{{=}}''VIDEOID''}}

'''書式'''（引数2個）：
*{{tlc|YouTube|''VIDEOID''|タイトル}}
*{{tlc|YouTube|id{{=}}''VIDEOID''|title{{=}}タイトル}}

'''解説''':
* YouTube上の動画にリンクするには、動画識別子を{{para|1}}もしくは{{para|id}}に指定します。動画識別子は<kbd><nowiki>https://www.youtube.com/watch?v=</nowiki>{{hilite|''VIDEOID''}}</kbd> のVIDEOIDにあたる部分です。
* 動画のタイトルは{{para|2}}もしくは{{para|title}}に指定します。ここで指定された文字列がリンクテキストとして表示されます。指定しなかった場合は「映像」と表示します。

'''使用例'''( <kbd><nowiki>https://www.youtube.com/watch?v=j9-CovbP-7U</nowiki></kbd> ):
{{demo|<nowiki>
* {{YouTube|j9-CovbP-7U}}</nowiki>}}
{{demo|<nowiki>
* {{YouTube|j9-CovbP-7U|Inside Wikimedia}}</nowiki>}}

==== タイムスタンプの指定 ====
動画の冒頭ではなく途中にリンクするには、タイムスタンプを{{para|time}}・{{para|t}}・{{para|3}}のいずれかに指定します。

'''使用例''':
{{demo|<nowiki>
* {{YouTube|id=j9-CovbP-7U|title=Inside Wikimedia|time=1m23s}}</nowiki>}}

=== チャンネルへのリンク ===
==== チャンネル識別子でリンクする ====
{{Wikidata property|P2397|YouTubeチャンネル識別子}}
'''書式'''（引数1個）：
*{{tlc|YouTube|c{{=}}''CHANNELID''}}
*{{tlc|YouTube|channel{{=}}''CHANNELID''}}

'''書式'''（引数2個）：
*{{tlc|YouTube|c{{=}}''CHANNELID''|タイトル}}
*{{tlc|YouTube|c{{=}}''CHANNELID''|title=タイトル}}
*{{tlc|YouTube|channel{{=}}''CHANNELID''|タイトル}}
*{{tlc|YouTube|channel{{=}}''CHANNELID''|title=タイトル}}

'''解説'''：
* {{para|c}}もしくは{{para|channel}}にチャンネル識別子を指定します。チャンネル識別子は<kbd><nowiki>https://www.youtube.com/channel/</nowiki>{{hilite|''CHANNELID''}}</kbd> のCHANNELIDにあたる部分です。
* リンクテキストとして表示する文字列は{{para|1}}もしくは{{para|title}}に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。

'''使用例'''( <kbd><nowiki>https://www.youtube.com/channel/UCK_cUZLMpibyRiIdp0uF-lQ</nowiki></kbd> ):
{{demo|<nowiki>
* {{YouTube|channel=UCK_cUZLMpibyRiIdp0uF-lQ|Wikimedia Foundation}}</nowiki>}}

==== YouTubeハンドルでリンクする ====
{{Wikidata property|P11245|YouTubeハンドル}}
'''書式'''（引数1個）：
*{{tlc|YouTube|h{{=}}''HANDLEID''}}
*{{tlc|YouTube|handle{{=}}''HANDLEID''}}

'''書式'''（引数2個）：
*{{tlc|YouTube|h{{=}}''HANDLEID''|タイトル}}
*{{tlc|YouTube|h{{=}}''HANDLEID''|title=タイトル}}
*{{tlc|YouTube|handle{{=}}''HANDLEID''|タイトル}}
*{{tlc|YouTube|handle{{=}}''HANDLEID''|title=タイトル}}

'''解説'''：
* {{para|h}}もしくは{{para|handle}}にYouTubeハンドルを指定します。YouTubeハンドルは<kbd><nowiki>https://www.youtube.com/@</nowiki>{{hilite|''HANDLEID''}}</kbd> のHANDLEIDにあたる部分です。
* リンクテキストとして表示する文字列は{{para|1}}もしくは{{para|title}}に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
* handleは「@」付きでも良い。

'''使用例'''( <kbd><nowiki>https://www.youtube.com/@wikipedia</nowiki></kbd> ):
{{demo|<nowiki>
* {{YouTube|handle=wikipedia|Wikimedia Foundation}}</nowiki>}}

==== ユーザー名でリンクする ====
{{※}} ユーザー名はYouTubeの古い機能であるため、チャンネル名やYouTubeハンドルによるURLでリンクすることを推奨します。

'''書式'''（引数1個）：
*{{tlc|YouTube|u{{=}}''USERNAME''}}
*{{tlc|YouTube|user{{=}}''USERNAME''}}

'''書式'''（引数2個）：
*{{tlc|YouTube|u{{=}}''USERNAME''|タイトル}}
*{{tlc|YouTube|u{{=}}''USERNAME''|title=タイトル}}
*{{tlc|YouTube|user{{=}}''USERNAME''|タイトル}}
*{{tlc|YouTube|user{{=}}''USERNAME''|title=タイトル}}

'''解説'''：
* {{para|u}}もしくは{{para|user}}にユーザー名を指定します。ユーザー名は<kbd><nowiki>https://www.youtube.com/user/</nowiki>{{hilite|''USERNAME''}}</kbd> のUSERNAMEにあたる部分です。
* リンクテキストとして表示する文字列は{{para|1}}もしくは{{para|title}}に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。

'''使用例'''( <kbd><nowiki>https://www.youtube.com/user/WikimediaFoundation</nowiki></kbd> ):
{{demo|<nowiki>
* {{YouTube|user=WikimediaFoundation|Wikimedia Foundation}}</nowiki>}}

==== カスタムURLでリンクする ====
{{※}} カスタムURLはYouTubeの古い機能であるため、チャンネル名やYouTubeハンドルによるURLでリンクすることを推奨します。

'''書式'''（引数1個）：
*{{tlc|YouTube|custom{{=}}''CUSTOMURL''}}

'''書式'''（引数2個）：
*{{tlc|YouTube|custom{{=}}''CUSTOMURL''|タイトル}}
*{{tlc|YouTube|custom{{=}}''CUSTOMURL''|title=タイトル}}

'''解説'''：
* {{para|custom}}にカスタムURL中の識別子を指定します。識別子は<kbd><nowiki>https://www.youtube.com/c/</nowiki>>{{hilite|''CUSTOMURL''}}</kbd> のCUSTOMURLにあたる部分です。
* リンクテキストとして表示する文字列は{{para|1}}もしくは{{para|title}}に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。

'''使用例'''( <kbd><nowiki>https://www.youtube.com/c/officialBEG</nowiki></kbd> ):
{{demo|<nowiki>
* {{YouTube|custom=officialBEG|Brown Eyed Girls}}</nowiki>}}

=== YouTube showへのリンク ===
{{※}} 著作権の制約により現時点で居住している国によって紹介ページにある動画の再生が不可能の場合があります。例としてアメリカ合衆国からのアクセスで再生可能な場合でも、日本からのアクセスでは再生できない場合があります。

'''書式'''（引数1個）：
*{{tlc|YouTube|s{{=}}''SHOWID''}}
*{{tlc|YouTube|show{{=}}''SHOWID''}}

'''書式'''（引数2個）：
*{{tlc|YouTube|s{{=}}''SHOWID''|タイトル}}
*{{tlc|YouTube|s{{=}}''SHOWID''|title=タイトル}}
*{{tlc|YouTube|show{{=}}''SHOWID''|タイトル}}
*{{tlc|YouTube|show{{=}}''SHOWID''|title=タイトル}}

'''解説'''：
* {{para|s}}もしくは{{para|show}}にshowの識別子を指定します。識別子は<kbd><nowiki>https://www.youtube.com/show/</nowiki>{{hilite|''SHOWID''}}</kbd> のSHOWIDにあたる部分です。
* リンクテキストとして表示する文字列は{{para|1}}もしくは{{para|title}}に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。

'''使用例'''( <kbd><nowiki>https://www.youtube.com/show/SCWdVLvom3QaFGxEKNASntaA</nowiki></kbd> ):
{{demo|<nowiki>
* {{YouTube|show=SCWdVLvom3QaFGxEKNASntaA|Star Trek}}</nowiki>}}

=== プレイリストへのリンク ===
'''書式'''（引数1個）：
*{{tlc|YouTube|p{{=}}''PLAYLISTID''}}
*{{tlc|YouTube|playlist{{=}}''PLAYLISTID''}}

'''書式'''（引数2個）：
*{{tlc|YouTube|p{{=}}''PLAYLISTID''|タイトル}}
*{{tlc|YouTube|p{{=}}''PLAYLISTID''|title=タイトル}}
*{{tlc|YouTube|playlist{{=}}''PLAYLISTID''|タイトル}}
*{{tlc|YouTube|playlist{{=}}''PLAYLISTID''|title=タイトル}}

'''解説'''：
* {{para|p}}もしくは{{para|playlist}}にshowの識別子を指定します。識別子は<kbd><nowiki>https://www.youtube.com/playlist?list=</nowiki>{{hilite|''PLAYLISTID''}}</kbd> のPLAYLISTIDにあたる部分です。
* リンクテキストとして表示する文字列は{{para|1}}もしくは{{para|title}}に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。

'''使用例'''( <kbd><nowiki>https://www.youtube.com/playlist?list=PLhV3K_DS5YfKOB0fRh1XXCEBuczGa33iA</nowiki></kbd> ):
{{demo|<nowiki>
* {{YouTube|playlist=PLhV3K_DS5YfKOB0fRh1XXCEBuczGa33iA|Wikimedia monthly activities meetings}}</nowiki>}}

=== 内部リンクの無効化 ===
{{Para|link|no}}と指定することで、出力における"[[YouTube]]"の部分に内部リンクが生成されなくなります。

'''例'''：
{{demo|<nowiki>{{YouTube|j9-CovbP-7U|Inside Wikimedia|link=no}}</nowiki>}}

== エラーチェック ==
識別子などを一切指定しないでテンプレートを呼び出した場合はエラーメッセージを表示します。

{{demo|<nowiki>{{YouTube}}</nowiki>}}

引数名が間違っている場合もエラーメッセージが表示されることがあります。

{{demo|<nowiki>{{YouTube|ID=test}}</nowiki>}}

== 追跡カテゴリ ==
* {{clc|テンプレート呼び出しエラーのあるページ/Template:YouTube}} – 標準名前空間を含む一部の名前空間において、識別子などを一切指定していないか、複数指定してテンプレートを呼び出した場合に付与されるカテゴリ
* {{clc|不明な引数を指定しているページ/Template:YouTube}} – テンプレート側で認識できない引数を使用している標準名前空間のページに付与されるカテゴリ

== 関連項目 ==
* [[Template:cite video]]、[[Template:cite AV media]]、[[Template:cite AV media ja]] - 動画を出典として明記するためのテンプレート。
* [[Template:External music video]] - {{tl|Infobox}}内にミュージックビデオをリンクするためのテンプレート。
* [[Template:YouTube channel]] - YouTubeのユーザーチャンネルにリンクするためのテンプレート。当テンプレートとは使い方が少し異なります。
* [[Template:Nicovideo]] - [[ニコニコ動画]]の映像にリンクするためのテンプレート。
* [[Template:YouTube Music]] - [[YouTube Music]]の曲ページ、チャンネル(アーティスト)ページ、プレイリスト(アルバム/シングル)ページにリンクするためのテンプレート。
* <span class="plainlinks">[https://ja.wikipedia.org/w/index.php?title=Special:LinkSearch&target=http%3A%2F%2F*.youtube.com&limit=500&offset=0 http://*.youtube.com]および[https://ja.wikipedia.org/w/index.php?title=Special%3ALinkSearch&target=https%3A%2F%2F*.youtube.com https://*.youtube.com]</span>へリンクしているページの一覧
* <span class="plainlinks">[https://ja.wikipedia.org/w/index.php?search=insource%3A%2F%3E%5C%7B%5C%7BYouTube%2Fi このテンプレートを脚注内で使用している記事を検索]</span>

== テンプレートデータ ==
{{TemplateData header}}
<templatedata>
{
	"description": "YouTubeにある動画やチャンネルなどのコンテンツにリンクするための外部リンク用テンプレート。出典テンプレートとしては使わない。",
	"params": {
		"id": {
			"label": "動画識別子",
			"description": "動画のURLにおいて https://www.youtube.com/watch?v= に続く識別子",
			"aliases": [
				"1"
			],
			"example": "9bZkp7q19f0",
			"type": "string",
			"suggested": true
		},
		"channel": {
			"label": "チャンネル識別子",
			"description": "チャンネルのURLにおいて after https://www.youtube.com/channel/ に続く識別子",
			"aliases": [
				"c"
			],
			"example": "UC-9-kyTW8ZkZNDHQJ6FgpwQ",
			"type": "string",
			"suggested": true
		},
		"handle": {
			"label": "YouTubeハンドル",
			"description": "チャンネルのURLにおいて after https://www.youtube.com/@ に続く識別子",
			"aliases": [
				"h"
			],
			"example": "PewDiePie",
			"type": "string"
		},
		"user": {
			"label": "ユーザー名",
			"description": "チャンネルのURLにおいて https://www.youtube.com/user/ に続く識別子",
			"aliases": [
				"u"
			],
			"example": "pewdiepie",
			"type": "string"
		},
		"custom": {
			"label": "カスタムURL中の識別子",
			"description": "チャンネルのURLにおいて https://www.youtube.com/c/ に続く識別子",
			"example": "youtube",
			"type": "string"
		},
		"show": {
			"label": "YouTube showの識別子",
			"description": "showのURLにおいて https://www.youtube.com/show/ に続く識別子",
			"aliases": [
				"s"
			],
			"example": "SCWdVLvom3QaFGxEKNASntaA",
			"type": "string",
			"suggested": true
		},
		"playlist": {
			"label": "プレイリストの識別子",
			"description": "プレイリストのURLにおいて https://www.youtube.com/playlist?list= に続く識別子",
			"aliases": [
				"p"
			],
			"example": "PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE",
			"type": "string",
			"suggested": true
		},
		"title": {
			"label": "タイトル",
			"description": "リンクテキストとして表示する文字列",
			"suggested": true,
			"aliases": [
				"2"
			],
			"example": "Gangnam Style",
			"default": "動画へのリンクする場合のデフォルト値は「映像」。それ以外の場合は呼び出し元の記事名",
			"type": "string"
		},
		"link": {
			"label": "内部リンクの有無",
			"description": "noを指定すると、出力における'YouTube'の部分に内部リンクが生成されなくなる",
			"type": "string",
			"suggestedvalues": [
				"no"
			]
		},
		"time": {
			"aliases": [
				"t",
				"3"
			],
			"label": "タイムスタンプ",
			"description": "動画の途中にリンクする場合は、この引数にタイムスタンプを指定する",
			"example": "3m2s",
			"type": "string"
		}
	},
	"paramOrder": [
		"id",
		"time",
		"channel",
		"handle",
		"user",
		"custom",
		"show",
		"playlist",
		"title",
		"link"
	],
	"format": "inline"
}</templatedata>

<includeonly>{{sandbox other||
{{デフォルトソート:{{TEMPLATENAME}}}}
<!-- カテゴリは以下に追加してください -->
[[Category:テレビの外部リンク用テンプレート]]
[[Category:Google関連の外部リンク用テンプレート]]
[[Category:ソーシャル・ネットワーキング・サービステンプレート]]
[[Category:追跡カテゴリを追加するテンプレート]]
}}</includeonly>