IGユーザー

InstagramビジネスアカウントまたはInstagramクリエイターアカウントを表します。

作成

この操作はサポートされていません。

読み取り

GET /{ig-user-id}

Instagramビジネスアカウントまたはクリエイターアカウントについてのフィールドおよびエッジを取得します。

要件

型	説明
アクセストークン	ユーザー。
ビジネスの役割	商品タグ付けの`shopping_product_tag_eligibility`フィールドをリクエストする場合、IGユーザーのInstagramショップを所有するビジネスマネージャの管理者の役割をアプリユーザーが持っていなければなりません。
Instagramショップ	商品タグ付けの`shopping_product_tag_eligibility`フィールドをリクエストする場合、商品を含む製品カタログを備えた、承認済みのInstagramショップをIGユーザーが所有していなければなりません。
アクセス許可	`instagram_basic` `pages_read_engagement` `pages_show_list` ビジネスマネージャを介してアプリユーザーにページに対する権限が付与されている場合は、次のいずれかが必要です。 `ads_management` `business_management` 商品タグ付けのための`shopping_product_tag_eligibility`フィールドをリクエストしている場合、以下も必要です。 `catalog_management` `instagram_shopping_tag_products`

リクエストの構文

GET https://graph.facebook.com/{api-version}/{ig-user-id}
  ?fields={fields}
  &access_token={access-token}

パスパラメーター

プレースホルダー	値
`{api-version}`	APIのバージョン。
`{ig-user-id}`	必須。IGユーザーID。

クエリ文字列パラメーター

キー	プレースホルダー	値
`access_token`	`{access-token}`	必須。アプリユーザーのユーザーアクセストークン。
`fields`	`{fields}`	各IGユーザーについて戻り値として結果セットに入れる、IGユーザーのフィールドのコンマ区切りリスト。

フィールド

フィールド拡張を使って、公開フィールドをエッジから返すことが可能です。

フィールド名	説明
`biography` 公開	プロフィール自己紹介テキスト。
`id` 公開	app-scoped user ID
`ig_id`	InstagramユーザーID。レガシーInstagram APIで使用。現在は廃止。代わりに`id`を使用します。
`followers_count` 公開	このユーザーをフォローするInstagramユーザーの合計数。
`follows_count`	このユーザーがフォローするInstagramユーザーの合計数。
`media_count` 公開	このユーザーで公開されているIGメディアの合計数。
`name`	プロフィール名。
`profile_picture_url`	プロフィール写真のURL。
`shopping_product_tag_eligibility`	アプリユーザーがInstagramショップを設定しており、商品タグ付けの対象である場合は`true`を返します。それ以外の場合は`false`を返します。
`username` 公開	プロフィールユーザー名。
`website` 公開	単一のプロフィールウェブサイトのURL。

エッジ

エッジ	説明
`business_discovery`	他のInstagramビジネスまたはInstagramクリエイターであるIGユーザーに関するデータを取得します。
`content_publishing_limit`	IGユーザーの現在のコンテンツ公開の使用状況を表します。
`insights`	IG ユーザーについてのソーシャルインタラクション指標を表します。
`live_media`	IGユーザーのライブ動画IGメディアのコレクションを表します。
`media`	IGユーザーのIGメディアのコレクションを表します。
`media_publish`	Instagram Business IGユーザーのIGコンテナを公開します。
`mentions`	IGユーザーが別のInstagramユーザーによって@mentionされたIGコメントまたはキャプションの付いたIGメディアに対するIGコメントを作成します。
`mentioned_comment`	別のInstagramユーザーによりIGユーザーが@メンションされたIGコメントに関するデータを取得します。
`mentioned_media`	別のInstagramユーザーのキャプション内でIGユーザーが@メンションされたIGメディアに関するデータを取得します。
`recently_searched_hashtags`	過去7日間にIGユーザーが検索したIGハッシュタグを取得します。
`stories`	IGユーザーのストーリーズIGメディアオブジェクトのコレクションを表します。
`tags`	別のInstagramユーザーによりIGユーザーがタグ付けされたIGメディアのコレクションを表します。

応答

デフォルトとリクエストのフィールドおよびエッジを含む、JSON形式のオブジェクト。

{
  "{field}":"{value}",
  ...
}

cURLの例

リクエスト

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

応答

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

更新

この操作はサポートされていません。

削除

この操作はサポートされていません。