Apelación de producto de usuario de IG

Representa el estado de apelación de un producto rechazado. Consulta la guía Etiquetado de productos para conocer los detalles de uso completos.

Creación

POST /{ig-user-id}/product_appeal

Realiza una apelación por un producto rechazado.

Limitaciones

No se admiten las cuentas de creador de Instagram.
No se admiten historias, Instagram TV, reels, Instagram Live ni menciones.

Requisitos

Tipo	Requisito
Tokens de acceso	Usuario
Roles comerciales	El usuario de la app debe tener rol de administrador en el administrador comercial que posea la tienda de Instagram del usuario de esta red.
Tienda de Instagram	El usuario de IG debe tener una tienda de Instagram aprobada con un catálogo que contenga productos.
Permisos	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Si se usó el administrador comercial para otorgar un rol al usuario de la app en la página conectada al usuario de Instagram dirigido, también necesitarás alguno de los siguientes elementos: `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 app.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`{access-token}`	Obligatorio. Token de acceso del usuario de la app.
`appeal_reason`	`{appeal-reason}`	Obligatorio. Explicación de los motivos por los que el producto se debería aprobar.
`product_id`	`{product-id}`	Obligatorio. Identificador del producto.

Respuesta

Un objeto que indica éxito o fracaso. La respuesta no indica el resultado de la apelación.

{
  "success": {success}
}

Contenido de la respuesta

Propiedad	Valor
`success`	Indica si la API aceptó (`true`) o no aceptó (`false`) la solicitud. La respuesta no indica el resultado de la apelación.

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 historias, Instagram TV, reels, Instagram Live ni menciones.

Requisitos

Tipo	Requisito
Tokens de acceso	Usuario
Roles comerciales	El usuario de la app debe tener rol de administrador en el administrador comercial que posea la tienda de Instagram del usuario de esta red.
Tienda de Instagram	El usuario de IG debe tener una tienda de Instagram aprobada con un catálogo que contenga productos.
Permisos	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Si se usó el administrador comercial para otorgar un rol al usuario de la app en la página conectada al usuario de Instagram dirigido, también necesitarás alguno de los siguientes elementos: `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 app.

Parámetros de la cadena de consulta

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

Respuesta

Un objeto con formato JSON que contiene una matriz de metadatos de estado de 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 puede apelarse (se puede apelar si el valor es `true`, no se puede aprobar si es `false`).
`product_id`	Identificador del producto.
`review_status`	Estado de revisión. El valor puede ser uno de los siguientes: `approved`: el producto está aprobado. `rejected`: el producto fue rechazado. `pending`: el producto se encuentra en proceso de revisión. `outdated`: el producto fue aprobado, pero se editó posteriormente y ahora requiere una nueva aprobación. `""`: sin estado de revisión. `no_review`: sin estado de revisión.

eligible_for_appeal

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

product_id

Identificador del producto.

review_status

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

approved: el producto está aprobado.
rejected: el producto fue rechazado.
pending: el producto se encuentra en proceso de revisión.
outdated: el producto fue aprobado, pero se editó posteriormente y ahora requiere una nueva aprobación.
"": 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

No se admite esta operación.

Eliminación

No se admite esta operación.