Activities: list

YouTube a abandonné la fonctionnalité de bulletin de chaîne. La méthode activities.list ne renvoie plus de bulletins de chaîne, et la méthode activities.insert n'est plus compatible. Pour en savoir plus, veuillez consulter le Centre d'aide YouTube.

Renvoie une liste d'événements d'activité de chaîne qui correspondent aux critères de la requête. Par exemple, vous pouvez récupérer des événements associés à une chaîne spécifique ou à la propre chaîne de l'utilisateur.

Impact sur le quota : un appel à cette méthode coûte 1 unité de quota.

Cas d'utilisation courants

Requête

Requête HTTP

GET https://www.googleapis.com/youtube/v3/activities

Paramètres

Le tableau suivant répertorie les paramètres compatibles avec cette requête. Tous les paramètres listés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
part	string Le paramètre part spécifie une liste de une ou plusieurs propriétés de ressource activity séparées par une virgule que la réponse de l'API inclura. Si le paramètre identifie une propriété qui contient des propriétés enfants, celles-ci seront incluses dans la réponse. Par exemple, dans une ressource activity, la propriété snippet contient d'autres propriétés qui identifient le type d'activité, un titre à afficher pour l'activité, etc. Si vous définissez part=snippet, la réponse de l'API contiendra également toutes ces propriétés imbriquées. La liste suivante contient les part noms que vous pouvez inclure dans la valeur du paramètre : contentDetails id snippet
Filtres (spécifiez exactement l'un des paramètres suivants)
channelId	string Le paramètre channelId spécifie un ID de la chaîne YouTube unique. L'API renvoie ensuite une liste des activités de cette chaîne.
home	boolean Remarque : Ce paramètre a été abandonné. Pour les requêtes qui définissent ce paramètre, la réponse de l'API contient des éléments semblables à ceux qu'un utilisateur déconnecté verrait sur la page d'accueil YouTube. Notez que ce paramètre ne peut être utilisé que dans une requête correctement autorisée.
mine	boolean Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. Définissez la valeur de ce paramètre sur true pour récupérer un flux des activités de l'utilisateur authentifié.
Paramètres facultatifs
maxResults	unsigned integer Le paramètre maxResults spécifie le nombre maximal d'éléments à renvoyer dans l'ensemble de résultats. Les valeurs acceptables sont comprises entre 0 et 50 inclus. La valeur par défaut est 5.
pageToken	string Le paramètre pageToken identifie une page spécifique de l'ensemble de résultats à renvoyer. Dans une réponse de l'API, les propriétés nextPageToken et prevPageToken identifient d'autres pages qui pourraient être récupérées.
publishedAfter	datetime Le paramètre publishedAfter spécifie la date et l'heure les plus anciennes auxquelles une activité a pu se produire pour être incluse dans la réponse de l'API. Si la valeur du paramètre spécifie un jour, mais pas une heure, toutes les activités qui ont eu lieu ce jour-là seront incluses dans l'ensemble de résultats. La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
publishedBefore	datetime Le paramètre publishedBefore spécifie la date et l'heure avant lesquelles une activité doit avoir eu lieu pour être incluse dans la réponse de l'API. Si la valeur du paramètre spécifie un jour, mais pas une heure, toutes les activités qui ont eu lieu ce jour-là seront exclues de l'ensemble de résultats. La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
regionCode	string Le paramètre regionCode demande à l'API de renvoyer les résultats pour le pays spécifié. La valeur du paramètre est un code pays ISO 3166-1 alpha-2. YouTube utilise cette valeur lorsque l'activité précédente de l'utilisateur autorisé sur YouTube ne fournit pas suffisamment d'informations pour générer le flux d'activité.

Corps de la requête

Ne fournissez pas de corps de requête lorsque vous appelez cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "kind": "youtube#activityListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    activity Resource
  ]
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource :

Propriétés
kind	string Identifie le type de ressource de l'API. La valeur sera youtube#activityListResponse.
etag	etag L'Etag de cette ressource.
nextPageToken	string Le jeton qui peut être utilisé comme valeur du paramètre pageToken pour récupérer la page suivante dans l'ensemble de résultats.
prevPageToken	string Le jeton qui peut être utilisé comme valeur du paramètre pageToken pour récupérer la page précédente dans l'ensemble de résultats.
pageInfo	object L'objet pageInfo encapsule les informations de pagination pour l'ensemble de résultats.
pageInfo.totalResults	integer Le nombre total de résultats dans l'ensemble de résultats.
pageInfo.resultsPerPage	integer Le nombre de résultats inclus dans la réponse de l'API.
items[]	list Liste des activités ou des événements qui correspondent aux critères de la requête.

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API peut renvoyer en réponse à un appel à cette méthode. Pour en savoir plus, veuillez consulter la documentation sur les messages d'erreur.

Type d'erreur	Détails de l'erreur	Description
forbidden (403)	forbidden	La requête n'est pas correctement autorisée.
forbidden (403)	homeParameterDeprecated	Les données d'activité de la page d'accueil de l'utilisateur ne sont pas disponibles via cette API. Cette erreur peut se produire si vous définissez le paramètre home sur true dans une requête non autorisée.
notFound (404)	channelNotFound	Impossible de trouver l'ID de la chaîne identifié par le paramètre channelId de la requête.
notFound (404)	homeChannelNotFound	Impossible de trouver un flux de page d'accueil YouTube pour l'utilisateur actuellement authentifié.
unauthorized (401)	authorizationRequired	La requête utilise le paramètre home, mais n'est pas correctement autorisée.

Essayer

Utilisez l'APIs Explorer pour appeler cette API et afficher la requête et la réponse de l'API.