Method: musicReleases.list

Pobiera listę wydań muzycznych.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba wersji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 30 wersji. Maksymalna wartość to 50. wartości powyżej 50 zostaną zmienione na 50.
pageToken

string

Token strony otrzymany z poprzedniego wywołania funkcji musicReleases.list. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu musicReleases.list muszą być zgodne z wywołaniem, które dostarczyło token strony.
onBehalfOfContentOwner

string

Identyfikuje właściciela treści, w imieniu którego działa użytkownik. Ten parametr obsługuje użytkowników, których konta są powiązane z wieloma właścicielami treści.
filter

object (ReleaseFilter)

Filtrowanie na podstawie różnych parametrów w musicReleases.list.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Reakcja na listę premier muzycznych

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "releases": [
    {
      object (MusicRelease)
    }
  ],
  "nextPageToken": string
}
Pola
releases[]

object (MusicRelease)

Żądane wydania muzyczne.
nextPageToken

string

Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ReleaseFilter

Reprezentacja wyrażenia na potrzeby filtrowania w musicReleases.list. Zawsze stosujemy spójnik (logiczne ORAZ) w filtrach, więc wydanie musi spełnić wszystkie kryteria, by zostało zwrócone.

Zapis JSON 
{
  "upcs": [
    string
  ],
  "titleMatches": string,
  "artistNameMatches": string,
  "hasOpenChangeRequest": boolean,
  "hasClosedChangeRequest": boolean
}
Pola
upcs[]

string

Lista kodów UPC wersji do pobrania (bez rozróżniania wielkości liter).
titleMatches

string

Wyszukiwanie tokenizowane (wielkość liter nie jest rozróżniana).
artistNameMatches

string

Wyszukiwanie tokenizowane (wielkość liter nie jest rozróżniana).
hasOpenChangeRequest

boolean

Co najmniej 1 prośba ChangeRequest jest otwarta.
hasClosedChangeRequest

boolean

Co najmniej 1 żądanie zmiany ma status zamknięty.