Esta página foi traduzida pela API Cloud Translation.

API do desenvolvedor

A API Developer dá acesso aos metadados de todas as famílias veiculadas pelo Google Fonts. Ele permite que os apps consultem as fontes disponíveis no Google Fonts. A API REST fornece dados no formato JSON que inclui os estilos e scripts (chamados de subconjuntos no Google Fonts) em cada família. A API pode classificar a lista de famílias em ordem alfabética, por data de adição, por número de estilos, por tendência ou por popularidade.

Público-alvo

Este documento é destinado a desenvolvedores da web e de aplicativos. O uso da API para desenvolvedores exige conhecimento de JavaScript.

Um exemplo rápido

Para recuperar a lista dinâmica de fontes oferecidas pelo serviço Google Fonts, envie a seguinte solicitação:

https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY

Veja um exemplo do resultado:

{
 "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"
  },
  [...]
 ]
}

Como identificar seu aplicativo para o Google

Seu aplicativo precisa se identificar toda vez que enviar uma solicitação à API Google Fonts Developer, incluindo uma chave de API em cada solicitação.

Como receber e usar uma chave de API

Ou crie uma na página Credenciais.

Depois que você tiver uma chave de API, seu aplicativo poderá anexar o parâmetro de consulta key=yourAPIKey a todos os URLs de solicitação.

A chave de API é segura para ser incorporada a URLs sem precisar de codificação.

Detalhes

A resposta JSON (veja o exemplo acima) é composta por uma matriz chamada "items", que contém objetos com informações sobre cada família de fontes.

Um objeto de família é composto pelos seguintes campos:

kind: o tipo de objeto, um objeto webfont
família: o nome da família
subconjuntos: uma lista de scripts compatíveis com a família
menu: um URL para o subconjunto familiar que abrange apenas o nome da família.
variantes: os diferentes estilos disponíveis para a família
version: a versão da família de fontes.
eixos: intervalo dos eixos, Presente somente mediante solicitação(veja abaixo) para fontes variáveis.
lastModified: é a data (formato "aaaa-MM-dd") em que a família de fontes foi modificada pela última vez.
files: os arquivos de família de fontes (com todos os scripts compatíveis) para cada uma das variantes disponíveis.

Combinando as informações de cada família, é fácil criar uma solicitação da API Fonts. Por exemplo, supondo que tenhamos uma referência ao objeto de família do Anônimo:

[...]

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('');

[...]

Classificação

A lista de famílias é retornada em nenhuma ordem específica por padrão. No entanto, é possível classificar a lista usando o parâmetro "sort":

https://www.googleapis.com/webfonts/v1/webfonts?sort=popularity

Os valores de classificação possíveis são:

alpha: Classificar a lista em ordem alfabética
date: Classificar a lista por data de adição (a fonte mais recente foi adicionada ou atualizada primeiro)
popularidade: classificar a lista por popularidade (família mais popular primeiro)
style: classificar a lista por número de estilos disponíveis (família com mais estilos primeiro)
em alta: classifique a lista por famílias que notam crescimento de uso (família com maior crescimento primeiro)

Filtragem

Consultar uma família específica

https://www.googleapis.com/webfonts/v1/webfonts?family=family_name

Todas as famílias com suporte ao subconjunto grego

https://www.googleapis.com/webfonts/v1/webfonts?subset=subset_name

Otimização

Para recuperar arquivos de fonte compactados no formato woff2

https://www.googleapis.com/webfonts/v1/webfonts?capability=WOFF2

Fontes variáveis

As fontes variáveis oferecem intervalos contínuos de estilos. Por padrão, uma combinação de arquivos de fontes estáticas é retornada para fontes variáveis instanciadas em posições padrão. Se capaibility=VF for definido, o arquivo de fonte variável será retornado em vez dos estáticos junto com os metadados do intervalo de eixos disponíveis. Exemplo de exemplo:

https://www.googleapis.com/webfonts/v1/webfonts?capaibility=VF

Exemplo de resposta:

{
 "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
      }
    ]
  },
  [...]
 ]
}

Especificação do URL da API

webfonts?key=<your_key>[&family=<family>][&subset=<subset>][&capability=<capability>...][&sort=<sort>]

your_key: a chave de API do desenvolvedor.

family: nome de uma família de fontes.

subset: nome de um subconjunto de fontes.

capability: VF | WOFF2.

sort: alpha | date | popularity | style | trending.