REST Resource: advertisers.youtubeAdGroupAds

{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}

string

Nazwa zasobu reklamy.

string (int64 format)

Unikalny identyfikator reklamodawcy, do którego należy reklama.

string (int64 format)

Unikalny identyfikator reklamy. Przypisana przez system.

string (int64 format)

Unikalny identyfikator grupy reklam, do której należy reklama.

string

Wyświetlana nazwa reklamy.

Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 255 bajtów.

enum (EntityStatus)

Stan elementu reklamy.

object (AdUrl)

Lista adresów URL używanych przez reklamę.

object (DisplayVideoSourceAd)

Szczegółowe informacje o reklamie pochodzącej z kreacji Display & Video 360.

object (MastheadAd)

Szczegółowe informacje o reklamie wyświetlanej na stronie głównej YouTube.

object (InStreamAd)

Szczegóły reklamy In-Stream możliwej do pominięcia po 5 sekundach, która służy do celów marketingowych związanych ze świadomością marki lub zasięgiem.

object (NonSkippableAd)

Szczegóły krótkiej reklamy wideo In-Stream niemożliwej do pominięcia, która trwa od 6 do 15 sekund, używanej do osiągania celów marketingowych związanych z zasięgiem.

object (BumperAd)

Szczegóły krótkiej reklamy wideo niemożliwej do pominięcia, trwającej maksymalnie 6 sekund, używane na potrzeby określania zasięgu.

object (AudioAd)

Szczegółowe informacje o reklamie audio używanej na potrzeby celów marketingowych związanych z zasięgiem.

object (VideoDiscoveryAd)

Szczegółowe informacje o reklamie promującej film, która wyświetla się w miejscach odkrywania.

object (VideoPerformanceAd)

Szczegółowe informacje o reklamie używanej w kampanii wideo zachęcającej do działania, która ma zachęcać użytkowników do podejmowania działań związanych z firmą, usługą lub produktem.

{
  "creativeId": string
}

string (int64 format)

Identyfikator kreacji źródłowej.

{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}

object (YoutubeVideoDetails)

Film w YouTube użyty w reklamie.

string

Nagłówek reklamy.

string

Opis reklamy.

enum (VideoAspectRatio)

Współczynnik proporcji automatycznie odtwarzanego filmu z YouTube w mastheadzie.

string (int64 format)

Czas (w milisekundach), po którym rozpocznie się odtwarzanie filmu.

string (Duration format)

Czas trwania autoodtwarzania filmu.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

string

Tekst na przycisku wezwania do działania.

string

Docelowy adres URL przycisku z wezwaniem do działania.

string

Link monitorujący przycisku wezwania do działania.

boolean

Określa, czy pokazywać tło, czy baner widoczny u góry strony YouTube.

object (YoutubeVideoDetails)

Filmy, które wyświetlają się obok reklamy w banerze masthead na komputerach. Może być maksymalnie 2 razy.

{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}

string

Identyfikator filmu w YouTube, który można wyszukiwać na stronie internetowej YouTube.

enum (VideoUnavailableReason)

Powód, dla którego dane filmu są niedostępne.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

Typowe atrybuty reklam.

map (key: string, value: string)

Parametry niestandardowe służące do przekazywania wartości niestandardowych do szablonu linku monitorującego.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}

string

Adres strony internetowej widoczny w reklamie.

string

Adres URL strony internetowej, na którą użytkownik trafia po kliknięciu reklamy.

string

Adres URL wczytywany w tle na potrzeby śledzenia.

string

Tekst na przycisku wezwania do działania.

string

Nagłówek banera z wezwaniem do działania.

object (YoutubeVideoDetails)

Film reklamy w YouTube.

object (ImageAsset)

Obraz wyświetlany obok reklamy wideo.

{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}

string

Typ MIME zasobu graficznego.

object (Dimensions)

Metadane tego obrazu w oryginalnym rozmiarze.

string (int64 format)

Rozmiar pliku komponentu z obrazem w bajtach.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

Typowe atrybuty reklam.

map (key: string, value: string)

Parametry niestandardowe służące do przekazywania wartości niestandardowych do szablonu linku monitorującego.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}

object (CommonInStreamAttribute)

Typowe atrybuty reklam.

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}

string

Adres strony internetowej widoczny w reklamie.

string

Adres URL strony internetowej, na którą użytkownik trafia po kliknięciu reklamy.

string

Adres URL wczytywany w tle na potrzeby śledzenia.

object (YoutubeVideoDetails)

Film reklamy w YouTube.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}

string

Nagłówek reklamy.

string

Pierwszy wiersz tekstu reklamy.

string

Drugi wiersz tekstu reklamy.

object (YoutubeVideoDetails)

Film w YouTube promowany przez reklamę.

enum (Thumbnail)

Miniatura obrazu użytego w reklamie.

{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}

string

Adres URL strony internetowej, na którą użytkownik trafia po kliknięciu reklamy.

string

Adres URL wczytywany w tle na potrzeby śledzenia.

string

Lista komponentów tekstowych wyświetlanych po kliknięciu przycisku wezwania do działania.

string

Lista nagłówków wyświetlana na banerze z wezwaniem do działania.

string

Lista pojedynczych nagłówków wyświetlanych na banerze z wezwaniem do działania.

string

Lista opisów wyświetlanych na banerze z wezwaniem do działania.

string

Pierwszy element w wyświetlanym adresie URL po domenie.

string

Drugi element po domenie w wyświetlanym adresie URL.

string

Domena wyświetlanego adresu URL.

object (YoutubeVideoDetails)

Lista komponentów wideo w YouTube użytych w tej reklamie.

map (key: string, value: string)

Parametry niestandardowe służące do przekazywania wartości niestandardowych do szablonu linku monitorującego.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

object (ImageAsset)

Lista banerów towarzyszących używanych przez tę reklamę.

{
  "type": enum (AdUrlType),
  "url": string
}

enum (AdUrlType)

Typ adresu URL reklamy.

string

Wartość ciągu tekstowego adresu URL.