REST Resource: customers.ads

FinalAppUrl

Eine URL für Deeplinks zu einer App für das jeweilige Betriebssystem.

JSON-Darstellung 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Felder
osType

enum (AppUrlOperatingSystemType)

Das Betriebssystem, auf das diese URL abzielt. Erforderlich.
url

string

Die Deeplink-URL der App Deeplinks geben eine Position in einer App an, die dem Inhalt entspricht, den du anzeigen möchtest. Sie müssen das Format {scheme}://{host_path} haben. Das Schema gibt an, welche App geöffnet werden soll. Für Ihre App können Sie ein benutzerdefiniertes Schema verwenden, das mit dem Namen der App beginnt. Host und Pfad geben an, wo sich Ihre Inhalte in der App befinden. Beispiel: „beispielapp://produktid_1234“. Erforderlich.

AppUrlOperatingSystemType

Betriebssystem

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
IOS Das Apple iOS-Betriebssystem.
ANDROID Das Android-Betriebssystem.

CustomParameter

Eine Zuordnung, die von Tags mit benutzerdefinierten Parametern in einem trackingUrlTemplate-, finalUrls- oder mobile_final_urls-Element verwendet werden kann.

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string

Der Schlüssel, der mit dem Parameter-Tag-Namen übereinstimmt.
value

string

Der Wert, der ersetzt werden soll.

AdType

Die möglichen Anzeigentypen.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
TEXT_AD Die Anzeige ist eine Textanzeige.
EXPANDED_TEXT_AD Die Anzeige ist eine erweiterte Textanzeige.
EXPANDED_DYNAMIC_SEARCH_AD Die Anzeige ist eine erweiterte dynamische Suchanzeige.
HOTEL_AD Die Anzeige ist eine Hotelanzeige.
SHOPPING_SMART_AD Die Anzeige ist eine smarte Shopping-Anzeige.
SHOPPING_PRODUCT_AD Die Anzeige ist eine Standard-Shopping-Anzeige.
VIDEO_AD Die Anzeige ist eine Videoanzeige.
IMAGE_AD Dies ist eine Bildanzeige.
RESPONSIVE_SEARCH_AD Die Anzeige ist eine responsive Suchanzeige.
LEGACY_RESPONSIVE_DISPLAY_AD Die Anzeige ist eine alte responsive Displayanzeige.
APP_AD Die Anzeige ist eine App-Anzeige.
LEGACY_APP_INSTALL_AD Die Anzeige ist eine alte App-Installationsanzeige.
RESPONSIVE_DISPLAY_AD Die Anzeige ist eine responsive Displayanzeige.
LOCAL_AD Die Anzeige ist eine lokale Anzeige.
HTML5_UPLOAD_AD Die Anzeige ist eine Display-Upload-Anzeige mit dem Produkttyp HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Die Anzeige ist eine Display-Upload-Anzeige mit einer der Produktarten DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Die Anzeige ist eine App-Interaktionsanzeige.
SHOPPING_COMPARISON_LISTING_AD Die Anzeige ist eine Shopping-Vergleichsanzeige.
VIDEO_BUMPER_AD Bumper-Videoanzeige
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Nicht überspringbare In-Stream-Videoanzeige
VIDEO_OUTSTREAM_AD Out-Stream-Videoanzeige
VIDEO_TRUEVIEW_IN_STREAM_AD TrueView In-Stream-Videoanzeige
VIDEO_RESPONSIVE_AD Responsive Videoanzeige
SMART_CAMPAIGN_AD Anzeige für smarte Kampagne.
CALL_AD Anrufanzeige.
APP_PRE_REGISTRATION_AD Universelle App-Anzeige zur Vorregistrierung.
IN_FEED_VIDEO_AD In-Feed-Videoanzeige
DISCOVERY_MULTI_ASSET_AD Discovery-Anzeige mit mehreren Assets.
TRAVEL_AD Reiseanzeige
DISCOVERY_VIDEO_RESPONSIVE_AD Responsive Discovery-Videoanzeige

Gerät

Gibt an, welche Google Ads-Geräte für die Ausrichtung zur Verfügung stehen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
MOBILE Mobilgeräte mit vollwertigem Internetbrowser
TABLET Tablets mit vollwertigem Internetbrowser
DESKTOP Computer.
CONNECTED_TV Smart-TVs und Spielekonsolen
OTHER Andere Gerätetypen

UrlCollection

Sammlung von URLs, die mit einer eindeutigen Kennung getaggt sind.

JSON-Darstellung 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Felder
finalUrls[]

string

Eine Liste möglicher finaler URLs.
finalMobileUrls[]

string

Eine Liste möglicher finaler mobiler URLs.
urlCollectionId

string

Eindeutige Kennung für diese UrlCollection-Instanz.
trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

SystemManagedResourceSource

Aufzählung der möglichen vom System verwalteten Entitätsquellen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AD_VARIATIONS Es wurde eine Testanzeige für Anzeigenvariationen erstellt.

TextAdInfo

Eine Textanzeige.

JSON-Darstellung 
{
  "headline": string,
  "description1": string,
  "description2": string
}
Felder
headline

string

Den Anzeigentitel der Anzeige.
description1

string

Die erste Zeile der Anzeigenbeschreibung.
description2

string

Die zweite Zeile der Anzeigenbeschreibung.

ExpandedTextAdInfo

Eine erweiterte Textanzeige.

JSON-Darstellung 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Felder
headlinePart1

string

Der erste Teil des Titels der Anzeige.
headlinePart2

string

Der zweite Teil des Anzeigetitels.
headlinePart3

string

Der dritte Teil des Titels der Anzeige.
description

string

Die Beschreibung der Anzeige.
description2

string

Die zweite Beschreibung der Anzeige.
path1

string

Der Text, der neben der angezeigten URL der Anzeige eingeblendet werden kann.
path2

string

Zusätzlicher Text, der neben der angezeigten URL der Anzeige eingeblendet werden kann.

CallAdInfo

Eine Anrufanzeige.

JSON-Darstellung 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Felder
countryCode

string

Der Ländercode in der Anzeige.
phoneNumber

string

Die Telefonnummer in der Anzeige.
businessName

string

Der Name des Unternehmens in der Anzeige.
headline1

string

Erster Anzeigentitel in der Anzeige
headline2

string

Zweiter Anzeigentitel in der Anzeige.
description1

string

Die erste Zeile der Anzeigenbeschreibung.
description2

string

Die zweite Zeile der Anzeigenbeschreibung.
callTracked

boolean

Gibt an, ob das Anruf-Tracking für das Creative aktiviert wird. Bei Aktivierung des Anruf-Trackings werden auch Anruf-Conversions aktiviert.
disableCallConversion

boolean

Gibt an, ob die Anruf-Conversion für das Creative deaktiviert werden soll. Wenn diese Richtlinie auf true gesetzt ist, werden Anruf-Conversions auch dann deaktiviert, wenn callTracked den Wert true hat. Wenn callTracked den Wert false hat, wird dieses Feld ignoriert.
phoneNumberVerificationUrl

string

Die URL, die für die Bestätigung der Telefonnummer verwendet werden soll.
conversionAction

string

Die Conversion-Aktion, der eine Anruf-Conversion zugeordnet werden soll. Ist die Richtlinie nicht konfiguriert, wird eine Standard-Conversion-Aktion verwendet. Dieses Feld ist nur wirksam, wenn callTracked auf true gesetzt ist. Andernfalls wird dieses Feld ignoriert.
conversionReportingState

enum (CallConversionReportingState)

Das Verhalten der Anruf-Conversions dieser Anrufanzeige. Sie kann eine eigene Einstellung für Anruf-Conversions verwenden, die Einstellung auf Kontoebene übernehmen oder deaktiviert werden.
path1

string

Der erste Teil des Textes, der an die URL in der Anzeige angehängt werden kann. Optional.
path2

string

Zweiter Teil des Textes, der an die URL in der Anzeige angehängt werden kann. Dieses Feld kann nur festgelegt werden, wenn auch path1 festgelegt ist. Optional.

CallConversionReportingState

Mögliche Datentypen für den Status einer Anruf-Conversion-Aktion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
DISABLED Die Anruf-Conversion-Aktion ist deaktiviert.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Für die Anruf-Conversion-Aktion wird der Anruf-Conversion-Typ verwendet, der auf Kontoebene festgelegt wurde.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Für die Anruf-Conversion-Aktion wird der Anruf-Conversion-Typ verwendet, der auf Ressourcenebene (Nur-Anrufanzeigen/Anruferweiterungen) festgelegt ist.

ExpandedDynamicSearchAdInfo

Eine erweiterte dynamische Suchanzeige.

JSON-Darstellung 
{
  "description": string,
  "description2": string
}
Felder
description

string

Die Beschreibung der Anzeige.
description2

string

Die zweite Beschreibung der Anzeige.

HotelAdInfo

Dieser Typ hat keine Felder.

Eine Hotelanzeige.

ShoppingSmartAdInfo

Dieser Typ hat keine Felder.

Eine smarte Shopping-Anzeige

ShoppingProductAdInfo

Dieser Typ hat keine Felder.

Eine Standard-Shopping-Anzeige

ImageAdInfo

Eine Bildanzeige

JSON-Darstellung 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Felder
mimeType

enum (MimeType)

Der MIME-Typ des Bildes.
pixelWidth

string (int64 format)

Breite in Pixeln des Bildes in voller Größe.
pixelHeight

string (int64 format)

Höhe in Pixeln des Bildes in voller Größe.
imageUrl

string

URL des Bildes in voller Größe.
previewPixelWidth

string (int64 format)

Breite des Bilds in der Vorschau in Pixeln.
previewPixelHeight

string (int64 format)

Höhe des Bilds in der Vorschau in Pixeln.
previewImageUrl

string

URL des Bilds in der Vorschaugröße.
name

string

Der Name des Bildes. Wenn das Bild aus einer Mediendatei erstellt wurde, ist dies der Name der Mediendatei. Wenn das Bild aus Bytes erstellt wurde, ist dieses Feld leer.
Union-Feld image. Das Bild, aus dem die ImageAd erstellt werden soll. Es gibt zwei Möglichkeiten, dies zu ändern. 1. Eine vorhandene MediaFile-Ressource. 2. Die Bildrohdaten in Byte. Für image ist nur einer der folgenden Werte zulässig:
mediaFile

string

Die MediaFile-Ressource, die für das Bild verwendet werden soll.
data

string (bytes format)

Rohbilddaten in Byte.

Ein base64-codierter String.
adIdToCopyImageFrom

string (int64 format)

Eine Anzeigen-ID, aus der das Bild kopiert werden soll.

MimeType

MIME-Typ

Enums
UNSPECIFIED Der MIME-Typ wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
IMAGE_JPEG Der MIME-Typ ist „image/jpeg“.
IMAGE_GIF MIME-Typ für image/gif.
IMAGE_PNG Der MIME-Typ ist „image/png“.
FLASH MIME-Typ für application/x-shockwave-flash.
TEXT_HTML MIME-Typ für text/html.
PDF MIME-Typ für application/pdf.
MSWORD MIME-Typ von application/msword
MSEXCEL MIME-Typ für application/vnd.ms-excel
RTF MIME-Typ für application/rtf.
AUDIO_WAV MIME-Typ für audio/wav.
AUDIO_MP3 MIME-Typ für audio/mp3.
HTML5_AD_ZIP MIME-Typ für application/x-html5-ad-zip.

VideoAdInfo

Eine Videoanzeige

JSON-Darstellung 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Felder
video

object (AdVideoAsset)

Die YouTube-Video-Assets, die für die Anzeige verwendet werden
Union-Feld format. Formatspezifisches Schema für die verschiedenen Videoformate. Für format ist nur einer der folgenden Werte zulässig:
inStream

object (VideoTrueViewInStreamAdInfo)

TrueView In-Stream-Videoanzeigen
bumper

object (VideoBumperInStreamAdInfo)

In-Stream-Videoanzeigenformat:
outStream

object (VideoOutstreamAdInfo)

Out-Stream-Videoanzeigenformat
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Nicht überspringbare In-Stream-Videoanzeige
inFeed

object (InFeedVideoAdInfo)

In-Feed-Videoanzeigenformat

AdVideoAsset

Ein Video-Asset, das in einer Anzeige verwendet wird

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

string

Der Name der Asset-Ressource dieses Videos.

VideoTrueViewInStreamAdInfo

Darstellung eines TrueView In-Stream-Videoanzeigenformats (Anzeige, die während der Videowiedergabe oft zu Beginn eingeblendet wird und bei der wenige Sekunden nach Beginn des Videos eine Schaltfläche zum Überspringen eingeblendet wird).

JSON-Darstellung 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
Felder
actionButtonLabel

string

Label der CTA-Schaltfläche, über die der Nutzer zur finalen URL der Videoanzeige gelangt Erforderlich für TrueView for Action-Kampagnen, ansonsten optional.
actionHeadline

string

Zusätzlicher Text, der mit der CTA-Schaltfläche (Call-to-Action) angezeigt wird, um Kontext zu bieten und Nutzer zum Klicken auf die Schaltfläche anzuregen
companionBanner

object (AdImageAsset)

Die Bild-Assets des Companion-Banners, das mit der Anzeige verwendet wird.

AdImageAsset

Ein Bild-Asset, das in einer Anzeige verwendet wird

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

string

Der Name der Asset-Ressource dieses Images.

VideoBumperInStreamAdInfo

Darstellung eines In-Stream-Video-Bumper-Anzeigenformats (sehr kurze, nicht überspringbare In-Stream-Videoanzeige)

JSON-Darstellung 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Felder
companionBanner

object (AdImageAsset)

Die Bild-Assets des Companion-Banners, das mit der Anzeige verwendet wird.
actionButtonLabel

string

Label der Call-to-Action-Schaltfläche, über die der Nutzer zur finalen URL der Videoanzeige gelangt
actionHeadline

string

Zusätzlicher Text, der mit der CTA-Schaltfläche (Call-to-Action) angezeigt wird, um Kontext zu bieten und Nutzer zum Klicken auf die Schaltfläche anzuregen

VideoOutstreamAdInfo

Darstellung eines Out-Stream-Videoanzeigenformats (Anzeige, die neben einem Feed mit automatischer Wiedergabe ohne Ton angezeigt wird)

JSON-Darstellung 
{
  "headline": string,
  "description": string
}
Felder
headline

string

Den Anzeigentitel der Anzeige.
description

string

Textzeile

VideoNonSkippableInStreamAdInfo

Darstellung eines nicht überspringbaren In-Stream-Videoanzeigenformats (15-sekündige, nicht überspringbare In-Stream-Videoanzeige)

JSON-Darstellung 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Felder
companionBanner

object (AdImageAsset)

Die Bild-Assets des Companion-Banners, das mit der Anzeige verwendet wird.
actionButtonLabel

string

Label der Call-to-Action-Schaltfläche, über die der Nutzer zur finalen URL der Videoanzeige gelangt
actionHeadline

string

Zusätzlicher Text, der mit der Schaltfläche „Call-to-Action“ angezeigt wird, um Kontext zu bieten und Nutzer zum Klicken auf die Schaltfläche anzuregen

InFeedVideoAdInfo

Darstellung des In-Feed-Videoanzeigenformats

JSON-Darstellung 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
Felder
headline

string

Den Anzeigentitel der Anzeige.
description1

string

Erste Textzeile für die Anzeige.
description2

string

Zweite Textzeile für die Anzeige
thumbnail

enum (VideoThumbnail)

Video-Miniaturansicht.

VideoThumbnail

Aufzählung der möglichen Typen eines Video-Thumbnails

Enums
UNSPECIFIED Der Typ wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt. Dies ist ein reiner Antwortwert.
DEFAULT_THUMBNAIL Das Standard-Thumbnail. Sie können automatisch erstellt oder von Nutzern hochgeladen werden.
THUMBNAIL_1 Aus dem Video generiertes Thumbnail 1.
THUMBNAIL_2 Aus dem Video generiertes Thumbnail 2.
THUMBNAIL_3 Aus dem Video generiertes Thumbnail 3.

VideoResponsiveAdInfo

Responsive Videoanzeige

JSON-Darstellung 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Felder
headlines[]

object (AdTextAsset)

Liste der Text-Assets, die für den kurzen Anzeigentitel verwendet werden. Für den kurzen Anzeigentitel wird derzeit nur ein einziger Wert unterstützt.
longHeadlines[]

object (AdTextAsset)

Liste der Text-Assets, die für den langen Anzeigentitel verwendet werden. Für einen langen Anzeigentitel wird derzeit nur ein einziger Wert unterstützt.
descriptions[]

object (AdTextAsset)

Liste der für die Beschreibung verwendeten Text-Assets. Derzeit wird nur ein einziger Wert für die Beschreibung unterstützt.
callToActions[]

object (AdTextAsset)

Liste der Text-Assets, die für die Schaltfläche verwendet werden, z. B. die Call-to-Action-Schaltfläche Derzeit wird nur ein Wert für die Schaltfläche unterstützt.
videos[]

object (AdVideoAsset)

Liste der YouTube-Video-Assets, die für die Anzeige verwendet werden Derzeit wird nur ein Wert für das YouTube-Video-Asset unterstützt.
companionBanners[]

object (AdImageAsset)

Liste der Bild-Assets, die für das Companion-Banner verwendet werden. Für das Companion-Banner-Asset wird derzeit nur ein einziger Wert unterstützt.
breadcrumb1

string

Der erste Teil des Textes, der in der Anzeige mit der angezeigten URL zu sehen ist.
breadcrumb2

string

Der zweite Teil des Textes, der in der Anzeige mit der angezeigten URL erscheint.

AdTextAsset

Ein Text-Asset, das in einer Anzeige verwendet wird

JSON-Darstellung 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
Felder
pinnedField

enum (ServedAssetFieldType)

Das angepinnte Feld des Assets. Dadurch wird das Asset nur in diesem Feld ausgeliefert. Es können mehrere Assets an dasselbe Feld angepinnt werden. Ein Asset, das losgelöst oder an ein anderes Feld angepinnt ist, wird in einem Feld, in dem ein anderes Asset angepinnt wurde, nicht ausgeliefert.
assetPerformanceLabel

enum (AssetPerformanceLabel)

Das Leistungslabel dieses Text-Assets.
policySummaryInfo

object (AdAssetPolicySummary)

Die Richtlinienzusammenfassung dieses Text-Assets.
text

string

Asset-Text.

ServedAssetFieldType

Die möglichen Asset-Feldtypen.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
HEADLINE_1 Das Asset wird für Anzeigentitel 1 verwendet.
HEADLINE_2 Das Asset wird für Anzeigentitel 2 verwendet.
HEADLINE_3 Das Asset wird für Anzeigentitel 3 verwendet.
DESCRIPTION_1 Das Asset wird in Textzeile 1 verwendet.
DESCRIPTION_2 Das Asset wird in Textzeile 2 verwendet.
CALL Dieses Asset wird für einen Anruf verwendet.
MOBILE_APP Dieses Asset wird für eine mobile App verwendet.
CALLOUT Dieses Asset wird als Zusatzinformation verwendet.
STRUCTURED_SNIPPET Dieses Asset wird als Snippet-Erweiterung verwendet.
PRICE Dieses Asset wird als Preis verwendet.
PROMOTION Dieses Asset wird als Werbung verwendet.
AD_IMAGE Dieses Asset wird als Bild verwendet.
LEAD_FORM Das Asset wird als Lead-Formular verwendet.

AssetPerformanceLabel

Aufzählung zur Beschreibung der möglichen Leistungslabels eines Inhalts, der normalerweise im Kontext einer Verknüpfung berechnet wird.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
PENDING Für dieses Asset liegen noch keine Leistungsinformationen vor. Das könnte daran liegen, dass die Überprüfung noch nicht abgeschlossen ist.
LEARNING Mit dem Asset werden Impressionen erzielt, aber die Statistiken sind statistisch nicht signifikant genug, um ein Leistungslabel für das Asset zu erhalten.
LOW Assets mit der schlechtesten Leistung
GOOD Assets mit guter Leistung
BEST Leistungsstärkste Assets

AdAssetPolicySummary

Enthält Richtlinieninformationen zu einem Asset in einer Anzeige.

JSON-Darstellung 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Felder
policyTopicEntries[]

object (PolicyTopicEntry)

Die Liste der Richtlinienergebnisse für dieses Asset.
reviewStatus

enum (PolicyReviewStatus)

Wo im Überprüfungsprozess dieses Asset
approvalStatus

enum (PolicyApprovalStatus)

Der Gesamtgenehmigungsstatus dieses Assets, der auf der Grundlage des Status der einzelnen Einträge von Richtlinienthemen berechnet wird.

PolicyTopicEntry

Richtlinienergebnisse für eine Ressource (z. B. Richtlinie zu Alkohol, die mit einer Website verknüpft ist, auf der Alkohol verkauft wird).

Jeder PolicyTopicEntry umfasst ein Thema, das die spezifische Anzeigenrichtlinie des Eintrags angibt, sowie einen Typ, der die Auswirkungen des Eintrags auf die Auslieferung angibt. Optional kann sie einen oder mehrere Nachweise enthalten, die den Grund für die Feststellung angeben. Optional kann sie auch eine oder mehrere Einschränkungen enthalten, die Details dazu enthalten, inwiefern die Bereitstellung eingeschränkt sein kann.

JSON-Darstellung 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
Felder
type

enum (PolicyTopicEntryType)

Beschreibt die negativen oder positiven Auswirkungen dieser Richtlinie auf die Auslieferung.
evidences[]

object (PolicyTopicEvidence)

Zusätzliche Informationen zur Erläuterung eines Richtlinienergebnisses, z. B. der Markenname für ein Markenergebnis.
constraints[]

object (PolicyTopicConstraint)

Gibt an, wie die Bereitstellung dieser Ressource beeinflusst werden kann, z. B. wenn sie in einem Land nicht bereitgestellt wird.
topic

string

Richtlinienthema, auf das sich dieses Ergebnis bezieht. Beispiel: „ALCOHOL“, „TRADEMARKS_IN_AD_TEXT“ oder „DESTINATION_NOT_WORKING“. Die Anzahl der möglichen Richtlinienthemen ist für eine bestimmte API-Version nicht festgelegt und kann sich jederzeit ändern.

PolicyTopicEntryType

Die möglichen Eintragstypen für Richtlinienthemen.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
PROHIBITED Die Ressource wird nicht bereitgestellt.
LIMITED Die Ressource wird unter bestimmten Umständen nicht bereitgestellt.
FULLY_LIMITED Die Ressource kann aufgrund der aktuellen Targeting-Kriterien überhaupt nicht ausgeliefert werden.
DESCRIPTIVE Kann von Interesse sein, schränkt aber nicht ein, wie die Ressource bereitgestellt wird.
BROADENING Sie könnte die Abdeckung über den normalen Bereich hinaus erhöhen.
AREA_OF_INTEREST_ONLY Für alle Zielländer eingeschränkt, Anzeigen können aber aufgrund von Interessengebieten in anderen Ländern ausgeliefert werden.

PolicyTopicEvidence

Zusätzliche Informationen zur Erläuterung eines Richtlinienergebnisses.

JSON-Darstellung 
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
Felder
Union-Feld value. Spezifische Nachweisinformationen je nach Nachweistyp. Für value ist nur einer der folgenden Werte zulässig:
websiteList

object (WebsiteList)

Liste der Websites, die mit dieser Ressource verknüpft sind.
textList

object (TextList)

Liste der im Text einer Ressource gefundenen Nachweise.
languageCode

string

Die Sprache, in der die Ressource geschrieben wurde. Dies ist ein IETF-Sprachtag wie „en-US“.
destinationTextList

object (DestinationTextList)

Der Text im Ziel der Ressource, der ein Richtlinienergebnis verursacht.
destinationMismatch

object (DestinationMismatch)

Die Ziele der URLs einer Ressource stimmen nicht überein.
destinationNotWorking

object (DestinationNotWorking)

Gibt an, wenn das Ziel einen HTTP-Fehlercode zurückgibt oder nicht an allen Standorten für häufig verwendete Geräte funktioniert.

WebsiteList

Eine Liste von Websites, die zu einem Richtlinienergebnis geführt haben. Wird beispielsweise für das Richtlinienthema ONE_WEBSITE_PER_AD_GROUP verwendet. Falls mehr als fünf Websites vorhanden sind, werden hier nur die fünf wichtigsten Websites aufgeführt, also diejenigen, die am häufigsten in den Ressourcen aufgeführt werden.

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

string

Websites, die zu einem Richtlinienergebnis geführt haben.

TextList

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

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

string

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

DestinationTextList

Eine Liste von Strings, die auf einer Zielseite gefunden wurden, die zu einem Richtlinienergebnis geführt haben.

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

string

Liste des auf der Landingpage der Ressource gefundenen Textes.

DestinationMismatch

Nachweis von Abweichungen zwischen den URLs einer Ressource.

JSON-Darstellung 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Felder
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

Die Gruppe der URLs, die nicht miteinander übereinstimmten.

PolicyTopicEvidenceDestinationMismatchUrlType

Die möglichen URL-Typen für das Nachweisziel des Richtlinienthemas.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
DISPLAY_URL Die angezeigte URL
FINAL_URL Die finale URL
FINAL_MOBILE_URL Die finale mobile URL.
TRACKING_URL Die Tracking-URL-Vorlage mit ersetzter Desktop-URL
MOBILE_TRACKING_URL Die Tracking-URL-Vorlage mit ersetzter mobiler URL

DestinationNotWorking

Nachweisdetails, wenn das Ziel einen HTTP-Fehlercode zurückgibt oder nicht an allen Standorten für häufig verwendete Geräte funktioniert.

JSON-Darstellung 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Felder
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

Der Gerätetyp, auf dem die URL nicht geladen werden konnte.
expandedUrl

string

Die vollständige URL, die nicht funktioniert hat.
lastCheckedDateTime

string

Der Zeitpunkt, zu dem die URL zuletzt geprüft wurde. Das Format ist „JJJJ-MM-TT HH:MM:SS“. Beispiele: „2018-03-05 09:15:00“ oder „2018-02-01 14:34:30“
Union-Feld reason. Gibt den Grund für das Richtlinienergebnis DESTINATION_NOT_WORKING an. Für reason ist nur einer der folgenden Werte zulässig:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Die Art des DNS-Fehlers.
httpErrorCode

string (int64 format)

Der HTTP-Fehlercode.

PolicyTopicEvidenceDestinationNotWorkingDevice

Das mögliche Richtlinienthema mit nicht funktionierenden Geräten.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
DESKTOP Die Landingpage funktioniert nicht auf Computern.
ANDROID Die Landingpage funktioniert nicht auf einem Android-Gerät.
IOS Die Landingpage funktioniert nicht auf einem iOS-Gerät.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Das mögliche Richtlinienthema weist auf nicht funktionierende DNS-Fehlertypen hin.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
HOSTNAME_NOT_FOUND Beim Abrufen der Landingpage wurde kein Hostname im DNS gefunden.
GOOGLE_CRAWLER_DNS_ISSUE Bei der Kommunikation mit dem DNS ist ein Problem mit dem internen Google-Crawler aufgetreten. Dieser Fehler bedeutet nicht, dass die Landingpage nicht funktioniert. Google crawlt die Landingpage neu.

PolicyTopicConstraint

Beschreibt die Auswirkung eines Richtlinienthemeneintrags auf die Bereitstellung.

JSON-Darstellung 
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
Felder
Union-Feld value. Spezifische Informationen zur Einschränkung. Für value ist nur einer der folgenden Werte zulässig:
countryConstraintList

object (CountryConstraintList)

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

object (ResellerConstraint)

Reseller-Einschränkung.
certificateMissingInCountryList

object (CountryConstraintList)

Das sind Länder, für die ein Zertifikat für die Auslieferung erforderlich ist.
certificateDomainMismatchInCountryList

object (CountryConstraintList)

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

CountryConstraintList

Eine Liste der Länder, in denen die Bereitstellung einer Ressource eingeschränkt ist.

JSON-Darstellung 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
Felder
countries[]

object (CountryConstraint)

Das sind die Länder, in denen die Anzeigenbereitstellung eingeschränkt ist.
totalTargetedCountries

integer

Gesamtzahl der Länder, auf die die Ressource ausgerichtet ist.

CountryConstraint

Gibt an, dass die Verfügbarkeit einer Ressource in einem bestimmten Land eingeschränkt ist.

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

string

Der Ressourcenname der geografischen Ausrichtungskonstante des Landes, in dem die Auslieferung eingeschränkt ist.

ResellerConstraint

Dieser Typ hat keine Felder.

Gibt an, dass ein Richtlinienthema eingeschränkt wurde, da die Website für Reseller-Zwecke abgelehnt wurde.

PolicyReviewStatus

Die möglichen Status der Richtlinienüberprüfung.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
REVIEW_IN_PROGRESS Wird derzeit überprüft.
REVIEWED Primäre Überprüfung abgeschlossen. Andere Überprüfungen werden möglicherweise fortgesetzt.
UNDER_APPEAL Die Ressource wurde noch einmal zur Genehmigung eingereicht oder gegen die Richtlinienentscheidung wurde Einspruch eingelegt.
ELIGIBLE_MAY_SERVE Die Ressource ist zulässig und wird möglicherweise bereitgestellt, wird aber noch einer weiteren Überprüfung unterzogen.

PolicyApprovalStatus

Die möglichen Richtlinienfreigabestatus. Sind mehrere Freigabestatus verfügbar, wird der schwerwiegendste verwendet. Die Wichtigkeitsstufen lauten DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED und APPROVED.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
DISAPPROVED Wird nicht ausgeliefert.
APPROVED_LIMITED Auslieferung mit Einschränkungen.
APPROVED Bereitstellung ohne Einschränkungen.
AREA_OF_INTEREST_ONLY Die Anzeigen werden nicht in Zielländern ausgeliefert, können aber für Nutzer ausgeliefert werden, die nach Informationen zu diesen Zielländern suchen.

ResponsiveSearchAdInfo

Responsive Suchanzeige

Der Text in responsiven Suchanzeigen wird ständig angepasst, damit Sie potenziellen Kunden relevante Botschaften präsentieren können. Wenn Sie eine solche Anzeige erstellen, können Sie mehrere Anzeigentitel und Textzeilen eingeben. In Google Ads werden dann im Lauf der Zeit automatisch verschiedene Kombinationen getestet und die leistungsstärksten unter ihnen ermittelt. Mit responsiven Suchanzeigen werden die Inhalte Ihrer Anzeigen so angepasst, dass sie bestmöglich auf die Suchbegriffe potenzieller Kunden abgestimmt sind. So lässt sich die Leistung Ihrer Kampagne eventuell verbessern.

Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/7684791.

JSON-Darstellung 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Felder
headlines[]

object (AdTextAsset)

Liste der Textassets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Titel aus dieser Liste ausgewählt.
descriptions[]

object (AdTextAsset)

Liste der Text-Assets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Beschreibungen aus dieser Liste ausgewählt.
path1

string

Der erste Teil des Textes, der an die URL in der Anzeige angehängt werden kann.
path2

string

Zweiter Teil des Textes, der an die URL in der Anzeige angehängt werden kann. Dieses Feld kann nur festgelegt werden, wenn auch path1 festgelegt ist.

LegacyResponsiveDisplayAdInfo

Eine alte responsive Displayanzeige. Anzeigen dieses Typs sind in der Google Ads-Benutzeroberfläche mit „Responsive Anzeigen“ gekennzeichnet.

JSON-Darstellung 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Felder
formatSetting

enum (DisplayAdFormatSetting)

Gibt an, in welchem Format die Anzeige bereitgestellt wird. Der Standardwert ist ALL_FORMATS.
shortHeadline

string

Die kurze Version des Titels der Anzeige.
longHeadline

string

Die lange Version des Titels der Anzeige.
description

string

Die Beschreibung der Anzeige.
businessName

string

Der Name des Unternehmens in der Anzeige.
allowFlexibleColor

boolean

Die Zustimmung des Werbetreibenden erlaubt, flexible Farben zuzulassen. Mit der Einstellung "true" kann die Anzeige bei Bedarf in einer anderen Farbe bereitgestellt werden. Mit der Einstellung "false" wird die Anzeige in den angegebenen Farben oder neutralen Farben bereitgestellt. Der Standardwert ist true. Muss „true“ sein, wenn mainColor und accentColor nicht festgelegt sind.
accentColor

string

Die Akzentfarbe der Anzeige im Hexadezimalformat, z. B. #ffffff für Weiß. Wenn entweder mainColor oder accentColor festgelegt ist, ist auch der andere erforderlich.
mainColor

string

Die Hauptfarbe der Anzeige im Hexadezimalformat, z. B. #ffffff für Weiß. Wenn entweder mainColor oder accentColor festgelegt ist, ist auch der andere erforderlich.
callToActionText

string

Der Call-to-Action-Text für die Anzeige.
logoImage

string

Der Ressourcenname der Mediendatei des in der Anzeige verwendeten Logobilds.
squareLogoImage

string

Der Ressourcenname der Mediendatei des in der Anzeige verwendeten quadratischen Logobilds.
marketingImage

string

Der Ressourcenname der Mediendatei des in der Anzeige verwendeten Marketingbilds.
squareMarketingImage

string

Der Ressourcenname der Mediendatei des in der Anzeige verwendeten quadratischen Marketingbilds.
pricePrefix

string

Präfix vor dem Preis. Beispiel: „so niedrig wie“.
promoText

string

Werbetext für dynamische Formate von responsiven Anzeigen. Beispiel: "kostenloser Versand innerhalb von zwei Tagen".

DisplayAdFormatSetting

Aufzählung der Einstellungen für das Displaynetzwerk-Anzeigenformat

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
ALL_FORMATS Text-, Bild- und native Formate
NON_NATIVE Text- und Bildformate
NATIVE Natives Format, z. B. das Rendering des Formats wird vom Publisher und nicht von Google gesteuert.

AppAdInfo

App-Anzeige

JSON-Darstellung 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
Felder
mandatoryAdText

object (AdTextAsset)

Obligatorischer Anzeigentext.
headlines[]

object (AdTextAsset)

Liste der Textassets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Titel aus dieser Liste ausgewählt.
descriptions[]

object (AdTextAsset)

Liste der Text-Assets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Beschreibungen aus dieser Liste ausgewählt.
images[]

object (AdImageAsset)

Liste der Bild-Assets, die zusammen mit der Anzeige eingeblendet werden können.
youtubeVideos[]

object (AdVideoAsset)

Liste der YouTube-Video-Assets, die zusammen mit der Anzeige angezeigt werden können.
html5MediaBundles[]

object (AdMediaBundleAsset)

Liste der Assets für Medienpakete, die mit der Anzeige verwendet werden können.

AdMediaBundleAsset

Ein Mediaset-Asset, das in einer Anzeige verwendet wird

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

string

Der Name der Asset-Ressource dieses Mediasets.

LegacyAppInstallAdInfo

Eine alte App-Installationsanzeige, die nur von einigen ausgewählten Kunden verwendet werden kann.

JSON-Darstellung 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Felder
appStore

enum (LegacyAppInstallAdAppStore)

Der App-Shop, in dem die App verfügbar ist.
appId

string

Die ID der mobilen App.
headline

string

Den Anzeigentitel der Anzeige.
description1

string

Die erste Textzeile der Anzeige.
description2

string

Die zweite Textzeile der Anzeige.

LegacyAppInstallAdAppStore

App-Shop-Typ in einer alten App-Installationsanzeige.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
APPLE_APP_STORE Apple iTunes
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows Store.
WINDOWS_PHONE_STORE Windows Phone Store.
CN_APP_STORE Die App wird in einem chinesischen App-Shop gehostet.

ResponsiveDisplayAdInfo

Eine responsive Displayanzeige.

JSON-Darstellung 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Felder
marketingImages[]

object (AdImageAsset)

In der Anzeige zu verwendende Marketingbilder. Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 600 x 314 und das Seitenverhältnis muss 1,91:1 (+- 1%) sein. Mindestens ein marketingImage ist erforderlich. In Kombination mit squareMarketingImages beträgt das Maximum 15.
squareMarketingImages[]

object (AdImageAsset)

Quadratische Marketingbilder, die in der Anzeige verwendet werden sollen. Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 300 x 300 und das Seitenverhältnis muss 1:1 (+- 1%) sein. Mindestens eine quadratische marketingImage ist erforderlich. In Kombination mit marketingImages beträgt das Maximum 15.
logoImages[]

object (AdImageAsset)

Logobilder, die in der Anzeige verwendet werden sollen. Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 512 x 128 und das Seitenverhältnis muss 4:1 (+- 1%) sein. In Kombination mit squareLogoImages beträgt das Maximum 5.
squareLogoImages[]

object (AdImageAsset)

Quadratische Logobilder, die in der Anzeige verwendet werden sollen. Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 128 x 128 und das Seitenverhältnis muss 1:1 (+- 1%) sein. In Kombination mit logoImages beträgt das Maximum 5.
headlines[]

object (AdTextAsset)

Kurzformat für die Anzeigetitel. Die maximale Länge beträgt 30 Zeichen. Es können mindestens ein und maximal fünf Titel angegeben werden.
longHeadline

object (AdTextAsset)

Erforderlicher langer Formattitel. Die maximale Länge beträgt 90 Zeichen.
descriptions[]

object (AdTextAsset)

Beschreibende Texte für die Anzeige. Die maximale Länge beträgt 90 Zeichen. Es können mindestens ein und maximal fünf Titel angegeben werden.
youtubeVideos[]

object (AdVideoAsset)

Optionale YouTube-Videos für die Anzeige. Es können maximal fünf Videos angegeben werden.
formatSetting

enum (DisplayAdFormatSetting)

Gibt an, in welchem Format die Anzeige bereitgestellt wird. Der Standardwert ist ALL_FORMATS.
controlSpec

object (ResponsiveDisplayAdControlSpec)

Spezifikation für verschiedene Creative-Steuerelemente.
businessName

string

Der Name des Werbetreibenden bzw. der Marke. Die maximale Anzeigebreite beträgt 25.
mainColor

string

Die Hauptfarbe der Anzeige im Hexadezimalformat, z. B. #ffffff für Weiß. Wenn entweder mainColor oder accentColor festgelegt ist, ist auch der andere erforderlich.
accentColor

string

Die Akzentfarbe der Anzeige im Hexadezimalformat, z. B. #ffffff für Weiß. Wenn entweder mainColor oder accentColor festgelegt ist, ist auch der andere erforderlich.
allowFlexibleColor

boolean

Die Zustimmung des Werbetreibenden erlaubt, flexible Farben zuzulassen. Mit der Einstellung "true" kann die Anzeige bei Bedarf in einer anderen Farbe bereitgestellt werden. Mit der Einstellung "false" wird die Anzeige in den angegebenen Farben oder neutralen Farben bereitgestellt. Der Standardwert ist true. Muss „true“ sein, wenn mainColor und accentColor nicht festgelegt sind.
callToActionText

string

Der Call-to-Action-Text für die Anzeige. Die maximale Anzeigebreite beträgt 30.
pricePrefix

string

Präfix vor dem Preis. Beispiel: „so niedrig wie“.
promoText

string

Werbetext für dynamische Formate von responsiven Anzeigen. Beispiel: "kostenloser Versand innerhalb von zwei Tagen".

ResponsiveDisplayAdControlSpec

Spezifikation für verschiedene Creative-Steuerelemente für eine responsive Displayanzeige.

JSON-Darstellung 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Felder
enableAssetEnhancements

boolean

Gibt an, ob der Werbetreibende die Funktion zur Asset-Optimierung aktiviert hat.
enableAutogenVideo

boolean

Gibt an, ob der Werbetreibende die automatische Videogenerierung aktiviert hat.

LocalAdInfo

Eine lokale Anzeige

JSON-Darstellung 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Felder
headlines[]

object (AdTextAsset)

Liste der Textassets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Titel aus dieser Liste ausgewählt. Geben Sie mindestens einen bis fünf Anzeigentitel an.
descriptions[]

object (AdTextAsset)

Liste der Text-Assets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Beschreibungen aus dieser Liste ausgewählt. Es müssen mindestens eine und höchstens fünf Textzeilen angegeben werden.
callToActions[]

object (AdTextAsset)

Liste der Text-Assets für Calls-to-Action. Wenn die Anzeige ausgeliefert wird, werden die Calls-to-Action aus dieser Liste ausgewählt. Geben Sie mindestens einen und höchstens fünf Calls-to-Action an.
marketingImages[]

object (AdImageAsset)

Liste der Marketingbild-Assets, die mit der Anzeige eingeblendet werden können. Die Bilder müssen 314 × 600 Pixel oder 320 × 320 Pixel groß sein. Geben Sie mindestens ein und höchstens 20 Bild-Assets an.
logoImages[]

object (AdImageAsset)

Liste der Logobild-Assets, die mit der Anzeige eingeblendet werden können. Die Bilder müssen 128 x 128 Pixel groß sein und dürfen nicht größer als 120 KB sein. Geben Sie mindestens ein und höchstens fünf Bild-Assets an.
videos[]

object (AdVideoAsset)

Liste der YouTube-Video-Assets, die zusammen mit der Anzeige angezeigt werden können. Geben Sie mindestens ein und höchstens 20 Video-Assets an.
path1

string

Der erste Teil des optionalen Textes, der an die URL in der Anzeige angehängt werden kann.
path2

string

Der zweite Teil des optionalen Textes, der an die URL in der Anzeige angehängt werden kann. Dieses Feld kann nur festgelegt werden, wenn auch path1 festgelegt ist.

DisplayUploadAdInfo

Ein allgemeiner Typ von Displayanzeige. Das genaue Anzeigenformat wird über das Feld displayUploadProductType bestimmt. Darüber wird festgelegt, welche Daten in der Anzeige enthalten sein müssen.

JSON-Darstellung 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Felder
displayUploadProductType

enum (DisplayUploadProductType)

Der Produkttyp dieser Anzeige. Weitere Informationen finden Sie in den Kommentaren zur Aufzählung.
Union-Feld media_asset. Die Asset-Daten, aus denen die Anzeige besteht. Für media_asset ist nur einer der folgenden Werte zulässig:
mediaBundle

object (AdMediaBundleAsset)

Ein Mediaset-Asset, das in der Anzeige verwendet wird Informationen zum Mediaset für HTML5_UPLOAD_AD finden Sie unter https://support.google.com/google-ads/answer/1722096. Mediasets, die zu dynamischen Produkttypen gehören, verwenden ein spezielles Format, das in Google Web Designer erstellt werden muss. Weitere Informationen finden Sie unter https://support.google.com/webdesigner/answer/7543898.

DisplayUploadProductType

Aufzählung für Display-Upload-Produkttypen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
HTML5_UPLOAD_AD HTML5-Upload-Anzeige. Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden.
DYNAMIC_HTML5_EDUCATION_AD Dynamische HTML5-Bildungsanzeige Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Sie können nur in Bildungskampagnen verwendet werden.
DYNAMIC_HTML5_FLIGHT_AD Dynamische HTML5-Flight-Anzeige Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Kann nur in einer Flight-Kampagne verwendet werden.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Dynamische HTML5-Hotel- und Mietanzeige Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Sie können nur in Hotelkampagnen verwendet werden.
DYNAMIC_HTML5_JOB_AD Dynamische HTML5-Jobanzeige. Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Sie können nur in einer Jobkampagne verwendet werden.
DYNAMIC_HTML5_LOCAL_AD Dynamische HTML5-Anzeige Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Sie können nur in einer lokalen Kampagne verwendet werden.
DYNAMIC_HTML5_REAL_ESTATE_AD Dynamische HTML5-Immobilienanzeige Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Sie können nur in einer Immobilienkampagne verwendet werden.
DYNAMIC_HTML5_CUSTOM_AD Dynamische HTML5-Anzeige. Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Sie können nur in einer benutzerdefinierten Kampagne verwendet werden.
DYNAMIC_HTML5_TRAVEL_AD Dynamische HTML5-Reiseanzeige Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Sie können nur in einer Reisekampagne verwendet werden.
DYNAMIC_HTML5_HOTEL_AD Dynamische HTML5-Hotelanzeige Für diesen Produkttyp muss das Feld „upload_media_bundle“ in „DisplayUploadAdInfo“ festgelegt werden. Sie können nur in Hotelkampagnen verwendet werden.

AppEngagementAdInfo

Bei App-Interaktionsanzeigen können Sie Text verfassen, der zu einer bestimmten Aktion in der App ermuntert, z. B. zum Einchecken, zu einem Kauf oder zum Buchen eines Flugs. Sie ermöglichen es Ihnen, Nutzer zu einem bestimmten Bereich Ihrer App weiterzuleiten, wo sie das Gesuchte einfacher und schneller finden.

JSON-Darstellung 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Felder
headlines[]

object (AdTextAsset)

Liste der Textassets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Titel aus dieser Liste ausgewählt.
descriptions[]

object (AdTextAsset)

Liste der Text-Assets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Beschreibungen aus dieser Liste ausgewählt.
images[]

object (AdImageAsset)

Liste der Bild-Assets, die zusammen mit der Anzeige eingeblendet werden können.
videos[]

object (AdVideoAsset)

Liste der Video-Assets, die mit der Anzeige eingeblendet werden können.

ShoppingComparisonListingAdInfo

Eine Shopping-Vergleichsanzeige.

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

string

Der Anzeigentitel der Anzeige Dies ist ein Pflichtfeld. Die zulässige Länge liegt zwischen 25 und 45 Zeichen.

SmartCampaignAdInfo

Eine smarte Kampagne

JSON-Darstellung 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
Felder
headlines[]

object (AdTextAsset)

Liste der Text-Assets. Jedes dieser Assets entspricht einem Anzeigentitel bei der Auslieferung der Anzeige. Die Liste muss mindestens 3 und maximal 15 Text-Assets enthalten.
descriptions[]

object (AdTextAsset)

Liste der Text-Assets. Jedes dieser Assets entspricht einer Beschreibung bei der Auslieferung der Anzeige. Die Liste muss mindestens 2 und maximal 4 Text-Assets enthalten.

AppPreRegistrationAdInfo

App-Anzeigen zur Vorregistrierung sind mit Ihrer App oder Ihrem Spieleintrag bei Google Play verknüpft und können bei Google Play, auf YouTube (nur In-Stream) sowie in anderen Apps und auf mobilen Websites im Displaynetzwerk ausgeliefert werden. So können Sie das Interesse der Nutzer an Ihrer App oder Ihrem Spiel wecken und sie schon vor der Veröffentlichung frühzeitig installieren.

JSON-Darstellung 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Felder
headlines[]

object (AdTextAsset)

Liste der Textassets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Titel aus dieser Liste ausgewählt.
descriptions[]

object (AdTextAsset)

Liste der Text-Assets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Beschreibungen aus dieser Liste ausgewählt.
images[]

object (AdImageAsset)

Liste der Bild-Asset-IDs, deren Bilder mit der Anzeige eingeblendet werden können.
youtubeVideos[]

object (AdVideoAsset)

Liste der YouTube-Video-Asset-IDs, deren Videos mit der Anzeige eingeblendet werden können.

DiscoveryMultiAssetAdInfo

Eine Discovery-Anzeige mit mehreren Assets.

JSON-Darstellung 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Felder
marketingImages[]

object (AdImageAsset)

Marketingbild-Assets, die in der Anzeige verwendet werden sollen Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 600 x 314 und das Seitenverhältnis muss 1,91:1 (+- 1%) sein. Erforderlich, wenn „squareMarketingImages“ nicht vorhanden ist. In Kombination mit squareMarketingImages und portraitMarketingImages beträgt das Maximum 20.
squareMarketingImages[]

object (AdImageAsset)

Quadratische Marketingbild-Assets, die in der Anzeige verwendet werden Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 300 x 300 und das Seitenverhältnis muss 1:1 (+- 1%) sein. Erforderlich, wenn marketingImages nicht vorhanden ist. In Kombination mit marketingImages und portraitMarketingImages beträgt das Maximum 20.
portraitMarketingImages[]

object (AdImageAsset)

Marketingbild-Assets im Hochformat, die in der Anzeige verwendet werden. Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 480 x 600 und das Seitenverhältnis muss 4:5 (+-1%) betragen. In Kombination mit marketingImages und squareMarketingImages beträgt das Maximum 20.
logoImages[]

object (AdImageAsset)

Logobild-Assets, die in der Anzeige verwendet werden sollen Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 128 x 128 und das Seitenverhältnis muss 1:1 (+- 1%) sein. Sie können mindestens ein und maximal fünf Logobilder angeben.
headlines[]

object (AdTextAsset)

Text-Asset des Anzeigentitels der Anzeige Die maximale Anzeigebreite beträgt 30. Es können mindestens ein und maximal fünf Titel angegeben werden.
descriptions[]

object (AdTextAsset)

Der beschreibende Text der Anzeige. Die maximale Displaybreite beträgt 90. Sie können mindestens eine und maximal fünf Textzeilen angeben.
businessName

string

Der Name des Werbetreibenden oder der Marke. Die maximale Anzeigebreite beträgt 25. Erforderlich.
callToActionText

string

Call-to-Action-Text.
leadFormOnly

boolean

Boolesche Option, die angibt, ob diese Anzeige mit einem Lead-Formular ausgeliefert werden muss.

DiscoveryCarouselAdInfo

Eine Discovery-Karussell-Anzeige

JSON-Darstellung 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
Felder
businessName

string

Erforderlich. Der Name des Werbetreibenden oder der Marke.
logoImage

object (AdImageAsset)

Erforderlich. Logobild, das in der Anzeige verwendet werden soll Die Mindestgröße beträgt 128 x 128 und das Seitenverhältnis muss 1:1 (+- 1%) sein.
headline

object (AdTextAsset)

Erforderlich. Der Anzeigentitel der Anzeige
description

object (AdTextAsset)

Erforderlich. Der beschreibende Text der Anzeige.
callToActionText

string

Call-to-Action-Text.
carouselCards[]

object (AdDiscoveryCarouselCardAsset)

Erforderlich. Karussellkarten, die mit der Anzeige eingeblendet werden. Min. 2, max. 10.

AdDiscoveryCarouselCardAsset

Ein Asset für eine Discovery-Karussell-Karte, das in einer Anzeige verwendet wird

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

string

Der Name der Asset-Ressource dieser Discovery-Karussell-Karte.

DiscoveryVideoResponsiveAdInfo

Responsive Discovery-Videoanzeige

JSON-Darstellung 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Felder
headlines[]

object (AdTextAsset)

Liste der Text-Assets, die für den kurzen Anzeigentitel verwendet werden.
longHeadlines[]

object (AdTextAsset)

Liste der Text-Assets, die für den langen Anzeigentitel verwendet werden.
descriptions[]

object (AdTextAsset)

Liste der für die Beschreibung verwendeten Text-Assets.
videos[]

object (AdVideoAsset)

Liste der YouTube-Video-Assets, die für die Anzeige verwendet werden
logoImages[]

object (AdImageAsset)

Logobild, das in der Anzeige verwendet werden soll Gültige Bildtypen sind GIF, JPEG und PNG. Die Mindestgröße beträgt 128 x 128 und das Seitenverhältnis muss 1:1 (+- 1%) sein.
breadcrumb1

string

Der erste Teil des Textes, der in der Anzeige mit der angezeigten URL zu sehen ist.
breadcrumb2

string

Der zweite Teil des Textes, der in der Anzeige mit der angezeigten URL erscheint.
businessName

object (AdTextAsset)

Erforderlich. Der Name des Werbetreibenden bzw. der Marke.
callToActions[]

object (AdCallToActionAsset)

Assets vom Typ „CallToActionAsset“, die für die Schaltfläche „Call-to-Action“ verwendet werden.

AdCallToActionAsset

Ein Call-to-Action-Asset, das in einer Anzeige verwendet wird

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

string

Der Name der Asset-Ressource dieses Call-to-Action-Assets.

TravelAdInfo

Dieser Typ hat keine Felder.

Eine Reiseanzeige

Methoden

get

 Gibt die angeforderte Anzeige mit allen Details zurück.

mutate

 Aktualisiert Anzeigen.