Réclamation d’utilisateur·trice Instagram sur les produits

Représente le statut de la réclamation concernant un produit rejeté. Pour des détails complets sur l’utilisation, consultez le guide Identification de produits.

Création

POST /{ig-user-id}/product_appeal

Effectuez une réclamation concernant un projet rejeté.

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.

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

POST https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?appeal_reason={appeal-reason}
  &product_id={product-id}
  &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.
`appeal_reason`	`{appeal-reason}`	Obligatoire. Explication de la raison pour laquelle le produit devrait être approuvé.
`product_id`	`{product-id}`	Obligatoire. ID du produit.

Réponse

Objet indiquant la réussite ou l’échec de l’opération. La réponse n’indique en rien l’issue de la réclamation.

{
  "success": {success}
}

Contenus de la réponse

Propriété	Valeur
`success`	Indique si l’API a accepté la requête (`true`) ou l’a refusée (`false`). La réponse n’indique en rien l’issue de la réclamation.

Exemple de requête cURL

Requête

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/product_appeal?appeal_reason=product%20is%20a%20toy%20and%20not%20a%20real%20weapon&product_id=4382881195057752&access_token=EAAOc..."

Réponse

{
  "success": true
}

Lecture

GET /{ig-user-id}/product_appeal

Obtenez le statut de la réclamation concernant un produit rejeté.

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.

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}/product_appeal
  ?product_id={product-id}
  &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.
`product_id`	`{product-id}`	Obligatoire. ID du produit.

Réponse

Objet au format JSON contenant un tableau de métadonnées de statut de réclamation.

{
  "data": [
    {
      "eligible_for_appeal": {eligible-for-appeal},
      "product_id": {product-id},
      "review_status": "{review-status}"
    }
  ]
}

Contenus de la réponse

Propriété Valeur

Propriété	Valeur
`eligible_for_appeal`	Indique s’il est possible de faire appel de la décision (si oui `true`, si non `false`).
`product_id`	ID du produit.
`review_status`	Statut d’examen. La valeur peut être : `approved` : le produit est approuvé. `rejected` : le produit a été rejeté. `pending` : l’examen est toujours en cours. `outdated` : le produit a été approuvé, mais il a été modifié et nécessite alors une nouvelle approbation. `""` : aucun statut d’examen. `no_review` : aucun statut d’examen.

eligible_for_appeal

Indique s’il est possible de faire appel de la décision (si oui true, si non false).

product_id

ID du produit.

review_status

Statut d’examen. La valeur peut être :

approved : le produit est approuvé.
rejected : le produit a été rejeté.
pending : l’examen est toujours en cours.
outdated : le produit a été approuvé, mais il a été modifié et nécessite alors une nouvelle approbation.
"" : aucun statut d’examen.
no_review : aucun statut d’examen.

Exemple de requête cURL

Requête

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

Réponse

{
  "data": [
    {
      "product_id": 4029274203846188,
      "review_status": "approved",
      "eligible_for_appeal": false
    }
  ]
}

Mise à jour

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

Suppression

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