Interfejsu API promocji Merchant Center można używać do tworzenia promocji i zarządzania nimi
Google.
accounts.promotions
pozwala prezentować oferty specjalne na produkty, które sprzedajesz w Google.
Więcej informacji znajdziesz w artykule Omówienie promocji
API.
Żą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
Porównanie interfejsu Content API for Shopping z Promocjami Interfejs API do obsługi żą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 dla: Zakupy Google i interfejs API sprzedawcy:
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 sekcji Lokalne Zasoby reklamowe.
Content API for Shopping | Interfejs API sprzedawcy | Opis |
---|---|---|
(nieobsługiwane) | custom_attributes |
Lista niestandardowych atrybutów (dostarczonych przez sprzedawcę). Dostępne opcje
a także do przesyłania atrybutów w pliku danych w ogólnej formie. Na przykład: { "name": "size type", "value": "regular" } ujawnianych przez interfejs API. |
Nieobsługiwane | data_source | Do utworzenia promocji potrzebne jest istniejące źródło danych. |
Nieobsługiwane | atrybuty |
Atrybuty specjalne promocji, na przykład:
long_tile, promotion_effective_timeperiod, a inne są częścią komunikatu atrybutu. |
item_id | item_id_inclusion |
Lista identyfikatorów produktów objętych promocją
Nazwa użytkownika została zmieniona na. |
store_id | store_id_inclusion |
Lista identyfikatorów sklepów, których dotyczy promocja
Nazwa adresu została zmieniona. |
prduct_type | product_type_inclusion |
Lista typów produktów objętych promocją
Nazwa adresu została zmieniona. |
item_group_id | item_group_id_inclusion |
Lista identyfikatorów grup produktów, do których ma zastosowanie promocja
Nazwa adresu została zmieniona. |
brand | brand_inclusion |
Lista marek, które są objęte promocją
Nazwa adresu została zmieniona. |
store_code | store_codes_inclusion |
Lista kodów sklepów objętych promocją
Nazwa adresu została zmieniona. |
price: { object (Price) } |
price: { object (Price) } |
Zmieniła się definicja opcji Price.
W Content API for Shopping atrybut Price
Kwota ceny jest teraz rejestrowana w mikrosekundach,
Nazwa pola amount (kwota) została zmieniona z „value” 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 } |
Zmienił się stan promocji.
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, ] } ] } |