Volume

Une collection Volume permet d'effectuer une recherche ou de lister le contenu d'une bibliothèque. 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 privée "Ma bibliothèque" des volumes et nécessite une authentification.
books.mylibrary.bookshelves.volumes.list

get
Récupère une ressource Volume en fonction de l'ID.
liste
Effectue une recherche de livres.

Représentations d'une ressource

Un volume représente les informations hébergées par Google Livres sur un livre ou un magazine. Il contient des métadonnées, telles que le titre et l'auteur, ainsi que des données personnalisées, comme l'état d'achat. (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. (Dans la projection LITE.)
id string Identifiant unique d'un volume. (Dans la projection LITE.)
etag string Identifiant opaque pour une version spécifique d'une ressource de volume. (En mode LITE)
volumeInfo object Informations générales sur le volume.
volumeInfo.title string Titre du volume. (Dans la projection LITE.)
volumeInfo.subtitle string Sous-titre du volume. (Dans la projection LITE.)
volumeInfo.authors[] list Noms des auteurs et/ou des éditeurs de ce volume. (En mode LITE)
volumeInfo.publisher string Éditeur de ce volume. (Dans la projection LITE.)
volumeInfo.publishedDate string Date de publication. (Dans la projection LITE.)
volumeInfo.description string Synopsis 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 les balises b, i et br. (en projection LITE)
volumeInfo.industryIdentifiers[] list Identifiants standards du secteur pour ce volume.
volumeInfo.industryIdentifiers[].type string Type d'identifiant. Les valeurs possibles sont ISBN_10, ISBN_13, ISSN et AUTRE.
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 "LIVRE" ou "REVUE".
volumeInfo.categories[] list Liste de catégories de sujets, telles que "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 attribuées à ce volume.
volumeInfo.contentVersion string Identifiant de la version du contenu du volume (texte et images). (En mode LITE)
volumeInfo.imageLinks.thumbnail string Lien vers l'image pour la taille de la vignette (largeur d'environ 128 pixels). (en projection LITE)
volumeInfo.imageLinks.small string Lien vers une image de petite taille (largeur d'environ 300 pixels). (en projection LITE)
volumeInfo.imageLinks.medium string Lien vers une image de taille moyenne (largeur d'environ 575 pixels). (en projection LITE)
volumeInfo.imageLinks.large string Lien vers une image de grande taille (largeur d'environ 800 pixels). (en projection LITE)
volumeInfo.imageLinks.smallThumbnail string Lien vers l'image pour une petite taille de vignette (environ 80 pixels de large). (en projection LITE)
volumeInfo.imageLinks.extraLarge string Lien vers l'image en 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 d'un code ISO 639-1 à deux lettres, tel que 'fr', 'en', etc.
volumeInfo.mainCategory string Catégorie principale à laquelle appartient ce volume. Il s'agit de la catégorie de la liste de catégories renvoyée ci-dessous qui a la pondération la plus élevée.
userInfo object Informations spécifiques à l'utilisateur concernant ce volume. (par exemple, la page que cet utilisateur a lue pour la dernière fois ou s'il a acheté ce livre)
userInfo.review nested object 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. (Dans la projection LITE.)
userInfo.isPurchased boolean Indique si ce volume a été acheté par l'utilisateur authentifié qui a effectué la requête. (Dans la projection LITE.)
saleInfo object Toute information sur un volume liée à la librairie numérique et/ou à la possibilité d'achat. Ces informations peuvent dépendre du pays d'où provient la demande (par exemple, les livres peuvent ne pas être disponibles à la vente dans certains pays).
saleInfo.country string Code pays ISO_3166-1 à deux lettres pour lequel les informations sur la vente sont valides. (Dans la projection LITE.)
saleInfo.saleability string Indique si ce livre est disponible à la vente ou proposé sans frais sur le Google eBookstore 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 e-book (peut être ajouté à l'étagère "Mes e-books").
saleInfo.listPrice object Prix de vente conseillé. (en projection LITE)
saleInfo.listPrice.amount double Montant dans la devise indiquée ci-dessous. (Dans la projection LITE.)
saleInfo.listPrice.currencyCode string Code de devise ISO 4217 à trois lettres. (Dans la projection LITE.)
saleInfo.retailPrice object Prix de vente réel du livre. Il s'agit du prix catalogue ou du prix suggéré, sauf si des offres ou des remises sont proposées sur ce volume. (en projection LITE)
saleInfo.retailPrice.amount double Montant dans la devise indiquée ci-dessous. (Dans la projection LITE.)
saleInfo.retailPrice.currencyCode string Code de devise ISO 4217 à trois lettres. (Dans la projection LITE.)
accessInfo object Toute information concernant la lecture ou l'obtention du texte d'un volume. Ces informations peuvent varier selon le pays (par exemple, les livres peuvent être du domaine public dans un pays, mais pas dans un autre).
accessInfo.country string Code pays ISO_3166-1 à deux lettres pour lequel ces informations d'accès sont valides. (Dans la projection LITE.)
accessInfo.viewability string Accès en lecture d'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" (PARTIEL) signifie que l'éditeur a autorisé une partie du volume à être visionnée publiquement, sans achat. Cela peut s'appliquer aux e-books et aux autres livres. Les livres du domaine public auront toujours la valeur ALL_PAGES.
accessInfo.epub object Informations sur le contenu EPUB. (en projection LITE)
accessInfo.pdf object Informations sur le contenu PDF. (dans la 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. (Dans la projection LITE.)
accessInfo.embeddable boolean Indique si ce volume peut être intégré dans un viewport à l'aide de l'API Embedded Viewer.
accessInfo.publicDomain boolean Indique si ce livre relève du domaine public dans le pays indiqué ci-dessus.
userInfo.updated datetime Code temporel de la dernière modification de ce volume par une action de l'utilisateur, comme la mise à jour de la position de lecture, l'achat d'un volume ou la rédaction d'un avis. (format date-heure UTC RFC 3339).
userInfo.isPreordered boolean Indique si ce volume a été précommandé par l'utilisateur authentifié qui a effectué la requête. (Dans la projection LITE.)
saleInfo.onSaleDate datetime Date à laquelle ce 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 Il s'agit d'un fichier ePub au format texte flottant disponible en domaine public ou à l'achat. (Dans la projection LITE.)
accessInfo.pdf.isAvailable boolean Une image scannée au format PDF est disponible en domaine public ou à l'achat. (Dans la projection LITE.)
accessInfo.downloadAccess nested object Informations sur les restrictions d'accès des licences de téléchargement d'un volume.
accessInfo.downloadAccess.kind string Type de ressource.
accessInfo.downloadAccess.volumeId string Identifie le volume auquel cette entrée s'applique.
accessInfo.downloadAccess.restricted boolean Indique si ce volume est soumis à des restrictions d'accès au téléchargement.
accessInfo.downloadAccess.deviceAllowed boolean En cas de restriction, indique si l'accès est accordé pour cet élément (utilisateur, appareil, volume).
accessInfo.downloadAccess.justAcquired boolean Si "deviceAllowed" est défini, indique si l'accès vient d'être acquis avec cette requête.
accessInfo.downloadAccess.maxDownloadDevices integer Si le nombre est limité, il s'agit du nombre maximal de licences de téléchargement de contenu pour ce volume.
accessInfo.downloadAccess.downloadsAcquired integer Si l'accès est limité, le nombre de licences de téléchargement de contenu déjà acquises (y compris le client à l'origine de la demande, le cas échéant).
accessInfo.downloadAccess.nonce string Nonce client 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 à l'avenir. 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 associées à ce volume.
searchInfo.textSnippet string Extrait de texte contenant la requête de recherche.