plexjs/docs/sdk/models/operations/getfirstcharactersrequest.md

GetFirstCharactersRequest

Example Usage

import { GetFirstCharactersRequest } from "@lukehagar/plexjs/sdk/models/operations";
import { MediaType } from "@lukehagar/plexjs/sdk/models/shared";

let value: GetFirstCharactersRequest = {
  sectionId: 231024,
  mediaQuery: {
    type: MediaType.Episode,
    sourceType: 2,
    sort: "duration:desc,index",
  },
};

Fields

Field	Type	Required	Description	Example
accepts	shared.Accepts	➖	Indicates the client accepts the indicated media types
clientIdentifier	string	➖	An opaque identifier unique to the client	abc123
product	string	➖	The name of the client product	Plex for Roku
version	string	➖	The version of the client application	2.4.1
platform	string	➖	The platform of the client	Roku
platformVersion	string	➖	The version of the platform	4.3 build 1057
device	string	➖	A relatively friendly name for the client device	Roku 3
model	string	➖	A potentially less friendly identifier for the device model	4200X
deviceVendor	string	➖	The device vendor	Roku
deviceName	string	➖	A friendly name for the client	Living Room TV
marketplace	string	➖	The marketplace on which the client application is distributed	googlePlay
sectionId	number	✔️	Section identifier
type	number	➖	The metadata type to filter on
sort	number	➖	The metadata type to filter on
mediaQuery	shared.MediaQuery	➖	A querystring-based filtering language used to select subsets of media. Can be provided as an object with typed properties for type safety, or as a string for complex queries with operators and boolean logic. The query supports: - Fields: integer, boolean, tag, string, date, language - Operators: =, !=, ==, !==, <=, >=, >>=, <<= (varies by field type) - Boolean operators: & (AND), , (OR), push/pop (parentheses), or=1 (explicit OR) - Sorting: sort parameter with :desc, :nullsLast modifiers - Grouping: group parameter - Limits: limit parameter Examples: - Object format: {type: 4, sourceType: 2, title: "24"} → type=4&sourceType=2&title=24 - String format: type=4&sourceType=2&title==24 - type = 4 AND sourceType = 2 AND title = "24" - Complex: push=1&index=1&or=1&rating=2&pop=1&duration=10 - (index = 1 OR rating = 2) AND duration = 10 See API Info section for detailed information on building media queries.	{ "type": 4, "sourceType": 2, "sort": "duration:desc,index" }