Verfügbare Kataloge für IG-Nutzer*innen

Stellt eine Collection mit Produktkatalogen in einem IG-Nutzer Instagram Shop dar. Umfassende Informationen zur Verwendung findest du im Leitfaden Produktmarkierung.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{ig-user-id}/available_catalogs

Den Produktkatalog in einem IG-Nutzer-Instagram Shop abrufen.

Einschränkungen

Instagram-Creator-Konten werden nicht unterstützt.
Stories, Instagram TV, Reels, Live und Mentions werden nicht unterstützt.
Gibt nur Daten zu einem Katalog zurück, da für Instagram Shops nur ein Katalog unterstützt wird.
Gemeinsame Kataloge (Kataloge von Shopping-Partnern oder Affiliate-Creator-Kataloge) werden nicht unterstützt.

Anforderungen

Typ	Anforderung
Zugriffsschlüssel	Nutzer
Unternehmensrollen	App-Nutzer*innen müssen eine Administratorrolle im Business Manager haben, dem der IG-Nutzer-Instagram Shop gehört.
Instagram Shop	IG-Nutzer*innen müssen 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}/available_catalogs
  ?fields={fields}
  &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.
`fields`	`{fields}`	Kommagetrennte Liste mit Katalogfeldern, die für die einzelnen Kataloge im Ergebnissatz zurückgegeben werden sollen.

Antwort

Ein JSON-formatiertes Objekt, das die von dir angeforderten Daten enthält.

{
  "data": [
    {
      "catalog_id": "{catalog-id}",
      "catalog_name": "{catalog-name}",
      "shop_name": "{shop-name}",
      "product_count": {product-count}
    }
  ]
}

Antwortinhalt

Eigenschaft	Wert
`catalog_id`	Katalog-ID
`catalog_name`	Katalogname
`shop_name`	Shop-Name
`product_count`	Anzahl der Produkte im Katalog Enthält alle Produkte unabhängig vom Überprüfungsstatus.

cURL-Beispiel

Anfrage

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

Antwort

{
  "data": [
    {
      "catalog_id": "960179311066902",
      "catalog_name": "Jay's Favorite Snacks",
      "shop_name": "Jay's Bespoke",
      "product_count": 11
    }
  ]
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.