Method: references.insert

Создает ссылку одним из следующих способов:

  • Если вы запрашиваете загрузку файла ссылки, YouTube создает ссылку на основе предоставленного контента. Вы можете предоставить либо видео/аудиофайл, либо предварительно сгенерированный отпечаток пальца. Если вы предоставляете предварительно созданный отпечаток пальца, установите для свойства fpDirect reference ресурса значение true в тексте запроса. В этом потоке вы можете использовать потоки составной или возобновляемой загрузки для предоставления справочного контента.
  • Если вы хотите создать ссылку, используя видео, на которое заявлены права, в качестве эталонного контента, используйте claimId , чтобы идентифицировать заявку.

HTTP-запрос

  • URI загрузки для запросов на загрузку мультимедиа:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI метаданных для запросов только метаданных:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

URL-адрес использует синтаксис транскодирования gRPC .

Параметры запроса

Параметры
claimId

string

Параметр claimId указывает идентификатор заявки YouTube для существующей заявки, на основе которой необходимо создать ссылку. (Заявленное видео используется в качестве справочного контента.)

onBehalfOfContentOwner

string

Параметр onBehalfOfContentOwner определяет владельца контента, от имени которого действует пользователь. Этот параметр поддерживает пользователей, чьи учетные записи связаны с несколькими владельцами контента.

Тело запроса

Тело запроса содержит экземпляр Reference .

Тело ответа

В случае успеха тело ответа содержит экземпляр Reference .

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .