Indice
PromotionsService
(interfaccia)Attributes
(messaggio)CouponValueType
(enum)GetPromotionRequest
(messaggio)InsertPromotionRequest
(messaggio)ListPromotionsRequest
(messaggio)ListPromotionsResponse
(messaggio)OfferType
(enum)ProductApplicability
(enum)Promotion
(messaggio)PromotionStatus
(messaggio)PromotionStatus.DestinationStatus
(messaggio)PromotionStatus.DestinationStatus.State
(enum)PromotionStatus.ItemLevelIssue
(messaggio)PromotionStatus.ItemLevelIssue.Severity
(enum)RedemptionChannel
(enum)StoreApplicability
(enum)
PromotionsService
Servizio per la gestione delle promozioni dei prodotti.
GetPromotion |
---|
Recupera la promozione dal tuo account Merchant Center. Dopo aver inserito o aggiornato un input della promozione, potrebbero essere necessari diversi minuti prima che sia possibile recuperare la promozione aggiornata.
|
InsertPromotion |
---|
Inserisce una promozione per il tuo account Merchant Center. Se la promozione esiste già, allora aggiorna la promozione.
|
ListPromotions |
---|
Elenca le promozioni nel tuo account Merchant Center. La risposta potrebbe contenere meno elementi di quelli specificati da Dopo aver inserito o aggiornato una promozione, potrebbero essere necessari diversi minuti prima che sia possibile recuperare la promozione elaborata aggiornata.
|
Attributi
Attributi.
Campi | |
---|---|
product_applicability |
Obbligatoria. Applicabilità della promozione a tutti i prodotti o solo a prodotti specifici. |
offer_type |
Obbligatoria. Il tipo di promozione. Utilizza questo attributo per indicare se i clienti hanno bisogno o meno di un codice coupon per utilizzare la promozione. |
generic_redemption_code |
Campo facoltativo. Codice promozionale generico per la promozione. Da utilizzare con il campo |
long_title |
Obbligatoria. Titolo lungo per la promozione. |
coupon_value_type |
Obbligatoria. L'attributo tipo di valore del coupon per indicare il tipo di promozione che intendi pubblicare. A seconda del tipo di valore del coupon selezionato, alcuni attributi sono obbligatori. |
promotion_destinations[] |
Obbligatoria. L'elenco di destinazioni a cui si applica la promozione. Se non specifichi una destinazione includendo un valore supportato nell'origine dati, per impostazione predefinita la tua promozione verrà visualizzata negli annunci Shopping e nelle schede senza costi. Potresti aver già inviato i seguenti valori come destinazioni per i tuoi prodotti: Shopping Actions, Piattaforme Google, Piattaforme Google locali. Per rappresentare questi valori, utilizza |
item_id_inclusion[] |
Campo facoltativo. Filtra prodotto in base all'ID articolo per la promozione. Gli attributi del filtro di prodotto si applicano solo quando l'attributo prodotti idonei all'applicabilità del prodotto in promozione |
brand_inclusion[] |
Campo facoltativo. Filtro prodotto in base al brand per la promozione. Gli attributi del filtro di prodotto si applicano solo quando l'attributo prodotti idonei all'applicabilità del prodotto in promozione |
item_group_id_inclusion[] |
Campo facoltativo. Filtra prodotti in base all'ID gruppo di articoli per la promozione. Gli attributi del filtro di prodotto si applicano solo quando l'attributo prodotti idonei alla promozione [product_applicability] è impostato su specific_products. |
product_type_inclusion[] |
Campo facoltativo. Filtro prodotto per tipo di prodotto per la promozione. Gli attributi del filtro di prodotto si applicano solo quando l'attributo prodotti idonei all'applicabilità del prodotto in promozione |
item_id_exclusion[] |
Campo facoltativo. Filtra il prodotto in base all'esclusione di ID articolo per la promozione. Gli attributi del filtro di prodotto si applicano solo quando l'attributo prodotti idonei all'applicabilità del prodotto in promozione |
brand_exclusion[] |
Campo facoltativo. Filtra i prodotti in base all'esclusione dei brand per la promozione. Gli attributi del filtro di prodotto si applicano solo quando l'attributo prodotti idonei all'applicabilità del prodotto in promozione |
item_group_id_exclusion[] |
Campo facoltativo. Filtro dei prodotti per ID gruppo di articoli. Gli attributi del filtro di prodotto si applicano solo quando l'attributo prodotti idonei all'applicabilità del prodotto della promozione |
product_type_exclusion[] |
Campo facoltativo. Filtro prodotto in base all'esclusione del tipo di prodotto per la promozione. Gli attributi del filtro di prodotto si applicano solo quando l'attributo prodotti idonei all'applicabilità del prodotto in promozione |
minimum_purchase_amount |
Campo facoltativo. Soglia minima di acquisto per la promozione. |
minimum_purchase_quantity |
Campo facoltativo. Quantità minima di acquisto per la promozione. |
limit_quantity |
Campo facoltativo. Quantità massima di acquisto per la promozione. |
limit_value |
Campo facoltativo. Prezzo massimo del prodotto per la promozione. |
percent_off |
Campo facoltativo. Lo sconto percentuale offerto nella promozione. |
money_off_amount |
Campo facoltativo. L'importo dello sconto offerto nella promozione. |
get_this_quantity_discounted |
Campo facoltativo. Il numero di articoli scontati nella promozione. L'attributo è impostato quando |
free_gift_value |
Campo facoltativo. Valore del regalo per la promozione. |
free_gift_description |
Campo facoltativo. Descrizione del regalo per la promozione. |
free_gift_item_id |
Campo facoltativo. ID articolo del regalo per la promozione. |
promotion_effective_time_period |
Obbligatoria. Rappresentazione |
promotion_display_time_period |
Campo facoltativo. Rappresentazione |
store_applicability |
Campo facoltativo. Indica se la promozione si applica a tutti i negozi o solo a quelli specificati. Le promozioni per gli annunci di inventario locale generano un errore se non viene inclusa alcuna applicabilità del negozio. Se |
store_codes_inclusion[] |
Campo facoltativo. Codici negozio da includere nella promozione. Gli attributi del filtro del negozio si applicano solo quando l'attributo Codice negozio (l'ID negozio presente nel profilo dell'attività) del negozio fisico in cui viene venduto il prodotto. Per saperne di più, consulta la specifica dei dati dell'inventario locale dei prodotti. |
store_codes_exclusion[] |
Campo facoltativo. Codici negozio da escludere per la promozione. Gli attributi del filtro del negozio si applicano solo quando l'attributo |
promotion_url |
Campo facoltativo. URL alla pagina del sito del commerciante in cui viene visualizzata la promozione. Le promozioni per gli annunci di inventario locale generano un errore se non viene incluso |
CouponValueType
Tipo di valore del coupon di una promozione.
Enum | |
---|---|
COUPON_VALUE_TYPE_UNSPECIFIED |
Indica che il tipo di valore del coupon non è specificato. |
MONEY_OFF |
Tipo di valore del coupon di sconto. |
PERCENT_OFF |
Tipo di valore del coupon con percentuale di sconto. |
BUY_M_GET_N_MONEY_OFF |
Acquista una quantità di M e ottieni uno sconto in denaro di N tipo di valore del coupon. minimum_purchase_quantity e get_this_quantity_discounted devono essere presenti. Deve essere presente anche money_off_amount . |
BUY_M_GET_N_PERCENT_OFF |
Acquista una quantità M e ottieni una percentuale di sconto pari a N per il tipo di valore del coupon. minimum_purchase_quantity e get_this_quantity_discounted devono essere presenti. Deve essere presente anche percent_off_percentage . |
BUY_M_GET_MONEY_OFF |
Acquista una quantità pari a M e ottieni uno sconto in denaro. Devono essere presenti minimum_purchase_quantity e money_off_amount . |
BUY_M_GET_PERCENT_OFF |
Acquista una quantità pari a M e ottieni uno sconto in denaro. Devono essere presenti minimum_purchase_quantity e percent_off_percentage . |
FREE_GIFT |
Regalo solo con descrizione. |
FREE_GIFT_WITH_VALUE |
Un regalo con un valore monetario. |
FREE_GIFT_WITH_ITEM_ID |
Regalo con ID articolo. |
FREE_SHIPPING_STANDARD |
Tipo di valore del coupon di spedizione gratuita standard. |
FREE_SHIPPING_OVERNIGHT |
Tipo di valore del coupon per la spedizione gratuita il giorno successivo. |
FREE_SHIPPING_TWO_DAY |
Tipo di valore del coupon con spedizione gratuita in due giorni. |
GetPromotionRequest
Messaggio di richiesta per il metodo GetPromotion
.
Campi | |
---|---|
name |
Obbligatoria. Il nome della promozione da recuperare. Formato: |
InsertPromotionRequest
Messaggio di richiesta per il metodo InsertPromotion
.
Campi | |
---|---|
parent |
Obbligatoria. L'account in cui verrà inserita la promozione. Formato: accounts/{account} |
promotion |
Obbligatoria. La promozione da inserire. |
data_source |
Obbligatoria. L'origine dati del formato della promozione: |
ListPromotionsRequest
Messaggio di richiesta per il metodo ListPromotions
.
Campi | |
---|---|
parent |
Obbligatoria. L'account per il quale elencare le promozioni elaborate. Formato: |
page_size |
Solo output. Il numero massimo di promozioni da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. Se non specificato, verrà restituito il numero massimo di promozioni. |
page_token |
Solo output. Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
ListPromotionsResponse
Messaggio di risposta per il metodo ListPromotions
.
Campi | |
---|---|
promotions[] |
Le promozioni elaborate dall'account specificato. |
next_page_token |
Un token, che può essere inviato come |
OfferType
Tipo di offerta di una promozione.
Enum | |
---|---|
OFFER_TYPE_UNSPECIFIED |
Tipo di offerta sconosciuto. |
NO_CODE |
Tipo di offerta senza codice. |
GENERIC_CODE |
Tipo di offerta con un codice. È necessario un codice promozionale generico per la promozione quando offerType = GENERIC_CODE . |
ProductApplicability
A quale prodotto o elenco di prodotti si applica la promozione.
Enum | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
I prodotti a cui si applica la promozione non sono noti. |
ALL_PRODUCTS |
Applicabile a tutti i prodotti. |
SPECIFIC_PRODUCTS |
Applicabile a un solo prodotto o elenco di prodotti. |
Promozione
Rappresenta una promozione. Per ulteriori dettagli, leggi i seguenti articoli.
Gli attributi di input della promozione obbligatori per superare i controlli di convalida dei dati sono definiti principalmente di seguito:
Dopo l'inserimento o l'aggiornamento di un input della promozione, potrebbero essere necessari diversi minuti prima che sia possibile recuperare la promozione finale.
Campi | |
---|---|
name |
Identificatore. Il nome della promozione. Formato: |
promotion_id |
Obbligatoria. L'utente ha fornito l'ID promozione per identificare in modo univoco la promozione. Segui i requisiti minimi per evitare che le promozioni non vengano approvate. |
content_language |
Obbligatoria. Il codice lingua ISO 639-1 di due lettere per la promozione. Le promozioni sono disponibili solo per alcune lingue selezionate. |
target_country |
Obbligatoria. Il paese di destinazione utilizzato come parte dell'identificatore univoco. Rappresentato come codice di territorio CLDR. Le promozioni sono disponibili solo in alcuni paesi, Schede senza costi e annunci Shopping Annunci di inventario locale |
redemption_channel[] |
Obbligatoria. Canale di utilizzo per la promozione. È richiesto almeno un canale. |
data_source |
Solo output. L'origine dati principale della promozione. |
attributes |
Campo facoltativo. Un elenco di attributi della promozione. |
custom_attributes[] |
Campo facoltativo. Un elenco di attributi personalizzati (forniti dal commerciante). Può essere utilizzato anche per inviare qualsiasi attributo della specifica dei dati in forma generica (ad esempio, |
promotion_status |
Solo output. Lo stato di una promozione, i problemi di convalida dei dati, ovvero le informazioni su una promozione calcolate in modo asincrono. |
version_number |
Campo facoltativo. Rappresenta la versione esistente (aggiornamento) della promozione, che può essere utilizzata per preservare l'ordine corretto quando vengono eseguiti più aggiornamenti contemporaneamente. Se impostato, l'inserimento viene impedito quando il numero di versione è inferiore a quello corrente della promozione esistente. Il reinserimento (ad esempio, l'aggiornamento della promozione dopo 30 giorni) può essere eseguito con l'attuale Se l'operazione viene impedita, verrà restituita l'eccezione interrotta. |
PromotionStatus
Lo stato della promozione.
Campi | |
---|---|
destination_statuses[] |
Solo output. Le destinazioni previste per la promozione. |
item_level_issues[] |
Solo output. Un elenco dei problemi associati alla promozione. |
creation_date |
Solo output. Data di creazione della promozione nel formato ISO 8601: data, ora e offset, ad esempio |
last_update_date |
Solo output. Data dell'ultimo aggiornamento dello stato della promozione nel formato ISO 8601: data, ora e offset, ad esempio |
DestinationStatus
Lo stato della destinazione specificata.
Campi | |
---|---|
reporting_context |
Solo output. Il nome della destinazione della promozione. |
status |
Solo output. Lo stato della destinazione specificata. |
Stato
Lo stato attuale della promozione.
Enum | |
---|---|
STATE_UNSPECIFIED |
Stato promozione sconosciuto. |
IN_REVIEW |
La promozione è in corso di revisione. |
REJECTED |
La promozione non è approvata. |
LIVE |
La promozione è approvata ed è attiva. |
STOPPED |
La promozione è stata interrotta dal commerciante. |
EXPIRED |
La promozione non è più attiva. |
PENDING |
La promozione non viene interrotta e tutte le revisioni sono state approvate, ma la data attiva è una data futura. |
ItemLevelIssue
Il problema associato alla promozione.
Campi | |
---|---|
code |
Solo output. Il codice di errore del problema. |
severity |
Solo output. L'impatto di questo problema sulla pubblicazione della promozione. |
resolution |
Solo output. Se il problema può essere risolto dal commerciante. |
attribute |
Solo output. Il nome dell'attributo, se il problema è causato da un singolo attributo. |
reporting_context |
Solo output. La destinazione a cui si applica il problema. |
description |
Solo output. Una breve descrizione del problema in inglese. |
detail |
Solo output. Una descrizione dettagliata del problema in inglese. |
documentation |
Solo output. L'URL di una pagina web per facilitare la risoluzione del problema. |
applicable_countries[] |
Solo output. Elenco dei codici paese (ISO 3166-1 alpha-2) in cui il problema si applica all'offerta. |
Gravità
Gravità del problema.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
Non specificato. |
NOT_IMPACTED |
Questo problema rappresenta un avviso e non ha un impatto diretto sulla promozione. |
DEMOTED |
La promozione è retrocessa e molto probabilmente avrà un rendimento limitato nei risultati di ricerca |
DISAPPROVED |
Il problema non approva la promozione. |
RedemptionChannel
Canale di una promozione.
Enum | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
Indica che il canale non è specificato. |
IN_STORE |
Indica che il canale è in negozio. È lo stesso canale di local utilizzato per products . |
ONLINE |
Indica che il canale è online. |
StoreApplicability
I codici negozio o l'elenco dei codici negozio a cui si applica la promozione. Solo per le promozioni degli annunci di inventario locale.
Enum | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
I codici negozio a cui si applica la promozione non sono noti. |
ALL_STORES |
La promozione si applica a tutti i negozi. |
SPECIFIC_STORES |
La promozione si applica solo ai negozi specificati. |