Платформа Instagram

IG User

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

Создание

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

Чтение

GET /{ig-user-id}

Получение полей и границ контекста аккаунта Instagram Business или аккаунта автора.

Требования

ТипОписание

Маркеры доступа

Пользователь.

Роли в Business Manager

Если вы запрашиваете поле shopping_product_tag_eligibility для меток товаров, пользователь приложения должен иметь роль администратора в том Business Manager, который владеет Instagram Магазином, связанным с IG User.

Магазин в Instagram

Если вы запрашиваете поле shopping_product_tag_eligibility для меток товаров, пользователь IG User должен иметь утвержденный Instagram Магазин с каталогом, в котором указаны продукты.

Разрешения

instagram_basic
pages_read_engagement
pages_show_list


Если пользователь приложения получил роль на Странице через Business Manager, вам также потребуется одно из этих разрешений:


ads_management
business_management


Если вы запрашиваете поле shopping_product_tag_eligibility для меток товаров, вам также понадобится:


catalog_management;
instagram_shopping_tag_products.

Синтаксис запроса

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

Параметры пути

ЗаполнительЗначение

{api-version}

Версия API.

{ig-user-id}

Обязательный параметр. ID пользователя IG User.

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

КлючЗаполнительЗначение

access_token

{access-token}

Обязательный параметр. Маркер доступа пользователя приложения.

fields

{fields}

Разделенный запятыми список полей IG User, которые нужно вернуть для каждого объекта IG User из списка результатов.

Поля

Общедоступные поля можно получить через границу контекста, используя расширение поля.

Имя поляОписание

biography
Общедоступно

Текст биографии профиля.

id
Общедоступно

ID пользователя внутри приложения.

ig_id

ID пользователя Instagram. Используется в устаревшем Instagram API, упразднено. Используйте вместо него id.

followers_count
Общедоступно

Общее количество подписчиков пользователя Instagram.

follows_count

Общее количество людей, на которых подписан пользователь Instagram.

media_count
Общедоступно

Общее количество объектов IG Media, опубликованных пользователем.

name

Имя профиля.

profile_picture_url

URL фото профиля.

shopping_product_tag_eligibility

Возвращает true, если пользователь приложения настроил магазин в Instagram и его товары можно отмечать. В противном случае возвращает значение false.

username
Общедоступное

Имя пользователя профиля.

website
Общедоступное

URL сайта профиля.

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

Граница контекстаОписание

business_discovery

Позволяет получить информацию о других аккаунтах IG User Instagram Business или автора.

content_publishing_limit

Показывает, как используется публикация контента пользователем IG User.

insights

Представляет метрики социального взаимодействия для объекта IG User.

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.

Ответ

Объект в формате JSON со стандартными и запрошенными полями и границами контекста.

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

Пример запроса cURL

Запрос

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

Ответ

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

Обновление

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

Удаление

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