API para desarrolladores

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

La API de Developer otorga acceso a los metadatos de todas las familias que entrega Google Fonts. Permite que las apps consulten a las fuentes de Google para las familias de fuentes disponibles. La API de REST proporciona datos en el formato JSON que incluyen los estilos y las secuencias de comandos (denominados subconjuntos de Google Fonts) de cada familia. La API puede ordenar alfabéticamente la lista de familias, por fecha de adición, por cantidad de estilos, por tendencia o por popularidad.

Audience

Este documento está dirigido a desarrolladores de aplicaciones y la Web. El uso de la API de Developer requiere conocimiento de JavaScript.

Ejemplo rápido:

Para recuperar la lista dinámica de fuentes que ofrece el servicio de Google Fonts, envía la siguiente solicitud:

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

Una muestra del resultado tendría el siguiente aspecto:

{
 "kind": "webfonts#webfontList",
 "items": [

[...]

{ "kind": "webfonts#webfont", "family": "Anonymous Pro", "variants": [ "regular", "italic", "700", "700italic" ], "subsets": [ "greek", "greek-ext", "cyrillic-ext", "latin-ext", "latin", "cyrillic" ], "version": "v3", "lastModified": "2012-07-25", "files": { "regular": "http://themes.googleusercontent.com/static/fonts/anonymouspro/v3/Zhfjj_gat3waL4JSju74E-V_5zh5b-_HiooIRUBwn1A.ttf", "italic": "http://themes.googleusercontent.com/static/fonts/anonymouspro/v3/q0u6LFHwttnT_69euiDbWKwIsuKDCXG0NQm7BvAgx-c.ttf", "700": "http://themes.googleusercontent.com/static/fonts/anonymouspro/v3/WDf5lZYgdmmKhO8E1AQud--Cz_5MeePnXDAcLNWyBME.ttf", "700italic": "http://themes.googleusercontent.com/static/fonts/anonymouspro/v3/_fVr_XGln-cetWSUc-JpfA1LL9bfs7wyIp6F8OC9RxA.ttf" } }, { "kind": "webfonts#webfont", "family": "Antic", "variants": [ "regular" ], "subsets": [ "latin" ], "version": "v4", "lastModified": "2012-07-25", "files": { "regular": "http://themes.googleusercontent.com/static/fonts/antic/v4/hEa8XCNM7tXGzD0Uk0AipA.ttf" } },

[...]

] }

Cómo identificar tu aplicación en Google

Tu aplicación debe identificarse cada vez que envíe una solicitud a la API de Google Fonts Developer, incluyendo una clave de API con cada solicitud.

Adquiere y usa una clave de API

Obtener una clave

También puedes crear una en la página Credenciales.

Una vez que tienes una clave de API, puedes usar tu aplicación para adjuntar el parámetro de consulta key=yourAPIKey a todas las URL de solicitud.

La clave de API en las URL se incorpora de manera segura, por lo que no necesita codificación.

Detalles

La respuesta JSON (consulta la muestra anterior) está compuesta por un arreglo llamado &items; que contiene objetos con información sobre cada familia de fuentes.

Un objeto familiar está compuesto por 4 campos:

  • tipo: El tipo de objeto, un objeto de fuente para sitios web
  • familia: el nombre de la familia
  • subconjuntos: una lista de secuencias de comandos compatibles con la familia
  • variantes: los diferentes estilos disponibles para la familia
  • version: La versión de la familia de fuentes.
  • lastModified: La fecha (formato) de la familia de fuentes en la que se modificó por última vez.
  • files: Los archivos de la familia de fuentes (con todas las secuencias de comandos compatibles) para cada una de las variantes disponibles.

Si se combina la información de cada familia, es fácil crear una solicitud a la API de Fonts. Por ejemplo, suponiendo que tenemos una referencia al objeto de familia para Anónimo 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('');

[...]

De forma predeterminada, se muestra la lista de familias sin un orden en particular. Sin embargo, es posible ordenar la lista con el parámetro de ordenamiento:

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

Los posibles valores de orden son los siguientes:

  • alfa: Ordenar la lista alfabéticamente
  • date: Ordena la lista por la fecha en que se agregó (la fuente más reciente se agregó o se actualizó primero)
  • popularidad: Ordene la lista por popularidad (los familiares más populares primero).
  • style: ordena la lista por cantidad de estilos disponibles (familia con la mayoría de los estilos primero)
  • tendencias: Ordena la lista por familias que están experimentando un aumento en el uso (la familia que primero ve más crecimiento)