REST Resource: advertisers.adGroupAds

{
  "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 standardzie 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óły reklamy pochodzącej z sieci reklamowej & Kreacja wideo 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, wykorzystywane do celów marketingowych związanych ze świadomością marki lub osiąganiem celów.

object (NonSkippableAd)

Szczegóły krótkiej reklamy wideo In-Stream niemożliwej do pominięcia, trwającej od 6 do 15 sekund, wykorzystywane do 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żywanych na potrzeby zasięgu.

object (AudioAd)

Szczegóły reklamy audio używanej do osiągnięcia celów marketingowych.

object (VideoDiscoveryAd)

Szczegóły reklamy promującej film, która wyświetla się w miejscach odkrywania.

object (VideoPerformanceAd)

Szczegóły reklamy używanej w kampanii wideo zachęcającej do działania w celu zachęcania do działania względem firmy, usługi lub produktu.

{
  "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 przez reklamę.

string

Nagłówek reklamy.

string

Tekst reklamy.

enum (VideoAspectRatio)

Format obrazu automatycznie odtwarzanego filmu w YouTube w mastheadzie.

string (int64 format)

Wyrażony w milisekundach czas, po którym rozpocznie się odtwarzanie filmu.

string (Duration format)

Czas, przez jaki film ma być autoodtwarzany.

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

string

Tekst na przycisku z wezwaniem 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 wyświetlać tło czy baner wyświetlany u góry strony YouTube.

object (YoutubeVideoDetails)

Filmy, które wyświetlają się obok reklamy w banerze masthead na komputerach. Wartość nie może być większa niż 2.

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

string

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

enum (VideoUnavailableReason)

Powód, dla którego dane o filmie 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, na którą użytkownik trafia po kliknięciu reklamy.

string

Adres URL wczytywany w tle na potrzeby śledzenia.

string

Tekst na przycisku z wezwaniem do działania.

string

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

object (YoutubeVideoDetails)

Film z reklamą 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 jego 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, na którą użytkownik trafia po kliknięciu reklamy.

string

Adres URL wczytywany w tle na potrzeby śledzenia.

object (YoutubeVideoDetails)

Film z reklamą 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, który promuje reklama.

enum (Thumbnail)

Miniatura obrazu użyta 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, 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świetlających się po kliknięciu przycisku wezwania do działania.

string

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

string

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

string

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

string

Pierwszy element po domenie w wyświetlanym adresie URL.

string

Drugi element po domenie w wyświetlanym adresie URL.

string

Domena wyświetlanego adresu URL.

object (YoutubeVideoDetails)

Lista komponentów wideo w YouTube wykorzystywanych przez tę 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" }.

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.