Catálogos disponibles de un usuario de Instagram

Representa una colección de catálogos de productos en una tienda de Instagram de un usuario de Instagram. Consulta todos los detalles sobre el uso en la guía de etiquetado de productos.

Creación

Esta operación no es compatible.

Lectura

GET /{ig-user-id}/available_catalogs

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

Limitaciones

No se admiten las cuentas de creador de Instagram.
No se admiten Stories, Instagram TV, Reels, Live ni Mentions.
Solo devuelve datos en un único catálogo porque las tiendas de Instagram están limitadas a un único catálogo.
No se admiten los catálogos colaborativos (como los catálogos de socios de compras o los catálogos de creadores afiliados).

Requisitos

Tipo	Requisito
Identificadores de acceso	Usuario
Roles de la empresa	El usuario de la aplicación debe tener un rol de administrador en la cuenta de Business Manager a la que pertenece la tienda de Instagram del usuario de Instagram.
Tienda de Instagram	El usuario de Instagram debe tener una tienda de Instagram aprobada con un catálogo de productos que contenga productos.
Permisos	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Si se ha concedido un rol al usuario de la aplicación mediante Business Manager en la página conectada al usuario de Instagram de destino, también necesitarás uno de los elementos siguientes: `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 aplicación del usuario de la aplicación.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`{access-token}`	Obligatorio. Identificador de acceso del usuario de la aplicación.
`fields`	`{fields}`	Lista separada por comas de los campos de un catálogo que quieres que se devuelvan para 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`	Número de productos del catálogo. Incluye todos los productos independientemente del 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

Esta operación no es compatible.

Eliminación

Esta operación no es compatible.