IGユーザー利用可能カタログ

IGユーザーのInstagramショップの中の商品カタログのコレクションを表します。使い方について詳しくは、商品のタグ付けをご覧ください。

作成

この操作はサポートされていません。

読み取り

GET /{ig-user-id}/available_catalogs

IGユーザーのInstagramショップの中の商品カタログを取得します。

制限

Instagramクリエイターアカウントはサポートされていません。
ストーリーズ、Instagram TV、リール、ライブ、メンションはサポートされていません。
Instagramショップは単一のカタログに制限されているため、単一のカタログに関するデータのみ返されます。
コラボレーションカタログ(ショッピングパートナーカタログやアフィリエイトクリエイターカタログなど)はサポートされていません。

要件

型	要件
アクセストークン	ユーザー
ビジネスの役割	アプリユーザーには、IGユーザーのInstagramショップを所有するビジネスマネージャの管理者権限がなければなりません。
Instagramショップ	IGユーザーには、商品が含まれる商品カタログがある、承認済みのInstagramショップがなければなりません。
アクセス許可	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` ターゲットのIGユーザーに接続されたページの役割がビジネスマネージャを介してアプリユーザーに付与されている場合は、次のうちのいずれか1つも必要です。 `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}`	必須。アプリユーザーのapp-scoped 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`	カタログ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
    }
  ]
}

更新

この操作はサポートされていません。

削除

この操作はサポートされていません。