- Ressource: AdGroupAd
- AdPolicy
- AdPolicyApprovalStatus
- AdPolicyReviewStatus
- AdPolicyTopicEntry
- AdPolicyTopicEntryType
- AdPolicyDecisionType
- AdPolicyEnforcementMeans
- AdPolicyTopicEvidence
- TextList
- WebsiteList
- DestinationTextList
- DestinationMismatch
- AdPolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
- Marke
- AdPolicyCriterionRestriction
- LegalRemoval
- Dmca
- LocalLegal
- AdPolicyTopicEvidenceLegalRemovalComplaintType
- Fälschung
- RegionalRequirements
- RegionalRequirementsEntry
- AdPolicyTopicConstraint
- AdPolicyCountryConstraintList
- AdPolicyResellerConstraint
- AdPolicyGlobalCertificateMissingConstraint
- AdPolicyGlobalCertificateDomainMismatchConstraint
- AdPolicyTopicAppealInfo
- AdPolicyAppealType
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Thumbnail
- VideoPerformanceAd
- DemandGenVideoAd
- CallToAction
- DemandGenImageAd
- DemandGenCarouselAd
- CarouselCard
- DemandGenProductAd
- 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 von der Anzeige verwendeten URLs. |
dcmTrackingInfo |
Optional. Die Informationen zur Campaign Manager-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. |
Union-Feld ad_details. Die Details der Anzeige. Für ad_details ist nur einer der folgenden Werte zulässig: |
|
displayVideoSourceAd |
Nur Ausgabe. Details einer Anzeige, die aus einem Display & Video 360-Creative stammt. |
mastheadAd |
Nur Ausgabe. Details zu einer Anzeige im YouTube-Startseitenfeed |
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 für Reichweitenmarketingziele verwendet wird. |
bumperAd |
Nur Ausgabe. Details zu einer nicht überspringbaren kurzen Videoanzeige mit einer Länge von höchstens 6 Sekunden, die für die 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, in der ein Video beworben wird, die an Orten für die Suche und Entdeckung ausgeliefert wird. |
videoPerformanceAd |
Nur Ausgabe. Details zu einer Anzeige in einer Video-Aktionskampagne, mit der Interaktionen 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. |
AdPolicy
Eine einzelne Anzeigenrichtlinie, die einer Anzeigengruppenanzeige zugeordnet 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 Anleitungen zum Beheben von Richtlinienverstößen. |
AdPolicyApprovalStatus
Mögliche Status einer Richtlinienfreigabe für Anzeigen.
| Enums | |
|---|---|
AD_POLICY_APPROVAL_STATUS_UNKNOWN |
Unbekannt oder nicht angegeben. |
DISAPPROVED |
Wird nicht ausgeliefert. |
APPROVED_LIMITED |
Die Auslieferung erfolgt mit Einschränkungen. |
APPROVED |
Die Anzeige 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 |
Das Creative wurde noch einmal zur Freigabe eingereicht oder es wurde Einspruch gegen eine Richtlinienentscheidung eingelegt. |
ELIGIBLE_MAY_SERVE |
Die Anzeige gilt als zulässig und wird 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 sind „TRADEMARKS“ (MARKEN) und „ALCOHOL“ (ALKOHOL). |
policyLabel |
Lokalisierter Labeltext für die Richtlinie. Beispiele sind „Marken im Text“ und „Enthält Alkohol“. |
policyTopicDescription |
Eine kurze Zusammenfassung des Richtlinienthemas. |
policyTopicType |
Wie sich die Anzeigenbereitstellung aufgrund der Beziehung zum Thema der Werberichtlinie 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 Auslieferungseinschrä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 Richtlinienthemas 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 ausgeliefert werden und wird möglicherweise auch über die normale Abdeckung hinaus ausgeliefert. |
AREA_OF_INTEREST_ONLY |
Die Ressource ist für alle Zielländer eingeschränkt, kann aber für Nutzer 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 Entscheidung über die Richtlinie verwendet wurden.
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld value. Die Beweise für die Richtlinienentscheidung. Für value ist nur einer der folgenden Werte zulässig: |
|
textList |
Liste der Beweise, die im Anzeigentext gefunden wurden. |
websiteList |
Liste der Websites, die mit der Anzeige verknüpft sind. |
httpCode |
HTTP-Code, der zurückgegeben wurde, als die endgültige URL gecrawlt wurde. |
languageCode |
Die Sprache, in der die Anzeige verfasst wurde. In diesem Feld werden IETF-Sprach-Tags wie „en-US“ verwendet. |
destinationTextList |
Der Text im Ziel der Anzeige, der einen Richtlinienverstoß verursacht. |
destinationMismatch |
Die Ziel-URLs für Anzeigen stimmen nicht überein. |
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 der Richtlinie zu Produktfälschungen, die zu einem Richtlinienverstoß geführt hat. |
regionalRequirements |
Die proaktive Durchsetzung durch T&S hat einen Richtlinienverstoß verursacht. |
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 das Richtlinienergebnis verursacht haben. |
DestinationTextList
Eine Liste mit Zieltext, der gegen die Richtlinie verstoßen hat.
| JSON-Darstellung |
|---|
{ "destinationTexts": [ string ] } |
| Felder | |
|---|---|
destinationTexts[] |
Zieltext, der das Richtlinienergebnis verursacht hat. |
DestinationMismatch
Details zu Abweichungen zwischen Ziel-URL-Typen
| JSON-Darstellung |
|---|
{
"uriTypes": [
enum ( |
| Felder | |
|---|---|
uriTypes[] |
Die Gruppe der 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 |
Gibt an, wann der Fehler beim Aufrufen der URL das letzte Mal 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: |
Union-Feld reason. Der HTTP- oder DNS-Fehler. Für reason ist nur einer der folgenden Werte zulässig: |
|
dnsErrorType |
Der Typ des DNS-Fehlers. |
httpErrorCode |
Der HTTP-Fehlercode. |
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-Server 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 |
Desktopgerä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 Markeninhalte. |
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 des Landes. Kann leer sein. |
LegalRemoval
Durchsetzung rechtlicher Bestimmungen, entweder gemäß dem US-amerikanischen Urheberrechtsgesetz (Digital Millennium Copyright Act, DMCA) oder gemäß lokalen rechtlichen Bestimmungen.
| JSON-Darstellung |
|---|
{ "complaintType": enum ( |
| Felder | |
|---|---|
complaintType |
Die Art der Beschwerde, die zur rechtlichen Entfernung geführt hat. |
countryRestrictions[] |
Die Länder, in denen die Inhalte aufgrund der rechtlichen Entfernung eingeschränkt sind. |
restrictedUris[] |
Die URLs, die aufgrund der rechtlichen Entfernung eingeschränkt wurden. |
Union-Feld type. Details zum Typ der Entfernung aus rechtlichen Gründen. Für type ist nur einer der folgenden Werte zulässig: |
|
dmca |
Details zur rechtlichen Entfernung gemäß DMCA-Verordnung. |
localLegal |
Details zur lokalen rechtlichen Regelung zur Entfernung aus rechtlichen Gründen. |
DMCA
Details zur DMCA-Beschwerde.
| JSON-Darstellung |
|---|
{ "complainant": string } |
| Felder | |
|---|---|
complainant |
Die Rechtspersönlichkeit, die die rechtliche Beschwerde eingereicht hat. |
LocalLegal
Details zu lokalen rechtlichen Bestimmungen
| JSON-Darstellung |
|---|
{ "lawType": string } |
| Felder | |
|---|---|
lawType |
Art des 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 |
Gerichtsbeschluss Gilt nur für lokales Recht. |
LOCAL_LEGAL |
Lokale gesetzliche Bestimmungen. Gilt nur für lokales Recht. |
Fälschung
Details zur Durchsetzung der Richtlinie zu Produktfälschungen, die zu einem Richtlinienverstoß geführt hat.
| JSON-Darstellung |
|---|
{ "owners": [ string ] } |
| Felder | |
|---|---|
owners[] |
Die Inhaber von Inhalten oder Produkten, die eine Beschwerde eingereicht haben. |
RegionalRequirements
Proaktive Erzwingung von Richtlinien durch Trust & Safety (T&S), die auf regionale Anforderungen ausgerichtet sind. 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, in denen die rechtliche Richtlinie gilt. |
AdPolicyTopicConstraint
Details zu Einschränkungen bei der Anzeigenbereitstellung.
| JSON-Darstellung |
|---|
{ "requestCertificateFormLink": string, // Union field |
| Felder | |
|---|---|
requestCertificateFormLink |
Link zum Formular, über das ein Zertifikat für die Einschränkung angefordert werden kann. |
Union-Feld constraint. Die Auslieferungseinschränkung. Für constraint ist nur einer der folgenden Werte zulässig: |
|
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 Auslieferung 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 beliebigen Land ausgeliefert werden kann. |
globalCertificateDomainMismatch |
Für die Auslieferung in einem beliebigen Land ist ein Zertifikat erforderlich und das vorhandene Zertifikat deckt die Domain der Anzeige nicht ab. |
AdPolicyCountryConstraintList
Eine Liste der Länder, in denen die Anzeige aufgrund von Richtlinieneinschränkungen nicht ausgeliefert werden kann.
| JSON-Darstellung |
|---|
{
"countries": [
{
object ( |
| Felder | |
|---|---|
countries[] |
Länder, in denen die Anzeige nicht ausgeliefert werden kann |
AdPolicyResellerConstraint
Dieser Typ hat keine Felder.
Das Richtlinienthema wurde eingeschränkt, da die Website für Reseller-Zwecke abgelehnt wurde.
AdPolicyGlobalCertificateMissingConstraint
Dieser Typ hat keine Felder.
Ein Zertifikat ist erforderlich, damit die Anzeige in einem beliebigen Land ausgeliefert werden kann.
AdPolicyGlobalCertificateDomainMismatchConstraint
Dieser Typ hat keine Felder.
Für die Auslieferung in einem beliebigen Land ist ein Zertifikat erforderlich und das vorhandene Zertifikat deckt die Domain der Anzeige nicht ab.
AdPolicyTopicAppealInfo
Informationen dazu, wie Sie Einspruch gegen eine Richtlinienentscheidung einlegen können.
| JSON-Darstellung |
|---|
{
"appealType": enum ( |
| Felder | |
|---|---|
appealType |
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 Arten von Einsprüchen.
| Enums | |
|---|---|
AD_POLICY_APPEAL_TYPE_UNKNOWN |
Unbekannt oder nicht angegeben. |
SELF_SERVICE_APPEAL |
Gegen die Entscheidung kann über ein Selfservice-Einspruchsverfahren Einspruch eingelegt werden. |
APPEAL_FORM |
Gegen die Entscheidung kann mit einem Einspruchsformular Einspruch eingelegt werden. |
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 in der Anzeige verwendet wird. |
headline |
Den Anzeigentitel der Anzeige |
description |
Die Beschreibung der Anzeige. |
videoAspectRatio |
Das Seitenverhältnis des automatisch abgespielten 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 der Call-to-Action-Schaltfläche. |
callToActionFinalUrl |
Die Ziel-URL für die Call-to-Action-Schaltfläche |
callToActionTrackingUrl |
Die Tracking-URL für die Call-to-Action-Schaltfläche |
showChannelArt |
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 ist 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 |
Allgemeine 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 der Call-to-Action-Schaltfläche. |
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. 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 |
Allgemeine 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 |
Allgemeine 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 |
Der Titel der Anzeige. |
description1 |
Die erste Textzeile der Anzeige. |
description2 |
Die zweite Textzeile für die Anzeige. |
video |
Das YouTube-Video, für das in der Anzeige geworben wird. |
thumbnail |
Thumbnail, das in der Anzeige verwendet wird. |
Thumbnail
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 der Call-to-Action-Schaltfläche angezeigt werden. |
headlines[] |
Die Liste der Titel, 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[] |
Liste der YouTube-Video-Assets, die in 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. Die Call-to-Action-Schaltfläche, die 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. Liste der YouTube-Video-Assets, die in dieser Anzeige verwendet werden. |
customParameters |
Optional. Die benutzerdefinierten Parameter und die zugehörigen Werte, die der Tracking-URL hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
companionBanner |
Optional. Das Companion-Banner, das für diese Anzeige verwendet wird. |
logo |
Erforderlich. Das in dieser Anzeige verwendete Logobild. |
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 |
Erforderlich. Der Name des Unternehmens, der in der Anzeige zu sehen ist. |
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 besuchen. |
WATCH_NOW |
Jetzt ansehen. |
DemandGenImageAd
Details zu einer Demand Gen-Bildanzeige.
| JSON-Darstellung |
|---|
{ "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "callToAction": string, "headlines": [ string ], "descriptions": [ string ], "customParameters": { string: string, ... }, "finalMobileUrl": string, "finalUrlSuffix": string, "businessName": string, "marketingImages": [ { object ( |
| Felder | |
|---|---|
finalUrl |
Erforderlich. Die URL-Adresse der Webseite, auf die Nutzer gelangen, wenn sie auf die Anzeige klicken. |
trackingUrl |
Nur Ausgabe. Die URL-Adresse, die zu Tracking-Zwecken im Hintergrund geladen wird. |
userSpecifiedTrackingUrl |
Optional. Die vom Nutzer manuell angegebene Tracking-URL. |
callToAction |
Erforderlich. Die Call-to-Action-Schaltfläche, die 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 |
Erforderlich. Der Name des Unternehmens, der in der Anzeige zu sehen ist. |
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[] |
Liste der Marketingbilder im Hochformat, die in der Anzeige zu sehen sind. |
logoImages[] |
Liste der Logobilder, die in der Anzeige zu sehen sind. |
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 |
Erforderlich. Der Name des Unternehmens, der in der Anzeige zu sehen ist. |
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 |
Erforderlich. Das in dieser Anzeige verwendete Logobild. |
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. Die Überschrift 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. Die Call-to-Action-Schaltfläche, die 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 |
Erforderlich. Der Name des Unternehmens, der in der Anzeige zu sehen ist. |
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 |
Erforderlich. Das in dieser Anzeige verwendete Logobild. |
displayUrlBreadcrumb1 |
Optional. Der erste Teil nach der Domain in der angezeigten URL. |
displayUrlBreadcrumb2 |
Optional. Der zweite Teil nach der Domain in der angezeigten URL. |
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 |
Beacon für erweiterbare DCM-Impressionen. Bei der Auslieferung wird sie in mehrere Beacons aufgeteilt. |
AD_URL_TYPE_BEACON_CLICK |
Tracking-URL, die angepingt werden soll, wenn das Klickereignis 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 Campaign Manager-Tracking-Anzeige. |
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 der Anzeigengruppe auf. |
|
Aktualisiert eine Anzeige in einer Anzeigengruppe. |