Query media assets in ApsaraVideo VOD by using advanced search methods such as fuzzy match and multi-value query - ApsaraVideo VOD

Le protocole de recherche multimédia est un protocole de recherche en temps réel qui intègre la récupération, le filtrage, le tri et la pagination. Utilisez ce protocole pour interroger des informations sur les ressources multimédias, telles que les vidéos, les fichiers audio et les images, dans ApsaraVideo VOD. Cette rubrique décrit la syntaxe du protocole utilisé pour la recherche de ressources multimédias dans ApsaraVideo VOD. Vous devez utiliser ce protocole conjointement avec l'opération SearchMedia. Configurez le paramètre Match pour interroger des ressources multimédias en fonction des champs de retour, des champs utilisés pour la correspondance exacte, des champs utilisés pour la correspondance floue, des champs utilisés pour les requêtes multivaleurs, des champs utilisés pour les requêtes de plage et des champs de tri.

Syntaxe

Les champs des ressources multimédias sont classés dans les catégories suivantes, selon les règles de syntaxe définies dans le protocole de recherche multimédia : champs de retour, champs utilisés pour la correspondance exacte, champs utilisés pour la correspondance floue, champs utilisés pour les requêtes multivaleurs, champs utilisés pour les requêtes de plage et champs de tri. Pour plus d'informations sur tous les champs de ressources multimédias pris en charge par ApsaraVideo VOD et sur les règles de syntaxe applicables, consultez la section Informations sur les ressources multimédias.

Important

Lorsque vous appelez l'opération SearchMedia pour interroger des informations sur les ressources multimédias, encodez l'instruction de requête au format URL. De plus, utilisez des signes de ponctuation mono-octets tels que les signes égal (=), les guillemets doubles ("), les apostrophes (') et les parenthèses () dans l'instruction de requête. Pour plus d'informations sur les caractères spéciaux définis dans le protocole de recherche multimédia, consultez la section Caractères spéciaux.
Si vous utilisez d'autres méthodes de requête pour un champ qui prend en charge à la fois la correspondance exacte et la correspondance floue, les résultats renvoyés pour ce champ suivent les méthodes de requête prises en charge par le champ. Par exemple, si un champ ne prend en charge que la correspondance floue, les résultats renvoyés par les requêtes multivaleurs seront également basés sur une correspondance floue.

Le tableau suivant décrit la syntaxe définie dans le protocole de recherche multimédia et fournit des exemples de recherche.

Catégorie	Description	Syntaxe	Exemple
Champ de retour	Spécifie les champs à inclure dans les résultats de la recherche. Par défaut, seuls l'ID, l'heure de création et le type de chaque ressource multimédia sont renvoyés.	field1,field2	Champ de retour
Champ utilisé pour la correspondance exacte	Interroge les ressources multimédias dont la valeur d'un champ spécifique correspond exactement.	field = value	Correspondance exacte
Champ utilisé pour la correspondance floue	Interroge les informations sur les ressources multimédias dont la valeur d'un champ spécifié contient les caractères ou les chaînes spécifiés.	field in ('value1','value2') or field = 'value'	Correspondance floue
Champ utilisé pour une requête multivaluer	Interroge les informations sur les ressources multimédias qui correspondent à l'une des valeurs d'un champ spécifié. Si les champs utilisés pour la requête ne prennent en charge que la correspondance floue, les résultats de la requête sont également renvoyés sur la base d'une correspondance floue.	field in ('value1','value2')	Requête multivaluer
Champ utilisé pour une requête de plage	Interroge les ressources multimédias dont la valeur d'un champ spécifique se situe dans un intervalle ouvert ou fermé spécifié.	field = (value1,value2)	Requête de plage
Champs de tri	Spécifie les champs selon lesquels les résultats de la recherche sont triés, ainsi que l'ordre de tri. L'ordre décroissant et l'ordre croissant sont pris en charge. Plusieurs champs de tri sont affichés de gauche à droite en fonction de leurs priorités, par ordre décroissant.	SortBy = field:Desc	Champ de tri

Caractères spéciaux

Caractère	Description	Syntaxe
and	Connecte deux conditions de filtre pour interroger les ressources multimédias qui correspondent aux deux conditions.	field1 = 'value' and field2 = 'value'
or	Connecte deux conditions de filtre pour interroger les informations sur les ressources multimédias qui satisfont à l'une des conditions. Si vous utilisez l'opérateur OR dans l'instruction de requête, placez les conditions de filtre entre parenthèses ().	(field1 = 'value1' or field2 = 'value2')
( )	Délimite un intervalle ouvert ou fermé spécifié pour une requête de plage.	field = ('value1','value2')
( )	Englobe plusieurs conditions de filtre liées par une relation OR.	(field1 = 'value1' or field2 = 'value2')
' '	Englobe les valeurs de champ de type STRING.	field = 'value'
,	Sépare plusieurs valeurs de champ pour une requête multivaluer. Vous pouvez séparer plusieurs valeurs de champ par des virgules (,).	field in ('value1','value2')
( ) [ ]	Spécifie un intervalle ouvert ou fermé pour une requête de plage. Vous pouvez indiquer si les extrémités gauche et droite de l'intervalle doivent être incluses ou exclues.	field = ['value1','value2']
in	Spécifie plusieurs valeurs pour un champ dans une requête multivaluer afin d'interroger les informations sur les ressources multimédias qui correspondent à l'une des valeurs du champ spécifié.	field in ('value1','value2')

Informations sur les ressources multimédias

ApsaraVideo VOD vous permet d'interroger des informations sur des fichiers vidéo, audio et image spécifiés, ainsi que sur des ressources multimédias auxiliaires. Les tableaux suivants décrivent les règles de syntaxe applicables aux différents champs des ressources multimédias. Dans les tableaux ci-dessous, le symbole √ indique que le champ est pris en charge et le symbole × indique qu'il ne l'est pas.

Important

Vous pouvez spécifier au maximum trois valeurs pour les requêtes multivaleurs. Les valeurs supplémentaires sont ignorées.
Chaque chaîne utilisée pour la correspondance floue peut comporter jusqu'à 60 caractères.
Si vous n'obtenez pas de résultat précis lors d'une recherche floue en utilisant le champ Title conjointement avec un autre champ, vérifiez votre instruction pour détecter d'éventuelles erreurs de format. Exemple de recherche floue : (Title = 'Test' and Description = 'Description').
Si les champs ne prennent en charge que la correspondance floue, les résultats de la requête sont également renvoyés sur la base d'une correspondance floue pour les requêtes multivaleurs.

Vidéo : informations sur une vidéo

Champ	Type	Description	Utilisé comme champ de retour	Utilisé pour la correspondance exacte	Utilisé pour la correspondance floue	Utilisé pour une requête multivaluer	Utilisé pour une requête de plage	Utilisé comme champ de tri
VideoId	String	ID de la vidéo.	✓	✓	×	✓	×	×
AppId	String	ID de l'application.	✓	×	×	✓	×	×
CateId	Long	ID de la catégorie à laquelle appartient la vidéo.	✓	✓	×	×	×	×
CateName	String	Nom de la catégorie à laquelle appartient la vidéo.	✓	×	×	×	×	×
StorageLocation	String	Région où la vidéo est stockée.	✓	✓	×	✓	×	×
Title	String	Titre de la vidéo.	✓	×	✓	×	×	×
Tags	String	Tags de la vidéo.	✓	×	✓	✓	×	×
Description	String	Description de la vidéo.	✓	×	✓	×	×	×
Status	String	État de la vidéo.	✓	×	×	✓	×	×
MediaSource	String	Source de la vidéo.	✓	×	×	✓	×	×
PreprocessStatus	String	État de prétraitement de la vidéo.	✓	×	×	✓	×	×
Size	Long	Taille de la vidéo.	✓	×	×	×	✓	×
Duration	Float	Durée de la vidéo.	✓	×	×	×	✓	×
CreationTime	String	Date de création de la vidéo.	✓	×	×	×	✓	✓
ModificationTime	String	Date de la dernière mise à jour de la vidéo.	✓	×	×	×	✓	✓
CoverURL	String	URL de la vignette.	✓	×	×	×	×	×
Snapshots	String[]	Liste des instantanés automatiques.	✓	×	×	×	×	×
SpriteSnapshots	String[]	Liste des sprites d'image.	✓	×	×	×	×	×
DownloadSwitch	String	Indique si le téléchargement hors ligne est activé.	✓	×	×	×	×	×
TranscodeMode	String	Mode de transcodage de l'audio.	✓	×	×	×	×	×
StorageClass	String	Classe de stockage de l'audio.	✓	×	×	✓	×	×

Audio : informations sur un fichier audio

Champ	Type	Description	Utilisé comme champ de retour	Utilisé pour la correspondance exacte	Utilisé pour la correspondance floue	Utilisé pour une requête multivaluer	Utilisé pour une requête de plage	Utilisé comme champ de tri
AudioId	String	ID du fichier audio.	✓	✓	×	×	×	×
AppId	String	ID de l'application.	✓	×	×	✓	×	×
CateId	Long	ID de la catégorie à laquelle appartient le fichier audio.	✓	✓	×	×	×	×
CateName	String	Nom de la catégorie à laquelle appartient le fichier audio.	✓	×	×	×	×	×
StorageLocation	String	Région où le fichier audio est stocké.	✓	×	×	✓	×	×
Title	String	Titre du fichier audio.	✓	×	✓	×	×	×
Tags	String	Tags du fichier audio.	✓	×	✓	✓	×	×
Description	String	Description du fichier audio.	✓	×	✓	×	×	×
Status	String	État du fichier audio.	✓	×	×	✓	×	×
MediaSource	String	Source du fichier audio.	✓	×	×	✓	×	×
PreprocessStatus	String	État de prétraitement du fichier audio.	✓	×	×	✓	×	×
Size	Long	Taille du fichier audio.	✓	×	×	×	✓	×
Duration	Float	Durée du fichier audio.	✓	×	×	×	✓	×
CreationTime	String	Date de création du fichier audio.	✓	×	×	×	✓	✓
ModificationTime	String	Date de la dernière mise à jour du fichier audio.	✓	×	×	×	✓	✓
CoverURL	String	URL de la vignette.	✓	×	×	×	×	×
Snapshots	String[]	Liste des instantanés automatiques.	✓	×	×	×	×	×
SpriteSnapshots	String[]	Liste des sprites d'image.	✓	×	×	×	×	×
DownloadSwitch	String	Indique si le téléchargement hors ligne est activé.	✓	×	×	×	×	×
TranscodeMode	String	Mode de transcodage de l'audio.	✓	×	×	×	×	×
StorageClass	String	Classe de stockage de l'audio.	✓	×	×	✓	×	×

Image : informations sur une image

Champ	Type	Description	Utilisé comme champ de retour	Utilisé pour la correspondance exacte	Utilisé pour la correspondance floue	Utilisé pour une requête multivaluer	Utilisé pour une requête de plage	Utilisé comme champ de tri
ImageId	String	ID de l'image.	✓	✓	×	×	×	×
AppId	String	ID de l'application.	✓	×	×	✓	×	×
CateId	Long	ID de la catégorie à laquelle appartient l'image.	✓	✓	×	×	×	×
CateName	String	Nom de la catégorie à laquelle appartient l'image.	✓	×	×	×	×	×
StorageLocation	String	Région où l'image est stockée.	✓	✓	×	✓	×	×
FileName	String	Nom de fichier de l'image.	✓	×	✓	×	×	×
Title	String	Titre de l'image.	✓	×	✓	×	×	×
Tags	String	Tags de l'image.	✓	×	✓	✓	×	×
Description	String	Description de l'image.	✓	×	✓	×	×	×
Status	String	État de l'image.	✓	×	×	✓	×	×
CreationTime	String	Date de création de l'image.	✓	×	×	×	✓	✓
ModificationTime	String	Date de la dernière mise à jour de l'image.	✓	×	×	×	✓	✓
URL	String	URL de l'image.	✓	×	×	×	×	×

AttachedMedia : informations sur une ressource multimédia auxiliaire

Champ	Type	Description	Utilisé comme champ de retour	Utilisé pour la correspondance exacte	Utilisé pour la correspondance floue	Utilisé pour une requête multivaluer	Utilisé pour une requête de plage	Utilisé comme champ de tri
MediaId	String	ID de la ressource multimédia auxiliaire.	✓	✓	×	×	×	×
AppIdString	String	ID de l'application.	✓	×	×	✓	×	×
CateId	Long	ID de la catégorie à laquelle appartient la ressource multimédia auxiliaire.	×	✓	×	×	×	×
Categories	Catégorie[]	Liste des ID de catégorie.	✓	×	×	×	×	×
StorageLocation	String	Région où la ressource multimédia auxiliaire est stockée.	✓	✓	×	✓	×	×
FileName	String	Nom de fichier de la ressource multimédia auxiliaire.	✓	×	✓	×	×	×
Title	String	Titre de la ressource multimédia auxiliaire.	✓	×	✓	×	×	×
Tags	String	Tags de la ressource multimédia auxiliaire.	✓	×	✓	✓	×	×
Description	String	Description de la ressource multimédia auxiliaire.	✓	×	✓	×	×	×
Status	String	État de la ressource multimédia auxiliaire.	✓	×	×	✓	×	×
CreationTime	String	Date de création de la ressource multimédia auxiliaire.	✓	×	×	×	✓	✓
ModificationTime	String	Date de la dernière mise à jour de la ressource multimédia auxiliaire.	✓	×	×	×	✓	✓
URL	String	URL de la ressource multimédia auxiliaire.	✓	×	×	×	×	×
BusinessType	String	Type d'activité.	✓	✓	×	×	×	×

Description des paramètres

PreprocessStatus : état de prétraitement d'une ressource multimédia

Seules les ressources multimédias prétraitées peuvent être utilisées pour la diffusion en direct dans un studio de production.

Valeur	Description	Remarques
UnPreprocess	La ressource multimédia n'est pas prétraitée.	État initial.
Preprocessing	La ressource multimédia est en cours de prétraitement.	-
PreprocessSucceed	Le prétraitement est terminé.	-
PreprocessFailed	Le prétraitement a échoué.	-

DownloadSwitch : activation ou désactivation du téléchargement hors ligne pour une ressource multimédia

Une ressource multimédia ne peut être téléchargée en mode hors ligne que si le téléchargement hors ligne est activé.

Valeur	Description	Remarques
on	Le téléchargement hors ligne est activé.	État initial. La ressource multimédia peut être téléchargée en mode hors ligne.
off	Le téléchargement hors ligne est désactivé.	Si le téléchargement hors ligne est désactivé, la ressource multimédia ne peut pas être téléchargée en mode hors ligne.

MediaSource : source d'une ressource multimédia

Valeur	Description	Remarques
general	La ressource multimédia est importée vers ApsaraVideo VOD via la console.	Mode d'importation simple.
short_video	La ressource multimédia est importée vers ApsaraVideo VOD via le SDK de vidéo courte.	Pour plus d'informations, consultez la section Présentation.
editing	La ressource multimédia est importée vers ApsaraVideo VOD lors de la création d'une tâche de production vidéo.	Pour plus d'informations, consultez la section ProduceEditingProjectVideo.
live	La ressource multimédia est importée vers ApsaraVideo VOD sous forme d'enregistrement de diffusion en direct.	Aucune.

TranscodeMode : mode de transcodage d'une ressource multimédia

Après l'importation d'une ressource multimédia dans ApsaraVideo VOD, celle-ci ne peut être lue qu'après traitement. Les méthodes de traitement varient selon les modes de transcodage.

Valeur	Description	Remarques
FastTranscode	Transcodage standard.	Mode par défaut. La ressource multimédia est immédiatement transcodée après son importation dans ApsaraVideo VOD. Elle ne peut être lue qu'après transcodage.
NoTranscode	Distribution sans transcodage	Les ressources multimédias aux formats suivants peuvent être lues immédiatement sans transcodage après leur importation dans ApsaraVideo VOD : MP4, FLV, M3U8, MP3 et WEBM.
AsyncTranscode	Distribution immédiate et transcodage une fois importé	Après l'importation d'une ressource multimédia dans ApsaraVideo VOD, celle-ci peut être lue immédiatement et transcodée de manière asynchrone.

StorageClass : classe de stockage d'une ressource multimédia

Valeur	Description	Remarques
Standard	Classe de stockage Standard	Toutes les ressources multimédias, y compris les fichiers sources et les flux transcodés, sont stockées en tant qu'objets Standard. Les ressources telles que les instantanés ne sont pas stockées en tant qu'objets Standard.
IA	Classe de stockage à accès peu fréquent (IA)	Toutes les ressources multimédias, y compris les fichiers sources et les flux transcodés, sont stockées en tant qu'objets IA. Les ressources telles que les instantanés ne sont pas stockées en tant qu'objets IA.
Archive	Classe de stockage Archive	Toutes les ressources multimédias, y compris les fichiers sources et les flux transcodés, sont stockées en tant qu'objets Archive. Les ressources telles que les instantanés ne sont pas stockées en tant qu'objets Archive.
ColdArchive	Classe de stockage Cold Archive	Toutes les ressources multimédias, y compris les fichiers sources et les flux transcodés, sont stockées en tant qu'objets Cold Archive. Les ressources telles que les instantanés ne sont pas stockées en tant qu'objets Cold Archive.
SourceIA	Stockage IA pour les fichiers sources	Seuls les fichiers sources sont des objets IA. Les ressources autres que les fichiers sources sont stockées en tant qu'objets Standard.
SourceArchive	Stockage Archive pour les fichiers sources	Seuls les fichiers sources sont des objets Archive. Les ressources autres que les fichiers sources sont stockées en tant qu'objets Standard.
SourceColdArchive	Stockage Cold Archive pour les fichiers sources	Seuls les fichiers sources sont des objets Cold Archive. Les ressources autres que les fichiers sources sont stockées en tant qu'objets Standard.
Changing	Classe de stockage des ressources multimédias en cours de modification	La classe de stockage des ressources multimédias est en cours de modification.
SourceChanging	Classe de stockage du fichier source en cours de modification	La classe de stockage du fichier source est en cours de modification.