Angebotsverwaltung migrieren

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

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 mit Merchant Promotions verglichen. API für angebotsbezogene Anfragen.

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 sehen Sie einen Vergleich der Verfügbarkeitsmethoden für Werbemethoden in der Content API für Shopping und die 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 finden Sie unter Lokale 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
Sie können damit auch Attribute des Feeds einreichen,
Spezifikation in ihrer generischen Form an.
Hier einige Beispiele: 
{
  "name": "size type", "value": "regular"
}
Dies ist nützlich, um Attribute einzureichen, 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, z. B.
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
to wurde umbenannt.
store_id store_id_inclusion Die Liste der Händler-IDs, für die ein Angebot gilt
in wird umbenannt.
prduct_type product_type_inclusion Die Liste der Produkttypen, für die ein Angebot gilt
in wird umbenannt.
item_group_id item_group_id_inclusion Die Liste der Artikelgruppen-IDs, für die ein Angebot gilt
in wird umbenannt.
brand brand_inclusion Die Liste der Marken, für die ein Angebot gilt
in wird umbenannt.
store_code store_codes_inclusion Die Liste der Geschäftscodes, auf die ein Angebot angewendet wird
in wird umbenannt. 
price: {
  object (Price)
}

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

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

Der Betrag für Price wird jetzt in Mikros festgehalten,
wobei 1 Million Millionstel dem Währungssymbol
Standardeinheit.

Der Name des Feldes amount wurde von "value" zu "value" geändert.
amountMicros.

Der Name des Felds currency wurde geändert in
currencyCode enthalten. 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
}
<ph type="x-smartling-placeholder"></ph> Der Status der Werbeaktion hat sich geändert.
In den Problemen 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,
    ]
    }
  ]
}