使い方
- 言語版に、版ごとに1行ずつ、コード、縦線、完全なアドレスを入力します。
- 言語の選択ページや既定のページがあれば、そのアドレスをフォールバックのアドレス(x-default)に入力します。
- 行の確認を読みます。すべての版が有効だと表示されたら、link要素、サイトマップ、またはヘッダーをコピーします。
- 同じセットを、すべてのページに入れ、各版がほかのすべての版へのリンクを持つことを確かめます。
コードの確かめ方
言語の部分は、ISO 639-1の2文字のコードでなければなりません。米国議会図書館の一覧には、そのコードが183あります。任意の地域は、GBやTWのように、正式に割り当てられたISO 3166-1のalpha-2コードでなければなりません。Googleのガイドによれば、対応する規格はこの2つだけで、言語が先に来なければなりません。そのため、GBのような地域だけのコードは受け付けられません。
HantやHansのような文字体系の部分は、4文字でなければなりません。Googleのガイドでは、文字体系はISO 15924で書くとされていますが、このツールは文字体系の形だけを確かめ、規格の全リストとは照合しません。コードは大文字と小文字を区別しないため、このツールは言語を小文字、地域を大文字、文字体系を先頭だけ大文字で書きます。
- en-ukは、UKが予約されたコードなので受け付けられません。英国はGBなので、ツールはen-GBを提案します。
- iw、in、jiは1989年にhe、id、yiへ変わったため、ツールはそれらのコードを提案します。
- xx、eng、en_USのような、どれにも一致しないコードは、行番号とともに受け付けられません。
同じセットを送る3つの方法
Googleは3つの方法を挙げています。HTMLのheadのlink要素、HTTPヘッダー、XMLサイトマップです。Googleは3つを同等とみなすため、保守しやすいものを選んでください。サイトマップの形式にはxhtmlの名前空間が必要で、各urlの項目は、自分を含むすべての代替版を並べます。
HTTPヘッダーの方法は、どのページのGET応答にも説明されています。Googleは、PDFなどHTML以外のファイルに役立つとしており、その例はPDFです。Webページには、通常はlink要素かサイトマップが使われます。Googleは、ページのどの版に返されるLinkヘッダーも同じだとしているため、このツールはセット全体に1つの値を書きます。
戻りのリンクとx-default
各版は、自分とほかのすべての版を並べなければならず、すべてのページは互いを指さなければなりません。Googleのガイドには、2つのページが互いを指していなければ、タグは無視される、とあります。セットを完全に保つのが難しい場合、Googleは一部のページで一部の言語を省いてもよいとしており、互いに指し合う組は処理されます。
x-defaultは、どの版の言語にも合わない場合のフォールバックのページを指します。Googleは言語の選択ページに推奨しており、言語コードを付けずに書きます。
例:3つの版とフォールバック
行 en | https://example.com/en/、en-GB | https://example.com/en-gb/、tr | https://example.com/tr/ に、フォールバックの https://example.com/ を加えると、代替版は4つになります。セットのすべてのページは同じ4つのlink要素を受け取り、サイトマップには3つのページごとにurlの項目が1つずつあります。
各urlの項目は、すべての4つの代替版を並べます。状態の行には「3件の言語版、すべて有効です。」と表示されます。フォールバックは言語版には数えられないためです。
| 出力 | 件数 | 詳細 |
|---|---|---|
| リンク要素 | 4 | hreflang="tr" href="https://example.com/tr/" |
| サイトマップのurlの項目 | 3 | それぞれが4件の代替版(x-defaultを含む)を並べる |
| Linkヘッダーの値 | 1 | すべてのページで同じ値、4件の代替版を含む |
| 言語版 | 3 | 状態:3件の言語版、すべて有効です。 |
よくある質問
どのコードが有効ですか?
ISO 639-1の言語コード(en、tr、zhなど)に、任意で、Hantのような4文字の文字体系と、GBやTWのようなISO 3166-1の地域を続けられます。コードは大文字と小文字を区別せず、ツールは標準の書き方で書きます。
en-ukがエラーと表示されるのは、なぜですか?
UKはISO 3166-1で予約されたコードで、Googleのガイドによれば、hreflangのUKには効果がありません。英国に割り当てられたコードはGBなので、正しいタグはen-GBです。
x-defaultの行は必要ですか?
任意です。Googleは、x-defaultをどの版の言語にも合わないときのフォールバックとし、言語の選択ページに推奨しています。ツールは、アドレスを入力したときだけ加えます。
すべてのページが、セット全体を並べる必要がありますか?
各版は、自分とほかのすべての版を並べなければなりません。2つのページが互いを指さないと、タグは無視されます。一方で、Googleは一部のページで言語を省いてもよく、互いにリンクする組は処理されるとしています。
なぜ、ツールはhttpsのアドレスだけを受け付けるのですか?
今では多くのサイトが使う、絶対httpsのアドレスを受け付けるためです。Googleは、転送の方法を含む完全なアドレスを求めています。まだhttpで動くサイトは、注釈を手で書く必要があります。
HTTPヘッダーの方法は、Webページを対象としていますか?
Googleは、どのページのGET応答にも使えると説明し、PDFなどHTML以外のファイルに役立つとしています。Webページには、通常はlink要素かサイトマップが使われます。
ツールは、アドレスをどこかに送りますか?
いいえ。結果は、入力された文字からお使いのブラウザの中で作られ、どのサーバーにも送られません。
出典
- Google Search Central(英語): 地域化されたページとhreflang
- 米国議会図書館(英語): ISO 639-2のコード一覧(ISO 639-1のコードを含む)
- Wikipedia(英語): ISO 639-1(登録された183のコード)
- Wikipedia(英語): List of ISO 639 language codes(1989年に変更されたコード)
- Wikipedia(英語): ISO 3166-1 alpha-2(正式に割り当てられたコード、UKは予約)
- Sitemaps.org(英語): プロトコル(エンティティのエスケープ)
数値と文章の最終確認日:2026年11月10日火曜日。