Volume: liste

Effectue une recherche de livres. Essayer maintenant

Demande

Requête HTTP

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

Paramètres

Nom du paramètre Value Description
Paramètres obligatoires
q string Chaîne de requête de recherche en texte intégral.
Paramètres facultatifs
download string Limiter aux volumes en fonction de la disponibilité des téléchargements

Les valeurs autorisées sont les suivantes :
  • "epub" : tous les volumes avec un epub.
filter string Filtrez les résultats de recherche.

Les valeurs autorisées sont les suivantes :
  • "ebooks" : tous les livres numériques Google
  • "free-ebooks" : e-book Google avec une visibilité totale du texte
  • "full" : l'ensemble du texte peut être affiché en mode public.
  • "paid-ebooks" : livre numérique Google avec un prix.
  • "partial" : public pouvant voir des parties du texte.
langRestrict string Limiter les résultats aux livres avec ce code de langue
libraryRestrict string Limiter la recherche à la bibliothèque de cet utilisateur

Les valeurs autorisées sont les suivantes :
  • "my-library" : limite la bibliothèque de l'utilisateur, n'importe quelle étagère.
  • "no-restrict" : aucune restriction ne s'applique 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 autorisées sont les suivantes :
  • "newest" : date de publication la plus récente.
  • "relevance" : pertinence par rapport aux termes de recherche.
partner string Restreindre et résultats associés à une marque pour l'ID de partenaire.
printType string Limiter aux livres ou aux magazines

Les valeurs autorisées sont les suivantes :
  • "all" : tous les types de contenus
  • "books" - Juste des livres.
  • "magazines" : juste des magazines.
projection string Limiter les informations renvoyées à un ensemble de champs sélectionnés.

Les valeurs autorisées sont les suivantes :
  • "full" : inclut toutes les données de volume.
  • "lite" : inclut un sous-ensemble de champs dans volumeInfo et accessInfo.
showPreorders boolean Défini sur "true" pour afficher les livres en précommande. Valeur par défaut : "false".
source string Chaîne permettant d'identifier l'auteur de cette requête.
startIndex unsigned integer Index 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 propriété Value Description Remarques
kind string Type de ressource.
items[] list Liste de volumes.
totalItems integer Nombre total de volumes trouvés. Cette valeur peut être supérieure au nombre de volumes renvoyés dans cette réponse si les résultats ont été paginés.

Essayer

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