Apelación de productos de un usuario de Instagram

Representa el estado de la apelación de un producto rechazado. Consulta todos los detalles sobre el uso en la guía de etiquetado de productos.

Creación

POST /{ig-user-id}/product_appeal

Apelar un producto rechazado.

Limitaciones

No se admiten las cuentas de creador de Instagram.
No se admiten Stories, Instagram TV, Reels, Live ni Mentions.

Requisitos

Tipo	Requisito
Identificadores de acceso	Usuario
Roles de la empresa	El usuario de la aplicación debe tener un rol de administrador en la cuenta de Business Manager a la que pertenece la tienda de Instagram del usuario de Instagram.
Tienda de Instagram	El usuario de Instagram debe tener una tienda de Instagram aprobada con un catálogo de productos que contenga productos.
Permisos	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Si se ha concedido un rol al usuario de la aplicación mediante Business Manager en la página conectada al usuario de Instagram de destino, también necesitarás uno de los elementos siguientes: `ads_management` `business_management`

Sintaxis de la solicitud

POST https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?appeal_reason={appeal-reason}
  &product_id={product-id}
  &access_token={access-token}

Parámetros de ruta

Marcador de posición	Valor
`{api-version}`	Versión de la API.
`{ig-user-id}`	Obligatorio. Identificador de usuario específico de la aplicación del usuario de la aplicación.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`{access-token}`	Obligatorio. Identificador de acceso del usuario de la aplicación.
`appeal_reason`	`{appeal-reason}`	Obligatorio. Explicación de por qué debe aprobarse el producto.
`product_id`	`{product-id}`	Obligatorio. Identificador del producto.

Respuesta

Un objeto que indique que se ha realizado correctamente o que se ha producido un error. El resultado de la apelación no se indica en la respuesta.

{
  "success": {success}
}

Contenido de la respuesta

Propiedad	Valor
`success`	Indica si la API ha aceptado la solicitud (`true`) o no (`false`). El resultado de la apelación no se indica en la respuesta.

Ejemplo de cURL

Solicitud

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..."

Respuesta

{
  "success": true
}

Lectura

GET /{ig-user-id}/product_appeal

Obtén el estado de apelación de un producto rechazado.

Limitaciones

No se admiten las cuentas de creador de Instagram.
No se admiten Stories, Instagram TV, Reels, Live ni Mentions.

Requisitos

Tipo	Requisito
Identificadores de acceso	Usuario
Roles de la empresa	El usuario de la aplicación debe tener un rol de administrador en la cuenta de Business Manager a la que pertenece la tienda de Instagram del usuario de Instagram.
Tienda de Instagram	El usuario de Instagram debe tener una tienda de Instagram aprobada con un catálogo de productos que contenga productos.
Permisos	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Si se ha concedido un rol al usuario de la aplicación mediante Business Manager en la página conectada al usuario de Instagram de destino, también necesitarás uno de los elementos siguientes: `ads_management` `business_management`

Sintaxis de la solicitud

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

Parámetros de ruta

Marcador de posición	Valor
`{api-version}`	Versión de la API.
`{ig-user-id}`	Obligatorio. Identificador de usuario específico de la aplicación del usuario de la aplicación.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`{access-token}`	Obligatorio. Identificador de acceso del usuario de la aplicación.
`product_id`	`{product-id}`	Obligatorio. Identificador del producto.

Respuesta

Un objeto con formato JSON que contiene una matriz de los metadatos del estado de la apelación.

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

Contenido de la respuesta

Propiedad Valor

Propiedad	Valor
`eligible_for_appeal`	Indica si la decisión se puede apelar (si el valor es `true`, se puede apelar, pero si el valor es `false`, no).
`product_id`	Identificador del producto.
`review_status`	Estado de la revisión. El valor puede ser uno de los siguientes: `approved`: el producto se ha aprobado. `rejected`: el producto se ha rechazado. `pending`: todavía se está revisando. `outdated`: el producto se ha aprobado, pero se ha editado y es necesario volver a aprobarlo. `""`: sin estado de revisión. `no_review`: sin estado de revisión.

eligible_for_appeal

Indica si la decisión se puede apelar (si el valor es true, se puede apelar, pero si el valor es false, no).

product_id

Identificador del producto.

review_status

Estado de la revisión. El valor puede ser uno de los siguientes:

approved: el producto se ha aprobado.
rejected: el producto se ha rechazado.
pending: todavía se está revisando.
outdated: el producto se ha aprobado, pero se ha editado y es necesario volver a aprobarlo.
"": sin estado de revisión.
no_review: sin estado de revisión.

Ejemplo de cURL

Solicitud

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

Respuesta

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

Actualización

Esta operación no es compatible.

Eliminación

Esta operación no es compatible.