Verwende diese Referenz, um die unterstützten Felder und die entsprechenden Beispiele für die Endpunkte POST /{catalog_id}/batch
und POST [/{catalog_id}/items_batch
anzuzeigen.
/{catalog_id}/batch
Diese Felder werden für die Methoden CREATE
und UPDATE
unterstützt.
Gib bei der Aktualisierung von Artikeln eine leere Zeichenfolge als Wert ein, um ein optionales Feld zu löschen. Durch Festlegen des Werts auf null
wird das Feld nicht gelöscht.
Feld | Beschreibung |
---|---|
Typ: Array<string> | Optional. URLs für bis zu 9-10 verschiedene Bilder. |
Typ: list<KeyValue:string,string> | Optional. Zusätzliche Eigenschaften, um das Produkt in seiner Variantengruppe zu unterscheiden. Beispiel: |
Typ: String | Erforderlich Gibt den Verfügbarkeitsstatus an:
|
Typ: String | Optional. Gruppe von Personen, die das gleiche oder ein ähnliches Alter aufweisen. Akzeptierte Werte sind |
Typ: Objekt<> | Optional. Links zu mobilen Apps. |
Typ: String | Optional, aber bei Advantage+ Catalog Ads empfohlen (kann zur Verbesserung der Anzeigenleistung beitragen). Optional für Instagram Shopping und Seiten-Shops, aber erforderlich, um Onsite-Checkout auf diesen Kanälen (nur in den USA) zu ermöglichen. Erforderlich für Marketplace (nur in den USA) Die Google-Produktkategorie (GPC) für den Artikel. Verwende den Taxonomie-Pfad oder die ID-Nummer der Kategorie aus dieser Liste. Wenn du Kaufabschluss auf Facebook und Instagram (nur in den USA) verwendest, wirkt sich die GPC eines Artikels auf die Steuern und Rückgaberichtlinie aus. Erfahre mehr über die Google-Produktkategorie für Katalogartikel, Hilfebereich für Werbung. Beispiel: |
Typ: String | Optional. Maximale Größe: 100. Artikelfarbe. |
Typ: String | Erforderlich. Zustand des Artikels: |
Typ: String | Erforderlich. Währung für den angegebenen Wert. Die Marketing API unterstützt alle Währungen, die von Werbekonten unterstützt werden. Verwende ISO 4217 für Währungsstandards. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. Gib eine leere Zeichenfolge an, um das Feld zu löschen. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. Gib eine leere Zeichenfolge an, um das Feld zu löschen. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. Gib eine leere Zeichenfolge an, um das Feld zu löschen. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. Gib eine leere Zeichenfolge an, um das Feld zu löschen. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. Gib eine leere Zeichenfolge an, um das Feld zu löschen. |
Typ: String | Erforderlich. Maximale Größe: 5.000. Kurze Beschreibung des Artikels. |
Typ: String | Optional. Geschlecht zur Größenbestimmung. Werte sind etwa |
Typ: String | Optional. Maximale Größe: 70. Die Global Trade Item Number kann |
Typ: String | Erforderlich. Link zum Artikelbild, das in der Anzeige verwendet wird. Gib korrekte Bildgrößen an. Für Advantage+ Catalog Ads mit einem Bild
Wenn das Bild außerhalb dieses Seitenverhältnisses liegt, schneidet Facebook es so zu, dass es dem minimalen oder maximalen Seitenverhältnis am nächsten kommt, je nach dem ursprünglichen Seitenverhältnis. Für Advantage+ Catalog Ads mit Carousel-Bild: mindestens erforderliche Auflösung ist 500 px * 500 px und Facebook schneidet es auf ein 1:1-Seitenverhältnis zu. Empfehlung: Vermeide häufige Änderungen der |
Typ: Zahl | Optional. Ganzzahl, die von Werbetreibenden verwendet werden kann, um Informationen über den Lagerstand zu speichern. |
Typ: String | N/A für Advantage+ Catalog Ads. Für den Handel optional. Gibt an, ob ein Artikel in einem Produkt-Launch verwendet wird. Unterstützte Werte:
|
Typ: String | Erforderlich. Maximale Größe: 100. Titel des Artikels. |
Typ: String | Optional Maximale Größe: 100. Muster oder Grafikdruck auf einem Artikel. |
Typ: Ganzzahl | Erforderlich. Der Preis multipliziert mit 100, für alle Währungen. Beispiel: 490 bedeutet bei Verwendung mit USD 4,90 $ und 49.000 bei Verwendung mit JPY 490 ¥. |
Typ: String | Optional. Maximale Größe: 750. Artikelkategorie nach Definition des Einzelhändlers. Beispiel: in TSV Heim und Garten > Küche und Essen > Geräte > Kühlschränke. Beispiel: in XML product_type > Heim und Garten > Küche und Essen > Geräte > Kühlschränke > product_type. |
Typ: String | Optional. Akzeptiert Strings. Werbetreibende können damit Produkte gruppieren. |
Typ: Ganzzahl | Optional. Reduzierter Preis, wenn der Artikel im Angebot ist. Dies ist der Aktionspreis multipliziert mit 100, für alle Währungen. Beispiel: 490 bedeutet bei Verwendung mit USD 4,90 $ und 49.000 bei Verwendung mit JPY 490 ¥. |
Typ: String | Optional. Enddatum und Uhrzeit für den Verkauf. Beispiel: |
Typ: String | Optional. Startdatum und Uhrzeit für den Verkauf.
|
Typ: Array<object> | Optional. Versandinformationen. |
Typ: String | Optional. Größe des Artikels. Beispiel: |
Typ: String | Erforderlich. Link zu Website des Händlers, auf der man den Artikel erwerben kann. |
Typ: String | Optional. Der ID des Verkäufers/Händlers, der den Artikel verkauft. |
/{catalog_id}/batch
{ "access_token": "<ACCESS_TOKEN>", "requests": [ { "method": "DELETE", "retailer_id": "retailer-1" }, { "method": "CREATE", "retailer_id": "retailer-2", "data": { "availability": "in stock", "brand": "Nike", "category": "t-shirts", "description": "product description", "image_url": "http://www.images.example.com/t-shirts/1.png", "name": "product name", "price": 1000, "currency": "USD", "shipping": [ { "country": "US", "region": "CA", "service": "service", "price_value": "10", "price_currency": "USD" } ], "condition": "new", "url":"http://www.images.example.com/t-shirts/1.png", "retailer_product_group_id": "product-group-1" }, "applinks": { "android": [{ "app_name": "Electronic Example Android", "package": "com.electronic", "url": "example-android://electronic" }], "ios": [{ "app_name": "Electronic Example iOS", "app_store_id": 2222, "url": "example-ios://electronic" }] }, }, { "method": "UPDATE", "retailer_id": "retailer-3", "data": { "availability": "out of stock", } } ] }
/{catalog_id}/batch
Ein oder mehrere Handles werden zurückgegeben.
"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch
/{catalog_id}/items_batch
Für kommerzielle Kataloge – Verwende diese API, wenn du Produktinformationen häufiger als einmal pro Stunde aktualisieren musst (verwende andernfalls die Feed API). Du kannst mehrere Objekte über eine einzelne HTTP-Anfrage aktualisieren.
Diese Produktfelder werden für die Methoden CREATE
und UPDATE
unterstützt, für Version 3.3 und 3.2:
Feld | Beschreibung |
---|---|
Typ: Array<string> | Optional. Link für bis zu 9–10 verschiedene Bilder. |
Typ: list<KeyValue:string,string> | Optional. Zusätzliche Attribute, um das Produkt in seiner Variantengruppe zu unterscheiden. Beispiel: |
Typ: String | Optional. Gruppe von Personen, die das gleiche oder ein ähnliches Alter aufweisen. Akzeptierte Werte sind |
Typ: Objekt<string> | Optional. Links zu mobilen Apps. Beispiel: "applink" : { "ios_url": "example-ios://electronic", "ios_app_store_id": "42", "ios_app_name": "Electronic Example iOS", "iphone_url": "example-iphone://electronic", "iphone_app_store_id": "43", "iphone_app_name": "Electronic Example iPhone", "ipad_url": "example-ipad://electronic", "ipad_app_store_id": "44", "ipad_app_name": "Electronic Example iPad", "android_url": "example-android://electronic", "android_package": "com.electronic", "android_class": "com.electronic.Example", "android_app_name": "Electronic Example Android", "windows_phone_url": "example-windows://electronic", "windows_phone_app_id": "64ec0d1b-5b3b-4c77-a86b-5e12d465edc0", "windows_phone_app_name": "Electronic Example Windows", } |
Typ: String | Erforderlich. Gibt den Verfügbarkeitsstatus an:
|
Typ: String | Optional. Maximale Größe: 100. Artikelfarbe. |
Typ: String | Erforderlich. Produktzustand: |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. |
Typ: String | Optional. Maximale Größe: 100. Zusätzliche Informationen zu diesem Artikel. |
Typ: String | Erforderlich. Maximale Größe: 5.000. Kurzer Text zur Produktbeschreibung. |
Typ: Array<string> | Optional. Liste der Funktionen, die deaktiviert werden sollen. Mögliche Werte sind: |
Typ: String | Optional. Geschlecht zur Größenbestimmung. Werte sind etwa |
Typ: String | Optional. Max. Größe: 250. Vordefinierte Werte (String oder Kategorie-ID) aus der Produkttaxonomie von Google. Beispiel: Bekleidung und Accessoires > Kleidung > Dresses oder 2271. |
Typ: String | Optional. Maximale Größe: 70. Global Trade Item Number (GTIN) kann |
Typ: String | Erforderlich. Händler-ID |
Typ: Array <object> | URLs und Tags für Bilder, die in deinen Anzeigen oder in Shops verwendet werden sollen. Unterstützt bis zu 20 verschiedene Bilder. Schlagwörter sind optional und sollten, wenn verwendet, beschreiben, was auf dem Bild zu sehen ist. Beispiel: "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['Swimming pool','Gym'], } ] |
Typ: String | Nicht erforderlich, wenn Wir empfehlen, stattdessen Link zum Artikelbild, das in der Anzeige verwendet wird. Gib korrekte Bildgrößen an. Für Advantage+ Catalog Ads mit einem Bild:
Für Advantage+ Catalog Ads mit Carousel-Bild: minimale erforderliche Bildauflösung ist 500 px * 500 px und Facebook schneidet es auf ein 1:1-Seitenverhältnis zu. |
Typ: Array <object> | URLs und Tags für Videos, die in deinen Anzeigen oder in Shops verwendet werden sollen. Unterstützt bis zu 30.000 Videos auf Katalogebene. Schlagwörter sind optional und sollten, wenn verwendet, beschreiben, was im Video enthalten ist. Die maximale Größe für ein Video-Datei beträgt 200 MB. Unterstützte Formate sind etwa .3g2, .3gp, .3gpp, .asf, .avi, .dat, .divx, .dv, .f4v, .flv, .gif, .m2ts, .m4v, .mkv, .mod, .mov, .mp4, .mpe, .mpeg, .mpeg4, .mpg, .mts, .nsv, .ogm, .ogv, .qt, .tod, .ts, .vob und .wmv Beispiel: "video": [ { "url":"http://example.com/video_1.mp4", "tag": ['Swimming pool','Gym'], } ] Hinweis: Um Video 1 zu löschen, wenn das Produkt Video 1 und 2 hat, entferne Video 1 aus dem Array: [ { "method": "UPDATE", "data": { "video": [ { "url": "https://google.com/video_2.mp4", "tag": ["video_2"] } ] } } ] Um alle Videos zu löschen, sende ein leeres Array: [ { "method": "UPDATE", "data": { "video": [] } } ] |
Typ: Objekt | Optional. Ganzzahl, die von Werbetreibenden verwendet werden kann, um Informationen über den Lagerstand zu speichern. |
Typ: String | Optional. Die von dem Werbetreibenden bereitgestellte ID einer Produktgruppe; nicht die FBID. Akzeptiert Strings. Wird von Werbetreibenden verwendet, um eine Vielzahl von unterschiedlichen Objekten (Produktartikel, Fahrzeuge, Hotels, Flüge usw.) zu gruppieren. |
Typ: String | Erforderlich. Link zu Website des Händlers, auf der man den Artikel erwerben kann. |
Typ: String | Optional. Eindeutige Hersteller-ID für das Produkt. |
Typ: String | Optional. Maximale Größe: 100. Muster oder Grafikdruck auf einem Produkt. |
Typ: String | Erforderlich. Preis des Artikels. Formatiere den Preis als die Kosten gefolgt vom dreistelligen ISO-Währungscode mit einem Leerzeichen zwischen dem Betrag und der Währung. Beispiel: |
Typ: Array<string> | Maximale Array-Größe: 5.000. Maximale Einzel-Tag-Größe: 110 Zeichen. Array technischer Tags, die auf ein Produkt angewendet werden können, um Produktpaletten zu erstellen. Der Inhalt dieses Felds wird Kund*innen niemals angezeigt; daher wird keine Integritätsprüfung ausgelöst. Verwende nur kleine Buchstaben, voran- und nachgestellte Leerzeichen sind nicht erlaubt. Beispiel: |
Typ: String | Optional, aber erforderlich, um die Overlay-Funktion für Advantage+ Catalog Ads zu verwenden. Reduzierter Preis, wenn der Artikel im Angebot ist. Formatiere den Preis als die Kosten gefolgt vom dreistelligen ISO-Währungscode mit einem Leerzeichen zwischen dem Betrag und der Währung. Beispiel: |
Typ: String | Optional. Start- und Enddatum und -uhrzeit für den Verkauf, durch einen Schrägstrich getrennt. Schreibe die Start- und Enddaten im Format JJJJ-MM-TT. Füge nach jedem Datum „T“ hinzu und gib dann die Uhrzeit an. Schreibe die Zeit im 24-Stunden-Format (0:00 bis 23:59). Beispiel: |
Typ: String | Optional. Blob mit unterschiedlichen Preisen für jedes Land und jede Region. Die einzelnen Regionen werden mit Kommas getrennt. Die Formatierung sollte wie folgt sein:
|
Typ: String | Optional. Größe des Artikels. Beispiel: |
Typ: String | Erforderlich. Maximale Größe: 100. Titel des Artikels. |
Die Methode UPDATE
kann auch zum Erstellen von Artikeln verwendet werden, sofern sie noch nicht vorhanden sind.
Erfahre mehr über Produktfelder in der API-Referenz.
PRODUCT_ITEM
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "PRODUCT_ITEM", "requests": [ { "method": "DELETE", "data": { "id": "retailer-1" } }, { "method": "CREATE", "data": { "id": "retailer-2", "applink" : { "ios_url":"example-ios://electronic", "ios_app_store_id":"42", "ios_app_name":"Electronic Example iOS", "iphone_url":"example-iphone://electronic", "iphone_app_store_id":"43", "iphone_app_name":"Electronic Example iPhone", "ipad_url":"example-ipad://electronic", "ipad_app_store_id":"44", "ipad_app_name":"Electronic Example iPad", "android_url":"example-android://electronic", "android_package":"com.electronic", "android_class":"com.electronic.Example", "android_app_name":"Electronic Example Android", "windows_phone_url":"example-windows://electronic", "windows_phone_app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0", "windows_phone_app_name":"Electronic Example Windows", }, "availability": "in stock", "brand": "Nike", "google_product_category": "t-shirts", "description": "product description", "image_link": "http://www.images.example.com/t-shirts/1.png", "title": "product name", "price": "10.00 USD", "shipping": [ { "shipping_country": "US", "shipping_region": "CA", "shipping_service": "service", "shipping_price_value": "10", "shipping_price_currency": "USD" } ], "condition": "new", "link":"http://www.images.example.com/t-shirts/1.png", "item_group_id": "product-group-1" } }, { "method": "UPDATE", "data": { "availability": "out of stock", "id": "retailer-3", } } ] }
PRODUCT_ITEM
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Erfahre mehr über das Hinzufügen von Katalogartikeln mit einem Datenfeed.
Produktfelder, die für die Methoden CREATE
und UPDATE
für Typ HOTEL
für Version 3.2 unterstützt werden:
Feld | Beschreibung |
---|---|
Typ: Objekt<string> | Erforderlich. Adresse des Hotels. |
Typ: | Optional. Links zu mobilen Apps. |
Typ: String | Erforderlich. Basispreis für das Hotelzimmer pro Übernachtung. Füge den Währungstyp zum Preis hinzu. Formatiere den Preis als die Kosten gefolgt vom ISO-Währungscode mit einem Leerzeichen zwischen dem Betrag und der Währung. Beispiel: |
Typ: String | Optional. Marke der Hotelkette. |
Typ: String | Erforderlich. Maximale Zeichengrenze: 5.000. Kurze Beschreibung des Hotels. |
Typ: Array<object> | Optional. Gastbewertungen des Hotels. |
Typ: String | Erforderlich. Eindeutige ID für das Hotel. |
Typ: Array<object> | Erforderlich. URLs und Tags für Bilder, die in den Anzeigen verwendet werden sollen. Unterstützt bis zu 20 Bilder. Tag ist optional, wenn verwendet. Sollte beschreiben, was auf dem Bild zu sehen ist. Beispiel: |
Typ: String | Erforderlich. Breitengrad des Hotels. |
Typ: String | Erforderlich. Längengrad des Hotels. |
Typ: String | Optional. Treueprogramm für das Hotel. |
Typ: String | Optional. Indikator für die Gewinnspanne des Hotels; Wert von |
Typ: String | Erforderlich. Name des Hotels. |
Typ: Array<string> | Optional. Ein oder mehrere Stadtteile für das Hotel. Beispiel: |
Typ: String | Optional. Telefonnummer mit Ländervorwahl. |
Typ: String | Optional. Aktionspreis pro Nacht im Hotel. Bewirb damit Rabatte auf den regulären Hotelpreis. Erforderlich: Füge die Währungsart zum Preis hinzu. Formatiere den Preis als die Kosten gefolgt vom ISO-Währungscode mit einem Leerzeichen zwischen dem Betrag und der Währung. Beispiel: |
Typ: String | Optional. Sternebewertung des Hotels. Die Nummer sollte zwischen |
Typ: String | Erforderlich. Link zur externen Webseite, auf der das Hotelzimmer gebucht werden kann. |
Die Methode UPDATE
kann auch zum Erstellen von Artikeln verwendet werden, sofern sie noch nicht vorhanden sind.
HOTEL
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "HOTEL", "requests": [ { "method": "DELETE", "data": { "hotel_id": "hotel-1" } }, { "method": "CREATE", "data": { "hotel_id": "1234", "brand": "Premium_brand", "description": "A very nice hotel", "name": "The best hotel", "base_price": "100.00 USD", "longitude":"42.10", "latitude":"42.10", "address": { "addr1":"100 Main Street", "city":"North Pole", "region":"ABC", "country":"US", "postal_code":"11111" }, "guest_rating" : [ { "rating_system":"tripAdvisor", "score":"7.8", "number_of_reviewers":"300", "max_score":"10", }, { "rating_system":"Yelp", "score":"5.1", "number_of_reviewers":"123", "max_score":"10", }, ], "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['Swimming pool','Gym'], } ], "applink" : { "ios_url":"example-ios://electronic", "ios_app_store_id":"42", "ios_app_name":"Electronic Example iOS", "iphone_url":"example-iphone://electronic", "iphone_app_store_id":"43", "iphone_app_name":"Electronic Example iPhone", "ipad_url":"example-ipad://electronic", "ipad_app_store_id":"44", "ipad_app_name":"Electronic Example iPad", "android_url":"example-android://electronic", "android_package":"com.electronic", "android_class":"com.electronic.Example", "android_app_name":"Electronic Example Android", "windows_phone_url":"example-windows://electronic", "windows_phone_app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0", "windows_phone_app_name":"Electronic Example Windows", }, "loyalty_program":"Premium_program", "margin_level": "8", "phone":"+61 2-96027455", "star_rating":"4", "url":"http://www.images.example.com/t-shirts/1.png" } }, { "method": "UPDATE", "data": { "base_price": "90.00 USD", "hotel_id": "hotel-3", } } ] }
HOTEL
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Diese Produktfelder werden für die Methoden CREATE
und UPDATE
für den Typ HOTEL_ROOM
für Version 3.2 unterstützt.
Feld | Beschreibung |
---|---|
Typ: String | Erforderlich. Basispreis für 1 Nacht. Die Währung sollte den ISO 4217-Währungscodes entsprechen. Beispiel: |
Typ: String | Erforderlich. Maximale Größe: 5.000. Kurze Zimmerbeschreibung. |
Typ: String | Erforderlich. Eindeutige ID für Hotel-Einzelhändler. |
Typ: String | Erforderlich. Eindeutige ID für Hotel. |
Typ: Array<object> | Erforderlich. Bilder des Zimmers. |
Typ: String | Erforderlich. Maximale Größe: 100. Name des Zimmers. |
Typ: String | Erforderlich. Link zur Website des Werbetreibenden, auf der man den Aufenthalt buchen kann. |
Die Methode UPDATE
kann auch zum Erstellen von Artikeln verwendet werden, sofern sie noch nicht vorhanden sind.
HOTEL_ROOM
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "HOTEL_ROOM", "requests": [ { "method": "DELETE", "data": { "hotel_retailer_id": "1234", "hotel_room_id": "room-1", } }, { "method": "CREATE", "data": { "hotel_retailer_id": "1234", "hotel_room_id": "room-2", "description": "product description", "name": "product name", "base_price": "100 USD", "url": "http://www.example.com/t-shirts/1.html", "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['Swimming pool','Gym'], } ] }, { "method": "UPDATE", "data": { "hotel_retailer_id": "1234", "hotel_room_id": "room-3", "base_price": "120 USD", } } ] }
HOTEL_ROOM
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Diese Produktfelder werden für die Methoden CREATE
und UPDATE
für den Typ FLIGHT
für Version 3.2 unterstützt.
Feld | Beschreibung |
---|---|
Typ: String | Optional. Maximale Zeichengrenze: 5.000. Beschreibung des Flugs. |
Typ: String | Erforderlich. Zielflughafen für den Flug. Sollte als IATA-Code angegeben werden. Beispiel: |
Typ: String | Optional. Name des Zielorts des Flugs. |
Typ: Array<object> | Erforderlich. URLs und Tags für Bilder, die in den Anzeigen verwendet werden sollen. Unterstützt bis zu 20 Bilder. Tag ist optional. Wenn er verwendet wird, sollte er beschreiben, was im Bild enthalten ist. Beispiel: |
Typ: String | Erforderlich. Abflughafen für den Flug. Sollte als IATA-Code angegeben werden. Beispiel: |
Typ: String | Optional. Name des Abflugorts. |
Typ: String | Optional. Die Kosten und Währung des Flugs. Der Preis ist eine Zahl, gefolgt vom Währungscode. Verwende ISO 4217-Standards. Verwende ""."" als Dezimalzahl für den Preis. |
Typ: String | Optional. Link zu der Website, auf der du den Flug buchen kannst. |
Die Methode UPDATE
kann auch zum Erstellen von Artikeln verwendet werden, sofern sie noch nicht vorhanden sind.
FLIGHT
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "FLIGHT", "requests": [ { "method": "DELETE", "data": { "origin_airport": "BOS", "destination_airport": "JFK", } }, { "method": "CREATE", "data": { "origin_airport": "BOS", "destination_airport": "SFO", "description": "Best Flight to SFO", "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['City'], }, { "url":"http://example.com/some.image_2.jpg", "tag": ['Food'], } ], "price":"100.00 USD", } }, { "method": "UPDATE", "data": {
FLIGHT
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Diese Produktfelder werden für die Methoden CREATE
und UPDATE
für Typ DESTINATION
für Version 3.2 unterstützt.
Feld | Beschreibung |
---|---|
Typ: Objekt<string> | Optional. Links zu mobilen Apps. |
Typ: Objekt<string> | Erforderlich. Adresse des Hotels. |
Typ: String | Optional. Maximale Zeichengrenze: 5.000. Kurze Beschreibung des Reiseziels. |
Typ: String | Erforderlich. Maximale Zeichengrenze: 100. Eindeutige ID für das Ziel. |
Typ: Array<object> | Erforderlich. URLs und Tags für Bilder, die in den Anzeigen verwendet werden sollen. Unterstützt bis zu 20 Bilder. Tag ist optional. Wenn er verwendet wird, sollte er beschreiben, was im Bild enthalten ist. Beispiel: |
Typ: String | Erforderlich. Breitengrad des Zielorts. |
Typ: String | Erforderlich. Breitengrad des Zielorts. |
Typ: String | Erforderlich. Name des Zielorts. |
Typ: Array<string> | Optional. Maximale Anzahl erlaubter Stadtteile: 20. Mindestens ein Stadtteil für das Reiseziel. Beispiel: |
Typ: String | Optional. Günstigster Durchschnittspreis und Währung für den Zielort. Formatiere den Preis als Zahl, gefolgt vom Währungscode. Verwende ISO 4217-Standards. Verwende ""."" als Dezimalzahl für den Preis. |
Typ: String | Optional. Preisänderung. Kann zum Erstellen von Produktpaletten und in der Anzeigengestaltung genutzt werden:
Beispiel: „durchschnittlicher Preis in NYC um X gesunken“ oder „durchschnittlicher Preis in NYC gesunken“ |
Typ: Array<string> | Erforderlich. Maximale Anzahl von Zielorttypen: 20. Art(en) von Zielorten. Ein Zielort kann mehrere Typen aufweisen. Beispiel: |
Typ: String | Erforderlich. Link zur Website, auf der der Zielort gebucht werden kann. |
Die Methode UPDATE
kann auch zum Erstellen von Artikeln verwendet werden, sofern sie noch nicht vorhanden sind.
DESTINATION
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "DESTINATION", "requests": [ { "method": "DELETE", "data": { "destination_id": "destination-1" } }, { "method": "CREATE", "data": { "destination_id": "123456789", "description": "My destination is the best.", "name": "The best destination", "price": "199.00 USD", "price_change": "-20", "longitude":"-122.4424", "latitude":"37.7712", "image": [ { "url":"http://example.com/image_1.jpg", "tag": ['City','Package'], }, { "url":"http://example.com/some.image_2.jpg", "tag": ['Tour','Landmark'], } ], "address": { "addr1":"1 Market Street", "city":"San Francisco", "region":"California", "country":"United States", "postal_code":"94117" }, "applink" : { "ios_url":"example-ios://travelapp", "ios_app_store_id":"42", "ios_app_name":"Travel App iOS", "iphone_url":"example-iphone://travelapp", "iphone_app_store_id":"43", "iphone_app_name":"Travel App iPhone", "ipad_url":"example-ipad://travelapp", "ipad_app_store_id":"44", "ipad_app_name":"Travel App iPad", "android_url":"example-android://travelapp", "android_package":"com.travelapp", "android_class":"com.travelapp.Example", "android_app_name":"Travel App Android", "windows_phone_url":"example-windows://travelapp", "windows_phone_app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0", "windows_phone_app_name":"Travel App Windows", }, "type":["city","culture"], "neighborhood":["Mission","SoMa"], "url":"http://www.thebestdestination.com" } }, { "method": "UPDATE", "data": { "price": "159.99", "destination_id": "destination-3", } } ] }
DESTINATION
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Diese Produktfelder werden für die Methoden CREATE
und UPDATE
für Typ HOME_LISTING
für Version 3.3 und 3.2 unterstützt.
Feld | Beschreibung |
---|---|
Typ: Objekt<string> | Optional. Links zu mobilen Apps. |
Typ: Objekt<string> | Erforderlich. Adresse des Immobilienangebots. |
Typ: String | Erforderlich. Aktuelle Verfügbarkeit der Unterkunft. Unterstützte Werte: |
Typ: Array<object> | Optional. Preiskonfigurationen |
Typ: String | Optional. Maximale Zeichengrenze: 5.000. Kurzer Absatz, in dem das Immobilienangebot beschrieben wird. |
Typ: Array<object> | Erforderlich. URLs und Tags für Bilder, die in den Anzeigen verwendet werden sollen. Unterstützt bis zu 20 Bilder. Tag ist optional. Wenn er verwendet wird, sollte er beschreiben, was im Bild enthalten ist. Beispiel: |
Typ: String | Optional. Breitengrad des Immobilieninserats. |
Typ: String | Optional. Längengrad des Immobilieninserats. |
Typ: String | Optional. Art der Anzeige. Unterstützte Werte: |
Typ: String | Erforderlich. Name des Immobilieninserats. |
Typ: Array<object> | Optional. Stadtteil für das Immobilieninserat. Max. zulässige Stadtteile: 20 |
Typ: String | Optional. Anzahl der Badezimmer. |
Typ: String | Optional. Anzahl der Schlafzimmer. |
Typ: String | Optional. Anzahl der verfügbaren Einheiten. Nur für Wohnungen zu verwenden, die zur Vermietung zur Verfügung stehen. |
Typ: String | Erforderlich. Preis und Währung für das Immobilieninserat. Der Preis ist eine Zahl, gefolgt vom Währungscode. Verwende ISO 4217-Standards. Verwende ""."" als Dezimalzahl für den Preis. |
Typ: String | Optional. Preisänderung. Kann zum Erstellen von Produktpaletten und in der Anzeigengestaltung genutzt werden:
Beispiel: „durchschnittlicher Preis in NYC um X gesunken“ oder „durchschnittlicher Preis in NYC gesunken“ |
Typ: String | Optional. Art der Immobilie. Unterstützte Werte: |
Typ: String | Erforderlich. Link zur Website, auf der das Inserat zu finden ist. |
Typ: String | Optional. Jahr, in dem das Haus erbaut wurde. |
Die Methode UPDATE
kann auch zum Erstellen von Artikeln verwendet werden, sofern sie noch nicht vorhanden sind.
HOME_LISTING
{ "access_token": "<ACCESS_TOKEN>", "item_type": "HOME_LISTING", "requests": [ { "method": "DELETE", "data": { "home_listing_id": "home-listing-1" } }, { "method": "CREATE", "data": { "home_listing_id": "12345678", "availability": "for_sale", "description": "An amazing listing", "name": "1 Hacker Way, Menlo Park, CA 94025", "price": "110000 USD", "longitude":"1.11414", "latitude":"-1.835003", "address": { "addr1":"1 Hacker Way", "city":"Menlo Park", "region":"California", "country":"United States", "postal_code":"94025" }, "neighborhood":["Menlo Oaks"], "image": [ { "url":"http://img10.naventcdn.com/avisos/18/00/52/30/31/52/1200x1200/63590918.jpg", }, ], "listing_type": "for_sale_by_agent", "num_baths":"6", "num_beds":"5", "num_units":"1", "property_type":"house", "year_built":"2007", "available_dates_price_config" : [ { "start_date":"2020-11-15", "end_date":"2020-12-15", "rate":"10000", "currency":"USD", "interval":"nightly", }, { "start_date":"2020-11-15", "end_date":"2020-12-15", "rate":"50000", "currency":"USD", "interval":"weekly", }, ], "applink" : { "ios_url":"example-ios://travelapp", "ios_app_store_id":"42", "ios_app_name":"Travel App iOS", "android_url":"example-android://travelapp", "android_package":"com.travelapp", "android_class":"com.travelapp.Example", "android_app_name":"Travel App Android", }, "url":"http://www.example.com/link_to_listing" } }, { "method": "UPDATE", "data": { "price": "100000 USD", "home_listing_id": "home-listing-3", } } ] }
HOME_LISTING
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
Unterstützte Felder für die Methoden CREATE
und UPDATE
für den Typ VEHICLE
findest du unter Felder für Automobilbestandskatalog – Fahrzeug.
Unterstützte Felder sind für Fahrzeug und Autohändler verfügbar.
Die Methode UPDATE
kann auch zum Erstellen von Artikeln verwendet werden, sofern sie noch nicht vorhanden sind.
VEHICLE
curl \ -d @body.json \ -H "Content-Type: application/json" { "access_token": "<ACCESS_TOKEN>", "item_type": "VEHICLE", "requests": [ { "method": "DELETE", "data": { "vehicle_id": "vehicle-1" } }, { "method": "CREATE", "data": { "vehicle_id": "i2 2017 Ford Fusion", "availability": "AVAILABLE", "make": "Ford", "model": "Fusion", "year": "2017", "mileage": { "value": "1500", "unit": "KM", }, "image": [ { "url":"http://www.facebook.com/teapic.jpg", "tag":["Car"], }, ], "fuel_type":"gasoline", "body_style":"sedan", "drivetrain":"FWD", "vin":"1FADP5AU6DL536022", "condition":"EXCELLENT", "description": "Turbocharged! Gasoline!", "title": "SE Ford Certified and 6-Speed Automatic.", "price": "18000 USD", "exterior_color":"white", "sale_price":"16000 USD", "state_of_vehicle":"new", "longitude":"52.35", "latitude":"42.1", "address": { "addr1":"550 Auto Center Dr", "city":"Watsonville", "region":"CA", "country":"US", "postal_code":"96075" }, "url":"http://www.example.com/test" } }, { "method": "UPDATE", "data": { "price": "16000 USD", "vehicle_id": "vehicle-3", } } ] }
VEHICLE
{ // One or more handles will be returned"handles": ["AczwaOW7j_EuQ5peV3kGq8X9qc7cDiv_kFrrHkdKuG7LkpkkqK5939wgdoduSQ45FGK5vKdVqOaSDJEun-fvbsR1kk8Rd53AZyD1WThSemo26Q"] }
/{catalog_id}/localized_items_batch
Siehe die Liste mit unterstützten Feldern und entsprechenden Beschreibungen für die einzelnen Felder für den Endpunkt /{catalog_id}/localized_items_batch
:
Siehe die vollständige Liste von im Katalog unterstützten Feldern.
/{catalog_id}/batch
/{catalog_id}/items_batch
/{catalog_id}/check_batch_request_status
/{catalog_id}/localized_items_batch