登录开始免费试用
easyCoexistence 官方 API

通过 API 为 Instagram 帖子标记人物并添加位置

Instagram API 通过 user_tags 标记人物,并通过 location_id 添加位置,两者均在媒体容器发布前设置。user_tags 列出公开的用户名,图片上必须提供取值范围为 0.0 至 1.0 的 x 和 y 坐标。Meta 称其适用于图片、视频和 Stories。location_id 接受带有位置数据的主页的 ID,可通过 Pages Search API 查找。

easyCoexistence 可以从 Claude、ChatGPT 或您自己的代码中,通过 publish_instagram_post 发布图片、轮播、Reels 和 Stories。

0.0 to 1.0

user_tags 中 x 和 y 的取值范围,从图片的左边缘和上边缘开始计算。

Images

user_tags 在何种情况下需要 x 和 y:在 Stories 上为可选,且仅适用于图片和 Stories。

Carousels

Meta 的媒体参考文档指出,location_id 不支持轮播中的图片或视频。

USER_TAGGING_FAILURE

媒体发布时未带上用户标记,返回的 config_issue 值,Meta 将其称为部分成功。

13 Mar 2018

Meta 何时开放在通过 API 发布的照片中标记地点和公开 Instagram 用户,首先面向测试合作伙伴。

如何在帖子中标记人物?

在容器上添加 user_tags。它是一个对象数组,每个对象包含一个公开 Instagram 账户的用户名;如果是图片,还需包含 x 和 y,即取值 0.0 至 1.0 的浮点数,表示标记距离图片左边缘和上边缘的位置。位置通过同一调用中的 location_id 设置,随后照常使用 media_publish 发布该容器。

An image container with a user tag and a location
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:

Imageuser_tags with x and y, and location_id
Reeluser_tags by username, and location_id
Storyuser_tags, with x and y optional; no location_id in its syntax
Carousel containerlocation_id, and no user_tags in its syntax
Carousel itemsNo 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。搜索在 Meta Graph API 上运行,使用您自己 Meta 应用的访问令牌:用户访问令牌,或者在获取公开主页信息时使用带有 Page Public Metadata Access 功能的应用访问令牌。

Searching for a Page with a location
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 账户的用户名。
使用 EasyCoexistence 完成这些操作

该工具不接受 user_tags 或 location_id,因此请在 Instagram 应用中,通过帖子的编辑选项标记人物和地点。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。

常见问题

能通过 API 标记私人 Instagram 账户吗?

不能。Meta 的媒体参考文档说明 user_tags 只接受公开 Instagram 账户的用户名,因此无法通过这种方式标记私人账户。

一条帖子最多可以标记多少人?

Meta 的 user_tags 参考文档未给出上限。其中提到的 20 个限制针对的是说明文字中的 @ 标记。

能否通过 API 为 Story 添加位置?

否。Meta 的 Story 容器语法列出了 user_tags,但未列出 location_id。

能否标记商品而不是人物?

商品标记是一项独立功能。Meta 的概述列出其支持 Facebook Login 和 Unified Login,不支持 Instagram Login。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间