Business Discovery для объектов IG User

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

Создание

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

Чтение

GET /{ig-user-id}?fields=business_discovery.username({username})

Возвращает данные о другом аккаунте IG User Instagram Business или автора. Укажите аккаунт IG User Instagram Business или автора, который выполняет запрос. В параметре username укажите целевую компанию.

Ограничения

Данные об отфильтрованных по возрасту аккаунтах IG User Instagram Business не возвращаются.

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

{username} (обязательный): имя пользователя аккаунта IG User Instagram Business или автора, о котором нужно получить данные.

Разрешения

Маркер доступа пользователя Facebook со следующими разрешениями:

instagram_basic
instagram_manage_insights
pages_read_engagement или pages_show_list

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

ads_management
pages_read_engagement
business_management

Расширение поля

С помощью расширения поля можно получить общедоступные поля для интересующего вас аккаунта IG User. Список общедоступных полей см. в справке по IG User.

Пример запроса с расширением поля

Получение данных об аккаунте IG User Instagram Business "Blue Bottle Coffee" и запрос сведений о количестве его подписчиков и медиафайлов с помощью расширения поля.

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

Пример ответа

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Использование расширения поля для доступа к границам контекста.

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

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

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

Пример запроса с использованием границы контекста

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

Пример ответа с использованием границы контекста

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

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

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

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

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

Пример ответа

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

Обновление

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

Удаление

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