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

Volume: liste

Effectue une recherche de livre. 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 l'accès aux volumes en fonction de la disponibilité du téléchargement. Les valeurs possibles sont les suivantes : "`epub`" : tous les volumes au format ePub
`filter`	`string`	Filtrez les résultats de recherche. Les valeurs possibles sont les suivantes : "`ebooks`" – Tous les e-books Google. "`free-ebooks`" – Livre numérique Google avec visibilité du texte intégral. "`full`" : les utilisateurs publics peuvent consulter l'intégralité du texte du volume. "`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`	Restreindre la recherche à la bibliothèque de cet utilisateur. Les valeurs possibles sont les suivantes : "`my-library`" : permet de restreindre l'accès à la bibliothèque de l'utilisateur et à ses étagères. "`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`	Triez les résultats de recherche. Les valeurs possibles sont les suivantes : "`newest`" : dernière publication. "`relevance`" : pertinence par rapport aux termes de recherche.
`partner`	`string`	Limiter les résultats et améliorer la notoriété de la marque pour l'ID du partenaire.
`printType`	`string`	Limiter l'accès aux livres ou aux magazines. Les valeurs possibles sont les suivantes : "`all`" : tous les types de contenus liés aux volumes. "`books`" : uniquement des livres. "`magazines`" : uniquement des magazines.
`projection`	`string`	Limite 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 ce paramètre 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 la 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 la propriété	Valeur	Description
`kind`	`string`	Type de ressource.
`items[]`	`list`	Liste de 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.