通过 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。
user_tags 中 x 和 y 的取值范围,从图片的左边缘和上边缘开始计算。
user_tags 在何种情况下需要 x 和 y:在 Stories 上为可选,且仅适用于图片和 Stories。
Meta 的媒体参考文档指出,location_id 不支持轮播中的图片或视频。
媒体发布时未带上用户标记,返回的 config_issue 值,Meta 将其称为部分成功。
Meta 何时开放在通过 API 发布的照片中标记地点和公开 Instagram 用户,首先面向测试合作伙伴。
如何在帖子中标记人物?
在容器上添加 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。搜索在 Meta Graph API 上运行,使用您自己 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 天免费试用。
常见问题
能通过 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 监控
验证时间