- Ressource: AdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Thumbnail
- VideoPerformanceAd
- DemandGenVideoAd
- CallToAction
- DemandGenImageAd
- DemandGenCarouselAd
- CarouselCard
- DemandGenProductAd
- AdPolicy
- AdPolicyApprovalStatus
- AdPolicyReviewStatus
- AdPolicyTopicEntry
- AdPolicyTopicEntryType
- AdPolicyDecisionType
- AdPolicyEnforcementMeans
- AdPolicyTopicEvidence
- TextList
- WebsiteList
- DestinationTextList
- DestinationMismatch
- AdPolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
- Markenrechtsverletzung
- AdPolicyCriterionRestriction
- LegalRemoval
- DMCA
- LocalLegal
- AdPolicyTopicEvidenceLegalRemovalComplaintType
- Produktfälschungen
- RegionalRequirements
- RegionalRequirementsEntry
- AdPolicyTopicConstraint
- AdPolicyCountryConstraintList
- AdPolicyResellerConstraint
- AdPolicyGlobalCertificateMissingConstraint
- AdPolicyGlobalCertificateDomainMismatchConstraint
- AdPolicyTopicAppealInfo
- AdPolicyAppealType
- AdUrl
- AdUrlType
- DcmTrackingInfo
- Methoden
Ressource: AdGroupAd
Eine einzelne Anzeige, die einer Anzeigengruppe zugeordnet ist.
| JSON-Darstellung |
|---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "adPolicy": { object ( |
| Felder | |
|---|---|
name |
Nur Ausgabe. Der Ressourcenname der Anzeige. |
advertiserId |
Nur Ausgabe. Die eindeutige ID des Werbetreibenden, zu dem die Anzeige gehört. |
adGroupAdId |
Nur Ausgabe. Die eindeutige ID der Anzeige. Wird vom System zugewiesen. |
adGroupId |
Erforderlich. Nicht veränderbar. Die eindeutige ID der Anzeigengruppe, zu der die Anzeige gehört. |
displayName |
Erforderlich. Der Anzeigename der Anzeige. Muss UTF-8-codiert sein und darf maximal 255 Byte groß sein. |
adPolicy |
Nur Ausgabe. Der Richtlinien-Freigabestatus der Anzeige. |
entityStatus |
Erforderlich. Der Entitätsstatus der Anzeige. |
adUrls[] |
Nur Ausgabe. Liste der URLs, die von der Anzeige verwendet werden. |
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 |
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 |
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 |
Nur Ausgabe. Details einer Anzeige, die aus einem Display & Video 360-Creative stammt. |
mastheadAd |
Nur Ausgabe. Details zu einer Anzeige, die im YouTube-Startseitenfeed ausgeliefert wird. |
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 |
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 |
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 |
Nur Ausgabe. Details zu einer Audioanzeige, die für Marketingziele zur Steigerung der Reichweite verwendet wird. |
videoDiscoverAd |
Nur Ausgabe. Details zu einer Anzeige, mit der ein Video beworben wird, das an Orten für die Entdeckung von Inhalten erscheint. |
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 |
Optional. Details einer Demand Gen-Videoanzeige. |
demandGenImageAd |
Optional. Details einer Demand Gen-Bildanzeige. |
demandGenCarouselAd |
Optional. Details zu einer Demand Gen-Karussell-Anzeige |
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 |
Die ID des Quell-Creatives. |
MastheadAd
Details zu einer Masthead-Anzeige
| JSON-Darstellung |
|---|
{ "video": { object ( |
| Felder | |
|---|---|
video |
Das YouTube-Video, das für die Anzeige verwendet wird. |
headline |
Den Anzeigentitel der Anzeige |
description |
Die Beschreibung der Anzeige. |
videoAspectRatio |
Das Seitenverhältnis des automatisch wiedergegebenen YouTube-Videos im Masthead. |
autoplayVideoStartMillisecond |
Die Zeit in Millisekunden, nach der die Wiedergabe des Videos beginnt. |
autoplayVideoDuration |
Die Dauer, für die das Video automatisch abgespielt wird. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
callToActionButtonLabel |
Der Text auf dem Call-to-Action-Button. |
callToActionFinalUrl |
Die Ziel-URL für den Call-to-Action-Button. |
callToActionTrackingUrl |
Die Tracking-URL für den Call-to-Action-Button. |
showChannelArt |
Gibt an, ob ein Hintergrundbild oder Banner oben auf einer YouTube-Seite angezeigt werden soll. |
companionYoutubeVideos[] |
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 ( |
| Felder | |
|---|---|
id |
Nur Ausgabe. Die YouTube-Video-ID, nach der auf der YouTube-Webseite gesucht werden kann. |
unavailableReason |
Nur Ausgabe. Der Grund, warum die Videodaten nicht verfügbar sind. |
videoAssetId |
Erforderlich. Die ID des YouTube-Video-Assets. Dies ist die |
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 ( |
| Felder | |
|---|---|
commonInStreamAttribute |
Erforderlich. Allgemeine Anzeigenattribute. |
customParameters |
Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
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 ( |
| Felder | |
|---|---|
displayUrl |
Erforderlich. Die Adresse der Webseite, die in der Anzeige zu sehen ist. |
finalUrl |
Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
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 |
Optional. Die vom Nutzer manuell angegebene Tracking-URL. |
actionButtonLabel |
Optional. Der Text auf dem Call-to-Action-Button. Muss festgelegt werden, wenn |
actionHeadline |
Optional. Die Überschrift des Call-to-Action-Banners. |
video |
Erforderlich. Nicht veränderbar. Das YouTube-Video der Anzeige. |
companionBanner |
Optional. Das Bild, das neben der Videoanzeige zu sehen ist. |
ImageAsset
Metadaten eines Bild-Assets.
| JSON-Darstellung |
|---|
{
"mimeType": string,
"fullSize": {
object ( |
| Felder | |
|---|---|
mimeType |
Nur Ausgabe. MIME-Typ des Bild-Assets. |
fullSize |
Nur Ausgabe. Metadaten für dieses Bild in seiner Originalgröße. |
fileSize |
Nur Ausgabe. Dateigröße des Bild-Assets in Byte. |
assetId |
Erforderlich. Die eindeutige ID des Assets. |
NonSkippableAd
Details zu einer nicht überspringbaren Anzeige.
| JSON-Darstellung |
|---|
{
"commonInStreamAttribute": {
object ( |
| Felder | |
|---|---|
commonInStreamAttribute |
Erforderlich. Allgemeine Anzeigenattribute. |
customParameters |
Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
BumperAd
Details zu einer Bumper-Anzeige
| JSON-Darstellung |
|---|
{
"commonInStreamAttribute": {
object ( |
| Felder | |
|---|---|
commonInStreamAttribute |
Erforderlich. Allgemeine Anzeigenattribute. |
AudioAd
Details zu einer Audioanzeige
| JSON-Darstellung |
|---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"userSpecifiedTrackingUrl": string,
"video": {
object ( |
| Felder | |
|---|---|
displayUrl |
Die Adresse der Webseite, die in der Anzeige zu sehen ist. |
finalUrl |
Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
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 |
Optional. Die vom Nutzer manuell angegebene Tracking-URL. |
video |
Das YouTube-Video der Anzeige. |
VideoDiscoveryAd
Details zu einer Video Discovery-Anzeige
| JSON-Darstellung |
|---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
| Felder | |
|---|---|
headline |
Den Anzeigentitel der Anzeige. |
description1 |
Erste Textzeile für die Anzeige. |
description2 |
Zweite Textzeile für die Anzeige. |
video |
Das YouTube-Video, für das mit der Anzeige geworben wird. |
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 ( |
| Felder | |
|---|---|
finalUrl |
Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
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 |
Optional. Die vom Nutzer manuell angegebene Tracking-URL. |
actionButtonLabels[] |
Optional. Die Liste der Text-Assets, die auf dem Call-to-Action-Button angezeigt werden. Muss festgelegt werden, wenn |
headlines[] |
Optional. Die Liste der Anzeigentitel, die im Call-to-Action-Banner angezeigt werden. |
longHeadlines[] |
Optional. Die Liste der langen Anzeigentitel, die im Call-to-Action-Banner angezeigt werden. Muss festgelegt werden, es sei denn, der Wert für |
descriptions[] |
Optional. Die Liste der Beschreibungen, die im Call-to-Action-Banner angezeigt werden. Muss festgelegt werden, es sei denn, der |
displayUrlBreadcrumb1 |
Optional. Der erste Teil nach der Domain in der angezeigten URL. |
displayUrlBreadcrumb2 |
Optional. Der zweite Teil nach der Domain in der angezeigten URL. Kann nur festgelegt werden, wenn |
domain |
Nur Ausgabe. Die Domain der angezeigten URL. |
videos[] |
Erforderlich. Die Liste der YouTube-Video-Assets, die in dieser Anzeige verwendet werden. |
customParameters |
Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
companionBanners[] |
Optional. Die Liste der Companion-Banner, die für diese Anzeige verwendet werden. |
businessName |
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. |
logo |
Optional. Das in dieser Anzeige verwendete Logobild. 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 ( |
| Felder | |
|---|---|
finalUrl |
Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird. |
userSpecifiedTrackingUrl |
Optional. Die vom Nutzer manuell angegebene Tracking-URL. |
callToAction |
Erforderlich. Der Call-to-Action-Button, der in der Anzeige zu sehen ist. Folgende Werte werden unterstützt:
|
headlines[] |
Erforderlich. Die Liste der Anzeigentitel, die in der Anzeige zu sehen sind. |
longHeadlines[] |
Erforderlich. Die Liste der langen Anzeigentitel, die in der Anzeige zu sehen sind. |
descriptions[] |
Erforderlich. Die Liste der Beschreibungen, die in der Anzeige zu sehen sind. |
displayUrlBreadcrumb1 |
Optional. Der erste Teil nach der Domain in der angezeigten URL. |
displayUrlBreadcrumb2 |
Optional. Der zweite Teil nach der Domain in der angezeigten URL. |
videos[] |
Erforderlich. Die Liste der YouTube-Video-Assets, die in dieser Anzeige verwendet werden. |
customParameters |
Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
companionBanner |
Optional. Das von dieser Anzeige verwendete Companion-Banner. |
logo |
Optional. Das in dieser Anzeige verwendete Logobild. Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet. |
finalMobileUrl |
Optional. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf einem Mobilgerät auf die Anzeige klicken. |
finalUrlSuffix |
Optional. Das Suffix, das an Landingpage-URLs angehängt werden soll. |
businessName |
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 ( |
| Felder | |
|---|---|
finalUrl |
Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird. |
userSpecifiedTrackingUrl |
Optional. Die vom Nutzer manuell angegebene Tracking-URL. |
callToAction |
Erforderlich. Der Call-to-Action-Button, der in der Anzeige zu sehen ist. |
headlines[] |
Erforderlich. Die Liste der Anzeigentitel, die in der Anzeige zu sehen sind. |
descriptions[] |
Erforderlich. Die Liste der Beschreibungen, die in der Anzeige zu sehen sind. |
customParameters |
Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
finalMobileUrl |
Optional. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf einem Mobilgerät auf die Anzeige klicken. |
finalUrlSuffix |
Optional. Das Suffix, das an Landingpage-URLs angehängt werden soll. |
businessName |
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[] |
Die Liste der Marketingbilder, die in der Anzeige zu sehen sind. |
squareMarketingImages[] |
Die Liste der quadratischen Marketingbilder, die in der Anzeige zu sehen sind. |
portraitMarketingImages[] |
Die Liste der Marketingbilder im Hochformat, die in der Anzeige zu sehen sind. |
logoImages[] |
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 ( |
| Felder | |
|---|---|
finalUrl |
Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
headline |
Erforderlich. Den Anzeigentitel der Anzeige |
description |
Erforderlich. Die Beschreibung der Anzeige. |
cards[] |
Erforderlich. Die Liste der Karten, die in der Anzeige zu sehen sind. |
finalUrlSuffix |
Optional. Das Suffix, das an Landingpage-URLs angehängt werden soll. |
trackingUrl |
Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird. |
userSpecifiedTrackingUrl |
Optional. Die vom Nutzer manuell angegebene Tracking-URL. |
businessName |
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 |
Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
logo |
Optional. Das in dieser Anzeige verwendete Logobild. Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet. |
CarouselCard
Details für eine Demand Gen-Karussell-Karte.
| JSON-Darstellung |
|---|
{ "finalUrl": string, "finalMobileUrl": string, "headline": string, "callToAction": string, "marketingImage": { object ( |
| Felder | |
|---|---|
finalUrl |
Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Karte klicken. |
finalMobileUrl |
Optional. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf einem Mobilgerät auf die Karte klicken. |
headline |
Erforderlich. Der Titel der Karte. |
callToAction |
Erforderlich. Der Text auf dem Call-to-Action-Button, der auf der Karte angezeigt wird. Maximal 10 Zeichen zulässig. |
marketingImage |
Optional. Das Marketingbild, das auf der Karte angezeigt wird. |
squareMarketingImage |
Optional. Das quadratische Marketingbild, das auf der Karte angezeigt wird. |
portraitMarketingImage |
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 ( |
| Felder | |
|---|---|
finalUrl |
Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
headline |
Erforderlich. Den Anzeigentitel der Anzeige |
description |
Erforderlich. Die Beschreibung der Anzeige. |
finalUrlSuffix |
Optional. Das Suffix, das an Landingpage-URLs angehängt werden soll. |
callToAction |
Erforderlich. Der Call-to-Action-Button, der in der Anzeige zu sehen ist. Folgende Werte werden unterstützt:
|
trackingUrl |
Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird. |
userSpecifiedTrackingUrl |
Optional. Die vom Nutzer manuell angegebene Tracking-URL. |
businessName |
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 |
Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
logo |
Optional. Das in dieser Anzeige verwendete Logobild. Diese Einstellung ist erforderlich, sofern auf Werbetreibendenebene kein Standardwert festgelegt ist. Wenn Sie nichts festlegen, wird der Standardwert angewendet. |
displayUrlBreadcrumb1 |
Optional. Der erste Teil nach der Domain in der angezeigten URL. |
displayUrlBreadcrumb2 |
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 ( |
| Felder | |
|---|---|
adPolicyApprovalStatus |
Der Richtlinien-Freigabestatus einer Anzeige, der die Freigabeentscheidung angibt. |
adPolicyReviewStatus |
Der Status der Richtlinienüberprüfung einer Anzeige, der angibt, wo sich die Anzeige derzeit im Überprüfungsprozess befindet. |
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 ( |
| Felder | |
|---|---|
policyTopic |
Das Richtlinienthema. Beispiele: „MARKEN“, „ALKOHOL“ usw. |
policyLabel |
Lokalisierter Labeltext für die Richtlinie. Beispiele: „Marken im Text“, „Enthält Alkohol“ usw. |
policyTopicDescription |
Eine kurze Zusammenfassung des Richtlinienthemas. |
policyTopicType |
Wie sich die Beziehung zum Thema der Werberichtlinie auf die Anzeigenbereitstellung auswirkt. |
policyDecisionType |
Die Quelle der Richtlinienentscheidung. |
policyEnforcementMeans |
Die Mittel zur Durchsetzung der Richtlinien, die bei der Richtlinienüberprüfung verwendet werden. |
policyTopicEvidences[] |
Die Belege, die für die Richtlinienentscheidung verwendet wurden. |
policyTopicConstraints[] |
Die für die Richtlinienentscheidung relevanten Auslieferungseinschränkungen. |
helpCenterLink |
Link zum Hilfeartikel für das Werberichtlinienthema. |
appealInfo |
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 ( |
| 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 |
Liste der im Anzeigentext gefundenen Belege. |
websiteList |
Liste der mit der Anzeige verknüpften Websites. |
httpCode |
HTTP-Code, der beim Crawlen der finalen URL zurückgegeben wurde. |
languageCode |
Die Sprache, in der die Anzeige verfasst wurde. In diesem Feld werden IETF-Sprach-Tags wie „en-US“ verwendet. |
destinationTextList |
Der Text im Anzeigenziel, der einen Richtlinienverstoß verursacht. |
destinationMismatch |
Eine fehlende Übereinstimmung zwischen den Ziel-URLs der Anzeige. |
destinationNotWorking |
Informationen zu HTTP- oder DNS-Fehlern im Zusammenhang mit dem Anzeigenziel. |
trademark |
Markenbegriffe, die zu einem Richtlinienverstoß geführt haben. |
legalRemoval |
Rechtliche Durchsetzung von Vorschriften, die zu einem Richtlinienverstoß geführt hat. |
counterfeit |
Maßnahme wegen Produktfälschung, die zu einem Richtlinienverstoß geführt hat. |
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[] |
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[] |
Websites, die den Richtlinienverstoß verursacht haben. |
DestinationTextList
Eine Liste der Zieltexte, die gegen die Richtlinie verstoßen haben.
| JSON-Darstellung |
|---|
{ "destinationTexts": [ string ] } |
| Felder | |
|---|---|
destinationTexts[] |
Zieltext, der zum Richtlinienbefund geführt hat. |
DestinationMismatch
Details zu einer Abweichung zwischen Ziel-URL-Typen.
| JSON-Darstellung |
|---|
{
"uriTypes": [
enum ( |
| Felder | |
|---|---|
uriTypes[] |
Die Gruppe von URLs, die nicht übereinstimmen. Die Liste kann einen oder mehrere URI-Typen enthalten. Beispiel 1: [ Beispiel 2: [ |
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 ( |
| Felder | |
|---|---|
expandedUri |
Die vollständige URL, die nicht funktioniert hat. |
device |
Das Gerät, auf dem der Aufruf der URL zu dem Fehler geführt hat. |
lastCheckedTime |
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: |
| 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 |
Der Typ des DNS-Fehlers. |
httpErrorCode |
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 ( |
| Felder | |
|---|---|
owner |
Der Rechteinhaber der Marke. |
term |
Der markenrechtlich geschützte Begriff. |
countryRestrictions[] |
Länder, in denen der Richtlinienverstoß relevant ist. |
AdPolicyCriterionRestriction
Stellt eine länderspezifische Einschränkung dar.
| JSON-Darstellung |
|---|
{ "countryCriterionId": string, "countryLabel": string } |
| Felder | |
|---|---|
countryCriterionId |
Die Kriteriums-ID für das Land. |
countryLabel |
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 ( |
| Felder | |
|---|---|
complaintType |
Die Art der Beschwerde, die zur Entfernung aus Rechtsgründen geführt hat. |
countryRestrictions[] |
Die Länder, in denen die Inhalte aufgrund der Entfernung aus Rechtsgründen eingeschränkt sind. |
restrictedUris[] |
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 |
Details zur Entfernung aus Rechtsgründen gemäß DMCA-Verordnung. |
localLegal |
Details zur Entfernung aus Rechtsgründen aufgrund lokaler rechtlicher Bestimmungen. |
| Ende der sich gegenseitig ausschließenden Felder. | |
DMCA
Details zur DMCA-Beschwerde.
| JSON-Darstellung |
|---|
{ "complainant": string } |
| Felder | |
|---|---|
complainant |
Die Rechtspersönlichkeit, die die rechtliche Beschwerde eingereicht hat. |
LocalLegal
Details zu lokalen rechtlichen Bestimmungen.
| JSON-Darstellung |
|---|
{ "lawType": string } |
| Felder | |
|---|---|
lawType |
Art des Rechts für den rechtlichen Hinweis. |
AdPolicyTopicEvidenceLegalRemovalComplaintType
Mögliche Beschwerdetypen für die Entfernung aus Rechtsgründen.
| Enums | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_LEGAL_REMOVAL_COMPLAINT_TYPE_UNKNOWN |
Nicht angegeben oder unbekannt. |
COPYRIGHT |
Urheberrecht. Gilt nur für DMCA. |
COURT_ORDER |
Gerichtsentscheidung Gilt nur für lokale rechtliche Anforderungen. |
LOCAL_LEGAL |
Lokale gesetzliche Bestimmungen. Gilt nur für lokale rechtliche Angelegenheiten. |
Fälschung
Details zur Maßnahme wegen Produktfälschung, die zu einem Richtlinienverstoß geführt hat.
| JSON-Darstellung |
|---|
{ "owners": [ string ] } |
| Felder | |
|---|---|
owners[] |
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 ( |
| Felder | |
|---|---|
regionalRequirementsEntries[] |
Liste der regionalen Anforderungen. |
RegionalRequirementsEntry
Details zu regionalen Rechtsverstößen auf Richtlinienebene.
| JSON-Darstellung |
|---|
{
"legalPolicy": string,
"countryRestrictions": [
{
object ( |
| Felder | |
|---|---|
legalPolicy |
Die rechtliche Richtlinie, gegen die verstoßen wird. |
countryRestrictions[] |
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 ( |
| Felder | |
|---|---|
requestCertificateFormLink |
Link zum Formular, über das ein Zertifikat für die Einschränkung angefordert werden kann. |
| 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 |
Länder, in denen die Anzeige nicht ausgeliefert werden kann. |
resellerConstraint |
Reseller-Einschränkung. |
certificateMissingCountryList |
Länder, in denen für die Auslieferung ein Zertifikat erforderlich ist. |
certificateDomainMismatchCountryList |
Länder, in denen die Domain der Ressource nicht durch die mit ihr verknüpften Zertifikate abgedeckt ist. |
globalCertificateMissing |
Für die Auslieferung in einem Land ist ein Zertifikat erforderlich. |
globalCertificateDomainMismatch |
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 ( |
| Felder | |
|---|---|
countries[] |
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 ( |
| Felder | |
|---|---|
appealType |
Ob gegen die Entscheidung Einspruch über einen Selfservice-Einspruch oder ein Einspruchsformular eingelegt werden kann. |
appealFormLink |
Nur verfügbar, wenn |
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 ( |
| Felder | |
|---|---|
type |
Der Typ der Anzeigen-URL. |
url |
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 |
Erforderlich. Die DCM-Placement-ID. |
trackingAdId |
Erforderlich. Die DCM-Tracking-Anzeigen-ID. |
creativeId |
Erforderlich. Die DCM-Creative-ID. |
Methoden |
|
|---|---|
|
Erstellt eine Anzeige in einer Anzeigengruppe. |
|
Löscht eine Anzeige in einer Anzeigengruppe. |
|
Ruft eine Anzeige in einer Anzeigengruppe ab. |
|
Listet Anzeigen in Anzeigengruppen auf. |
|
Aktualisiert eine Anzeige in einer Anzeigengruppe. |