Developer API を使用すると、Google Fonts で提供されるすべてのファミリーのメタデータにアクセスできます。これにより、アプリは利用可能なフォント ファミリーについて Google Fonts をクエリできます。REST API は、各ファミリーのスタイルとスクリプト(Google Fonts ではサブセットと呼ばれます)を含む JSON 形式のデータを提供します。この API では、ファミリーのリストをアルファベット、追加日、スタイル数、トレンド、人気度で並べ替えることができます。
対象読者
このドキュメントは、ウェブ デベロッパーとアプリケーション デベロッパーを対象としています。Developer API を使用するには、JavaScript の知識が必要です。
簡単な例
Google Fonts サービスが提供するフォントの動的リストを取得するには、次のリクエストを送信します。
https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY
結果のサンプルは次のようになります。
{ "kind": "webfonts#webfontList", "items": [ [...] { "family": "Anonymous Pro", "variants": [ "regular", "italic", "700", "700italic" ], "subsets": [ "cyrillic", "greek", "latin", "latin-ext" ], "version": "v21", "lastModified": "2022-09-22", "files": { "regular": "http://fonts.gstatic.com/s/anonymouspro/v21/rP2Bp2a15UIB7Un-bOeISG3pLlw89CH98Ko.ttf", "italic": "http://fonts.gstatic.com/s/anonymouspro/v21/rP2fp2a15UIB7Un-bOeISG3pHl428AP44Kqr2Q.ttf", "700": "http://fonts.gstatic.com/s/anonymouspro/v21/rP2cp2a15UIB7Un-bOeISG3pFuAT0CnW7KOywKo.ttf", "700italic": "http://fonts.gstatic.com/s/anonymouspro/v21/rP2ap2a15UIB7Un-bOeISG3pHl4OTCzc6IG30KqB9Q.ttf" }, "category": "monospace", "kind": "webfonts#webfont", "menu": "http://fonts.gstatic.com/s/anonymouspro/v21/rP2Bp2a15UIB7Un-bOeISG3pHl028A.ttf" }, { "family": "Antic", "variants": [ "regular" ], "subsets": [ "latin" ], "version": "v19", "lastModified": "2022-09-22", "files": { "regular": "http://fonts.gstatic.com/s/antic/v19/TuGfUVB8XY5DRaZLodgzydtk.ttf" }, "category": "sans-serif", "kind": "webfonts#webfont", "menu": "http://fonts.gstatic.com/s/antic/v19/TuGfUVB8XY5DRZZKq9w.ttf" }, [...] ] }
Google がアプリケーションを特定する
アプリケーションは、Google Fonts Developer API にリクエストを送信するたびに、リクエストに API キーを含めることによって、自身を識別する必要があります。
API キーの取得と使用
キーの取得または、認証情報ページでキーを作成することもできます。
API キーを作成したら、アプリケーションですべてのリクエスト URL の末尾にクエリ パラメータ key=yourAPIKey
を追加できます。
API キーは URL に埋め込んでも安全です。エンコーディングの必要はありません。
詳細
JSON レスポンス(上記のサンプルを参照)は、「items」という名前の配列で構成されています。この配列には、各フォント ファミリーに関する情報を含むオブジェクトが含まれています。
ファミリー オブジェクトは以下のフィールドで構成されます。
- kind: オブジェクトの種類。ウェブフォント オブジェクト
- family: ファミリーの名前
- サブセット:ファミリーがサポートしているスクリプトのリスト
- メニュー: ファミリーの名前のみを含むファミリー サブセットの URL。
- バリエーション: ファミリーで使用可能なさまざまなスタイル。
- version: フォント ファミリーのバージョン。
- 軸: 軸の範囲。可変フォントの場合は、リクエストに応じてのみ表示されます(下記参照)。
- lastModified: フォント ファミリーが最後に変更された日付(形式「yyyy-MM-dd」)。
- ファイル: 使用可能な各バリアントのフォント ファミリー ファイル(サポートされているすべてのスクリプトを含む)。
各ファミリーの情報を組み合わせることで、Fonts API リクエストを簡単に作成できます。たとえば、Anonymous Pro のファミリー オブジェクトへの参照があるとします。
[...] var apiUrl = []; apiUrl.push('https://fonts.googleapis.com/css?family='); apiUrl.push(anonymousPro.family.replace(/ /g, '+')); if (contains('italic', anonymousPro.variants)) { apiUrl.push(':'); apiUrl.push('italic'); } if (contains('greek', anonymousPro.subsets)) { apiUrl.push('&subset='); apiUrl.push('greek'); } // url: 'https://fonts.googleapis.com/css?family=Anonymous+Pro:italic&subset=greek' var url = apiUrl.join(''); [...]
並べ替え
デフォルトでは、ファミリーのリストは順不同で返されます。ただし、sort パラメータを使用してリストを並べ替えることはできます。
https://www.googleapis.com/webfonts/v1/webfonts?sort=popularity
可能な並べ替え値は次のとおりです。
- alpha: リストをアルファベット順に並べ替える
- 日付: 追加日でリストを並べ替えます(最新のフォントが追加または更新された順)。
- 人気度: リストを人気順で並べ替えます(人気のある家族から順)。
- style: 利用可能なスタイル数でリストを並べ替えます(スタイル数が多いファミリーを最初に表示します)。
- 急上昇: 使用量が増えているファミリーでリストを並べ替え(最も使用量が増えているファミリーを最初に表示)
フィルタリング
特定のファミリーをクエリする
https://www.googleapis.com/webfonts/v1/webfonts?family=family_name
ギリシャ語のサブセットをサポートするすべてのファミリー
https://www.googleapis.com/webfonts/v1/webfonts?subset=subset_name
最適化
woff2 形式で圧縮されたフォント ファイルを取得します。
https://www.googleapis.com/webfonts/v1/webfonts?capability=WOFF2
可変フォント
可変フォントでは、スタイルの範囲が連続しています。デフォルトでは、標準の位置でインスタンス化された可変フォントに対して、静的フォント ファイルの組み合わせが返されます。capability=VF
が設定されている場合、静的なフォント ファイルではなく、使用可能な軸範囲のメタデータとともに、可変フォント ファイルが返されます。例:
https://www.googleapis.com/webfonts/v1/webfonts?capability=VF
レスポンスの例:
{ "kind": "webfonts#webfontList", "items": [ [...] { "family": "Noto Sans Display", "variants": [ "regular", "italic" ], "subsets": [ "cyrillic", "cyrillic-ext", "greek", "greek-ext", "latin", "latin-ext", "vietnamese" ], "version": "v20", "lastModified": "2022-09-22", "files": { "regular": "http://fonts.gstatic.com/s/notosansdisplay/v20/RLplK4fy6r6tOBEJg0IAKzqdFZVZxokvfn_BDLxR.ttf", "italic": "http://fonts.gstatic.com/s/notosansdisplay/v20/RLpjK4fy6r6tOBEJg0IAKzqdFZVZxrktdHvjCaxRgew.ttf" }, "category": "sans-serif", "kind": "webfonts#webfont", "menu": "http://fonts.gstatic.com/s/notosansdisplay/v20/RLpbK4fy6r6tOBEJg0IAKzqdFZVZxpMkXJMhnB9XjO1o90LuV-PT4Doq_AKp_3cKZTCa3g.ttf", "axes": [ { "tag": "wdth", "start": 62.5, "end": 100 }, { "tag": "wght", "start": 100, "end": 900 } ] }, [...] ] }
API の URL 仕様
webfonts?key=<your_key>[&family=<family>][&subset=<subset>][&capability=<capability>...][&sort=<sort>]
your_key
: デベロッパー API キー。
family
: フォント ファミリーの名前。
subset
: フォント サブセットの名前。
capability
: VF
| WOFF2
。
sort
: alpha
| date
| popularity
| style
| trending