Instagram 用戶可用目錄

表示 Instagram 用戶 Instagram 商店中的一組商品目錄。如需了解完整的使用詳情，請參閱商品標註功能指南。

建立

不支援這項操作。

讀取

GET /{ig-user-id}/available_catalogs

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

限制

不支援 Instagram 創作者帳戶。
不支援限時動態、Instagram TV、Reels、Live 和提及功能。
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`	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
    }
  ]
}

更新

不支援這項操作。

刪除

不支援這項操作。