ExtensionFeedItem

Ein Feedelement für die Erweiterung

JSON-Darstellung 
{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname des Feedelements der Erweiterung. Ressourcennamen von Erweiterungs-Feedelementen haben das folgende Format:

customers/{customerId}/extensionFeedItems/{feed_item_id}
extensionType

enum (ExtensionType)

Nur Ausgabe Der Erweiterungstyp des Feedelements der Erweiterung. Dieses Feld ist schreibgeschützt.
adSchedules[]

object (AdScheduleInfo)

Liste der sich nicht überschneidenden Zeitpläne, in denen alle Zeitintervalle angegeben sind, in denen das Feedelement ausgeliefert werden kann. Pro Tag sind maximal sechs Zeitpläne möglich.
device

enum (FeedItemTargetDevice)

Das Zielgerät.
targetedKeyword

object (KeywordInfo)

Das ausgewählte Keyword
status

enum (FeedItemStatus)

Nur Ausgabe Der Status des Feedelements. Dieses Feld ist schreibgeschützt.
id

string (int64 format)

Nur Ausgabe Die ID dieses Feedelements. Schreibgeschützt.
startDateTime

string

Beginn, in dem dieses Feedelement aktiv ist und ausgeliefert werden kann. Die Uhrzeit wird in der Zeitzone des Kunden angegeben. Das Format ist „JJJJ-MM-TT HH:MM:SS“. Beispiele: „2018-03-05 09:15:00“ oder „2018-02-01 14:34:30“
endDateTime

string

Ende, zu dem dieses Feedelement nicht mehr gültig ist und nicht mehr ausgeliefert wird. Die Uhrzeit wird in der Zeitzone des Kunden angegeben. Das Format ist „JJJJ-MM-TT HH:MM:SS“. Beispiele: „2018-03-05 09:15:00“ oder „2018-02-01 14:34:30“
targetedGeoTargetConstant

string

Die Konstante für die geografische Ausrichtung, auf die ausgerichtet wird.
Union-Feld extension. Erweiterungstyp. Für extension ist nur einer der folgenden Werte zulässig:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Snippet-Erweiterung.
appFeedItem

object (AppFeedItem)

App-Erweiterung.
callFeedItem

object (CallFeedItem)

Anruferweiterung.
calloutFeedItem

object (CalloutFeedItem)

Erweiterung mit Zusatzinformationen.
textMessageFeedItem

object (TextMessageFeedItem)

SMS-Erweiterung.
priceFeedItem

object (PriceFeedItem)

Preiserweiterung.
promotionFeedItem

object (PromotionFeedItem)

Angebotserweiterung aus.
locationFeedItem

object (LocationFeedItem)

Nur Ausgabe Standorterweiterung aus. Standorte werden von einem Unternehmensprofil mit einem Feed synchronisiert. Dieses Feld ist schreibgeschützt.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Nur Ausgabe Affiliate-Standorterweiterung. Feedstandorte werden anhand einer Ketten-ID von Google Ads gefüllt. Dieses Feld ist schreibgeschützt.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Erweiterung mit Zusatzinformationen für Hotels.
imageFeedItem

object (ImageFeedItem)

Nicht veränderbar. Vom Werbetreibenden bereitgestellte Bilderweiterung.
Union-Feld serving_resource_targeting. Ausrichtung auf Kampagnen- oder Anzeigengruppenebene Feedelemente, die auf eine Kampagne oder Anzeigengruppe ausgerichtet sind, werden nur mit dieser Ressource ausgeliefert. Für serving_resource_targeting ist nur einer der folgenden Werte zulässig:
targetedCampaign

string

Die angezielte Kampagne.
targetedAdGroup

string

Die Anzeigengruppe, auf die die Anzeigen ausgerichtet sind

StructuredSnippetFeedItem

Stellt eine Snippet-Erweiterung dar.

JSON-Darstellung 
{
  "values": [
    string
  ],
  "header": string
}
Felder
values[]

string

Die Werte im Snippet Die maximale Größe dieser Sammlung ist 10.
header

string

Der Header des Snippets. Dieser String darf nicht leer sein.

AppFeedItem

Stellt eine App-Erweiterung dar.

JSON-Darstellung 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
Felder
appStore

enum (AppStore)

Der App-Shop, zu dem die Zielanwendung gehört. Dies ist ein Pflichtfeld.
finalUrls[]

string

Eine Liste möglicher finaler URLs nach allen domainübergreifenden Weiterleitungen. Diese Liste darf nicht leer sein.
finalMobileUrls[]

string

Eine Liste möglicher finaler mobiler URLs nach allen domainübergreifenden Weiterleitungen.
urlCustomParameters[]

object (CustomParameter)

Eine Liste mit Zuordnungen, die zum Ersetzen von benutzerdefinierten URL-Parameter-Tags in „trackingUrlTemplate“, „finalUrls“ und/oder „finalMobileUrls“ verwendet werden.
linkText

string

Der sichtbare Text, der angezeigt wird, wenn der Link in einer Anzeige gerendert wird. Dieser String darf nicht leer sein und muss zwischen 1 und 25 Zeichen (einschließlich) liegen.
appId

string

Die geschäftsspezifische ID für die Zielanwendung. Dieser String darf nicht leer sein.
trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL. Der Standardwert ist „{lpurl}“.
finalUrlSuffix

string

URL-Vorlage zum Anhängen von Parametern an Landingpage-URLs, die mit parallelem Tracking bereitgestellt werden.

AppStore

App-Shop-Typ in einer App-Erweiterung

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
APPLE_ITUNES Apple iTunes
GOOGLE_PLAY Google Play.

TextMessageFeedItem

Eine Erweiterung, auf die Nutzer klicken können, um eine SMS an den Werbetreibenden zu senden.

JSON-Darstellung 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Felder
businessName

string

Der Name des Unternehmens, der dem Nachrichtentext vorangestellt werden soll. Dies ist ein Pflichtfeld.
countryCode

string

Ländercode aus zwei Buchstaben der Telefonnummer des Werbetreibenden in Großbuchstaben Dies ist ein Pflichtfeld.
phoneNumber

string

Telefonnummer des Werbetreibenden, an die die Nachricht gesendet wird Erforderlich.
text

string

Der Text, der in der Anzeige erscheint. Dies ist ein Pflichtfeld.
extensionText

string

Der in der SMS-App ausgefüllte SMS-Erweiterungstext

PriceFeedItem

Stellt eine Preiserweiterung dar.

JSON-Darstellung 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
Felder
type

enum (PriceExtensionType)

Der Preiserweiterungstyp dieser Erweiterung.
priceQualifier

enum (PriceExtensionPriceQualifier)

Preiskennzeichner für alle Angebote dieser Preiserweiterung.
priceOfferings[]

object (PriceOffer)

Die Angebote in dieser Preiserweiterung.
trackingUrlTemplate

string

Tracking-URL-Vorlage für alle Angebote dieser Preiserweiterung.
languageCode

string

Der Code der Sprache, die für diese Preiserweiterung verwendet wird.
finalUrlSuffix

string

Tracking-URL-Vorlage für alle Angebote dieser Preiserweiterung.

PriceOffer

Stellt ein Preisangebot in einer Preiserweiterung dar.

JSON-Darstellung 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
Felder
price

object (Money)

Preiswert dieses Angebots.
unit

enum (PriceExtensionPriceUnit)

Preiseinheit für dieses Angebot.
finalUrls[]

string

Eine Liste möglicher finaler URLs nach allen domainübergreifenden Weiterleitungen.
finalMobileUrls[]

string

Eine Liste möglicher finaler mobiler URLs nach allen domainübergreifenden Weiterleitungen.
header

string

Titeltext dieses Angebots.
description

string

Beschreibung dieses Angebots.

PromotionFeedItem

Stellt eine Angebotserweiterung dar.

JSON-Darstellung 
{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
Felder
discountModifier

enum (PromotionExtensionDiscountModifier)

Enum, das die Qualifikation des Rabatts ändert.
occasion

enum (PromotionExtensionOccasion)

Der Anlass, für den die Werbeaktion bestimmt war. Wenn ein Anlass festgelegt wurde, muss das Einlösungsfenster in den Zeitraum fallen, der dem Anlass zugeordnet ist.
finalUrls[]

string

Eine Liste möglicher finaler URLs nach allen domainübergreifenden Weiterleitungen. Dies ist ein Pflichtfeld.
finalMobileUrls[]

string

Eine Liste möglicher finaler mobiler URLs nach allen domainübergreifenden Weiterleitungen.
urlCustomParameters[]

object (CustomParameter)

Eine Liste mit Zuordnungen, die zum Ersetzen von benutzerdefinierten URL-Parameter-Tags in „trackingUrlTemplate“, „finalUrls“ und/oder „finalMobileUrls“ verwendet werden.
promotionTarget

string

Eine freie Beschreibung dessen, worauf das Angebot abzielt. Dies ist ein Pflichtfeld.
promotionStartDate

string

Das Startdatum, ab dem das Angebot eingelöst werden kann.
promotionEndDate

string

Letztes Datum, an dem das Angebot eingelöst werden kann.
trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.
finalUrlSuffix

string

URL-Vorlage zum Anhängen von Parametern an Landingpage-URLs, die mit parallelem Tracking bereitgestellt werden.
languageCode

string

Die Sprache der Werbeaktion. Wird als Sprach-Tag BCP 47 dargestellt.
Union-Feld discount_type. Rabatttyp, kann Rabatt in Prozent oder Betrag sein. discount_type kann nur einer der folgenden Werte sein:
percentOff

string (int64 format)

Prozentualer Rabatt des Angebots in Mikroeinheiten. Eine Million entspricht einem Prozent. Entweder dieser Wert oder „money_off_amount“ ist erforderlich.
moneyAmountOff

object (Money)

Rabattbetrag für den Rabatt im Angebot. Entweder das oder der Prozentsatz ist erforderlich.
Union-Feld promotion_trigger. Trigger für Werbeaktionen. Kann per Aktionscode oder Sonderfall auf Grundlage eines zulässigen Bestellbetrags erfolgen. Für promotion_trigger ist nur einer der folgenden Werte zulässig:
promotionCode

string

Ein Code, den der Nutzer verwenden muss, um das Angebot in Anspruch zu nehmen.
ordersOverAmount

object (Money)

Der Betrag, der insgesamt für die Bestellung des Nutzers erforderlich ist, damit das Angebot genutzt werden kann.

LocationFeedItem

Eine Standorterweiterung

JSON-Darstellung 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Felder
businessName

string

Der Name des Unternehmens
addressLine1

string

Zeile 1 der Geschäftsadresse
addressLine2

string

Zeile 2 der Geschäftsadresse
city

string

Ort der Geschäftsadresse
province

string

Provinz der Geschäftsadresse.
postalCode

string

Postleitzahl der Geschäftsadresse
countryCode

string

Ländercode der Geschäftsadresse
phoneNumber

string

Telefonnummer des Unternehmens

AffiliateLocationFeedItem

Stellt eine Affiliate-Standorterweiterung dar

JSON-Darstellung 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Felder
businessName

string

Der Name des Unternehmens
addressLine1

string

Zeile 1 der Geschäftsadresse
addressLine2

string

Zeile 2 der Geschäftsadresse
city

string

Ort der Geschäftsadresse
province

string

Provinz der Geschäftsadresse.
postalCode

string

Postleitzahl der Geschäftsadresse
countryCode

string

Ländercode der Geschäftsadresse
phoneNumber

string

Telefonnummer des Unternehmens
chainId

string (int64 format)

Die ID der Einzelhandelskette, die als Verkäufer Ihres Produkts beworben wird.
chainName

string

Name der Kette.

HotelCalloutFeedItem

Stellt eine Erweiterung mit Zusatzinformationen für Hotels dar

JSON-Darstellung 
{
  "text": string,
  "languageCode": string
}
Felder
text

string

Der Text der Erweiterung mit Zusatzinformationen. Die Länge der Zeichenfolge muss zwischen 1 und 25 Zeichen (einschließlich) liegen.
languageCode

string

Die Sprache des Textes mit Zusatzinformationen für Hotels. IETF-BCP-47-konformer Sprachcode

ImageFeedItem

Stellt eine vom Werbetreibenden bereitgestellte Bilderweiterung dar.

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

string

Erforderlich. Ressourcenname des Bild-Assets.