Method: musicReleases.list

Recupera una lista de lanzamientos musicales.

Solicitud HTTP

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

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

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de versiones que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 30 versiones. 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 musicReleases.list anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a musicReleases.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 (ReleaseFilter)

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

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Una respuesta para enumerar los lanzamientos musicales.

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

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

object (MusicRelease)

Los lanzamientos musicales solicitados
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.

ReleaseFilter

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

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

string

Es una lista de códigos UPC que no distinguen mayúsculas de minúsculas de los lanzamientos 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).
hasOpenChangeRequest

boolean

Al menos un ChangeRequest en estado abierto
hasClosedChangeRequest

boolean

Al menos un ChangeRequest con estado cerrado