IG 用戶可用目錄

代表 IG 用戶的 Instagram 商店中的商品目錄集合。如需完整的用法詳細資訊，請參閱商品標註指南。

建立

不支援執行此作業。

讀取

GET /{ig-user-id}/available_catalogs

取得 IG 用戶的 Instagram 商店中的商品目錄。

限制

不支援 Instagram 創作者帳號。
不支援限時動態、Instagram TV、Reels、Live 和 Mentions。
只會傳回單一目錄的資料，因為 Instagram 商店僅限單一目錄。
不支援協作目錄（購物合作夥伴目錄或聯盟行銷創作者目錄）。

必備條件

類型	條件
存取權杖	用戶
企業角色	應用程式用戶在擁有 IG 用戶的 Instagram 商店的企業管理平台上，必須具有管理員角色。
Instagram 商店	IG 用戶必須擁有獲得批准的 Instagram 商店，以及包含商品的商品目錄。
權限	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` 如果應用程式用戶是透過連結至目標 IG 用戶之粉絲專頁的企業管理平台獲得角色，您還需要下列其中一項： `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
    }
  ]
}

更新

不支援執行此作業。

刪除

不支援執行此作業。