Katalog

Batch mit lokalisierten Objekten senden

Verwende den Endpunkt /{catalog_id}/localized_items_batch zum Versenden von Lokalisierungs-Updates.

Wenn du lokalisierte Produkte in deinem Katalog erstellen, aktualisieren oder löschen möchtest, sende einen HTTP-POST-Aufruf an:

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/localized_items_batch?requests=<REQUESTS>

Parameter

Parameter Typ Beschreibung

item_type

Enumerator

Art der Objekte in der Anforderung. Unterstützte Werte: DESTINATION, FLIGHT, HOME_LISTING, HOTEL, HOTEL_ROOM, PRODUCT_ITEM, VEHICLE, VEHICLE OFFER.

requests

Objekt

Ein JSON-Objekt, das sämtliche Anfragen enthält.

requests.data

Objekt

Ein JSON-Objekt, das Felder und Werte für ein Produkt enthält.

Bei der Methode CREATE darf dieses Objekt nur lokalisierte Felder für den angegebenen item_type enthalten.

requests.method

String

CREATE, UPDATE, DELETE

requests.localization

Objekt

Ein JSON-Objekt mit den Lokalisierungsdaten, die du auf das angegebene Katalogobjekt anwenden möchtest. Dieses Objekt muss die folgenden Felder enthalten:

  • type – unterstützte Werte: LANGUAGE, COUNTRY oder LANGUAGE_AND_COUNTRY.
  • value: Hierbei kann es sich je nach ausgewähltem Typ um eine beliebige gültige Sprache bzw. einen beliebigen gültigen Ländercode handeln. Beachte, dass bei LANGUAGE_AND_COUNTRY die Werte mit dem Zeichen '|' getrennt werden sollten, z. B. en_XX|US. Hier findest du eine Liste der Sprachen- und Ländercodes.

Das Setup des lokalisierten Katalogs enthält die Liste der unterstützten Sprachen und Länder für Katalogüberschreibungen und Beispiele von Überschreibungstypen und -werten bei der Lokalisierung nach LANGUAGE, COUNTRY ODER LANGUAGE_AND_COUNTRY. Eine Liste der unterstützten Katalogfelder findest du unter Unterstützte Felder – Lokalisierte Kataloge.

Hinweis: price, sale_price, unit_price, base_price, status (Sichtbarkeit) und availability dürfen nur in einem Länderfeed angegeben werden. Diese Felder dürfen nicht in einem Sprachfeed angegeben werden. So kann sichergestellt werden, dass Kund*innen die richtigen lokalisierten Produktdaten angezeigt werden.

Einschränkungen

  • Der Parameter requests kann bis zu 1.000 Artikel enthalten.
  • Für jeden Katalog kannst du eine Anzahl von Aufrufen pro Stunde tätigen, die durch die Durchsatzratenbegrenzungsformel für geschäftliche Anwendungsfälle von Catalog Batch definiert wird. Nimm Kontakt zu uns auf, wenn das nicht reicht.
  • Fehlercode 1 mit der Meldung "Please reduce the amount of data you're asking for, then retry your request" zeigt an, dass die Größe der in der API-Anforderung empfangenen Daten (in Bytes) zu groß ist. Um dieses Problem zu beheben, reduziere die Anzahl der Elemente im Stapel und versuche es erneut. Dadurch wird sichergestellt, dass die Anfrage innerhalb der zulässigen Größengrenzen liegt und erfolgreich bearbeitet werden kann.

Unterstützte Felder

Siehe die Liste der unterstützten Felder und entsprechenden Beschreibungen für die einzelnen Felder für den Endpunkt /{catalog_id}/localized_items_batch:

Siehe auch

Beispiel

Beispielanfrage

POST /{catalog_id}/*localized_items_batch*
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "localization": {
        "type": "LANGUAGE",
        "value": "fr_XX"
      },
       "data": {
         "id": "retailer-2",
         "title": "C'est un tshirt",
         "description": "Le t-shirt a un joli motif",
         "link": "http://www.fr.example.com/t-shirts/1.png"
       }
    },
    {
      "method": "CREATE",
      "localization": {
        "type": "COUNTRY",
         "value": "FR"
      },
       "data": {
         "id": "retailer-2",
         "availability": "in stock",
         "price": "9.99 EUR"
       }
    },
    {
      "method": "UPDATE",
      "localization": {
        "type": "LANGUAGE",
        "value": "fr_XX"
      },
      "data": {
        "id": "retailer-3",
        "availability": "out of stock",
        "link": "http://www.fr.example.com/t-shirts/2.png"
      }
    },
    {
      "method": "UPDATE",
      "localization": {
        "type": "COUNTRY",
        "value": "FR"
      },
      "data": {
        "id": "retailer-3",
        "price": "19.99 USD"
      }
    },
    {
      "method": "DELETE",
      "localization": {
        "type": "COUNTRY",
        "value": "FR"
      },
      "data": {
        "id": "retailer-4"
      }
    }
  ]
}

Beispielantwort

"handles": ["AczBWxwCxXv4s3xQpm0JwXBlhs-IPGatrWmDRBmc1wTYrV5JvtkuQRT_FOCmKZGmHvotvvX8UtQnwEgg16wTx14cqPYzWVzmxZiaZDLgMUmjSA"]

Dieser Endpunkt erstellt keine neuen Katalogobjekte. Alle Anforderungen müssen ein JSON-Datenobjekt enthalten, das wiederum eine ID für ein vorhandenes Katalogobjekt enthält.

Du kannst über das Feld applink Deeplink-Informationen angeben. Es funktioniert ähnlich wie Deeplinks. Stelle deine Deeplink-Informationen im unten aufgeführten JSON-Format bereit.

"applink" : {"ios": [{"url":"example-ios://electronic","app_store_id":42,"app_name":"Electronic Example iOS"}],"iphone": [{"url":"example-iphone://electronic","app_store_id":43,"app_name":"Electronic Example iPhone"}],"ipad": [{"url":"example-ipad://electronic","app_store_id":44,"app_name":"Electronic Example iPad"}],"android": [{"url":"example-android://electronic","package":"com.electronic","class":"com.electronic.Example","app_name":"Electronic Example Android",}],"windows_phone": [{"url":"example-windows://electronic","app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0","app_name":"Electronic Example Windows"}]}

Gegenüber den Feldnamen bei Deeplinks gibt es einen kleinen Unterschied, da jeder App-Typ einen eigenen Knoten darstellt und in seinem jeweiligen Feld steht.

'data\[applink\]\[android\]' stellt ein Array dar, für das nur ein Wert festgelegt wurde. Dies ist auch bei anderen App-Typen der Fall.

iOS Universal Links werden nicht unterstützt.

Zur Lokalisierung von applink-Feldern musst du sämtliche Felder angeben. Erfahre mehr über Deep Links für Produkte.

Mehr dazu