DescribeVodPlayerMetricData - - Centre de documentation Alibaba Cloud

Consulte les données métriques du lecteur.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

vod:DescribeVodPlayerMetricData

none

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
AppId	string	Oui	L'identifiant de l'application.	app-1000000
StartTime	string	Oui	L'heure de début de la requête. Format : aaaa-mm-jjthh:mm:ssz (UTC). Remarque Prend en charge l'interrogation de l'historique des données de lecture pour l'année écoulée. La plage de temps pour une requête unique ne peut pas dépasser 31 jours. L'intervalle de temps est fermé à gauche et ouvert à droite [StartTime, EndTime).	2025-06-24T00:55:06Z
EndTime	string	Oui	L'heure de fin de la requête. Format : aaaa-mm-jjthh:mm:ssz (UTC).	2025-06-05T15:59:59Z
Interval	string	Oui	La granularité temporelle pour l'interrogation des données. Valeurs valides : 5m, 1h et 1d. La granularité temporelle prise en charge dépend de l'intervalle de temps entre `StartTime` et `EndTime` : Dans un délai de 3 jours : 5m, 1h et 1d. De 4 à 7 jours : 1h et 1d. Plus de 7 jours : 1d.	1d
TerminalType	string	Oui	Le type de terminal. Valeurs valides : web : web. mobile : natif.	web
Filters	string	Non	Les filtres de dimension de métrique. Une dimension se compose d'un type de dimension (Field), d'un opérateur (Op) et d'une valeur de dimension. Remarque Un maximum de trois dimensions peut être spécifié. Lorsque le paramètre Metrics inclut les quatre métriques suivantes, les filtres (Filters) ne prennent pas effet : Uv (utilisateurs de lecture), AvgPerVv (lectures moyennes par utilisateur), AvgPerPlayDuration (durée de lecture moyenne par utilisateur) et AvgPerCompletionVv (lectures complètes moyennes par utilisateur). Pour les provinces et les pays, transmettez le regionCode. Séparez les valeurs multiples par #_#. Valeurs valides pour le type de dimension (Field) : SdkVersion : version du SDK. AppVersion : version de l'application. Codec : codec. VideoType : format vidéo. Network : type de réseau. Country : pays. Isp : FAI. VideoDefinition : résolution. Domain : nom de domaine. Province : province. IsHw : indique si le décodage matériel est utilisé. ErrorCode : code d'erreur. Valeurs valides pour l'opérateur (Op) : = (égal à), > (supérieur à), < (inférieur à) et != (différent de). Remarque SdkVersion et VideoDefinition prennent en charge les quatre opérateurs. Les autres métriques ne prennent en charge que = (égal à) et != (différent de). Récupérez les valeurs de dimension en appelant DescribeVodPlayerDimensionData.	[ { "Field": "codec", "Op": "=", "Value": "h265#_#h264" }, { "Field": "os", "Op": "=", "Value": "Android#_#iOS" } ]
Metrics	string	Oui	Les types de métriques. Vous pouvez sélectionner plusieurs métriques (jusqu'à 3). Remarque Les données de pourcentage sont renvoyées sous forme décimale. Métriques de qualité de service (QoS) : Vv : nombre de lectures. RealVv : nombre de lectures réelles. FirstFrame : temps de la première image. SecondPlayRate : taux de lecture instantané. SlowPlayRate : taux de lecture lente. StuckCountRate : taux de saccades par nombre. SeekDuration : durée de recherche. StuckDuration100s : durée de saccades pour 100 secondes. StuckCount100s : nombre de saccades pour 100 secondes. PlayFailRate : taux d'échec de lecture. SeedFailRate : taux de non-lecture. AvgPlayBitrate : débit binaire moyen de lecture. AvgStartBitrate : débit binaire moyen de démarrage. ErrorCount100s : nombre d'erreurs pour 100 secondes. Métriques de qualité d'expérience (QoE) : Uv : utilisateurs de lecture. AvgPerVv : lectures moyennes par utilisateur. AvgVideoDuration : durée vidéo moyenne. AvgPerPlayDuration : durée de lecture moyenne par utilisateur. AvgPerCompletionVv : lectures complètes moyennes par utilisateur. CompletionVv : nombre de lectures complètes. CompletionRate : taux de complétion. AvgPlayDuration : durée de lecture moyenne. JumpRate5s : taux de rebond à 5 secondes.	Vv,Uv,AvgPerVv
Top	integer	Non	Renvoie les données des N premiers éléments classés par nombre de lectures. Si ce paramètre n'est pas spécifié, les données de toutes les dimensions sont renvoyées.	5
PageNumber	integer	Non	Le numéro de page. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées par page. Valeur par défaut : 5000. Valeur maximale : 5000.	5000
Language	string	Non	La langue de la réponse. Valeurs valides : zh (par défaut) : chinois simplifié. en : anglais.	zh
Os	string	Non	Le système d'exploitation du lecteur. Spécifiez ce paramètre pour effectuer une requête filtrée pour les données de lecture d'un système d'exploitation spécifique. Valeurs valides : Android, iOS, Harmony, Windows, MacOS et Linux. Les valeurs disponibles varient selon le type de terminal : native : Android, iOS, Harmony. web : Android, iOS, Harmony, Windows, MacOS, Linux. Séparez les valeurs multiples par #_#.	Android,iOS,Windows

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	25818875-5F78-4A*****F6-D7393642CA58
PageNumber	integer	Le numéro de page actuel.	1
PageSize	integer	La taille de la page.	5000
TotalCnt	integer	Le nombre total de points de données.	500
DataList	array<object>	La liste des données renvoyées.
	object
TimeStamp	string	L'horodatage des données. Format : aaaa-mm-jjthh:mm:ssz (UTC).	2025-06-24T00:55:06Z
Dimension	string	La dimension.	H265_MP4_WIFI
Uv	number	Le nombre d'utilisateurs de lecture.	500
Vv	number	Le nombre de lectures.	800
RealVv	number	Le nombre de lectures réelles.	1000
FirstFrame	number	Le temps de la première image, en millisecondes (ms).	100
SecondPlayRate	number	Le taux de lecture instantané.	0.8
SlowPlayRate	number	Le taux de lecture lente.	0.2
StuckCountRate	number	Le taux de saccades par nombre.	0.1
SeekDuration	number	La durée de recherche, en millisecondes (ms).	100
StuckDuration100s	number	La durée de saccades pour 100 secondes, en millisecondes (ms).	200
PlayFailRate	number	Le taux d'échec de lecture.	0.2
SeedFailRate	number	Le taux de non-lecture.	0.01
AvgPlayBitrate	number	Le débit binaire moyen de lecture, en bps.	100
AvgStartBitrate	number	Le débit binaire moyen de démarrage, en bps.	100
ErrorCount100s	number	Le nombre d'erreurs pour 100 secondes.	1
AvgPerVv	number	Le nombre moyen de lectures par utilisateur.	10
AvgVideoDuration	number	La durée vidéo moyenne, en millisecondes (ms).	100000
AvgPerPlayDuration	number	La durée de lecture moyenne par utilisateur, en millisecondes (ms).	100000
AvgPerCompletionVv	number	Le nombre moyen de lectures complètes par utilisateur.	2
CompletionVv	number	Le nombre de lectures complètes.	500
CompletionRate	number	Le taux de complétion.	0.8
AvgPlayDuration	number	La durée de lecture moyenne, en millisecondes (ms).	100000
JumpRate5s	number	Le taux de rebond à 5 secondes.	0.1
TotalPlayDuration	number	La durée totale de lecture, en millisecondes (ms).	100000
StuckCount100s	string	Le nombre de saccades pour 100 secondes.	2
Extend	object	Les informations étendues.
ActualStartTime	string	L'heure la plus ancienne avec des points de données dans la plage de temps spécifiée. Format : aaaa-mm-jjthh:mm:ssz (UTC).	2025-06-24T00:55:06Z
ActualEndTime	string	L'heure la plus récente avec des points de données dans la plage de temps spécifiée. Format : aaaa-mm-jjthh:mm:ssz (UTC).	2025-06-05T15:59:59Z
IntervalSeconds	integer	La granularité temporelle des données interrogées, en secondes (s).	3600

Exemples

JSON format

{
  "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
  "PageNumber": 1,
  "PageSize": 5000,
  "TotalCnt": 500,
  "DataList": [
    {
      "TimeStamp": "2025-06-24T00:55:06Z\n",
      "Dimension": "H265_MP4_WIFI",
      "Uv": 500,
      "Vv": 800,
      "RealVv": 1000,
      "FirstFrame": 100,
      "SecondPlayRate": 0.8,
      "SlowPlayRate": 0.2,
      "StuckCountRate": 0.1,
      "SeekDuration": 100,
      "StuckDuration100s": 200,
      "PlayFailRate": 0.2,
      "SeedFailRate": 0.01,
      "AvgPlayBitrate": 100,
      "AvgStartBitrate": 100,
      "ErrorCount100s": 1,
      "AvgPerVv": 10,
      "AvgVideoDuration": 100000,
      "AvgPerPlayDuration": 100000,
      "AvgPerCompletionVv": 2,
      "CompletionVv": 500,
      "CompletionRate": 0.8,
      "AvgPlayDuration": 100000,
      "JumpRate5s": 0.1,
      "TotalPlayDuration": 100000,
      "StuckCount100s": "2"
    }
  ],
  "Extend": {
    "ActualStartTime": "2025-06-24T00:55:06Z",
    "ActualEndTime": "2025-06-05T15:59:59Z",
    "IntervalSeconds": 3600
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	Meter.ParamError	Param Error:%s,Please Check Again.	One or more parameters are invalid.
500	Meter.ServerInternalError	The Request Processing Has Failed Due To Some Unknown Error.	An internal error occurred.
500	Meter.DataSourceQueryError	Data Source Error:%s,Please Try Again.	An internal data source error occurred.
403	Meter.AuthError	Authentication Failed,Please Try Again.	You do not have permissions to perform this operation.
502	Meter.ReadyTsError	Get ReadyTs Failed,Please Try Again.	The data is not prepared.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.