Cataloghi disponibili per l'utente di IG

Rappresenta una raccolta di cataloghi prodotti all'interno di uno Shop di Instagram dell'utente di IG. Consulta la guida sui Tag dei prodotti per dettagli completi sull'utilizzo.

Creazione

Questa operazione non è supportata.

Lettura

GET /{ig-user-id}/available_catalogs

Ottieni il catalogo prodotti all'interno di uno Shop di Instagram dell'utente di IG.

Limitazioni

Gli account creator di Instagram non sono supportati.
Storie, Instagram TV, Reel, Live e Menzioni non sono supportati.
Restituisce solo i dati su un singolo catalogo perché gli Shop di Instagram sono limitati a un unico catalogo.
I cataloghi collaborativi (cataloghi dei partner di shopping o cataloghi dei creator affiliati) 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}/available_catalogs
  ?fields={fields}
  &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.
`fields`	`{fields}`	Lista separata da virgole dei campi del catalogo che desideri vengano restituiti nell'insieme dei risultati per ciascun catalogo.

Risposta

Un oggetto JSON contenente i dati richiesti.

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

Contenuti della risposta

Proprietà	Valore
`catalog_id`	ID del catalogo.
`catalog_name`	Nome del catalogo.
`shop_name`	Nome dello shop.
`product_count`	Numero di prodotti presenti nel catalogo. Include tutti i prodotti indipendentemente dallo stato del controllo.

Esempio di cURL

Richiesta

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

Risposta

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

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.