Einsprüche für Produkte von IG-Nutzer*innen

Gibt den Einspruchstatus für ein abgelehntes Produkt an. Umfassende Informationen zur Verwendung findest du im Leitfaden Produktmarkierung.

Erstellen

POST /{ig-user-id}/product_appeal

Einspruch gegen ein abgelehntes Produkt erheben

Einschränkungen

Instagram-Creator-Konten werden nicht unterstützt.
Stories, Instagram TV, Reels, Live und Mentions werden nicht unterstützt.

Anforderungen

Typ	Anforderung
Zugriffsschlüssel	Nutzer
Unternehmensrollen	Der App-Nutzer muss eine Administratorrolle für den Business Manager haben, dem der Instagram Shop des IG-Nutzers gehört.
Instagram Shop	Der IG-Nutzer muss einen genehmigten Instagram Shop mit einem Produktkatalog mit Produkten haben.
Berechtigungen	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Wenn der App-Nutzer über den Business Manager auf der mit dem IG-Nutzer aus der Zielgruppe verbundenen Seite eine Rolle zugewiesen bekommen hat, benötigst du außerdem eine der folgenden Berechtigungen: `ads_management` `business_management`

Anfragesyntax

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

Pfadparameter

Platzhalter	Wert
`{api-version}`	API-Version.
`{ig-user-id}`	Erforderlich. App-spezifische Nutzer-ID des App-Nutzers.

Abfrage-String-Parameter

Schlüssel	Platzhalter	Wert
`access_token`	`{access-token}`	Erforderlich. Der Nutzer-Zugriffsschlüssel eineseiner App-Nutzerin.
`appeal_reason`	`{appeal-reason}`	Erforderlich. Erläuterung der Gründe für die Genehmigung des Produkts.
`product_id`	`{product-id}`	Erforderlich. Produkt-ID.

Antwort

Ein Objekt, das Erfolg oder Fehlschlag angibt. Die Antwort gibt keinen Hinweis auf das Resultat des Einspruchs.

{
  "success": {success}
}

Antwortinhalt

Eigenschaft	Wert
`success`	Gibt an, ob die Anfrage von der API akzeptiert wurde (`true`) oder nicht (`false`). Die Antwort gibt keinen Hinweis auf das Resultat des Einspruchs.

cURL-Beispiel

Anfrage

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

Antwort

{
  "success": true
}

Lesen

GET /{ig-user-id}/product_appeal

Einspruch-Status für ein abgelehntes Produkt abrufen.

Einschränkungen

Instagram-Creator-Konten werden nicht unterstützt.
Stories, Instagram TV, Reels, Live und Mentions werden nicht unterstützt.

Anforderungen

Typ	Anforderung
Zugriffsschlüssel	Nutzer
Unternehmensrollen	Der App-Nutzer muss eine Administratorrolle für den Business Manager haben, dem der Instagram Shop des IG-Nutzers gehört.
Instagram Shop	Der IG-Nutzer muss einen genehmigten Instagram Shop mit einem Produktkatalog mit Produkten haben.
Berechtigungen	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Wenn der App-Nutzer über den Business Manager auf der mit dem IG-Nutzer aus der Zielgruppe verbundenen Seite eine Rolle zugewiesen bekommen hat, benötigst du außerdem eine der folgenden Berechtigungen: `ads_management` `business_management`

Anfragesyntax

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

Pfadparameter

Platzhalter	Wert
`{api-version}`	API-Version.
`{ig-user-id}`	Erforderlich. App-spezifische Nutzer-ID des App-Nutzers.

Abfrage-String-Parameter

Schlüssel	Platzhalter	Wert
`access_token`	`{access-token}`	Erforderlich. Der Nutzer-Zugriffsschlüssel eineseiner App-Nutzerin.
`product_id`	`{product-id}`	Erforderlich. Produkt-ID.

Antwort

Ein JSON-formatiertes Objekt, das ein Array von Metadaten für Einspruch-Status enthält.

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

Antwortinhalt

Eigenschaft Wert

Eigenschaft	Wert
`eligible_for_appeal`	Gibt an, ob Einspruch gegen die Entscheidung eingelegt werden kann (ja, wenn `true`, nein, wenn `false`).
`product_id`	Produkt-ID.
`review_status`	Überprüfungsstatus. Zulässige Werte sind: `approved`: Produkt wurde genehmigt `rejected`: Produkt wurde abgelehnt `pending`: Prüfung läuft noch `outdated`: Produkt wurde genehmigt, wurde aber bearbeitet und muss erneut genehmigt werden `""`: kein Überprüfungsstatus `no_review`: kein Überprüfungsstatus

eligible_for_appeal

Gibt an, ob Einspruch gegen die Entscheidung eingelegt werden kann (ja, wenn true, nein, wenn false).

product_id

Produkt-ID.

review_status

Überprüfungsstatus. Zulässige Werte sind:

approved: Produkt wurde genehmigt
rejected: Produkt wurde abgelehnt
pending: Prüfung läuft noch
outdated: Produkt wurde genehmigt, wurde aber bearbeitet und muss erneut genehmigt werden
"": kein Überprüfungsstatus
no_review: kein Überprüfungsstatus

cURL-Beispiel

Anfrage

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

Antwort

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

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.