Angebotsverwaltung migrieren

Mit der Merchant Promotions API können Sie Werbeaktionen 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 mit der Content API for Shopping die Datenquelle automatisch beim ersten Einfügen eines Angebots erstellt wird. Das ist bei der Merchant API 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.

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

{NAME}

Methoden

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

  • Angebote einfügen
  • Angebote erhalten
  • Angebote auflisten

Hier finden Sie einen 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 es bei Angeboten in der Merchant Promotions API gibt.

Ein Beispiel finden Sie unter Lokales Inventar.

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 Feed-Spezifikation 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 Attribute 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 eine Werbeaktion 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 Betrag für Preis wird jetzt in Mikros erfasst,
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
}
Der 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,
    ]
    }
  ]
}