メンションされたメディア

別のInstagramユーザーのキャプション内でIGユーザーが@メンションされたIGメディアに関するデータを返します。

作成

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

読み取り

GET /{ig-user-id}?fields=mentioned_media.media_id

別のInstagramユーザーによりIGユーザーがキャプション内で@メンションされたIGメディアに関するデータを返します。

制限

ストーリーのメンションはサポートされていません。
自分がタグ付けされた写真へのコメントはサポートされていません。
コメントが付けられたメディアや@mentionが表示されるメディアが非公開設定のアカウントによって作成された場合、Webhooksは送信されません。

要件

タイプ説明

タイプ	説明
アクセストークン	ユーザー
アクセス許可	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` ビジネスマネージャでアプリユーザーにページに対する権限が付与されている場合は、次のいずれかも必要です。 `ads_management` `business_management`
タスク	`MANAGE`、`CREATE_CONTENT`、`MODERATE`

アクセストークン

ユーザー

アクセス許可

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

ビジネスマネージャでアプリユーザーにページに対する権限が付与されている場合は、次のいずれかも必要です。

ads_management
business_management

タスク

MANAGE、CREATE_CONTENT、MODERATE

リクエストの構文

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_media.media_id({media-id}){{fields}}
  &access_token={access-token}

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

パラメーター	値
`{access_token}` 必須文字列	アプリユーザーのユーザーアクセストークン。
`{fields}` コンマ区切りリスト	戻り値を取得するIGメディアフィールドのコンマ区切りリスト。省略した場合、デフォルトのフィールドが返されます。
`{media-id}` 必須文字列	IGユーザーがキャプション内で@メンションされたIGメディアのID。このIDはWebhook通知ペイロードに含まれています。

フィールド

フィールド	説明
`caption` 文字列	キャプションのテキスト。IGユーザーを@メンションしているキャプションに`@`記号は含まれません。ただし、キャプションが作成されたIGメディアオブジェクトをアプリユーザーが作成した場合は例外です。
`comments` オブジェクト	IGメディアのIGコメントのリスト。フィールド拡張機能を使用してコメントのテキストを取得している場合、IGユーザーを@メンションしているテキストに`@`記号は含まれません。ただし、キャプションが作成されたIGメディアオブジェクトをアプリユーザーが作成した場合は例外です。
`comments_count` 文字列	IGメディアのIGコメント数。
`id` デフォルト文字列	IGメディアのID。
`like_count` 文字列	メディアに対する「いいね！」の数。アルバムの子メディアへの「いいね！」と、そのメディアから作成された宣伝投稿への「いいね！」を除きます。コメントへの返信を含みます。 v10.0以前の場合の呼び出し: メディア所有者の「いいね！」数が非表示の場合は値が`0`になります。 v11.0以降の場合の呼び出し: メディア所有者の「いいね！」数が非表示の場合はフィールドが省略されます。メディア所有者の「いいね！」数が非表示の場合は値が`0`になります。
`media_type` 文字列	IGメディアのタイプ: `CAROUSEL_ALBUM`、`IMAGE`、`STORY`、または`VIDEO`。
`media_url` 文字列	公開されたIGメディアのURL。
`owner` 文字列	IGメディアを作成したIGユーザーのID。アプリユーザーがIGメディアオブジェクトを作成した場合のみ返されます。それ以外の場合は、代わりに`username`フィールドが返されます。
`timestamp` 文字列	ISO 8601形式のIGメディア作成日付。
`username` 文字列	IGメディアを作成したIGユーザーのユーザーネーム。

リクエストの例

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

応答の例

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

上記の応答例では、アプリユーザーがキャプションを作成したのではないため、APIにより元のキャプション(@metricsaurus headquarters!)から先頭の@記号が取り除かれています。

ページネーション

フィールド拡張機能を使用して、カーソルベースのページネーションをサポートするエッジにアクセスすると、応答のデータが複数ページにまたがる場合、応答にbeforeカーソルとafterカーソルが含まれます。ただし、通常のカーソルベースのページネーションとは異なり、応答にpreviousフィールドとnextフィールドは含まれません。そのため、返されたデータセットでページ移動するには、beforeカーソルとafterカーソルを使用してpreviousとnextクエリ文字列を手動で作成する必要があります。

更新

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

削除

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