Method: musicTracks.list

Récupère une liste de titres musicaux.

Requête HTTP

GET https://youtubepartner.googleapis.com/youtube/partner/v1/music/{parent=releases/*}/tracks

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. L'album parent, qui contient cette liste de pistes. Format: releases/{release}

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de titres à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 30 pistes au maximum seront renvoyées. La valeur maximale est 50. les valeurs supérieures à 50 sont réduites à 50.
pageToken

string

Jeton de page reçu d'un appel musicTracks.list précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à musicTracks.list doivent correspondre à l'appel ayant fourni le jeton de page.
onBehalfOfContentOwner

string

Identifie le propriétaire du contenu pour lequel l'utilisateur agit. Ce paramètre prend en charge les utilisateurs dont les comptes sont associés à plusieurs propriétaires de contenu.
filter

object (TrackFilter)

Filtrage basé sur différents paramètres de musicTracks.list

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse à la liste de pistes musicales.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "tracks": [
    {
      object (MusicTrack)
    }
  ],
  "nextPageToken": string
}
Champs
tracks[]

object (MusicTrack)

Titres musicaux demandés.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/youtubepartner

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

TrackFilter

Représentation d'une expression pour le filtrage dans musicTracks.list. Nous prenons toujours la conjonction (opérateur logique ET) des filtres, de sorte qu'une piste doit répondre à tous les critères pour être renvoyée.

Représentation JSON 
{
  "isrcs": [
    string
  ],
  "upcs": [
    string
  ],
  "titleMatches": string,
  "artistNameMatches": string,
  "externalVideoIds": [
    string
  ],
  "hasOpenChangeRequest": boolean,
  "hasClosedChangeRequest": boolean
}
Champs
isrcs[]

string

Liste des codes ISRC des pistes à récupérer, qui ne sont pas sensibles à la casse.
upcs[]

string

Liste des codes UPC des titres à récupérer qui ne sont pas sensibles à la casse.
titleMatches

string

Recherche tokenisée (non sensible à la casse).
artistNameMatches

string

Recherche tokenisée (non sensible à la casse).
externalVideoIds[]

string

Liste des ID vidéo externes non sensibles à la casse des pistes à récupérer.
hasOpenChangeRequest

boolean

Au moins une demande de changement est en cours.
hasClosedChangeRequest

boolean

Au moins une demande de changement est à l'état fermé.