Przenoszenie zarządzania promocjami

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
była liczbą dziesiętną w postaci ciągu znaków.

Kwota ceny jest teraz rejestrowana w mikro, czyli
, gdzie milion mikro to standardowa jednostka
w Twojej walucie.

Nazwa pola amount została zmieniona z wartości na
amountMicros.

Nazwa pola currency została zmieniona na
currencyCode. Format to
ISO 4217. (Wikipedia)

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,
    ]
    }
  ]
}