Catálogos disponibles para los usuarios de IG

Representa una colección de catálogos de productos en la tienda de Instagram de un usuario de la red. Consulta la guía Etiquetado de productos para conocer los detalles de uso completos.

Creación

No se admite esta operación.

Lectura

GET /{ig-user-id}/available_catalogs

Obtén el catálogo de productos en la tienda de Instagram de un usuario de la red.

Limitaciones

No se admiten las cuentas de creador de Instagram.
No se admiten historias, Instagram TV, reels, Instagram Live ni menciones.
Solo devuelve datos en un catálogo porque las tiendas de Instagram están limitadas a un solo catálogo.
Los catálogos colaborativos (catálogos de socios de compras o creadores afiliados) no son compatibles.

Requisitos

Tipo	Requisito
Tokens de acceso	Usuario
Roles comerciales	El usuario de la app debe tener rol de administrador en el administrador comercial que posea la tienda de Instagram del usuario de esta red.
Tienda de Instagram	El usuario de IG debe tener una tienda de Instagram aprobada con un catálogo que contenga productos.
Permisos	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Si se usó el administrador comercial para otorgar un rol al usuario de la app en la página conectada al usuario de Instagram dirigido, también necesitarás alguno de los siguientes elementos: `ads_management` `business_management`

Sintaxis de la solicitud

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

Parámetros de ruta

Marcador de posición	Valor
`{api-version}`	Versión de la API.
`{ig-user-id}`	Obligatorio. Identificador de usuario específico de la app.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`{access-token}`	Obligatorio. Token de acceso del usuario de la app.
`fields`	`{fields}`	Lista separada por comas de los campos del catálogo que deseas que se devuelvan sobre cada catálogo en el conjunto de resultados.

Respuesta

Objeto con formato JSON que contiene los datos solicitados.

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

Contenido de la respuesta

Propiedad	Valor
`catalog_id`	Identificador del catálogo.
`catalog_name`	Nombre del catálogo.
`shop_name`	Nombre de la tienda.
`product_count`	Cantidad de productos del catálogo. Incluye todos los productos, sin importar el estado de revisión.

Ejemplo de cURL

Solicitud

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

Respuesta

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

Actualización

No se admite esta operación.

Eliminación

No se admite esta operación.