Angebotsverwaltung migrieren

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

Änderungen im Vergleich zur Content API for Shopping

Ein wesentlicher Unterschied besteht darin, dass mit der Content API for Shopping die Datenquelle automatisch bei der ersten Angebotsinsertion erstellt wird. Das ist bei der Merchant API nicht der Fall. Wenn Sie ein Angebot mit der Merchant API einfügen möchten, müssen Sie zuerst eine Angebotsdatenquelle erstellen. Informationen zu den Feldern im promotionDataSource Objekt in accounts.dataSources Ressource finden Sie unter PromotionDataSource.

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 wird die Content API for Shopping mit der 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 wird daraus:

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 wird daraus:

{NAME}

Methoden

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

  • Angebote einfügen
  • Angebote abrufen
  • Angebote auflisten

Hier ist 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
  • delete

Feldänderungen

In der Tabelle sehen Sie, welche Änderungen für Angebote in der Merchant Promotions API vorgenommen wurden.

Ein Beispiel finden Sie unter Lokales Inventar.

Content API for Shopping Merchant API Beschreibung
(nicht unterstützt) custom_attributes Eine Liste benutzerdefinierter Attribute. Sie können
damit auch beliebige Attribute der Feed
Spezifikation in ihrer allgemeinen 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
wurde umbenannt.
store_id store_id_inclusion Die Liste der Geschäfts-IDs, für die ein Angebot gilt
wurde umbenannt.
product_type product_type_inclusion Die Liste der Produkttypen, für die ein Angebot gilt
wurde umbenannt.
item_group_id item_group_id_inclusion Die Liste der Artikelgruppen-IDs, für die ein Angebot gilt
wurde umbenannt.
brand brand_inclusion Die Liste der Marken, für die ein Angebot gilt
wurde umbenannt.
store_code store_codes_inclusion Die Liste der Geschäftscodes, für die ein Angebot gilt
wurde umbenannt. 
price:
  {
    object (Price)
  }

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

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

Der Betrag für Preis wird jetzt in Mikros angegeben.
1 Million Mikros entspricht der Standardeinheit Ihrer Währung.

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

Der Feldname currency wurde in
currencyCode geändert. Das Format bleibt als
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
}
Der Angebotsstatus wurde geändert.
Detailliertere Informationen finden Sie unter Probleme. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}