Interfejsu API promocji możesz używać do tworzenia promocji i zarządzania nimi w Google. Za pomocą zasobu accounts.promotions możesz prezentować oferty specjalne na produkty, które sprzedajesz w Google. Więcej informacji znajdziesz w Omówieniu interfejsu API promocji sprzedawców.
Żądania
Aby wysłać prośbę, użyj tego adresu URL.
POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions
Migracja z Content API for Shopping
Poniżej porównujemy Content API for Shopping z interfejsem API promocji dla sprzedawców w przypadku żądań związanych z promocjami.
URL
W interfejsie Content API for Shopping:
https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
w interfejsie Merchant API zmienia się w:
https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
Identyfikatory
W interfejsie Content API for Shopping:
{merchantId}/promotions/{promotionId}
w interfejsie Merchant API zmienia się w:
{name}
Metody
Interfejs API sprzedawcy obsługuje następujące metody promocji:
- Wstaw promocje
- Promocje
- Wyświetl listę promocji
Oto porównanie dostępności metod promocji w Content API for Shopping i Merchant API:
Metoda | Content API for Shopping | Interfejs API sprzedawcy |
---|---|---|
wstaw | Tak | Tak |
pobierz | Tak | Tak |
list | Tak | Tak |
customBatch | Nie | Nie |
usuń | Nie | (Do ustalenia) |
Nazwa zasobu
Tabela pokazuje zmiany dotyczące promocji w interfejsie API promocji.
Przykład znajdziesz w artykule Lokalny asortyment.
Content API for Shopping | Interfejs API sprzedawcy | Opis |
---|---|---|
(nieobsługiwane) | custom_attributes |
Lista niestandardowych atrybutów (dostarczonych przez sprzedawcę). Za pomocą możesz też przesłać dowolny atrybut specyfikacji pliku danych w jego ogólnej formie. Na przykład: { "name": "size type", "value": "regular" }Jest to przydatne w przypadku przesyłania atrybutów, które nie są bezpośrednio udostępniane przez interfejs API. |
Nieobsługiwane | data_source | Do utworzenia promocji potrzebne jest istniejące źródło danych. |
Nieobsługiwane | atrybuty |
Atrybuty specjalne promocji, takie jak long_tile, promotion_effective_timeperiod czy , są częścią komunikatu atrybutu. |
item_id | item_id_inclusion |
Zmieniono nazwę listy identyfikatorów produktów, do których ma zastosowanie promocja. |
store_id | store_id_inclusion |
Nazwa listy identyfikatorów sklepów, do których ma zastosowanie , została zmieniona. |
prduct_type | product_type_inclusion |
Nazwa listy typów produktów, do których ma zastosowanie , została zmieniona. |
item_group_id | item_group_id_inclusion |
Nazwa listy identyfikatorów grup produktów, do których ma zastosowanie , została zmieniona. |
brand | brand_inclusion |
Nazwa listy marek, do których ma zastosowanie , została zmieniona. |
store_code | store_codes_inclusion |
Zmieniono nazwę listy kodów sklepów, do których ma zastosowanie . |
price: { object (Price) } |
price: { object (Price) } |
Zmieniła się definicja opcji Price.
W Content API for Shopping Cena
Kwota ceny jest teraz rejestrowana w mikro, czyli
Nazwa pola amount została zmieniona z wartości na
Nazwa pola currency została zmieniona na |
order_limit | (nieobsługiwane) | Atrybut order_limit nie jest obsługiwany. |
shippingServiceNames[] | (nieobsługiwane) | Atrybut shippingServiceNames[] nie jest obsługiwany. |
money_budget | (nieobsługiwane) | Parametr money_budget nie jest obsługiwany. |
promotion_destination_ids | promotion_destinations | Nazwa promotionDestinationIds została zmieniona. |
Stan promocji
{ "destinationStatuses": [ { "destination": string, "status": enum (State) } ], "promotionIssue": [ { "code": string, "detail": string } ], "creationDate": string, "lastUpdateDate": string } |
Stan promocji się zmienił.
Bardziej szczegółowe informacje znajdziesz w tych problemach. promotionStatus = { destinationStatuses = [ { reportingContext = Enum status = Enum }, ], itemLevelIssues = [ { code = String severity = Enum resolution = String reportingContext = Enum description = String detail = String documentation = String applicableCountries = [ String, ] } ] } |