ExtensionFeedItem

Un elemento del feed estensione.

Rappresentazione 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.
}
Campi
resourceName

string

Immutabile. Il nome della risorsa dell'elemento del feed dell'estensione. I nomi delle risorse degli elementi del feed estensione hanno il seguente formato:

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

enum (ExtensionType)

Solo output. Il tipo di estensione dell'elemento del feed estensione. Questo campo è di sola lettura.
adSchedules[]

object (AdScheduleInfo)

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali potrebbe essere pubblicato l'elemento del feed. Possono esistere massimo 6 programmazioni al giorno.
device

enum (FeedItemTargetDevice)

Il dispositivo target.
targetedKeyword

object (KeywordInfo)

La parola chiave scelta come target.
status

enum (FeedItemStatus)

Solo output. Lo stato dell'elemento del feed. Questo campo è di sola lettura.
id

string (int64 format)

Solo output. L'ID di questo elemento del feed. Sola lettura.
startDateTime

string

Ora di inizio in cui questo elemento del feed è attivo e può iniziare la pubblicazione. L'ora è indicata nel fuso orario del cliente. Il formato è "AAAA-MM-GG HH:MM:SS". Esempi: "2018-03-05 09:15:00" o "2018-02-01 14:34:30"
endDateTime

string

Ora di fine in cui questo elemento del feed non è più attivo e non viene più pubblicato. L'ora è indicata nel fuso orario del cliente. Il formato è "AAAA-MM-GG HH:MM:SS". Esempi: "2018-03-05 09:15:00" o "2018-02-01 14:34:30"
targetedGeoTargetConstant

string

La costante del targeting geografico target.
Campo di unione extension. Tipo di estensione. extension può essere solo uno dei seguenti:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

Estensione snippet strutturato.
appFeedItem

object (AppFeedItem)

Estensione per app.
callFeedItem

object (CallFeedItem)

Estensione di chiamata.
calloutFeedItem

object (CalloutFeedItem)

Estensione callout.
textMessageFeedItem

object (TextMessageFeedItem)

Estensione messaggio di testo.
priceFeedItem

object (PriceFeedItem)

Estensione di prezzo.
promotionFeedItem

object (PromotionFeedItem)

Estensione di promozione.
locationFeedItem

object (LocationFeedItem)

Solo output. Estensione di località. Le sedi vengono sincronizzate da un profilo dell'attività in un feed. Questo campo è di sola lettura.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

Solo output. Estensione di località dell'affiliato. Le località dei feed vengono compilate da Google Ads in base a un ID catena. Questo campo è di sola lettura.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

Estensione callout per hotel.
imageFeedItem

object (ImageFeedItem)

Immutabile. Estensione immagine fornita dall'inserzionista.
Campo di unione serving_resource_targeting. Targeting a livello di campagna o di gruppo di annunci. Gli elementi del feed che hanno come target una campagna o un gruppo di annunci verranno pubblicati solo con questa risorsa. serving_resource_targeting può essere solo uno dei seguenti:
targetedCampaign

string

La campagna target.
targetedAdGroup

string

Il gruppo di annunci scelto come target.

StructuredSnippetFeedItem

Rappresenta un'estensione snippet strutturato.

Rappresentazione JSON 
{
  "values": [
    string
  ],
  "header": string
}
Campi
values[]

string

I valori nello snippet. La dimensione massima di questa raccolta è 10.
header

string

L'intestazione dello snippet. Questa stringa non deve essere vuota.

AppFeedItem

Rappresenta un'estensione per app.

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

enum (AppStore)

L'archivio applicazioni a cui appartiene l'applicazione di destinazione. Questo campo è obbligatorio.
finalUrls[]

string

Un elenco di possibili URL finali dopo tutti i reindirizzamenti interdominio. Questo elenco non deve essere vuoto.
finalMobileUrls[]

string

Un elenco di possibili URL mobile finali dopo tutti i reindirizzamenti interdominio.
urlCustomParameters[]

object (CustomParameter)

Un elenco di mappature da utilizzare per sostituire i tag dei parametri personalizzati dell'URL in trackingUrlTemplate, finalUrls e/o finalMobileUrls.
linkText

string

Il testo visibile che viene mostrato quando il link viene visualizzato in un annuncio. Questa stringa non deve essere vuota e la sua lunghezza deve essere compresa tra 1 e 25 inclusi.
appId

string

L'ID specifico del negozio per l'applicazione di destinazione. Questa stringa non deve essere vuota.
trackingUrlTemplate

string

Modello di URL per la creazione di un URL di monitoraggio. Il valore predefinito è "{lpurl}".
finalUrlSuffix

string

Modello di URL per l'aggiunta di parametri agli URL pagina di destinazione pubblicati con il monitoraggio parallelo.

AppStore

Tipo di store in un'estensione per app.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
APPLE_ITUNES iTunes di Apple.
GOOGLE_PLAY Google Play.

TextMessageFeedItem

Un'estensione su cui gli utenti possono fare clic per inviare un messaggio di testo all'inserzionista.

Rappresentazione JSON 
{
  "businessName": string,
  "countryCode": string,
  "phoneNumber": string,
  "text": string,
  "extensionText": string
}
Campi
businessName

string

Il nome dell'attività da anteporre al testo del messaggio. Questo campo è obbligatorio.
countryCode

string

Il codice paese di due lettere maiuscole del numero di telefono dell'inserzionista. Questo campo è obbligatorio.
phoneNumber

string

Il numero di telefono dell'inserzionista a cui verrà inviato il messaggio. Obbligatorio.
text

string

Il testo da mostrare nell'annuncio. Questo campo è obbligatorio.
extensionText

string

Il testo dell'estensione messaggio compilato nell'app di messaggistica.

PriceFeedItem

Rappresenta un'estensione di prezzo.

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

enum (PriceExtensionType)

Tipo di estensione di prezzo di questa estensione.
priceQualifier

enum (PriceExtensionPriceQualifier)

Qualificatore prezzo per tutte le offerte di questa estensione di prezzo.
priceOfferings[]

object (PriceOffer)

Le offerte di prezzo in questa estensione di prezzo.
trackingUrlTemplate

string

Modello di URL di monitoraggio per tutte le offerte di questa estensione di prezzo.
languageCode

string

Il codice della lingua utilizzata per questa estensione di prezzo.
finalUrlSuffix

string

Modello di URL di monitoraggio per tutte le offerte di questa estensione di prezzo.

PriceOffer

Rappresenta un'offerta di prezzo in un'estensione di prezzo.

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

object (Money)

Valore del prezzo di questa offerta.
unit

enum (PriceExtensionPriceUnit)

Unità di prezzo per questa offerta.
finalUrls[]

string

Un elenco di possibili URL finali dopo tutti i reindirizzamenti interdominio.
finalMobileUrls[]

string

Un elenco di possibili URL mobile finali dopo tutti i reindirizzamenti interdominio.
header

string

Testo intestazione dell'offerta.
description

string

Testo descrittivo dell'offerta.

PromotionFeedItem

Rappresenta un'estensione di promozione.

Rappresentazione 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.
}
Campi
discountModifier

enum (PromotionExtensionDiscountModifier)

Enum che modifica la qualifica dello sconto.
occasion

enum (PromotionExtensionOccasion)

L'occasione a cui era destinata la promozione. Se è impostata un'occasione, la finestra di utilizzo deve rientrare nell'intervallo di date associato all'occasione.
finalUrls[]

string

Un elenco di possibili URL finali dopo tutti i reindirizzamenti interdominio. Questo campo è obbligatorio.
finalMobileUrls[]

string

Un elenco di possibili URL mobile finali dopo tutti i reindirizzamenti interdominio.
urlCustomParameters[]

object (CustomParameter)

Un elenco di mappature da utilizzare per sostituire i tag dei parametri personalizzati dell'URL in trackingUrlTemplate, finalUrls e/o finalMobileUrls.
promotionTarget

string

Una descrizione in formato libero del target della promozione. Questo campo è obbligatorio.
promotionStartDate

string

Data di inizio del periodo in cui la promozione è idonea per essere utilizzata.
promotionEndDate

string

L'ultima data in cui è possibile utilizzare la promozione.
trackingUrlTemplate

string

Modello di URL per la creazione di un URL di monitoraggio.
finalUrlSuffix

string

Modello di URL per l'aggiunta di parametri agli URL pagina di destinazione pubblicati con il monitoraggio parallelo.
languageCode

string

La lingua della promozione. Rappresentato come tag della lingua BCP 47.
Campo di unione discount_type. Tipo di sconto, che può essere una percentuale di sconto o uno sconto di importo. Il valore discount_type può essere solo uno dei seguenti:
percentOff

string (int64 format)

Percentuale di sconto sulla promozione in micro. Un milione è equivalente all'uno percento. È obbligatorio specificare questo valore o "money_off_amount".
moneyAmountOff

object (Money)

Importo dello sconto per la promozione. È obbligatorio specificare questo valore o percentualeOff.
Campo di unione promotion_trigger. Attivatore della promozione. Può essere tramite codice promozionale o promozione in base all'importo dell'ordine idoneo. promotion_trigger può essere solo uno dei seguenti:
promotionCode

string

Un codice che l'utente deve utilizzare per poter usufruire della promozione.
ordersOverAmount

object (Money)

L'importo totale dell'ordine affinché l'utente sia idoneo alla promozione.

LocationFeedItem

Rappresenta un'estensione di località.

Rappresentazione JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
Campi
businessName

string

Il nome dell'attività commerciale.
addressLine1

string

Riga 1 dell'indirizzo dell'attività commerciale.
addressLine2

string

Riga 2 dell'indirizzo dell'attività.
city

string

Città dell'indirizzo dell'attività.
province

string

Provincia dell'indirizzo dell'attività.
postalCode

string

Codice postale dell'indirizzo dell'attività commerciale.
countryCode

string

Codice paese dell'indirizzo dell'attività.
phoneNumber

string

Numero di telefono dell'attività commerciale.

AffiliateLocationFeedItem

Rappresenta un'estensione di località dell'affiliato.

Rappresentazione JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
Campi
businessName

string

Il nome dell'attività commerciale.
addressLine1

string

Riga 1 dell'indirizzo dell'attività commerciale.
addressLine2

string

Riga 2 dell'indirizzo dell'attività.
city

string

Città dell'indirizzo dell'attività.
province

string

Provincia dell'indirizzo dell'attività.
postalCode

string

Codice postale dell'indirizzo dell'attività commerciale.
countryCode

string

Codice paese dell'indirizzo dell'attività.
phoneNumber

string

Numero di telefono dell'attività commerciale.
chainId

string (int64 format)

ID della catena di vendita al dettaglio pubblicizzata come venditore del prodotto.
chainName

string

Nome della catena.

HotelCalloutFeedItem

Rappresenta un'estensione callout per hotel.

Rappresentazione JSON 
{
  "text": string,
  "languageCode": string
}
Campi
text

string

Il testo del callout. La lunghezza di questa stringa deve essere compresa tra 1 e 25 inclusi.
languageCode

string

La lingua del testo dell'estensione callout per hotel. Codice lingua conforme allo standard IETF BCP 47.

ImageFeedItem

Rappresenta un'estensione immagine fornita dall'inserzionista.

Rappresentazione JSON 
{
  "imageAsset": string
}
Campi
imageAsset

string

Obbligatorio. Nome della risorsa dell'asset immagine.