Ważne: 18 sierpnia 2026 r. wycofamy interfejs Content API for Shopping.

Jeśli potrzebujesz więcej czasu na przejście na Merchant API, poproś o przedłużenie dostępu do Content API for Shopping.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Rozwiązywanie problemów związanych z podrzędnym interfejsem API promocji

Na tej stronie dowiesz się, jak rozwiązywać problemy związane z podrzędnym interfejsem API Promocje.

Utwórz promocję

Jeśli używasz żądania accounts.promotions.insert wstawienia promocji, upewnij się, że w treści żądania znajdują się wszystkie wymagane pola. Te pola są wymagane:

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

Nieprawidłowy okres obowiązywania promocji

Jeśli w żądaniu accounts.promotions.insert podasz nieprawidłowe daty obowiązywania promocji, zobaczysz ten komunikat o błędzie:

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

Aby naprawić ten błąd, sprawdź, czy wartość podana w polu promotionDisplayTimePeriod.startTime jest taka sama lub wcześniejsza niż wartość podana w polu promotionEffectiveTimePeriod.startTime. Upewnij się też, że wartość podana w polu promotionDisplayTimePeriod.endTime jest taka sama jak wartość podana w polu promotionEffectiveTimePeriod.endTime lub wcześniejsza.

Wartości pól startTime i endTime muszą być w formacie UTC RFC3339, czyli yyyy-mm-ddThh:mm:ssZ. Na przykład 2024-08-15T18:20:20Z.

Nie określono minimalnej wielkości zakupu

Jeśli Twój attributes.couponValueType to BUY_M_GET_N_PERCENT_OFF lub BUY_M_GET_N_MONEY_OFF, musisz podać wartość w polu attributes.minimumPurchaseQuantity w żądaniu accounts.promotions.insert.

Jeśli w żądaniu accounts.promotions.insert nie podasz wartości w polu attributes.minimumPurchaseQuantity, zobaczysz ten komunikat o błędzie:

[minimumPurchaseQuantity] Missing benefit or restriction attributes for its type

Aby rozwiązać ten problem, w żądaniu podaj wartość pola minimumPurchaseQuantity.

Nie podano kwoty rabatu

Jeśli wartość pola attributes.couponValueType to MONEY_OFF, musisz podać wartość pola attributes.moneyOffAmount w żądaniu accounts.promotions.insert.

Jeśli w żądaniu attributes.moneyOffAmount nie podasz wartości w polu accounts.promotions.insert, zobaczysz ten komunikat o błędzie:

[moneyOffAmount] Missing benefit or restriction attributes for its type

Aby rozwiązać ten problem, w żądaniu podaj wartość pola attributes.moneyOffAmount. Kwota musi być podana w mikro.

Opis prezentu nie został podany

Jeśli wartość pola attributes.couponValueType to FREE_GIFT, musisz podać wartość pola attributes.freeGiftDescription w żądaniu accounts.promotions.insert.

Jeśli w żądaniu accounts.promotions.insert nie podasz wartości w polu attributes.freeGiftDescription, zobaczysz ten komunikat o błędzie:

[freeGiftDescription] Missing benefit or restriction attributes for its type

Aby rozwiązać ten problem, w żądaniu podaj wartość pola attributes.freeGiftDescription.

Bezpłatna dostawa nie jest obsługiwana w przypadku promocji produktów dostępnych lokalnie

Jeśli wartość pola redemptionChannel to IN_STORE, a wartość pola attributes.couponValueType to FREE_SHIPPING_STANDARD, FREE_SHIPPING_OVERNIGHT lub FREE_SHIPPING_TWO_DAY, zobaczysz ten komunikat o błędzie:

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

Aby naprawić ten błąd, sprawdź, czy wartość pola redemptionChannel to ONLINE.

Nie określono kanału wykorzystania

Jeśli w żądaniu accounts.promotions.insert nie podasz wartości pola redemptionChannel, zobaczysz ten komunikat o błędzie:

[redemptionChannel] Required parameter: redemptionChannel

Aby rozwiązać ten problem, w żądaniu podaj wartość pola redemptionChannel.

Pole `contentLanguage` promocji i źródła danych nie pasuje do siebie

Jeśli wartość pola contentLanguage nie jest taka sama jak wartość pola contentLanguage w źródle danych o promocjach, którego używasz w żądaniu accounts.promotions.insert, zobaczysz ten komunikat o błędzie:

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

Aby rozwiązać ten problem, upewnij się, że wartość pola contentLanguage jest taka sama jak wartość pola contentLanguage w używanym źródle danych o promocjach.

Ten błąd pojawi się też, jeśli wartość atrybutu targetCountry nie jest taka sama jak wartość pola targetCountry w używanym źródle danych o promocjach.