Instagram 用户可用目录

表示 Instagram 用户的 Instagram 店铺中的一组商品目录。如需了解完整的使用详情，请参阅商品标记指南。

创建

不支持此操作。

读取

GET /{ig-user-id}/available_catalogs

获取 Instagram 用户的 Instagram 店铺中的商品目录。

限制

不支持 Instagram 创作者帐户。
不支持快拍、Instagram TV、Reels、Live 和 Mentions。
Instagram 店铺仅使用一个目录，因此只返回一个目录的数据。
不支持合作目录（购物合作伙伴目录或联盟营销创作者目录）。

要求

类型	要求
访问口令	用户
商务管理平台身份	应用用户必须在此 Instagram 用户的 Instagram 店铺所属的商务管理平台上具有管理员身份。
Instagram 店铺	Instagram 用户必须拥有已获批准的 Instagram 店铺，以及包含商品的商品目录。
权限	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` 若在与目标 Instagram 用户相绑定的公共主页上，通过商务管理平台向应用用户授予了身份，您还将需要以下其中一项权限： `ads_management` `business_management`

请求语法

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

路径参数

占位符	值
`{api-version}`	API 版本。
`{ig-user-id}`	必要项。应用用户的应用范围用户编号。

查询字符串参数

键	占位符	值
`access_token`	`{access-token}`	必要项。应用用户的用户访问口令。
`fields`	`{fields}`	您希望系统针对结果集中的每个目录返回的，以逗号分隔的目录字段列表。

响应

包含您所请求的数据的 JSON 格式对象。

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

响应内容

属性	值
`catalog_id`	目录编号。
`catalog_name`	目录名称。
`shop_name`	店铺名称。
`product_count`	目录中的商品数量。包括所有商品（不考虑审核状态）。

cURL 示例

请求

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

响应

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

更新

不支持此操作。

删除

不支持此操作。