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 Overview .