Google Books identifiers

Archive-reader recognizes GoogleBooks as a known identifier scheme when a publication states it explicitly. A publication can also carry a Google Books reference as a general URL identifier.

Publication metadata	Resolved identifier
EPUB 3 identifier explicitly typed GoogleBooks	{ value: id, scheme: "GoogleBooks" }
Absolute Google Books URL in an EPUB identifier	{ value: url, scheme: "URL" }
Absolute Google Books URL in ComicInfo Web	{ value: url, scheme: "URL" }
Untyped opaque Google Books id	{ value: id, scheme: "Unknown" }

Explicitly typed EPUB identifier

EPUB 3 can state the identifier namespace directly:

<dc:identifier id="google-books-id">k028AAAACAAJ</dc:identifier>
<meta refines="#google-books-id" property="identifier-type">
  GoogleBooks
</meta>

Archive-reader preserves the value and canonicalizes the known scheme spelling:

{
  value: "k028AAAACAAJ",
  scheme: "GoogleBooks",
}

This is the most precise representation because the publication explicitly says what assigned the otherwise opaque value.

Reference URL

Publications can carry a catalog reference without assigning a specialized identifier scheme.

In EPUB metadata:

<dc:identifier>
  https://books.google.com/books?id=k028AAAACAAJ
</dc:identifier>

In a CBZ or CBR ComicInfo.xml, the standard Web field provides the equivalent representation:

<ComicInfo>
  <Web>https://books.google.com/books?id=k028AAAACAAJ</Web>
</ComicInfo>

Both resolve to the literal URL:

{
  value: "https://books.google.com/books?id=k028AAAACAAJ",
  scheme: "URL",
}

Archive-reader normalizes an absolute HTTP(S) value generically as URL and preserves the complete authored value. ComicInfo keeps it under metadata.comicInfo.web as well, and its Web field can contain multiple space-separated reference URLs.

Reading the volume id

Because the same identifier arrives either explicitly typed or as a reference URL, read it with identifierValue rather than filtering on the scheme:

import { identifierValue } from "@prose-reader/archive-reader"

const id = identifierValue(metadata.identifiers, "GoogleBooks")
// "k028AAAACAAJ" | undefined

That answers for both representations above. Filtering on scheme === "GoogleBooks" misses every publication — comics especially — that stated the reference as a URL.

See Publication identifiers for the shared scheme resolution rules, custom schemes, URLs, and the Unknown fallback.