Method: assets.get

Pobiera metadane określonego zasobu. Pamiętaj, że jeśli w żądaniu znajdzie się zasób, który został scalony z innym, czyli że YouTube rozpoznał żądany zasób jako duplikat, to żądanie zwróci scalony lub zsyntetyzowany zasób.

Żądanie HTTP

GET https://youtubepartner.googleapis.com/youtube/partner/v1/assets/{assetId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
assetId

string

Parametr assetId określa identyfikator pobieranego zasobu YouTube.

Parametry zapytania

Parametry
fetchMatchPolicy

string

Parametr fetchMatchPolicy określa wersję zasady dopasowania zasobu, która powinna zostać zwrócona w odpowiedzi interfejsu API.

Parametr fetchMatchPolicy określa rozdzieloną przecinkami listę wersji zasady dopasowania zasobu, które powinny zostać zwrócone w odpowiedzi interfejsu API. Wycofane pole matchPolicy jest ustawiane tylko wtedy, gdy określono dokładnie jedną wartość fetchMatchPolicy. Dopuszczalne wartości:

  • effective – pobierz zasadę dopasowania, którą YouTube stosuje do zasobu.
  • mine – pobierz zasadę dopasowania ustawioną przez domyślnego właściciela treści dla obecnie uwierzytelnionego użytkownika.
  • none – nie pobiera zasady dopasowania zasobu. jest to wartość domyślna
fetchMetadata

string

Parametr fetchMetadata określa wersję metadanych zasobu, która powinna zostać zwrócona w odpowiedzi interfejsu API. W niektórych przypadkach YouTube otrzymuje metadane zasobu z wielu źródeł, na przykład gdy prawa do zasobu należą do różnych partnerów w różnych regionach.

fetchOwnership

string

Parametr fetchOwnership określa wersję danych własności zasobu, która powinna zostać zwrócona w odpowiedzi interfejsu API. Podobnie jak w przypadku metadanych zasobów, YouTube może otrzymywać dane dotyczące własności z wielu źródeł.

Parametr fetchOwnership określa rozdzieloną przecinkami listę wersji danych własności zasobu, które powinny zostać zwrócone w odpowiedzi interfejsu API. Podobnie jak w przypadku metadanych zasobów, YouTube może otrzymywać dane dotyczące własności zasobu z wielu źródeł.

Wycofane pole ownership jest ustawiane tylko wtedy, gdy określono dokładnie jedną wartość fetchOwnership.

Akceptowane wartości to:

  • canonicalten parametr został wycofany. Zobacz effective.
  • effective – pobierz dane własności, które według algorytmów YouTube są najbardziej dokładne dla danego zasobu.
  • mine – pobierz dane o własności dostarczone przez domyślnego właściciela treści powiązanego z aktualnie uwierzytelnionym użytkownikiem.
  • none – nie pobiera żadnych danych o własności. jest to wartość domyślna
fetchOwnershipConflicts

boolean

Parametr fetchOwnershipConflicts umożliwia pobieranie informacji o konfliktach własności.

onBehalfOfContentOwner

string

Parametr onBehalfOfContentOwner wskazuje właściciela treści, w imieniu którego działa użytkownik. Ten parametr jest przeznaczony dla użytkowników, których konta są powiązane z wieloma właścicielami treści.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Asset.

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.