ExtensionFeedItem

Un é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. Le nom des ressources d'élément de flux d'extensions se présente sous la forme suivante:

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 qui ne se chevauchent pas, spécifiant tous les intervalles de temps pendant lesquels l'élément de flux peut être diffusé. Jusqu'à six programmations sont autorisées 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. ID 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 correspond au 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 efficace et cessera d'être diffusé. L'heure correspond au 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 à partir d'une fiche d'établissement. Ce champ est en lecture seule.

affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

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

hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Une 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

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 est obligatoire.

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 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 des mises en correspondance à utiliser pour remplacer les balises de paramètre personnalisé d'URL dans "trackingUrlTemplate", "finalUrls" et/ou "finalMobileUrls".

appId

string

ID spécifique à la plate-forme pour l'application cible. Cette chaîne est obligatoire.

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

Il s'agit d'une 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) en 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

Message 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)

Prix proposés 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

Description 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 la qualification de la remise.

occasion

enum (PromotionExtensionOccasion)

L'occasion pour laquelle la promotion était prévue. Si une occasion est définie, la période d'utilisation doit être comprise 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 des 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 l'objet de la promotion. Ce champ est obligatoire.

promotionStartDate

string

Date de début de l'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. discount_type ne peut correspondre qu'à l'un des éléments suivants :
percentOff

string (int64 format)

Pourcentage de remise dans la promotion en micros. Un million équivaut à un pour cent. Veuillez saisir cette valeur ou le montant "money_off_amount".

moneyAmountOff

object (Money)

Montant de la remise dans le cadre de la promotion. Veuillez saisir cette valeur ou pourcentageOff.

Champ d'union promotion_trigger. Déclencheur de promotion. Il peut s'agir d'un code promotionnel ou d'une promotion en fonction du montant de la commande éligible. promotion_trigger ne peut être qu'un des éléments suivants :
promotionCode

string

Code à utiliser pour que l'utilisateur puisse 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'entreprise

addressLine2

string

Ligne 2 de l'adresse de l'entreprise

city

string

Ville de l'adresse de l'établissement.

province

string

Région 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'entreprise

addressLine2

string

Ligne 2 de l'adresse de l'entreprise

city

string

Ville de l'adresse de l'établissement.

province

string

Région 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 présentée 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.