Cette page a été traduite par l'API Cloud Translation.

Dynamic Links

La fonctionnalité de liens dynamiques Google Livres vous permet de créer des liens plus fiables et personnalisables vers Google Livres à partir de votre site. Par exemple, cet outil vous permet de générer des liens "intelligents" qui ne s'affichent que lorsqu'un livre figure dans notre index, ou d'afficher des liens qui indiquent aux utilisateurs si un livre peut être prévisualisé sur Google Livres. La fonctionnalité Liens dynamiques vous permet également d'inclure une vignette dans votre lien vers Google Livres. L'objectif de ce document est de vous permettre d'ajouter rapidement cette fonctionnalité à votre site.

Remarque: Cette fonctionnalité était auparavant appelée "API Book Visibility".

L'assistant de prévisualisation est un outil intégré à Dynamic Links. Il vous permet d'ajouter encore plus facilement des liens vers des aperçus de livres à partir d'un site en copiant simplement quelques lignes de code. Ce document s'adresse aux développeurs plus avancés qui souhaitent personnaliser la façon dont ils établissent un lien vers Google Recherche de Livres.

Sommaire

Audience
Terminologie de Recherche de Livres
Introduction
Consignes relatives à la marque
L'API côté client
1. Format de l'URL de requête
2. Format des résultats JSON
Modes synchrone et asynchrone
Questions fréquentes
Exemples de code

Audience

La documentation sur les liens dynamiques est destinée aux programmeurs qui souhaitent créer des applications Web qui redirigent vers des livres dans Google Livres. Dans cette documentation, nous partons du principe que vous connaissez le protocole HTTP et le langage JavaScript de base.

Terminologie de Google Recherche de Livres

Google Livres respecte les restrictions locales applicables aux droits d'auteur. Par conséquent, les aperçus ou l'affichage intégral de certains livres ne sont pas disponibles dans tous les pays. La visibilité est regroupée dans les classes suivantes:

Tout afficher: L'intégralité du livre peut être consultée. Ces livres peuvent appartenir au domaine public.
Aperçu limité: Une partie du livre est consultable. Ce livre est protégé par des droits d'auteur, et l'équipe Google Livres a reçu l'autorisation de rendre ces pages accessibles aux utilisateurs. À la différence de l'affichage d'extraits, ces livres ne permettent pas aux utilisateurs de consulter des pages entières.
Affichage d'extraits et pas d'aperçu: Les utilisateurs ne voient qu'une page "À propos du livre". Seuls de courts extraits du livre sont disponibles tout au plus. Ce livre n'a pas été numérisé ou est protégé par des droits d'auteur. Google Livres n'a pas reçu l'autorisation de présenter plus de quelques "extraits" liés au terme de recherche d'un utilisateur.

Présentation

La documentation sur les liens statiques décrit un moyen très simple de générer des URL vers la page d'un livre spécifique sur Google Livres. Malheureusement, il arrive qu'un livre donné ne figure pas dans l'index Google Livres ou qu'aucun aperçu ne soit disponible pour un utilisateur situé dans une zone géographique donnée. Les liens statiques étant "aveugles", ils n'aboutissent pas toujours correctement.

Les liens dynamiques constituent une autre méthode programmatique côté client permettant d'interroger la visibilité d'un livre à l'aide de JavaScript. Vous pouvez ainsi inclure des liens plus fiables et prévisibles vers Google Recherche de Livres, et proposer une expérience plus cohérente à vos utilisateurs. La visibilité varie en fonction de l'emplacement de l'utilisateur final. Par conséquent, l'interface de lien dynamique n'est pas conçue pour les requêtes côté serveur ou hors connexion.

Pour découvrir les fonctionnalités des liens dynamiques, passez aux exemples de code à la fin de ce document.

Consignes relatives à la marque

Lorsque vous affichez des liens dynamiques, vous devez respecter les consignes relatives à la marque qui régissent la famille de l'API Google Livres. En particulier,

Vous devez gérer les mentions et les liens vers Google Livres.
Vous ne devez utiliser que le bouton "Aperçu Google" approuvé lorsque vous créez un lien vers des aperçus sur Google Livres.
Les liens textuels, les boutons, la documentation ou le texte descriptif doivent respecter les conventions d'attribution de noms approuvées. Par exemple, n'utilisez pas les verbes "télécharger" ou "lire" lorsque vous créez un lien vers des aperçus Google Livres, car seules les œuvres appartenant au domaine public peuvent être téléchargées dans leur intégralité.

Exemple de branding

Freakonomics: An Rogue Economist explore la face cachée du monde

Par Steven Levitt et Stephen Dubner

La section "Exemples" à la fin de ce document fournit des exemples supplémentaires conformes aux consignes actuelles relatives à la marque.

API côté client

Au cœur du lien dynamique côté client se trouve un format d'URL qui permet aux développeurs de créer des URL demandant des informations sur un ou plusieurs livres et d'envoyer les requêtes à Google Livres à l'aide de la balise <script>.

Exemple de syntaxe:: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

Format de requête

Le format de l'URL est semblable à la syntaxe d'URL utilisée pour créer un lien vers des livres. Toutefois, le champ d'ID de livre peut contenir plusieurs ID de livre séparés par une virgule, et des paramètres "jscmd" et "callback" supplémentaires peuvent être ajoutés. Des arguments supplémentaires peuvent éventuellement être présents pour contrôler les filtres de visibilité.

Dynamic Links accepte plusieurs méthodes d'identification des livres: les ISBN, les numéros OCLC et les clés LCCN. L'API autorise les requêtes par lot dont la taille ne dépasse pas la taille maximale d'une requête GET.

ISBN: &bibkeys=ISBN:0451526538 (L'API est compatible avec les codes ISBN 10 et 13.)
OCLC: &bibkeys=OCLC:36792831
Numéro de contrôle de la Bibliothèque du Congrès: &bibkeys=LCCN:96072233

Format des résultats JSON

La réponse à cet appel contient des informations sur les livres demandés, qui sont renvoyés sous la forme d'un ou de plusieurs objets JSON. Les objets JSON utilisent la structure suivante:

JsonSearchResult {
    string bib_key;
    string info_url;
    string preview_url;
    string thumbnail_url;
    string preview;
};

Ces champs fournissent les informations suivantes:

bib_key: Identifiant utilisé pour interroger ce livre.
info_url: URL d'une page Google Livres contenant des informations sur le livre (page "À propos de ce livre").
preview_url: URL vers l'aperçu du livre, qui redirige l'utilisateur directement vers la couverture du livre. Si vous ne disposez que de l'affichage d'extraits ou de l'absence d'aperçu des livres pour une requête, aucune URL d'aperçu n'est renvoyée.
thumbnail_url: URL d'une vignette de la couverture du livre.
preview: Valeur indiquant l'état de visibilité du livre: full (pour les livres en intégralité), partial (pour les livres en aperçu limité) ou noview (pour les livres avec aperçu ou sans aperçu).
intégrable: Cette valeur booléenne est true si le livre peut être intégré à des pages tierces à l'aide de la visionneuse intégrée Recherche de Livres.

Dynamic Links

Sommaire

Audience

Terminologie de Google Recherche de Livres

Présentation

Consignes relatives à la marque

Exemple de branding

API côté client

Format de requête

Format des résultats JSON

Paramètres et champs supplémentaires

Modes synchrone et asynchrone

Mode asynchrone

Mode synchrone

Questions fréquentes

Exemples de code