Katalog

Versenden von Artikel-Updates

Verwende den Endpunkt /{catalog_id}/batch zum Versenden von Artikel-Updates.

Um Artikel in deinem Katalog zu erstellen, zu aktualisieren oder zu löschen, sende einen HTTP-POST-Aufruf an:

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

Parameter

Die Parameternamen für /{catalog_id}/batch und /{catalog_id}/items_batch ähneln sich möglicherweise auf den ersten Blick, sind aber völlig unterschiedlich.

Wir empfehlen, /{catalog_id}/items_batch API zu verwenden, die mehr Anwendungsfälle unterstützt und aktiv gepflegt wird.

Parameter Typ Beschreibung

allow_upsert

Boolescher Wert

Wenn allow_upsertfalse lautet, werden Update-Anfragen für Artikel, die sich nicht im Katalog befinden, nicht abgeschlossen. Ansonsten werden neue Artikel erstellt.

requests

Objekt

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

requests.data

Objekt

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

  • Wenn die Methode CREATE lautet, muss dieses Objekt alle erforderlichen Felder enthalten.
  • Wenn die Methode UPDATE lautet, kann es beliebige Felder enthalten.

Hinweis: Hier findest du die unterstützten Felder, die übergeben werden können.

requests.method

String

CREATE, UPDATE, DELETE

requests.retailer_id

String

Vom Werbetreibenden angegebene id für einen Artikel; nicht die FBID.

Die Methode UPDATE kann auch zum Erstellen von Artikeln verwendet werden, sofern sie noch nicht vorhanden sind.

Weitere Details findest du in der API-Referenz.

Einschränkungen

  • Der Parameter requests kann bis zu 5.000 Updates 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.
  • Die Batch-Größenbegrenzung beträgt 5000.
  • 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 für den /{catalog_id}/batch-Endpunkt.

Mehr dazu