REST Resource: videoContent.networks.sources.content

Zasób: VideoContent

Metadane treści.

Zapis JSON 
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu treści wideo. To pole ma format: „networks/{kod_sieci}/sources/{identyfikator_źródła_treści}/content/{cms_content_id}”

Network_code to kod sieci w Google Ad Manager, do której należy treść.

content_source_id to identyfikator źródła treści w Google Ad Manager, do którego powinna należeć treść.

cms_content_id to identyfikator treści CMS w Google Ad Manager utworzony jako część żądania reklamy w celu wskazywania reklam, które Ad Manager może wyświetlać w danym filmie. Ta wartość może być liczbowa lub alfanumeryczna.
status

enum (VideoContentStatus)

Stan treści. Jeśli go pominiesz, aktywna będzie wartość domyślna.
title

string

Wymagane. Tytuł treści.
updateTime

string (Timestamp format)

Wymagane. Data ostatniej modyfikacji treści.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
publishTime

string (Timestamp format)

Czas publikacji treści. To pole jest wymagane, jeśli film ma być uwzględniany w regułach reklamowych, które określają czas rozpoczęcia i zakończenia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
duration

string (Duration format)

Czas trwania treści. Czas trwania jest obsługiwany z dokładnością do milisekund.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „s”. Przykład: "3.5s".
cuePoints[]

string (Duration format)

Określa punkty wstawienia reklamy. Punkty wstawienia reklamy to momenty w filmie, w których można wstawić reklamę. Punkty wstawienia reklamy są obsługiwane z dokładnością do milisekundy. To pole jest wymagane, jeśli film zawiera przerwy na reklamy w trakcie filmu.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „s”. Przykład: "3.5s".
thumbnailUrl

string

Adres URL miniatury materiału.
metadata

object (Metadata)

Identyfikuje niestandardowe metadane treści.
gracenoteMetadata

object (GracenoteMetadata)

Metadane treści związane z Gracenote.
syndicationMetadata

object (VideoContentSyndicationInfo)

Metadane związane z dystrybucją treści.
dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

Metadane treści związane z dynamicznym wstawianiem reklam.

VideoContentStatus

Opcje stanu umożliwiające wyświetlanie kierowanych reklam w przypadku treści.

Wartości w polu enum
ACTIVE Wyświetlane są reklamy kierowane na treść strony.
BLOCKED W takich treściach nie będą wyświetlane żadne reklamy, jeśli będą one miały stan ZABLOKOWANY.
DELETED Treść zostanie zarchiwizowana w usłudze Ad Manager. Jeśli Ad Manager otrzyma żądanie reklamy dotyczące treści oznaczonej jako USUNIĘTE, nadal mogą być w niej wyświetlane autoreklamy lub reklamy kierowane na jednostki reklamowe bądź według innych kryteriów kierowania. Aby zablokować reklamy, ustaw stan na ZABLOKOWANY.

Metadane

Niestandardowe metadane treści.

Zapis JSON 
{
  "keyValues": {
    string: value,
    ...
  }
}
Pola
keyValues

map (key: string, value: value (Value format))

Identyfikuje niestandardowe metadane treści w postaci pary klucz-wartość. Dla wartości akceptowane są tylko ciągi tekstowe lub lista ciągów znaków.

GracenoteMetadata

Metadane Gracenote treści.

Zapis JSON 
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
Pola
gracenoteId

string

Wymagane. Odnosi się do identyfikatora Gracenote treści. Musi mieć jeden z następujących prawidłowych prefiksów: 1. „EP” – odcinek serialu. Teledysk - film 3. „SP” – wydarzenie sportowe
gracenoteSeriesId

string

Opcjonalnie: To pole odnosi się do identyfikatora serii Gracenote. Musi mieć prefiks „SH”.

VideoContentSyndicationInfo

Metadane do określania relacji między treścią kanoniczną a treściami rozpowszechnianymi.

Zapis JSON 
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
Pola
Pole sumy syndication. VideoContentSyndiationMetadata może zawierać tylko jeden z tych elementów. syndication może mieć tylko jedną z tych wartości:
canonicalVideoContent

string

Nazwa treści kanonicznej. Musi mieć format „sieci/{kod_sieci}/źródła/{identyfikator_źródła_treści}/content/{identyfikator_treści_systemu} i muszą należeć do tej samej sieci co treść zawierająca to pole.
syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

Kolekcja materiałów redystrybuowanych

SyndicatedVideoContentNames

Lista nazw wszystkich rozpowszechnianych treści.

Zapis JSON 
{
  "syndicatedVideoContent": [
    string
  ]
}
Pola
syndicatedVideoContent[]

string

Powtórzone pole nazwy rozpowszechnianej treści. Muszą mieć format "sieci/{kod_sieci}/źródła/{identyfikator_źródła_treści}/content/{identyfikator_treści_systemu_cms} i muszą należeć do tej samej sieci co treść zawierająca to pole.

DynamicAdInsertionInfo

Informacje związane z dynamicznym wstawianiem reklam.

Zapis JSON 
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
Pola
videoIngestUrlInfo

object (VideoIngestUrlInfo)

Link do pliku mastera m3u8, który jest używany do warunkowania i generowania playlisty.
mediaUpdateTime

string (Timestamp format)

Czas ostatniej modyfikacji pliku wideo, do którego odwołuje się videoIngestUrlInfo.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

Adres URL pliku z napisami.
fwCaid

string

Identyfikator zasobu niestandardowego FreeWheel używany do kierowania reklamy.

VideoIngestUrlInfo

Metadane określające link do pliku m3u8, który jest używany do warunkowania i generowania playlisty.

Zapis JSON 
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
Pola
videoFormat

enum (VideoFormat)

Format filmu.
videoPreconditioned

enum (VideoPreconditioned)

Wskazuje, czy treści są już uwarunkowane do wyświetlania reklam w trakcie filmu, co oznacza, że segmenty są już podzielone na segmenty, by określić przerwy na reklamę.
url

string

Link do pliku m3u8.

VideoFormat

Formaty, w których można kodować treści wideo.

Wartości w polu enum
VIDEO_FORMAT_UNSPECIFIED Nie określono formatu filmu.
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

Uwarunkowany stan treści wideo.

Wartości w polu enum
NO Jeszcze nie uwarunkowane.
YES Film został uwarunkowany/podzielony.

ClosedCaptionUrlInfo

Metadane jednego pliku z napisami.

Zapis JSON 
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
Pola
languageCode

string

Kod języka IETF BCP-47 reprezentujący język, w którym zapisano plik napisów.
closedCaptionFormat

enum (ClosedCaptionFormat)

Format pliku z napisami.
url

string

Adres URL pliku z napisami.

ClosedCaptionFormat

Formaty plików z napisami.

Wartości w polu enum
CLOSED_CAPTION_FORMAT_UNSPECIFIED Nie określono formatu napisów.
TTML application/ttaf+xml
WEB_VTT text/vtt

Metody

update

 interfejsu API do tworzenia nowych treści lub aktualizowania ich metadanych, jeśli treści znajdują się już w usłudze Ad Manager.