ExtensionFeedItem

Élément de flux d'extensions.

Représentation JSON 
{
  "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.
}
Champs
resourceName

string

Immuable. Nom de ressource de l'élément de flux de l'extension. Les noms de ressources des éléments de flux d'extensions ont le format suivant:

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

enum (ExtensionType)

Uniquement en sortie. Type d'extension de l'élément de flux d'extensions. Ce champ est en lecture seule.
adSchedules[]

object (AdScheduleInfo)

Liste des calendriers sans chevauchement spécifiant tous les intervalles de temps pendant lesquels l'élément de flux peut être diffusé. Le nombre de programmations est limité à six par jour.
device

enum (FeedItemTargetDevice)

Appareil ciblé.
targetedKeyword

object (KeywordInfo)

Mot clé ciblé
status

enum (FeedItemStatus)

Uniquement en sortie. État de l'élément de flux. Ce champ est en lecture seule.
id

string (int64 format)

Uniquement en sortie. Identifiant de cet élément de flux. Lecture seule.
startDateTime

string

Heure de début à laquelle cet élément de flux est effectif et peut commencer à être diffusé. L'heure est indiquée dans le fuseau horaire du client. Le format est "AAAA-MM-JJ HH:MM:SS". Exemples: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
endDateTime

string

Heure de fin à laquelle cet élément de flux n'est plus effectif et cessera d'être diffusé. L'heure est indiquée dans le fuseau horaire du client. Le format est "AAAA-MM-JJ HH:MM:SS". Exemples: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
targetedGeoTargetConstant

string

Constante de la cible géographique ciblée
Champ d'union extension. Type d'extension. extension ne peut être qu'un des éléments suivants :
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Extension d'extraits structurés.
appFeedItem

object (AppFeedItem)

Extension d'application.
callFeedItem

object (CallFeedItem)

Extension d'appel.
calloutFeedItem

object (CalloutFeedItem)

Extension d'accroche.
textMessageFeedItem

object (TextMessageFeedItem)

Extension SMS.
priceFeedItem

object (PriceFeedItem)

Extension de prix.
promotionFeedItem

object (PromotionFeedItem)

Extension de promotion.
locationFeedItem

object (LocationFeedItem)

Uniquement en sortie. Extension de lieu. Les établissements sont synchronisés dans un flux depuis une fiche d'établissement. Ce champ est en lecture seule.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Uniquement en sortie. Extension de lieu affilié. Les emplacements des flux sont renseignés par Google Ads en fonction d'un ID de chaîne. Ce champ est en lecture seule.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Extension d'accroche pour hôtel.
imageFeedItem

object (ImageFeedItem)

Immuable. Extension d'image fournie par l'annonceur.
Champ d'union serving_resource_targeting. Ciblage au niveau de la campagne ou du groupe d'annonces Les éléments de flux qui ciblent une campagne ou un groupe d'annonces ne seront diffusés qu'avec cette ressource. serving_resource_targeting ne peut être qu'un des éléments suivants :
targetedCampaign

string

La campagne ciblée.
targetedAdGroup

string

Le groupe d'annonces ciblé.

StructuredSnippetFeedItem

Représente une extension d'extraits structurés.

Représentation JSON 
{
  "values": [
    string
  ],
  "header": string
}
Champs
values[]

string

Valeurs de l'extrait. Cet ensemble ne peut contenir plus de 10 éléments.
header

string

En-tête de l'extrait. Cette chaîne ne doit pas être vide.

AppFeedItem

Représente une extension d'application.

Représentation JSON 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
Champs
appStore

enum (AppStore)

Plate-forme de téléchargement d'applications à laquelle appartient l'application cible. Ce champ est obligatoire.
finalUrls[]

string

Liste des URL finales possibles après toutes les redirections interdomaines. Cette liste ne doit pas être vide.
finalMobileUrls[]

string

Une liste des URL finales pour mobile possibles après toutes les redirections vers un autre domaine.
urlCustomParameters[]

object (CustomParameter)

Liste de mises en correspondance à utiliser pour remplacer les balises de paramètre personnalisé d'URL dans "trackingUrlTemplate", "finalUrls" et/ou "finalMobileUrls".
linkText

string

Texte visible qui s'affiche lorsque le lien s'affiche dans une annonce. Cette chaîne ne doit pas être vide, et sa longueur doit être comprise entre 1 et 25 inclus.
appId

string

ID spécifique au magasin pour l'application cible. Cette chaîne ne doit pas être vide.
trackingUrlTemplate

string

Modèle d'URL permettant de créer une URL de suivi. La valeur par défaut est "{lpurl}".
finalUrlSuffix

string

Modèle d'URL permettant d'ajouter des paramètres aux URL de page de destination diffusées avec le suivi en parallèle.

AppStore

Type de plate-forme de téléchargement d'applications dans une extension d'application.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
APPLE_ITUNES Apple iTunes.
GOOGLE_PLAY Google Play.

TextMessageFeedItem

Extension sur laquelle les utilisateurs peuvent cliquer pour envoyer un message à l'annonceur.

Représentation JSON 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Champs
businessName

string

Nom de l'entreprise à ajouter au texte du message. Ce champ est obligatoire.
countryCode

string

Code pays à deux lettres majuscules du numéro de téléphone de l'annonceur. Ce champ est obligatoire.
phoneNumber

string

Numéro de téléphone de l'annonceur auquel le message sera envoyé. Obligatoire.
text

string

Texte à afficher dans l'annonce. Ce champ est obligatoire.
extensionText

string

Texte extensionText renseigné dans l'application de chat.

PriceFeedItem

Représente une extension de prix.

Représentation JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "priceOfferings": [
    {
      object (PriceOffer)
    }
  ],
  "trackingUrlTemplate": string,
  "languageCode": string,
  "finalUrlSuffix": string
}
Champs
type

enum (PriceExtensionType)

Type d'extension de prix de cette extension.
priceQualifier

enum (PriceExtensionPriceQualifier)

Qualificateur de prix pour toutes les offres de cette extension de prix.
priceOfferings[]

object (PriceOffer)

Offres de prix dans cette extension de prix.
trackingUrlTemplate

string

Modèle d'URL de suivi pour toutes les offres de cette extension de prix.
languageCode

string

Code de la langue utilisée pour cette extension de prix.
finalUrlSuffix

string

Modèle d'URL de suivi pour toutes les offres de cette extension de prix.

PriceOffer

Représente une offre de prix dans une extension de prix.

Représentation JSON 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
Champs
price

object (Money)

Prix de cette offre.
unit

enum (PriceExtensionPriceUnit)

Unité de prix de cette offre.
finalUrls[]

string

Liste des URL finales possibles après toutes les redirections interdomaines.
finalMobileUrls[]

string

Une liste des URL finales pour mobile possibles après toutes les redirections vers un autre domaine.
header

string

Texte de l'en-tête de cette offre.
description

string

Texte descriptif de cette offre.

PromotionFeedItem

Représente une extension de promotion.

Représentation JSON 
{
  "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.
}
Champs
discountModifier

enum (PromotionExtensionDiscountModifier)

Énumération qui modifie l'éligibilité de la remise.
occasion

enum (PromotionExtensionOccasion)

L'occasion à laquelle la promotion était destinée. Si un événement est défini, la période d'utilisation doit se situer dans la plage de dates qui lui est associée.
finalUrls[]

string

Liste des URL finales possibles après toutes les redirections interdomaines. Ce champ est obligatoire.
finalMobileUrls[]

string

Une liste des URL finales pour mobile possibles après toutes les redirections vers un autre domaine.
urlCustomParameters[]

object (CustomParameter)

Liste de mises en correspondance à utiliser pour remplacer les balises de paramètre personnalisé d'URL dans "trackingUrlTemplate", "finalUrls" et/ou "finalMobileUrls".
promotionTarget

string

Description libre de ce que cible la promotion. Ce champ est obligatoire.
promotionStartDate

string

Date de début d'utilisation de la promotion.
promotionEndDate

string

Date limite à laquelle la promotion peut être utilisée.
trackingUrlTemplate

string

Modèle d'URL permettant de créer une URL de suivi.
finalUrlSuffix

string

Modèle d'URL permettant d'ajouter des paramètres aux URL de page de destination diffusées avec le suivi en parallèle.
languageCode

string

Langue de la promotion. Représenté sous la forme d'un tag de langue BCP 47.
Champ d'union discount_type. Type de remise : pourcentage ou montant de la remise. La valeur de discount_type ne peut être qu'un des éléments suivants :
percentOff

string (int64 format)

Pourcentage de remise de la promotion en micros. 1 million équivaut à 1 %. Veuillez saisir cette valeur ou money_off_amount.
moneyAmountOff

object (Money)

Montant de la remise dans le cadre de la promotion. Veuillez saisir cette valeur ou "percentOff".
Champ d'union promotion_trigger. Déclencheur de la promotion. Par code promotionnel ou par promotion en fonction du montant de la commande éligible. promotion_trigger ne peut être qu'un des éléments suivants :
promotionCode

string

Code que l'utilisateur doit utiliser pour pouvoir bénéficier de la promotion.
ordersOverAmount

object (Money)

Montant total de la commande pour que l'utilisateur puisse bénéficier de la promotion.

LocationFeedItem

Représente une extension de lieu.

Représentation JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Champs
businessName

string

Nom de l'établissement.
addressLine1

string

Ligne 1 de l'adresse de l'établissement
addressLine2

string

La ligne 2 de l'adresse de l'établissement
city

string

Ville de l'adresse de l'établissement.
province

string

Province de l'adresse de l'établissement.
postalCode

string

Code postal de l'adresse de l'établissement.
countryCode

string

Code pays de l'adresse de l'établissement.
phoneNumber

string

Numéro de téléphone de l'établissement.

AffiliateLocationFeedItem

Représente une extension de lieu affilié.

Représentation JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Champs
businessName

string

Nom de l'établissement.
addressLine1

string

Ligne 1 de l'adresse de l'établissement
addressLine2

string

La ligne 2 de l'adresse de l'établissement
city

string

Ville de l'adresse de l'établissement.
province

string

Province de l'adresse de l'établissement.
postalCode

string

Code postal de l'adresse de l'établissement.
countryCode

string

Code pays de l'adresse de l'établissement.
phoneNumber

string

Numéro de téléphone de l'établissement.
chainId

string (int64 format)

Identifiant de la chaîne de magasins promue comme vendeur de votre produit.
chainName

string

Nom de la chaîne.

HotelCalloutFeedItem

Représente une extension d'accroche pour hôtel.

Représentation JSON 
{
  "text": string,
  "languageCode": string
}
Champs
text

string

Texte de l'accroche. La longueur de cette chaîne doit être comprise entre 1 et 25, inclus.
languageCode

string

Langue du texte de l'accroche pour hôtel. Code de langue conforme à la norme IETF BCP 47.

ImageFeedItem

Représente une extension d'image fournie par l'annonceur.

Représentation JSON 
{
  "imageAsset": string
}
Champs
imageAsset

string

Obligatoire. Nom de ressource du composant Image.