Отметки людей и место в публикации Instagram через API
API Instagram отмечает людей через user_tags и добавляет место через location_id. Оба параметра задаются в медиаконтейнере до публикации. user_tags принимает публичные имена пользователей с координатами x и y от 0.0 до 1.0, которые обязательны для изображений. Meta описывает их для изображений, видео и Stories. location_id принимает ID Страницы с данными о местоположении, который находится через Pages Search API.
easyCoexistence публикует фото, карусели, Reels и Stories через publish_instagram_post из Claude, ChatGPT или вашего кода.
Диапазон координат x и y в user_tags, отсчитываемых от левого и верхнего края изображения.
Где user_tags требует x и y: на Stories они необязательны, а параметры применяются только к изображениям и Stories.
location_id не поддерживается для изображений и видео внутри карусели, как указано в справочнике медиа Meta.
Значение config_issue, когда публикация выходит без отметок пользователей; Meta называет это частичным успехом.
Когда Meta открыла отметку локаций и публичных аккаунтов Instagram в фото, опубликованных через API, сначала для бета-партнёров.
Как отмечать людей в публикации?
Добавьте user_tags в контейнер. Это массив объектов, каждый с именем пользователя публичного аккаунта Instagram и, для изображения, x и y: числа с плавающей точкой от 0.0 до 1.0, задающие расстояние отметки от левого и верхнего края. Место указывается в location_id в том же запросе, после чего контейнер публикуется через media_publish, как обычно.
POST /<IG_ID>/media
Content-Type: application/json
{
"image_url": "https://example.com/team.jpg",
"caption": "<CAPTION>",
"user_tags": [
{ "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
],
"location_id": "<PAGE_ID>"
}Какие публикации принимают отметки и место?
Справочник медиа Meta описывает user_tags для изображений, видео и Stories; x и y применяются только к изображениям и Stories. Там же перечислены параметры, которые принимает каждый контейнер. В карусели место указывается в контейнере карусели, так как location_id не поддерживается для изображений и видео внутри неё:
Как найти location_id?
Найдите Страницу. location_id: ID Страницы, связанной с локацией. Справочник Meta указывает на Pages Search API: GET /pages/search с q и fields=id,name,location, а затем на проверку, что выбранная Страница содержит данные о местоположении. Страница без них вызывает ошибку INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Поиск выполняется в Graph API Meta с токеном вашего приложения Meta: пользовательским токеном или, для публичной информации о Странице, токеном приложения с функцией Page Public Metadata Access.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>Что происходит, если отметка не прикрепилась?
Публикация всё равно может выйти. media_publish тогда возвращает config_issue со значением USER_TAGGING_FAILURE, что означает публикацию без отметок пользователей. Meta называет это частичным успехом и просит приложения считать это сигналом для сверки, а не ошибкой, так как ID медиа действителен. Повторная публикация создаст второй пост.
Работают ли отметки пользователей с Instagram Login?
Справочник медиа Meta перечисляет user_tags и location_id для создания контейнера, не привязывая их к одному типу входа. Однако его страница об Instagram API с Instagram Login утверждает, что такая настройка не имеет доступа к рекламе или отметкам, не уточняя, каким именно. Прежде чем строить на любом из параметров с Instagram Login, опубликуйте тестовую публикацию и проверьте ответ и саму публикацию.
Как отмечать людей через easyCoexistence?
Пока нельзя. publish_instagram_post сам создаёт контейнер и не принимает user_tags или location_id, а токены Instagram не выдаются для собственного вызова. Опубликуйте пост через publish_instagram_post, затем добавьте отметки и локацию в приложении Instagram, через пункт «Редактировать» у публикации.
Распространённые ошибки
- Отсутствие x и y у отметки на изображении. Meta требует их для изображений; только для Stories они необязательны.
- Координаты в пикселях или процентах. Значения x и y задаются числами с плавающей точкой от 0.0 до 1.0, отсчитываемыми от левого и верхнего края.
- Установка location_id на элементах карусели. Meta не поддерживает его для изображений или видео внутри карусели.
- Отметка закрытого аккаунта. user_tags принимает имена пользователей публичных аккаунтов Instagram.
Инструмент не принимает user_tags и location_id, поэтому людей и места отмечают в приложении Instagram, через пункт «Редактировать» у публикации. От US$ 9 до US$ 0,75 за подключение в месяц, с уменьшением по мере добавления подключений, и с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Можно ли отметить закрытый аккаунт Instagram через API?
Нет. Справочник медиа Meta указывает, что user_tags принимает имена публичных аккаунтов Instagram, поэтому закрытый аккаунт таким способом не отметить.
Сколько людей можно отметить в одной публикации?
Справочник Meta для user_tags не задаёт максимума. Ограничение в 20 упомянуто для @-отметок в подписи.
Можно ли добавить место к Stories через API?
Нет. Синтаксис контейнера Stories у Meta перечисляет user_tags, но не location_id.
Можно ли отметить товар вместо человека?
Отметки товаров являются отдельной функцией. Обзор Meta указывает, что она поддерживается с Facebook Login и Unified Login, но не с Instagram Login.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на