REST Resource: advertisers.adGroupAds

Ressource: AdGroupAd

Eine einzelne Anzeige, die mit einer Anzeigengruppe verknüpft ist.

JSON-Darstellung 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "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.
entityStatus

enum (EntityStatus)

Der Entitätsstatus der Anzeige.
adUrls[]

object (AdUrl)

Liste der URLs, die in der Anzeige verwendet werden.
Union-Feld ad_details. Die Details der Anzeige. Für ad_details ist nur einer der folgenden Werte zulässig:
displayVideoSourceAd

object (DisplayVideoSourceAd)

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

object (MastheadAd)

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

object (InStreamAd)

Details zu einer nach 5 Sekunden überspringbaren In-Stream-Anzeige, die für die Markenbekanntheit oder die Erreichung von Marketingzielen verwendet wird.
nonSkippableAd

object (NonSkippableAd)

Details zu einer nicht überspringbaren kurzen In-Stream-Videoanzeige zwischen 6 und 15 Sekunden, die für Marketingziele vom Typ „Reichweite“ verwendet wird.
bumperAd

object (BumperAd)

Details zu einer nicht überspringbaren kurzen Videoanzeige, die maximal 6 Sekunden lang ist und für die Reichweite verwendet wird.
audioAd

object (AudioAd)

Details zu einer Audioanzeige, die für Marketingziele im Hinblick auf die Reichweite verwendet wird.
videoDiscoverAd

object (VideoDiscoveryAd)

Details zu einer Anzeige, die für ein Video wirbt und an Discovery-Standorten ausgeliefert wird.
videoPerformanceAd

object (VideoPerformanceAd)

Details zu einer Anzeige in einer Video-Aktionskampagne, mit der mehr Interaktionen mit dem Unternehmen, dem Dienst oder dem Produkt erzielt werden sollen.

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 in der Anzeige verwendete YouTube-Video.
headline

string

Der Titel der Anzeige.
description

string

Die Beschreibung der Anzeige.
videoAspectRatio

enum (VideoAspectRatio)

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

string (int64 format)

Die Zeit in Millisekunden, nach der die Wiedergabe des Videos beginnt.
autoplayVideoDuration

string (Duration format)

Die Dauer, für die das Video automatisch wiedergegeben 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 Hintergrund oder Banner oben auf einer YouTube-Seite angezeigt werden soll.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

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, die 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 wird 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 wird gestreckt und oben und unten zugeschnitten.
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)

Gängige Anzeigenattribute
customParameters

map (key: string, value: string)

Benutzerdefinierte Parameter, mit denen benutzerdefinierte Werte an die Tracking-URL-Vorlage übergeben werden.

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

CommonInStreamAttribute

Gemeinsame 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 im Hintergrund zu Tracking-Zwecken 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 erscheint.

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)

Gängige Anzeigenattribute
customParameters

map (key: string, value: string)

Benutzerdefinierte Parameter, mit denen benutzerdefinierte Werte an die Tracking-URL-Vorlage übergeben werden.

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)

Gängige 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 im Hintergrund zu Tracking-Zwecken 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 Anzeigentitel.
description1

string

Erste Textzeile der Anzeige.
description2

string

Zweite Textzeile der Anzeige.
video

object (YoutubeVideoDetails)

Das YouTube-Video, für das die Anzeige wirbt.
thumbnail

enum (Thumbnail)

In der Anzeige verwendetes Thumbnail-Bild.

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, aus dem Video generiert
THUMBNAIL_2 Miniaturansicht 2, aus dem Video generiert
THUMBNAIL_3 Miniaturansicht 3, aus dem Video generiert

VideoPerformanceAd

Details zu einer Videokampagne vom Typ „Leistung“

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 im Hintergrund zu Tracking-Zwecken geladen wird.
actionButtonLabels[]

string

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

string

Die Liste der Anzeigentitel, die auf dem 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)

Benutzerdefinierte Parameter, mit denen benutzerdefinierte Werte an die Tracking-URL-Vorlage übergeben werden.

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 in 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 Typen von Anzeigen-URLs

Enums
AD_URL_TYPE_UNSPECIFIED Unbekannt oder nicht angegeben.
AD_URL_TYPE_BEACON_IMPRESSION Ein 1:1-Tracking-Pixel, das gepingt wird, wenn eine Impression eines Creatives ausgeliefert wird.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Erweiterbares DCM-Impressions-Beacon. Zum Zeitpunkt der Auslieferung wird sie auf mehrere Beacons erweitert.
AD_URL_TYPE_BEACON_CLICK Tracking-URL, die gepingt werden soll, wenn das Klickereignis ausgelöst wird.
AD_URL_TYPE_BEACON_SKIP Tracking-URL, die gepingt werden soll, wenn das Ereignis „Überspringen“ ausgelöst wird.

Methoden

get

 Ruft eine Anzeigengruppe ab.

list

 Hier werden Anzeigengruppenanzeigen aufgeführt.