Get Volume

google_books.get_volume
ActionBusiness appsconnection required

Calls the Google Books API with the connection's credentials.

Read one volume's full Google Books record.

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Google Books
Secret shape
the API key, or {"api_key": "…"}
Config it needs
base_url, country
Resolved by
config.connection_id, else node.connection_id

Configuration

2 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
volume_id
The volume's Google Books id, as returned by a search.
stringYes——zyTCAlFPjgYC
projection
How much of each volume to return: FULL is every field, LITE a subset of volumeInfo and accessInfo.
stringNo—one of "FULL", "LITE"—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "volume_id": "zyTCAlFPjgYC"
}

Output

One shape.

result

FieldTypeExample
id
The volume's Google Books id.
string—
volumeInfo.title
The volume's title.
string—
volumeInfo.subtitle
The volume's subtitle, when it has one.
string—
volumeInfo.authors
The volume's authors.
array—
volumeInfo.publisher
The volume's publisher.
string—
volumeInfo.publishedDate
The volume's publication date.
string—
volumeInfo.description
The publisher's description.
string—
volumeInfo.pageCount
How many pages the volume has.
number—
volumeInfo.industryIdentifiers
The volume's ISBN and other industry identifiers.
array—
saleInfo.saleability
Whether the volume is for sale.
string—
accessInfo.viewability
How much of the volume can be read.
string—
{
  "accessInfo": {
    "viewability": ""
  },
  "id": "",
  "saleInfo": {
    "saleability": ""
  },
  "volumeInfo": {
    "authors": [],
    "description": "",
    "industryIdentifiers": [],
    "pageCount": 0,
    "publishedDate": "",
    "publisher": "",
    "subtitle": "",
    "title": ""
  }
}

See Get Volume run in a workflow.

In a technical demo we add the Google Books connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.