Apelação de produto do usuário do Instagram

Representa o status de apelação de um produto rejeitado. Consulte o guia Marcação de produto para ver as informações completas de uso.

Criação

POST /{ig-user-id}/product_appeal

Faça uma apelação de um produto rejeitado.

Limitações

Não há compatibilidade com contas de criador de conteúdo do Instagram.
Não há compatibilidade com Stories, Instagram TV, Reels, Live nem Mentions.

Requisitos

Tipo	Requisito
Tokens de acesso	Usuário
Funções na empresa	O usuário do aplicativo precisa ter uma função de administrador no Gerenciador de Negócios da Loja do Instagram.
Loja do Instagram	O usuário do Instagram precisa ter uma Loja do Instagram aprovada com um catálogo que inclui produtos.
Permissões	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Caso uma função tenha sido concedida ao usuário do aplicativo por meio do Gerenciador de Negócios na Página conectada ao usuário do Instagram em questão, você precisará obter uma das seguintes permissões: `ads_management` `business_management`

Sintaxe da solicitação

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 caminho

Espaço reservado	Valor
`{api-version}`	A versão da API.
`{ig-user-id}`	Obrigatório. O ID do usuário no escopo do aplicativo.

Parâmetros da string de consulta

Chave	Espaço reservado	Valor
`access_token`	`{access-token}`	Obrigatório. Token de acesso do usuário do aplicativo.
`appeal_reason`	`{appeal-reason}`	Obrigatório. Explicação do motivo que justifica a aprovação do produto.
`product_id`	`{product-id}`	Obrigatório. Identificação do produto.

Resposta

Um objeto que representa sucesso ou falha. A resposta não indica o resultado da apelação.

{
  "success": {success}
}

Conteúdo da resposta

Propriedade	Valor
`success`	Indica se a API aceitou (`true`) ou não (`false`) a solicitação. A resposta não indica o resultado da apelação.

Exemplo de cURL

Solicitação

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

Resposta

{
  "success": true
}

Leitura

GET /{ig-user-id}/product_appeal

Obtenha o status da apelação de um produto rejeitado.

Limitações

Não há compatibilidade com contas de criador de conteúdo do Instagram.
Não há compatibilidade com Stories, Instagram TV, Reels, Live nem Mentions.

Requisitos

Tipo	Requisito
Tokens de acesso	Usuário
Funções na empresa	O usuário do aplicativo precisa ter uma função de administrador no Gerenciador de Negócios da Loja do Instagram.
Loja do Instagram	O usuário do Instagram precisa ter uma Loja do Instagram aprovada com um catálogo que inclui produtos.
Permissões	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Caso uma função tenha sido concedida ao usuário do aplicativo por meio do Gerenciador de Negócios na Página conectada ao usuário do Instagram em questão, você precisará obter uma das seguintes permissões: `ads_management` `business_management`

Sintaxe da solicitação

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

Parâmetros de caminho

Espaço reservado	Valor
`{api-version}`	A versão da API.
`{ig-user-id}`	Obrigatório. O ID do usuário no escopo do aplicativo.

Parâmetros da string de consulta

Chave	Espaço reservado	Valor
`access_token`	`{access-token}`	Obrigatório. Token de acesso do usuário do aplicativo.
`product_id`	`{product-id}`	Obrigatório. Identificação do produto.

Resposta

Um objeto formatado em JSON que contém uma matriz de metadados do status da apelação.

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

Conteúdo da resposta

Propriedade Valor

Propriedade	Valor
`eligible_for_appeal`	Indica se pode ser feita uma apelação da decisão (sim se `true`, não se `false`).
`product_id`	Identificação do produto.
`review_status`	O status da análise. Os valores podem ser os seguintes: `approved`: produto aprovado. `rejected`: produto rejeitado. `pending`: ainda em análise. `outdated`: produto aprovado, mas precisa de reaprovação devido a edições. `""`: sem status de análise. `no_review`: sem status de análise.

eligible_for_appeal

Indica se pode ser feita uma apelação da decisão (sim se true, não se false).

product_id

Identificação do produto.

review_status

O status da análise. Os valores podem ser os seguintes:

approved: produto aprovado.
rejected: produto rejeitado.
pending: ainda em análise.
outdated: produto aprovado, mas precisa de reaprovação devido a edições.
"": sem status de análise.
no_review: sem status de análise.

Exemplo de cURL

Solicitação

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

Resposta

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

Atualização

Esta operação não é compatível.

Exclusão

Esta operação não é compatível.