Przenoszenie zarządzania promocjami

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"
}
Jest to przydatne przy przesyłaniu atrybutów, które nie są wyraźnie określone
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
była liczbą dziesiętną w postaci ciągu.

Kwota ceny jest teraz rejestrowana w mikrosekundach,
gdzie milion mikro to równowartość w walucie lokalnej.
standardowych jednostek reklamowych.

Nazwa pola amount (kwota) została zmieniona z „value” 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
}
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,
    ]
    }
  ]
}