Method: references.insert

Tworzy plik referencyjny na jeden z tych sposobów:

  • Jeśli żądanie polega na przesłaniu pliku referencyjnego, YouTube tworzy plik referencyjny na podstawie podanych treści. Możesz podać plik wideo lub audio albo wstępnie wygenerowany odcisk palca. Jeśli podajesz wstępnie wygenerowany odcisk palca, w treści żądania ustaw właściwość reference zasobu fpDirect na true. W tym przypadku możesz użyć przesyłania wieloczęściowego lub przesyłania z możliwością wznowienia, aby podać treści referencyjne.
  • Jeśli chcesz utworzyć plik referencyjny, używając jako treści referencyjnych filmu objętego roszczeniem, użyj parametru claimId, aby zidentyfikować roszczenie.

Żądanie HTTP

  • Identyfikator URI przesyłania w przypadku żądań przesyłania multimediów:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • Identyfikator URI metadanych w przypadku żądań dotyczących tylko metadanych:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
claimId

string

Parametr claimId określa identyfikator roszczenia w YouTube, na podstawie którego ma zostać utworzony plik referencyjny. Jako treści referencyjne używany jest film objęty roszczeniem.

onBehalfOfContentOwner

string

Parametr onBehalfOfContentOwner określa 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 kilkoma właścicielami treści.

Treść żądania

Treść żądania zawiera wystąpienie elementu Reference.

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz tutaj: OAuth 2.0 Overview.