- 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
- Fälschung
- 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. 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 Status der Anzeige. |
adUrls[] |
Nur Ausgabe. Liste der URLs, die von der Anzeige verwendet werden. |
dcmTrackingInfo |
Optional. Die Informationen zur DCM-Tracking-Anzeige. Nur für Demand Gen-Anzeigen gültig. Wenn Sie die Informationen zur DCM-Tracking-Anzeige entfernen möchten, lassen Sie dieses Feld leer. |
| Die Details der Anzeige. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt: | |
displayVideoSourceAd |
Nur Ausgabe. Details zu 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 überspringbaren In-Stream-Anzeige nach 5 Sekunden, die für Marketingziele wie 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 zur Erreichung von Reichweitenmarketingzielen verwendet wird. |
bumperAd |
Nur Ausgabe. Details zu einer nicht überspringbaren Kurzvideoanzeige mit einer Länge von maximal 6 Sekunden, die zur Steigerung der Reichweite verwendet wird. |
audioAd |
Nur Ausgabe. Details zu einer Audioanzeige, die zur Erreichung von Reichweiten-Marketingzielen verwendet wird. |
videoDiscoverAd |
Nur Ausgabe. Details zu einer Anzeige zur Bewerbung eines Videos, die an Orten für die Entdeckung von Inhalten ausgeliefert wird. |
videoPerformanceAd |
Nur Ausgabe. Details zu einer Anzeige in einer Video-Aktionskampagne, mit der Aktionen für das Unternehmen, die Dienstleistung oder das Produkt erzielt werden sollen. |
demandGenVideoAd |
Details zu einer Demand Gen-Videoanzeige. |
demandGenImageAd |
Details zu einer Demand Gen-Bildanzeige. |
demandGenCarouselAd |
Details zu einer Demand Gen-Karussell-Anzeige. |
demandGenProductAd |
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 Videowiedergabe 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 maximal 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 |
Der Grund, warum die Videodaten nicht verfügbar sind. |
videoAssetId |
Erforderlich. Die ID des YouTube-Video-Assets. Dies ist der |
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 |
Häufige Anzeigenattribute |
customParameters |
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-, nicht überspringbare und Bumper-Anzeigen.
| JSON-Darstellung |
|---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": 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. |
actionButtonLabel |
Der Text auf dem Call-to-Action-Button. |
actionHeadline |
Der Titel des Call-to-Action-Banners. |
video |
Das YouTube-Video der Anzeige. |
companionBanner |
Das Bild, das neben der Videoanzeige zu sehen ist. |
ImageAsset
Metadaten eines Bild-Assets.
| JSON-Darstellung |
|---|
{
"mimeType": string,
"fullSize": {
object ( |
| Felder | |
|---|---|
mimeType |
Nur Ausgabe. Der MIME-Typ des Bild-Assets. |
fullSize |
Nur Ausgabe. Metadaten für dieses Bild in Originalgröße. |
fileSize |
Nur Ausgabe. Die 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 |
Häufige Anzeigenattribute |
customParameters |
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 |
Häufige Anzeigenattribute |
AudioAd
Details zu einer Audioanzeige
| JSON-Darstellung |
|---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": 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. |
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 |
Die erste Textzeile der Anzeige. |
description2 |
Zweite Textzeile für die Anzeige. |
video |
Das YouTube-Video, für das in der Anzeige geworben wird. |
thumbnail |
In der Anzeige verwendetes Vorschaubild. |
Miniaturansicht
Mögliche Thumbnail-Optionen in Video Discovery-Anzeigen
| Enums | |
|---|---|
THUMBNAIL_UNSPECIFIED |
Unbekannt oder nicht angegeben. |
THUMBNAIL_DEFAULT |
Das Standard-Thumbnail kann automatisch generiert oder vom Nutzer hochgeladen werden. |
THUMBNAIL_1 |
Miniaturansicht 1, die aus dem Video generiert wurde. |
THUMBNAIL_2 |
Miniaturansicht 2, die aus dem Video generiert wurde. |
THUMBNAIL_3 |
Miniaturansicht 3, die aus dem Video generiert wurde. |
VideoPerformanceAd
Details zu einer Video-Performance-Anzeige
| JSON-Darstellung |
|---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
| Felder | |
|---|---|
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. |
actionButtonLabels[] |
Die Liste der Text-Assets, die auf dem Call-to-Action-Button angezeigt werden. |
headlines[] |
Die Liste der Überschriften, die im Call-to-Action-Banner angezeigt werden. |
longHeadlines[] |
Die Liste der langen Anzeigentitel, die im Call-to-Action-Banner angezeigt werden. |
descriptions[] |
Die Liste der Beschreibungen, die im Call-to-Action-Banner angezeigt werden. |
displayUrlBreadcrumb1 |
Der erste Teil nach der Domain in der angezeigten URL. |
displayUrlBreadcrumb2 |
Der zweite Teil nach der Domain in der angezeigten URL. |
domain |
Die Domain der angezeigten URL. |
videos[] |
Die Liste der YouTube-Video-Assets, die von dieser Anzeige verwendet werden. |
customParameters |
Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
companionBanners[] |
Die Liste der Companion-Banner, die von dieser Anzeige verwendet werden. |
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 von 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 Companion-Banner, das für diese Anzeige verwendet wird. |
logo |
Optional. Das in dieser Anzeige verwendete Logobild. Diese Einstellung ist erforderlich, sofern kein Standardwert auf Werbetreibendenebene festgelegt ist. Wenn der Wert nicht festgelegt ist, 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 kein Standardwert auf Werbetreibendenebene festgelegt ist. Wenn der Wert nicht festgelegt ist, wird der Standardwert angewendet. |
CallToAction
Mögliche Call-to-Action-Werte für Demand Gen-Produkt- und ‑Videoanzeigen.
| Enums | |
|---|---|
CALL_TO_ACTION_UNSPECIFIED |
Nicht angegeben oder unbekannt. |
AUTOMATED |
Automatisiert: |
LEARN_MORE |
Weitere Informationen |
GET_QUOTE |
Angebot anfordern |
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 aufrufen |
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 kein Standardwert auf Werbetreibendenebene festgelegt ist. Wenn der Wert nicht festgelegt ist, 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 kein Standardwert auf Werbetreibendenebene festgelegt ist. Wenn der Wert nicht festgelegt ist, 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 kein Standardwert auf Werbetreibendenebene festgelegt ist. Wenn der Wert nicht festgelegt ist, 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 kein Standardwert auf Werbetreibendenebene festgelegt ist. Wenn der Wert nicht festgelegt ist, 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 der Call-to-Action-Schaltfläche, die auf der Karte angezeigt wird. Darf höchstens 10 Zeichen enthalten. |
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 kein Standardwert auf Werbetreibendenebene festgelegt ist. Wenn der Wert nicht festgelegt ist, 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 kein Standardwert auf Werbetreibendenebene festgelegt ist. Wenn der Wert nicht festgelegt ist, 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, in welcher Phase der Überprüfung sich die Anzeige gerade 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 dazu, wie Sie Richtlinienprobleme beheben können. |
AdPolicyApprovalStatus
Mögliche Status einer Genehmigung gemäß den Werberichtlinien.
| Enums | |
|---|---|
AD_POLICY_APPROVAL_STATUS_UNKNOWN |
Unbekannt oder nicht angegeben. |
DISAPPROVED |
Wird nicht ausgeliefert. |
APPROVED_LIMITED |
Die Auslieferung erfolgt mit Einschränkungen. |
APPROVED |
Wird ohne Einschränkungen ausgeliefert. |
AREA_OF_INTEREST_ONLY |
Anzeigen werden nicht in den Zielländern ausgeliefert, aber möglicherweise für Nutzer, die nach Informationen zu den Zielländern suchen. |
AdPolicyReviewStatus
Mögliche Status einer Überprüfung von Anzeigenrichtlinien.
| Enums | |
|---|---|
AD_POLICY_REVIEW_STATUS_UNKNOWN |
Unbekannt oder nicht angegeben. |
REVIEW_IN_PROGRESS |
Wird derzeit überprüft. |
REVIEWED |
Die primäre Überprüfung ist abgeschlossen. Andere Überprüfungen laufen möglicherweise noch. |
UNDER_APPEAL |
Noch einmal zur Genehmigung eingereicht oder Einspruch gegen eine Richtlinienentscheidung eingelegt. |
ELIGIBLE_MAY_SERVE |
Als berechtigt eingestuft und werden möglicherweise ausgeliefert. Es kann noch zu einer weiteren Überprüfung kommen. |
AdPolicyTopicEntry
Ein Eintrag, in dem beschrieben wird, wie eine Anzeige als Verstoß gegen eine Werberichtlinie identifiziert wurde.
| JSON-Darstellung |
|---|
{ "policyTopic": string, "policyLabel": string, "policyTopicDescription": string, "policyTopicType": enum ( |
| Felder | |
|---|---|
policyTopic |
Das Richtlinienthema. Beispiele: „TRADEMARKS“ (MARKEN), „ALCOHOL“ (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 bei der Richtlinienüberprüfung verwendeten Maßnahmen zur Richtliniendurchsetzung. |
policyTopicEvidences[] |
Die in der Richtlinienentscheidung verwendeten Beweise. |
policyTopicConstraints[] |
Die für die Richtlinienentscheidung relevanten Auslieferungsbeschränkungen. |
helpCenterLink |
Link zum Hilfeartikel zu den Google Ads-Werberichtlinien für das Richtlinienthema. |
appealInfo |
Informationen dazu, wie Sie Einspruch gegen die Richtlinienentscheidung einlegen können. |
AdPolicyTopicEntryType
Mögliche Auswirkungen eines Werberichtlinienthemas auf die Anzeigenbereitstellung.
| 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 bereitgestellt werden. |
BROADENING |
Die Ressource kann über die normale Abdeckung hinaus ausgeliefert werden. |
AREA_OF_INTEREST_ONLY |
Die Ressource ist für alle Zielländer eingeschränkt, kann aber für Nutzer bereitgestellt 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 einer rechtlichen Mitteilung, einer Gerichtsentscheidung oder einer Beschwerde des Markeninhabers usw. |
GOOGLE_INVESTIGATION |
Die Entscheidung basiert auf einer Untersuchung durch Google. |
AdPolicyEnforcementMeans
Mögliche Mittel zur Richtliniendurchsetzung, die bei der Richtlinienüberprüfung verwendet werden.
| Enums | |
|---|---|
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN |
Unbekannt oder nicht angegeben. |
AUTOMATED |
Der Prozess zur Durchsetzung der Richtlinien war vollständig automatisiert. |
HUMAN_REVIEW |
Ein Mensch war teilweise oder vollständig am Prozess zur Durchsetzung der Entscheidung beteiligt. |
AdPolicyTopicEvidence
Informationen zu den Beweisen, die bei der 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 Beweise für die Richtlinienentscheidung. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt: | |
textList |
Liste der Belege, die im Anzeigentext gefunden wurden. |
websiteList |
Liste der Websites, die mit der Anzeige verknüpft sind. |
httpCode |
HTTP-Code, der beim Crawlen der finalen URL zurückgegeben wurde. |
languageCode |
Die Sprache, in der die Anzeige verfasst ist. In diesem Feld werden IETF-Sprach-Tags wie „en-US“ verwendet. |
destinationTextList |
Der Text im Ziel der Anzeige, der einen Richtlinienverstoß verursacht. |
destinationMismatch |
Abweichungen bei den Anzeigenzielen. |
destinationNotWorking |
Informationen zu HTTP- oder DNS-Fehlern im Zusammenhang mit dem Anzeigenziel. |
trademark |
Markenbegriffe, die einen Richtlinienverstoß verursacht haben. |
legalRemoval |
Durchsetzung einer rechtlichen Verordnung, die zu einem Richtlinienverstoß geführt hat. |
counterfeit |
Durchsetzung von Maßnahmen gegen Produktfälschungen, die zu einem Richtlinienverstoß geführt hat. |
regionalRequirements |
Die proaktive Durchsetzung durch T&S hat einen Richtlinienverstoß verursacht. |
| 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 zum Richtlinienverstoß geführt 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 mit Zieltext, der gegen die Richtlinie verstoßen hat.
| JSON-Darstellung |
|---|
{ "destinationTexts": [ string ] } |
| Felder | |
|---|---|
destinationTexts[] |
Zieltext, der zum Richtlinienverstoß geführt hat. |
DestinationMismatch
Details zu Abweichungen 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 beim Aufrufen der URL der Fehler aufgetreten ist. |
lastCheckedTime |
Das letzte Mal, dass der Fehler beim Aufrufen der URL 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 von sich gegenseitig ausschließenden Feldern. 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 einen Richtlinienverstoß verursacht haben.
| JSON-Darstellung |
|---|
{
"owner": string,
"term": string,
"countryRestrictions": [
{
object ( |
| Felder | |
|---|---|
owner |
Der Inhaber der Markenrechte. |
term |
Der Markenbegriff. |
countryRestrictions[] |
Länder, in denen der Richtlinienverstoß relevant ist. |
AdPolicyCriterionRestriction
Stellt eine Ländereinschränkung dar.
| JSON-Darstellung |
|---|
{ "countryCriterionId": string, "countryLabel": string } |
| Felder | |
|---|---|
countryCriterionId |
Die Kriteriums-ID für das Land. |
countryLabel |
Lokalisierter Name für das Land. Kann leer sein. |
LegalRemoval
Durchsetzung von rechtlichen 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 der Zugriff aufgrund der Entfernung aus Rechtsgründen eingeschränkt ist. |
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 von sich gegenseitig ausschließenden Feldern. 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 gemäß lokaler Gesetzgebung. |
| Ende der sich gegenseitig ausschließenden Felder. | |
DMCA
Details zur DMCA-Beschwerde
| JSON-Darstellung |
|---|
{ "complainant": string } |
| Felder | |
|---|---|
complainant |
Die Rechtssubjekte, die die rechtliche Beschwerde eingereicht haben. |
LocalLegal
Details zu lokalen rechtlichen Bestimmungen
| JSON-Darstellung |
|---|
{ "lawType": string } |
| Felder | |
|---|---|
lawType |
Art des Gesetzes 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 den DMCA. |
COURT_ORDER |
Gerichtsentscheidung Gilt nur für lokales Recht. |
LOCAL_LEGAL |
Lokale gesetzliche Bestimmung. Gilt nur für lokales Recht. |
Fälschung
Details zur Durchsetzung von Maßnahmen gegen Produktfälschungen, die zu einem Richtlinienverstoß geführt haben.
| JSON-Darstellung |
|---|
{ "owners": [ string ] } |
| Felder | |
|---|---|
owners[] |
Die Inhalts- oder Rechteinhaber, die eine Beschwerde eingereicht haben. |
RegionalRequirements
Proaktive Durchsetzung von Richtlinien durch Trust & Safety (T&S), die regionale Anforderungen erfüllen sollen. Da es sich um eine proaktive Durchsetzung der Nutzungsbedingungen handelt, wird dies als Untersuchung durch Google und nicht als Mitteilung über eine Verordnung betrachtet.
| 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 von sich gegenseitig ausschließenden Feldern. 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 ein Zertifikat für die Anzeigenschaltung erforderlich ist. |
certificateDomainMismatchCountryList |
Länder, in denen die Domain der Ressource nicht durch die zugehörigen Zertifikate abgedeckt ist. |
globalCertificateMissing |
Ein Zertifikat ist erforderlich, damit die Anzeige in einem Land ausgeliefert werden kann. |
globalCertificateDomainMismatch |
Ein Zertifikat ist für die Auslieferung in allen Ländern 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 Richtlinienbeschrä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 eingeschränkt, weil die Website für Reseller-Zwecke abgelehnt wurde.
AdPolicyGlobalCertificateMissingConstraint
Dieser Typ hat keine Felder.
Ein Zertifikat ist erforderlich, damit die Anzeige in einem Land ausgeliefert werden kann.
AdPolicyGlobalCertificateDomainMismatchConstraint
Dieser Typ hat keine Felder.
Ein Zertifikat ist für die Auslieferung in allen Ländern 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 |
Gibt an, ob gegen die Entscheidung über einen Selfservice-Einspruch oder ein Einspruchsformular Einspruch eingelegt werden kann. |
appealFormLink |
Nur verfügbar, wenn |
AdPolicyAppealType
Mögliche Einspruchstypen.
| Enums | |
|---|---|
AD_POLICY_APPEAL_TYPE_UNKNOWN |
Unbekannt oder nicht angegeben. |
SELF_SERVICE_APPEAL |
Gegen die Entscheidung kann über ein Self-Service-Einspruchsverfahren Einspruch eingelegt werden. |
APPEAL_FORM |
Gegen die Entscheidung kann mit einem 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 Anzeigentypen für URLs.
| Enums | |
|---|---|
AD_URL_TYPE_UNSPECIFIED |
Unbekannt oder nicht angegeben. |
AD_URL_TYPE_BEACON_IMPRESSION |
Ein 1 × 1-Tracking-Pixel, das angepingt wird, wenn eine Impression eines Creatives ausgeliefert wird. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
Maximierbarer DCM-Beacon für Impressionen. Bei der Bereitstellung wird sie auf mehrere Beacons erweitert. |
AD_URL_TYPE_BEACON_CLICK |
Tracking-URL, die angepingt werden soll, wenn das Click-Event ausgelöst wird. |
AD_URL_TYPE_BEACON_SKIP |
Tracking-URL, die angepingt wird, wenn das Ereignis „Überspringen“ 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 ID der Tracking-Anzeige in CM. |
creativeId |
Erforderlich. Die DCM-Creative-ID. |
Methoden |
|
|---|---|
|
Erstellt eine Anzeige für eine Anzeigengruppe. |
|
Löscht eine Anzeige in einer Anzeigengruppe. |
|
Ruft eine Anzeige in einer Anzeigengruppe ab. |
|
Listet Anzeigen für Anzeigengruppen auf. |
|
Aktualisiert eine Anzeige in einer Anzeigengruppe. |