Graph API для Instagram

Метки

Представляет подборку объектов IG Media, в которых пользователь IG User отмечен другим пользователем Instagram.

Создание

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

Чтение

GET /{ig-user-id}/tags

Возвращает список объектов IG Media, в которых пользователь IG User был отмечен другим пользователем Instagram.

Ограничения

Закрытые объекты IG Media не возвращаются.

Требования

ТипОписание

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

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

Функции

Неприменимо.

Разрешения

instagram_basic
instagram_manage_comments
pages_read_engagement

pages_show_list


Если маркер доступа принадлежит пользователю, роль которого на Странице была назначена через Business Manager, также требуется одно из следующих разрешений: 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 Media.

Для вызовов версии 10.0 и более ранних до 7 сентября 2021 г.: поле like_count в IG Media теперь возвращает 0, если владелец медиафайла скрыл для него количество отметок "Нравится".

Для вызовов версии 11.0 и более поздних с 7 сентября 2021 г.: при непрямом запросе объекта IG Media через другую конечную точку или расширение поля в ответе на вызов API будет отсутствовать поле like_count, если владелец медиаобъекта скрыл количество поставленных ему отметок "Нравится". При прямом запросе объекта IG Media (который может совершить только его владелец) возвращается реальное количество отметок "Нравится", даже если этот показатель был скрыт.

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

С помощью параметра строки запроса fields можно указать границы контекста, которые должны включаться в ответ для возвращаемых объектов IG Media.

Ответ

Объект в формате JSON, содержащий объекты IG Media.

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

Разбивка на страницы

Эта граница контекста поддерживает разбивку на страницы с использованием курсора, поэтому ответ содержит курсоры before и after, если возвращаемые данные состоят из нескольких страниц. В отличие от стандартной разбивки на страницы с использованием курсора, ответ не содержит полей previous и next, поэтому вам потребуется вручную создавать строки запроса previous и next с помощью курсоров before и after для перехода по страницам полученного набора данных.

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

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..."
    }
  ]
}

Обновление

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

Удаление

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