Risolvere i problemi relativi alla sottoAPI Promozioni

Questa pagina descrive come risolvere i problemi relativi alla sub-API Promotions.

Crea una promozione

Quando utilizzi la richiesta accounts.promotions.insert per inserire una promozione, assicurati di aver incluso tutti i campi obbligatori nel corpo della richiesta. I seguenti campi sono obbligatori:

  • promotion.promotionId
  • promotion.contentLanguage
  • promotion.redemptionChannel
  • promotion.targetCountry
  • promotion.attributes.longTitle
  • promotion.attributes.promotionEffectiveTimePeriod.startTime
  • promotion.attributes.promotionEffectiveTimePeriod.endTime
  • promotion.attributes.promotionDestinations
  • promotion.attributes.couponValueType
  • promotion.attributes.offerType
  • promotion.attributes.productApplicability
  • promotion.attributes.promotionUrl

Periodo di validità della promozione non valido

Se fornisci date di validità della promozione non valide nella richiesta accounts.promotions.insert, visualizzerai il seguente messaggio di errore:

Invalid value at 'promotion.attributes.promotion_effective_time_period.start_time'

Per risolvere questo errore, assicurati che il valore fornito per il campo promotionDisplayTimePeriod.startTime sia uguale o precedente al valore fornito per il campo promotionEffectiveTimePeriod.startTime. Assicurati inoltre che il valore fornito per il campo promotionDisplayTimePeriod.endTime sia uguale o precedente al valore fornito per il campo promotionEffectiveTimePeriod.endTime.

I valori dei campi startTime e endTime devono essere nel formato RFC3339 UTC, ovvero yyyy-mm-ddThh:mm:ssZ. Ad esempio, 2024-08-15T18:20:20Z.

Quantità minima di acquisto non specificata

Se il tuo attributes.couponValueType è BUY_M_GET_N_PERCENT_OFF o BUY_M_GET_N_MONEY_OFF, devi fornire un valore per il campo attributes.minimumPurchaseQuantity nella richiesta accounts.promotions.insert.

Se non fornisci un valore per il campo attributes.minimumPurchaseQuantity nella richiesta accounts.promotions.insert, visualizzerai il seguente messaggio di errore:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Per risolvere questo errore, assicurati di fornire un valore per il campo minimumPurchaseQuantity nella richiesta.

Importo dello sconto non specificato

Se il valore del campo attributes.couponValueType è MONEY_OFF, devi fornire un valore per il campo attributes.moneyOffAmount nella tua richiesta accounts.promotions.insert.

Se non fornisci un valore per il campo attributes.moneyOffAmount nella tua richiesta accounts.promotions.insert, verrà visualizzato il seguente messaggio di errore:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Per risolvere questo errore, assicurati di fornire un valore per il campo attributes.moneyOffAmount nella richiesta. L'importo deve essere in micro.

Descrizione del regalo non specificata

Se il valore del campo attributes.couponValueType è FREE_GIFT, devi fornire un valore per il campo attributes.freeGiftDescription nella tua richiesta accounts.promotions.insert.

Se non fornisci un valore per il campo attributes.freeGiftDescription nella richiesta accounts.promotions.insert, verrà visualizzato il seguente messaggio di errore:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Per risolvere questo errore, assicurati di fornire un valore per il campo attributes.freeGiftDescription nella richiesta.

Spedizione gratuita non supportata per le promozioni locali

Se il valore del campo redemptionChannel è IN_STORE e il valore del campo attributes.couponValueType è FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT o FREE_SHIPPING_TWO_DAY, verrà visualizzato il seguente messaggio di errore:

[shippingServiceNames] Free shipping types are not supported for local promotions

Per risolvere questo errore, assicurati che il valore del campo redemptionChannel sia ONLINE.

Canale promozionale non specificato

Se il valore del campo redemptionChannel non è specificato nella richiesta accounts.promotions.insert, viene visualizzato il seguente messaggio di errore:

[redemptionChannel] Required parameter: redemptionChannel

Per risolvere questo errore, assicurati di fornire un valore per il campo redemptionChannel nella richiesta.

Il campo contentLanguage della promozione e dell'origine dati non corrispondono

Se il valore del campo contentLanguage non è uguale a quello del campo contentLanguage dell'origine dei dati delle promozioni che utilizzi nella richiesta accounts.promotions.insert, viene visualizzato il seguente messaggio di errore:

[promotion] Could not find the proper data target for the provided feedLabel and contentLanguage

Per risolvere questo errore, assicurati che il valore del campo contentLanguage sia uguale al valore del campo contentLanguage dell'origine dei dati delle promozioni che stai utilizzando.

Visualizzerai questo errore anche se il valore di targetCountry non è uguale al valore del campo targetCountry dell'origine dati delle promozioni che stai utilizzando.

Scopri di più