Une collection
Volume
permet d'effectuer une recherche ou de répertorier le contenu d'une étagère. Cette collection est en lecture seule.Méthodes
Les méthodes suivantes s'appliquent aux données publiques sur les volumes et ne nécessitent pas d'authentification.
books.volumes.list.books.volumes.get
La méthode suivante s'applique à la vue de volumes privée "Ma bibliothèque" et nécessite une authentification.
books.mylibrary.bookshelfs.volumes.list- obtenir
- Récupère une ressource de volume basée sur l'ID.
- list
- Recherche un livre.
Représentations des ressources
Un volume représente des informations hébergées par Google Livres à propos d'un livre ou d'un magazine. Il contient des métadonnées, telles que le titre et l'auteur, ainsi que des données personnalisées (par exemple, s'il a été acheté ou non). (Les champs de volume disponibles dans la projection LITE sont indiqués ci-dessous.)
{ "kind": "books#volume", "id": string, "etag": string, "selfLink": string, "volumeInfo": { "title": string, "subtitle": string, "authors": [ string ], "publisher": string, "publishedDate": string, "description": string, "industryIdentifiers": [ { "type": string, "identifier": string } ], "pageCount": integer, "dimensions": { "height": string, "width": string, "thickness": string }, "printType": string, "mainCategory": string, "categories": [ string ], "averageRating": double, "ratingsCount": integer, "contentVersion": string, "imageLinks": { "smallThumbnail": string, "thumbnail": string, "small": string, "medium": string, "large": string, "extraLarge": string }, "language": string, "previewLink": string, "infoLink": string, "canonicalVolumeLink": string }, "userInfo": { "review": mylibrary.reviews Resource, "readingPosition": mylibrary.readingpositions Resource, "isPurchased": boolean, "isPreordered": boolean, "updated": datetime }, "saleInfo": { "country": string, "saleability": string, "onSaleDate": datetime, "isEbook": boolean, "listPrice": { "amount": double, "currencyCode": string }, "retailPrice": { "amount": double, "currencyCode": string }, "buyLink": string }, "accessInfo": { "country": string, "viewability": string, "embeddable": boolean, "publicDomain": boolean, "textToSpeechPermission": string, "epub": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "pdf": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "webReaderLink": string, "accessViewStatus": string, "downloadAccess": { "kind": "books#downloadAccessRestriction", "volumeId": string, "restricted": boolean, "deviceAllowed": boolean, "justAcquired": boolean, "maxDownloadDevices": integer, "downloadsAcquired": integer, "nonce": string, "source": string, "reasonCode": string, "message": string, "signature": string } }, "searchInfo": { "textSnippet": string } }
Nom de propriété | Value | Description | Remarques |
---|---|---|---|
kind |
string |
Type de ressource pour un volume. (en projection LITE). | |
id |
string |
Identifiant unique d'un volume. (en projection LITE). | |
etag |
string |
Identifiant opaque pour une version spécifique d'une ressource de volume. (En projection LITE) | |
selfLink |
string |
URL de cette ressource. (en projection LITE). | |
volumeInfo |
object |
Informations générales sur le volume. | |
volumeInfo.title |
string |
Titre du volume. (en projection LITE). | |
volumeInfo.subtitle |
string |
Sous-titre du volume (en projection LITE). | |
volumeInfo.authors[] |
list |
Noms des auteurs et/ou des éditeurs de ce volume. (En projection LITE) | |
volumeInfo.publisher |
string |
Éditeur de ce volume. (en projection LITE). | |
volumeInfo.publishedDate |
string |
Date de publication. (en projection LITE). | |
volumeInfo.description |
string |
Synopsis du volume. Le texte de la description est au format HTML et inclut des éléments de mise en forme simples, tels que des balises "b", "i" et "br". (en projection LITE) | |
volumeInfo.industryIdentifiers[] |
list |
Identifiants standards pour ce volume. | |
volumeInfo.industryIdentifiers[].type |
string |
Type d'identifiant. Les valeurs possibles sont ISBN_10, ISBN_13, ISSN et OTHER. | |
volumeInfo.industryIdentifiers[].identifier |
string |
Identifiant de volume spécifique au secteur. | |
volumeInfo.pageCount |
integer |
Nombre total de pages. | |
volumeInfo.dimensions |
object |
Dimensions physiques de ce volume. | |
volumeInfo.dimensions.height |
string |
Hauteur ou longueur de ce volume (en cm). | |
volumeInfo.dimensions.width |
string |
Largeur de ce volume (en cm). | |
volumeInfo.dimensions.thickness |
string |
Épaisseur de ce volume (en cm). | |
volumeInfo.printType |
string |
Type de publication de ce volume. Les valeurs possibles sont BOOK ou MAGAZINE. | |
volumeInfo.categories[] |
list |
Liste de catégories de sujets (par exemple, "Fiction", "Suspense", etc.) | |
volumeInfo.averageRating |
double |
Note moyenne des avis pour ce volume. (min = 1,0, max = 5,0) | |
volumeInfo.ratingsCount |
integer |
Nombre de notes pour ce volume. | |
volumeInfo.contentVersion |
string |
Identifiant de la version du volume (texte et images). (En projection LITE) | |
volumeInfo.imageLinks |
object |
Liste des liens image pour toutes les tailles disponibles. (en projection LITE) | |
volumeInfo.imageLinks.thumbnail |
string |
Lien de l'image pour la taille de la vignette (largeur d'environ 128 pixels). (en projection LITE) | |
volumeInfo.imageLinks.small |
string |
Lien de l'image dans un format réduit (largeur d'environ 300 pixels) (en projection LITE) | |
volumeInfo.imageLinks.medium |
string |
Lien de l'image pour la taille moyenne (environ 575 pixels). (en projection LITE) | |
volumeInfo.imageLinks.large |
string |
Lien de l'image pour les grandes tailles (largeur d'environ 800 pixels) (en projection LITE) | |
volumeInfo.imageLinks.smallThumbnail |
string |
Lien de l'image pour les vignettes de petite taille (largeur d'environ 80 pixels). (en projection LITE) | |
volumeInfo.imageLinks.extraLarge |
string |
Lien de l'image pour une très grande taille (largeur d'environ 1 280 pixels) (en projection LITE) | |
volumeInfo.language |
string |
Meilleure langue pour ce volume (en fonction du contenu). Il s'agit du code ISO 639-1 à deux lettres, par exemple "fr", "en", etc. | |
volumeInfo.mainCategory |
string |
Catégorie principale à laquelle ce volume appartient. Il s'agira de la catégorie de la liste renvoyée ci-dessous qui présente la pondération la plus élevée. | |
volumeInfo.previewLink |
string |
URL pour prévisualiser ce volume sur le site Google Livres. | |
userInfo |
object |
Informations spécifiques à l'utilisateur liées à ce volume. (par exemple, la page à laquelle l'utilisateur a lu pour la dernière fois ou s'il a acheté ce livre) | |
userInfo.review |
nested object |
L'avis de cet utilisateur sur ce volume, le cas échéant. | |
userInfo.readingPosition |
readingPosition Resource |
Position actuelle de lecture de l'utilisateur dans le volume, le cas échéant. (en projection LITE). | |
userInfo.isPurchased |
boolean |
Indique si ce volume a été acheté par l'utilisateur authentifié qui effectue la requête. (en projection LITE). | |
saleInfo |
object |
Toute information sur un volume lié à l'e-librairie et/ou à l'achat Ces informations peuvent dépendre du pays d'origine de la demande (par exemple, les livres ne sont pas disponibles à la vente dans certains pays). | |
saleInfo.country |
string |
Code pays ISO-3166-1 à deux lettres pour lequel ces informations sont valides. (en projection LITE). | |
saleInfo.saleability |
string |
Indique si ce livre est disponible à la vente ou proposé sans frais dans l'e-librairie Google pour le pays indiqué ci-dessus. Les valeurs possibles sont FOR_SALE, FREE, NOT_FOR_SALE ou FOR_PREORDER. | |
saleInfo.isEbook |
boolean |
Indique si ce volume est un livre numérique (peut être ajouté à l'étagère "Mes livres numériques"). | |
saleInfo.listPrice |
object |
Prix de vente conseillé. (en projection LITE) | |
saleInfo.listPrice.amount |
double |
Montant dans la devise indiquée ci-dessous. (en projection LITE). | |
saleInfo.listPrice.currencyCode |
string |
Code de devise à trois lettres ISO 4217. (en projection LITE). | |
saleInfo.retailPrice |
object |
Prix de vente réel du livre. Il est identique au prix de vente conseillé ou au prix catalogue, sauf si ce volume contient des offres ou des remises. (en projection LITE) | |
saleInfo.retailPrice.amount |
double |
Montant dans la devise indiquée ci-dessous. (en projection LITE). | |
saleInfo.retailPrice.currencyCode |
string |
Code de devise à trois lettres ISO 4217. (en projection LITE). | |
saleInfo.buyLink |
string |
URL permettant d'acheter ce volume sur le site Google Livres. (en projection LITE) | |
accessInfo |
object |
Toute information sur un volume lié à la lecture ou à l'obtention de ce texte. Ces informations peuvent dépendre du pays (les livres peuvent appartenir au domaine public dans un pays, mais pas dans un autre, par exemple). | |
accessInfo.country |
string |
Code pays ISO-3166-1 à deux lettres pour lequel ces informations d'accès sont valides. (en projection LITE). | |
accessInfo.viewability |
string |
Accès en lecture à un volume. Les valeurs possibles sont PARTIAL, ALL_PAGES, NO_PAGES ou UNKNOWN. Cette valeur dépend du pays indiqué ci-dessus. La valeur PARTIAL indique que l'éditeur a autorisé la consultation publique d'une partie du volume, sans achat. Cela s'applique aussi bien aux e-books qu'aux e-books. Les livres appartenant au domaine public auront toujours la valeur ALL_PAGES. | |
accessInfo.epub |
object |
Informations sur le contenu EPUB. (en projection LITE) | |
accessInfo.epub.downloadLink |
string |
URL de téléchargement du fichier EPUB. (en projection LITE). | |
accessInfo.epub.acsTokenLink |
string |
URL permettant de récupérer le jeton ACS pour le téléchargement EPUB. (en projection LITE). | |
accessInfo.pdf |
object |
Informations sur le contenu PDF. (en projection LITE) | |
accessInfo.pdf.downloadLink |
string |
URL de téléchargement du fichier PDF. (en projection LITE). | |
accessInfo.pdf.acsTokenLink |
string |
URL permettant de récupérer le jeton ACS pour le téléchargement au format PDF. (en projection LITE). | |
accessInfo.accessViewStatus |
string |
Combine l'accès et la visibilité de ce volume dans un seul champ d'état pour cet utilisateur. Les valeurs possibles sont FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE ou AUCUN. (en projection LITE). | |
accessInfo.embeddable |
boolean |
Indique si ce volume peut être intégré dans une fenêtre d'affichage à l'aide de l'API de la visionneuse intégrée. | |
accessInfo.publicDomain |
boolean |
Indique si ce livre appartient au domaine public dans le pays indiqué ci-dessus. | |
|
string |
URL pour afficher des informations sur ce volume sur le site Google Livres (En projection LITE) | |
userInfo.updated |
datetime |
Horodatage de la dernière modification de ce volume par une action de l'utilisateur (mise à jour de la position de lecture, achat de volume ou évaluation d'un avis, par exemple). (format de date et d'heure RFC 3339 UTC) | |
volumeInfo.canonicalVolumeLink |
string |
URL canonique d'un volume. (en projection LITE). | |
userInfo.isPreordered |
boolean |
Indique si ce volume a été précommandé par l'utilisateur authentifié à l'origine de la requête. (en projection LITE). | |
saleInfo.onSaleDate |
datetime |
Date de mise en vente du livre. | |
accessInfo.textToSpeechPermission |
string |
Indique si la synthèse vocale est autorisée pour ce volume. Les valeurs possibles sont ALLOWED, ALLOWED_FOR_ACCESSIBILITY ou NOT_ALLOWED. | |
accessInfo.epub.isAvailable |
boolean |
Un fichier EPUB en mode texte flottant est disponible en tant que domaine public ou à la vente. (en projection LITE). | |
accessInfo.pdf.isAvailable |
boolean |
Un PDF de l'image numérisée est-il disponible dans le domaine public ou en vente ? (en projection LITE). | |
accessInfo.webReaderLink |
string |
URL pour lire ce volume sur le site Google Livres. Le lien ne permettra pas aux utilisateurs de lire des volumes non visibles. | |
accessInfo.downloadAccess |
nested object |
Informations sur les restrictions d'accès aux licences de téléchargement pour un volume. | |
accessInfo.downloadAccess.kind |
string |
Type de ressource. | |
accessInfo.downloadAccess.volumeId |
string |
Identifie le volume pour lequel cette entrée s'applique. | |
accessInfo.downloadAccess.restricted |
boolean |
Indique si ce volume comporte des restrictions d'accès de téléchargement. | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
Si restreint, indique si l'accès est autorisé pour cet utilisateur (utilisateur, appareil, volume). | |
accessInfo.downloadAccess.justAcquired |
boolean |
Si deviceAllowed est spécifié, indique si l'accès vient d'être obtenu avec cette requête. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
Si limité, le nombre maximal de licences de téléchargement de contenu pour ce volume. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
Si limité, nombre de licences de téléchargement de contenu déjà acquises (y compris le client demandeur, le cas échéant). | |
accessInfo.downloadAccess.nonce |
string |
Client nonce pour la validation. Accès au téléchargement et validation du client uniquement. | |
accessInfo.downloadAccess.source |
string |
Identifiant de l'application cliente à des fins de validation. Accès au téléchargement et validation du client uniquement. | |
accessInfo.downloadAccess.reasonCode |
string |
Code de motif d'erreur/d'avertissement. D'autres codes pourront être ajoutés ultérieurement. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS | |
accessInfo.downloadAccess.message |
string |
Message d'erreur/d'avertissement. | |
accessInfo.downloadAccess.signature |
string |
Signature de la réponse. | |
searchInfo |
object |
Informations sur les résultats de recherche liées à ce volume. | |
searchInfo.textSnippet |
string |
Extrait de texte contenant la requête de recherche. |