Ricorso per un prodotto per l'utente di IG

Rappresenta lo stato del ricorso di un prodotto rifiutato. Consulta la guida sui Tag dei prodotti per dettagli completi sull'utilizzo.

Creazione

POST /{ig-user-id}/product_appeal

Invia un ricorso per un prodotto rifiutato.

Limitazioni

Gli account creator di Instagram non sono supportati.
Storie, Instagram TV, Reel, Live e Menzioni non sono supportati.

Requisiti

Tipo	Requisito
Token d'accesso	Utente
Ruoli aziendali	L'utente dell'app deve disporre di un ruolo di amministratore nel Business Manager che possiede lo Shop di Instagram dell'utente di IG.
Shop di Instagram	L'utente IG deve disporre di uno Shop di Instagram approvato con un catalogo prodotti contenente dei prodotti.
Autorizzazioni	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Se all'utente dell'app è stato concesso un ruolo tramite Business Manager sulla Pagina collegata all'utente di IG specifico, sarà necessaria anche una delle seguenti autorizzazioni: `ads_management` `business_management`

Sintassi della richiesta

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

Parametri del percorso

Segnaposto	Valore
`{api-version}`	Versione dell'API.
`{ig-user-id}`	Obbligatorio. ID utente per singola app dell'utente dell'app.

Parametri della stringa della query

Chiave	Segnaposto	Valore
`access_token`	`{access-token}`	Obbligatorio. Token d'accesso dell'utente dell'utente dell'app.
`appeal_reason`	`{appeal-reason}`	Obbligatorio. Spiegazione del motivo per cui il prodotto dovrebbe essere approvato.
`product_id`	`{product-id}`	Obbligatorio. ID prodotto.

Risposta

Un oggetto che indica un'azione eseguita correttamente o un errore. La risposta non indica l'esito del ricorso.

{
  "success": {success}
}

Contenuti della risposta

Proprietà	Valore
`success`	Indica se l'API ha accettato la richiesta (`true`) o meno (`false`). La risposta non indica l'esito del ricorso.

Esempio di cURL

Richiesta

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

Risposta

{
  "success": true
}

Lettura

GET /{ig-user-id}/product_appeal

Acquisisci lo stato del ricorso di un prodotto rifiutato.

Limitazioni

Gli account creator di Instagram non sono supportati.
Storie, Instagram TV, Reel, Live e Menzioni non sono supportati.

Requisiti

Tipo	Requisito
Token d'accesso	Utente
Ruoli aziendali	L'utente dell'app deve disporre di un ruolo di amministratore nel Business Manager che possiede lo Shop di Instagram dell'utente di IG.
Shop di Instagram	L'utente di IG deve disporre di uno Shop di Instagram approvato con un catalogo prodotti contenente dei prodotti.
Autorizzazioni	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Se all'utente dell'app è stato concesso un ruolo tramite Business Manager sulla Pagina collegata all'utente di IG specifico, sarà necessaria anche una delle seguenti autorizzazioni: `ads_management` `business_management`

Sintassi della richiesta

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

Parametri del percorso

Segnaposto	Valore
`{api-version}`	Versione dell'API.
`{ig-user-id}`	Obbligatorio. ID utente per singola app dell'utente dell'app.

Parametri della stringa della query

Chiave	Segnaposto	Valore
`access_token`	`{access-token}`	Obbligatorio. Token d'accesso dell'utente dell'utente dell'app.
`product_id`	`{product-id}`	Obbligatorio. ID prodotto.

Risposta

Un oggetto in formato JSON contenente un array di metadati dello stato del ricorso.

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

Contenuti della risposta

Proprietà Valore

Proprietà	Valore
`eligible_for_appeal`	Indica se è possibile inviare un ricorso per la decisione (sì se `true`, no se `false`).
`product_id`	ID prodotto.
`review_status`	Stato del controllo. Il valore può essere: `approved`: il prodotto è stato approvato. `rejected`: il prodotto è stato rifiutato. `pending`: ancora in fase di controllo. `outdated`: il prodotto è stato approvato, ma è stato modificato e richiede una nuova approvazione. `""`: nessuno stato del controllo. `no_review`: nessuno stato del controllo.

eligible_for_appeal

Indica se è possibile inviare un ricorso per la decisione (sì se true, no se false).

product_id

ID prodotto.

review_status

Stato del controllo. Il valore può essere:

approved: il prodotto è stato approvato.
rejected: il prodotto è stato rifiutato.
pending: ancora in fase di controllo.
outdated: il prodotto è stato approvato, ma è stato modificato e richiede una nuova approvazione.
"": nessuno stato del controllo.
no_review: nessuno stato del controllo.

Esempio di cURL

Richiesta

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

Risposta

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

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.