Catalogues disponibles des utilisateur·trices Instagram

Représente une collection de catalogues produits dans la Boutique Instagram d’un ou d’une utilisateur·trice Instagram. Pour des détails complets sur l’utilisation, consultez le guide Identification de produits.

Création

Cette opération n’est pas prise en charge.

Lecture

GET /{ig-user-id}/available_catalogs

Obtenez le catalogue produits de la Boutique Instagram d’un ou d’une utilisateur·trice Instagram.

Limites

Les comptes Creator Instagram ne sont pas pris en charge.
Les fonctionnalités Instagram TV, Stories, Reels, Live et Mentions ne sont pas prises en charge.
Renvoie uniquement les données d’un catalogue unique, car les Boutiques Instagram sont limitées à un seul catalogue.
Les catalogues collaboratifs (catalogues de partenaires shopping ou de créateurs affiliés) ne sont pas pris en charge.

Conditions requises

Type	Condition requise
Tokens d’accès	Utilisateur·trice
Rôles dans Business Manager	L’utilisateur·trice de l’application doit disposer d’un rôle admin sur le Business Manager qui possède la Boutique Instagram de l’utilisateur·trice Instagram.
Boutique Instagram	L’utilisateur·trice Instagram doit disposer d’une Boutique Instagram approuvée avec un catalogue contenant des produits.
Autorisations	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Si un rôle a été attribué à l’utilisateur·trice de l’application via Business Manager sur la Page connectée à l’utilisateur·trice Instagram cible, vous aurez également besoin de l’un des éléments suivants : `ads_management` `business_management`

Syntaxe de la requête

GET https://graph.facebook.com/{api-version}/{ig-user-id}/available_catalogs
  ?fields={fields}
  &access_token={access-token}

Paramètres du chemin

Espace réservé	Valeur
`{api-version}`	Version de l’API.
`{ig-user-id}`	Obligatoire. ID utilisateur spécifique à une app de l’utilisateur·trice de l’application.

Paramètres de la chaîne de requête

Clé	Espace réservé	Valeur
`access_token`	`{access-token}`	Obligatoire. Token d’accès utilisateur de l’utilisateur·trice de l’application.
`fields`	`{fields}`	Liste de champs de catalogue séparés par des virgules qui doivent être renvoyés pour chaque catalogue dans l’ensemble de résultats.

Réponse

Objet au format JSON contenant les données que vous avez demandées.

{
  "data": [
    {
      "catalog_id": "{catalog-id}",
      "catalog_name": "{catalog-name}",
      "shop_name": "{shop-name}",
      "product_count": {product-count}
    }
  ]
}

Contenus de la réponse

Propriété	Valeur
`catalog_id`	ID du catalogue.
`catalog_name`	Nom du catalogue.
`shop_name`	Nom de la boutique.
`product_count`	Nombre de produits dans le catalogue. Inclut tous les produits quel que soit leur statut d’examen.

Exemple de requête cURL

Requête

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010177253934/available_catalogs?access_token=EAAOc..."

Réponse

{
  "data": [
    {
      "catalog_id": "960179311066902",
      "catalog_name": "Jay's Favorite Snacks",
      "shop_name": "Jay's Bespoke",
      "product_count": 11
    }
  ]
}

Mise à jour

Cette opération n’est pas prise en charge.

Suppression

Cette opération n’est pas prise en charge.