Method: musicReleases.list

Récupère une liste de sorties musicales.

Requête HTTP

GET https://youtubepartner.googleapis.com/youtube/partner/v1/music/releases

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de versions à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 30 versions 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 musicReleases.list précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à musicReleases.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 (ReleaseFilter)

Filtrage basé sur différents paramètres dans musicReleases.list.

Corps de la requête

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

Corps de la réponse

Réponse pour lister des sorties musicales.

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

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

object (MusicRelease)

Sorties musicales demandées.
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.

ReleaseFilter

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

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

string

Liste des codes UPC des versions à récupérer, non sensibles à la casse.
titleMatches

string

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

string

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

boolean

Au moins une demande de changement est en cours.
hasClosedChangeRequest

boolean

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