Method: musicTracks.list

Recupera una lista de pistas de música.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Es obligatorio. La versión superior, que contiene esta lista de pistas Formato: releases/{release}

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de pistas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 30 segmentos. El valor máximo es 50, y los valores superiores se convertirán a 50.
pageToken

string

Un token de página, recibido desde una llamada musicTracks.list anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a musicTracks.list deben coincidir con la llamada que proporcionó el token de la página.
onBehalfOfContentOwner

string

Identifica al propietario del contenido en cuyo nombre actúa el usuario. Este parámetro admite usuarios cuyas cuentas están asociadas con varios propietarios de contenido.
filter

object (TrackFilter)

Filtrado basado en varios parámetros en musicTracks.list.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es una respuesta para enumerar las pistas de música.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "tracks": [
    {
      object (MusicTrack)
    }
  ],
  "nextPageToken": string
}
Campos
tracks[]

object (MusicTrack)

Las pistas de música solicitadas
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

TrackFilter

Representación de una expresión para filtrar en musicTracks.list. Siempre tomamos la conjunción (AND lógico) de los filtros, por lo que un segmento debe cumplir con todos los criterios para que se muestre.

Representación JSON 
{
  "isrcs": [
    string
  ],
  "upcs": [
    string
  ],
  "titleMatches": string,
  "artistNameMatches": string,
  "externalVideoIds": [
    string
  ],
  "hasOpenChangeRequest": boolean,
  "hasClosedChangeRequest": boolean
}
Campos
isrcs[]

string

Es una lista de códigos ISRC sin distinción de mayúsculas o minúsculas de los segmentos que se recuperarán.
upcs[]

string

Es una lista de códigos UPC sin distinción de mayúsculas o minúsculas de los segmentos que se recuperarán.
titleMatches

string

Búsqueda de tokens (no distingue mayúsculas de minúsculas).
artistNameMatches

string

Búsqueda de tokens (no distingue mayúsculas de minúsculas).
externalVideoIds[]

string

Es una lista de videoIds externos sin distinción de mayúsculas o minúsculas de los segmentos que se recuperarán.
hasOpenChangeRequest

boolean

Al menos un ChangeRequest en estado abierto
hasClosedChangeRequest

boolean

Al menos un ChangeRequest con estado cerrado