REST Resource: claims

Ресурс: Претензия

claim связывает видео, загруженное партнером или пользователем, с объектом , которому это видео соответствует. В заявлении указывается, соответствует ли видео аудио, видео или аудиовизуальным (аудио и видео) компонентам ресурса. В претензии также указывается политика, которую правообладатель хочет, чтобы YouTube применял к заявленному видео.

JSON-представление
{
  "kind": string,
  "policy": {
    object (Policy)
  },
  "timeCreated": string,
  "contentType": string,
  "ugcType": string,
  "isPartnerUploaded": boolean,
  "timeStatusLastModified": string,
  "blockOutsideOwnership": boolean,
  "status": string,
  "appliedPolicy": {
    object (Policy)
  },
  "id": string,
  "assetId": string,
  "videoId": string,
  "origin": {
    object (Origin)
  },
  "matchInfo": {
    object (MatchInfo)
  },
  "studioInfo": {
    object (StudioInfo)
  }
}
Поля
kind

string

Тип ресурса API. Для ресурсов claim это значение — youtubePartner#claim .

policy

object ( Policy )

Политика, предоставленная владельцем просмотра в претензии.

timeCreated

string

Время создания претензии.

contentType

string

Это значение указывает, распространяется ли заявка на аудио-, видео- или аудиовизуальную часть заявленного контента.

ugcType

string

Тип заявки на пользовательский контент (стандартный, премиум, песня).

isPartnerUploaded

boolean

Указывает, является ли заявка заявкой, загруженной партнером.

timeStatusLastModified

string

Время последнего изменения статуса претензии и/или сведений о статусе.

blockOutsideOwnership

boolean

Указывает, следует ли блокировать видео, на которое заявлены права, везде, где оно явно не принадлежит.

status

string

Статус претензии. При обновлении заявки вы можете обновить ее статус с active на inactive , чтобы эффективно освободить заявку, но API не поддерживает другие обновления статуса заявки.

appliedPolicy

object ( Policy )

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

id

string

Идентификатор, который YouTube присваивает и использует для уникальной идентификации заявки.

assetId

string

Уникальный идентификатор объекта YouTube, который идентифицирует объект, связанный с заявкой.

videoId

string

Уникальный идентификатор видео YouTube, идентифицирующий видео, связанное с заявкой.

origin

object ( Origin )

matchInfo

object ( MatchInfo )

Если эта заявка была создана автоматически на основе предоставленной ссылки, в этом разделе будут представлены сведения о совпадении, в результате которого была создана заявка.

studioInfo

object ( StudioInfo )

Содержит URL-адреса, ведущие на страницы, связанные с заявками, в Studio.

Источник

Этот объект содержит информацию, описывающую источник метаданных или данных о собственности.

JSON-представление
{
  "source": string
}
Поля
source

string

Информация о матче

Сопоставьте информацию о претензии.

JSON-представление
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
Поля
matchSegments[]

object ( MatchSegment )

Подробности о каждом сегменте матча. Каждый элемент списка содержит информацию об одном сегменте соответствия, связанном с заявкой. Возможно иметь несколько сегментов совпадений. Например, если аудио- и видеоконтент загруженного видео совпадает с содержимым эталонного видео, будет два сегмента соответствия. Один сегмент будет описывать совпадение аудио, а другой — совпадение видео.

referenceId

string

Идентификатор ссылки , которая сгенерировала это совпадение.

longestMatch

object ( LongestMatch )

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

totalMatch

object ( TotalMatch )

Подробная информация об общем количестве совпадающих друг с другом ссылочного и пользовательского видеоконтента. Обратите внимание, что эти два значения могут отличаться, если эталонное или пользовательское видео содержит цикл.

Сегмент совпадения

Информация об одном сегменте совпадения в заявке.

JSON-представление
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
Поля
video_segment

object ( Segment )

Объект videoSegment содержит информацию о соответствующей части заявленного видео.

reference_segment

object ( Segment )

Объект referenceSegment содержит информацию о соответствующей части ссылочного содержимого.

channel

string

Определяет, насколько заявленное видео соответствует эталонному видео.

manual_segment

object ( Segment2 )

При операции вставки заявлений, заявленных вручную, объект manualSegment содержит информацию о конкретной части видео, которая, как утверждается, соответствует.

Сегмент

Этот ресурс представляет собой простой сегмент со временем начала и окончания, отформатированным в виде строки «чч:мм:сс.ммм».

JSON-представление
{
  "start": string,
  "duration": string,
  "kind": string
}
Поля
start

string

Время начала сегмента, измеряемое в миллисекундах от начала.

duration

string

Длительность сегмента в миллисекундах.

kind

string

Тип ресурса API. Для ресурсов сегмента значением является youtubePartner#segment .

Сегмент2

Этот ресурс представляет собой еще один простой сегмент со временем начала и окончания, отформатированным в виде строки «чч:мм:сс.ммм».

JSON-представление
{
  "start": string,
  "kind": string,
  "finish": string
}
Поля
start

string

Время начала сегмента, измеряемое в миллисекундах от начала.

kind

string

Тип ресурса API. Для ресурсов сегмента значением является youtubePartner#segment .

finish

string

Время окончания сегмента, измеряемое в миллисекундах от начала.

Самый длинный матч

Самое длинное совпадение претензий.

JSON-представление
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
Поля
durationSecs

string

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

userVideoOffset

string

Смещение в секундах пользовательского видео, с которого началось самое длинное совпадение.

referenceOffset

string

Смещение в секундах от ссылки, с которой началось самое длинное совпадение.

ТоталМатч

Полное совпадение претензий.

JSON-представление
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
Поля
userVideoDurationSecs

string

Общий объем контента в пользовательском видео, соответствующего ссылке, в секундах.

referenceDurationSecs

string

Общий объем контента в ссылке, соответствующего пользовательскому видео, в секундах.

Методы

get

Получает конкретную заявку по идентификатору.

insert

Создает претензию.

list

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

patch

Исправляет существующую заявку, изменяя ее политику или статус.

update

Обновляет существующую заявку, изменяя ее политику или статус.