API で Instagram 投稿にユーザーをタグ付けし、位置情報を追加する
Instagram API では、メディアコンテナを公開する前に、user_tags でユーザーをタグ付けし、location_id で位置情報を追加します。user_tags には公開 Instagram アカウントのユーザー名を指定する配列を渡し、画像では x と y の座標(0.0 から 1.0 まで)が必須です。Meta はこの機能を画像、動画、ストーリーズを対象として説明しています。location_id には、位置情報データを持つ Page の ID を指定します。その ID は Pages Search API で検索できます。
easyCoexistence は、Claude、ChatGPT、または自分のコードから publish_instagram_post で写真、カルーセル、リール、ストーリーズを公開できます。
user_tags の x と y の範囲。画像の左端と上端から測った値です。
user_tags で x と y が必須となる箇所。ストーリーズでは任意で、適用対象は画像とストーリーズのみです。
location_id は、Meta のメディアリファレンスによると、カルーセル内の画像や動画ではサポートされていません。
メディアは公開されたがユーザータグが付かなかった場合の config_issue の値。Meta はこれを部分的な成功と呼んでいます。
Meta が API 公開の写真で位置情報と公開 Instagram ユーザーへのタグ付けを開放した時期(最初はベータパートナーのみ)。
投稿に人をタグ付けするにはどうすればよいですか?
コンテナに user_tags を追加します。これは配列で、各要素に公開 Instagram アカウントのユーザー名と、画像の場合は x と y を含みます。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 は画像、動画、ストーリーズを対象とし、x と y は画像とストーリーズのみに適用されます。各コンテナが受け付けるパラメータも記載されています。カルーセルの場合、位置情報はカルーセルのコンテナに指定します。カルーセル内の画像や動画では location_id がサポートされていないためです。
location_id はどうやって見つけますか?
Page を検索します。location_id は、位置情報に関連付けられた Page の ID です。Meta のリファレンスでは、Pages Search API(GET /pages/search、パラメータ q と fields=id,name,location)を使い、選んだ Page に位置情報データがあるか確認するよう案内しています。位置情報データのない Page では INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID エラーになります。この検索は、Meta の Graph API に対して自分の Meta アプリのトークンで実行します。ユーザートークンを使うか、公開 Page 情報の場合は 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 は有効なため、再度公開すると投稿が 2 つできてしまいます。
ユーザータグは Instagram Login でも使えますか?
Meta のメディアリファレンスでは、user_tags と location_id はいずれもコンテナ作成時に使えると記載されており、特定のログイン方式に限定されていません。一方、Instagram Login を使う Instagram API のページでは、その設定では広告やタグ付けにアクセスできないとあります。どの種類のタグ付けかは明記されていません。Instagram Login でどちらかのパラメータを使う前に、テスト投稿を公開し、レスポンスと投稿そのものを確認してください。
easyCoexistence でどうやって人をタグ付けしますか?
まだできません。publish_instagram_post はコンテナを自分で作成し、user_tags も location_id も受け付けません。また、Instagram のトークンは独自の呼び出し用には渡されません。publish_instagram_post で投稿を公開し、そのあと Instagram アプリで、投稿の編集オプションからタグと場所を追加してください。
よくある間違い
- 画像へのタグで x と y を省略すること。Meta は画像では必須とし、ストーリーズのみ任意です。
- 座標をピクセルやパーセントで指定すること。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 アカウントのユーザー名だけです。そのため、非公開アカウントをこの方法でタグ付けすることはできません。
1 つの投稿に何人までタグ付けできますか?
Meta の user_tags のリファレンスには上限が記載されていません。記載されている 20 という上限は、キャプション内の @ タグに対するものです。
API でストーリーズに位置情報を追加できますか?
いいえ。Meta のストーリーズ用コンテナの構文には user_tags はありますが、location_id はありません。
人ではなく商品をタグ付けできますか?
商品タグは別の機能です。Meta の概要によると、Facebook Login と Unified Login でサポートされており、Instagram Login ではサポートされていません。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日