Angebotsverwaltung migrieren

Mit der Merchant Promotions API können Sie Angebote auf Google erstellen und verwalten. Mit der Ressource accounts.promotions können Sie Sonderangebote für die Produkte präsentieren, die Sie auf Google verkaufen. Weitere Informationen finden Sie unter Übersicht über die Merchant Promotions API.

Übersicht über die Änderungen von der Content API for Shopping zur Merchant API

Ein wesentlicher Unterschied besteht darin, dass die Content API for Shopping die Datenquelle beim ersten Einfügen eines Angebots automatisch erstellt. Bei der Merchant API ist das nicht der Fall. Wenn Sie ein Angebot über die Merchant API einfügen möchten, müssen Sie zuerst eine Angebotsdatenquelle erstellen.

Informationen zu den Feldern im promotionDataSource-Objekt in der accounts.dataSources-Ressource finden Sie unter PromotionDataSource.

Vorhandene Datenquellen

Wenn Sie bei vorhandenen Datenquellen Ihre accounts.dataSources.name nicht kennen, können Sie sie mit dataSources.list abrufen.

Alternativ können Sie die Datenquelle für jedes Ihrer Angebote mit der Methode accounts.promotions.get ermitteln und das Feld dataSource in der Antwort aller vorhandenen Angebote in Ihrem Konto prüfen.

Wir empfehlen dringend, die accounts.dataSources.name für jedes Angebot in Ihrer lokalen Datenbank zu speichern, damit Sie bei zukünftigen API-Aufrufen direkt darauf verweisen können.

Anfragen

Verwenden Sie die folgende URL, um Anfragen zu stellen.

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

Von der Content API for Shopping migrieren

Im Folgenden werden die Content API for Shopping und die Merchant Promotions API für angebotsbezogene Anfragen verglichen.

URL

In der Content API for Shopping:

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

in der Merchant API zu:

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

IDs

In der Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

in der Merchant API zu:

{NAME}

Methoden

Die Merchant API unterstützt die folgenden Methoden für Angebote:

  • Angebote einfügen
  • Angebote erhalten
  • Angebote auflisten

Hier ein Vergleich der Verfügbarkeit von Angebotsmethoden in der Content API for Shopping und der Merchant API:

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

Feldänderungen

In der Tabelle sehen Sie, was sich bei Angeboten in der Merchant Promotions API ändert.

Ein Beispiel finden Sie unter accounts.promotions.

Content API for Shopping Merchant API Beschreibung
(nicht unterstützt) custom_attributes Eine Liste benutzerdefinierter (vom Nutzer bereitgestellter) Attribute. Sie können
damit auch jedes Attribut der Feedspezifikation
in seiner generischen Form einreichen.
Beispiel: 
{
  "name": "size type", "value": "regular"
}
Dies ist nützlich, um Attribute einzureichen, die nicht explizit von der API bereitgestellt werden.
Nicht unterstützt data_source Zum Erstellen eines Angebots ist eine vorhandene Datenquelle erforderlich.
Nicht unterstützt attributes Angebotsbezogene Attribute wie
long_tile, promotion_effective_timeperiod,
und andere sind Teil der Attributnachricht.
item_id item_id_inclusion Die Liste der Artikel-IDs, für die ein Angebot gilt, wird umbenannt.
store_id store_id_inclusion Die Liste der Geschäfts-IDs, für die ein Angebot gilt, wird umbenannt.
product_type product_type_inclusion Die Liste der Produkttypen, für die ein Angebot gilt, wird umbenannt.
item_group_id item_group_id_inclusion Die Liste der Artikelgruppen-IDs, für die ein Angebot gilt, wird umbenannt.
brand brand_inclusion Die Liste der Marken, für die ein Angebot gilt, wird umbenannt.
store_code store_codes_inclusion Die Liste der Geschäftscodes, für die ein Angebot gilt,
wird umbenannt. 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
Die Definition von Preis hat sich geändert.

In der Content API for Shopping war Price
eine Dezimalzahl in Form eines Strings.

Der Preis wird jetzt in Mikros angegeben,
wobei 1 Million Mikros der Standardeinheit
Ihrer Währung entspricht.

Der Feldname amount wurde von „value“ in
amountMicros geändert.

Der Feldname currency wurde in
currencyCode geändert. Das Format bleibt
ISO 4217. (Wikipedia)

order_limit (nicht unterstützt) Das Attribut order_limit wird nicht unterstützt.
shippingServiceNames[] (nicht unterstützt) shippingServiceNames[] wird nicht unterstützt.
money_budget (nicht unterstützt) money_budget wird nicht unterstützt.
promotion_destination_ids promotion_destinations promotionDestinationIds wurde umbenannt.
Angebotsstatus 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Angebotsstatus hat sich geändert.
Detailliertere Informationen finden Sie in den Problemen. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}
Zurück
Migrate order tracking signals
Weiter
Migrate conversion sources management