ログイン無料トライアルを開始
easyCoexistence 公式 API

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 で写真、カルーセル、リール、ストーリーズを公開できます。

0.0 to 1.0

user_tags の x と y の範囲。画像の左端と上端から測った値です。

Images

user_tags で x と y が必須となる箇所。ストーリーズでは任意で、適用対象は画像とストーリーズのみです。

Carousels

location_id は、Meta のメディアリファレンスによると、カルーセル内の画像や動画ではサポートされていません。

USER_TAGGING_FAILURE

メディアは公開されたがユーザータグが付かなかった場合の config_issue の値。Meta はこれを部分的な成功と呼んでいます。

13 Mar 2018

Meta が API 公開の写真で位置情報と公開 Instagram ユーザーへのタグ付けを開放した時期(最初はベータパートナーのみ)。

投稿に人をタグ付けするにはどうすればよいですか?

コンテナに user_tags を追加します。これは配列で、各要素に公開 Instagram アカウントのユーザー名と、画像の場合は x と y を含みます。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 は画像、動画、ストーリーズを対象とし、x と y は画像とストーリーズのみに適用されます。各コンテナが受け付けるパラメータも記載されています。カルーセルの場合、位置情報はカルーセルのコンテナに指定します。カルーセル内の画像や動画では 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 はどうやって見つけますか?

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 機能を持つアプリトークンを使います。

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 は有効なため、再度公開すると投稿が 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 アカウントのユーザー名だけです。
EasyCoexistence で実現する

このツールは 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 監視

確認日