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 in der Übersicht über die Merchant Promotions API.

Anfragen

Verwenden Sie für Anfragen die folgende URL.

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

Von Content API for Shopping migrieren

Im Folgenden wird die Content API for Shopping bei angebotsbezogenen Anfragen mit der Merchant Promotions API verglichen.

URL

In der Content API for Shopping:

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

in Merchant API zu:

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

IDs

In der Content API for Shopping:

{merchantId}/promotions/{promotionId}

in Merchant API zu:

{name}

Methoden

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

  • Werbeaktionen einfügen
  • Angebote erhalten
  • Werbeaktionen auflisten

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

Methode Content API for Shopping Händler-API
insert Ja Ja
get Ja Ja
list Ja Ja
customBatch Nein Nein
delete Nein (wird noch festgelegt)

Ressourcenname

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

Ein Beispiel findest du unter Lokales Inventar.

Content API for Shopping Händler-API Beschreibung
(nicht unterstützt) custom_attributes Eine Liste benutzerdefinierter (vom Händler bereitgestellt) Attribute. Sie können die
auch verwenden, um beliebige Attribute der
-Feedspezifikation in einem generischen Format einzureichen.
Beispiel: 
{
  "name": "size type", "value": "regular"
}
Dies ist nützlich, um Attribute zu senden, die nicht explizit von der API
zur Verfügung gestellt werden.
Nicht unterstützt data_source Zum Erstellen eines Angebots ist eine vorhandene Datenquelle erforderlich.
Nicht unterstützt Attribute Angebotsspezifische Attribute wie
long_tile, promotion_effective_timeperiod und
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 Shop-IDs, für die ein Angebot gilt,
wird umbenannt.
prduct_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, auf die ein Angebot
angewendet wird, 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 der Preis
eine Dezimalzahl in Form eines Strings.

Der Betrag für Preis wird jetzt in Mikroeinheiten,
, erfasst, wobei 1 Million Mikros der Standardeinheit
Ihrer Währung entsprechen.

Der Name des Feldes amount wurde von
in amountMicros.

Der Name des Felds 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.
Unter „Probleme“ finden Sie detailliertere Details. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}