Package google.ads.drx.video.v1

Indeks

VideoContentIngestionService

Usługa API do przetwarzania treści, która umożliwia tworzenie lub aktualizowanie treści wideo i powiązanych z nimi metadanych w usłudze Google Ad Manager.

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API do tworzenia nowych treści lub aktualizowania ich metadanych, jeśli treści te znajdują się już w usłudze Ad Manager. Zwraca treść w przypadku powodzenia lub google.rpc.Code w przypadku niepowodzenia.

Przykładowe żądanie:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

Więcej informacji znajdziesz w omówieniu OAuth 2.0.

ClosedCaptionFormat

formaty, w których mogą być pliki 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

ClosedCaptionUrlInfo

Metadane jednego pliku z napisami.

Pola
language_code

string

Kod języka IETF BCP-47 reprezentujący język, w którym jest plik z napisami.
closed_caption_format

ClosedCaptionFormat

Format pliku z napisami.
url

string

Adres URL pliku z napisami.

DynamicAdInsertionInfo

Informacje dotyczące dynamicznego wstawiania reklam.

Pola
video_ingest_url_info

VideoIngestUrlInfo

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

Timestamp

Czas ostatniej modyfikacji pliku wideo, do którego odwołuje się element video_ingest_url_info.
closed_caption_url_info[]

ClosedCaptionUrlInfo

Adres URL pliku z napisami.
fw_caid

string

Identyfikator niestandardowego zasobu Freewheel używany do kierowania reklam.

GracenoteMetadata

Metadane Gracenote dotyczące treści.

Pola
gracenote_id

string

Wymagane. Odwołuje się do identyfikatora Gracenote treści. Musi mieć jeden z tych prawidłowych prefiksów: 1. „EP” – odcinek serialu 2. „MV” – film 3. „SP” – wydarzenie sportowe
gracenote_series_id

string

Opcjonalnie. To pole odnosi się do identyfikatora serii Gracenote. Musi być poprzedzona ciągiem „SH”.

Metadane

Niestandardowe metadane treści.

Pola
key_values

map<string, Value>

Określa niestandardowe metadane treści jako parę klucz-wartość. Wartości mogą być tylko ciągami tekstowymi lub listami ciągów tekstowych.

SyndicatedVideoContentNames

Lista nazw wszystkich materiałów redystrybuowanych.

Pola
syndicated_video_content[]

string

Pole powtarzane z nazwą materiałów redystrybuowanych. Muszą mieć format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}” i należeć do tej samej sieci co treści zawierające to pole.

UpdateVideoContentRequest

Żądanie [VideoContentIngestionService.UpdateVideoContentRequest][].

Pola
video_content

VideoContent

Wymagane. Metadane treści.

Treść wideo

Metadane treści.

Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu treści wideo. Format tego pola to: „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}”.

network_code to kod sieci w Google Ad Managerze, do której należą te treści.

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

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. Może być ona numeryczna lub alfanumeryczna.
status

VideoContentStatus

Stan treści. Jeśli ten parametr zostanie pominięty, domyślną wartością będzie „aktywny”.
title

string

Wymagane. Tytuł treści.
update_time

Timestamp

Wymagane. Czas ostatniej modyfikacji treści.
publish_time

Timestamp

Czas opublikowania treści. To pole jest wymagane, jeśli film ma być uwzględniony w regułach reklamowych określających czas rozpoczęcia i zakończenia.
duration

Duration

Czas trwania treści. Czas trwania jest obsługiwany z dokładnością do milisekundy.
cue_points[]

Duration

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

string

Adres URL miniatury treści.
metadata

Metadata

Określa niestandardowe metadane treści.
gracenote_metadata

GracenoteMetadata

Metadane powiązane z treścią w Gracenote.
syndication_metadata

VideoContentSyndicationInfo

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

DynamicAdInsertionInfo

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

VideoContentStatus

Opcje stanu, które umożliwiają wyświetlanie lub niewyświetlanie reklam kierowanych na treści.

Wartości w polu enum
ACTIVE Wyświetlane będą reklamy kierowane na treść.
BLOCKED Jeśli stan to BLOCKED, w tych treściach nie będą się wyświetlać żadne reklamy.
DELETED Treści zostaną zarchiwizowane w usłudze Ad Manager. Jeśli Ad Manager otrzyma żądanie reklamy dotyczące treści oznaczonej jako USUNIĘTE, mogą się w niej wyświetlać autoreklamy lub reklamy kierowane na jednostki reklamowe w zasobach reklamowych bądź inne kryteria kierowania. Aby zablokować reklamy, ustaw stan na ZABLOKOWANE.

VideoContentSyndicationInfo

Metadane służące do określania relacji między treściami kanonicznymi a materiałami redystrybuowanymi.

Pola
Pole zbiorcze syndication. Element VideoContentSyndicationMetadata może zawierać tylko jeden z tych elementów. syndication może mieć tylko jedną z tych wartości:
canonical_video_content

string

Nazwa treści kanonicznych. Musi mieć format „networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}” i należeć do tej samej sieci co treści zawierające to pole.
syndicated_video_content_names

SyndicatedVideoContentNames

kolekcja materiałów redystrybuowanych,

VideoFormat

Formaty, w których mogą być kodowane treści wideo.

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

VideoIngestUrlInfo

Metadane określające link do pliku m3u8 używanego do warunkowania i generowania playlisty.

Pola
video_format

VideoFormat

Format filmu.
video_preconditioned

VideoPreconditioned

Wskazuje, czy treści są już uwarunkowane pod kątem wyświetlania reklam w trakcie filmu, czyli czy segmenty są już podzielone na segmenty sygnalizujące przerwy na reklamę.
url

string

Link do pliku m3u8.

VideoPreconditioned

Stan warunkowania treści wideo.

Wartości w polu enum
NO Jeszcze nie spełnia warunków.
YES Film został podzielony.