REST Resource: advertisers.youtubeAdGroups

Ressource: YouTubeAnzeigengruppe

Eine einzelne YouTube-Anzeigengruppe, die mit einer „YouTube und Partner“-Werbebuchung verknüpft ist.

JSON-Darstellung 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Felder
name

string

Der Ressourcenname der Anzeigengruppe.
advertiserId

string (int64 format)

Die eindeutige ID des Werbetreibenden, zu dem die Anzeigengruppe gehört.
adGroupId

string (int64 format)

Die eindeutige ID der Anzeigengruppe. Vom System zugewiesen.
lineItemId

string (int64 format)

Eindeutige ID der Werbebuchung, zu der die Anzeigengruppe gehört
displayName

string

Der Anzeigename der Anzeigengruppe.

Muss UTF-8-codiert sein und darf maximal 255 Byte groß sein.
youtubeAdIds[]

string (int64 format)

Die IDs der [youtube_ad_group_ad][]-Ressourcen, die mit der Anzeigengruppe verknüpft sind.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

Das Format der Anzeigen in der Anzeigengruppe.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Die von der Anzeigengruppe verwendete Gebotsstrategie.
entityStatus

enum (EntityStatus)

Steuert, ob die Anzeigengruppe ihr Budget ausgeben und auf Inventar bieten kann.

Wenn die übergeordnete Werbebuchung der Anzeigengruppe nicht aktiv ist, kann das Budget der Anzeigengruppe auch dann nicht ausgegeben werden, wenn ihr eigener Status ENTITY_STATUS_ACTIVE ist.
targetingExpansion

object (TargetingExpansionConfig)

Die Einstellungen für die Ausweitung der Ausrichtung der Anzeigengruppe.

Diese Konfiguration ist nur anwendbar, wenn der Anzeigengruppe ein geeignetes Zielgruppenlisten-Targeting zugewiesen ist.
productFeedData

object (ProductFeedData)

Die Einstellungen des Produktfeeds in dieser Anzeigengruppe.

YoutubeAndPartnersAdGroupFormat

Das Format der YouTube-Anzeigengruppe.

Enums
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED Der Formatwert ist nicht angegeben oder in dieser Version unbekannt.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM In-Stream-Anzeigen
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY In-Feed-Anzeigen
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Bumper-Anzeigen
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Nicht überspringbare In-Stream-Anzeigen
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Nicht überspringbare In-Stream-Audioanzeigen
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Responsive Anzeigen für Video-Aktionskampagnen
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Anzeigengruppen mit effektiver Reichweite, einschließlich In-Stream- und Bumper-Anzeigen
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Masthead-Anzeige, die in der obersten Fläche der YouTube-Startseite eingeblendet wird

ProductFeedData

Die Details des Produktfeeds.

JSON-Darstellung 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Felder
productMatchType

enum (ProductMatchType)

Wie Produkte über den Produktfeed ausgewählt werden.
productMatchDimensions[]

object (ProductMatchDimension)

Eine Liste von Dimensionen für den Abgleich von Produkten.
isFeedDisabled

boolean

Gibt an, ob die Präsentation von Produkten im Produktfeed deaktiviert wurde.

ProductMatchType

Die Arten der Zuordnung von Produkten.

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED Nicht angegeben oder unbekannt.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Alle Produkte sind zugeordnet.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Es wurden bestimmte Produkte ausgewählt.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Produkte anhand ihrer benutzerdefinierten Labels abgleichen.

ProductMatchDimension

Eine Dimension, mit der Produkte abgeglichen werden.

JSON-Darstellung 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Felder
Union-Feld dimension. Die Dimension und der Wert, auf die das Produkt zutrifft. Für dimension ist nur einer der folgenden Werte zulässig:
productOfferId

string

Die ID des Produktangebots, die mit einem Produkt mit derselben Angebots-ID abgeglichen werden soll.
customLabel

object (CustomLabel)

Das benutzerdefinierte Label, das alle Produkte mit dem Label abgleichen soll.

CustomLabel

Schlüssel und Wert eines benutzerdefinierten Labels.

JSON-Darstellung 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Felder
key

enum (CustomLabelKey)

Schlüssel des Labels.
value

string

Der Wert des Labels.

CustomLabelKey

Schlüssel des benutzerdefinierten Labels

Enums
CUSTOM_LABEL_KEY_UNSPECIFIED Nicht angegeben oder unbekannt.
CUSTOM_LABEL_KEY_0 Schlüsselindex 0.
CUSTOM_LABEL_KEY_1 Schlüsselindex 1.
CUSTOM_LABEL_KEY_2 Schlüsselindex 2.
CUSTOM_LABEL_KEY_3 Schlüsselindex 3.
CUSTOM_LABEL_KEY_4 Schlüsselindex 4.

Methoden

bulkListAdGroupAssignedTargetingOptions

 Listet die zugewiesenen Targeting-Optionen für mehrere YouTube-Anzeigengruppen mit verschiedenen Ausrichtungstypen auf.

get

 Ruft eine YouTube-Anzeigengruppe ab.

list

 Listet YouTube-Anzeigengruppen auf