Method: references.insert

Tworzy plik referencyjny na jeden z tych sposobów:

  • Jeśli przesyłasz plik referencyjny, YouTube utworzy plik referencyjny na podstawie przesłanych treści. Możesz przesłać plik wideo/audio lub wstępnie wygenerowany odcisk cyfrowy. Jeśli dostarczasz wstępnie wygenerowany odcisk cyfrowy, ustaw właściwość fpDirect zasobu reference na true w treści żądania. Aby przesłać treści referencyjne, możesz skorzystać z procesu przesyłania wieloczęściowego lub resumable.
  • Jeśli chcesz utworzyć plik referencyjny, używając filmu objętego roszczeniem jako treści referencyjnej, użyj parametru claimId, aby zidentyfikować roszczenie.

Żądanie HTTP

  • Identyfikator URI przesyłania dla żądań przesłania multimediów:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • Identyfikator URI metadanych dla żądań 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 istniejącego roszczenia w YouTube, na podstawie którego ma zostać utworzony plik referencyjny. (Film objęty roszczeniem jest używany jako treść referencyjna).
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 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 w artykule Omówienie protokołu OAuth 2.0.