IG 사용자 사용 가능한 카탈로그

IG 사용자의 Instagram Shop에 있는 제품 카탈로그 컬렉션을 나타냅니다. 사용 방법에 대한 자세한 내용은 제품 태그 가이드를 참조하세요.

만들기

지원되지 않는 작업입니다.

읽기

GET /{ig-user-id}/available_catalogs

IG 사용자의 Instagram Shop에 있는 제품 카탈로그를 가져옵니다.

제한 사항

Instagram 크리에이터 계정은 지원되지 않습니다.
스토리, Instagram TV, 릴스, 라이브 및 언급은 지원되지 않습니다.
Instagram Shops는 단일 카탈로그로 제한되므로 단일 카탈로그에 대한 데이터만 반환합니다.
공동 카탈로그(쇼핑 파트너 또는 제휴 크리에이터 카탈로그)는 지원되지 않습니다.

요구 사항

유형	요구 사항
액세스 토큰	사용자
비즈니스 역할	앱 사용자는 IG 사용자의 Instagram Shop을 소유하는 비즈니스 관리자에 대한 관리자 역할이 있어야 합니다.
Instagram Shop	IG 사용자는 제품을 포함하는 제품 카탈로그가 있는 승인된 Instagram Shop이 있어야 합니다.
권한	`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}`	필수 항목. 앱 사용자의 앱 범위 사용자 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`	Shop 이름.
`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
    }
  ]
}

업데이트

지원되지 않는 작업입니다.

삭제

지원되지 않는 작업입니다.