IG User

Представляет бизнес-аккаунт Instagram или аккаунт автора.

В нашей документации термины "пользователь Instagram" и "аккаунт Instagram" взаимозаменяемы. Оба представляют собой профессиональный аккаунт пользователя приложения в 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 или аккаунта автора 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>`	Обязательный параметр. ID пользователя IG User.

Параметры строки запроса

Ключ	Заполнитель	Значение
`access_token`	`<ACCESS_TOKEN>`	Обязательный параметр. Маркер доступа пользователя приложения.
`fields`	`<LIST_OF_FIELDS>`	Разделенный запятыми список полей IG User, которые нужно вернуть для каждого объекта IG User из списка результатов.

Поля

Общедоступные поля можно получить через границу контекста, используя расширение поля. Для обращения к аккаунтам 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`	ID Instagram пользователя вашего приложения, созданный для конечных точек Marketing API для версии 21.0 и более ранних. Доступен для аккаунтов Instagram на базе Страницы.
`media_count` Общедоступное	Общее количество объектов IG Media, опубликованных в аккаунте пользователя приложения.
`name`	Имя профиля Instagram для пользователя приложения.
`profile_picture_url`	URL фото профиля Instagram вашего пользователя приложения.
`collaborative_media_search`	Поиск конкретного совместного медиафайла по ID. Доступ через расширение поля. Доступно только для Instagram API с входом через Facebook.
`shopping_product_tag_eligibility`	Возвращает значение `true`, если пользователь приложения настроил магазин Instagram и его товары можно отмечать. В противном случае возвращает значение `false`.
`username` Общедоступное	Имя пользователя профиля Instagram для пользователя приложения.
`website` Общедоступное	URL сайта пользователя приложения.

Границы контекста

Граница контекста	Описание
`agencies`	Список компаний, которые могут размещать рекламу в этом профессиональном аккаунте Instagram.
`authorized_adaccounts`	Список рекламных аккаунтов, которые могут размещать рекламу в этом профессиональном аккаунте Instagram.
`business_discovery`	Позволяет получить информацию о других аккаунтах IG User Instagram Business или автора.
`connected_threads_user`	Представляет аккаунт Threads, связанный с аккаунтом Instagram.
`content_publishing_limit`	Показывает, как используется публикация контента пользователем IG User.
`insights`	Представляет метрики социального взаимодействия для объекта IG User.
`instagram_backed_threads_user`	Представляет аккаунт Threads на базе аккаунта Instagram.
`live_media`	Представляет подборку объектов видео в прямом эфире IG Media объекта IG User.
`media`	Представляет подборку объектов IG Media объекта IG User.
`media_publish`	Публикует объект IG Container для пользователя Instagram Business IG User.
`mentions`	Позволяет создать комментарий IG Comment в ответ на комментарий IG Comment либо объект IG Media с подписью, в котором пользователя IG User @упомянул другой пользователь Instagram.
`mentioned_comment`	Позволяет получить данные комментария IG Comment, в котором пользователь IG User @упоминается другим пользователем Instagram.
`mentioned_media`	Позволяет получить данные объекта IG Media, в подписи к которому пользователя IG User @упомянул другой пользователь Instagram.
`recently_searched_hashtags`	Получение хэштегов IG Hashtag, по которым пользователь IG User выполнял поиск за последние семь дней.
`stories`	Представляет подборку объектов историй IG Media объекта IG User.
`tags`	Представляет подборку объектов IG Media, в которых пользователь IG User отмечен другим пользователем Instagram.
`upcoming_events`	Список мероприятий, которые проводятся в этом профессиональном аккаунте Instagram.
`collaboration_invites`	Представляет подборку атрибутов объекта `IG Media` (media_id, media_owner_username, caption, media_url), для работы с которыми пользователь Instagram был приглашен как соавтор.
`collaborative_media`	Представляет подборку объектов IG Media, в которых пользователь Instagram является принятым соавтором. Сюда не относятся медиафайлы, принадлежащие пользователю напрямую. Доступно только для Instagram API с входом через Facebook.

Ответ

Объект в формате 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/"
}

Обновление

Эта операция не поддерживается.

Удаление

Эта операция не поддерживается.