mirror of
https://github.com/BradNut/graphbrainz
synced 2025-09-08 17:40:32 +00:00
Update docs
This commit is contained in:
Brian Beck
parent
c12e97f83d
commit
168648c6e6
3 changed files with 905 additions and 10 deletions
143
docs/schema.md
143
docs/schema.md
|
|
@ -584,6 +584,62 @@ type Coordinates {
|
|||
longitude: Degrees
|
||||
}
|
||||
|
||||
# An individual piece of album artwork from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).
|
||||
type CoverArtImage {
|
||||
# The Internet Archive’s internal file ID for the image.
|
||||
fileID: String!
|
||||
|
||||
# The URL at which the image can be found.
|
||||
image: URLString!
|
||||
|
||||
# A set of thumbnails for the image.
|
||||
thumbnails: CoverArtImageThumbnails
|
||||
|
||||
# Whether this image depicts the “main front” of the release.
|
||||
front: Boolean!
|
||||
|
||||
# Whether this image depicts the “main back” of the release.
|
||||
back: Boolean!
|
||||
|
||||
# A list of [image types](https://musicbrainz.org/doc/Cover_Art/Types)
|
||||
# describing what part(s) of the release the image includes.
|
||||
types: [String]
|
||||
|
||||
# The MusicBrainz edit ID.
|
||||
edit: Int
|
||||
|
||||
# Whether the image was approved by the MusicBrainz edit system.
|
||||
approved: Boolean
|
||||
|
||||
# A free-text comment left for the image.
|
||||
comment: String
|
||||
}
|
||||
|
||||
# The image sizes that may be requested at the [Cover Art
|
||||
# Archive](https://musicbrainz.org/doc/Cover_Art_Archive).
|
||||
enum CoverArtImageSize {
|
||||
# A maximum dimension of 250px.
|
||||
SMALL
|
||||
|
||||
# A maximum dimension of 500px.
|
||||
LARGE
|
||||
|
||||
# The image’s original dimensions, with no maximum.
|
||||
FULL
|
||||
}
|
||||
|
||||
# URLs for thumbnails of different sizes for a particular piece of
|
||||
# cover art.
|
||||
type CoverArtImageThumbnails {
|
||||
# The URL of a small version of the cover art, where the
|
||||
# maximum dimension is 250px.
|
||||
small: URLString
|
||||
|
||||
# The URL of a large version of the cover art, where the
|
||||
# maximum dimension is 500px.
|
||||
large: URLString
|
||||
}
|
||||
|
||||
# Year, month (optional), and day (optional) in YYYY-MM-DD format.
|
||||
scalar Date
|
||||
|
||||
|
|
@ -1611,6 +1667,10 @@ type Release implements Node, Entity {
|
|||
# [EANs](https://en.wikipedia.org/wiki/International_Article_Number).
|
||||
barcode: String
|
||||
|
||||
# A list and summary of the cover art images that are present
|
||||
# for this release from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).
|
||||
coverArt: ReleaseCoverArt!
|
||||
|
||||
# The status describes how “official” a release is.
|
||||
status: ReleaseStatus
|
||||
|
||||
|
|
@ -1675,6 +1735,57 @@ type ReleaseConnection {
|
|||
totalCount: Int
|
||||
}
|
||||
|
||||
# An object containing a list of the cover art images for a
|
||||
# release obtained from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive),
|
||||
# as well as a summary of what artwork is available.
|
||||
type ReleaseCoverArt {
|
||||
# The URL of an image depicting the album cover or “main
|
||||
# front” of the release, i.e. the front of the packaging of the audio recording
|
||||
# (or in the case of a digital release, the image associated with it in a digital
|
||||
# media store).
|
||||
#
|
||||
# In the MusicBrainz schema, this field is a Boolean value indicating the presence
|
||||
# of a front image, whereas here the value is the URL for the image itself if one
|
||||
# exists. You can check for null if you just want to determine the presence of an
|
||||
# image.
|
||||
front(
|
||||
# The size of the image to retrieve. By default, the returned
|
||||
# image will have its full original dimensions, but certain thumbnail sizes may be
|
||||
# retrieved as well.
|
||||
size: CoverArtImageSize = null
|
||||
): URLString
|
||||
|
||||
# The URL of an image depicting the “main back” of the
|
||||
# release, i.e. the back of the packaging of the audio recording.
|
||||
#
|
||||
# In the MusicBrainz schema, this field is a Boolean value indicating the presence
|
||||
# of a back image, whereas here the value is the URL for the image itself. You can
|
||||
# check for null if you just want to determine the presence of an image.
|
||||
back(
|
||||
# The size of the image to retrieve. By default, the returned
|
||||
# image will have its full original dimensions, but certain thumbnail sizes may be
|
||||
# retrieved as well.
|
||||
size: CoverArtImageSize = null
|
||||
): URLString
|
||||
|
||||
# A list of images depicting the different sides and surfaces
|
||||
# of a release’s media and packaging.
|
||||
images: [CoverArtImage]
|
||||
|
||||
# Whether there is artwork present for this release.
|
||||
artwork: Boolean!
|
||||
|
||||
# Whether the Cover Art Archive has received a take-down
|
||||
# request for this release’s artwork, disallowing new uploads.
|
||||
darkened: Boolean!
|
||||
|
||||
# The number of artwork images present for this release.
|
||||
count: Int!
|
||||
|
||||
# The particular release shown in the returned cover art.
|
||||
release: Release!
|
||||
}
|
||||
|
||||
# An edge in a connection.
|
||||
type ReleaseEdge {
|
||||
# The item at the end of the edge
|
||||
|
|
@ -1747,6 +1858,10 @@ type ReleaseGroup implements Node, Entity {
|
|||
# field.
|
||||
secondaryTypeIDs: [MBID]
|
||||
|
||||
# The cover art for a release group, obtained from the [Cover
|
||||
# Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).
|
||||
coverArt: ReleaseGroupCoverArt
|
||||
|
||||
# A list of artists linked to this entity.
|
||||
artists(after: String, first: Int): ArtistConnection
|
||||
|
||||
|
|
@ -1787,6 +1902,34 @@ type ReleaseGroupConnection {
|
|||
totalCount: Int
|
||||
}
|
||||
|
||||
# An object containing the cover art for a release group obtained
|
||||
# from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive). For
|
||||
# release groups, just the front cover of particular release will be selected.
|
||||
type ReleaseGroupCoverArt {
|
||||
# The URL of an image depicting the album cover or “main
|
||||
# front” of a release in the release group, i.e. the front of the packaging of the
|
||||
# audio recording (or in the case of a digital release, the image associated with
|
||||
# it in a digital media store).
|
||||
front(
|
||||
# The size of the image to retrieve. By default, the returned
|
||||
# image will have its full original dimensions, but certain thumbnail sizes may be
|
||||
# retrieved as well.
|
||||
size: CoverArtImageSize = null
|
||||
): URLString
|
||||
|
||||
# A list of images returned by the [Cover Art
|
||||
# Archive](https://musicbrainz.org/doc/Cover_Art_Archive) for a release group. A
|
||||
# particular release’s front image will be included in the list, and likely no
|
||||
# others, even if other images are available.
|
||||
images: [CoverArtImage]
|
||||
|
||||
# Whether there is artwork present for this release group.
|
||||
artwork: Boolean!
|
||||
|
||||
# The particular release shown in the returned cover art.
|
||||
release: Release!
|
||||
}
|
||||
|
||||
# An edge in a connection.
|
||||
type ReleaseGroupEdge {
|
||||
# The item at the end of the edge
|
||||
|
|
|
|||
302
docs/types.md
302
docs/types.md
|
|
@ -18,6 +18,8 @@ You may also be interested in reading the [schema in GraphQL syntax](schema.md).
|
|||
<li>[CollectionConnection](#collectionconnection)</li>
|
||||
<li>[CollectionEdge](#collectionedge)</li>
|
||||
<li>[Coordinates](#coordinates)</li>
|
||||
<li>[CoverArtImage](#coverartimage)</li>
|
||||
<li>[CoverArtImageThumbnails](#coverartimagethumbnails)</li>
|
||||
<li>[Disc](#disc)</li>
|
||||
<li>[Event](#event)</li>
|
||||
<li>[EventConnection](#eventconnection)</li>
|
||||
|
|
@ -45,10 +47,12 @@ You may also be interested in reading the [schema in GraphQL syntax](schema.md).
|
|||
<li>[Relationships](#relationships)</li>
|
||||
<li>[Release](#release)</li>
|
||||
<li>[ReleaseConnection](#releaseconnection)</li>
|
||||
<li>[ReleaseCoverArt](#releasecoverart)</li>
|
||||
<li>[ReleaseEdge](#releaseedge)</li>
|
||||
<li>[ReleaseEvent](#releaseevent)</li>
|
||||
<li>[ReleaseGroup](#releasegroup)</li>
|
||||
<li>[ReleaseGroupConnection](#releasegroupconnection)</li>
|
||||
<li>[ReleaseGroupCoverArt](#releasegroupcoverart)</li>
|
||||
<li>[ReleaseGroupEdge](#releasegroupedge)</li>
|
||||
<li>[SearchQuery](#searchquery)</li>
|
||||
<li>[Series](#series)</li>
|
||||
|
|
@ -63,6 +67,7 @@ You may also be interested in reading the [schema in GraphQL syntax](schema.md).
|
|||
<li>[WorkEdge](#workedge)</li>
|
||||
</ul></li>
|
||||
<li>[Enums](#enums)<ul>
|
||||
<li>[CoverArtImageSize](#coverartimagesize)</li>
|
||||
<li>[ReleaseGroupType](#releasegrouptype)</li>
|
||||
<li>[ReleaseStatus](#releasestatus)</li>
|
||||
</ul></li>
|
||||
|
|
@ -1657,6 +1662,113 @@ Geographic coordinates described with latitude and longitude.
|
|||
</tr>
|
||||
</tbody></table>
|
||||
|
||||
### CoverArtImage
|
||||
|
||||
An individual piece of album artwork from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).
|
||||
|
||||
<table><thead>
|
||||
<tr>
|
||||
<th align="left">Field / Argument</th>
|
||||
<th align="left">Type</th>
|
||||
<th align="left">Description</th>
|
||||
</tr>
|
||||
</thead><tbody>
|
||||
<tr>
|
||||
<td valign="top"><strong>fileID</strong> </td>
|
||||
<td valign="top"><a href="#string">String</a>!</td>
|
||||
<td>
|
||||
The Internet Archive’s internal file ID for the image.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>image</strong> </td>
|
||||
<td valign="top"><a href="#urlstring">URLString</a>!</td>
|
||||
<td>
|
||||
The URL at which the image can be found.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>thumbnails</strong> </td>
|
||||
<td valign="top"><a href="#coverartimagethumbnails">CoverArtImageThumbnails</a></td>
|
||||
<td>
|
||||
A set of thumbnails for the image.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>front</strong> </td>
|
||||
<td valign="top"><a href="#boolean">Boolean</a>!</td>
|
||||
<td>
|
||||
Whether this image depicts the “main front” of the release.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>back</strong> </td>
|
||||
<td valign="top"><a href="#boolean">Boolean</a>!</td>
|
||||
<td>
|
||||
Whether this image depicts the “main back” of the release.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>types</strong> </td>
|
||||
<td valign="top">[<a href="#string">String</a>]</td>
|
||||
<td>
|
||||
A list of <a href="https://musicbrainz.org/doc/Cover_Art/Types">image types</a>
|
||||
describing what part(s) of the release the image includes.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>edit</strong> </td>
|
||||
<td valign="top"><a href="#int">Int</a></td>
|
||||
<td>
|
||||
The MusicBrainz edit ID.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>approved</strong> </td>
|
||||
<td valign="top"><a href="#boolean">Boolean</a></td>
|
||||
<td>
|
||||
Whether the image was approved by the MusicBrainz edit system.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>comment</strong> </td>
|
||||
<td valign="top"><a href="#string">String</a></td>
|
||||
<td>
|
||||
A free-text comment left for the image.
|
||||
</td>
|
||||
</tr>
|
||||
</tbody></table>
|
||||
|
||||
### CoverArtImageThumbnails
|
||||
|
||||
URLs for thumbnails of different sizes for a particular piece of
|
||||
cover art.
|
||||
|
||||
<table><thead>
|
||||
<tr>
|
||||
<th align="left">Field / Argument</th>
|
||||
<th align="left">Type</th>
|
||||
<th align="left">Description</th>
|
||||
</tr>
|
||||
</thead><tbody>
|
||||
<tr>
|
||||
<td valign="top"><strong>small</strong> </td>
|
||||
<td valign="top"><a href="#urlstring">URLString</a></td>
|
||||
<td>
|
||||
The URL of a small version of the cover art, where the
|
||||
maximum dimension is 250px.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>large</strong> </td>
|
||||
<td valign="top"><a href="#urlstring">URLString</a></td>
|
||||
<td>
|
||||
The URL of a large version of the cover art, where the
|
||||
maximum dimension is 500px.
|
||||
</td>
|
||||
</tr>
|
||||
</tbody></table>
|
||||
|
||||
### Disc
|
||||
|
||||
Information about the physical CD and releases associated with a
|
||||
|
|
@ -4038,6 +4150,14 @@ release has one. The most common types found on releases are 12-digit
|
|||
<a href="https://en.wikipedia.org/wiki/International_Article_Number">EANs</a>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>coverArt</strong> </td>
|
||||
<td valign="top"><a href="#releasecoverart">ReleaseCoverArt</a>!</td>
|
||||
<td>
|
||||
A list and summary of the cover art images that are present
|
||||
for this release from the <a href="https://musicbrainz.org/doc/Cover_Art_Archive">Cover Art Archive</a>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>status</strong> </td>
|
||||
<td valign="top"><a href="#releasestatus">ReleaseStatus</a></td>
|
||||
|
|
@ -4237,6 +4357,95 @@ ignoring pagination.
|
|||
</tr>
|
||||
</tbody></table>
|
||||
|
||||
### ReleaseCoverArt
|
||||
|
||||
An object containing a list of the cover art images for a
|
||||
release obtained from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive),
|
||||
as well as a summary of what artwork is available.
|
||||
|
||||
<table><thead>
|
||||
<tr>
|
||||
<th align="left">Field / Argument</th>
|
||||
<th align="left">Type</th>
|
||||
<th align="left">Description</th>
|
||||
</tr>
|
||||
</thead><tbody>
|
||||
<tr>
|
||||
<td valign="top"><strong>front</strong> </td>
|
||||
<td valign="top"><a href="#urlstring">URLString</a></td>
|
||||
<td>
|
||||
The URL of an image depicting the album cover or “main
|
||||
front” of the release, i.e. the front of the packaging of the audio recording
|
||||
(or in the case of a digital release, the image associated with it in a digital
|
||||
media store).<br><br>In the MusicBrainz schema, this field is a Boolean value indicating the presence
|
||||
of a front image, whereas here the value is the URL for the image itself if one
|
||||
exists. You can check for null if you just want to determine the presence of an
|
||||
image.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right" valign="top">size</td>
|
||||
<td valign="top"><a href="#coverartimagesize">CoverArtImageSize</a></td>
|
||||
<td>The size of the image to retrieve. By default, the returned
|
||||
image will have its full original dimensions, but certain thumbnail sizes may be
|
||||
retrieved as well.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>back</strong> </td>
|
||||
<td valign="top"><a href="#urlstring">URLString</a></td>
|
||||
<td>
|
||||
The URL of an image depicting the “main back” of the
|
||||
release, i.e. the back of the packaging of the audio recording.<br><br>In the MusicBrainz schema, this field is a Boolean value indicating the presence
|
||||
of a back image, whereas here the value is the URL for the image itself. You can
|
||||
check for null if you just want to determine the presence of an image.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right" valign="top">size</td>
|
||||
<td valign="top"><a href="#coverartimagesize">CoverArtImageSize</a></td>
|
||||
<td>The size of the image to retrieve. By default, the returned
|
||||
image will have its full original dimensions, but certain thumbnail sizes may be
|
||||
retrieved as well.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>images</strong> </td>
|
||||
<td valign="top">[<a href="#coverartimage">CoverArtImage</a>]</td>
|
||||
<td>
|
||||
A list of images depicting the different sides and surfaces
|
||||
of a release’s media and packaging.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>artwork</strong> </td>
|
||||
<td valign="top"><a href="#boolean">Boolean</a>!</td>
|
||||
<td>
|
||||
Whether there is artwork present for this release.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>darkened</strong> </td>
|
||||
<td valign="top"><a href="#boolean">Boolean</a>!</td>
|
||||
<td>
|
||||
Whether the Cover Art Archive has received a take-down
|
||||
request for this release’s artwork, disallowing new uploads.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>count</strong> </td>
|
||||
<td valign="top"><a href="#int">Int</a>!</td>
|
||||
<td>
|
||||
The number of artwork images present for this release.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>release</strong> </td>
|
||||
<td valign="top"><a href="#release">Release</a>!</td>
|
||||
<td>
|
||||
The particular release shown in the returned cover art.
|
||||
</td>
|
||||
</tr>
|
||||
</tbody></table>
|
||||
|
||||
### ReleaseEdge
|
||||
|
||||
An edge in a connection.
|
||||
|
|
@ -4415,6 +4624,14 @@ that apply to this release group.
|
|||
field.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>coverArt</strong> </td>
|
||||
<td valign="top"><a href="#releasegroupcoverart">ReleaseGroupCoverArt</a></td>
|
||||
<td>
|
||||
The cover art for a release group, obtained from the <a href="https://musicbrainz.org/doc/Cover_Art_Archive">Cover
|
||||
Art Archive</a>.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>artists</strong> </td>
|
||||
<td valign="top"><a href="#artistconnection">ArtistConnection</a></td>
|
||||
|
|
@ -4544,6 +4761,62 @@ ignoring pagination.
|
|||
</tr>
|
||||
</tbody></table>
|
||||
|
||||
### ReleaseGroupCoverArt
|
||||
|
||||
An object containing the cover art for a release group obtained
|
||||
from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive). For
|
||||
release groups, just the front cover of particular release will be selected.
|
||||
|
||||
<table><thead>
|
||||
<tr>
|
||||
<th align="left">Field / Argument</th>
|
||||
<th align="left">Type</th>
|
||||
<th align="left">Description</th>
|
||||
</tr>
|
||||
</thead><tbody>
|
||||
<tr>
|
||||
<td valign="top"><strong>front</strong> </td>
|
||||
<td valign="top"><a href="#urlstring">URLString</a></td>
|
||||
<td>
|
||||
The URL of an image depicting the album cover or “main
|
||||
front” of a release in the release group, i.e. the front of the packaging of the
|
||||
audio recording (or in the case of a digital release, the image associated with
|
||||
it in a digital media store).
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right" valign="top">size</td>
|
||||
<td valign="top"><a href="#coverartimagesize">CoverArtImageSize</a></td>
|
||||
<td>The size of the image to retrieve. By default, the returned
|
||||
image will have its full original dimensions, but certain thumbnail sizes may be
|
||||
retrieved as well.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>images</strong> </td>
|
||||
<td valign="top">[<a href="#coverartimage">CoverArtImage</a>]</td>
|
||||
<td>
|
||||
A list of images returned by the <a href="https://musicbrainz.org/doc/Cover_Art_Archive">Cover Art
|
||||
Archive</a> for a release group. A
|
||||
particular release’s front image will be included in the list, and likely no
|
||||
others, even if other images are available.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>artwork</strong> </td>
|
||||
<td valign="top"><a href="#boolean">Boolean</a>!</td>
|
||||
<td>
|
||||
Whether there is artwork present for this release group.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>release</strong> </td>
|
||||
<td valign="top"><a href="#release">Release</a>!</td>
|
||||
<td>
|
||||
The particular release shown in the returned cover art.
|
||||
</td>
|
||||
</tr>
|
||||
</tbody></table>
|
||||
|
||||
### ReleaseGroupEdge
|
||||
|
||||
An edge in a connection.
|
||||
|
|
@ -5375,6 +5648,35 @@ these results were found through a search.
|
|||
|
||||
## Enums
|
||||
|
||||
### CoverArtImageSize
|
||||
|
||||
The image sizes that may be requested at the [Cover Art
|
||||
Archive](https://musicbrainz.org/doc/Cover_Art_Archive).
|
||||
|
||||
<table><thead>
|
||||
<th align="left">Value</th>
|
||||
<th align="left">Description</th>
|
||||
</thead><tbody>
|
||||
<tr>
|
||||
<td valign="top"><strong>SMALL</strong> </td>
|
||||
<td>
|
||||
A maximum dimension of 250px.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>LARGE</strong> </td>
|
||||
<td>
|
||||
A maximum dimension of 500px.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td valign="top"><strong>FULL</strong> </td>
|
||||
<td>
|
||||
The image’s original dimensions, with no maximum.
|
||||
</td>
|
||||
</tr>
|
||||
</tbody></table>
|
||||
|
||||
### ReleaseGroupType
|
||||
|
||||
A type used to describe release groups, e.g. album, single, EP,
|
||||
|
|
|
|||
470
schema.json
470
schema.json
|
|
@ -2907,6 +2907,22 @@
|
|||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "coverArt",
|
||||
"description": "A list and summary of the cover art images that are present\nfor this release from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "OBJECT",
|
||||
"name": "ReleaseCoverArt",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "status",
|
||||
"description": "The status describes how “official” a release is.",
|
||||
|
|
@ -3269,6 +3285,356 @@
|
|||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "OBJECT",
|
||||
"name": "ReleaseCoverArt",
|
||||
"description": "An object containing a list of the cover art images for a\nrelease obtained from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive),\nas well as a summary of what artwork is available.",
|
||||
"fields": [
|
||||
{
|
||||
"name": "front",
|
||||
"description": "The URL of an image depicting the album cover or “main\nfront” of the release, i.e. the front of the packaging of the audio recording\n(or in the case of a digital release, the image associated with it in a digital\nmedia store).\n\nIn the MusicBrainz schema, this field is a Boolean value indicating the presence\nof a front image, whereas here the value is the URL for the image itself if one\nexists. You can check for null if you just want to determine the presence of an\nimage.",
|
||||
"args": [
|
||||
{
|
||||
"name": "size",
|
||||
"description": "The size of the image to retrieve. By default, the returned\nimage will have its full original dimensions, but certain thumbnail sizes may be\nretrieved as well.",
|
||||
"type": {
|
||||
"kind": "ENUM",
|
||||
"name": "CoverArtImageSize",
|
||||
"ofType": null
|
||||
},
|
||||
"defaultValue": "null"
|
||||
}
|
||||
],
|
||||
"type": {
|
||||
"kind": "SCALAR",
|
||||
"name": "URLString",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "back",
|
||||
"description": "The URL of an image depicting the “main back” of the\nrelease, i.e. the back of the packaging of the audio recording.\n\nIn the MusicBrainz schema, this field is a Boolean value indicating the presence\nof a back image, whereas here the value is the URL for the image itself. You can\ncheck for null if you just want to determine the presence of an image.",
|
||||
"args": [
|
||||
{
|
||||
"name": "size",
|
||||
"description": "The size of the image to retrieve. By default, the returned\nimage will have its full original dimensions, but certain thumbnail sizes may be\nretrieved as well.",
|
||||
"type": {
|
||||
"kind": "ENUM",
|
||||
"name": "CoverArtImageSize",
|
||||
"ofType": null
|
||||
},
|
||||
"defaultValue": "null"
|
||||
}
|
||||
],
|
||||
"type": {
|
||||
"kind": "SCALAR",
|
||||
"name": "URLString",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "images",
|
||||
"description": "A list of images depicting the different sides and surfaces\nof a release’s media and packaging.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "LIST",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "OBJECT",
|
||||
"name": "CoverArtImage",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "artwork",
|
||||
"description": "Whether there is artwork present for this release.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "Boolean",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "darkened",
|
||||
"description": "Whether the Cover Art Archive has received a take-down\nrequest for this release’s artwork, disallowing new uploads.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "Boolean",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "count",
|
||||
"description": "The number of artwork images present for this release.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "Int",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "release",
|
||||
"description": "The particular release shown in the returned cover art.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "OBJECT",
|
||||
"name": "Release",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
}
|
||||
],
|
||||
"inputFields": null,
|
||||
"interfaces": [],
|
||||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "ENUM",
|
||||
"name": "CoverArtImageSize",
|
||||
"description": "The image sizes that may be requested at the [Cover Art\nArchive](https://musicbrainz.org/doc/Cover_Art_Archive).",
|
||||
"fields": null,
|
||||
"inputFields": null,
|
||||
"interfaces": null,
|
||||
"enumValues": [
|
||||
{
|
||||
"name": "SMALL",
|
||||
"description": "A maximum dimension of 250px.",
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "LARGE",
|
||||
"description": "A maximum dimension of 500px.",
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "FULL",
|
||||
"description": "The image’s original dimensions, with no maximum.",
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
}
|
||||
],
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "SCALAR",
|
||||
"name": "URLString",
|
||||
"description": "A web address.",
|
||||
"fields": null,
|
||||
"inputFields": null,
|
||||
"interfaces": null,
|
||||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "OBJECT",
|
||||
"name": "CoverArtImage",
|
||||
"description": "An individual piece of album artwork from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).",
|
||||
"fields": [
|
||||
{
|
||||
"name": "fileID",
|
||||
"description": "The Internet Archive’s internal file ID for the image.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "String",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "image",
|
||||
"description": "The URL at which the image can be found.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "URLString",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "thumbnails",
|
||||
"description": "A set of thumbnails for the image.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "OBJECT",
|
||||
"name": "CoverArtImageThumbnails",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "front",
|
||||
"description": "Whether this image depicts the “main front” of the release.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "Boolean",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "back",
|
||||
"description": "Whether this image depicts the “main back” of the release.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "Boolean",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "types",
|
||||
"description": "A list of [image types](https://musicbrainz.org/doc/Cover_Art/Types)\ndescribing what part(s) of the release the image includes.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "LIST",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "String",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "edit",
|
||||
"description": "The MusicBrainz edit ID.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "SCALAR",
|
||||
"name": "Int",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "approved",
|
||||
"description": "Whether the image was approved by the MusicBrainz edit system.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "SCALAR",
|
||||
"name": "Boolean",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "comment",
|
||||
"description": "A free-text comment left for the image.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "SCALAR",
|
||||
"name": "String",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
}
|
||||
],
|
||||
"inputFields": null,
|
||||
"interfaces": [],
|
||||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "OBJECT",
|
||||
"name": "CoverArtImageThumbnails",
|
||||
"description": "URLs for thumbnails of different sizes for a particular piece of\ncover art.",
|
||||
"fields": [
|
||||
{
|
||||
"name": "small",
|
||||
"description": "The URL of a small version of the cover art, where the\nmaximum dimension is 250px.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "SCALAR",
|
||||
"name": "URLString",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "large",
|
||||
"description": "The URL of a large version of the cover art, where the\nmaximum dimension is 500px.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "SCALAR",
|
||||
"name": "URLString",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
}
|
||||
],
|
||||
"inputFields": null,
|
||||
"interfaces": [],
|
||||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "OBJECT",
|
||||
"name": "Medium",
|
||||
|
|
@ -7539,6 +7905,18 @@
|
|||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "coverArt",
|
||||
"description": "The cover art for a release group, obtained from the [Cover\nArt Archive](https://musicbrainz.org/doc/Cover_Art_Archive).",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "OBJECT",
|
||||
"name": "ReleaseGroupCoverArt",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "artists",
|
||||
"description": "A list of artists linked to this entity.",
|
||||
|
|
@ -7740,6 +8118,88 @@
|
|||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "OBJECT",
|
||||
"name": "ReleaseGroupCoverArt",
|
||||
"description": "An object containing the cover art for a release group obtained\nfrom the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive). For\nrelease groups, just the front cover of particular release will be selected.",
|
||||
"fields": [
|
||||
{
|
||||
"name": "front",
|
||||
"description": "The URL of an image depicting the album cover or “main\nfront” of a release in the release group, i.e. the front of the packaging of the\naudio recording (or in the case of a digital release, the image associated with\nit in a digital media store).",
|
||||
"args": [
|
||||
{
|
||||
"name": "size",
|
||||
"description": "The size of the image to retrieve. By default, the returned\nimage will have its full original dimensions, but certain thumbnail sizes may be\nretrieved as well.",
|
||||
"type": {
|
||||
"kind": "ENUM",
|
||||
"name": "CoverArtImageSize",
|
||||
"ofType": null
|
||||
},
|
||||
"defaultValue": "null"
|
||||
}
|
||||
],
|
||||
"type": {
|
||||
"kind": "SCALAR",
|
||||
"name": "URLString",
|
||||
"ofType": null
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "images",
|
||||
"description": "A list of images returned by the [Cover Art\nArchive](https://musicbrainz.org/doc/Cover_Art_Archive) for a release group. A\nparticular release’s front image will be included in the list, and likely no\nothers, even if other images are available.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "LIST",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "OBJECT",
|
||||
"name": "CoverArtImage",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "artwork",
|
||||
"description": "Whether there is artwork present for this release group.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "SCALAR",
|
||||
"name": "Boolean",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
},
|
||||
{
|
||||
"name": "release",
|
||||
"description": "The particular release shown in the returned cover art.",
|
||||
"args": [],
|
||||
"type": {
|
||||
"kind": "NON_NULL",
|
||||
"name": null,
|
||||
"ofType": {
|
||||
"kind": "OBJECT",
|
||||
"name": "Release",
|
||||
"ofType": null
|
||||
}
|
||||
},
|
||||
"isDeprecated": false,
|
||||
"deprecationReason": null
|
||||
}
|
||||
],
|
||||
"inputFields": null,
|
||||
"interfaces": [],
|
||||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "OBJECT",
|
||||
"name": "SeriesConnection",
|
||||
|
|
@ -8401,16 +8861,6 @@
|
|||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "SCALAR",
|
||||
"name": "URLString",
|
||||
"description": "A web address.",
|
||||
"fields": null,
|
||||
"inputFields": null,
|
||||
"interfaces": null,
|
||||
"enumValues": null,
|
||||
"possibleTypes": null
|
||||
},
|
||||
{
|
||||
"kind": "OBJECT",
|
||||
"name": "URL",
|
||||
|
|
|
|||
Loading…
Reference in a new issue