One or two Title Formatting patterns; the second sub-groups each run.
OptionalplaylistPlaylist index; omitted, the active playlist.
OptionalplaylistPersistent unique identifier of a playlist (bracketed GUID, case-insensitive), used in place of a mutable index. Mutually exclusive with playlist; passing both or an invalid format fails with INVALID_PARAMS. Fails with NOT_FOUND if the playlist does not exist, never falling back. Invalid-format and not-found failures return the given GUID in details.playlistGuid.
Parameters for
playlist.getGroupRuns. Split a whole playlist into runs of adjacent rows whose group key is equal, with ASCII letters compared case-insensitively; a second pattern sub-groups each run. Rows are never reordered and only the run boundaries come back, so the answer grows with the number of runs, not of rows. Keys are evaluated off the main thread. More than two patterns, an empty pattern or one that fails to compile fails withINVALID_PARAMS, the last two withdetails.patterngiving its position. An index past the last playlist fails withINVALID_INDEXanddetails.playlistgiving the index asked for, aplaylistGuidno playlist has withNOT_FOUNDanddetails.playlistGuid; with both omitted and no active playlist the call fails withNO_ACTIVE_ITEM. An error while the keys are evaluated fails withOPERATION_FAILED, the failure carrying an emptyrunsandtotal0.