Przenoszenie zarządzania promocjami

Za pomocą interfejsu Merchant Promotions API możesz tworzyć promocje w Google i nimi zarządzać. Zasób accounts.promotions umożliwia prezentowanie ofert specjalnych na produkty, które sprzedajesz w Google. Więcej informacji znajdziesz w artykule Omówienie interfejsów API Promocji dla sprzedawców.

Omówienie zmian związanych z przejściem z Content API for Shopping na Merchant API

Istotną różnicą jest to, że Content API for Shopping automatycznie tworzy źródło danych po pierwszym wstawieniu promocji, co nie ma miejsca w przypadku interfejsu Merchant API. Aby dodać promocję za pomocą interfejsu Merchant API, musisz najpierw utworzyć źródło danych o promocjach.

Informacje o polach w obiekcie promotionDataSource w zasobie accounts.dataSources znajdziesz w artykule PromotionDataSource.

Istniejące źródła danych

Jeśli nie znasz identyfikatora accounts.dataSources.name istniejących źródeł danych, użyj metody dataSources.list, aby go pobrać.

Możesz też zidentyfikować źródło danych dla każdej promocji, używając metody accounts.promotions.get i sprawdzając pole dataSource w odpowiedzi dotyczącej istniejących promocji na Twoim koncie.

Aby odwoływać się do nich bezpośrednio w przyszłych wywołaniach interfejsu API, zdecydowanie zalecamy przechowywanie accounts.dataSources.name w lokalnej bazie danych dla każdej promocji.

Żądania

Aby wysyłać żądania, użyj tego adresu URL.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Migracja z Content API for Shopping

Poniżej porównujemy interfejs Content API for Shopping z interfejsem Merchant Promotions API w przypadku żądań związanych z promocjami.

URL

W Content API for Shopping:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

w Merchant API staje się:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

Identyfikatory

W Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

w interfejsie Merchant API:

{NAME}

Metody

Interfejs Merchant API obsługuje te metody dotyczące promocji:

  • Wstaw promocje
  • Skorzystaj z promocji
  • Promocje na liście

Oto porównanie dostępności metod promocji w interfejsie Content API for Shopping i interfejsie Merchant API:

Funkcja Content API for Shopping Merchant API
Adres URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
Identyfikatory {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Metody
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list

Zmiany pól

Tabela pokazuje, co się zmienia w przypadku promocji w interfejsie Merchant Promotions API.

Przykładowe informacje znajdziesz w artykule accounts.promotions.

Content API for Shopping Merchant API Opis
(nieobsługiwane) custom_attributes Lista atrybutów niestandardowych (podanych przez użytkownika). Możesz
go też użyć do przesłania dowolnego atrybutu ze specyfikacji
pliku danych w jego ogólnej formie.
Przykład: 
{
  "name": "size type", "value": "regular"
}
Jest to przydatne do przesyłania atrybutów, które nie są bezpośrednio
udostępniane przez interfejs API.
Nieobsługiwane data_source Utworzenie promocji wymaga istniejącego źródła danych.
Nieobsługiwane attributes Atrybuty specyficzne dla promocji, takie jak
long_tile, promotion_effective_timeperiod
i inne, są częścią komunikatu atrybutu.
item_id item_id_inclusion Lista identyfikatorów produktów, których dotyczy promocja,
została zmieniona.
store_id store_id_inclusion Lista identyfikatorów sklepów, w których obowiązuje promocja,
została przemianowana.
product_type product_type_inclusion Zmieniono nazwę listy typów produktów, których dotyczy promocja
.
item_group_id item_group_id_inclusion Zmieniono nazwę listy identyfikatorów grup produktów, do których ma zastosowanie promocja.
brand brand_inclusion Zmieniono nazwę listy marek, których dotyczy promocja
.
store_code store_codes_inclusion Zmieniono nazwę listy kodów sklepów, w których obowiązuje promocja (
). 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
Definicja Ceny uległa zmianie.

W interfejsie Content API for Shopping Price
był liczbą dziesiętną w postaci ciągu znaków.

Kwota Cena jest teraz rejestrowana w mikrojednostkach,
gdzie milion mikrojednostek odpowiada standardowej jednostce
Twojej waluty.

Nazwa pola amount została zmieniona z value na
amountMicros.

Nazwa pola currency została zmieniona na
currencyCode. Format pozostaje taki sam jak w 
ISO 4217. (Wikipedia)

order_limit (nieobsługiwane) Atrybut order_limit nie jest obsługiwany.
shippingServiceNames[] (nieobsługiwane) shippingServiceNames[] nie jest obsługiwany.
money_budget (nieobsługiwane) money_budget nie jest obsługiwany.
promotion_destination_ids promotion_destinations Zmieniono nazwę promotionDestinationIds.
Stan promocji 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Stan promocji uległ zmianie.
Bardziej szczegółowe informacje znajdziesz w sekcji Problemy. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}
Wstecz
Migrate order tracking signals
Dalej
Migrate conversion sources management