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.

Essayez-la !

Utilisez l'explorateur ci-dessous pour appeler cette méthode sur des données réelles et obtenir la réponse.