IG 사용자

Instagram 비즈니스 계정 또는 Instagram 크리에이터 계정을 나타냅니다.

문서 전체에서 'Instagram 사용자'와 'Instagam 계정'은 같은 의미로 사용됩니다. 두 용어 모두 앱 사용자의 Instagram 프로페셔널 계정을 나타냅니다.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic`	`instagram_basic` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

만들기

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

읽기

GET /<IG_USER_ID>

Instagram 비즈니스 또는 크리에이터 계정에 대한 필드와 에지를 가져옵니다.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

요청 구문

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

경로 매개변수

자리 표시자	값
`<API_VERSION>`	API 버전.
`<IG_USER_ID>`	필수 사항. IG 사용자 ID.

쿼리 문자열 매개변수

키	자리 표시자	값
`access_token`	`<ACCESS_TOKEN>`	필수 사항. 앱 사용자의 사용자 액세스 토큰입니다.
`fields`	`<LIST_OF_FIELDS>`	결과 세트에서 각 IG 사용자에 대해 반환하고자 하는 IG 사용자 필드를 쉼표로 구분한 리스트입니다.

필드

전체 공개 필드는 필드 확장을 사용하여 에지를 통해 반환될 수 있습니다. 일부 필드만 페이지 지원 Instagram 계정에 액세스하는 데 사용할 수 있습니다.

필드 이름	설명
`alt_text` 전체 공개	접근성을 위해 이미지를 설명하는 텍스트.
`biography` 전체 공개	프로필 약력 텍스트.
`followers_count` 전체 공개	사용자를 팔로우하는 Instagram 사용자 총수입니다.
`follows_count`	사용자가 팔로우하는 Instagram 사용자 총수입니다.
`has_profile_pic`	앱 사용자의 Instagram 프로페셔널 계정에 프로필 사진이 있는지 나타냅니다.
`id` 전체 공개	앱 범위 사용자 ID입니다. 페이지 지원 Instagram 계정에 제공됩니다.
`is_published`	앱 사용자의 Instagram 계정이 공개되어 있는지 나타냅니다. 페이지 지원 Instagram 계정에 제공됩니다.
`legacy_instagram_user_id`	마케팅 API 엔드포인트 v21.0 이하에서 사용하도록 생성된 앱 사용자의 Instagram ID입니다. 페이지 지원 Instagram 계정에 제공됩니다.
`media_count` 전체 공개	앱 사용자의 계정에 게시된 IG 미디어의 총 개수입니다.
`name`	앱 사용자의 Instagram 프로필 이름입니다.
`profile_picture_url`	앱 사용자의 Instagram 프로필 사진 URL.
`collaborative_media_search`	ID로 특정 콜라보 미디어를 검색합니다. 필드 확장을 통해 액세스합니다. Facebook 로그인을 통한 Instagram API에만 사용할 수 있습니다.
`shopping_product_tag_eligibility`	앱 사용자가 Instagram Shop을 설정해서 제품 태그가 가능한 경우 `true`를 반환하고, 그렇지 않을 경우 `false`를 반환합니다.
`username` 전체 공개	앱 사용자의 Instagram 프로필 사용자 이름입니다.
`website` 전체 공개	앱 사용자의 웹사이트 URL입니다.

에지

에지	설명
`agencies`	이 Instagram 프로페셔널 계정의 광고를 집행할 수 있는 비즈니스의 리스트입니다.
`authorized_adaccounts`	이 Instagram 프로페셔널 계정의 광고를 집행할 수 있는 광고 계정입니다.
`business_discovery`	다른 Instagram 비즈니스 또는 Instagram 크리에이터 IG 사용자에 대한 데이터를 가져옵니다.
`connected_threads_user`	Instagram 계정에 연결된 Threads 계정을 나타냅니다.
`content_publishing_limit`	IG 사용자의 현재 콘텐츠 게시 사용량을 나타냅니다.
`insights`	IG 사용자에 대한 소셜 상호 작용 지표를 나타냅니다.
`instagram_backed_threads_user`	Instagram 계정 기반의 Threads 계정을 나타냅니다.
`live_media`	IG 사용자에 대한 라이브 방송 IG 미디어의 컬렉션을 나타냅니다.
`media`	IG 사용자에 대한 IG 미디어의 컬렉션을 나타냅니다.
`media_publish`	Instagram 비즈니스 IG 사용자에 대한 IG 컨테이너를 게시합니다.
`mentions`	IG 사용자가 다른 Instagram 사용자가 @언급한 IG 댓글이나 캡션이 있는 IG 미디어에 IG 댓글을 생성합니다.
`mentioned_comment`	다른 Instagram 사용자가 @언급한 IG 사용자에 대한 IG 댓글 데이터를 가져옵니다.
`mentioned_media`	다른 Instagram 사용자가 캡션에서 IG 사용자를 @언급한 IG 미디어 데이터를 가져옵니다.
`recently_searched_hashtags`	IG 사용자가 최근 7일 이내에 검색한 IG 해시태그를 가져옵니다.
`stories`	IG 사용자에 대한 스토리 IG 미디어 개체의 컬렉션을 나타냅니다.
`tags`	다른 Instagram 사용자가 IG 사용자를 태그한 IG 미디어의 컬렉션을 나타냅니다.
`upcoming_events`	이 Instagram 프로페셔널 계정이 진행하는 이벤트의 리스트입니다.
`collaboration_invites`	IG 사용자가 공동 작업에 초대된 `IG Media` 개체 속성(media_id, media_owner_username, caption, media_url)의 컬렉션을 나타냅니다.
`collaborative_media`	IG 사용자가 수락된 공동 작업자인 IG 미디어의 컬렉션을 나타냅니다. 사용자가 직접 소유한 미디어는 포함하지 않습니다. Facebook 로그인을 통한 Instagram API에만 사용할 수 있습니다.

응답

기본 및 요청된 필드와 에지를 포함하는 JSON 형식의 개체입니다.

{
  "<FIELD>":"<VALUE>",
  ...
}

cURL 예시

요청

curl -X GET \
  'https://graph.facebook.com/v25.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

응답

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

업데이트

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

삭제

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