Catalogue

Envoi d’un lot d’articles localisés

Pour envoyer des mises à jour de localisation, utilisez le point de terminaison /{catalog_id}/localized_items_batch.

Pour créer, mettre à jour ou supprimer des produits localisés dans votre catalogue, effectuer un appel HTTP POST à :

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

Paramètres

Paramètre Type Description

item_type

énumération

Type d’articles dans la demande. Valeurs prises en charge : DESTINATION, FLIGHT, HOME_LISTING, HOTEL, HOTEL_ROOM, PRODUCT_ITEM, VEHICLE, VEHICLE OFFER

requests

objet

Objet JSON contenant toutes les demandes.

requests.data

objet

Objet JSON contenant des champs et des valeurs pour un produit.

Lorsque la méthode est CREATE, cet objet doit contenir uniquement les champs localisés pour le item_type spécifié.

requests.method

chaîne

CREATE, UPDATE, DELETE

requests.localization

objet

Objet JSON contenant les données de localisation que vous souhaitez appliquer à l’article de catalogue spécifié. Cet objet doit contenir les champs suivants :

  • type : les valeurs prises en charge sont LANGUAGE, COUNTRY ou LANGUAGE_AND_COUNTRY
  • value : toute langue ou tout code pays valide, en fonction du type sélectionné. Notez que pour LANGUAGE_AND_COUNTRY, les valeurs doivent être séparées par un caractère '|' (par exemple en_XX|US). Voir la liste de codes de langue et indicatifs pays ici.

La Configuration des catalogues localisés contient les listes des langues et pays pris en charge pour les remplacements de catalogue, ainsi que des exemples de types et de valeurs de remplacement lors de la localisation par LANGUAGE, COUNTRY OU LANGUAGE_AND_COUNTRY. Consultez la section Champs pris en charge : catalogues localisés pour obtenir une liste des champs de catalogue pris en charge.

Remarque : price, sale_price, unit_price, base_price, status (visibilité) et availability ne doivent être fournis que dans un flux de pays. Ces champs ne peuvent pas être fournis dans un flux linguistique. Les client·es peuvent ainsi voir les données des produits localisées.

Limites

  • Le paramètre requests peut contenir jusqu’à 1 000 articles.
  • Pour chaque catalogue, vous êtes limité·e à un certain nombre d’appels par heure, défini par la formule de plafond du cas d’utilisation pour les entreprises de Catalog Batch. Si ce nombre est insuffisant, veuillez nous contacter.
  • Le code d’erreur 1 associé au message "Please reduce the amount of data you're asking for, then retry your request" indique que la taille des données (en octets) reçues dans la requête d’API est trop importante. Pour corriger ce problème, réduisez le nombre d’éléments inclus dans le lot, puis réessayez. Ainsi, la requête respectera les limites de taille acceptable et pourra être traitée correctement.

Champs pris en charge

Consultez la liste des champs pris en charge et leurs descriptions respectives pour chaque champ, pour le point de terminaison /{catalog_id}/localized_items_batch :

Voir aussi

Exemple

Exemple de requête

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"
      }
    }
  ]
}

Exemple de réponse

"handles": ["AczBWxwCxXv4s3xQpm0JwXBlhs-IPGatrWmDRBmc1wTYrV5JvtkuQRT_FOCmKZGmHvotvvX8UtQnwEgg16wTx14cqPYzWVzmxZiaZDLgMUmjSA"]

Ce point de terminaison ne crée pas de nouveaux articles de catalogue. Toutes les demandes doivent contenir un objet JSON de données qui contient l’identifiant d’un article de catalogue existant.

Vous pouvez utiliser le champ applink pour spécifier des informations sur les liens profonds ; il fonctionne de manière similaire à Liens profonds. Fournissez vos informations sur les liens profonds dans le format JSON indiqué ci-dessous.

"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"}]}

Il existe une légère différence dans les noms des champs par rapport à ceux des liens profonds, car chaque type d’application est un nœud distinct et est inclus dans leurs champs respectifs.

'data\[applink\]\[android\]' est une grille dans laquelle une seule valeur est spécifiée. Il en va de même pour les autres types d’applications.

Nous ne prenons pas en charge les liens universels iOS.

Pour localiser les champs applink, vous devez tous les fournir. En savoir plus sur les liens profonds vers des produits.

En savoir plus