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 nicht überlappender 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 Keyword, auf das die Anzeige ausgerichtet ist
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, zu dem dieses Feedelement wirksam ist und mit der Auslieferung beginnen kann. Die Zeit 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

Endzeit, in der dieses Feedelement nicht mehr wirksam ist und nicht mehr ausgeliefert wird. Die Zeit 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 das Targeting erfolgt.
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 ausgewählte Kampagne.
targetedAdGroup

string

Die Zielanzeigengruppe.

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 der möglichen finalen URLs nach allen domainübergreifenden Weiterleitungen. Diese Liste darf nicht leer sein.
finalMobileUrls[]

string

Eine Liste der möglichen finalen mobilen URLs nach allen domainübergreifenden Weiterleitungen.
urlCustomParameters[]

object (CustomParameter)

Eine Liste mit Zuordnungen, die verwendet werden können, um benutzerdefinierte URL-Parameter-Tags in „trackingUrlTemplate“, „finalUrls“ und/oder „finalMobileUrls“ zu ersetzen.
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 (jeweils 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 den in dieser Version unbekannten Wert 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

Der zweistellige Ländercode 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

Die SMS-Erweiterungstext, der in der SMS/MMS-App ausgefüllt wird.

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)

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)

Preis dieses Angebots.
unit

enum (PriceExtensionPriceUnit)

Preiseinheit für dieses Angebot.
finalUrls[]

string

Eine Liste der möglichen finalen URLs nach allen domainübergreifenden Weiterleitungen.
finalMobileUrls[]

string

Eine Liste der möglichen finalen mobilen URLs nach allen domainübergreifenden Weiterleitungen.
header

string

Überschrift dieses Angebots.
description

string

Beschreibung dieses Angebots.

PromotionFeedItem

Eine Angebotserweiterung.

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 Qualifizierung des Rabatts ändert.
occasion

enum (PromotionExtensionOccasion)

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

string

Eine Liste der möglichen finalen URLs nach allen domainübergreifenden Weiterleitungen. Dies ist ein Pflichtfeld.
finalMobileUrls[]

string

Eine Liste der möglichen finalen mobilen URLs nach allen domainübergreifenden Weiterleitungen.
urlCustomParameters[]

object (CustomParameter)

Eine Liste mit Zuordnungen, die verwendet werden können, um benutzerdefinierte URL-Parameter-Tags in „trackingUrlTemplate“, „finalUrls“ und/oder „finalMobileUrls“ zu ersetzen.
promotionTarget

string

Eine Beschreibung im freien Format, auf die das Angebot ausgerichtet ist. Dies ist ein Pflichtfeld.
promotionStartDate

string

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

string

Das letzte 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 des Angebots. Wird als BCP 47-Sprach-Tag dargestellt.
Union-Feld discount_type. Rabatttyp, kann Rabatt in Prozent oder Betrag sein. Für discount_type ist nur einer der folgenden Werte zulässig:
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 Rabatt im Angebot. Entweder this oderpercentOff ist erforderlich.
Union-Feld promotion_trigger. Trigger für bevorzugte Suchergebnisse. Kann durch einen Gutscheincode oder durch eine Werbeaktion nach dem zulässigen Bestellbetrag angegeben werden. Für promotion_trigger ist nur einer der folgenden Werte zulässig:
promotionCode

string

Ein Code, den der Nutzer verwenden muss, um für das Angebot infrage zu kommen.
ordersOverAmount

object (Money)

Der Gesamtbetrag der Bestellung, der erforderlich sein muss, damit der Nutzer für das Angebot infrage kommt.

LocationFeedItem

Stellt eine Standorterweiterung dar

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

Die 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

Die 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

Erweiterung mit Zusatzinformationen für Hotels

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

string

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 der Erweiterung 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.