유형	설명
액세스 토큰	사용자
기능	해당 사항 없음.
권한	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` 비즈니스 관리자를 통해 페이지 역할이 부여된 사용자에게서 받은 토큰일 경우 `ads_management`, `business_management`, `pages_read_engagement` 권한 중 하나도 필요합니다.
작업	앱 사용자는 앱에서 요청한 권한에 따라 페이지에서 적절한 작업을 수행할 수 있어야 합니다.

요청 구문

GET https://graph.facebook.com/{ig-user-id}/tags
  ?fields={fields}
  &access_token={access-token}

쿼리 문자열 매개변수

요청을 보강하기 위해 다음 쿼리 문자열 매개변수를 포함합니다.

키	값
`access_token` 필수 문자열	앱 사용자의 Instagram 사용자 액세스 토큰입니다.
`fields` 쉼표로 구분된 리스트	응답에 포함하고자 하는 필드와 에지의 쉼표로 구분된 리스트입니다. 생략할 경우 기본 필드가 반환됩니다.

필드

fields 쿼리 문자열 매개변수를 사용하여 반환된 IG 미디어 개체에 포함하고자 하는 필드를 지정하세요.

2021년 9월 7일까지 v10.0 이전 호출: IG 미디어의 like_count 필드는 미디어 소유자가 미디어의 좋아요 개수를 숨겼을 경우0을 반환합니다.

2021년 9월 7일에 v11.0 이상 호출 및 모든 버전: 다른 엔드포인트 또는 필드 확장을 통해 IG 미디어를 간접적으로 쿼리할 경우 미디어 소유자가 미디어의 좋아요 개수를 숨겼다면 like_count 필드는 API 응답에서 생략됩니다. IG 미디어를 직접 쿼리하면(IG 미디어 소유자만 가능) 좋아요 개수가 숨겨져 있더라도 실제 좋아요 개수가 반환됩니다.

에지

fields 쿼리 문자열 매개변수를 사용하여 반환된 IG 미디어 개체에 포함하고자 하는 에지를 지정하세요.

응답

IG 미디어 개체를 포함한 JSON 형식 개체.

{
  "{field}":"{value}",
  ...
}

페이지 매김

이 에지는 커서 기반 페이지 매김을 지원하므로 응답에 여러 페이지의 데이터가 포함되어 있을 경우 before와 after 커서가 포함됩니다. 그러나 표준 커서 기반 페이지 매김과 달리, 응답에는 previous 또는 next 필드가 포함되지 않으므로 before와 after 커서를 사용하여 수동으로 previous와 next 쿼리 문자열을 구성하고 반환된 데이터 세트에 페이지를 지정해야 합니다.

요청 샘플

GET graph.facebook.com/17841405822304914/tags
    ?fields=id,username
    &access_token=EAADd...

응답 샘플

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}

업데이트

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

삭제