REST Resource: advertisers.adGroupAds

Ressource: AdGroupAd

Eine einzelne Anzeige, die einer Anzeigengruppe zugeordnet ist.

JSON-Darstellung
{
  "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.
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname der Anzeige.

advertiserId

string (int64 format)

Nur Ausgabe. Die eindeutige ID des Werbetreibenden, zu dem die Anzeige gehört.

adGroupAdId

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Anzeige. Wird vom System zugewiesen.

adGroupId

string (int64 format)

Erforderlich. Nicht veränderbar. Die eindeutige ID der Anzeigengruppe, zu der die Anzeige gehört.

displayName

string

Erforderlich. Der Anzeigename der Anzeige.

Muss UTF-8-codiert sein und darf maximal 255 Byte groß sein.

adPolicy

object (AdPolicy)

Nur Ausgabe. Der Richtlinien-Freigabestatus der Anzeige.

entityStatus

enum (EntityStatus)

Erforderlich. Der Entitätsstatus der Anzeige.

adUrls[]

object (AdUrl)

Nur Ausgabe. Liste der URLs, die von der Anzeige verwendet werden.

dcmTrackingInfo

object (DcmTrackingInfo)

Optional. Die Informationen zur DCM-Tracking-Anzeige.

Wenn Sie die Informationen zur DCM-Tracking-Anzeige entfernen möchten, lassen Sie dieses Feld leer.

containsSyntheticMedia

boolean

Optional. Gibt an, ob die Anzeige veränderte oder synthetische Medien enthält.

Sollte nur für Anzeigen von Werbetreibenden festgelegt werden, die für Wahlwerbung bestätigt wurden. Gilt nur für YouTube-Anzeigen.

parentCreativeId

string (int64 format)

Nur Ausgabe. Die ID des Display & Video 360-Creatives, das zum Generieren dieser Anzeige verwendet wurde.

Dieses Feld wird nur für Anzeigen ausgefüllt, die aus Creatives generiert wurden, die der übergeordneten Anzeigengruppe zugewiesen sind.

Die Anzeigendetails Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Nur Ausgabe. Details einer Anzeige, die aus einem Display & Video 360-Creative stammt.

mastheadAd

object (MastheadAd)

Nur Ausgabe. Details zu einer Anzeige, die im YouTube-Startseitenfeed ausgeliefert wird.

inStreamAd

object (InStreamAd)

Nur Ausgabe. Details zu einer In-Stream-Anzeige, die nach 5 Sekunden übersprungen werden kann, die für Marketingziele im Zusammenhang mit Markenbekanntheit oder Reichweite verwendet wird.

nonSkippableAd

object (NonSkippableAd)

Nur Ausgabe. Details zu einer nicht überspringbaren kurzen In-Stream-Videoanzeige mit einer Länge von 6 bis 15 Sekunden, die für Marketingziele im Bereich Reichweite verwendet wird.

bumperAd

object (BumperAd)

Nur Ausgabe. Details zu einer nicht überspringbaren kurzen Videoanzeige mit einer Länge von maximal 6 Sekunden, die für die Reichweite verwendet wird.

audioAd

object (AudioAd)

Nur Ausgabe. Details zu einer Audioanzeige, die für Marketingziele zur Steigerung der Reichweite verwendet wird.

videoDiscoverAd

object (VideoDiscoveryAd)

Nur Ausgabe. Details zu einer Anzeige, mit der ein Video beworben wird, das an Orten für die Entdeckung von Inhalten erscheint.

videoPerformanceAd

object (VideoPerformanceAd)

Nur Ausgabe. Details zu einer Anzeige, die in einer Video Action-Kampagne verwendet wird, um Aktionen für das Unternehmen, die Dienstleistung oder das Produkt zu fördern.

demandGenVideoAd

object (DemandGenVideoAd)

Optional. Details einer Demand Gen-Videoanzeige.

demandGenImageAd

object (DemandGenImageAd)

Optional. Details einer Demand Gen-Bildanzeige.

demandGenProductAd

object (DemandGenProductAd)

Optional. Details zu einer Demand Gen-Produktanzeige

Ende der sich gegenseitig ausschließenden Felder.

DisplayVideoSourceAd

Die Anzeige stammt aus einem DV360-Creative.

JSON-Darstellung
{
  "creativeId": string
}
Felder
creativeId

string (int64 format)

Die ID des Quell-Creatives.

MastheadAd

Details zu einer Masthead-Anzeige

JSON-Darstellung
{
  "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)
    }
  ]
}
Felder
video

object (YoutubeVideoDetails)

Das YouTube-Video, das für die Anzeige verwendet wird.

headline

string

Den Anzeigentitel der Anzeige

description

string

Die Beschreibung der Anzeige.

videoAspectRatio

enum (VideoAspectRatio)

Das Seitenverhältnis des automatisch wiedergegebenen YouTube-Videos im Masthead.

autoplayVideoStartMillisecond

string (int64 format)

Die Zeit in Millisekunden, nach der die Wiedergabe des Videos beginnt.

autoplayVideoDuration

string (Duration format)

Die Dauer, für die das Video automatisch abgespielt wird.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

callToActionButtonLabel

string

Der Text auf dem Call-to-Action-Button.

callToActionFinalUrl

string

Die Ziel-URL für den Call-to-Action-Button.

callToActionTrackingUrl

string

Die Tracking-URL für den Call-to-Action-Button.

showChannelArt

boolean

Gibt an, ob ein Hintergrundbild oder Banner oben auf einer YouTube-Seite angezeigt werden soll.

companionYoutubeVideos[]

object (YoutubeVideoDetails)

Die Videos, die auf Computern neben der Masthead-Anzeige zu sehen sind. Es dürfen nicht mehr als zwei sein.

YoutubeVideoDetails

Details zu einem YouTube-Video.

JSON-Darstellung
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason),
  "videoAssetId": string
}
Felder
id

string

Nur Ausgabe. Die YouTube-Video-ID, nach der auf der YouTube-Webseite gesucht werden kann.

unavailableReason

enum (VideoUnavailableReason)

Nur Ausgabe. Der Grund, warum die Videodaten nicht verfügbar sind.

videoAssetId

string (int64 format)

Erforderlich. Die ID des YouTube-Video-Assets. Dies ist die adAssetId einer AdAsset-Ressource.

VideoUnavailableReason

Mögliche Gründe, warum ein Video nicht verfügbar ist.

Enums
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Unbekannt oder nicht angegeben.
VIDEO_UNAVAILABLE_REASON_PRIVATE Das Video ist privat.
VIDEO_UNAVAILABLE_REASON_DELETED Das Video wurde gelöscht.

VideoAspectRatio

Mögliche Seitenverhältnisse für ein YouTube-Video.

Enums
VIDEO_ASPECT_RATIO_UNSPECIFIED Nicht angegeben oder unbekannt.
VIDEO_ASPECT_RATIO_WIDESCREEN Das Video wird gestreckt und oben und unten abgeschnitten.
VIDEO_ASPECT_RATIO_FIXED_16_9 Das Video hat ein festes Seitenverhältnis von 16:9.

InStreamAd

Details zu einer In-Stream-Anzeige

JSON-Darstellung
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Felder
commonInStreamAttribute

object (CommonInStreamAttribute)

Erforderlich. Allgemeine Anzeigenattribute.

customParameters

map (key: string, value: string)

Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

Allgemeine Attribute für In-Stream-Anzeigen, nicht überspringbare Anzeigen und Bumper-Anzeigen

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

string

Erforderlich. Die Adresse der Webseite, die in der Anzeige zu sehen ist.

finalUrl

string

Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken.

trackingUrl

string

Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird.

In v4 und früheren Versionen steht dieses Feld für die Tracking-URL, die vom Nutzer manuell angegeben wurde. Diese finden Sie in v5 unter userSpecifiedTrackingUrl.

userSpecifiedTrackingUrl

string

Optional. Die vom Nutzer manuell angegebene Tracking-URL.

actionButtonLabel

string

Optional. Der Text auf dem Call-to-Action-Button.

Muss festgelegt werden, wenn actionHeadline festgelegt ist.

actionHeadline

string

Optional. Die Überschrift des Call-to-Action-Banners.

video

object (YoutubeVideoDetails)

Erforderlich. Nicht veränderbar. Das YouTube-Video der Anzeige.

companionBanner

object (ImageAsset)

Optional. Das Bild, das neben der Videoanzeige zu sehen ist.

ImageAsset

Metadaten eines Bild-Assets.

JSON-Darstellung
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string,
  "assetId": string
}
Felder
mimeType

string

Nur Ausgabe. MIME-Typ des Bild-Assets.

fullSize

object (Dimensions)

Nur Ausgabe. Metadaten für dieses Bild in seiner Originalgröße.

fileSize

string (int64 format)

Nur Ausgabe. Dateigröße des Bild-Assets in Byte.

assetId

string (int64 format)

Erforderlich. Die eindeutige ID des Assets.

NonSkippableAd

Details zu einer nicht überspringbaren Anzeige.

JSON-Darstellung
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Felder
commonInStreamAttribute

object (CommonInStreamAttribute)

Erforderlich. Allgemeine Anzeigenattribute.

customParameters

map (key: string, value: string)

Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

Details zu einer Bumper-Anzeige

JSON-Darstellung
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Felder
commonInStreamAttribute

object (CommonInStreamAttribute)

Erforderlich. Allgemeine Anzeigenattribute.

AudioAd

Details zu einer Audioanzeige

JSON-Darstellung
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Felder
displayUrl

string

Die Adresse der Webseite, die in der Anzeige zu sehen ist.

finalUrl

string

Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken.

trackingUrl

string

Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird.

In v4 und früheren Versionen steht dieses Feld für die Tracking-URL, die vom Nutzer manuell angegeben wurde. Diese finden Sie in v5 unter userSpecifiedTrackingUrl.

userSpecifiedTrackingUrl

string

Optional. Die vom Nutzer manuell angegebene Tracking-URL.

video

object (YoutubeVideoDetails)

Das YouTube-Video der Anzeige.

VideoDiscoveryAd

Details zu einer Video Discovery-Anzeige

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

string

Den Anzeigentitel der Anzeige.

description1

string

Erste Textzeile für die Anzeige.

description2

string

Zweite Textzeile für die Anzeige.

video

object (YoutubeVideoDetails)

Das YouTube-Video, für das mit der Anzeige geworben wird.

thumbnail

enum (Thumbnail)

In der Anzeige verwendetes Thumbnail.

Miniaturansicht

Mögliche Thumbnail-Optionen in Video Discovery-Anzeigen.

Enums
THUMBNAIL_UNSPECIFIED Unbekannt oder nicht angegeben.
THUMBNAIL_DEFAULT Das Standard-Thumbnail, das automatisch generiert oder vom Nutzer hochgeladen werden kann.
THUMBNAIL_1 Thumbnail 1, aus dem Video generiert.
THUMBNAIL_2 Thumbnail 2, aus dem Video generiert.
THUMBNAIL_3 Thumbnail 3, aus dem Video generiert.

VideoPerformanceAd

Details zu einer leistungsorientierten Videoanzeige

JSON-Darstellung
{
  "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)
  }
}
Felder
finalUrl

string

Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken.

trackingUrl

string

Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird.

In v4 und früheren Versionen steht dieses Feld für die Tracking-URL, die vom Nutzer manuell angegeben wurde. Diese finden Sie in v5 unter userSpecifiedTrackingUrl.

userSpecifiedTrackingUrl

string

Optional. Die vom Nutzer manuell angegebene Tracking-URL.

actionButtonLabels[]

string

Optional. Die Liste der Text-Assets, die auf dem Call-to-Action-Button angezeigt werden.

Muss festgelegt werden, wenn headlines festgelegt ist.

headlines[]

string

Optional. Die Liste der Anzeigentitel, die im Call-to-Action-Banner angezeigt werden.

longHeadlines[]

string

Optional. Die Liste der langen Anzeigentitel, die im Call-to-Action-Banner angezeigt werden.

Muss festgelegt werden, es sei denn, der Wert für lineItemType der übergeordneten Werbebuchung ist LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE. In diesem Fall kann dieses Feld nicht festgelegt werden.

descriptions[]

string

Optional. Die Liste der Beschreibungen, die im Call-to-Action-Banner angezeigt werden.

Muss festgelegt werden, es sei denn, der lineItemType der übergeordneten Werbebuchung ist LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE. In diesem Fall kann dieses Feld nicht festgelegt werden.

displayUrlBreadcrumb1

string

Optional. Der erste Teil nach der Domain in der angezeigten URL.

displayUrlBreadcrumb2

string

Optional. Der zweite Teil nach der Domain in der angezeigten URL.

Kann nur festgelegt werden, wenn displayUrlBreadcrumb1 ebenfalls festgelegt ist.

domain

string

Nur Ausgabe. Die Domain der angezeigten URL.

videos[]

object (YoutubeVideoDetails)

Erforderlich. Die Liste der YouTube-Video-Assets, die in dieser Anzeige verwendet werden.

customParameters

map (key: string, value: string)

Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

companionBanners[]

object (ImageAsset)

Optional. Die Liste der Companion-Banner, die für diese Anzeige verwendet werden.

businessName

string

Optional. Der Name des Unternehmens, der in der Anzeige zu sehen ist.

Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet.

DemandGenVideoAd

Details zu einer Demand Gen-Videoanzeige

JSON-Darstellung
{
  "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
}
Felder
finalUrl

string

Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken.

trackingUrl

string

Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird.

userSpecifiedTrackingUrl

string

Optional. Die vom Nutzer manuell angegebene Tracking-URL.

callToAction

enum (CallToAction)

Erforderlich. Der Call-to-Action-Button, der in der Anzeige zu sehen ist.

Folgende Werte werden unterstützt:

  • 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

Erforderlich. Die Liste der Anzeigentitel, die in der Anzeige zu sehen sind.

longHeadlines[]

string

Erforderlich. Die Liste der langen Anzeigentitel, die in der Anzeige zu sehen sind.

descriptions[]

string

Erforderlich. Die Liste der Beschreibungen, die in der Anzeige zu sehen sind.

displayUrlBreadcrumb1

string

Optional. Der erste Teil nach der Domain in der angezeigten URL.

displayUrlBreadcrumb2

string

Optional. Der zweite Teil nach der Domain in der angezeigten URL.

videos[]

object (YoutubeVideoDetails)

Erforderlich. Die Liste der YouTube-Video-Assets, die in dieser Anzeige verwendet werden.

customParameters

map (key: string, value: string)

Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

companionBanner

object (ImageAsset)

Optional. Das von dieser Anzeige verwendete Companion-Banner.

finalMobileUrl

string

Optional. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf einem Mobilgerät auf die Anzeige klicken.

finalUrlSuffix

string

Optional. Das Suffix, das an Landingpage-URLs angehängt werden soll.

businessName

string

Optional. Der Name des Unternehmens, der in der Anzeige zu sehen ist.

Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet.

CallToAction

Mögliche Call-to-Action-Werte für Demand Gen-Produkt-/Videoanzeigen.

Enums
CALL_TO_ACTION_UNSPECIFIED Nicht angegeben oder unbekannt.
AUTOMATED Automatisiert:
LEARN_MORE Weitere Informationen
GET_QUOTE Angebot einholen.
APPLY_NOW Jetzt beantragen.
SIGN_UP Registrieren.
CONTACT_US Kontakt
SUBSCRIBE Abonnieren
DOWNLOAD Herunterladen.
BOOK_NOW Jetzt buchen.
SHOP_NOW Jetzt Angebote sichern.
BUY_NOW Jetzt kaufen.
DONATE_NOW Jetzt spenden.
ORDER_NOW Jetzt bestellen.
PLAY_NOW Jetzt spielen.
SEE_MORE Mehr dazu.
START_NOW Jetzt starten.
VISIT_SITE Website besuchen.
WATCH_NOW Jetzt ansehen.

DemandGenImageAd

Details zu einer Demand Gen-Bildanzeige

JSON-Darstellung
{
  "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)
    }
  ]
}
Felder
finalUrl

string

Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken.

trackingUrl

string

Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird.

userSpecifiedTrackingUrl

string

Optional. Die vom Nutzer manuell angegebene Tracking-URL.

callToAction

string

Erforderlich. Der Call-to-Action-Button, der in der Anzeige zu sehen ist.

headlines[]

string

Erforderlich. Die Liste der Anzeigentitel, die in der Anzeige zu sehen sind.

descriptions[]

string

Erforderlich. Die Liste der Beschreibungen, die in der Anzeige zu sehen sind.

customParameters

map (key: string, value: string)

Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

finalMobileUrl

string

Optional. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf einem Mobilgerät auf die Anzeige klicken.

finalUrlSuffix

string

Optional. Das Suffix, das an Landingpage-URLs angehängt werden soll.

businessName

string

Optional. Der Name des Unternehmens, der in der Anzeige zu sehen ist.

Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet.

marketingImages[]

object (ImageAsset)

Die Liste der Marketingbilder, die in der Anzeige zu sehen sind.

squareMarketingImages[]

object (ImageAsset)

Die Liste der quadratischen Marketingbilder, die in der Anzeige zu sehen sind.

portraitMarketingImages[]

object (ImageAsset)

Die Liste der Marketingbilder im Hochformat, die in der Anzeige zu sehen sind.

logoImages[]

object (ImageAsset)

Die Liste der Logobilder, die in der Anzeige zu sehen sind.

Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet.

DemandGenCarouselAd

Details zu einer Demand Gen-Karussell-Anzeige.

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

string

Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken.

headline

string

Erforderlich. Den Anzeigentitel der Anzeige

description

string

Erforderlich. Die Beschreibung der Anzeige.

cards[]

object (CarouselCard)

Erforderlich. Die Liste der Karten, die in der Anzeige zu sehen sind.

finalUrlSuffix

string

Optional. Das Suffix, das an Landingpage-URLs angehängt werden soll.

trackingUrl

string

Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird.

userSpecifiedTrackingUrl

string

Optional. Die vom Nutzer manuell angegebene Tracking-URL.

businessName

string

Optional. Der Name des Unternehmens, der in der Anzeige zu sehen ist.

Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet.

customParameters

map (key: string, value: string)

Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CarouselCard

Details für eine Demand Gen-Karussell-Karte.

JSON-Darstellung
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Felder
finalUrl

string

Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Karte klicken.

finalMobileUrl

string

Optional. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf einem Mobilgerät auf die Karte klicken.

headline

string

Erforderlich. Der Titel der Karte.

callToAction

string

Erforderlich. Der Text auf dem Call-to-Action-Button, der auf der Karte angezeigt wird.

Maximal 10 Zeichen zulässig.

marketingImage

object (ImageAsset)

Optional. Das Marketingbild, das auf der Karte angezeigt wird.

squareMarketingImage

object (ImageAsset)

Optional. Das quadratische Marketingbild, das auf der Karte angezeigt wird.

portraitMarketingImage

object (ImageAsset)

Optional. Das Marketingbild im Hochformat, das auf der Karte angezeigt wird.

DemandGenProductAd

Details zu einer Demand Gen-Produktanzeige.

JSON-Darstellung
{
  "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
}
Felder
finalUrl

string

Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken.

headline

string

Erforderlich. Den Anzeigentitel der Anzeige

description

string

Erforderlich. Die Beschreibung der Anzeige.

finalUrlSuffix

string

Optional. Das Suffix, das an Landingpage-URLs angehängt werden soll.

callToAction

enum (CallToAction)

Erforderlich. Der Call-to-Action-Button, der in der Anzeige zu sehen ist.

Folgende Werte werden unterstützt:

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

string

Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird.

userSpecifiedTrackingUrl

string

Optional. Die vom Nutzer manuell angegebene Tracking-URL.

businessName

string

Optional. Der Name des Unternehmens, der in der Anzeige zu sehen ist.

Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet.

customParameters

map (key: string, value: string)

Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

displayUrlBreadcrumb1

string

Optional. Der erste Teil nach der Domain in der angezeigten URL.

displayUrlBreadcrumb2

string

Optional. Der zweite Teil nach der Domain in der angezeigten URL.

AdPolicy

Eine einzelne Werberichtlinie, die mit einer Anzeige in einer Anzeigengruppe verknüpft ist.

JSON-Darstellung
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Felder
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

Der Richtlinien-Freigabestatus einer Anzeige, der die Freigabeentscheidung angibt.

adPolicyReviewStatus

enum (AdPolicyReviewStatus)

Der Status der Richtlinienüberprüfung einer Anzeige, der angibt, wo sich die Anzeige derzeit im Überprüfungsprozess befindet.

adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Die Einträge für jedes Richtlinienthema, das sich auf die Anzeige bezieht. Jeder Eintrag enthält das Thema, die Einschränkungsstufe und eine Anleitung zur Behebung von Richtlinienproblemen.

AdPolicyApprovalStatus

Mögliche Statuswerte für die Freigabe von Anzeigen gemäß den Werberichtlinien.

Enums
AD_POLICY_APPROVAL_STATUS_UNKNOWN Unbekannt oder nicht angegeben.
DISAPPROVED Wird nicht ausgeliefert.
APPROVED_LIMITED Anzeigen werden mit Einschränkungen ausgeliefert.
APPROVED Wird ohne Einschränkungen ausgeliefert.
AREA_OF_INTEREST_ONLY Die Anzeige wird nicht in den Zielländern ausgeliefert, aber möglicherweise für Nutzer, die nach Informationen zu den Zielländern suchen.

AdPolicyReviewStatus

Mögliche Statuswerte einer Überprüfung der Werberichtlinien.

Enums
AD_POLICY_REVIEW_STATUS_UNKNOWN Unbekannt oder nicht angegeben.
REVIEW_IN_PROGRESS Wird derzeit überprüft.
REVIEWED Primäre Überprüfung abgeschlossen. Andere Überprüfungen sind möglicherweise noch nicht abgeschlossen.
UNDER_APPEAL Die Anzeige wurde noch einmal zur Freigabe eingereicht oder es wurde Einspruch gegen eine Richtlinienentscheidung eingelegt.
ELIGIBLE_MAY_SERVE Als zulässig eingestuft und wird möglicherweise ausgeliefert. Eine weitere Überprüfung kann noch folgen.

AdPolicyTopicEntry

Ein Eintrag, der beschreibt, wie eine Anzeige als relevant für eine Werberichtlinie identifiziert wurde.

JSON-Darstellung
{
  "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)
  }
}
Felder
policyTopic

string

Das Richtlinienthema.

Beispiele: „MARKEN“, „ALKOHOL“ usw.

policyLabel

string

Lokalisierter Labeltext für die Richtlinie.

Beispiele: „Marken im Text“, „Enthält Alkohol“ usw.

policyTopicDescription

string

Eine kurze Zusammenfassung des Richtlinienthemas.

policyTopicType

enum (AdPolicyTopicEntryType)

Wie sich die Beziehung zum Thema der Werberichtlinie auf die Anzeigenbereitstellung auswirkt.

policyDecisionType

enum (AdPolicyDecisionType)

Die Quelle der Richtlinienentscheidung.

policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Die Mittel zur Durchsetzung der Richtlinien, die bei der Richtlinienüberprüfung verwendet werden.

policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Die Belege, die für die Richtlinienentscheidung verwendet wurden.

policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Die für die Richtlinienentscheidung relevanten Auslieferungseinschränkungen.

appealInfo

object (AdPolicyTopicAppealInfo)

Informationen dazu, wie Sie Einspruch gegen die Richtlinienentscheidung einlegen können.

AdPolicyTopicEntryType

Mögliche Auswirkungen eines Werberichtlinienthemas auf die Bereitstellung.

Enums
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Unbekannt oder nicht angegeben.
PROHIBITED Die Ressource wird nicht ausgeliefert.
FULLY_LIMITED Die Ressource wird nicht in allen Zielländern ausgeliefert.
LIMITED Die Ressource kann in einigen Ländern nicht ausgeliefert werden.
DESCRIPTIVE Die Ressource kann ausgeliefert werden.
BROADENING Die Ressource kann ausgeliefert werden und wird möglicherweise über die normale Abdeckung hinaus ausgeliefert.
AREA_OF_INTEREST_ONLY Die Ressource ist für alle Zielländer eingeschränkt, kann aber für Nutzer ausgeliefert werden, die nach Informationen zu den Zielländern suchen.

AdPolicyDecisionType

Mögliche Quellen einer Richtlinienentscheidung.

Enums
AD_POLICY_DECISION_TYPE_UNKNOWN Unbekannt oder nicht angegeben.
PURSUANT_TO_NOTICE Die Entscheidung basiert auf einem Bescheid, einer Gerichtsentscheidung oder einer Beschwerde eines Rechteinhabers usw.
GOOGLE_INVESTIGATION Die Entscheidung basiert auf einer von Google durchgeführten Prüfung.

AdPolicyEnforcementMeans

Mögliche Mittel zur Durchsetzung von Richtlinien, die bei der Richtlinienüberprüfung verwendet werden.

Enums
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Unbekannt oder nicht angegeben.
AUTOMATED Der Durchsetzungsprozess war vollständig automatisiert.
HUMAN_REVIEW Ein Mensch war teilweise oder vollständig am Prozess der Durchsetzung der Entscheidung beteiligt.

AdPolicyTopicEvidence

Informationen zu den Nachweisen, die für die Richtlinienentscheidung verwendet wurden.

JSON-Darstellung
{

  // 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.
}
Felder
Die Belege für die Richtlinienentscheidung. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
textList

object (TextList)

Liste der im Anzeigentext gefundenen Belege.

websiteList

object (WebsiteList)

Liste der mit der Anzeige verknüpften Websites.

httpCode

integer

HTTP-Code, der beim Crawlen der finalen URL zurückgegeben wurde.

languageCode

string

Die Sprache, in der die Anzeige verfasst wurde.

In diesem Feld werden IETF-Sprach-Tags wie „en-US“ verwendet.

destinationTextList

object (DestinationTextList)

Der Text im Anzeigenziel, der einen Richtlinienverstoß verursacht.

destinationMismatch

object (DestinationMismatch)

Eine fehlende Übereinstimmung zwischen den Ziel-URLs der Anzeige.

destinationNotWorking

object (DestinationNotWorking)

Informationen zu HTTP- oder DNS-Fehlern im Zusammenhang mit dem Anzeigenziel.

trademark

object (Trademark)

Markenbegriffe, die zu einem Richtlinienverstoß geführt haben.

legalRemoval

object (LegalRemoval)

Rechtliche Durchsetzung von Vorschriften, die zu einem Richtlinienverstoß geführt hat.

counterfeit

object (Counterfeit)

Maßnahme wegen Produktfälschung, die zu einem Richtlinienverstoß geführt hat.

regionalRequirements

object (RegionalRequirements)

Proaktive Durchsetzung von Trust& Safety-Maßnahmen, die zu einem Richtlinienverstoß geführt hat.

Ende der sich gegenseitig ausschließenden Felder.

TextList

Eine Liste von Textfragmenten, die gegen die Richtlinie verstoßen haben.

JSON-Darstellung
{
  "texts": [
    string
  ]
}
Felder
texts[]

string

Die Textfragmente aus der Ressource, die das Richtlinienergebnis verursacht haben.

WebsiteList

Eine Liste der Websites, die gegen die Richtlinie verstoßen haben.

JSON-Darstellung
{
  "websites": [
    string
  ]
}
Felder
websites[]

string

Websites, die den Richtlinienverstoß verursacht haben.

DestinationTextList

Eine Liste der Zieltexte, die gegen die Richtlinie verstoßen haben.

JSON-Darstellung
{
  "destinationTexts": [
    string
  ]
}
Felder
destinationTexts[]

string

Zieltext, der zum Richtlinienbefund geführt hat.

DestinationMismatch

Details zu einer Abweichung zwischen Ziel-URL-Typen.

JSON-Darstellung
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Felder
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

Die Gruppe von URLs, die nicht übereinstimmen. Die Liste kann einen oder mehrere URI-Typen enthalten.

Beispiel 1: [DISPLAY_URL, FINAL_URL] bedeutet, dass die angezeigte URL der Anzeige nicht mit der finalen URL der Anzeige übereinstimmt.

Beispiel 2: [FINAL_URL] bedeutet, dass die finale URL der Anzeige nicht mit der gecrawlten URL übereinstimmt. Das wird ebenfalls als abweichendes Ziel gewertet.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Mögliche URL-Typen.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Nicht angegeben oder unbekannt.
DISPLAY_URL Die angezeigte URL.
FINAL_URL Die finale URL.
FINAL_MOBILE_URL Die finale mobile URL.
TRACKING_URL Die Tracking-URL.
MOBILE_TRACKING_URL Die mobile Tracking-URL.

DestinationNotWorking

Details zu HTTP- oder DNS-Fehlern im Zusammenhang mit dem Anzeigenziel.

JSON-Darstellung
{
  "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.
}
Felder
expandedUri

string

Die vollständige URL, die nicht funktioniert hat.

device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Das Gerät, auf dem der Aufruf der URL zu dem Fehler geführt hat.

lastCheckedTime

string (Timestamp format)

Der Zeitpunkt, zu dem der Fehler beim Aufrufen der URL zuletzt aufgetreten ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Der HTTP- oder DNS-Fehler. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Der Typ des DNS-Fehlers.

httpErrorCode

string (int64 format)

Der HTTP-Fehlercode.

Ende der sich gegenseitig ausschließenden Felder.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Mögliche DNS-Fehlertypen.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Nicht angegeben oder unbekannt.
HOSTNAME_NOT_FOUND Der Hostname wurde beim Abrufen der Landingpage nicht im DNS gefunden.
GOOGLE_CRAWLER_DNS_ISSUE Google konnte die Landingpage bei der Kommunikation mit dem DNS nicht crawlen.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Mögliche Geräte, auf denen beim Aufrufen der URL ein Fehler aufgetreten ist.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Nicht angegeben oder unbekannt.
DESKTOP Desktop-Gerät
ANDROID Android-Gerät
IOS iOS-Gerät

Marke

Markenbegriffe, die zu einem Richtlinienverstoß geführt haben.

JSON-Darstellung
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Felder
owner

string

Der Rechteinhaber der Marke.

term

string

Der markenrechtlich geschützte Begriff.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

Länder, in denen der Richtlinienverstoß relevant ist.

AdPolicyCriterionRestriction

Stellt eine länderspezifische Einschränkung dar.

JSON-Darstellung
{
  "countryCriterionId": string,
  "countryLabel": string
}
Felder
countryCriterionId

string (int64 format)

Die Kriteriums-ID für das Land.

countryLabel

string

Lokalisierter Name des Landes. Kann leer sein.

LegalRemoval

Durchsetzung rechtlicher Bestimmungen, entweder gemäß dem US-amerikanischen Urheberrechtsgesetz (Digital Millennium Copyright Act, DMCA) oder lokalen rechtlichen Bestimmungen.

JSON-Darstellung
{
  "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.
}
Felder
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Die Art der Beschwerde, die zur Entfernung aus Rechtsgründen geführt hat.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

Die Länder, in denen die Inhalte aufgrund der Entfernung aus Rechtsgründen eingeschränkt sind.

restrictedUris[]

string

Die URLs, die aufgrund der Entfernung aus Rechtsgründen eingeschränkt wurden.

Details zur Art der Entfernung aus Rechtsgründen. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
dmca

object (Dmca)

Details zur Entfernung aus Rechtsgründen gemäß DMCA-Verordnung.

Ende der sich gegenseitig ausschließenden Felder.

DMCA

Details zur DMCA-Beschwerde.

JSON-Darstellung
{
  "complainant": string
}
Felder
complainant

string

Die Rechtspersönlichkeit, die die rechtliche Beschwerde eingereicht hat.

LocalLegal

Details zu lokalen rechtlichen Bestimmungen.

JSON-Darstellung
{
  "lawType": string
}
Felder
lawType

string

Art des Rechts für den rechtlichen Hinweis.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Mögliche Beschwerdetypen für die Entfernung aus Rechtsgründen.

Enums
COPYRIGHT

Urheberrecht.

Gilt nur für DMCA.

COURT_ORDER

Gerichtsentscheidung

Gilt nur für lokale rechtliche Anforderungen.

Fälschung

Details zur Maßnahme wegen Produktfälschung, die zu einem Richtlinienverstoß geführt hat.

JSON-Darstellung
{
  "owners": [
    string
  ]
}
Felder
owners[]

string

Die Rechteinhaber der Inhalte oder Produkte, die eine Beschwerde eingereicht haben.

RegionalRequirements

Proaktive Durchsetzung von Richtlinien durch das Trust & Safety-Team, um regionale Anforderungen zu erfüllen. Dies gilt als von Google eingeleitete Untersuchung und nicht als behördliche Mitteilung, da es sich um eine proaktive Durchsetzung der Nutzungsbedingungen handelt.

JSON-Darstellung
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Felder
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Liste der regionalen Anforderungen.

RegionalRequirementsEntry

Details zu regionalen Rechtsverstößen auf Richtlinienebene.

JSON-Darstellung
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Felder
legalPolicy

string

Die rechtliche Richtlinie, gegen die verstoßen wird.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

Die Länder, die aufgrund der rechtlichen Richtlinie eingeschränkt sind.

AdPolicyTopicConstraint

Details zu Einschränkungen bei der Anzeigenbereitstellung

JSON-Darstellung
{
  "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.
}
Felder
Die Auslieferungseinschränkung. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
countryConstraint

object (AdPolicyCountryConstraintList)

Länder, in denen die Anzeige nicht ausgeliefert werden kann.

resellerConstraint

object (AdPolicyResellerConstraint)

Reseller-Einschränkung.

certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Länder, in denen für die Auslieferung ein Zertifikat erforderlich ist.

certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Länder, in denen die Domain der Ressource nicht durch die mit ihr verknüpften Zertifikate abgedeckt ist.

globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Für die Auslieferung in einem Land ist ein Zertifikat erforderlich.

globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Für die Auslieferung in allen Ländern ist ein Zertifikat erforderlich und das vorhandene Zertifikat deckt die Domain der Anzeige nicht ab.

Ende der sich gegenseitig ausschließenden Felder.

AdPolicyCountryConstraintList

Eine Liste der Länder, in denen die Anzeige aufgrund von Richtlinieneinschränkungen nicht ausgeliefert werden kann.

JSON-Darstellung
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Felder
countries[]

object (AdPolicyCriterionRestriction)

Länder, in denen die Anzeige nicht ausgeliefert werden kann.

AdPolicyResellerConstraint

Dieser Typ hat keine Felder.

Das Richtlinienthema wurde aufgrund der Ablehnung der Website für Reseller-Zwecke eingeschränkt.

AdPolicyGlobalCertificateMissingConstraint

Dieser Typ hat keine Felder.

Für die Auslieferung in einem Land ist ein Zertifikat erforderlich.

AdPolicyGlobalCertificateDomainMismatchConstraint

Dieser Typ hat keine Felder.

Für die Auslieferung in allen Ländern ist ein Zertifikat erforderlich und das vorhandene Zertifikat deckt die Domain der Anzeige nicht ab.

AdPolicyTopicAppealInfo

Informationen dazu, wie Sie Einspruch gegen eine Richtlinienentscheidung einlegen können.

JSON-Darstellung
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Felder
appealType

enum (AdPolicyAppealType)

Ob gegen die Entscheidung Einspruch über einen Selfservice-Einspruch oder ein Einspruchsformular eingelegt werden kann.

AdPolicyAppealType

Mögliche Arten von Einsprüchen.

Enums
AD_POLICY_APPEAL_TYPE_UNKNOWN Unbekannt oder nicht angegeben.
SELF_SERVICE_APPEAL Gegen die Entscheidung kann per Self-Service Einspruch eingelegt werden.
APPEAL_FORM Gegen die Entscheidung kann über ein Einspruchsformular Einspruch eingelegt werden.

AdUrl

Zusätzliche URLs im Zusammenhang mit der Anzeige, einschließlich Beacons.

JSON-Darstellung
{
  "type": enum (AdUrlType),
  "url": string
}
Felder
type

enum (AdUrlType)

Der Typ der Anzeigen-URL.

url

string

Der URL-Stringwert.

AdUrlType

Mögliche Anzeigen-URL-Typen.

Enums
AD_URL_TYPE_UNSPECIFIED Unbekannt oder nicht angegeben.
AD_URL_TYPE_BEACON_IMPRESSION Ein 1 × 1-Tracking-Pixel, das gepingt wird, wenn eine Impression eines Creatives ausgeliefert wird.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Expandable-DCM-Impressions-Beacon. Bei der Auslieferung wird sie auf mehrere Beacons erweitert.
AD_URL_TYPE_BEACON_CLICK Tracking-URL, die gepingt werden soll, wenn das Klickereignis ausgelöst wird.
AD_URL_TYPE_BEACON_SKIP Tracking-URL, die gepingt werden soll, wenn das Überspringen-Ereignis ausgelöst wird.

DcmTrackingInfo

Details zum DCM-Tracking.

JSON-Darstellung
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
Felder
placementId

string (int64 format)

Erforderlich. Die DCM-Placement-ID.

trackingAdId

string (int64 format)

Erforderlich. Die DCM-Tracking-Anzeigen-ID.

creativeId

string (int64 format)

Erforderlich. Die DCM-Creative-ID.

Methoden

create

Erstellt eine Anzeige in einer Anzeigengruppe.

delete

Löscht eine Anzeige in einer Anzeigengruppe.

get

Ruft eine Anzeige in einer Anzeigengruppe ab.

list

Listet Anzeigen in Anzeigengruppen auf.

patch

Aktualisiert eine Anzeige in einer Anzeigengruppe.