mirror of
https://github.com/LukeHagar/plexgo.git
synced 2025-12-09 20:47:49 +00:00
## Go SDK Changes:
* `PlexApi.LibraryPlaylists.AddPlaylistItems()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Hubs.GetMetadataHubs()`: * `request.Request.OnlyTransient` **Changed** * `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryCollections.MoveCollectionItem()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryCollections.DeleteCollectionItem()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryCollections.AddCollectionItems()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Content.GetSonicallySimilar()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Butler.StopTask()`: `request.Request` **Changed** **Breaking** ⚠️ * `PlexApi.Butler.StartTask()`: `request.Request` **Changed** **Breaking** ⚠️ * `PlexApi.Content.GetSonicPath()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.DownloadQueue.GetItemDecision()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Hubs.GetAllHubs()`: * `request.Request.OnlyTransient` **Changed** * `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Hubs.GetContinueWatching()`: `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Hubs.GetPromotedHubs()`: `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Content.GetAllLeaves()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Hubs.GetPostplayHubs()`: * `request.Request.OnlyTransient` **Changed** * `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Hubs.GetRelatedHubs()`: * `request.Request.OnlyTransient` **Changed** * `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Hubs.GetSectionHubs()`: * `request.Request.OnlyTransient` **Changed** * `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Content.ListContent()`: * `request.Request` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Content.GetAlbums()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Search.SearchHubs()`: `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Search.VoiceSearchHubs()`: * `request.Request.Type` **Changed** **Breaking** ⚠️ * `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetLibraryItems()`: * `request.Request.MediaQuery` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.IngestTransientItem()`: * `request.Request` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetLibraryMatches()`: * `request.Request` **Changed** **Breaking** ⚠️ * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Content.GetMetadataItem()`: * `request.Request` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetSections()`: `response.MediaContainer.Directory.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.AddSection()`: * `request.Request` **Changed** * `response.MediaContainer.Directory.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetTags()`: * `request.Request.Type` **Changed** **Breaking** ⚠️ * `PlexApi.Content.GetCollectionItems()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetAllItemLeaves()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Status.ListSessions()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.PlayQueue.MovePlayQueueItem()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetExtras()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.PlayQueue.DeletePlayQueueItem()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.PlayQueue.Unshuffle()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.ListMatches()`: * `request.Request.Manual` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.ListSonicallySimilar()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.PlayQueue.ResetPlayQueue()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetRelatedItems()`: `response.MediaContainer.Hub.[].Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.ListSimilar()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.PlayQueue.ClearPlayQueue()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetItemTree()`: `response.MediaContainer.MetadataItem.[]` **Changed** **Breaking** ⚠️ * `PlexApi.PlayQueue.AddToPlayQueue()`: * `request.Request.Next` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.PlayQueue.GetPlayQueue()`: * `request.Request` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryPlaylists.MovePlaylistItem()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetPerson()`: `response.MediaContainer.Directory.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.ListPersonMedia()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryPlaylists.GetPlaylistGeneratorItems()`: `response.MediaContainer.Metadata` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetLibraryDetails()`: * `request.Request.IncludeDetails` **Changed** * `response.MediaContainer.Directory.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryPlaylists.ModifyPlaylistGenerator()`: * `request.Request.Item` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.Autocomplete()`: * `request.Request.MediaQuery` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetCollections()`: * `request.Request.MediaQuery` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.GetCommon()`: * `request.Request.MediaQuery` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryPlaylists.DeletePlaylistItem()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryPlaylists.ClearPlaylistItems()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.PlayQueue.Shuffle()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LibraryPlaylists.CreatePlaylist()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Playlist.GetPlaylistItems()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Playlist.GetPlaylist()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Collections.CreateCollection()`: * `request.Request.Type` **Changed** **Breaking** ⚠️ * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.DvRs.TuneChannel()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LiveTv.GetSessions()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.LiveTv.GetLiveTvSession()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Playlist.ListPlaylists()`: `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Subscriptions.GetAllSubscriptions()`: * `request.Request` **Changed** * `response.MediaContainer.MediaSubscription.[].MediaGrabOperation.[].Metadata` **Changed** **Breaking** ⚠️ * `PlexApi.Subscriptions.CreateSubscription()`: `response.MediaContainer.MediaSubscription.[].MediaGrabOperation.[].Metadata` **Changed** **Breaking** ⚠️ * `PlexApi.Subscriptions.GetScheduledRecordings()`: `response.MediaContainer.MediaGrabOperation.[].Metadata` **Changed** **Breaking** ⚠️ * `PlexApi.Subscriptions.GetTemplate()`: `response.MediaContainer.SubscriptionTemplate.[].MediaSubscription.[].MediaGrabOperation.[].Metadata` **Changed** **Breaking** ⚠️ * `PlexApi.Subscriptions.GetSubscription()`: * `request.Request` **Changed** * `response.MediaContainer.MediaSubscription.[].MediaGrabOperation.[].Metadata` **Changed** **Breaking** ⚠️ * `PlexApi.Subscriptions.EditSubscriptionPreferences()`: `response.MediaContainer.MediaSubscription.[].MediaGrabOperation.[].Metadata` **Changed** **Breaking** ⚠️ * `PlexApi.Subscriptions.ReorderSubscription()`: `response.MediaContainer.MediaSubscription.[].MediaGrabOperation.[].Metadata` **Changed** **Breaking** ⚠️ * `PlexApi.Transcoder.MakeDecision()`: * `request.Request` **Changed** * `response.MediaContainer.Metadata.[]` **Changed** **Breaking** ⚠️ * `PlexApi.Library.RefreshItemsMetadata()`: * `request.Request.MarkUpdated` **Changed** * `PlexApi.Authentication.Post-Users-Sign-In-Data()`: **Added** * `PlexApi.Transcoder.StartTranscodeSession()`: `request.Request` **Changed** * `PlexApi.Devices.ModifyDevice()`: * `request.Request.Enabled` **Changed** * `PlexApi.Library.GetMediaPart()`: * `request.Request.Download` **Changed** * `PlexApi.Library.DetectIntros()`: * `request.Request.Force` **Changed** * `PlexApi.Library.RefreshSection()`: * `request.Request.Force` **Changed** * `PlexApi.LibraryPlaylists.UploadPlaylist()`: * `request.Request.Force` **Changed** * `PlexApi.Library.DeleteMediaItem()`: * `request.Request.Proxy` **Changed** * `PlexApi.Authentication.GetTokenDetails()`: **Added** * `PlexApi.Library.GetFirstCharacters()`: * `request.Request.MediaQuery` **Changed** * `PlexApi.Library.UpdateItems()`: * `request.Request.Field.locked` **Changed** * `PlexApi.Library.DeleteLibrarySection()`: * `request.Request.Async` **Changed** * `PlexApi.Library.SetStreamSelection()`: * `request.Request.AllParts` **Changed** * `PlexApi.PlayQueue.CreatePlayQueue()`: `request.Request` **Changed** * `PlexApi.Library.GetAugmentationStatus()`: * `request.Request.Wait` **Changed** * `PlexApi.Library.DetectVoiceActivity()`: `request.Request` **Changed** * `PlexApi.Transcoder.TranscodeImage()`: `request.Request` **Changed** * `PlexApi.Transcoder.TranscodeSubtitles()`: `request.Request` **Changed** * `PlexApi.Library.AddSubtitles()`: `request.Request` **Changed** * `PlexApi.Library.GetStream()`: * `request.Request.AutoAdjustSubtitle` **Changed** * `PlexApi.Library.StartBifGeneration()`: * `request.Request.Force` **Changed** * `PlexApi.Library.DetectCredits()`: `request.Request` **Changed** * `PlexApi.UltraBlur.GetImage()`: * `request.Request.Noise` **Changed** * `PlexApi.Library.GenerateThumbs()`: * `request.Request.Force` **Changed** * `PlexApi.Updater.ApplyUpdates()`: `request.Request` **Changed** * `PlexApi.Updater.CheckUpdates()`: * `request.Request.Download` **Changed** * `PlexApi.Library.DeleteMetadataItem()`: * `request.Request.Proxy` **Changed** * `PlexApi.Library.OptimizeDatabase()`: * `request.Request.Async` **Changed** * `PlexApi.Hubs.UpdateHubVisibility()`: `request.Request` **Changed** * `PlexApi.Hubs.CreateCustomHub()`: `request.Request` **Changed** * `PlexApi.Library.GetSectionImage()`: * `request.Request.MediaQuery` **Changed** * `PlexApi.DownloadQueue.AddDownloadQueueItems()`: `request.Request` **Changed** * `PlexApi.Timeline.Report()`: `request.Request` **Changed** * `PlexApi.General.GetSourceConnectionInformation()`: * `request.Request.Refresh` **Changed** * `PlexApi.Plex.Get-Server-Resources()`: **Added** * `PlexApi.Users.Get-Users()`: **Added**
This commit is contained in:
speakeasybot
12
docs/models/components/autoselectsubtitle.md
Normal file
12
docs/models/components/autoselectsubtitle.md
Normal file
@@ -0,0 +1,12 @@
|
||||
# AutoSelectSubtitle
|
||||
|
||||
The auto-select subtitle mode (0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled)
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ----------------------------------------- | ----------------------------------------- |
|
||||
| `AutoSelectSubtitleManuallySelected` | 0 |
|
||||
| `AutoSelectSubtitleShownWithForeignAudio` | 1 |
|
||||
| `AutoSelectSubtitleAlwaysEnabled` | 2 |
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ------------- | ------------- |
|
||||
| `BoolIntZero` | 0 |
|
||||
| `BoolIntOne` | 1 |
|
||||
| Name | Value |
|
||||
| -------------- | -------------- |
|
||||
| `BoolIntFalse` | 0 |
|
||||
| `BoolIntTrue` | 1 |
|
||||
14
docs/models/components/connections.md
Normal file
14
docs/models/components/connections.md
Normal file
@@ -0,0 +1,14 @@
|
||||
# Connections
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
|
||||
| `Protocol` | [components.PlexDeviceProtocol](../../models/components/plexdeviceprotocol.md) | :heavy_check_mark: | The protocol used for the connection (http, https, etc) | http |
|
||||
| `Address` | *string* | :heavy_check_mark: | The (ip) address or domain name used for the connection | |
|
||||
| `Port` | *int* | :heavy_check_mark: | The port used for the connection | |
|
||||
| `URI` | *string* | :heavy_check_mark: | The full URI of the connection | |
|
||||
| `Local` | *bool* | :heavy_check_mark: | If the connection is local address | |
|
||||
| `Relay` | *bool* | :heavy_check_mark: | If the connection is relayed through plex.direct | |
|
||||
| `IPv6` | *bool* | :heavy_check_mark: | If the connection is using IPv6 | |
|
||||
13
docs/models/components/defaultaudioaccessibility.md
Normal file
13
docs/models/components/defaultaudioaccessibility.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# DefaultAudioAccessibility
|
||||
|
||||
The audio accessibility mode (0 = Prefer non-accessibility audio, 1 = Prefer accessibility audio, 2 = Only show accessibility audio, 3 = Only show non-accessibility audio)
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ------------------------------------------------- | ------------------------------------------------- |
|
||||
| `DefaultAudioAccessibilityPreferNonAccessibility` | 0 |
|
||||
| `DefaultAudioAccessibilityPreferAccessibility` | 1 |
|
||||
| `DefaultAudioAccessibilityOnlyAccessibility` | 2 |
|
||||
| `DefaultAudioAccessibilityOnlyNonAccessibility` | 3 |
|
||||
13
docs/models/components/defaultsubtitleaccessibility.md
Normal file
13
docs/models/components/defaultsubtitleaccessibility.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# DefaultSubtitleAccessibility
|
||||
|
||||
The subtitles for the deaf or hard-of-hearing (SDH) searches mode (0 = Prefer non-SDH subtitles, 1 = Prefer SDH subtitles, 2 = Only show SDH subtitles, 3 = Only show non-SDH subtitles)
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ------------------------------------------ | ------------------------------------------ |
|
||||
| `DefaultSubtitleAccessibilityPreferNonSdh` | 0 |
|
||||
| `DefaultSubtitleAccessibilityPreferSdh` | 1 |
|
||||
| `DefaultSubtitleAccessibilityOnlySdh` | 2 |
|
||||
| `DefaultSubtitleAccessibilityOnlyNonSdh` | 3 |
|
||||
13
docs/models/components/defaultsubtitleforced.md
Normal file
13
docs/models/components/defaultsubtitleforced.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# DefaultSubtitleForced
|
||||
|
||||
The forced subtitles searches mode (0 = Prefer non-forced subtitles, 1 = Prefer forced subtitles, 2 = Only show forced subtitles, 3 = Only show non-forced subtitles)
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| -------------------------------------- | -------------------------------------- |
|
||||
| `DefaultSubtitleForcedPreferNonForced` | 0 |
|
||||
| `DefaultSubtitleForcedPreferForced` | 1 |
|
||||
| `DefaultSubtitleForcedOnlyForced` | 2 |
|
||||
| `DefaultSubtitleForcedOnlyNonForced` | 3 |
|
||||
8
docs/models/components/guids.md
Normal file
8
docs/models/components/guids.md
Normal file
@@ -0,0 +1,8 @@
|
||||
# Guids
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ID` | *string* | :heavy_check_mark: | The unique identifier for the Guid. Can be prefixed with imdb://, tmdb://, tvdb://<br/> | {<br/>"imdbExample": {<br/>"summary": "IMDB example",<br/>"value": "imdb://tt13015952"<br/>},<br/>"tmdbExample": {<br/>"summary": "TMDB example",<br/>"value": "tmdb://2434012"<br/>},<br/>"tvdbExample": {<br/>"summary": "TVDB example",<br/>"value": "tvdb://7945991"<br/>}<br/>} |
|
||||
@@ -10,74 +10,78 @@ Metadata items can often live in a hierarchy with relationships between them. F
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Title` | *any* | :heavy_minus_sign: | The title of the item (e.g. “300” or “The Simpsons”) |
|
||||
| `Type` | *any* | :heavy_minus_sign: | The type of the video item, such as `movie`, `episode`, or `clip`. |
|
||||
| `AbsoluteIndex` | **int64* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. |
|
||||
| `AddedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was added to the library. |
|
||||
| `Art` | *any* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. |
|
||||
| `AudienceRating` | **float64* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings |
|
||||
| `AudienceRatingImage` | *any* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Banner` | *any* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. |
|
||||
| `ChapterSource` | *any* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). |
|
||||
| `Composite` | *any* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). |
|
||||
| `ContentRating` | *any* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent |
|
||||
| `GUID` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Hero` | *any* | :heavy_minus_sign: | When present, the URL for a hero image for the item. |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A |
|
||||
| `Index` | **int64* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. |
|
||||
| `Key` | *any* | :heavy_minus_sign: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | When a user has watched or listened to an item, this contains a timestamp (epoch seconds) for that last consumption time. |
|
||||
| `LeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. |
|
||||
| `Media` | [][components.Media](../../models/components/media.md) | :heavy_minus_sign: | N/A |
|
||||
| `OriginallyAvailableAt` | *any* | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. |
|
||||
| `OriginalTitle` | *any* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent |
|
||||
| `ParentIndex` | **int64* | :heavy_minus_sign: | The `index` of the parent |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent |
|
||||
| `PrimaryExtraKey` | *any* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) |
|
||||
| `Rating` | **float64* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `RatingCount` | **int64* | :heavy_minus_sign: | Number of ratings under this metadata |
|
||||
| `RatingImage` | *any* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. |
|
||||
| `RatingKey` | *any* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Studio` | *any* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). |
|
||||
| `Subtype` | *any* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library |
|
||||
| `Summary` | *any* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). |
|
||||
| `Tagline` | *any* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). |
|
||||
| `Theme` | *any* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). |
|
||||
| `Thumb` | *any* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. |
|
||||
| `TitleSort` | *any* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). |
|
||||
| `UserRating` | **float64* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating |
|
||||
| `ViewCount` | **int64* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. |
|
||||
| `ViewedLeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. |
|
||||
| `ViewOffset` | **int64* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Year` | **int64* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). |
|
||||
| `MetadataItem` | [][components.Items](../../models/components/items.md) | :heavy_minus_sign: | N/A |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Title` | *string* | :heavy_check_mark: | The title of the item (e.g. “300” or “The Simpsons”) | |
|
||||
| `Type` | *string* | :heavy_check_mark: | The type of the video item, such as `movie`, `episode`, or `clip`. | |
|
||||
| `AbsoluteIndex` | **int* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. | |
|
||||
| `AddedAt` | *int64* | :heavy_check_mark: | In units of seconds since the epoch, returns the time at which the item was added to the library. | |
|
||||
| `Art` | **string* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. | /library/metadata/58683/art/1703239236 |
|
||||
| `AudienceRating` | **float32* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings | |
|
||||
| `AudienceRatingImage` | **string* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). | |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Banner` | **string* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. | |
|
||||
| `ChapterSource` | **string* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). | media |
|
||||
| `ChildCount` | **int* | :heavy_minus_sign: | The number of child items associated with this media item. | 1 |
|
||||
| `Composite` | **string* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). | |
|
||||
| `ContentRating` | **string* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. | |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. | |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent | |
|
||||
| `GrandparentGUID` | **string* | :heavy_minus_sign: | The GUID of the grandparent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent | |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent | |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent | |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent | |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent | |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent | |
|
||||
| `GUID` | **string* | :heavy_minus_sign: | The globally unique identifier for the media item. | plex://movie/5d7768ba96b655001fdc0408 |
|
||||
| `Guids` | [][components.ItemsGuids](../../models/components/itemsguids.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Hero` | **string* | :heavy_minus_sign: | When present, the URL for a hero image for the item. | |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Index` | **int* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. | |
|
||||
| `Key` | *string* | :heavy_check_mark: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. | |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `LeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. | |
|
||||
| `Media` | [][components.Media](../../models/components/media.md) | :heavy_minus_sign: | N/A | |
|
||||
| `OriginallyAvailableAt` | [*types.Date](../../types/date.md) | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. | 2022-12-14 |
|
||||
| `OriginalTitle` | **string* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. | |
|
||||
| `ParentGUID` | **string* | :heavy_minus_sign: | The GUID of the parent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent | |
|
||||
| `ParentIndex` | **int* | :heavy_minus_sign: | The `index` of the parent | |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent | |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent | |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent | |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent | |
|
||||
| `PrimaryExtraKey` | **string* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. | |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) | |
|
||||
| `Rating` | **float32* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. | |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `RatingCount` | **int* | :heavy_minus_sign: | Number of ratings under this metadata | |
|
||||
| `RatingImage` | **string* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. | |
|
||||
| `RatingKey` | **string* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. | |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory | |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. | |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. | |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). | |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Studio` | **string* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). | |
|
||||
| `Subtype` | **string* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library | |
|
||||
| `Summary` | **string* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). | |
|
||||
| `Tagline` | **string* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). | |
|
||||
| `Theme` | **string* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). | /library/metadata/1/theme/1705636920 |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. | /library/metadata/58683/thumb/1703239236 |
|
||||
| `TitleSort` | **string* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). | |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). | |
|
||||
| `UserRating` | **float32* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating | |
|
||||
| `ViewCount` | **int* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. | |
|
||||
| `ViewedLeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. | |
|
||||
| `ViewOffset` | **int* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. | |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Year` | **int* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). | |
|
||||
| `MetadataItem` | [][components.Items](../../models/components/items.md) | :heavy_minus_sign: | N/A | |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
8
docs/models/components/itemsguids.md
Normal file
8
docs/models/components/itemsguids.md
Normal file
@@ -0,0 +1,8 @@
|
||||
# ItemsGuids
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ID` | *string* | :heavy_check_mark: | The unique identifier for the Guid. Can be prefixed with imdb://, tmdb://, tvdb://<br/> | {<br/>"imdbExample": {<br/>"summary": "IMDB example",<br/>"value": "imdb://tt13015952"<br/>},<br/>"tmdbExample": {<br/>"summary": "TMDB example",<br/>"value": "tmdb://2434012"<br/>},<br/>"tvdbExample": {<br/>"summary": "TVDB example",<br/>"value": "tvdb://7945991"<br/>}<br/>} |
|
||||
@@ -3,25 +3,26 @@
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
| ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
||||
| `Title` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `Type` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `Agent` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `AllowSync` | **bool* | :heavy_minus_sign: | N/A |
|
||||
| `Art` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `Composite` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `Content` | **bool* | :heavy_minus_sign: | N/A |
|
||||
| `ContentChangedAt` | **int64* | :heavy_minus_sign: | N/A |
|
||||
| `CreatedAt` | **int64* | :heavy_minus_sign: | N/A |
|
||||
| `Directory` | **bool* | :heavy_minus_sign: | N/A |
|
||||
| `Filters` | **bool* | :heavy_minus_sign: | Indicates whether this section has filtering capabilities |
|
||||
| `Hidden` | **bool* | :heavy_minus_sign: | N/A |
|
||||
| `Key` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `Language` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `Location` | [][components.LibrarySectionLocation](../../models/components/librarysectionlocation.md) | :heavy_minus_sign: | N/A |
|
||||
| `Refreshing` | **bool* | :heavy_minus_sign: | Indicates whether this library section is currently scanning |
|
||||
| `ScannedAt` | **int64* | :heavy_minus_sign: | N/A |
|
||||
| `Scanner` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | N/A |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | N/A |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
|
||||
| `Title` | **string* | :heavy_minus_sign: | The title of the library | Movies |
|
||||
| `Type` | [components.MediaTypeString](../../models/components/mediatypestring.md) | :heavy_check_mark: | The type of media content in the Plex library. This can represent videos, music, or photos.<br/> | movie |
|
||||
| `Agent` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `AllowSync` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
| `Art` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `Composite` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `Content` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
| `ContentChangedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `CreatedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `Directory` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
| `Filters` | **bool* | :heavy_minus_sign: | Indicates whether this section has filtering capabilities | |
|
||||
| `Hidden` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
| `Key` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `Language` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `UUID` | *string* | :heavy_check_mark: | The universally unique identifier for the library. | e69655a2-ef48-4aba-bb19-d3cc3401e7d6 |
|
||||
| `Location` | [][components.LibrarySectionLocation](../../models/components/librarysectionlocation.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Refreshing` | **bool* | :heavy_minus_sign: | Indicates whether this library section is currently scanning | |
|
||||
| `ScannedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `Scanner` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
12
docs/models/components/mailingliststatus.md
Normal file
12
docs/models/components/mailingliststatus.md
Normal file
@@ -0,0 +1,12 @@
|
||||
# MailingListStatus
|
||||
|
||||
Your current mailing list status
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ------------------------------- | ------------------------------- |
|
||||
| `MailingListStatusActive` | active |
|
||||
| `MailingListStatusUnsubscribed` | unsubscribed |
|
||||
| `MailingListStatusRemoved` | removed |
|
||||
@@ -8,22 +8,22 @@
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ---------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------- |
|
||||
| `AspectRatio` | **float64* | :heavy_minus_sign: | N/A | 2.35 |
|
||||
| `AudioChannels` | **int64* | :heavy_minus_sign: | N/A | 2 |
|
||||
| `AudioCodec` | *any* | :heavy_minus_sign: | N/A | aac |
|
||||
| `AudioProfile` | *any* | :heavy_minus_sign: | N/A | lc |
|
||||
| `Bitrate` | **int64* | :heavy_minus_sign: | N/A | 5612 |
|
||||
| `Container` | *any* | :heavy_minus_sign: | N/A | mov |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | N/A | 150192 |
|
||||
| `AspectRatio` | **float32* | :heavy_minus_sign: | N/A | 2.35 |
|
||||
| `AudioChannels` | **int* | :heavy_minus_sign: | N/A | 2 |
|
||||
| `AudioCodec` | **string* | :heavy_minus_sign: | N/A | aac |
|
||||
| `AudioProfile` | **string* | :heavy_minus_sign: | N/A | lc |
|
||||
| `Bitrate` | **int* | :heavy_minus_sign: | N/A | 5612 |
|
||||
| `Container` | **string* | :heavy_minus_sign: | N/A | mov |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | N/A | 150192 |
|
||||
| `Has64bitOffsets` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `HasVoiceActivity` | **bool* | :heavy_minus_sign: | N/A | true |
|
||||
| `Height` | **int64* | :heavy_minus_sign: | N/A | 544 |
|
||||
| `ID` | **int64* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `Height` | **int* | :heavy_minus_sign: | N/A | 544 |
|
||||
| `ID` | *int64* | :heavy_check_mark: | N/A | 1 |
|
||||
| `OptimizedForStreaming` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `Part` | [][components.Part](../../models/components/part.md) | :heavy_minus_sign: | N/A | |
|
||||
| `VideoCodec` | *any* | :heavy_minus_sign: | N/A | h264 |
|
||||
| `VideoFrameRate` | *any* | :heavy_minus_sign: | N/A | 24p |
|
||||
| `VideoProfile` | *any* | :heavy_minus_sign: | N/A | main |
|
||||
| `VideoResolution` | *any* | :heavy_minus_sign: | N/A | 720 |
|
||||
| `Width` | **int64* | :heavy_minus_sign: | N/A | 1280 |
|
||||
| `VideoCodec` | **string* | :heavy_minus_sign: | N/A | h264 |
|
||||
| `VideoFrameRate` | **string* | :heavy_minus_sign: | N/A | 24p |
|
||||
| `VideoProfile` | **string* | :heavy_minus_sign: | N/A | main |
|
||||
| `VideoResolution` | **string* | :heavy_minus_sign: | N/A | 720 |
|
||||
| `Width` | **int* | :heavy_minus_sign: | N/A | 1280 |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
@@ -0,0 +1,8 @@
|
||||
# MediaContainerWithDecisionGuids
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ID` | *string* | :heavy_check_mark: | The unique identifier for the Guid. Can be prefixed with imdb://, tmdb://, tvdb://<br/> | {<br/>"imdbExample": {<br/>"summary": "IMDB example",<br/>"value": "imdb://tt13015952"<br/>},<br/>"tmdbExample": {<br/>"summary": "TMDB example",<br/>"value": "tmdb://2434012"<br/>},<br/>"tvdbExample": {<br/>"summary": "TVDB example",<br/>"value": "tvdb://7945991"<br/>}<br/>} |
|
||||
@@ -8,24 +8,24 @@
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
|
||||
| `AspectRatio` | **float64* | :heavy_minus_sign: | N/A | 2.35 |
|
||||
| `AudioChannels` | **int64* | :heavy_minus_sign: | N/A | 2 |
|
||||
| `AudioCodec` | *any* | :heavy_minus_sign: | N/A | aac |
|
||||
| `AudioProfile` | *any* | :heavy_minus_sign: | N/A | lc |
|
||||
| `Bitrate` | **int64* | :heavy_minus_sign: | N/A | 5612 |
|
||||
| `Container` | *any* | :heavy_minus_sign: | N/A | mov |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | N/A | 150192 |
|
||||
| `AspectRatio` | **float32* | :heavy_minus_sign: | N/A | 2.35 |
|
||||
| `AudioChannels` | **int* | :heavy_minus_sign: | N/A | 2 |
|
||||
| `AudioCodec` | **string* | :heavy_minus_sign: | N/A | aac |
|
||||
| `AudioProfile` | **string* | :heavy_minus_sign: | N/A | lc |
|
||||
| `Bitrate` | **int* | :heavy_minus_sign: | N/A | 5612 |
|
||||
| `Container` | **string* | :heavy_minus_sign: | N/A | mov |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | N/A | 150192 |
|
||||
| `Has64bitOffsets` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `HasVoiceActivity` | **bool* | :heavy_minus_sign: | N/A | true |
|
||||
| `Height` | **int64* | :heavy_minus_sign: | N/A | 544 |
|
||||
| `ID` | **int64* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `Height` | **int* | :heavy_minus_sign: | N/A | 544 |
|
||||
| `ID` | *int64* | :heavy_check_mark: | N/A | 1 |
|
||||
| `OptimizedForStreaming` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `Part` | [][components.MediaContainerWithDecisionPart](../../models/components/mediacontainerwithdecisionpart.md) | :heavy_minus_sign: | N/A | |
|
||||
| `VideoCodec` | *any* | :heavy_minus_sign: | N/A | h264 |
|
||||
| `VideoFrameRate` | *any* | :heavy_minus_sign: | N/A | 24p |
|
||||
| `VideoProfile` | *any* | :heavy_minus_sign: | N/A | main |
|
||||
| `VideoResolution` | *any* | :heavy_minus_sign: | N/A | 720 |
|
||||
| `Width` | **int64* | :heavy_minus_sign: | N/A | 1280 |
|
||||
| `VideoCodec` | **string* | :heavy_minus_sign: | N/A | h264 |
|
||||
| `VideoFrameRate` | **string* | :heavy_minus_sign: | N/A | 24p |
|
||||
| `VideoProfile` | **string* | :heavy_minus_sign: | N/A | main |
|
||||
| `VideoResolution` | **string* | :heavy_minus_sign: | N/A | 720 |
|
||||
| `Width` | **int* | :heavy_minus_sign: | N/A | 1280 |
|
||||
| `Abr` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
| `ResourceSession` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `Selected` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
|
||||
@@ -10,73 +10,77 @@ Metadata items can often live in a hierarchy with relationships between them. F
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Title` | *any* | :heavy_minus_sign: | The title of the item (e.g. “300” or “The Simpsons”) |
|
||||
| `Type` | *any* | :heavy_minus_sign: | The type of the video item, such as `movie`, `episode`, or `clip`. |
|
||||
| `AbsoluteIndex` | **int64* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. |
|
||||
| `AddedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was added to the library. |
|
||||
| `Art` | *any* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. |
|
||||
| `AudienceRating` | **float64* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings |
|
||||
| `AudienceRatingImage` | *any* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Banner` | *any* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. |
|
||||
| `ChapterSource` | *any* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). |
|
||||
| `Composite` | *any* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). |
|
||||
| `ContentRating` | *any* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent |
|
||||
| `GUID` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Hero` | *any* | :heavy_minus_sign: | When present, the URL for a hero image for the item. |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A |
|
||||
| `Index` | **int64* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. |
|
||||
| `Key` | *any* | :heavy_minus_sign: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | When a user has watched or listened to an item, this contains a timestamp (epoch seconds) for that last consumption time. |
|
||||
| `LeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. |
|
||||
| `Media` | [][components.MediaContainerWithDecisionMedia](../../models/components/mediacontainerwithdecisionmedia.md) | :heavy_minus_sign: | N/A |
|
||||
| `OriginallyAvailableAt` | *any* | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. |
|
||||
| `OriginalTitle` | *any* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent |
|
||||
| `ParentIndex` | **int64* | :heavy_minus_sign: | The `index` of the parent |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent |
|
||||
| `PrimaryExtraKey` | *any* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) |
|
||||
| `Rating` | **float64* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `RatingCount` | **int64* | :heavy_minus_sign: | Number of ratings under this metadata |
|
||||
| `RatingImage` | *any* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. |
|
||||
| `RatingKey` | *any* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Studio` | *any* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). |
|
||||
| `Subtype` | *any* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library |
|
||||
| `Summary` | *any* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). |
|
||||
| `Tagline` | *any* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). |
|
||||
| `Theme` | *any* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). |
|
||||
| `Thumb` | *any* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. |
|
||||
| `TitleSort` | *any* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). |
|
||||
| `UserRating` | **float64* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating |
|
||||
| `ViewCount` | **int64* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. |
|
||||
| `ViewedLeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. |
|
||||
| `ViewOffset` | **int64* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Year` | **int64* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Title` | *string* | :heavy_check_mark: | The title of the item (e.g. “300” or “The Simpsons”) | |
|
||||
| `Type` | *string* | :heavy_check_mark: | The type of the video item, such as `movie`, `episode`, or `clip`. | |
|
||||
| `AbsoluteIndex` | **int* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. | |
|
||||
| `AddedAt` | *int64* | :heavy_check_mark: | In units of seconds since the epoch, returns the time at which the item was added to the library. | |
|
||||
| `Art` | **string* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. | /library/metadata/58683/art/1703239236 |
|
||||
| `AudienceRating` | **float32* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings | |
|
||||
| `AudienceRatingImage` | **string* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). | |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Banner` | **string* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. | |
|
||||
| `ChapterSource` | **string* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). | media |
|
||||
| `ChildCount` | **int* | :heavy_minus_sign: | The number of child items associated with this media item. | 1 |
|
||||
| `Composite` | **string* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). | |
|
||||
| `ContentRating` | **string* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. | |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. | |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent | |
|
||||
| `GrandparentGUID` | **string* | :heavy_minus_sign: | The GUID of the grandparent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent | |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent | |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent | |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent | |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent | |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent | |
|
||||
| `GUID` | **string* | :heavy_minus_sign: | The globally unique identifier for the media item. | plex://movie/5d7768ba96b655001fdc0408 |
|
||||
| `Guids` | [][components.MediaContainerWithDecisionGuids](../../models/components/mediacontainerwithdecisionguids.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Hero` | **string* | :heavy_minus_sign: | When present, the URL for a hero image for the item. | |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Index` | **int* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. | |
|
||||
| `Key` | *string* | :heavy_check_mark: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. | |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `LeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. | |
|
||||
| `Media` | [][components.MediaContainerWithDecisionMedia](../../models/components/mediacontainerwithdecisionmedia.md) | :heavy_minus_sign: | N/A | |
|
||||
| `OriginallyAvailableAt` | [*types.Date](../../types/date.md) | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. | 2022-12-14 |
|
||||
| `OriginalTitle` | **string* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. | |
|
||||
| `ParentGUID` | **string* | :heavy_minus_sign: | The GUID of the parent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent | |
|
||||
| `ParentIndex` | **int* | :heavy_minus_sign: | The `index` of the parent | |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent | |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent | |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent | |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent | |
|
||||
| `PrimaryExtraKey` | **string* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. | |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) | |
|
||||
| `Rating` | **float32* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. | |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `RatingCount` | **int* | :heavy_minus_sign: | Number of ratings under this metadata | |
|
||||
| `RatingImage` | **string* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. | |
|
||||
| `RatingKey` | **string* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. | |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory | |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. | |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. | |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). | |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Studio` | **string* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). | |
|
||||
| `Subtype` | **string* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library | |
|
||||
| `Summary` | **string* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). | |
|
||||
| `Tagline` | **string* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). | |
|
||||
| `Theme` | **string* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). | /library/metadata/1/theme/1705636920 |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. | /library/metadata/58683/thumb/1703239236 |
|
||||
| `TitleSort` | **string* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). | |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). | |
|
||||
| `UserRating` | **float32* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating | |
|
||||
| `ViewCount` | **int* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. | |
|
||||
| `ViewedLeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. | |
|
||||
| `ViewOffset` | **int* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. | |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Year` | **int* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). | |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
@@ -8,17 +8,20 @@
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
|
||||
| `AudioProfile` | *any* | :heavy_minus_sign: | N/A | lc |
|
||||
| `Container` | *any* | :heavy_minus_sign: | The container of the media file, such as `mp4` or `mkv` | mov |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | The duration of the media item, in milliseconds | 150192 |
|
||||
| `File` | *any* | :heavy_minus_sign: | The local file path at which the part is stored on the server | /home/schuyler/Videos/Trailers/Cloud Atlas (2012).mov |
|
||||
| `Accessible` | **bool* | :heavy_minus_sign: | Indicates if the part is accessible. | true |
|
||||
| `AudioProfile` | **string* | :heavy_minus_sign: | N/A | lc |
|
||||
| `Container` | **string* | :heavy_minus_sign: | The container of the media file, such as `mp4` or `mkv` | mov |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | The duration of the media item, in milliseconds | 150192 |
|
||||
| `Exists` | **bool* | :heavy_minus_sign: | Indicates if the part exists. | true |
|
||||
| `File` | **string* | :heavy_minus_sign: | The local file path at which the part is stored on the server | /home/schuyler/Videos/Trailers/Cloud Atlas (2012).mov |
|
||||
| `Has64bitOffsets` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `ID` | **int64* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `Key` | *any* | :heavy_minus_sign: | The key from which the media can be streamed | /library/parts/1/1531779263/file.mov |
|
||||
| `ID` | *int64* | :heavy_check_mark: | N/A | 1 |
|
||||
| `Indexes` | **string* | :heavy_minus_sign: | N/A | sd |
|
||||
| `Key` | *string* | :heavy_check_mark: | The key from which the media can be streamed | /library/parts/1/1531779263/file.mov |
|
||||
| `OptimizedForStreaming` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `Size` | **int64* | :heavy_minus_sign: | The size of the media, in bytes | 105355654 |
|
||||
| `Stream` | [][components.MediaContainerWithDecisionStream](../../models/components/mediacontainerwithdecisionstream.md) | :heavy_minus_sign: | N/A | |
|
||||
| `VideoProfile` | *any* | :heavy_minus_sign: | N/A | main |
|
||||
| `VideoProfile` | **string* | :heavy_minus_sign: | N/A | main |
|
||||
| `Decision` | [*components.Decision](../../models/components/decision.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Selected` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
@@ -6,37 +6,60 @@
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `Default` | **bool* | :heavy_minus_sign: | N/A | true |
|
||||
| `AudioChannelLayout` | *any* | :heavy_minus_sign: | N/A | stereo |
|
||||
| `BitDepth` | **int64* | :heavy_minus_sign: | N/A | 8 |
|
||||
| `Bitrate` | **int64* | :heavy_minus_sign: | N/A | 5466 |
|
||||
| `CanAutoSync` | **bool* | :heavy_minus_sign: | For subtitle streams only. If `true` then the server can attempt to automatically sync the subtitle timestamps with the video. | true |
|
||||
| `ChromaLocation` | *any* | :heavy_minus_sign: | N/A | topleft |
|
||||
| `ChromaSubsampling` | *any* | :heavy_minus_sign: | N/A | 4:2:0 |
|
||||
| `Codec` | *any* | :heavy_minus_sign: | The codec of the stream, such as `h264` or `aac` | h264 |
|
||||
| `ColorPrimaries` | *any* | :heavy_minus_sign: | N/A | bt709 |
|
||||
| `ColorRange` | *any* | :heavy_minus_sign: | N/A | tv |
|
||||
| `ColorSpace` | *any* | :heavy_minus_sign: | N/A | bt709 |
|
||||
| `ColorTrc` | *any* | :heavy_minus_sign: | N/A | bt709 |
|
||||
| `DisplayTitle` | *any* | :heavy_minus_sign: | A friendly name for the stream, often comprised of the language and codec information | English (H.264 Main) |
|
||||
| `FrameRate` | **float64* | :heavy_minus_sign: | N/A | 23.976 |
|
||||
| `HasScalingMatrix` | *any* | :heavy_minus_sign: | N/A | false |
|
||||
| `Height` | **int64* | :heavy_minus_sign: | N/A | 544 |
|
||||
| `ID` | **int64* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `Index` | **int64* | :heavy_minus_sign: | If the stream is part of the `Part` and not an external resource, the index of the stream within that part | 0 |
|
||||
| `Key` | *any* | :heavy_minus_sign: | If the stream is independently streamable, the key from which it can be streamed | /library/streams/1 |
|
||||
| `Language` | *any* | :heavy_minus_sign: | N/A | English |
|
||||
| `LanguageCode` | *any* | :heavy_minus_sign: | The three character language code for the stream contents | eng |
|
||||
| `Level` | **int64* | :heavy_minus_sign: | N/A | 31 |
|
||||
| `Profile` | *any* | :heavy_minus_sign: | N/A | main |
|
||||
| `RefFrames` | **int64* | :heavy_minus_sign: | N/A | 2 |
|
||||
| `SamplingRate` | **int64* | :heavy_minus_sign: | N/A | 48000 |
|
||||
| `Selected` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
| `StreamIdentifier` | **int64* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `StreamType` | **int64* | :heavy_minus_sign: | A number indicating the type of the stream. `1` for video, `2` for audio, `3` for subtitles, `4` for lyrics | 1 |
|
||||
| `Width` | **int64* | :heavy_minus_sign: | N/A | 1280 |
|
||||
| `Decision` | [*components.MediaContainerWithDecisionDecision](../../models/components/mediacontainerwithdecisiondecision.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Location` | [*components.MediaContainerWithDecisionLocation](../../models/components/mediacontainerwithdecisionlocation.md) | :heavy_minus_sign: | N/A | |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
|
||||
| `Default` | **bool* | :heavy_minus_sign: | Indicates if this stream is default. | true |
|
||||
| `AudioChannelLayout` | **string* | :heavy_minus_sign: | Audio channel layout. | 5.1(side) |
|
||||
| `Channels` | **int* | :heavy_minus_sign: | Number of audio channels (for audio streams). | 6 |
|
||||
| `BitDepth` | **int* | :heavy_minus_sign: | Bit depth of the video stream. | 10 |
|
||||
| `DOVIBLCompatID` | **int* | :heavy_minus_sign: | Dolby Vision BL compatibility ID. | 1 |
|
||||
| `DOVIBLPresent` | **bool* | :heavy_minus_sign: | Indicates if Dolby Vision BL is present. | true |
|
||||
| `DOVIELPresent` | **bool* | :heavy_minus_sign: | Indicates if Dolby Vision EL is present. | false |
|
||||
| `DOVILevel` | **int* | :heavy_minus_sign: | Dolby Vision level. | 6 |
|
||||
| `DOVIPresent` | **bool* | :heavy_minus_sign: | Indicates if Dolby Vision is present. | true |
|
||||
| `DOVIProfile` | **int* | :heavy_minus_sign: | Dolby Vision profile. | 8 |
|
||||
| `DOVIRPUPresent` | **bool* | :heavy_minus_sign: | Indicates if Dolby Vision RPU is present. | true |
|
||||
| `DOVIVersion` | **string* | :heavy_minus_sign: | Dolby Vision version. | 1.0 |
|
||||
| `Bitrate` | **int* | :heavy_minus_sign: | Bitrate of the stream. | 24743 |
|
||||
| `CanAutoSync` | **bool* | :heavy_minus_sign: | Indicates if the stream can auto-sync. | false |
|
||||
| `ChromaLocation` | **string* | :heavy_minus_sign: | Chroma sample location. | topleft |
|
||||
| `ChromaSubsampling` | **string* | :heavy_minus_sign: | Chroma subsampling format. | 4:2:0 |
|
||||
| `CodedHeight` | **int* | :heavy_minus_sign: | Coded video height. | 1608 |
|
||||
| `CodedWidth` | **int* | :heavy_minus_sign: | Coded video width. | 3840 |
|
||||
| `ClosedCaptions` | **bool* | :heavy_minus_sign: | N/A | true |
|
||||
| `Codec` | *string* | :heavy_check_mark: | Codec used by the stream. | hevc |
|
||||
| `ColorPrimaries` | **string* | :heavy_minus_sign: | Color primaries used. | bt2020 |
|
||||
| `ColorRange` | **string* | :heavy_minus_sign: | Color range (e.g., tv). | tv |
|
||||
| `ColorSpace` | **string* | :heavy_minus_sign: | Color space. | bt2020nc |
|
||||
| `ColorTrc` | **string* | :heavy_minus_sign: | Color transfer characteristics. | smpte2084 |
|
||||
| `DisplayTitle` | *string* | :heavy_check_mark: | Display title for the stream. | 4K DoVi/HDR10 (HEVC Main 10) |
|
||||
| `ExtendedDisplayTitle` | **string* | :heavy_minus_sign: | Extended display title for the stream. | 4K DoVi/HDR10 (HEVC Main 10) |
|
||||
| `FrameRate` | **float32* | :heavy_minus_sign: | Frame rate of the stream. | 23.976 |
|
||||
| `HasScalingMatrix` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `Height` | **int* | :heavy_minus_sign: | Height of the video stream. | 1602 |
|
||||
| `ID` | *int* | :heavy_check_mark: | Unique stream identifier. | 1002625 |
|
||||
| `Index` | **int* | :heavy_minus_sign: | Index of the stream. | 0 |
|
||||
| `Key` | *string* | :heavy_check_mark: | Key to access this stream part. | /library/streams/216389 |
|
||||
| `Language` | **string* | :heavy_minus_sign: | Language of the stream. | English |
|
||||
| `LanguageCode` | **string* | :heavy_minus_sign: | ISO language code. | eng |
|
||||
| `LanguageTag` | **string* | :heavy_minus_sign: | Language tag (e.g., en). | en |
|
||||
| `Format` | **string* | :heavy_minus_sign: | Format of the stream (e.g., srt). | srt |
|
||||
| `HeaderCompression` | **bool* | :heavy_minus_sign: | Indicates whether header compression is enabled. | true |
|
||||
| `Level` | **int* | :heavy_minus_sign: | Video level. | 150 |
|
||||
| `Original` | **bool* | :heavy_minus_sign: | Indicates if this is the original stream. | true |
|
||||
| `Profile` | **string* | :heavy_minus_sign: | Video profile. | main 10 |
|
||||
| `RefFrames` | **int* | :heavy_minus_sign: | Number of reference frames. | 1 |
|
||||
| `SamplingRate` | **int* | :heavy_minus_sign: | Sampling rate for the audio stream. | 48000 |
|
||||
| `ScanType` | **string* | :heavy_minus_sign: | N/A | progressive |
|
||||
| `EmbeddedInVideo` | **string* | :heavy_minus_sign: | N/A | progressive |
|
||||
| `Selected` | **bool* | :heavy_minus_sign: | Indicates if this stream is selected (applicable for audio streams). | true |
|
||||
| `Forced` | **bool* | :heavy_minus_sign: | N/A | true |
|
||||
| `HearingImpaired` | **bool* | :heavy_minus_sign: | Indicates if the stream is for the hearing impaired. | true |
|
||||
| `Dub` | **bool* | :heavy_minus_sign: | Indicates if the stream is a dub. | true |
|
||||
| `Title` | **string* | :heavy_minus_sign: | Optional title for the stream (e.g., language variant). | SDH |
|
||||
| `StreamIdentifier` | **int* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `StreamType` | *int64* | :heavy_check_mark: | Stream type:<br/> - VIDEO = 1<br/> - AUDIO = 2<br/> - SUBTITLE = 3<br/> | |
|
||||
| `Width` | **int* | :heavy_minus_sign: | Width of the video stream. | 3840 |
|
||||
| `Decision` | [*components.MediaContainerWithDecisionDecision](../../models/components/mediacontainerwithdecisiondecision.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Location` | [*components.MediaContainerWithDecisionLocation](../../models/components/mediacontainerwithdecisionlocation.md) | :heavy_minus_sign: | N/A | |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
@@ -0,0 +1,8 @@
|
||||
# MediaContainerWithNestedMetadataGuids
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ID` | *string* | :heavy_check_mark: | The unique identifier for the Guid. Can be prefixed with imdb://, tmdb://, tvdb://<br/> | {<br/>"imdbExample": {<br/>"summary": "IMDB example",<br/>"value": "imdb://tt13015952"<br/>},<br/>"tmdbExample": {<br/>"summary": "TMDB example",<br/>"value": "tmdb://2434012"<br/>},<br/>"tvdbExample": {<br/>"summary": "TVDB example",<br/>"value": "tvdb://7945991"<br/>}<br/>} |
|
||||
@@ -0,0 +1,8 @@
|
||||
# MediaContainerWithPlaylistMetadataGuids
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ID` | *string* | :heavy_check_mark: | The unique identifier for the Guid. Can be prefixed with imdb://, tmdb://, tvdb://<br/> | {<br/>"imdbExample": {<br/>"summary": "IMDB example",<br/>"value": "imdb://tt13015952"<br/>},<br/>"tmdbExample": {<br/>"summary": "TMDB example",<br/>"value": "tmdb://2434012"<br/>},<br/>"tvdbExample": {<br/>"summary": "TVDB example",<br/>"value": "tvdb://7945991"<br/>}<br/>} |
|
||||
@@ -10,77 +10,81 @@ Metadata items can often live in a hierarchy with relationships between them. F
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ReadOnly` | **bool* | :heavy_minus_sign: | If we return this as true then this playlist cannot be altered or deleted directly by the client. |
|
||||
| `Composite` | *any* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. |
|
||||
| `Key` | *any* | :heavy_minus_sign: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. |
|
||||
| `LeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. |
|
||||
| `PlaylistType` | [*components.PlaylistType](../../models/components/playlisttype.md) | :heavy_minus_sign: | The type of the playlist. |
|
||||
| `Smart` | **bool* | :heavy_minus_sign: | Whether or not the playlist is smart. |
|
||||
| `SpecialPlaylistType` | **string* | :heavy_minus_sign: | If this is a special playlist, this returns its type (e.g. favorites). |
|
||||
| `Title` | *any* | :heavy_minus_sign: | The title of the item (e.g. “300” or “The Simpsons”) |
|
||||
| `Type` | *any* | :heavy_minus_sign: | The type of the video item, such as `movie`, `episode`, or `clip`. |
|
||||
| `AbsoluteIndex` | **int64* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. |
|
||||
| `AddedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was added to the library. |
|
||||
| `Art` | *any* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. |
|
||||
| `AudienceRating` | **float64* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings |
|
||||
| `AudienceRatingImage` | *any* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Banner` | *any* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. |
|
||||
| `ChapterSource` | *any* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). |
|
||||
| `ContentRating` | *any* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent |
|
||||
| `GUID` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Hero` | *any* | :heavy_minus_sign: | When present, the URL for a hero image for the item. |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A |
|
||||
| `Index` | **int64* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | When a user has watched or listened to an item, this contains a timestamp (epoch seconds) for that last consumption time. |
|
||||
| `Media` | [][components.Media](../../models/components/media.md) | :heavy_minus_sign: | N/A |
|
||||
| `OriginallyAvailableAt` | *any* | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. |
|
||||
| `OriginalTitle` | *any* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent |
|
||||
| `ParentIndex` | **int64* | :heavy_minus_sign: | The `index` of the parent |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent |
|
||||
| `PrimaryExtraKey` | *any* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) |
|
||||
| `Rating` | **float64* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `RatingCount` | **int64* | :heavy_minus_sign: | Number of ratings under this metadata |
|
||||
| `RatingImage` | *any* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. |
|
||||
| `RatingKey` | *any* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Studio` | *any* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). |
|
||||
| `Subtype` | *any* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library |
|
||||
| `Summary` | *any* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). |
|
||||
| `Tagline` | *any* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). |
|
||||
| `Theme` | *any* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). |
|
||||
| `Thumb` | *any* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. |
|
||||
| `TitleSort` | *any* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). |
|
||||
| `UserRating` | **float64* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating |
|
||||
| `ViewCount` | **int64* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. |
|
||||
| `ViewedLeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. |
|
||||
| `ViewOffset` | **int64* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Year` | **int64* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ReadOnly` | **bool* | :heavy_minus_sign: | If we return this as true then this playlist cannot be altered or deleted directly by the client. | |
|
||||
| `Composite` | **string* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). | |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. | |
|
||||
| `Key` | *string* | :heavy_check_mark: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. | |
|
||||
| `LeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. | |
|
||||
| `PlaylistType` | [*components.PlaylistType](../../models/components/playlisttype.md) | :heavy_minus_sign: | The type of the playlist. | |
|
||||
| `Smart` | **bool* | :heavy_minus_sign: | Whether or not the playlist is smart. | |
|
||||
| `SpecialPlaylistType` | **string* | :heavy_minus_sign: | If this is a special playlist, this returns its type (e.g. favorites). | |
|
||||
| `Title` | *string* | :heavy_check_mark: | The title of the item (e.g. “300” or “The Simpsons”) | |
|
||||
| `Type` | *string* | :heavy_check_mark: | The type of the video item, such as `movie`, `episode`, or `clip`. | |
|
||||
| `AbsoluteIndex` | **int* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. | |
|
||||
| `AddedAt` | *int64* | :heavy_check_mark: | In units of seconds since the epoch, returns the time at which the item was added to the library. | |
|
||||
| `Art` | **string* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. | /library/metadata/58683/art/1703239236 |
|
||||
| `AudienceRating` | **float32* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings | |
|
||||
| `AudienceRatingImage` | **string* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). | |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Banner` | **string* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. | |
|
||||
| `ChapterSource` | **string* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). | media |
|
||||
| `ChildCount` | **int* | :heavy_minus_sign: | The number of child items associated with this media item. | 1 |
|
||||
| `ContentRating` | **string* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. | |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent | |
|
||||
| `GrandparentGUID` | **string* | :heavy_minus_sign: | The GUID of the grandparent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent | |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent | |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent | |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent | |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent | |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent | |
|
||||
| `GUID` | **string* | :heavy_minus_sign: | The globally unique identifier for the media item. | plex://movie/5d7768ba96b655001fdc0408 |
|
||||
| `Guids` | [][components.MediaContainerWithPlaylistMetadataGuids](../../models/components/mediacontainerwithplaylistmetadataguids.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Hero` | **string* | :heavy_minus_sign: | When present, the URL for a hero image for the item. | |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Index` | **int* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. | |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `Media` | [][components.Media](../../models/components/media.md) | :heavy_minus_sign: | N/A | |
|
||||
| `OriginallyAvailableAt` | [*types.Date](../../types/date.md) | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. | 2022-12-14 |
|
||||
| `OriginalTitle` | **string* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. | |
|
||||
| `ParentGUID` | **string* | :heavy_minus_sign: | The GUID of the parent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent | |
|
||||
| `ParentIndex` | **int* | :heavy_minus_sign: | The `index` of the parent | |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent | |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent | |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent | |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent | |
|
||||
| `PrimaryExtraKey` | **string* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. | |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) | |
|
||||
| `Rating` | **float32* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. | |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `RatingCount` | **int* | :heavy_minus_sign: | Number of ratings under this metadata | |
|
||||
| `RatingImage` | **string* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. | |
|
||||
| `RatingKey` | **string* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. | |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory | |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. | |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. | |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). | |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Studio` | **string* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). | |
|
||||
| `Subtype` | **string* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library | |
|
||||
| `Summary` | **string* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). | |
|
||||
| `Tagline` | **string* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). | |
|
||||
| `Theme` | **string* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). | /library/metadata/1/theme/1705636920 |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. | /library/metadata/58683/thumb/1703239236 |
|
||||
| `TitleSort` | **string* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). | |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). | |
|
||||
| `UserRating` | **float32* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating | |
|
||||
| `ViewCount` | **int* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. | |
|
||||
| `ViewedLeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. | |
|
||||
| `ViewOffset` | **int* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. | |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Year` | **int* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). | |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
@@ -1,7 +1,17 @@
|
||||
# MediaQuery
|
||||
|
||||
A querystring-based filtering language used to select subsets of media. When provided as an object, properties are serialized as a querystring using form style with explode.
|
||||
|
||||
Only the defined properties below are allowed. The object serializes to a querystring format like: `type=4&sourceType=2&sort=duration:desc,index`
|
||||
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
| ----------- | ----------- | ----------- | ----------- |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Type` | [*components.MediaType](../../models/components/mediatype.md) | :heavy_minus_sign: | The type of media to retrieve or filter by.<br/><br/>1 = movie<br/>2 = show<br/>3 = season<br/>4 = episode<br/>5 = artist<br/>6 = album<br/>7 = track<br/>8 = photo_album<br/>9 = photo<br/><br/>E.g. A movie library will not return anything with type 3 as there are no seasons for movie libraries<br/> | 2 |
|
||||
| `SourceType` | **int64* | :heavy_minus_sign: | Change the default level to which fields refer (used with type for hierarchical queries) | |
|
||||
| `Sort` | **string* | :heavy_minus_sign: | Field(s) to sort by, with optional modifiers. Use comma to separate multiple fields, and :desc or :nullsLast for modifiers (e.g., "duration:desc,index") | |
|
||||
| `Group` | **string* | :heavy_minus_sign: | Field to group results by (similar to SQL GROUP BY) | |
|
||||
| `Limit` | **int64* | :heavy_minus_sign: | Maximum number of results to return | |
|
||||
13
docs/models/components/mediareviewsvisibility.md
Normal file
13
docs/models/components/mediareviewsvisibility.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# MediaReviewsVisibility
|
||||
|
||||
Whether or not the account has media reviews visibility enabled
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ------------------------------------------- | ------------------------------------------- |
|
||||
| `MediaReviewsVisibilityNoOne` | 0 |
|
||||
| `MediaReviewsVisibilityCriticsOnly` | 1 |
|
||||
| `MediaReviewsVisibilityPlexUsersOnly` | 2 |
|
||||
| `MediaReviewsVisibilityPlexUsersAndCritics` | 3 |
|
||||
31
docs/models/components/mediatype.md
Normal file
31
docs/models/components/mediatype.md
Normal file
@@ -0,0 +1,31 @@
|
||||
# MediaType
|
||||
|
||||
The type of media to retrieve or filter by.
|
||||
|
||||
1 = movie
|
||||
2 = show
|
||||
3 = season
|
||||
4 = episode
|
||||
5 = artist
|
||||
6 = album
|
||||
7 = track
|
||||
8 = photo_album
|
||||
9 = photo
|
||||
|
||||
E.g. A movie library will not return anything with type 3 as there are no seasons for movie libraries
|
||||
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| --------------------- | --------------------- |
|
||||
| `MediaTypeMovie` | 1 |
|
||||
| `MediaTypeTvShow` | 2 |
|
||||
| `MediaTypeSeason` | 3 |
|
||||
| `MediaTypeEpisode` | 4 |
|
||||
| `MediaTypeArtist` | 5 |
|
||||
| `MediaTypeAlbum` | 6 |
|
||||
| `MediaTypeTrack` | 7 |
|
||||
| `MediaTypePhotoAlbum` | 8 |
|
||||
| `MediaTypePhoto` | 9 |
|
||||
20
docs/models/components/mediatypestring.md
Normal file
20
docs/models/components/mediatypestring.md
Normal file
@@ -0,0 +1,20 @@
|
||||
# MediaTypeString
|
||||
|
||||
The type of media content in the Plex library. This can represent videos, music, or photos.
|
||||
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| --------------------------- | --------------------------- |
|
||||
| `MediaTypeStringMovie` | movie |
|
||||
| `MediaTypeStringTvShow` | show |
|
||||
| `MediaTypeStringSeason` | season |
|
||||
| `MediaTypeStringEpisode` | episode |
|
||||
| `MediaTypeStringArtist` | artist |
|
||||
| `MediaTypeStringAlbum` | album |
|
||||
| `MediaTypeStringTrack` | track |
|
||||
| `MediaTypeStringPhotoAlbum` | photoalbum |
|
||||
| `MediaTypeStringPhoto` | photo |
|
||||
| `MediaTypeStringCollection` | collection |
|
||||
@@ -10,73 +10,77 @@ Metadata items can often live in a hierarchy with relationships between them. F
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Title` | *any* | :heavy_minus_sign: | The title of the item (e.g. “300” or “The Simpsons”) |
|
||||
| `Type` | *any* | :heavy_minus_sign: | The type of the video item, such as `movie`, `episode`, or `clip`. |
|
||||
| `AbsoluteIndex` | **int64* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. |
|
||||
| `AddedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was added to the library. |
|
||||
| `Art` | *any* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. |
|
||||
| `AudienceRating` | **float64* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings |
|
||||
| `AudienceRatingImage` | *any* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Banner` | *any* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. |
|
||||
| `ChapterSource` | *any* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). |
|
||||
| `Composite` | *any* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). |
|
||||
| `ContentRating` | *any* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent |
|
||||
| `GUID` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Hero` | *any* | :heavy_minus_sign: | When present, the URL for a hero image for the item. |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A |
|
||||
| `Index` | **int64* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. |
|
||||
| `Key` | *any* | :heavy_minus_sign: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | When a user has watched or listened to an item, this contains a timestamp (epoch seconds) for that last consumption time. |
|
||||
| `LeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. |
|
||||
| `Media` | [][components.Media](../../models/components/media.md) | :heavy_minus_sign: | N/A |
|
||||
| `OriginallyAvailableAt` | *any* | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. |
|
||||
| `OriginalTitle` | *any* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent |
|
||||
| `ParentIndex` | **int64* | :heavy_minus_sign: | The `index` of the parent |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent |
|
||||
| `PrimaryExtraKey` | *any* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) |
|
||||
| `Rating` | **float64* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `RatingCount` | **int64* | :heavy_minus_sign: | Number of ratings under this metadata |
|
||||
| `RatingImage` | *any* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. |
|
||||
| `RatingKey` | *any* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Studio` | *any* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). |
|
||||
| `Subtype` | *any* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library |
|
||||
| `Summary` | *any* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). |
|
||||
| `Tagline` | *any* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). |
|
||||
| `Theme` | *any* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). |
|
||||
| `Thumb` | *any* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. |
|
||||
| `TitleSort` | *any* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). |
|
||||
| `UserRating` | **float64* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating |
|
||||
| `ViewCount` | **int64* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. |
|
||||
| `ViewedLeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. |
|
||||
| `ViewOffset` | **int64* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Year` | **int64* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Title` | *string* | :heavy_check_mark: | The title of the item (e.g. “300” or “The Simpsons”) | |
|
||||
| `Type` | *string* | :heavy_check_mark: | The type of the video item, such as `movie`, `episode`, or `clip`. | |
|
||||
| `AbsoluteIndex` | **int* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. | |
|
||||
| `AddedAt` | *int64* | :heavy_check_mark: | In units of seconds since the epoch, returns the time at which the item was added to the library. | |
|
||||
| `Art` | **string* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. | /library/metadata/58683/art/1703239236 |
|
||||
| `AudienceRating` | **float32* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings | |
|
||||
| `AudienceRatingImage` | **string* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). | |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Banner` | **string* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. | |
|
||||
| `ChapterSource` | **string* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). | media |
|
||||
| `ChildCount` | **int* | :heavy_minus_sign: | The number of child items associated with this media item. | 1 |
|
||||
| `Composite` | **string* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). | |
|
||||
| `ContentRating` | **string* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. | |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. | |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent | |
|
||||
| `GrandparentGUID` | **string* | :heavy_minus_sign: | The GUID of the grandparent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent | |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent | |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent | |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent | |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent | |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent | |
|
||||
| `GUID` | **string* | :heavy_minus_sign: | The globally unique identifier for the media item. | plex://movie/5d7768ba96b655001fdc0408 |
|
||||
| `Guids` | [][components.Guids](../../models/components/guids.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Hero` | **string* | :heavy_minus_sign: | When present, the URL for a hero image for the item. | |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Index` | **int* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. | |
|
||||
| `Key` | *string* | :heavy_check_mark: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. | |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `LeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. | |
|
||||
| `Media` | [][components.Media](../../models/components/media.md) | :heavy_minus_sign: | N/A | |
|
||||
| `OriginallyAvailableAt` | [*types.Date](../../types/date.md) | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. | 2022-12-14 |
|
||||
| `OriginalTitle` | **string* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. | |
|
||||
| `ParentGUID` | **string* | :heavy_minus_sign: | The GUID of the parent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent | |
|
||||
| `ParentIndex` | **int* | :heavy_minus_sign: | The `index` of the parent | |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent | |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent | |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent | |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent | |
|
||||
| `PrimaryExtraKey` | **string* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. | |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) | |
|
||||
| `Rating` | **float32* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. | |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `RatingCount` | **int* | :heavy_minus_sign: | Number of ratings under this metadata | |
|
||||
| `RatingImage` | **string* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. | |
|
||||
| `RatingKey` | **string* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. | |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory | |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. | |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. | |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). | |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Studio` | **string* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). | |
|
||||
| `Subtype` | **string* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library | |
|
||||
| `Summary` | **string* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). | |
|
||||
| `Tagline` | **string* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). | |
|
||||
| `Theme` | **string* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). | /library/metadata/1/theme/1705636920 |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. | /library/metadata/58683/thumb/1703239236 |
|
||||
| `TitleSort` | **string* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). | |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). | |
|
||||
| `UserRating` | **float32* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating | |
|
||||
| `ViewCount` | **int* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. | |
|
||||
| `ViewedLeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. | |
|
||||
| `ViewOffset` | **int* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. | |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Year` | **int* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). | |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
@@ -10,74 +10,78 @@ Metadata items can often live in a hierarchy with relationships between them. F
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Title` | *any* | :heavy_minus_sign: | The title of the item (e.g. “300” or “The Simpsons”) |
|
||||
| `Type` | *any* | :heavy_minus_sign: | The type of the video item, such as `movie`, `episode`, or `clip`. |
|
||||
| `AbsoluteIndex` | **int64* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. |
|
||||
| `AddedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was added to the library. |
|
||||
| `Art` | *any* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. |
|
||||
| `AudienceRating` | **float64* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings |
|
||||
| `AudienceRatingImage` | *any* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Banner` | *any* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. |
|
||||
| `ChapterSource` | *any* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). |
|
||||
| `Composite` | *any* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). |
|
||||
| `ContentRating` | *any* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent |
|
||||
| `GUID` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Hero` | *any* | :heavy_minus_sign: | When present, the URL for a hero image for the item. |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A |
|
||||
| `Index` | **int64* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. |
|
||||
| `Key` | *any* | :heavy_minus_sign: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | When a user has watched or listened to an item, this contains a timestamp (epoch seconds) for that last consumption time. |
|
||||
| `LeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. |
|
||||
| `Media` | [][components.Media](../../models/components/media.md) | :heavy_minus_sign: | N/A |
|
||||
| `OriginallyAvailableAt` | *any* | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. |
|
||||
| `OriginalTitle` | *any* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent |
|
||||
| `ParentIndex` | **int64* | :heavy_minus_sign: | The `index` of the parent |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent |
|
||||
| `PrimaryExtraKey` | *any* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) |
|
||||
| `Rating` | **float64* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `RatingCount` | **int64* | :heavy_minus_sign: | Number of ratings under this metadata |
|
||||
| `RatingImage` | *any* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. |
|
||||
| `RatingKey` | *any* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level |
|
||||
| `Studio` | *any* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). |
|
||||
| `Subtype` | *any* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library |
|
||||
| `Summary` | *any* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). |
|
||||
| `Tagline` | *any* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). |
|
||||
| `Theme` | *any* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). |
|
||||
| `Thumb` | *any* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. |
|
||||
| `TitleSort` | *any* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). |
|
||||
| `UserRating` | **float64* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating |
|
||||
| `ViewCount` | **int64* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. |
|
||||
| `ViewedLeafCount` | **int64* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. |
|
||||
| `ViewOffset` | **int64* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A |
|
||||
| `Year` | **int64* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). |
|
||||
| `MetadataItem` | [][components.Items](../../models/components/items.md) | :heavy_minus_sign: | N/A |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Title` | *string* | :heavy_check_mark: | The title of the item (e.g. “300” or “The Simpsons”) | |
|
||||
| `Type` | *string* | :heavy_check_mark: | The type of the video item, such as `movie`, `episode`, or `clip`. | |
|
||||
| `AbsoluteIndex` | **int* | :heavy_minus_sign: | When present, contains the disc number for a track on multi-disc albums. | |
|
||||
| `AddedAt` | *int64* | :heavy_check_mark: | In units of seconds since the epoch, returns the time at which the item was added to the library. | |
|
||||
| `Art` | **string* | :heavy_minus_sign: | When present, the URL for the background artwork for the item. | /library/metadata/58683/art/1703239236 |
|
||||
| `AudienceRating` | **float32* | :heavy_minus_sign: | Some rating systems separate reviewer ratings from audience ratings | |
|
||||
| `AudienceRatingImage` | **string* | :heavy_minus_sign: | A URI representing the image to be shown with the audience rating (e.g. rottentomatoes://image.rating.spilled). | |
|
||||
| `Autotag` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Banner` | **string* | :heavy_minus_sign: | When present, the URL for a banner graphic for the item. | |
|
||||
| `ChapterSource` | **string* | :heavy_minus_sign: | When present, indicates the source for the chapters in the media file. Can be media (the chapters were embedded in the media itself), agent (a metadata agent computed them), or mixed (a combination of the two). | media |
|
||||
| `ChildCount` | **int* | :heavy_minus_sign: | The number of child items associated with this media item. | 1 |
|
||||
| `Composite` | **string* | :heavy_minus_sign: | When present, the URL for a composite image for descendent items (e.g. photo albums or playlists). | |
|
||||
| `ContentRating` | **string* | :heavy_minus_sign: | If known, the content rating (e.g. MPAA) for an item. | |
|
||||
| `Country` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Director` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | When present, the duration for the item, in units of milliseconds. | |
|
||||
| `Filter` | [][components.Filter](../../models/components/filter.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Genre` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `GrandparentArt` | **string* | :heavy_minus_sign: | The `art` of the grandparent | |
|
||||
| `GrandparentGUID` | **string* | :heavy_minus_sign: | The GUID of the grandparent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `GrandparentHero` | **string* | :heavy_minus_sign: | The `hero` of the grandparent | |
|
||||
| `GrandparentKey` | **string* | :heavy_minus_sign: | The `key` of the grandparent | |
|
||||
| `GrandparentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the grandparent | |
|
||||
| `GrandparentTheme` | **string* | :heavy_minus_sign: | The `theme` of the grandparent | |
|
||||
| `GrandparentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the grandparent | |
|
||||
| `GrandparentTitle` | **string* | :heavy_minus_sign: | The `title` of the grandparent | |
|
||||
| `GUID` | **string* | :heavy_minus_sign: | The globally unique identifier for the media item. | plex://movie/5d7768ba96b655001fdc0408 |
|
||||
| `Guids` | [][components.MediaContainerWithNestedMetadataGuids](../../models/components/mediacontainerwithnestedmetadataguids.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Hero` | **string* | :heavy_minus_sign: | When present, the URL for a hero image for the item. | |
|
||||
| `Image` | [][components.Image](../../models/components/image.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Index` | **int* | :heavy_minus_sign: | When present, this represents the episode number for episodes, season number for seasons, or track number for audio tracks. | |
|
||||
| `Key` | *string* | :heavy_check_mark: | The key at which the item's details can be fetched. In many cases a metadata item may be passed without all the details (such as in a hub) and this key corresponds to the endpoint to fetch additional details. | |
|
||||
| `LastViewedAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `LeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of total episodes. | |
|
||||
| `Media` | [][components.Media](../../models/components/media.md) | :heavy_minus_sign: | N/A | |
|
||||
| `OriginallyAvailableAt` | [*types.Date](../../types/date.md) | :heavy_minus_sign: | When present, in the format YYYY-MM-DD [HH:MM:SS] (the hours/minutes/seconds part is not always present). The air date, or a higher resolution release date for an item, depending on type. For example, episodes usually have air date like 1979-08-10 (we don't use epoch seconds because media existed prior to 1970). In some cases, recorded over-the-air content has higher resolution air date which includes a time component. Albums and movies may have day-resolution release dates as well. | 2022-12-14 |
|
||||
| `OriginalTitle` | **string* | :heavy_minus_sign: | When present, used to indicate an item's original title, e.g. a movie's foreign title. | |
|
||||
| `ParentGUID` | **string* | :heavy_minus_sign: | The GUID of the parent media item. | plex://show/5d9c081b170e24001f2a7be4 |
|
||||
| `ParentHero` | **string* | :heavy_minus_sign: | The `hero` of the parent | |
|
||||
| `ParentIndex` | **int* | :heavy_minus_sign: | The `index` of the parent | |
|
||||
| `ParentKey` | **string* | :heavy_minus_sign: | The `key` of the parent | |
|
||||
| `ParentRatingKey` | **string* | :heavy_minus_sign: | The `ratingKey` of the parent | |
|
||||
| `ParentThumb` | **string* | :heavy_minus_sign: | The `thumb` of the parent | |
|
||||
| `ParentTitle` | **string* | :heavy_minus_sign: | The `title` of the parent | |
|
||||
| `PrimaryExtraKey` | **string* | :heavy_minus_sign: | Indicates that the item has a primary extra; for a movie, this is a trailer, and for a music track it is a music video. The URL points to the metadata details endpoint for the item. | |
|
||||
| `Prompt` | **string* | :heavy_minus_sign: | Prompt to give the user for this directory (such as `Search Movies`) | |
|
||||
| `Rating` | **float32* | :heavy_minus_sign: | When present, the rating for the item. The exact meaning and representation depends on where the rating was sourced from. | |
|
||||
| `RatingArray` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `RatingCount` | **int* | :heavy_minus_sign: | Number of ratings under this metadata | |
|
||||
| `RatingImage` | **string* | :heavy_minus_sign: | When present, indicates an image to be shown with the rating. This is passed back as a small set of defined URI values, e.g. rottentomatoes://image.rating.rotten. | |
|
||||
| `RatingKey` | **string* | :heavy_minus_sign: | This is the opaque string to be passed into timeline, scrobble, and rating endpoints to identify them. While it often appears to be numeric, this is not guaranteed. | |
|
||||
| `Role` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Search` | **bool* | :heavy_minus_sign: | Indicates this is a search directory | |
|
||||
| `Secondary` | **bool* | :heavy_minus_sign: | Used by old clients to provide nested menus allowing for primative (but structured) navigation. | |
|
||||
| `SkipChildren` | **bool* | :heavy_minus_sign: | When found on a show item, indicates that the children (seasons) should be skipped in favor of the grandchildren (episodes). Useful for mini-series, etc. | |
|
||||
| `SkipParent` | **bool* | :heavy_minus_sign: | When present on an episode or track item, indicates parent should be skipped in favor of grandparent (show). | |
|
||||
| `Sort` | [][components.Sort](../../models/components/sort.md) | :heavy_minus_sign: | Typically only seen in metadata at a library's top level | |
|
||||
| `Studio` | **string* | :heavy_minus_sign: | When present, the studio or label which produced an item (e.g. movie studio for movies, record label for albums). | |
|
||||
| `Subtype` | **string* | :heavy_minus_sign: | The subtype of the video item, such as `photo` when the video item is in a photo library | |
|
||||
| `Summary` | **string* | :heavy_minus_sign: | When present, the extended textual information about the item (e.g. movie plot, artist biography, album review). | |
|
||||
| `Tagline` | **string* | :heavy_minus_sign: | When present, a pithy one-liner about the item (usually only seen for movies). | |
|
||||
| `Theme` | **string* | :heavy_minus_sign: | When present, the URL for theme music for the item (usually only for TV shows). | /library/metadata/1/theme/1705636920 |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | When present, the URL for the poster or thumbnail for the item. When available for types like movie, it will be the poster graphic, but fall-back to the extracted media thumbnail. | /library/metadata/58683/thumb/1703239236 |
|
||||
| `TitleSort` | **string* | :heavy_minus_sign: | Whene present, this is the string used for sorting the item. It's usually the title with any leading articles removed (e.g. “Simpsons”). | |
|
||||
| `UpdatedAt` | **int64* | :heavy_minus_sign: | In units of seconds since the epoch, returns the time at which the item was last changed (e.g. had its metadata updated). | |
|
||||
| `UserRating` | **float32* | :heavy_minus_sign: | When the user has rated an item, this contains the user rating | |
|
||||
| `ViewCount` | **int* | :heavy_minus_sign: | When a users has completed watched or listened to an item, this attribute contains the number of consumptions. | |
|
||||
| `ViewedLeafCount` | **int* | :heavy_minus_sign: | For shows and seasons, contains the number of viewed episodes. | |
|
||||
| `ViewOffset` | **int* | :heavy_minus_sign: | When a user is in the process of viewing or listening to this item, this attribute contains the current offset, in units of milliseconds. | |
|
||||
| `Writer` | [][components.Tag](../../models/components/tag.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Year` | **int* | :heavy_minus_sign: | When present, the year associated with the item's release (e.g. release year for a movie). | |
|
||||
| `MetadataItem` | [][components.Items](../../models/components/items.md) | :heavy_minus_sign: | N/A | |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
@@ -8,15 +8,18 @@
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- |
|
||||
| `AudioProfile` | *any* | :heavy_minus_sign: | N/A | lc |
|
||||
| `Container` | *any* | :heavy_minus_sign: | The container of the media file, such as `mp4` or `mkv` | mov |
|
||||
| `Duration` | **int64* | :heavy_minus_sign: | The duration of the media item, in milliseconds | 150192 |
|
||||
| `File` | *any* | :heavy_minus_sign: | The local file path at which the part is stored on the server | /home/schuyler/Videos/Trailers/Cloud Atlas (2012).mov |
|
||||
| `Accessible` | **bool* | :heavy_minus_sign: | Indicates if the part is accessible. | true |
|
||||
| `AudioProfile` | **string* | :heavy_minus_sign: | N/A | lc |
|
||||
| `Container` | **string* | :heavy_minus_sign: | The container of the media file, such as `mp4` or `mkv` | mov |
|
||||
| `Duration` | **int* | :heavy_minus_sign: | The duration of the media item, in milliseconds | 150192 |
|
||||
| `Exists` | **bool* | :heavy_minus_sign: | Indicates if the part exists. | true |
|
||||
| `File` | **string* | :heavy_minus_sign: | The local file path at which the part is stored on the server | /home/schuyler/Videos/Trailers/Cloud Atlas (2012).mov |
|
||||
| `Has64bitOffsets` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `ID` | **int64* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `Key` | *any* | :heavy_minus_sign: | The key from which the media can be streamed | /library/parts/1/1531779263/file.mov |
|
||||
| `ID` | *int64* | :heavy_check_mark: | N/A | 1 |
|
||||
| `Indexes` | **string* | :heavy_minus_sign: | N/A | sd |
|
||||
| `Key` | *string* | :heavy_check_mark: | The key from which the media can be streamed | /library/parts/1/1531779263/file.mov |
|
||||
| `OptimizedForStreaming` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `Size` | **int64* | :heavy_minus_sign: | The size of the media, in bytes | 105355654 |
|
||||
| `Stream` | [][components.Stream](../../models/components/stream.md) | :heavy_minus_sign: | N/A | |
|
||||
| `VideoProfile` | *any* | :heavy_minus_sign: | N/A | main |
|
||||
| `VideoProfile` | **string* | :heavy_minus_sign: | N/A | main |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
31
docs/models/components/plexdevice.md
Normal file
31
docs/models/components/plexdevice.md
Normal file
@@ -0,0 +1,31 @@
|
||||
# PlexDevice
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
|
||||
| `Name` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `Product` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `ProductVersion` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `Platform` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `PlatformVersion` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `Device` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `ClientIdentifier` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `CreatedAt` | [time.Time](https://pkg.go.dev/time#Time) | :heavy_check_mark: | N/A | 2019-06-24T11:38:02Z |
|
||||
| `LastSeenAt` | [time.Time](https://pkg.go.dev/time#Time) | :heavy_check_mark: | N/A | 2019-06-24T11:38:02Z |
|
||||
| `Provides` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `OwnerID` | *int64* | :heavy_check_mark: | ownerId is null when the device is owned by the token used to send the request | |
|
||||
| `SourceTitle` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `PublicAddress` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `AccessToken` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `Owned` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `Home` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `Synced` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `Relay` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `Presence` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `HTTPSRequired` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `PublicAddressMatches` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `DNSRebindingProtection` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `NatLoopbackSupported` | *bool* | :heavy_check_mark: | N/A | |
|
||||
| `Connections` | [][components.Connections](../../models/components/connections.md) | :heavy_check_mark: | N/A | |
|
||||
11
docs/models/components/plexdeviceprotocol.md
Normal file
11
docs/models/components/plexdeviceprotocol.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# PlexDeviceProtocol
|
||||
|
||||
The protocol used for the connection (http, https, etc)
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ------------------------- | ------------------------- |
|
||||
| `PlexDeviceProtocolHTTP` | http |
|
||||
| `PlexDeviceProtocolHTTPS` | https |
|
||||
12
docs/models/components/services.md
Normal file
12
docs/models/components/services.md
Normal file
@@ -0,0 +1,12 @@
|
||||
# Services
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
|
||||
| `Identifier` | *string* | :heavy_check_mark: | N/A | metadata-dev |
|
||||
| `Endpoint` | *string* | :heavy_check_mark: | N/A | https://epg.provider.plex.tv |
|
||||
| `Token` | *string* | :heavy_check_mark: | N/A | DjoMtqFAGRL1uVtCyF1dKIorTbShJeqv |
|
||||
| `Secret` | *string* | :heavy_check_mark: | N/A | |
|
||||
| `Status` | [components.UserPlexAccountStatus](../../models/components/userplexaccountstatus.md) | :heavy_check_mark: | N/A | online |
|
||||
@@ -6,35 +6,58 @@
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `Default` | **bool* | :heavy_minus_sign: | N/A | true |
|
||||
| `AudioChannelLayout` | *any* | :heavy_minus_sign: | N/A | stereo |
|
||||
| `BitDepth` | **int64* | :heavy_minus_sign: | N/A | 8 |
|
||||
| `Bitrate` | **int64* | :heavy_minus_sign: | N/A | 5466 |
|
||||
| `CanAutoSync` | **bool* | :heavy_minus_sign: | For subtitle streams only. If `true` then the server can attempt to automatically sync the subtitle timestamps with the video. | true |
|
||||
| `ChromaLocation` | *any* | :heavy_minus_sign: | N/A | topleft |
|
||||
| `ChromaSubsampling` | *any* | :heavy_minus_sign: | N/A | 4:2:0 |
|
||||
| `Codec` | *any* | :heavy_minus_sign: | The codec of the stream, such as `h264` or `aac` | h264 |
|
||||
| `ColorPrimaries` | *any* | :heavy_minus_sign: | N/A | bt709 |
|
||||
| `ColorRange` | *any* | :heavy_minus_sign: | N/A | tv |
|
||||
| `ColorSpace` | *any* | :heavy_minus_sign: | N/A | bt709 |
|
||||
| `ColorTrc` | *any* | :heavy_minus_sign: | N/A | bt709 |
|
||||
| `DisplayTitle` | *any* | :heavy_minus_sign: | A friendly name for the stream, often comprised of the language and codec information | English (H.264 Main) |
|
||||
| `FrameRate` | **float64* | :heavy_minus_sign: | N/A | 23.976 |
|
||||
| `HasScalingMatrix` | *any* | :heavy_minus_sign: | N/A | false |
|
||||
| `Height` | **int64* | :heavy_minus_sign: | N/A | 544 |
|
||||
| `ID` | **int64* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `Index` | **int64* | :heavy_minus_sign: | If the stream is part of the `Part` and not an external resource, the index of the stream within that part | 0 |
|
||||
| `Key` | *any* | :heavy_minus_sign: | If the stream is independently streamable, the key from which it can be streamed | /library/streams/1 |
|
||||
| `Language` | *any* | :heavy_minus_sign: | N/A | English |
|
||||
| `LanguageCode` | *any* | :heavy_minus_sign: | The three character language code for the stream contents | eng |
|
||||
| `Level` | **int64* | :heavy_minus_sign: | N/A | 31 |
|
||||
| `Profile` | *any* | :heavy_minus_sign: | N/A | main |
|
||||
| `RefFrames` | **int64* | :heavy_minus_sign: | N/A | 2 |
|
||||
| `SamplingRate` | **int64* | :heavy_minus_sign: | N/A | 48000 |
|
||||
| `Selected` | **bool* | :heavy_minus_sign: | N/A | |
|
||||
| `StreamIdentifier` | **int64* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `StreamType` | **int64* | :heavy_minus_sign: | A number indicating the type of the stream. `1` for video, `2` for audio, `3` for subtitles, `4` for lyrics | 1 |
|
||||
| `Width` | **int64* | :heavy_minus_sign: | N/A | 1280 |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| -------------------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- |
|
||||
| `Default` | **bool* | :heavy_minus_sign: | Indicates if this stream is default. | true |
|
||||
| `AudioChannelLayout` | **string* | :heavy_minus_sign: | Audio channel layout. | 5.1(side) |
|
||||
| `Channels` | **int* | :heavy_minus_sign: | Number of audio channels (for audio streams). | 6 |
|
||||
| `BitDepth` | **int* | :heavy_minus_sign: | Bit depth of the video stream. | 10 |
|
||||
| `DOVIBLCompatID` | **int* | :heavy_minus_sign: | Dolby Vision BL compatibility ID. | 1 |
|
||||
| `DOVIBLPresent` | **bool* | :heavy_minus_sign: | Indicates if Dolby Vision BL is present. | true |
|
||||
| `DOVIELPresent` | **bool* | :heavy_minus_sign: | Indicates if Dolby Vision EL is present. | false |
|
||||
| `DOVILevel` | **int* | :heavy_minus_sign: | Dolby Vision level. | 6 |
|
||||
| `DOVIPresent` | **bool* | :heavy_minus_sign: | Indicates if Dolby Vision is present. | true |
|
||||
| `DOVIProfile` | **int* | :heavy_minus_sign: | Dolby Vision profile. | 8 |
|
||||
| `DOVIRPUPresent` | **bool* | :heavy_minus_sign: | Indicates if Dolby Vision RPU is present. | true |
|
||||
| `DOVIVersion` | **string* | :heavy_minus_sign: | Dolby Vision version. | 1.0 |
|
||||
| `Bitrate` | **int* | :heavy_minus_sign: | Bitrate of the stream. | 24743 |
|
||||
| `CanAutoSync` | **bool* | :heavy_minus_sign: | Indicates if the stream can auto-sync. | false |
|
||||
| `ChromaLocation` | **string* | :heavy_minus_sign: | Chroma sample location. | topleft |
|
||||
| `ChromaSubsampling` | **string* | :heavy_minus_sign: | Chroma subsampling format. | 4:2:0 |
|
||||
| `CodedHeight` | **int* | :heavy_minus_sign: | Coded video height. | 1608 |
|
||||
| `CodedWidth` | **int* | :heavy_minus_sign: | Coded video width. | 3840 |
|
||||
| `ClosedCaptions` | **bool* | :heavy_minus_sign: | N/A | true |
|
||||
| `Codec` | *string* | :heavy_check_mark: | Codec used by the stream. | hevc |
|
||||
| `ColorPrimaries` | **string* | :heavy_minus_sign: | Color primaries used. | bt2020 |
|
||||
| `ColorRange` | **string* | :heavy_minus_sign: | Color range (e.g., tv). | tv |
|
||||
| `ColorSpace` | **string* | :heavy_minus_sign: | Color space. | bt2020nc |
|
||||
| `ColorTrc` | **string* | :heavy_minus_sign: | Color transfer characteristics. | smpte2084 |
|
||||
| `DisplayTitle` | *string* | :heavy_check_mark: | Display title for the stream. | 4K DoVi/HDR10 (HEVC Main 10) |
|
||||
| `ExtendedDisplayTitle` | **string* | :heavy_minus_sign: | Extended display title for the stream. | 4K DoVi/HDR10 (HEVC Main 10) |
|
||||
| `FrameRate` | **float32* | :heavy_minus_sign: | Frame rate of the stream. | 23.976 |
|
||||
| `HasScalingMatrix` | **bool* | :heavy_minus_sign: | N/A | false |
|
||||
| `Height` | **int* | :heavy_minus_sign: | Height of the video stream. | 1602 |
|
||||
| `ID` | *int* | :heavy_check_mark: | Unique stream identifier. | 1002625 |
|
||||
| `Index` | **int* | :heavy_minus_sign: | Index of the stream. | 0 |
|
||||
| `Key` | *string* | :heavy_check_mark: | Key to access this stream part. | /library/streams/216389 |
|
||||
| `Language` | **string* | :heavy_minus_sign: | Language of the stream. | English |
|
||||
| `LanguageCode` | **string* | :heavy_minus_sign: | ISO language code. | eng |
|
||||
| `LanguageTag` | **string* | :heavy_minus_sign: | Language tag (e.g., en). | en |
|
||||
| `Format` | **string* | :heavy_minus_sign: | Format of the stream (e.g., srt). | srt |
|
||||
| `HeaderCompression` | **bool* | :heavy_minus_sign: | Indicates whether header compression is enabled. | true |
|
||||
| `Level` | **int* | :heavy_minus_sign: | Video level. | 150 |
|
||||
| `Original` | **bool* | :heavy_minus_sign: | Indicates if this is the original stream. | true |
|
||||
| `Profile` | **string* | :heavy_minus_sign: | Video profile. | main 10 |
|
||||
| `RefFrames` | **int* | :heavy_minus_sign: | Number of reference frames. | 1 |
|
||||
| `SamplingRate` | **int* | :heavy_minus_sign: | Sampling rate for the audio stream. | 48000 |
|
||||
| `ScanType` | **string* | :heavy_minus_sign: | N/A | progressive |
|
||||
| `EmbeddedInVideo` | **string* | :heavy_minus_sign: | N/A | progressive |
|
||||
| `Selected` | **bool* | :heavy_minus_sign: | Indicates if this stream is selected (applicable for audio streams). | true |
|
||||
| `Forced` | **bool* | :heavy_minus_sign: | N/A | true |
|
||||
| `HearingImpaired` | **bool* | :heavy_minus_sign: | Indicates if the stream is for the hearing impaired. | true |
|
||||
| `Dub` | **bool* | :heavy_minus_sign: | Indicates if the stream is a dub. | true |
|
||||
| `Title` | **string* | :heavy_minus_sign: | Optional title for the stream (e.g., language variant). | SDH |
|
||||
| `StreamIdentifier` | **int* | :heavy_minus_sign: | N/A | 1 |
|
||||
| `StreamType` | *int64* | :heavy_check_mark: | Stream type:<br/> - VIDEO = 1<br/> - AUDIO = 2<br/> - SUBTITLE = 3<br/> | |
|
||||
| `Width` | **int* | :heavy_minus_sign: | Width of the video stream. | 3840 |
|
||||
| `AdditionalProperties` | map[string]*any* | :heavy_minus_sign: | N/A | |
|
||||
15
docs/models/components/subscription.md
Normal file
15
docs/models/components/subscription.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# Subscription
|
||||
|
||||
If the account's Plex Pass subscription is active
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
|
||||
| `Features` | []*string* | :heavy_minus_sign: | List of features allowed on your Plex Pass subscription | |
|
||||
| `Active` | **bool* | :heavy_minus_sign: | If the account's Plex Pass subscription is active | true |
|
||||
| `SubscribedAt` | **string* | :heavy_minus_sign: | Date the account subscribed to Plex Pass | 2021-04-12T18:21:12Z |
|
||||
| `Status` | [*components.UserPlexAccountSubscriptionStatus](../../models/components/userplexaccountsubscriptionstatus.md) | :heavy_minus_sign: | String representation of subscriptionActive | Inactive |
|
||||
| `PaymentService` | **string* | :heavy_minus_sign: | Payment service used for your Plex Pass subscription | |
|
||||
| `Plan` | **string* | :heavy_minus_sign: | Name of Plex Pass subscription plan | |
|
||||
@@ -6,15 +6,15 @@ A variety of extra information about a metadata item is included as tags. These
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
|
||||
| `Confidence` | **float64* | :heavy_minus_sign: | Measure of the confidence of an automatic tag | |
|
||||
| `Context` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `Filter` | *any* | :heavy_minus_sign: | A filter parameter that can be used to query for more content that matches this tag value. | actor=49 |
|
||||
| `ID` | **int64* | :heavy_minus_sign: | N/A | |
|
||||
| `RatingKey` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `Role` | *any* | :heavy_minus_sign: | The role this actor played | Secretary |
|
||||
| `Tag` | *any* | :heavy_minus_sign: | The value of the tag (the name) | Shaun Lawton |
|
||||
| `TagKey` | *any* | :heavy_minus_sign: | Plex identifier for this tag which can be used to fetch additional information from plex.tv | 5d3ee12c4cde6a001c3e0b27 |
|
||||
| `TagType` | **int64* | :heavy_minus_sign: | N/A | |
|
||||
| `Thumb` | *any* | :heavy_minus_sign: | N/A | http://image.tmdb.org/t/p/original/lcJ8qM51ClAR2UzXU1mkZGfnn3o.jpg |
|
||||
| Field | Type | Required | Description | Example |
|
||||
| --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `Confidence` | **float64* | :heavy_minus_sign: | Measure of the confidence of an automatic tag | |
|
||||
| `Context` | **string* | :heavy_minus_sign: | N/A | |
|
||||
| `Filter` | **string* | :heavy_minus_sign: | A filter parameter that can be used to query for more content that matches this tag value. | actor=49 |
|
||||
| `ID` | **int* | :heavy_minus_sign: | N/A | |
|
||||
| `RatingKey` | **string* | :heavy_minus_sign: | The rating key (Media ID) of this media item. Note: Although this is always an integer, it is represented as a string in the API. | 58683 |
|
||||
| `Role` | **string* | :heavy_minus_sign: | The role this actor played | Secretary |
|
||||
| `Tag` | *string* | :heavy_check_mark: | The value of the tag (the name) | Shaun Lawton |
|
||||
| `TagKey` | **string* | :heavy_minus_sign: | Plex identifier for this tag which can be used to fetch additional information from plex.tv | 5d3ee12c4cde6a001c3e0b27 |
|
||||
| `TagType` | **int* | :heavy_minus_sign: | N/A | |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | N/A | http://image.tmdb.org/t/p/original/lcJ8qM51ClAR2UzXU1mkZGfnn3o.jpg |
|
||||
48
docs/models/components/userplexaccount.md
Normal file
48
docs/models/components/userplexaccount.md
Normal file
@@ -0,0 +1,48 @@
|
||||
# UserPlexAccount
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `AdsConsent` | **bool* | :heavy_minus_sign: | Unknown | |
|
||||
| `AdsConsentReminderAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `AdsConsentSetAt` | **int64* | :heavy_minus_sign: | N/A | 1556281940 |
|
||||
| `Anonymous` | **bool* | :heavy_minus_sign: | Unknown | |
|
||||
| `AuthToken` | *string* | :heavy_check_mark: | The account token | CxoUzBTSV5hsxjTpFKaf |
|
||||
| `BackupCodesCreated` | **bool* | :heavy_minus_sign: | If the two-factor authentication backup codes have been created | |
|
||||
| `Confirmed` | **bool* | :heavy_minus_sign: | If the account has been confirmed | |
|
||||
| `Country` | **string* | :heavy_minus_sign: | The account country | US |
|
||||
| `Email` | *string* | :heavy_check_mark: | The account email address | username@email.com |
|
||||
| `EmailOnlyAuth` | **bool* | :heavy_minus_sign: | If login with email only is enabled | |
|
||||
| `ExperimentalFeatures` | **bool* | :heavy_minus_sign: | If experimental features are enabled | |
|
||||
| `FriendlyName` | *string* | :heavy_check_mark: | Your account full name | friendlyUsername |
|
||||
| `Entitlements` | []*string* | :heavy_minus_sign: | List of devices your allowed to use with this account | [] |
|
||||
| `Guest` | **bool* | :heavy_minus_sign: | If the account is a Plex Home guest user | |
|
||||
| `HasPassword` | **bool* | :heavy_minus_sign: | If the account has a password | |
|
||||
| `Home` | **bool* | :heavy_minus_sign: | If the account is a Plex Home user | |
|
||||
| `HomeAdmin` | **bool* | :heavy_minus_sign: | If the account is the Plex Home admin | |
|
||||
| `HomeSize` | **int* | :heavy_minus_sign: | The number of accounts in the Plex Home | 1 |
|
||||
| `ID` | *int* | :heavy_check_mark: | The Plex account ID | 13692262 |
|
||||
| `JoinedAt` | *int64* | :heavy_check_mark: | Unix epoch datetime in seconds | 1556281940 |
|
||||
| `Locale` | **string* | :heavy_minus_sign: | The account locale | |
|
||||
| `MailingListActive` | **bool* | :heavy_minus_sign: | If you are subscribed to the Plex newsletter | |
|
||||
| `MailingListStatus` | [*components.MailingListStatus](../../models/components/mailingliststatus.md) | :heavy_minus_sign: | Your current mailing list status | active |
|
||||
| `MaxHomeSize` | **int* | :heavy_minus_sign: | The maximum number of accounts allowed in the Plex Home | 15 |
|
||||
| ~~`Pin`~~ | **string* | :heavy_minus_sign: | : warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.<br/><br/>[Might be removed] The hashed Plex Home PIN | |
|
||||
| `Profile` | [*components.UserProfile](../../models/components/userprofile.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Protected` | **bool* | :heavy_minus_sign: | If the account has a Plex Home PIN enabled | |
|
||||
| `RememberExpiresAt` | **int64* | :heavy_minus_sign: | Unix epoch datetime in seconds | 1556281940 |
|
||||
| `Restricted` | **bool* | :heavy_minus_sign: | If the account is a Plex Home managed user | |
|
||||
| `Roles` | []*string* | :heavy_minus_sign: | [Might be removed] List of account roles. Plexpass membership listed here | |
|
||||
| `ScrobbleTypes` | **string* | :heavy_minus_sign: | Unknown | |
|
||||
| `Services` | [][components.Services](../../models/components/services.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Subscription` | [*components.Subscription](../../models/components/subscription.md) | :heavy_minus_sign: | If the account's Plex Pass subscription is active | |
|
||||
| `SubscriptionDescription` | **string* | :heavy_minus_sign: | Description of the Plex Pass subscription | |
|
||||
| `Subscriptions` | [][components.UserPlexAccountSubscription](../../models/components/userplexaccountsubscription.md) | :heavy_minus_sign: | N/A | |
|
||||
| `Thumb` | **string* | :heavy_minus_sign: | URL of the account thumbnail | https://plex.tv/users/a4f43c1ebfde43a5/avatar?c=8372075101 |
|
||||
| `Title` | *string* | :heavy_check_mark: | The title of the account (username or friendly name) | UsernameTitle |
|
||||
| `TwoFactorEnabled` | **bool* | :heavy_minus_sign: | If two-factor authentication is enabled | |
|
||||
| `Username` | *string* | :heavy_check_mark: | The account username | Username |
|
||||
| `UUID` | *string* | :heavy_check_mark: | The account UUID | dae343c1f45beb4f |
|
||||
| `AttributionPartner` | **string* | :heavy_minus_sign: | N/A | <nil> |
|
||||
9
docs/models/components/userplexaccountstatus.md
Normal file
9
docs/models/components/userplexaccountstatus.md
Normal file
@@ -0,0 +1,9 @@
|
||||
# UserPlexAccountStatus
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ------------------------------ | ------------------------------ |
|
||||
| `UserPlexAccountStatusOnline` | online |
|
||||
| `UserPlexAccountStatusOffline` | offline |
|
||||
13
docs/models/components/userplexaccountsubscription.md
Normal file
13
docs/models/components/userplexaccountsubscription.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# UserPlexAccountSubscription
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
|
||||
| `Features` | []*string* | :heavy_minus_sign: | List of features allowed on your Plex Pass subscription | |
|
||||
| `Active` | **bool* | :heavy_minus_sign: | If the account's Plex Pass subscription is active | true |
|
||||
| `SubscribedAt` | **string* | :heavy_minus_sign: | Date the account subscribed to Plex Pass | 2021-04-12T18:21:12Z |
|
||||
| `Status` | [*components.UserPlexAccountSubscriptionsStatus](../../models/components/userplexaccountsubscriptionsstatus.md) | :heavy_minus_sign: | String representation of subscriptionActive | Inactive |
|
||||
| `PaymentService` | **string* | :heavy_minus_sign: | Payment service used for your Plex Pass subscription | |
|
||||
| `Plan` | **string* | :heavy_minus_sign: | Name of Plex Pass subscription plan | |
|
||||
11
docs/models/components/userplexaccountsubscriptionsstatus.md
Normal file
11
docs/models/components/userplexaccountsubscriptionsstatus.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# UserPlexAccountSubscriptionsStatus
|
||||
|
||||
String representation of subscriptionActive
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| -------------------------------------------- | -------------------------------------------- |
|
||||
| `UserPlexAccountSubscriptionsStatusInactive` | Inactive |
|
||||
| `UserPlexAccountSubscriptionsStatusActive` | Active |
|
||||
11
docs/models/components/userplexaccountsubscriptionstatus.md
Normal file
11
docs/models/components/userplexaccountsubscriptionstatus.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# UserPlexAccountSubscriptionStatus
|
||||
|
||||
String representation of subscriptionActive
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ------------------------------------------- | ------------------------------------------- |
|
||||
| `UserPlexAccountSubscriptionStatusInactive` | Inactive |
|
||||
| `UserPlexAccountSubscriptionStatusActive` | Active |
|
||||
19
docs/models/components/userprofile.md
Normal file
19
docs/models/components/userprofile.md
Normal file
@@ -0,0 +1,19 @@
|
||||
# UserProfile
|
||||
|
||||
|
||||
## Fields
|
||||
|
||||
| Field | Type | Required | Description | Example |
|
||||
| --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
|
||||
| `AutoSelectAudio` | **bool* | :heavy_minus_sign: | If the account has automatically select audio and subtitle tracks enabled | true |
|
||||
| `DefaultAudioLanguage` | *string* | :heavy_check_mark: | The preferred audio language for the account | ja |
|
||||
| `DefaultAudioAccessibility` | [*components.DefaultAudioAccessibility](../../models/components/defaultaudioaccessibility.md) | :heavy_minus_sign: | N/A | 0 |
|
||||
| `DefaultAudioLanguages` | []*string* | :heavy_minus_sign: | The preferred audio languages for the account | <nil> |
|
||||
| `DefaultSubtitleLanguage` | *string* | :heavy_check_mark: | The preferred subtitle language for the account | en |
|
||||
| `DefaultSubtitleLanguages` | []*string* | :heavy_minus_sign: | The preferred subtitle languages for the account | <nil> |
|
||||
| `AutoSelectSubtitle` | [*components.AutoSelectSubtitle](../../models/components/autoselectsubtitle.md) | :heavy_minus_sign: | N/A | 1 |
|
||||
| `DefaultSubtitleAccessibility` | [*components.DefaultSubtitleAccessibility](../../models/components/defaultsubtitleaccessibility.md) | :heavy_minus_sign: | N/A | 1 |
|
||||
| `DefaultSubtitleForced` | [*components.DefaultSubtitleForced](../../models/components/defaultsubtitleforced.md) | :heavy_minus_sign: | N/A | 1 |
|
||||
| `WatchedIndicator` | [*components.WatchedIndicator](../../models/components/watchedindicator.md) | :heavy_minus_sign: | N/A | 1 |
|
||||
| `MediaReviewsVisibility` | [*components.MediaReviewsVisibility](../../models/components/mediareviewsvisibility.md) | :heavy_minus_sign: | N/A | 1 |
|
||||
| `MediaReviewsLanguages` | []*string* | :heavy_minus_sign: | The languages for media reviews visibility | <nil> |
|
||||
13
docs/models/components/watchedindicator.md
Normal file
13
docs/models/components/watchedindicator.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# WatchedIndicator
|
||||
|
||||
Whether or not media watched indicators are enabled (little orange dot on media)
|
||||
|
||||
|
||||
## Values
|
||||
|
||||
| Name | Value |
|
||||
| ---------------------------------- | ---------------------------------- |
|
||||
| `WatchedIndicatorNone` | 0 |
|
||||
| `WatchedIndicatorMoviesAndTvShows` | 1 |
|
||||
| `WatchedIndicatorMovies` | 2 |
|
||||
| `WatchedIndicatorTvShows` | 3 |
|
||||
Reference in New Issue
Block a user