Volume: liste

Effectue une recherche de livres. Essayer maintenant

Requête

Requête HTTP

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

Paramètres

Nom du paramètre	Valeur	Description
Paramètres obligatoires
q	string	Chaîne de requête de recherche en texte intégral.
Paramètres facultatifs
download	string	Limiter les volumes en fonction de la disponibilité du téléchargement Les valeurs acceptées sont les suivantes : "epub" : tous les volumes avec epub.
filter	string	Filtrez les résultats de recherche. Les valeurs acceptées sont les suivantes : "ebooks" : tous les e-books Google. "free-ebooks" : livre électronique Google avec visibilité du texte à plein volume. "full" : le public peut consulter l'intégralité du texte du volume. "paid-ebooks" : e-book Google avec un prix. "partial" : le public peut voir certaines parties du texte.
langRestrict	string	Limite les résultats aux livres associés à ce code de langue.
libraryRestrict	string	Limiter la recherche à la bibliothèque de cet utilisateur Les valeurs acceptées sont les suivantes : "my-library" : limite l'accès à la bibliothèque de l'utilisateur, à n'importe quelle étagère. "no-restrict" : ne pas appliquer de restriction en fonction de la bibliothèque de l'utilisateur.
maxResults	unsigned integer	Nombre maximal de résultats sur une page. Les valeurs autorisées vont de 0 à 40, inclus.
orderBy	string	Trier les résultats de recherche Les valeurs acceptées sont les suivantes : "newest" : le plus récent. "relevance" : pertinence par rapport aux termes de recherche.
partner	string	Limitez et marquez les résultats pour l'ID du partenaire.
printType	string	Limitez-vous aux livres ou aux magazines. Les valeurs acceptées sont les suivantes : "all" : tous les types de contenus liés aux volumes. "books" : uniquement des livres. "magazines" : uniquement des magazines.
projection	string	Limitez les informations renvoyées à un ensemble de champs sélectionnés. Les valeurs possibles sont les suivantes : "full" : inclut toutes les données du volume. "lite" : inclut un sous-ensemble de champs dans volumeInfo et accessInfo.
showPreorders	boolean	Définissez cette valeur sur "true" pour afficher les livres disponibles en précommande. Valeur par défaut : "false".
source	string	Chaîne permettant d'identifier l'auteur de cette requête.
startIndex	unsigned integer	Indice du premier résultat à renvoyer (commence à 0)

Corps de la requête

Ne spécifiez pas de corps de requête pour cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}

Nom de la propriété	Valeur	Description	Remarques
kind	string	Type de ressource.
items[]	list	Liste des volumes.
totalItems	integer	Nombre total de volumes trouvés. Ce nombre peut être supérieur au nombre de volumes renvoyés dans cette réponse si les résultats ont été paginés.