このページは Cloud Translation API によって翻訳されました。

Developer API

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