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 concernant les volumes et ne nécessitent pas d'authentification.
books.volumes.listbooks.volumes.get
La méthode suivante s'applique à l'affichage privé "Ma bibliothèque" des volumes et nécessite une authentification.
books.mylibrary.bookshelves.volumes.list- get
- Récupère une ressource de volume basée sur l'ID.
- liste
- Effectue une recherche de livre.
Représentations d'une ressource
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, comme le titre et l'auteur, ainsi que des données personnalisées, indiquant par exemple si le contenu 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 la propriété | Valeur | Description | Remarques |
---|---|---|---|
kind |
string |
Type de ressource d'un volume. (en projection LITE). | |
id |
string |
Identifiant unique d'un volume. (en projection LITE). | |
etag |
string |
Identifiant opaque d'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 |
Résumé du volume. Le texte de la description est mis en forme en HTML et comprend des éléments de mise en forme simples, tels que des balises b, i et br. (en projection LITE) | |
volumeInfo.industryIdentifiers[] |
list |
Identifiants standards dans l'industrie 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 |
Une liste de catégories de sujets, telles que "Fiction", "Suspense", etc. | |
volumeInfo.averageRating |
double |
Note moyenne attribuée aux avis pour ce volume. (min = 1,0, max = 5,0) | |
volumeInfo.ratingsCount |
integer |
Nombre de notes attribuées aux avis pour ce volume. | |
volumeInfo.contentVersion |
string |
Identifiant de la version du contenu du volume (texte et images). (En projection LITE) | |
volumeInfo.imageLinks |
object |
Liste de liens image pour toutes les tailles disponibles. (en projection LITE) | |
volumeInfo.imageLinks.thumbnail |
string |
Lien image pour la taille de la vignette (largeur d'environ 128 pixels). (en projection LITE) | |
volumeInfo.imageLinks.small |
string |
Lien image pour les petites tailles (largeur d'environ 300 pixels). (en projection LITE) | |
volumeInfo.imageLinks.medium |
string |
Lien image pour la taille moyenne (largeur d'environ 575 pixels). (en projection LITE) | |
volumeInfo.imageLinks.large |
string |
Lien image pour une grande taille (largeur d'environ 800 pixels). (en projection LITE) | |
volumeInfo.imageLinks.smallThumbnail |
string |
Lien image pour les vignettes de petite taille (largeur d'environ 80 pixels). (en projection LITE) | |
volumeInfo.imageLinks.extraLarge |
string |
Lien image pour une très grande taille (largeur d'environ 1 280 pixels). (en projection LITE) | |
volumeInfo.language |
string |
Langue optimale pour ce volume (d'après le contenu). Il s'agit du code ISO 639-1 à deux lettres, tel que "fr", "en", etc. | |
volumeInfo.mainCategory |
string |
Catégorie principale à laquelle appartient ce volume. Il s'agira de la catégorie de la liste de catégories renvoyée ci-dessous ayant la pondération la plus élevée. | |
volumeInfo.previewLink |
string |
URL permettant d'afficher un aperçu de ce volume sur le site Google Livres. | |
userInfo |
object |
Informations spécifiques à l'utilisateur concernant ce volume. (par exemple, la dernière page lue par l'utilisateur 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 de lecture actuelle 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é à l'origine de la requête. (en projection LITE). | |
saleInfo |
object |
Toute information sur un volume en rapport avec l'e-librairie et/ou la possibilité d'achat Ces informations peuvent dépendre du pays d'origine de la demande (les livres peuvent ne pas être à la vente dans certains pays, par exemple). | |
saleInfo.country |
string |
Code pays ISO_3166-1 à deux lettres correspondant à cette information de vente. (en projection LITE). | |
saleInfo.saleability |
string |
Indique si le 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 ou non (peut être ajouté à l'étagère Mes livres numériques). | |
saleInfo.listPrice |
object |
Prix de vente suggéré. (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 ISO 4217 à trois lettres. (en projection LITE). | |
saleInfo.retailPrice |
object |
Prix de vente réel du livre. Il s'agit du même prix que le prix de vente suggéré ou le prix catalogue, sauf s'il existe des offres ou des remises sur ce volume. (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 ISO 4217 à trois lettres. (en projection LITE). | |
saleInfo.buyLink |
string |
URL permettant d'acheter ce volume sur le site Google Livres. (en projection LITE) | |
accessInfo |
object |
Toute information concernant un volume en rapport avec la lecture ou l'obtention de ce texte. Ces informations peuvent varier en fonction 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 cette information d'accès est valide. (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 signifie que l'éditeur a autorisé la consultation publique d'une partie du volume, sans achat. Cela s'applique aussi bien aux livres numériques qu'aux autres types de livres. Les livres appartenant au domaine public seront toujours associés à la valeur ALL_PAGES. | |
accessInfo.epub |
object |
Informations sur les contenus 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 d'ePub. (en projection LITE). | |
accessInfo.pdf |
object |
Informations sur le contenu PDF. (en projection LITE) | |
accessInfo.pdf.downloadLink |
string |
URL du téléchargement au format 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 peuvent être FULL_PURCHASED, FULL_PUBLIC_DOMAIN, Sample ou NONE. (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 Embedded Viewer. | |
accessInfo.publicDomain |
boolean |
Indique si le livre relève ou non du domaine public dans le pays indiqué ci-dessus. | |
|
string |
URL permettant d'afficher des informations sur ce volume sur le site Google Livres. (En projection LITE) | |
userInfo.updated |
datetime |
Code temporel de la dernière modification de ce volume par une action de l'utilisateur, telle qu'une mise à jour de la position de lecture, un achat de volume ou la rédaction d'un avis. (format de date/heure UTC RFC 3339). | |
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 à laquelle le livre est disponible à la vente. | |
accessInfo.textToSpeechPermission |
string |
Indique si la synthèse vocale est autorisée pour ce volume. Les valeurs peuvent être ALLOWED, ALLOWED_FOR_ACCESSIBILITY ou NOT_ALLOWED. | |
accessInfo.epub.isAvailable |
boolean |
Est un fichier ePub en texte flottant disponible à l'achat ou dans le domaine public ? (en projection LITE). | |
accessInfo.pdf.isAvailable |
boolean |
Est une image numérisée au format PDF disponible à l'achat ou dans le domaine public ? (en projection LITE). | |
accessInfo.webReaderLink |
string |
URL permettant de lire ce volume sur le site Google Livres. Le lien ne permettra pas aux utilisateurs de lire les volumes non visibles. | |
accessInfo.downloadAccess |
nested object |
Informations sur les restrictions d'accès aux licences de téléchargement d'un volume. | |
accessInfo.downloadAccess.kind |
string |
Type de ressource. | |
accessInfo.downloadAccess.volumeId |
string |
Identifie le volume auquel s'applique cette entrée. | |
accessInfo.downloadAccess.restricted |
boolean |
Indique si ce volume est soumis à des restrictions d'accès au téléchargement. | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
Si l'accès est limité, détermine si l'accès est accordé pour cet élément (utilisateur, appareil, volume). | |
accessInfo.downloadAccess.justAcquired |
boolean |
Si deviceAllowed, indique si l'accès vient d'être obtenu avec cette requête. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
Si la limite est appliquée, le nombre maximal de licences de téléchargement de contenu pour ce volume. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
Si la limite est appliquée, le nombre de licences de téléchargement de contenu déjà acquises (y compris le client à l'origine de la demande, s'il dispose d'une licence). | |
accessInfo.downloadAccess.nonce |
string |
Nonce du client pour la vérification. Accès au téléchargement et validation du client uniquement. | |
accessInfo.downloadAccess.source |
string |
Identifiant de l'application cliente pour la 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 en lien avec ce volume. | |
searchInfo.textSnippet |
string |
Extrait de texte contenant la requête de recherche. |