IG 미디어 제품 태그

IG 미디어의 제품 태그를 나타냅니다. 사용 방법에 대한 자세한 내용은 제품 태그 가이드를 참조하세요.

만들기

POST /{ig-media-id}/product_tags

기존 IG 미디어에 대한 제품 태그를 생성하거나 업데이트합니다.

제한 사항

Instagram 크리에이터 계정은 지원되지 않습니다.
스토리, Instagram TV, 라이브 및 언급은 지원되지 않습니다.
5개의 태그 사용 제한에 도달할 때까지 미디어에 태그가 추가됩니다. 타게팅된 미디어가 요청에서 이미 제품에 의해 태그된 경우 기존 태그의 x 및 y 값이 새로운 값으로 업데이트됩니다(새 태그는 추가되지 않음).

요구 사항

유형	요구 사항
액세스 토큰	사용자
비즈니스 역할	앱 사용자는 IG 사용자의 Instagram Shop을 소유하는 비즈니스 관리자에 대한 관리자 역할을 보유하고 있어야 합니다.
Instagram Shop	IG 미디어를 소유하는 IG 사용자는 제품이 포함된 제품 카탈로그가 있는 승인된 Instagram Shop이 있어야 합니다.
권한	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` 또한 앱 사용자가 타게팅된 IG 사용자에 연결된 페이지에서 비즈니스 관리자를 통해 역할을 부여받은 경우 다음 중 하나도 필요합니다. `ads_management` `business_management`

요청 구문

POST https://graph.facebook.com/{api-version}/{ig-media-id}/product_tags
  ?updated_tags={updated-tags}
  &access_token={access-token}

경로 매개변수

자리 표시자	값
`{api-version}`	API 버전
`{ig-media-id}`	필수 항목. IG 미디어 ID

쿼리 문자열 매개변수

키 자리 표시자 값

access_token

{access-token}

필수 항목. 앱 사용자의 사용자 액세스 토큰입니다.

updated_tags

{updated-tags}

필수 항목. 이미지와 동영상에만 적용됩니다. 이미지 또는 동영상에 붙일 제품 태그를 지정하는 개체의 배열입니다(최대 5개, 태그 및 제품 ID는 고유해야 함). 각 개체는 다음의 정보를 포함해야 합니다.

product_id — 필수 항목. 제품 ID.
x — 이미지에만 해당합니다. 게시된 미디어 이미지의 왼쪽 가장자리에서부터의 비율 거리를 나타내는 선택적 부동 소수점입니다. 값은 0.0~1.0 범위 이내여야 합니다.
y — 이미지에만 해당합니다. 게시된 미디어 이미지의 상단 가장자리에서부터의 비율 거리를 나타내는 선택적 부동 소수점입니다. 값은 0.0~1.0 범위 이내여야 합니다.

예를 들면 다음과 같습니다.

[{product_id:'3231775643511089',x:0.5,y:0.8}]

응답

성공 또는 실패를 나타내는 개체.

{
  "success": {success}
}

응답 내용

속성	값
`success`	IG 미디어 제품 태그를 업데이트할 수 있으면 `true`를 반환하고 그 외의 경우에는 `false`를 반환합니다.

cURL 예시

요청

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010778325754/product_tags?updated_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20x%3A%200.5%2C%0A%20%20%20%20y%3A%200.8%0A%20%20%7D%0A%5D&access_token=EAAOc..."

참고로 HTML로 디코딩된 POST 페이로드 문자열은 다음과 같습니다.

https://graph.facebook.com/v19.0/90010778325754/product_tags?updated_tags=[ { product_id:'3859448974125379', x: 0.5, y: 0.8 } ]&access_token=EAAOc...

응답

{
  "success": true
}

읽기

GET /{ig-media-id}/product_tags

IG 미디어에 대한 제품 태그 컬렉션을 가져옵니다. 제품 태그 절차에 대한 자세한 내용은 제품 태그 가이드를 참조하세요.

제한 사항

Instagram 크리에이터 계정은 지원되지 않습니다.
스토리, Instagram TV, 릴스, 라이브 및 언급은 지원되지 않습니다.

요구 사항

유형	요구 사항
액세스 토큰	사용자
비즈니스 역할	앱 사용자는 IG 사용자의 Instagram Shop을 소유하는 비즈니스 관리자에 대한 관리자 역할을 보유하고 있어야 합니다.
Instagram Shop	IG 미디어를 소유하는 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-media-id}/product_tags
  ?access_token={access-token}

경로 매개변수

자리 표시자	값
`{api-version}`	API 버전
`{ig-media-id}`	필수 항목. IG 미디어 ID

쿼리 문자열 매개변수

키	자리 표시자	값
`access_token`	`{access-token}`	필수 항목. 앱 사용자의 사용자 액세스 토큰입니다.

응답

IG 미디어에 대한 제품 태그 배열을 포함하는 JSON 형식 개체. 응답은 다음의 제품 태그 필드를 포함할 수 있습니다.

{
  "data": [
    {
      "product_id": {product-id},
      "merchant_id": {merchant-id},
      "name": "{name}",
      "price_string": "{price-string}",
      "image_url": "{image-url}",
      "review_status": "{review-status}",
      "is_checkout": {is-checkout},
      "stripped_price_string": "{stripped-price-string}",
      "string_sale_price_string": "{string-sale-price-string}",
      "x": {x},
      "y": {y}
    }
  ]
}

응답 내용

속성	값
`product_id`	제품 ID.
`merchant_id`	판매자 ID.
`name`	제품 이름.
`price_string`	가격 문자열.
`image_url`	제품 이미지 URL.
`review_status`	제품 검토 상태. 다음과 같은 값을 사용할 수 있습니다. `approved` — 제품이 승인되었습니다. `rejected` — 제품이 거부되었습니다. `pending` — 아직 검토 중입니다. `outdated` — 제품이 승인되었지만 수정되었으므로 재승인이 필요합니다. `""` — 검토 상태가 없습니다.
`is_checkout`	`true`인 경우 Instagram 앱에서 직접 제품을 구매할 수 있습니다. `false`인 경우 판매자의 웹사이트에서만 제품을 구매할 수 있습니다.
`stripped_price_string`	축약된 제품 가격 문자열(가격이 제한된 공간에 표시됨(예: `100 USD` 대신 `$100`)).
`string_sale_price_string`	제품 세일 가격.
`x`	미디어 이미지의 왼쪽 가장자리에서부터의 비율 거리를 나타내는 부동 소수점. 값은 `0.0`~`1.0` 범위 이내여야 합니다.
`y`	미디어 이미지의 상단 가장자리에서부터의 비율 거리를 나타내는 부동 소수점. 값은 `0.0`~`1.0` 범위 이내여야 합니다.

cURL 예시

요청

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

응답

{
  "data": [
    {
      "product_id": 3231775643511089,
      "merchant_id": 90010177253934,
      "name": "Gummy Bears",
      "price_string": "$3.50",
      "image_url": "https://scont...",
      "review_status": "approved",
      "is_checkout": true,
      "stripped_price_string": "$3.50",
      "stripped_sale_price_string": "$3",
      "x": 0.5,
      "y": 0.80000001192093
    }
  ]
}

업데이트

만들기를 참조하세요.

삭제

DELETE /{ig-media-id}/product_tags

기존 IG 미디어에 대한 제품 태그를 삭제합니다.

제한 사항

Instagram 크리에이터 계정은 지원되지 않습니다.
스토리, Instagram TV, 릴스, 라이브 및 언급은 지원되지 않습니다.

요구 사항

유형	요구 사항
액세스 토큰	사용자
비즈니스 역할	앱 사용자는 IG 사용자의 Instagram Shop을 소유하는 비즈니스 관리자에 대한 관리자 역할을 보유하고 있어야 합니다.
Instagram Shop	IG 미디어를 소유하는 IG 사용자는 제품이 포함된 제품 카탈로그가 있는 승인된 Instagram Shop이 있어야 합니다.
권한	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` 또한 앱 사용자가 타게팅된 IG 사용자에 연결된 페이지에서 비즈니스 관리자를 통해 역할을 부여받은 경우 다음 중 하나도 필요합니다. `ads_management` `business_management`

요청 구문

DELETE https://graph.facebook.com/{api-version}/{ig-media-id}/product_tags
  ?deleted_tags={deleted-tags}
  &access_token={access-token}

경로 매개변수

자리 표시자	값
`{api-version}`	API 버전
`{ig-media-id}`	필수 항목. IG 미디어 ID

쿼리 문자열 매개변수

키 자리 표시자 값

access_token

{access-token}

필수 항목. 앱 사용자의 사용자 액세스 토큰입니다.

deleted_tags

{deleted-tags}

필수 항목. 삭제할 각 제품 태그에 대한 다음 정보를 포함하는 배열입니다.

merchant_id — 필수 항목. 판매자 ID.
product_id — 필수 항목. 제품 ID.

응답

성공 또는 실패를 나타내는 개체.

{
  "success": {success}
}

응답 내용

속성	값
`success`	IG 미디어에 대해 지정된 제품 태그를 삭제할 수 있으면 `true`를 반환하고 그 외의 경우에는 `false`를 반환합니다.

cURL 예시

요청

curl -i -X DELETE \
  "https://graph.facebook.com/v19.0/90010778325754/product_tags?deleted_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20merchant_id%3A'90010177253934'%0A%20%20%7D%0A%5D&access_token=EAAOc..."

참고로 HTML로 디코딩된 POST 페이로드 문자열은 다음과 같습니다.

https://graph.facebook.com/v12.0/90010778325754/product_tags?deleted_tags=[ { product_id:'3859448974125379', merchant_id:'90010177253934' } ]&access_token=EAAOc...

응답

{
  "success": true
}