REST Resource: advertisers.adGroupAds

Ressource: AdGroupAd

Eine einzelne Anzeige, die einer Anzeigengruppe zugeordnet ist.

JSON-Darstellung 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
Felder
name

string

Der Ressourcenname der Anzeige.
advertiserId

string (int64 format)

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

string (int64 format)

Die eindeutige ID der Anzeige. Vom System zugewiesen.
adGroupId

string (int64 format)

Die eindeutige ID der Anzeigengruppe, zu der die Anzeige gehört.
displayName

string

Der Anzeigename der Anzeige.

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

object (AdPolicy)

Der Richtlinien-Freigabestatus der Anzeige.
entityStatus

enum (EntityStatus)

Der Status der Anzeige.
adUrls[]

object (AdUrl)

Liste der von der Anzeige verwendeten URLs.

Union-Feld ad_details. Die Details der Anzeige.

Für ad_details ist nur einer der folgenden Werte zulässig:
displayVideoSourceAd

object (DisplayVideoSourceAd)

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

object (MastheadAd)

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

object (InStreamAd)

Details zu einer In-Stream-Anzeige, die nach 5 Sekunden übersprungen werden kann und mit der Marketingziele in Bezug auf Markenbekanntheit oder Reichweite erreicht werden sollen.
nonSkippableAd

object (NonSkippableAd)

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

object (BumperAd)

Details zu einer nicht überspringbaren kurzen Videoanzeige mit einer Länge von höchstens 6 Sekunden, die für die Reichweite verwendet wird.
audioAd

object (AudioAd)

Details zu einer Audioanzeige, die zur Erreichung von Reichweiten-Marketingzielen verwendet wird.
videoDiscoverAd

object (VideoDiscoveryAd)

Details zu einer Anzeige, in der ein Video beworben wird, die an Orten für die Suche und Entdeckung ausgeliefert wird.
videoPerformanceAd

object (VideoPerformanceAd)

Details zu einer Anzeige in einer Video-Aktionskampagne, mit der Interaktionen für das Unternehmen, die Dienstleistung oder das Produkt erzielt werden sollen.

AdPolicy

Eine einzelne Anzeigenrichtlinie, die einer Anzeigengruppenanzeige zugeordnet ist.

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

enum (AdPolicyApprovalStatus)

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

enum (AdPolicyReviewStatus)

Der Status der Richtlinienüberprüfung einer Anzeige, der angibt, in welcher Phase der Überprüfung sich die Anzeige gerade befindet.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Die Einträge für jedes Richtlinienthema, das sich auf die Anzeige bezieht. Jeder Eintrag enthält das Thema, die Einschränkungsstufe und Anleitungen zum Beheben von Richtlinienverstößen.

AdPolicyApprovalStatus

Mögliche Status einer Freigabe gemäß Richtlinie.

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

AdPolicyReviewStatus

Mögliche Status einer Überprüfung von Anzeigenrichtlinien.

Enums
AD_POLICY_REVIEW_STATUS_UNKNOWN Unbekannt oder nicht angegeben.
REVIEW_IN_PROGRESS Wird derzeit überprüft.
REVIEWED Die primäre Überprüfung ist abgeschlossen. Andere Überprüfungen laufen möglicherweise noch.
UNDER_APPEAL Das Creative wurde noch einmal zur Genehmigung 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 (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Felder
policyTopic

string

Das Richtlinienthema.

Beispiele sind „TRADEMARKS“ (MARKEN) und „ALCOHOL“ (ALKOHOL).
policyLabel

string

Lokalisierter Labeltext für die Richtlinie.

Beispiele sind „Marken im Text“ und „Enthält Alkohol“.
policyTopicDescription

string

Eine kurze Zusammenfassung des Richtlinienthemas.
policyTopicType

enum (AdPolicyTopicEntryType)

Wie sich die Anzeigenbereitstellung aufgrund der Beziehung zum Thema der Werberichtlinie auswirkt.
policyDecisionType

enum (AdPolicyDecisionType)

Die Quelle der Richtlinienentscheidung.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Die bei der Richtlinienüberprüfung verwendeten Maßnahmen zur Richtliniendurchsetzung.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Die in der Richtlinienentscheidung verwendeten Beweise.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Die für die Richtlinienentscheidung relevanten Auslieferungseinschränkungen.
appealInfo

object (AdPolicyTopicAppealInfo)

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

AdPolicyTopicEntryType

Mögliche Auswirkungen eines 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 ausgeliefert 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 value can be only one of the following:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of list of possible types for union field value.
}
Felder
Union-Feld value. Die Beweise für die Richtlinienentscheidung. Für value ist nur einer der folgenden Werte zulässig:
textList

object (TextList)

Liste der Beweise, die im Anzeigentext gefunden wurden.
websiteList

object (WebsiteList)

Liste der Websites, die mit der Anzeige verknüpft sind.
httpCode

integer

HTTP-Code, der zurückgegeben wurde, als die endgültige URL gecrawlt wurde.
languageCode

string

Die Sprache, in der die Anzeige verfasst wurde.

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

object (DestinationTextList)

Der Text im Ziel der Anzeige, der einen Richtlinienverstoß verursacht.
destinationMismatch

object (DestinationMismatch)

Eine fehlende Übereinstimmung zwischen den Ziel-URLs für Anzeigen.
destinationNotWorking

object (DestinationNotWorking)

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

object (Trademark)

Markenbegriffe, die einen Richtlinienverstoß verursacht haben.
legalRemoval

object (LegalRemoval)

Durchsetzung einer rechtlichen Bestimmung, die zu einem Richtlinienverstoß geführt hat.
counterfeit

object (Counterfeit)

Durchsetzung der Richtlinie zu Produktfälschungen, die zu einem Richtlinienverstoß geführt hat.
regionalRequirements

object (RegionalRequirements)

Die proaktive Durchsetzung von T&S hat einen Richtlinienverstoß verursacht.

TextList

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

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

string

Die Textfragmente aus der Ressource, die zum Richtlinienverstoß geführt haben.

WebsiteList

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

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

string

Websites, die zum Richtlinienverstoß geführt haben.

DestinationTextList

Eine Liste mit Zieltext, der gegen die Richtlinie verstoßen hat.

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

string

Zieltext, der das Richtlinienergebnis verursacht hat.

DestinationMismatch

Details zu einer Abweichung zwischen Ziel-URL-Typen.

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

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

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

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

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

AdPolicyTopicEvidenceDestinationMismatchUrlType

Mögliche URL-Typen

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

DestinationNotWorking

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

JSON-Darstellung 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

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

string

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

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Das Gerät, auf dem beim Aufrufen der URL der Fehler aufgetreten ist.
lastCheckedTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
Union-Feld reason. Der HTTP- oder DNS-Fehler. Für reason ist nur einer der folgenden Werte zulässig:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Der Typ des DNS-Fehlers.
httpErrorCode

string (int64 format)

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 (AdPolicyCriterionRestriction)
    }
  ]
}
Felder
owner

string

Der Inhaber der Markeninhalte.
term

string

Der Markenbegriff.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

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

AdPolicyCriterionRestriction

Stellt eine Ländereinschränkung dar.

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

string (int64 format)

Die Kriteriums-ID für das Land.
countryLabel

string

Lokalisierter Name des Landes. Kann leer sein.

LegalRemoval

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

JSON-Darstellung 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
Felder
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Die Art der Beschwerde, die zur rechtlichen Entfernung geführt hat.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Die Länder, in denen die Inhalte aufgrund der rechtlichen Entfernung eingeschränkt sind.
restrictedUris[]

string

Die URLs, die aufgrund der rechtlichen Entfernung eingeschränkt wurden.
Union-Feld type. Details zum Typ der rechtlichen Entfernung. Für type ist nur einer der folgenden Werte zulässig:
dmca

object (Dmca)

Details zur rechtlichen Entfernung gemäß DMCA-Verordnung.

DMCA

Details zur DMCA-Beschwerde.

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

string

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

LocalLegal

Details zu lokalen rechtlichen Bestimmungen

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

string

Art des Gesetzes für den rechtlichen Hinweis.

AdPolicyTopicEvidenceLegalRemovalComplaintType

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

Enums
COPYRIGHT

Urheberrecht.

Gilt nur für den DMCA.
COURT_ORDER

Gerichtsbeschluss

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[]

string

Die Rechteinhaber von Inhalten oder Produkten, die eine Beschwerde eingereicht haben.

RegionalRequirements

Proaktive Durchsetzung von Richtlinien für Vertrauen und Sicherheit (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 behördliche Maßnahme betrachtet.

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

object (RegionalRequirementsEntry)

Liste der regionalen Anforderungen.

RegionalRequirementsEntry

Details zu regionalen Rechtsverstößen auf Richtlinienebene.

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

string

Die rechtliche Richtlinie, gegen die verstoßen wird.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Die Länder, in denen die rechtliche Richtlinie gilt.

AdPolicyTopicConstraint

Details zu Einschränkungen bei der Anzeigenbereitstellung.

JSON-Darstellung 
{
  "requestCertificateFormLink": string,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
Felder
Union-Feld constraint. Die Auslieferungseinschränkung. Für constraint ist nur einer der folgenden Werte zulässig:
countryConstraint

object (AdPolicyCountryConstraintList)

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

object (AdPolicyResellerConstraint)

Reseller-Einschränkung.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

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

object (AdPolicyCountryConstraintList)

Länder, in denen die Domain der Ressource nicht durch die zugehörigen Zertifikate abgedeckt ist.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Ein Zertifikat ist erforderlich, damit die Anzeige in einem beliebigen Land ausgeliefert werden kann.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

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 (AdPolicyCriterionRestriction)
    }
  ]
}
Felder
countries[]

object (AdPolicyCriterionRestriction)

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 Händlerzwecke 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 (AdPolicyAppealType),
  "appealFormLink": string
}
Felder
appealType

enum (AdPolicyAppealType)

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

AdPolicyAppealType

Mögliche Einspruchsarten

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

string (int64 format)

Die ID des Quell-Creatives.

MastheadAd

Details zu einer Masthead-Anzeige.

JSON-Darstellung 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Felder
video

object (YoutubeVideoDetails)

Das YouTube-Video, das in der Anzeige verwendet wird.
headline

string

Der Titel der Anzeige.
description

string

Die Beschreibung der Anzeige.
videoAspectRatio

enum (VideoAspectRatio)

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

string (int64 format)

Die Zeit in Millisekunden, nach der die Videowiedergabe beginnt.
autoplayVideoDuration

string (Duration format)

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

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

string

Der Text auf der Call-to-Action-Schaltfläche.
callToActionFinalUrl

string

Die Ziel-URL für die Call-to-Action-Schaltfläche
callToActionTrackingUrl

string

Die Tracking-URL für die Call-to-Action-Schaltfläche
showChannelArt

boolean

Ob ein Hintergrundbild oder Banner angezeigt werden soll, das oben auf einer YouTube-Seite zu sehen ist.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

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 (VideoUnavailableReason)
}
Felder
id

string

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

enum (VideoUnavailableReason)

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

VideoUnavailableReason

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

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

VideoAspectRatio

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

Enums
VIDEO_ASPECT_RATIO_UNSPECIFIED Nicht angegeben oder unbekannt.
VIDEO_ASPECT_RATIO_WIDESCREEN Das Video 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 (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Felder
commonInStreamAttribute

object (CommonInStreamAttribute)

Allgemeine Anzeigenattribute
customParameters

map (key: string, value: string)

Die benutzerdefinierten Parameter zum Übergeben benutzerdefinierter Werte an die Tracking-URL-Vorlage.

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

CommonInStreamAttribute

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

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

string

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

string

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

string

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

string

Der Text auf der Call-to-Action-Schaltfläche.
actionHeadline

string

Der Titel des Call-to-Action-Banners.
video

object (YoutubeVideoDetails)

Das YouTube-Video der Anzeige.
companionBanner

object (ImageAsset)

Das Bild, das neben der Videoanzeige zu sehen ist.

ImageAsset

Metadaten eines Bild-Assets.

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

string

MIME-Typ des Bild-Assets.
fullSize

object (Dimensions)

Metadaten für dieses Bild in Originalgröße.
fileSize

string (int64 format)

Dateigröße des Bild-Assets in Byte.

NonSkippableAd

Details zu einer nicht überspringbaren Anzeige.

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

object (CommonInStreamAttribute)

Allgemeine Anzeigenattribute
customParameters

map (key: string, value: string)

Die benutzerdefinierten Parameter zum Übergeben benutzerdefinierter Werte an die Tracking-URL-Vorlage.

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

BumperAd

Details zu einer Bumper-Anzeige

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

object (CommonInStreamAttribute)

Allgemeine Anzeigenattribute

AudioAd

Details zu einer Audioanzeige

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

string

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

string

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

string

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

object (YoutubeVideoDetails)

Das YouTube-Video der Anzeige.

VideoDiscoveryAd

Details zu einer Video Discovery-Anzeige

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

string

Der Titel der Anzeige.
description1

string

Die erste Textzeile der Anzeige.
description2

string

Die zweite Textzeile für die Anzeige.
video

object (YoutubeVideoDetails)

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

enum (Thumbnail)

Thumbnail, das in der Anzeige verwendet wird.

Thumbnail

Mögliche Thumbnail-Optionen bei 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 (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
Felder
finalUrl

string

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

string

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

string

Die Liste der Text-Assets, die auf der Call-to-Action-Schaltfläche angezeigt werden.
headlines[]

string

Die Liste der Titel, die im Call-to-Action-Banner angezeigt werden.
longHeadlines[]

string

Die Liste der einzelnen Anzeigentitel, die im Call-to-Action-Banner angezeigt werden.
descriptions[]

string

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

string

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

string

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

string

Die Domain der angezeigten URL.
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

Die benutzerdefinierten Parameter zum Übergeben benutzerdefinierter Werte an die Tracking-URL-Vorlage.

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

object (ImageAsset)

Die Liste der Companion-Banner, die von dieser Anzeige verwendet werden.

AdUrl

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

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

enum (AdUrlType)

Der Typ der Anzeigen-URL.
url

string

Der URL-Stringwert.

AdUrlType

Mögliche 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 auf mehrere Beacons erweitert.
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 „skip“ ausgelöst wird.

Methoden

get

 Ruft eine Anzeige in einer Anzeigengruppe ab.

list

 Listet Anzeigen der Anzeigengruppe auf.