ActivityPub-federated video streaming platform using P2P directly in your web browser
Add state filter for videos
Chocobozzzc2e976d08b1e
diff --git a/client/src/app/+admin/overview/videos/video-list.component.html b/client/src/app/+admin/overview/videos/video-list.component.htmlindex dbeabd2a20..864381e6d1 100644--- a/client/src/app/+admin/overview/videos/video-list.component.html+++ b/client/src/app/+admin/overview/videos/video-list.component.html@@ -38,7 +38,7 @@<my-video-nsfw-badge [video]="video" theme="red"></my-video-nsfw-badge>@if (isUnpublished(video)) {- <span class="pt-badge badge-yellow">{{ video.state.label }}</span>+ <span [class]="getVideoStateBadgeClass(video.state.id)">{{ video.state.label }}</span>}@if (isAccountBlocked(video)) {diff --git a/client/src/app/+admin/overview/videos/video-list.component.ts b/client/src/app/+admin/overview/videos/video-list.component.tsindex 3af61dd301..7f6506946e 100644--- a/client/src/app/+admin/overview/videos/video-list.component.ts+++ b/client/src/app/+admin/overview/videos/video-list.component.ts@@ -11,8 +11,17 @@ import { VideoService } from '@app/shared/shared-main/video/video.service'import { VideoBlockComponent } from '@app/shared/shared-moderation/video-block.component'import { VideoBlockService } from '@app/shared/shared-moderation/video-block.service'import { PrivacyBadgeComponent } from '@app/shared/shared-video/privacy-badge.component'+import { getAllVideoStates, getVideoStateBadgeClass, getVideoStateLabel } from '@app/shared/shared-video/video-state-utils'import { getAllFiles } from '@peertube/peertube-core-utils'-import { FileStorage, NSFWFlag, UserRight, VideoFile, VideoState, VideoStreamingPlaylistType } from '@peertube/peertube-models'+import {+ FileStorage,+ NSFWFlag,+ UserRight,+ VideoFile,+ VideoState,+ VideoStateType,+ VideoStreamingPlaylistType+} from '@peertube/peertube-models'import { videoRequiresFileToken } from '@root-helpers/video'import { TableRowExpandEvent } from 'primeng/table'import { AdvancedFilterDef } from '../../../shared/shared-forms/advanced-input-filter.component'@@ -168,6 +177,19 @@ export class VideoListComponent implements OnInit {]},+ {+ type: 'select',+ key: 'state',+ title: $localize`Video state`,+ clearable: true,+ filter: true,+ items: getAllVideoStates().map(state => ({+ id: state + '',+ label: getVideoStateLabel(state).toLocaleUpperCase(),+ classes: [ 'pt-badge', getVideoStateBadgeClass(state) ]+ }))+ },+{type: 'options',key: 'hasWebVideoFiles',@@ -314,6 +336,10 @@ export class VideoListComponent implements OnInit {return total}+ getVideoStateBadgeClass (state: VideoStateType) {+ return 'pt-badge ' + getVideoStateBadgeClass(state)+ }+async removeVideoFile (video: Video, file: VideoFile, type: 'hls' | 'web-videos') {const message = $localize`Are you sure you want to delete this ${file.resolution.label} file?`const res = await this.confirmService.confirm(message, $localize`Delete file`)@@ -368,12 +394,20 @@ export class VideoListComponent implements OnInit {// ---------------------------------------------------------------------------- private _dataLoader (options: DataLoaderOptionsBase & Partial<Parameters<VideoAdminService['listAdminVideos']>[0]>) {+ private _dataLoader (+ options: DataLoaderOptionsBase & Partial<Parameters<VideoAdminService['listAdminVideos']>[0]> & {+ state: VideoStateType | string+ }+ ) {return this.videoAdminService.listAdminVideos({// Always list NSFW video, overriding instance/user settingnsfwFlagsExcluded: NSFWFlag.NONE,nsfw: 'both',+ stateOneOf: options.state+ ? [ options.state as VideoStateType ]+ : undefined,+...options})}diff --git a/client/src/app/shared/shared-forms/advanced-input-filter.component.scss b/client/src/app/shared/shared-forms/advanced-input-filter.component.scssindex f71a276bd5..b3c30dfa27 100644--- a/client/src/app/shared/shared-forms/advanced-input-filter.component.scss+++ b/client/src/app/shared/shared-forms/advanced-input-filter.component.scss@@ -87,8 +87,9 @@flex-direction: column;}-my-peertube-checkbox {- margin-bottom: 0.5rem;+my-select-options {+ display: block;+ margin-bottom: 1.5rem;}.pt-input-text {diff --git a/client/src/app/shared/shared-main/video/video.service.ts b/client/src/app/shared/shared-main/video/video.service.tsindex f19e981068..52801e26ee 100644--- a/client/src/app/shared/shared-main/video/video.service.ts+++ b/client/src/app/shared/shared-main/video/video.service.ts@@ -222,6 +222,7 @@ export class VideoService {nsfwFlagsExcluded,nsfwFlagsIncluded,autoTagOneOf,+ stateOneOf,...otherOptions} = options@@ -237,6 +238,8 @@ export class VideoService {if (Array.isArray(categoryOneOf)) newParams = this.restService.addArrayParams(newParams, 'categoryOneOf', categoryOneOf)if (Array.isArray(privacyOneOf)) newParams = this.restService.addArrayParams(newParams, 'privacyOneOf', privacyOneOf)if (Array.isArray(autoTagOneOf)) newParams = this.restService.addArrayParams(newParams, 'autoTagOneOf', autoTagOneOf)+ if (Array.isArray(autoTagOneOf)) newParams = this.restService.addArrayParams(newParams, 'autoTagOneOf', autoTagOneOf)+ if (Array.isArray(stateOneOf)) newParams = this.restService.addArrayParams(newParams, 'stateOneOf', stateOneOf)if (search) newParams = newParams.set('search', search)newParams = this.buildNSFWParams(newParams, { nsfw, nsfwFlagsExcluded, nsfwFlagsIncluded })diff --git a/client/src/app/shared/shared-video/video-state-badge.component.ts b/client/src/app/shared/shared-video/video-state-badge.component.tsindex 8c9b24fe4c..9ad4cde877 100644--- a/client/src/app/shared/shared-video/video-state-badge.component.ts+++ b/client/src/app/shared/shared-video/video-state-badge.component.ts@@ -1,6 +1,7 @@import { CommonModule } from '@angular/common'import { Component, input, OnChanges } from '@angular/core'-import { Video, VideoPrivacy, VideoState, VideoStateType } from '@peertube/peertube-models'+import { Video, VideoPrivacy, VideoState } from '@peertube/peertube-models'+import { getVideoStateBadgeClass, getVideoStateLabel } from './video-state-utils'@Component({selector: 'my-video-state-badge',@@ -10,21 +11,6 @@ import { Video, VideoPrivacy, VideoState, VideoStateType } from '@peertube/peertexport class VideoStateBadgeComponent implements OnChanges {readonly video = input.required<Pick<Video, 'privacy' | 'state' | 'waitTranscoding'>>()- private states: { [id in VideoStateType]: string } = {- [VideoState.PUBLISHED]: 'badge-green',- [VideoState.TO_TRANSCODE]: 'badge-brown',- [VideoState.TO_IMPORT]: 'badge-brown',- [VideoState.TO_IMPORT_FAILED]: 'badge-red',- [VideoState.WAITING_FOR_LIVE]: 'badge-blue',- [VideoState.LIVE_ENDED]: 'badge-green',- [VideoState.TO_MOVE_TO_EXTERNAL_STORAGE]: 'badge-brown',- [VideoState.TRANSCODING_FAILED]: 'badge-red',- [VideoState.TO_MOVE_TO_EXTERNAL_STORAGE_FAILED]: 'badge-red',- [VideoState.TO_EDIT]: 'badge-brown',- [VideoState.TO_MOVE_TO_FILE_SYSTEM]: 'badge-brown',- [VideoState.TO_MOVE_TO_FILE_SYSTEM_FAILED]: 'badge-brown'- }-label: stringbadgeClass: string@@ -41,7 +27,7 @@ export class VideoStateBadgeComponent implements OnChanges {}const state = video.state.id- this.badgeClass = this.states[video.state.id]+ this.badgeClass = getVideoStateBadgeClass(video.state.id)switch (state) {case VideoState.PUBLISHED:@@ -57,35 +43,7 @@ export class VideoStateBadgeComponent implements OnChanges {return}- this.label = $localize`Published`- return-- case VideoState.WAITING_FOR_LIVE:- this.label = $localize`Waiting live`- return-- case VideoState.LIVE_ENDED:- this.label = $localize`Live ended`- return-- case VideoState.TRANSCODING_FAILED:- this.label = $localize`Transcoding failed`- return-- case VideoState.TO_MOVE_TO_FILE_SYSTEM:- this.label = $localize`Moving to file system`- return-- case VideoState.TO_MOVE_TO_FILE_SYSTEM_FAILED:- this.label = $localize`Moving to file system failed`- return-- case VideoState.TO_MOVE_TO_EXTERNAL_STORAGE:- this.label = $localize`Moving to external storage`- return-- case VideoState.TO_MOVE_TO_EXTERNAL_STORAGE_FAILED:- this.label = $localize`Move to external storage failed`+ this.label = getVideoStateLabel(video.state.id)returncase VideoState.TO_TRANSCODE:@@ -94,20 +52,8 @@ export class VideoStateBadgeComponent implements OnChanges {: $localize`To transcode`return- case VideoState.TO_IMPORT:- this.label = $localize`To import`- return-- case VideoState.TO_IMPORT_FAILED:- this.label = $localize`Import failed`- return-- case VideoState.TO_EDIT:- this.label = $localize`To edit`- return-default:- return state satisfies never+ this.label = getVideoStateLabel(video.state.id)}}}diff --git a/client/src/app/shared/shared-video/video-state-utils.ts b/client/src/app/shared/shared-video/video-state-utils.tsnew file mode 100644index 0000000000..71dc744847--- /dev/null+++ b/client/src/app/shared/shared-video/video-state-utils.ts@@ -0,0 +1,43 @@+import { VideoState, VideoStateType } from '@peertube/peertube-models'++export function getAllVideoStates () {+ return Object.values(VideoState) as VideoStateType[]+}++export function getVideoStateLabel (state: VideoStateType) {+ const states = {+ [VideoState.PUBLISHED]: $localize`Published`,+ [VideoState.TO_TRANSCODE]: $localize`To transcode`,+ [VideoState.TO_IMPORT]: $localize`To import`,+ [VideoState.TO_IMPORT_FAILED]: $localize`Import failed`,+ [VideoState.WAITING_FOR_LIVE]: $localize`Waiting live`,+ [VideoState.LIVE_ENDED]: $localize`Live ended`,+ [VideoState.TRANSCODING_FAILED]: $localize`Transcoding failed`,+ [VideoState.TO_MOVE_TO_EXTERNAL_STORAGE]: $localize`Moving to external storage`,+ [VideoState.TO_MOVE_TO_EXTERNAL_STORAGE_FAILED]: $localize`Move to external storage failed`,+ [VideoState.TO_EDIT]: $localize`To edit`,+ [VideoState.TO_MOVE_TO_FILE_SYSTEM]: $localize`Moving to file system`,+ [VideoState.TO_MOVE_TO_FILE_SYSTEM_FAILED]: $localize`Moving to file system failed`+ }++ return states[state] || ''+}++export function getVideoStateBadgeClass (state: VideoStateType) {+ const states: { [id in VideoStateType]: string } = {+ [VideoState.PUBLISHED]: 'badge-green',+ [VideoState.TO_TRANSCODE]: 'badge-brown',+ [VideoState.TO_IMPORT]: 'badge-brown',+ [VideoState.TO_IMPORT_FAILED]: 'badge-red',+ [VideoState.WAITING_FOR_LIVE]: 'badge-blue',+ [VideoState.LIVE_ENDED]: 'badge-green',+ [VideoState.TO_MOVE_TO_EXTERNAL_STORAGE]: 'badge-brown',+ [VideoState.TRANSCODING_FAILED]: 'badge-red',+ [VideoState.TO_MOVE_TO_EXTERNAL_STORAGE_FAILED]: 'badge-red',+ [VideoState.TO_EDIT]: 'badge-brown',+ [VideoState.TO_MOVE_TO_FILE_SYSTEM]: 'badge-brown',+ [VideoState.TO_MOVE_TO_FILE_SYSTEM_FAILED]: 'badge-brown'+ }++ return states[state] || ''+}diff --git a/packages/models/src/search/videos-common-query.model.ts b/packages/models/src/search/videos-common-query.model.tsindex d993a14f15..6427347e7d 100644--- a/packages/models/src/search/videos-common-query.model.ts+++ b/packages/models/src/search/videos-common-query.model.ts@@ -1,5 +1,6 @@import { VideoIncludeType } from '../videos/video-include.enum.js'import { VideoPrivacyType } from '../videos/video-privacy.enum.js'+import { VideoStateType } from '../videos/video-state.enum.js'import { BooleanBothQuery } from './boolean-both-query.model.js'// These query parameters can be used with any endpoint that list videos@@ -42,6 +43,7 @@ export interface VideosCommonQuery {// Only available with special user rightautoTagOneOf?: string[]privacyOneOf?: VideoPrivacyType[]+ stateOneOf?: VideoStateType[]}export interface VideosCommonQueryAfterSanitize extends VideosCommonQuery {diff --git a/packages/server-commands/src/videos/videos-command.ts b/packages/server-commands/src/videos/videos-command.tsindex 690444abcd..c0e0559093 100644--- a/packages/server-commands/src/videos/videos-command.ts+++ b/packages/server-commands/src/videos/videos-command.ts@@ -666,6 +666,7 @@ export class VideosCommand extends AbstractCommand {'include','skipCount','autoTagOneOf',+ 'stateOneOf','search','includeScheduledLive'])diff --git a/packages/tests/src/api/check-params/videos-common-filters.ts b/packages/tests/src/api/check-params/videos-common-filters.tsindex f91a033707..d608a187ab 100644--- a/packages/tests/src/api/check-params/videos-common-filters.ts+++ b/packages/tests/src/api/check-params/videos-common-filters.ts@@ -1,7 +1,7 @@/* oxlint-disable @typescript-eslint/no-unused-expressions,@typescript-eslint/require-await */import { pick } from '@peertube/peertube-core-utils'-import { HttpStatusCode, HttpStatusCodeType, UserRole, VideoInclude, VideoPrivacy, VideosCommonQuery } from '@peertube/peertube-models'+import { HttpStatusCode, HttpStatusCodeType, UserRole, VideoInclude, VideoPrivacy, VideoState, VideosCommonQuery } from '@peertube/peertube-models'import {cleanupTests,createSingleServer,@@ -51,6 +51,7 @@ describe('Test video filters validators', function () {| 'include'| 'privacyOneOf'| 'autoTagOneOf'+ | 'stateOneOf'| 'excludeAlreadyWatched'| 'nsfw'| 'nsfwFlagsExcluded'@@ -88,6 +89,7 @@ describe('Test video filters validators', function () {'isLocal','privacyOneOf','autoTagOneOf',+ 'stateOneOf','include','excludeAlreadyWatched','filter',@@ -166,6 +168,32 @@ describe('Test video filters validators', function () {})})+ describe('State', function () {+ it('Should fail to use stateOneOf with a simple user', async function () {+ await testEndpoints({+ stateOneOf: [ VideoState.PUBLISHED ],+ token: userAccessToken,+ expectedStatus: HttpStatusCode.UNAUTHORIZED_401+ })+ })++ it('Should fail with an invalid stateOneOf value', async function () {+ await testEndpoints({+ stateOneOf: [ 'toto' ] as any,+ token: moderatorAccessToken,+ expectedStatus: HttpStatusCode.BAD_REQUEST_400+ })+ })++ it('Should succeed to use stateOneOf with a moderator', async function () {+ await testEndpoints({+ stateOneOf: [ VideoState.PUBLISHED, VideoState.TO_TRANSCODE ],+ token: moderatorAccessToken,+ expectedStatus: HttpStatusCode.OK_200+ })+ })+ })+describe('Include', function () {it('Should fail with a bad include', async function () {await testEndpoints({ include: 'toto' as any, expectedStatus: HttpStatusCode.BAD_REQUEST_400 })diff --git a/packages/tests/src/api/videos/videos-common-filters.ts b/packages/tests/src/api/videos/videos-common-filters.tsindex bbb71273c5..6ae67bf30f 100644--- a/packages/tests/src/api/videos/videos-common-filters.ts+++ b/packages/tests/src/api/videos/videos-common-filters.ts@@ -11,6 +11,7 @@ import {VideoIncludeType,VideoPrivacy,VideoPrivacyType,+ VideoState,VideosCommonQuery} from '@peertube/peertube-models'import {@@ -111,6 +112,7 @@ describe('Test videos filter', function () {'categoryOneOf','languageOneOf','privacyOneOf',+ 'stateOneOf','excludeAlreadyWatched','host','search'@@ -549,6 +551,20 @@ describe('Test videos filter', function () {expect(foundVideo).to.be.undefined}})++ it('Should filter by stateOneOf', async function () {+ for (const path of paths) {+ {+ const videos = await listVideos({ server: servers[0], path, stateOneOf: [ VideoState.PUBLISHED ] })+ expect(videos.length).to.be.at.least(1)+ }++ {+ const videos = await listVideos({ server: servers[0], path, stateOneOf: [ VideoState.TO_TRANSCODE ] })+ expect(videos).to.have.lengthOf(0)+ }+ }+ })})describe('Check sorts', function () {diff --git a/server/core/helpers/query.ts b/server/core/helpers/query.tsindex f1fca17dce..1e9c1f542a 100644--- a/server/core/helpers/query.ts+++ b/server/core/helpers/query.ts@@ -30,7 +30,8 @@ function pickCommonVideoQuery (query: VideosCommonQueryAfterSanitize) {'hasWebVideoFiles','search','excludeAlreadyWatched',- 'autoTagOneOf'+ 'autoTagOneOf',+ 'stateOneOf'])}diff --git a/server/core/middlewares/validators/videos/videos.ts b/server/core/middlewares/validators/videos/videos.tsindex a44981ca02..bf9355d690 100644--- a/server/core/middlewares/validators/videos/videos.ts+++ b/server/core/middlewares/validators/videos/videos.ts@@ -572,6 +572,10 @@ export const commonVideosFiltersValidatorFactory = (options: {.optional().customSanitizer(toArray).custom(isStringArray).withMessage('Should have a valid autoTagOneOf array'),+ query('stateOneOf')+ .optional()+ .customSanitizer(toArray)+ .custom(isNumberArray).withMessage('Should have a valid stateOneOf array'),query('host').optional().custom(isHostValid),@@ -591,10 +595,12 @@ export const commonVideosFiltersValidatorFactory = (options: {const user = res.locals.oauth?.token.Userif ((user?.hasRight(UserRight.SEE_ALL_VIDEOS) !== true)) {- if (query.include || (options.allowPrivacyFilterForAllUsers !== true && query.privacyOneOf) || query.autoTagOneOf) {+ if (+ query.include || (options.allowPrivacyFilterForAllUsers !== true && query.privacyOneOf) || query.autoTagOneOf || query.stateOneOf+ ) {return res.fail({status: HttpStatusCode.UNAUTHORIZED_401,- message: req.t('You are not allowed to see all videos, specify a custom include or auto tags filter')+ message: req.t('You are not allowed to see all videos, specify a custom include, auto tags or state filter')})}}diff --git a/server/core/models/video/sql/video/videos-id-list-query-builder.ts b/server/core/models/video/sql/video/videos-id-list-query-builder.tsindex 67aba70724..6907e4632e 100644--- a/server/core/models/video/sql/video/videos-id-list-query-builder.ts+++ b/server/core/models/video/sql/video/videos-id-list-query-builder.ts@@ -5,7 +5,8 @@ import {VideoIncludeType,VideoPrivacy,VideoPrivacyType,- VideoState+ VideoState,+ VideoStateType} from '@peertube/peertube-models'import { exists } from '@server/helpers/custom-validators/misc.js'import { WEBSERVER } from '@server/initializers/constants.js'@@ -57,6 +58,8 @@ export type BuildVideosListQueryOptions = {autoTagOneOf?: string[]+ stateOneOf?: VideoStateType[]+uuids?: string[]hasFiles?: boolean@@ -287,6 +290,10 @@ export class VideosIdListQueryBuilder extends AbstractRunQuery {this.whereAutoTagOneOf(options.autoTagOneOf)}+ if (options.stateOneOf) {+ this.whereStateOneOf(options.stateOneOf)+ }+if (options.privacyOneOf) {this.wherePrivacyOneOf(options.privacyOneOf)} else {@@ -676,6 +683,11 @@ export class VideosIdListQueryBuilder extends AbstractRunQuery {this.replacements.privacyOneOf = privacyOneOf}+ private whereStateOneOf (stateOneOf: VideoStateType[]) {+ this.and.push('"video"."state" IN (:stateOneOf)')+ this.replacements.stateOneOf = stateOneOf+ }+private whereUUIDs (uuids: string[]) {this.and.push('"video"."uuid" IN (' + createSafeIn(this.sequelize, uuids) + ')')}diff --git a/server/core/models/video/video.ts b/server/core/models/video/video.tsindex 6727ae7b7b..3a14853339 100644--- a/server/core/models/video/video.ts+++ b/server/core/models/video/video.ts@@ -1135,6 +1135,8 @@ export class VideoModel extends SequelizeModel<VideoModel> {autoTagOneOf?: string[]+ stateOneOf?: VideoStateType[]+includeCollaborations?: boolean // default false}) {VideoModel.throwIfPrivateIncludeWithoutUser(options)@@ -1156,6 +1158,7 @@ export class VideoModel extends SequelizeModel<VideoModel> {'languageOneOf','host','autoTagOneOf',+ 'stateOneOf','tagsOneOf','tagsAllOf','privacyOneOf',diff --git a/support/doc/api/openapi.yaml b/support/doc/api/openapi.yamlindex 9c98ac78d7..009aa27a63 100644--- a/support/doc/api/openapi.yaml+++ b/support/doc/api/openapi.yaml@@ -807,6 +807,7 @@ paths:- $ref: '#/components/parameters/hasWebVideoFiles'- $ref: '#/components/parameters/host'- $ref: '#/components/parameters/autoTagOneOfVideo'+ - $ref: '#/components/parameters/stateOneOfVideo'- $ref: '#/components/parameters/privacyOneOf'- $ref: '#/components/parameters/excludeAlreadyWatched'- $ref: '#/components/parameters/search'@@ -2419,6 +2420,7 @@ paths:- $ref: '#/components/parameters/hasWebVideoFiles'- $ref: '#/components/parameters/host'- $ref: '#/components/parameters/autoTagOneOfVideo'+ - $ref: '#/components/parameters/stateOneOfVideo'- $ref: '#/components/parameters/privacyOneOf'- $ref: '#/components/parameters/excludeAlreadyWatched'- $ref: '#/components/parameters/search'@@ -2526,6 +2528,7 @@ paths:- $ref: '#/components/parameters/hasWebVideoFiles'- $ref: '#/components/parameters/host'- $ref: '#/components/parameters/autoTagOneOfVideo'+ - $ref: '#/components/parameters/stateOneOfVideo'- $ref: '#/components/parameters/privacyOneOf'- $ref: '#/components/parameters/excludeAlreadyWatched'- $ref: '#/components/parameters/search'@@ -3111,6 +3114,7 @@ paths:- $ref: '#/components/parameters/hasWebVideoFiles'- $ref: '#/components/parameters/host'- $ref: '#/components/parameters/autoTagOneOfVideo'+ - $ref: '#/components/parameters/stateOneOfVideo'- $ref: '#/components/parameters/privacyOneOf'- $ref: '#/components/parameters/excludeAlreadyWatched'- $ref: '#/components/parameters/search'@@ -4991,6 +4995,7 @@ paths:- $ref: '#/components/parameters/hasWebVideoFiles'- $ref: '#/components/parameters/host'- $ref: '#/components/parameters/autoTagOneOfVideo'+ - $ref: '#/components/parameters/stateOneOfVideo'- $ref: '#/components/parameters/privacyOneOf'- $ref: '#/components/parameters/excludeAlreadyWatched'- $ref: '#/components/parameters/search'@@ -6207,6 +6212,7 @@ paths:- $ref: '#/components/parameters/hasWebVideoFiles'- $ref: '#/components/parameters/host'- $ref: '#/components/parameters/autoTagOneOfVideo'+ - $ref: '#/components/parameters/stateOneOfVideo'- $ref: '#/components/parameters/privacyOneOf'- $ref: '#/components/parameters/excludeAlreadyWatched'- name: startDate@@ -8503,6 +8509,19 @@ components:type: stringstyle: formexplode: true+ stateOneOfVideo:+ name: stateOneOf+ in: query+ required: false+ description: "**PeerTube >= 8.2** **Admins and moderators only** filter on videos that have one of these states"+ schema:+ oneOf:+ - $ref: '#/components/schemas/VideoStateConstant/properties/id'+ - type: array+ items:+ $ref: '#/components/schemas/VideoStateConstant/properties/id'+ style: form+ explode: truechannelNameOneOf:name: channelNameOneOfin: query