REST Resource: advertisers.adGroupAds

Zasób: AdGroupAd

Pojedyncza reklama powiązana z grupą reklam.

Zapis JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu reklamy.
advertiserId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reklamodawcy, do którego należy reklama.
adGroupAdId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reklamy. Przypisany przez system.
adGroupId

string (int64 format)

Wymagane. Wartość niezmienna. Unikalny identyfikator grupy reklam, do której należy reklama.
displayName

string

Wymagane. Wyświetlana nazwa reklamy.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 255 bajtów.
adPolicy

object (AdPolicy)

Tylko dane wyjściowe. Stan zatwierdzenia reklamy pod kątem zgodności z zasadami.
entityStatus

enum (EntityStatus)

Wymagane. Stan reklamy.
adUrls[]

object (AdUrl)

Tylko dane wyjściowe. Lista adresów URL używanych przez reklamę.
dcmTrackingInfo

object (DcmTrackingInfo)

Opcjonalnie: Informacje o reklamie śledzącej DCM.

Aby usunąć informacje o reklamie śledzącej DCM, pozostaw to pole puste.
containsSyntheticMedia

boolean

Opcjonalnie: Wskazuje, czy reklama zawiera zmienione lub wygenerowane syntetycznie multimedia.

Należy go ustawiać tylko w przypadku reklam utworzonych przez zweryfikowanych reklamodawców wyświetlających reklamy wyborcze. Dotyczy tylko reklam na YouTube.
parentCreativeId

string (int64 format)

Tylko dane wyjściowe. Identyfikator kreacji Display & Video 360 użytej do wygenerowania tej reklamy.

To pole będzie wypełniane tylko w przypadku reklam generowanych na podstawie kreacji przypisanych do nadrzędnej grupy reklam.
Szczegóły reklamy. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Tylko dane wyjściowe. Szczegóły reklamy pochodzącej z kreacji w Display & Video 360.
mastheadAd

object (MastheadAd)

Tylko dane wyjściowe. Szczegóły reklamy wyświetlanej na stronie głównej YouTube.
inStreamAd

object (InStreamAd)

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

object (NonSkippableAd)

Tylko dane wyjściowe. Szczegóły dotyczące niemożliwej do pominięcia krótkiej reklamy wideo In-Stream o długości od 6 do 15 sekund, która służy do osiągania celów marketingowych związanych z zasięgiem.
bumperAd

object (BumperAd)

Tylko dane wyjściowe. Szczegóły dotyczące niemożliwej do pominięcia krótkiej reklamy wideo o długości do 6 sekund, która służy do zwiększania zasięgu.
audioAd

object (AudioAd)

Tylko dane wyjściowe. Szczegóły dotyczące reklamy audio używanej do osiągania celów marketingowych związanych z zasięgiem.
videoDiscoverAd

object (VideoDiscoveryAd)

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

object (VideoPerformanceAd)

Tylko dane wyjściowe. Szczegóły dotyczące reklamy 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.
demandGenVideoAd

object (DemandGenVideoAd)

Opcjonalnie: Szczegóły reklamy wideo generującej popyt.
demandGenImageAd

object (DemandGenImageAd)

Opcjonalnie: Szczegóły reklamy graficznej generującej popyt.
demandGenProductAd

object (DemandGenProductAd)

Opcjonalnie: Szczegóły reklamy produktowej kampanii generującej popyt.
Koniec pól wykluczających się wzajemnie.

DisplayVideoSourceAd

Reklama pochodzi z kreacji DV360.

Zapis JSON 
{
  "creativeId": string
}
Pola
creativeId

string (int64 format)

Identyfikator kreacji źródłowej.

MastheadAd

Szczegóły reklamy w mastheadzie.

Zapis JSON 
{
  "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)
    }
  ]
}
Pola
video

object (YoutubeVideoDetails)

Film na YouTube używany przez reklamę.
headline

string

Nagłówek reklamy.
description

string

Opis reklamy.
videoAspectRatio

enum (VideoAspectRatio)

Format obrazu filmu na YouTube odtwarzanego automatycznie w mastheadzie.
autoplayVideoStartMillisecond

string (int64 format)

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

string (Duration format)

Czas, przez który film będzie odtwarzany automatycznie.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".
callToActionButtonLabel

string

Tekst na przycisku wezwania do działania.
callToActionFinalUrl

string

Docelowy adres URL przycisku wezwania do działania.
callToActionTrackingUrl

string

Link monitorujący przycisku wezwania do działania.
showChannelArt

boolean

Określa, czy u góry strony w YouTube ma się wyświetlać tło lub baner.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Filmy wyświetlane obok reklamy w banerze masthead na komputerach. Możesz dodać maksymalnie 2 takie elementy.

YoutubeVideoDetails

Szczegóły filmu na YouTube.

Zapis JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason),
  "videoAssetId": string
}
Pola
id

string

Tylko dane wyjściowe. Identyfikator filmu na YouTube, który można wyszukać na stronie YouTube.
unavailableReason

enum (VideoUnavailableReason)

Tylko dane wyjściowe. Powód, dla którego dane filmu są niedostępne.
videoAssetId

string (int64 format)

Wymagane. Identyfikator komponentu wideo w YouTube. To jest adAssetId zasobu AdAsset.

VideoUnavailableReason

Możliwe przyczyny niedostępności filmu.

Wartości w polu enum
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Nieznany lub nieokreślony.
VIDEO_UNAVAILABLE_REASON_PRIVATE Ten film wideo jest prywatny.
VIDEO_UNAVAILABLE_REASON_DELETED Film został usunięty.

VideoAspectRatio

Możliwe formaty obrazu filmu na YouTube.

Wartości w polu enum
VIDEO_ASPECT_RATIO_UNSPECIFIED Nie określono lub nieznany.
VIDEO_ASPECT_RATIO_WIDESCREEN Film jest rozciągnięty, a góra i dół są przycięte.
VIDEO_ASPECT_RATIO_FIXED_16_9 Film ma stały format obrazu 16:9.

InStreamAd

Szczegóły reklamy In-Stream.

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

object (CommonInStreamAttribute)

Wymagane. Typowe atrybuty reklam.
customParameters

map (key: string, value: string)

Opcjonalnie: Parametry niestandardowe i towarzyszące im wartości, które mają zostać dodane do linku monitorującego.

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

CommonInStreamAttribute

Typowe atrybuty reklam In-Stream, reklam niemożliwych do pominięcia i bumperów reklamowych.

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

string

Wymagane. Adres strony internetowej widoczny w reklamie.
finalUrl

string

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

string

Tylko dane wyjściowe. Adres URL wczytywany w tle na potrzeby śledzenia.

W wersji 4 i starszych to pole reprezentuje link monitorujący określony ręcznie przez użytkownika. W wersji 5 znajdziesz go w sekcji userSpecifiedTrackingUrl.
userSpecifiedTrackingUrl

string

Opcjonalnie: Link monitorujący określony ręcznie przez użytkownika.
actionButtonLabel

string

Opcjonalnie: Tekst na przycisku wezwania do działania.

Należy ustawić, jeśli ustawiono actionHeadline.
actionHeadline

string

Opcjonalnie: Nagłówek banera z wezwaniem do działania.
video

object (YoutubeVideoDetails)

Wymagane. Wartość niezmienna. Film na YouTube, który jest reklamą.
companionBanner

object (ImageAsset)

Opcjonalnie: Obraz wyświetlany obok reklamy wideo.

ImageAsset

Metadane komponentu z obrazem.

Zapis JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string,
  "assetId": string
}
Pola
mimeType

string

Tylko dane wyjściowe. Typ MIME komponentu z obrazem.
fullSize

object (Dimensions)

Tylko dane wyjściowe. Metadane tego obrazu w oryginalnym rozmiarze.
fileSize

string (int64 format)

Tylko dane wyjściowe. Rozmiar pliku komponentu z obrazem w bajtach.
assetId

string (int64 format)

Wymagane. Unikalny identyfikator zasobu.

NonSkippableAd

Szczegóły reklamy niemożliwej do pominięcia.

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

object (CommonInStreamAttribute)

Wymagane. Typowe atrybuty reklam.
customParameters

map (key: string, value: string)

Opcjonalnie: Parametry niestandardowe i towarzyszące im wartości, które mają zostać dodane do linku monitorującego.

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

BumperAd

Szczegóły bumpera reklamowego.

Zapis JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Pola
commonInStreamAttribute

object (CommonInStreamAttribute)

Wymagane. Typowe atrybuty reklam.

AudioAd

Szczegóły reklamy audio.

Zapis JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Pola
displayUrl

string

Adres strony internetowej widoczny w reklamie.
finalUrl

string

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

string

Adres URL wczytywany w tle na potrzeby śledzenia.

W wersji 4 i starszych to pole reprezentuje link monitorujący określony ręcznie przez użytkownika. W wersji 5 znajdziesz go w sekcji userSpecifiedTrackingUrl.
userSpecifiedTrackingUrl

string

Opcjonalnie: Link monitorujący określony ręcznie przez użytkownika.
video

object (YoutubeVideoDetails)

Film na YouTube, który jest reklamą.

VideoDiscoveryAd

Szczegóły reklamy wideo Discovery.

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

string

Nagłówek reklamy.
description1

string

Pierwszy wiersz tekstu reklamy.
description2

string

Druga linia tekstu reklamy.
video

object (YoutubeVideoDetails)

Film na YouTube promowany przez reklamę.
thumbnail

enum (Thumbnail)

Miniatura używana w reklamie.

Miniatura

Możliwe opcje miniatur w reklamach wideo Discovery.

Wartości w polu enum
THUMBNAIL_UNSPECIFIED Nieznany lub nieokreślony.
THUMBNAIL_DEFAULT Domyślna miniatura, która może być wygenerowana automatycznie lub przesłana przez użytkownika.
THUMBNAIL_1 Miniatura 1 wygenerowana z filmu.
THUMBNAIL_2 Miniatura 2 wygenerowana z filmu.
THUMBNAIL_3 Miniatura 3 wygenerowana z filmu.

VideoPerformanceAd

Szczegóły reklamy wideo generującej konwersje.

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

string

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

string

Tylko dane wyjściowe. Adres URL wczytywany w tle na potrzeby śledzenia.

W wersji 4 i starszych to pole reprezentuje link monitorujący określony ręcznie przez użytkownika. W wersji 5 znajdziesz go w sekcji userSpecifiedTrackingUrl.
userSpecifiedTrackingUrl

string

Opcjonalnie: Link monitorujący określony ręcznie przez użytkownika.
actionButtonLabels[]

string

Opcjonalnie: Lista komponentów tekstowych wyświetlanych na przycisku wezwania do działania.

Należy ustawić, jeśli ustawiono headlines.
headlines[]

string

Opcjonalnie: Lista nagłówków wyświetlanych na banerze z wezwaniem do działania.
longHeadlines[]

string

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

Należy ustawić, chyba że pole lineItemType nadrzędnego elementu zamówienia ma wartość LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE. W takim przypadku nie można ustawić tego pola.
descriptions[]

string

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

Należy ustawić, chyba że pole lineItemType nadrzędnego elementu zamówienia ma wartość LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE. W takim przypadku nie można ustawić tego pola.
displayUrlBreadcrumb1

string

Opcjonalnie: Pierwszy element po domenie w wyświetlanym adresie URL.
displayUrlBreadcrumb2

string

Opcjonalnie: Druga część po domenie w wyświetlanym adresie URL.

Można ustawić tylko wtedy, gdy ustawiono też displayUrlBreadcrumb1.
domain

string

Tylko dane wyjściowe. Domena wyświetlanego adresu URL.
videos[]

object (YoutubeVideoDetails)

Wymagane. Lista komponentów wideo w YouTube używanych przez tę reklamę.
customParameters

map (key: string, value: string)

Opcjonalnie: Parametry niestandardowe i towarzyszące im wartości, które mają zostać dodane do linku monitorującego.

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

object (ImageAsset)

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

string

Opcjonalnie: Nazwa firmy wyświetlana w reklamie.

To ustawienie jest wymagane, chyba że na poziomie reklamodawcy jest ustawiona wartość domyślna. Jeśli nie zostanie ustawiona, zostanie zastosowana wartość domyślna.

DemandGenVideoAd

Szczegóły reklamy wideo generującej popyt.

Zapis JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
Pola
finalUrl

string

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

string

Tylko dane wyjściowe. Adres URL wczytywany w tle na potrzeby śledzenia.
userSpecifiedTrackingUrl

string

Opcjonalnie: Link monitorujący określony ręcznie przez użytkownika.
callToAction

enum (CallToAction)

Wymagane. Przycisk wezwania do działania wyświetlany w reklamie.

Obsługiwane wartości to:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

Wymagane. Lista nagłówków wyświetlanych w reklamie.
longHeadlines[]

string

Wymagane. Lista długich nagłówków wyświetlanych w reklamie.
descriptions[]

string

Wymagane. Lista tekstów wyświetlanych w reklamie.
displayUrlBreadcrumb1

string

Opcjonalnie: Pierwsza część po domenie w wyświetlanym adresie URL.
displayUrlBreadcrumb2

string

Opcjonalnie: Druga część po domenie w wyświetlanym adresie URL.
videos[]

object (YoutubeVideoDetails)

Wymagane. Lista komponentów wideo w YouTube używanych przez tę reklamę.
customParameters

map (key: string, value: string)

Opcjonalnie: Parametry niestandardowe i towarzyszące im wartości, które mają zostać dodane do linku monitorującego.

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

object (ImageAsset)

Opcjonalnie: Baner towarzyszący używany przez tę reklamę.
finalMobileUrl

string

Opcjonalnie: Adres URL strony, na którą użytkownik trafia po kliknięciu reklamy na urządzeniu mobilnym.
finalUrlSuffix

string

Opcjonalnie: Sufiks, który ma być dołączany do adresów URL stron docelowych.
businessName

string

Opcjonalnie: Nazwa firmy wyświetlana w reklamie.

To ustawienie jest wymagane, chyba że na poziomie reklamodawcy jest ustawiona wartość domyślna. Jeśli nie zostanie ustawiona, zostanie zastosowana wartość domyślna.

CallToAction

Możliwe wartości wezwania do działania w reklamach produktowych i reklamach wideo w kampaniach generujących popyt.

Wartości w polu enum
CALL_TO_ACTION_UNSPECIFIED Nie określono lub nieznany.
AUTOMATED automatyczne,
LEARN_MORE Więcej informacji
GET_QUOTE Uzyskaj wycenę.
APPLY_NOW Zgłoś się już teraz.
SIGN_UP Zarejestruj się.
CONTACT_US Skontaktuj się z nami.
SUBSCRIBE Subskrybuj.
DOWNLOAD Pobierz.
BOOK_NOW Zarezerwuj teraz.
SHOP_NOW Kup teraz.
BUY_NOW Kup teraz.
DONATE_NOW Przekaż darowiznę teraz.
ORDER_NOW Zamów teraz.
PLAY_NOW Zagraj teraz.
SEE_MORE Zobacz więcej.
START_NOW Zacznij teraz.
VISIT_SITE Odwiedź witrynę.
WATCH_NOW Obejrzyj teraz.

DemandGenImageAd

Szczegóły reklamy graficznej generującej popyt.

Zapis JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
Pola
finalUrl

string

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

string

Tylko dane wyjściowe. Adres URL wczytywany w tle na potrzeby śledzenia.
userSpecifiedTrackingUrl

string

Opcjonalnie: Link monitorujący określony ręcznie przez użytkownika.
callToAction

string

Wymagane. Przycisk wezwania do działania wyświetlany w reklamie.
headlines[]

string

Wymagane. Lista nagłówków wyświetlanych w reklamie.
descriptions[]

string

Wymagane. Lista tekstów wyświetlanych w reklamie.
customParameters

map (key: string, value: string)

Opcjonalnie: Parametry niestandardowe i towarzyszące im wartości, które mają zostać dodane do linku monitorującego.

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

string

Opcjonalnie: Adres URL strony, na którą użytkownik trafia po kliknięciu reklamy na urządzeniu mobilnym.
finalUrlSuffix

string

Opcjonalnie: Sufiks, który ma być dołączany do adresów URL stron docelowych.
businessName

string

Opcjonalnie: Nazwa firmy wyświetlana w reklamie.

To ustawienie jest wymagane, chyba że na poziomie reklamodawcy jest ustawiona wartość domyślna. Jeśli nie zostanie ustawiona, zostanie zastosowana wartość domyślna.
marketingImages[]

object (ImageAsset)

Lista obrazów marketingowych wyświetlanych w reklamie.
squareMarketingImages[]

object (ImageAsset)

Lista kwadratowych obrazów marketingowych wyświetlanych w reklamie.
portraitMarketingImages[]

object (ImageAsset)

Lista obrazów marketingowych w orientacji pionowej wyświetlanych w reklamie.
logoImages[]

object (ImageAsset)

Lista obrazów logo wyświetlanych w reklamie.

To ustawienie jest wymagane, chyba że na poziomie reklamodawcy jest ustawiona wartość domyślna. Jeśli nie zostanie ustawiona, zostanie zastosowana wartość domyślna.

DemandGenCarouselAd

Szczegóły reklamy karuzelowej kampanii generującej popyt.

Zapis JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
Pola
finalUrl

string

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

string

Wymagane. Nagłówek reklamy.
description

string

Wymagane. Opis reklamy.
cards[]

object (CarouselCard)

Wymagane. Lista kart wyświetlanych w reklamie.
finalUrlSuffix

string

Opcjonalnie: Sufiks, który ma być dołączany do adresów URL stron docelowych.
trackingUrl

string

Tylko dane wyjściowe. Adres URL wczytywany w tle na potrzeby śledzenia.
userSpecifiedTrackingUrl

string

Opcjonalnie: Link monitorujący określony ręcznie przez użytkownika.
businessName

string

Opcjonalnie: Nazwa firmy wyświetlana w reklamie.

To ustawienie jest wymagane, chyba że na poziomie reklamodawcy jest ustawiona wartość domyślna. Jeśli nie zostanie ustawiona, zostanie zastosowana wartość domyślna.
customParameters

map (key: string, value: string)

Opcjonalnie: Parametry niestandardowe i towarzyszące im wartości, które mają zostać dodane do linku monitorującego.

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

CarouselCard

Szczegóły karty karuzeli kampanii generującej popyt.

Zapis JSON 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Pola
finalUrl

string

Wymagane. Adres URL strony, na którą użytkownik trafia po kliknięciu karty.
finalMobileUrl

string

Opcjonalnie: Adres URL strony, na którą trafiają użytkownicy po kliknięciu karty na urządzeniu mobilnym.
headline

string

Wymagane. Nagłówek karty.
callToAction

string

Wymagane. Tekst na przycisku wezwania do działania wyświetlanym na karcie.

Musi mieć maksymalnie 10 znaków.
marketingImage

object (ImageAsset)

Opcjonalnie: Obraz marketingowy wyświetlany na karcie.
squareMarketingImage

object (ImageAsset)

Opcjonalnie: Kwadratowy obraz marketingowy wyświetlany na karcie.
portraitMarketingImage

object (ImageAsset)

Opcjonalnie: Obraz marketingowy w orientacji pionowej wyświetlany na karcie.

DemandGenProductAd

Szczegóły reklamy produktów w kampanii generującej popyt.

Zapis JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
Pola
finalUrl

string

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

string

Wymagane. Nagłówek reklamy.
description

string

Wymagane. Opis reklamy.
finalUrlSuffix

string

Opcjonalnie: Sufiks, który ma być dołączany do adresów URL stron docelowych.
callToAction

enum (CallToAction)

Wymagane. Przycisk wezwania do działania wyświetlany w reklamie.

Obsługiwane wartości to:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

Tylko dane wyjściowe. Adres URL wczytywany w tle na potrzeby śledzenia.
userSpecifiedTrackingUrl

string

Opcjonalnie: Link monitorujący określony ręcznie przez użytkownika.
businessName

string

Opcjonalnie: Nazwa firmy wyświetlana w reklamie.

To ustawienie jest wymagane, chyba że na poziomie reklamodawcy jest ustawiona wartość domyślna. Jeśli nie zostanie ustawiona, zostanie zastosowana wartość domyślna.
customParameters

map (key: string, value: string)

Opcjonalnie: Parametry niestandardowe i towarzyszące im wartości, które mają zostać dodane do linku monitorującego.

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

string

Opcjonalnie: Pierwsza część po domenie w wyświetlanym adresie URL.
displayUrlBreadcrumb2

string

Opcjonalnie: Druga część po domenie w wyświetlanym adresie URL.

AdPolicy

Pojedyncze zasady dotyczące reklam powiązane z reklamą w grupie reklam.

Zapis JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Pola
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

Stan zatwierdzenia reklamy pod kątem zgodności z zasadami, który wskazuje decyzję o zatwierdzeniu.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

Stan weryfikacji zgodności reklamy z zasadami, który wskazuje, na jakim etapie procesu sprawdzania znajduje się obecnie reklama.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Wpisy dotyczące każdego tematu zasad, który został zidentyfikowany jako powiązany z reklamą. Każdy wpis zawiera temat, poziom ograniczenia i wskazówki dotyczące rozwiązywania problemów z zasadami.

AdPolicyApprovalStatus

Możliwe stany zatwierdzenia zasad dotyczących reklam.

Wartości w polu enum
AD_POLICY_APPROVAL_STATUS_UNKNOWN Nieznany lub nieokreślony.
DISAPPROVED Nie będzie się wyświetlać.
APPROVED_LIMITED Będzie wyświetlana z ograniczeniami.
APPROVED Będzie wyświetlana bez ograniczeń.
AREA_OF_INTEREST_ONLY Reklama nie będzie się wyświetlać w krajach docelowych, ale może się wyświetlać użytkownikom, którzy szukają informacji o tych krajach.

AdPolicyReviewStatus

Możliwe stany weryfikacji zgodności z zasadami dotyczącymi reklam.

Wartości w polu enum
AD_POLICY_REVIEW_STATUS_UNKNOWN Nieznany lub nieokreślony.
REVIEW_IN_PROGRESS Obecnie w trakcie sprawdzania.
REVIEWED Wstępne sprawdzanie zostało zakończone. Inne procesy sprawdzania mogą być nadal w toku.
UNDER_APPEAL Przesłano ponownie do zatwierdzenia lub złożono odwołanie od decyzji dotyczącej zgodności z zasadami.
ELIGIBLE_MAY_SERVE Została uznana za kwalifikującą się i może się wyświetlać. Może być konieczne dalsze sprawdzenie.

AdPolicyTopicEntry

Wpis opisujący, jak reklama została zidentyfikowana jako powiązana z zasadami dotyczącymi reklam.

Zapis JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Pola
policyTopic

string

Temat dotyczący zasad.

Przykłady: „TRADEMARKS”, „ALCOHOL” itp.
policyLabel

string

Zlokalizowany tekst etykiety zasad.

Przykłady: „Znaki towarowe w tekście”, „Zawiera alkohol” itp.
policyTopicDescription

string

Krótkie podsumowanie tematu zasad.
policyTopicType

enum (AdPolicyTopicEntryType)

Jak dany temat zasad dotyczących reklam wpłynie na wyświetlanie reklam.
policyDecisionType

enum (AdPolicyDecisionType)

Źródło decyzji dotyczącej zgodności z zasadami.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Sposób egzekwowania zasad używany podczas weryfikacji zgodności z zasadami.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Dowody użyte do podjęcia decyzji dotyczącej zgodności z zasadami.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Ograniczenia wyświetlania związane z decyzją dotyczącą zgodności z zasadami.
appealInfo

object (AdPolicyTopicAppealInfo)

informacje o tym, jak odwołać się od decyzji dotyczącej zgodności z zasadami.

AdPolicyTopicEntryType

Możliwy wpływ tematu zasad dotyczących reklam na wyświetlanie reklam.

Wartości w polu enum
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Nieznany lub nieokreślony.
PROHIBITED Zasób nie będzie wyświetlany.
FULLY_LIMITED Zasób nie będzie się wyświetlać we wszystkich krajach docelowych.
LIMITED Zasób nie może wyświetlać się w niektórych krajach.
DESCRIPTIVE Zasób może być wyświetlany.
BROADENING Zasób może wyświetlać reklamy i może to robić poza normalnym zasięgiem.
AREA_OF_INTEREST_ONLY Zasób jest ograniczony we wszystkich krajach docelowych, ale może wyświetlać się użytkownikom, którzy szukają informacji o krajach docelowych.

AdPolicyDecisionType

Możliwe źródła decyzji dotyczącej zgodności z zasadami.

Wartości w polu enum
AD_POLICY_DECISION_TYPE_UNKNOWN Nieznany lub nieokreślony.
PURSUANT_TO_NOTICE Decyzja została podjęta na podstawie zawiadomienia o toczącym się postępowaniu, orzeczenia sądowego, skargi właściciela treści dotyczącej znaku towarowego itp.
GOOGLE_INVESTIGATION Decyzja została podjęta na podstawie dochodzenia przeprowadzonego przez Google.

AdPolicyEnforcementMeans

Możliwe środki egzekwowania zasad stosowane podczas weryfikacji zgodności z zasadami.

Wartości w polu enum
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Nieznany lub nieokreślony.
AUTOMATED Proces egzekwowania zasad był w pełni zautomatyzowany.
HUMAN_REVIEW W procesie egzekwowania decyzji częściowo lub całkowicie uczestniczył człowiek.

AdPolicyTopicEvidence

Informacje o dowodach użytych do podjęcia decyzji dotyczącej zgodności z zasadami.

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
Pola
Dowody na decyzję dotyczącą zgodności z zasadami. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
textList

object (TextList)

Lista dowodów znalezionych w tekście reklamy.
websiteList

object (WebsiteList)

Lista witryn powiązanych z reklamą.
httpCode

integer

Kod HTTP zwrócony podczas skanowania końcowego adresu URL.
languageCode

string

Język, w którym została napisana reklama.

To pole używa tagów języka IETF, takich jak „pl-PL”.
destinationTextList

object (DestinationTextList)

Tekst w miejscu docelowym reklamy, który powoduje naruszenie zasad.
destinationMismatch

object (DestinationMismatch)

niezgodność docelowych adresów URL reklam;
destinationNotWorking

object (DestinationNotWorking)

Informacje o błędach HTTP lub DNS związanych z miejscem docelowym reklamy.
trademark

object (Trademark)

Hasła związane ze znakiem towarowym, które spowodowały naruszenie zasad.
legalRemoval

object (LegalRemoval)

Egzekwowanie przepisów prawnych, które spowodowało naruszenie zasad.
counterfeit

object (Counterfeit)

Egzekwowanie zasad dotyczących podróbek, które spowodowało naruszenie zasad.
regionalRequirements

object (RegionalRequirements)

Proaktywne egzekwowanie zasad przez zespół ds. zaufania i bezpieczeństwa, które spowodowało naruszenie zasad.
Koniec pól wykluczających się wzajemnie.

TextList

Lista fragmentów tekstu, które naruszyły zasady.

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

string

Fragmenty tekstu z zasobu, które spowodowały wykrycie naruszenia zasad.

WebsiteList

listę witryn, które naruszyły zasady;

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

string

Witryny, które spowodowały wykrycie naruszenia zasad.

DestinationTextList

Lista tekstów miejsc docelowych, które naruszyły zasady.

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

string

Tekst w miejscu docelowym, który spowodował wykrycie naruszenia zasad.

DestinationMismatch

Szczegóły dotyczące niezgodności typów docelowych adresów URL.

Zapis JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Pola
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

Zestaw adresów URL, które nie pasują. Lista może zawierać jeden lub więcej typów identyfikatorów URI.

Przykład 1. [DISPLAY_URL, FINAL_URL] oznacza, że wyświetlany URL reklamy nie pasuje do końcowego adresu URL reklamy.

Przykład 2: [FINAL_URL] oznacza, że końcowy adres URL reklamy nie pasuje do zindeksowanego adresu URL, co również jest uważane za niezgodność miejsca docelowego.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Możliwe typy adresów URL.

Wartości w polu enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Nie określono lub nieznany.
DISPLAY_URL Wyświetlany URL.
FINAL_URL Końcowy URL
FINAL_MOBILE_URL Końcowy mobilny adres URL.
TRACKING_URL Link monitorujący.
MOBILE_TRACKING_URL Link monitorujący na urządzenia mobilne.

DestinationNotWorking

Szczegóły dotyczące błędów HTTP lub DNS związanych z miejscem docelowym reklamy.

Zapis JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
Pola
expandedUri

string

pełny adres URL, który nie działał;
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Urządzenie, na którym odwiedzenie adresu URL spowodowało błąd.
lastCheckedTime

string (Timestamp format)

Ostatni raz błąd wystąpił podczas przechodzenia do adresu URL.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
Błąd HTTP lub DNS. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Typ błędu DNS.
httpErrorCode

string (int64 format)

Kod błędu HTTP.
Koniec pól wykluczających się wzajemnie.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Możliwe typy błędów DNS.

Wartości w polu enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Nie określono lub nieznany.
HOSTNAME_NOT_FOUND Podczas pobierania strony docelowej nie znaleziono nazwy hosta w DNS.
GOOGLE_CRAWLER_DNS_ISSUE Google nie może zindeksować strony docelowej podczas komunikacji z serwerem DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Urządzenia, na których mógł wystąpić błąd podczas próby otwarcia adresu URL.

Wartości w polu enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Nie określono lub nieznany.
DESKTOP komputer,
ANDROID urządzenie z Androidem,
IOS urządzenie z iOS.

Znak towarowy

Hasła związane ze znakiem towarowym, które spowodowały naruszenie zasad.

Zapis JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Pola
owner

string

Właściciel treści zawierających znak towarowy.
term

string

Termin będący znakiem towarowym.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Kraje, w których naruszenie zasad jest istotne.

AdPolicyCriterionRestriction

Reprezentuje ograniczenie związane z krajem.

Zapis JSON 
{
  "countryCriterionId": string,
  "countryLabel": string
}
Pola
countryCriterionId

string (int64 format)

Identyfikator kryterium kraju.
countryLabel

string

Zlokalizowana nazwa kraju. Może być puste.

LegalRemoval

Egzekwowanie przepisów prawnych, wynikających z ustawy DMCA lub lokalnych przepisów prawnych.

Zapis JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
Pola
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Typ skargi, która spowodowała usunięcie treści ze względów prawnych.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Kraje, w których obowiązują ograniczenia związane z krajem ze względu na usunięcie treści ze względów prawnych.
restrictedUris[]

string

Adresy URL, które zostały objęte ograniczeniami z powodu usunięcia treści ze względów prawnych.
Szczegóły dotyczące typu usunięcia treści ze względów prawnych. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
dmca

object (Dmca)

Szczegółowe informacje o usunięciu treści ze względów prawnych na podstawie ustawy DMCA.
Koniec pól wykluczających się wzajemnie.

Ustawa DMCA

Szczegóły skargi związanej z ustawą DMCA.

Zapis JSON 
{
  "complainant": string
}
Pola
complainant

string

Podmiot, który złożył skargę prawną.

LocalLegal

Szczegóły lokalnych przepisów prawnych.

Zapis JSON 
{
  "lawType": string
}
Pola
lawType

string

Typ prawa, którego dotyczy zawiadomienie o toczącym się postępowaniu.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Możliwe typy skarg dotyczących usunięcia treści ze względów prawnych.

Wartości w polu enum
COPYRIGHT

Prawa autorskie.

Dotyczy tylko ustawy DMCA.
COURT_ORDER

orzeczenie sądowe,

Dotyczy tylko lokalnych przepisów prawa.

Podróbki

Szczegóły dotyczące egzekwowania zasad dotyczących podróbek, które spowodowały naruszenie zasad.

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

string

właścicieli treści lub produktów, którzy złożyli skargę;

RegionalRequirements

Proaktywne egzekwowanie przez zespół ds. zaufania i bezpieczeństwa zasad mających na celu spełnienie wymagań regionalnych. Jest to uznawane za dochodzenie prowadzone przez Google, a nie powiadomienie o naruszeniu przepisów, ponieważ jest to proaktywne egzekwowanie zasad dotyczących bezpieczeństwa i warunków korzystania z usługi.

Zapis JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Pola
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Lista wymagań regionalnych.

RegionalRequirementsEntry

Szczegóły dotyczące naruszenia prawa w danym regionie na poziomie zasad.

Zapis JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Pola
legalPolicy

string

Zasada dotycząca kwestii prawnych, która została naruszona.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Kraje, w których obowiązują ograniczenia związane z krajem ze względu na zasadę dotyczącą kwestii prawnych.

AdPolicyTopicConstraint

Szczegółowe informacje o ograniczeniach wyświetlania reklam.

Zapis JSON 
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
Pola
Ograniczenie wyświetlania. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
countryConstraint

object (AdPolicyCountryConstraintList)

Kraje, w których reklama nie może się wyświetlać.
resellerConstraint

object (AdPolicyResellerConstraint)

Ograniczenie sprzedawcy.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Kraje, w których do wyświetlania reklam wymagany jest certyfikat.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Kraje, w których domena zasobu nie jest objęta powiązanymi z nią certyfikatami.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Certyfikat jest wymagany do wyświetlania reklam w dowolnym kraju.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Certyfikat jest wymagany do wyświetlania reklam w dowolnym kraju, a obecny certyfikat nie obejmuje domeny reklamy.
Koniec pól wykluczających się wzajemnie.

AdPolicyCountryConstraintList

Lista krajów, w których reklama nie może się wyświetlać z powodu ograniczeń wynikających z zasad.

Zapis JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Pola
countries[]

object (AdPolicyCriterionRestriction)

Kraje, w których reklama nie może się wyświetlać.

AdPolicyResellerConstraint

Ten typ nie ma pól.

Temat zasad został ograniczony z powodu odrzucenia witryny pod kątem odsprzedaży.

AdPolicyGlobalCertificateMissingConstraint

Ten typ nie ma pól.

Certyfikat jest wymagany do wyświetlania reklam w dowolnym kraju.

AdPolicyGlobalCertificateDomainMismatchConstraint

Ten typ nie ma pól.

Certyfikat jest wymagany do wyświetlania reklam w dowolnym kraju, a obecny certyfikat nie obejmuje domeny reklamy.

AdPolicyTopicAppealInfo

Informacje o tym, jak odwołać się od decyzji dotyczącej zgodności z zasadami.

Zapis JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Pola
appealType

enum (AdPolicyAppealType)

czy istnieje możliwość odwołania się od decyzji za pomocą odwołania samoobsługowego lub formularza odwołania.

AdPolicyAppealType

Możliwe typy odwołań.

Wartości w polu enum
AD_POLICY_APPEAL_TYPE_UNKNOWN Nieznany lub nieokreślony.
SELF_SERVICE_APPEAL Od decyzji można się odwołać w trybie samoobsługowym.
APPEAL_FORM Od decyzji można się odwołać za pomocą formularza odwołania.

AdUrl

Dodatkowe adresy URL powiązane z reklamą, w tym sygnały nawigacyjne.

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

enum (AdUrlType)

Typ adresu URL reklamy.
url

string

Wartość ciągu adresu URL.

AdUrlType

Możliwe typy adresów URL reklam.

Wartości w polu enum
AD_URL_TYPE_UNSPECIFIED Nieznany lub nieokreślony.
AD_URL_TYPE_BEACON_IMPRESSION Piksel śledzący 1 x 1, który wysyła sygnał po wyświetleniu kreacji.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Rozwijany beacon wyświetleń DCM. W momencie wyświetlania jest on rozwijany do kilku sygnałów.
AD_URL_TYPE_BEACON_CLICK Link monitorujący, który ma zostać wywołany po aktywowaniu zdarzenia kliknięcia.
AD_URL_TYPE_BEACON_SKIP Link monitorujący, który ma zostać wywołany po aktywowaniu zdarzenia pominięcia.

DcmTrackingInfo

Szczegółowe informacje o śledzeniu DCM.

Zapis JSON 
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
Pola
placementId

string (int64 format)

Wymagane. Identyfikator miejsca docelowego DCM.
trackingAdId

string (int64 format)

Wymagane. Identyfikator reklamy śledzącej DCM.
creativeId

string (int64 format)

Wymagane. Identyfikator kreacji DCM.

Metody

create

 Tworzy reklamę w grupie reklam.

delete

 Usuwa reklamę z grupy reklam.

get

 Pobiera reklamę z grupy reklam.

list

 Wyświetla listę reklam w grupie reklam.

patch

 Aktualizuje reklamę w grupie reklam.