このドキュメントが更新されました。
日本語への翻訳がまだ完了していません。

英語の最終更新: 9月2日

IGメディア

Instagramのアルバム、写真、動画(アップロードされた動画、ライブ動画、Instagram TVアプリで作成された動画、リール動画、ストーリーズ)を表します。

2024年6月3日より、boost_eligibility_infoフィールドを使って、メディアを広告として宣伝できるかどうかを簡単かつ効率的に確認できるようになりました。また、boost_ads_listを使うことで、その広告に関連する過去のInstagram広告情報の追跡も可能になりました。詳しくは、ブログをご覧ください。InstagramグラフAPIでのみ利用可能です。

作成

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

読み取り

GET /<IG_MEDIA_ID>

IGメディアのフィールドとエッジを取得します。

制限

集計された値を返すフィールドに、広告ドリブンデータは含まれません。例えば、comments_countは写真に付けられたコメントの数をカウントしますが、その写真を含む広告に付けられたコメントはカウントしません。
アプリユーザーが管理者と同等のタスクをアプリで実行できない限り、キャプションに@記号は含まれません。
permalinkなど、一部のフィールドは、アルバム(子)内の写真には使えません。
ライブ動画IGメディアは、配信中のみ読み取り可能です。
このAPIは、Instagramプロアカウントが所有するメディアのデータのみを返します。個人用Instagramアカウントが所有するメディアのデータを取得するために使用することはできません。

リクエストの構文

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

パスパラメーター

プレースホルダー	値
`<API_VERSION>`	APIのバージョン。
`<IG_MEDIA_ID>`	必須。公開されるメディアのID。

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

キー	プレースホルダー	値
`access_token`	`<ACCESS_TOKEN>`	必須。アプリユーザーのユーザーアクセストークン
`fields`	`<LIST_OF_FIELDS>`	戻り値を取得するフィールドのコンマ区切りリスト。

フィールド

公開フィールドは、フィールド拡張機能で読み取ることができます。

フィールド説明

boost_ads_list

オーガニックメディアに関連するすべてのInstagram広告情報の概要を提供します。これには、相対的な広告IDと広告配信ステータスが含まれます。InstagramグラフAPIでのみ利用可能です。

boost_eligibility_info

このフィールドには、広告としてのIG instagramメディアの利用資格を引き上げるための情報と、利用資格がない場合の追加の詳細が表示されます。InstagramグラフAPIでのみ利用可能です。

caption
公開

キャプション。アルバムの子を除きます。@記号は、キャプション(InstagramグラフAPIのみ)の作成に使用されたInstagramアカウントにリンクしているFacebookページに対し、アプリユーザーが管理者と同等のタスクを実行できない限り、除外されます。

comments_count
公開

メディアに付けられたコメントの数。アルバムの子メディアとメディアのキャプションに付けられたコメントを除きます。コメントへの返信を含みます。

copyright_check_information.status

statusオブジェクトとmatches_foundオブジェクトを返します

statusオブジェクト説明

status

completed – 検出処理は終了しました
error – 検出処理でエラーが発生しました
in_progress – 検出処理は実行中です
not_started – 検出処理はまだ始まっていません

matches_found

以下のいずれかを設定します。

動画が著作権違反をしていない場合は、false
動画が著作権違反をしている場合は、true

動画が著作権違反をしている場合、著作権が保護されているマテリアルのオブジェクト配列と、違反が動画内で発生している場合は、その違反を軽減するために取るべきアクションの配列を含むcopyright_matchesが返されます。

copyright_matchesオブジェクト	説明
`author`	著作権が保護されている動画の作成者
`content_title`	著作権が保護されている動画の名前
`matched_segments`	次のキー:値ペアを含むオブジェクトの配列: * `duration_in_seconds` – コンテンツが著作権違反している秒数 * `segment_type` – `AUDIO`または`VIDEO`のいずれか * `start_time_in_seconds` – 動画の開始時間に設定
`owner_copyright_policy`	返されるオブジェクトには次のものが含まれます。 `name` – 著作権所有者のポリシーの名前。 `actions` – 著作権所有者のポリシーで定義された緩和ステップを含む`action`オブジェクトの配列。場所によって異なる緩和ステップが含まれる場合があります。 `action` – 著作権違反をしている動画に対する緩和措置。緩和の手順は、国によって異なる可能性があります。次のいずれかの値になります。 `BLOCK` – 動画は、`geos`配列にリストされているオーディエンスに対してブロックされます `MUTE` - 動画は、`geos`配列にリストされているオーディエンスに対してミュートされます

id
公開

メディアID。

is_comment_enabled

コメントが有効か無効かを示します。アルバムの子を除きます。

is_shared_to_feed
公開

リールのみ。trueの場合、リール動画は[フィード]タブと[リール]タブの両方に表示されます。falseの場合、リール動画は[リール]タブだけに表示されます。

これらの値によって、リール動画が実際に[リール]タブに表示されるかどうかが決まるわけではありません。リール動画が資格条件を満たしていない場合や、当社のアルゴリズムで選択されない場合があるからです。資格条件については、リールの仕様をご覧ください。

like_count

メディアに対する「いいね！」の数。コメントに対する返信も含まれます。アルバムの子メディアへの「いいね！」と、メディアから作成された宣伝投稿への「いいね！」を除きます。

別のエンドポイントやフィールド展開を通して間接的に問い合わせた場合、メディアの所有者が「いいね！」の数を非表示にしている場合にlike_countフィールドは省略されます。

media_product_type
公開

メディアが公開されるサーフェス。AD、FEED、STORY、またはREELS。InstagramグラフAPIでのみ利用可能です。

media_type
公開

メディアタイプ。CAROUSEL_ALBUM、IMAGE、またはVIDEO。

media_url
公開

メディアのURL。

メディアに著作権対象コンテンツが含まれている場合や、著作権違反のフラグが付いている場合、media_urlフィールドは応答から省かれます。著作権対象コンテンツの例として、リールの音声などが挙げられます。

owner
公開

メディアを作成したInstagramユーザーID。クエリするアプリユーザーがメディアも作成した場合にのみ返されます。それ以外の場合は、代わりにusernameフィールドが返されます。

permalink
公開

メディアを指す永続URL。

shortcode
公開

メディアを指すショートコード。

thumbnail_url
公開

メディアのサムネイルURL。VIDEOメディアでのみ使用可能。

timestamp
公開

ISO 8601形式のUTCでの作成日(デフォルトはUTC ±00:00)。

username
公開

メディアを作成したユーザーのユーザーネーム。

エッジ

フィールド拡張により公開エッジを返すことが可能です。

エッジ	説明
`children` 公開。	アルバムIGメディアのIGメディアオブジェクトのコレクションを表します。
`collaborators`	IGメディアオブジェクトにコラボレーターとして追加されたユーザーのリストを表示します。InstagramグラフAPIでのみ利用可能です。
`comments`	IGメディアオブジェクトに関するIGコメントのコレクションを表します。
`insights`	IGメディアオブジェクトについてのソーシャルインタラクション指標を表します。InstagramグラフAPIでのみ利用可能です。

cURLの例

リクエストの例

curl -X GET \
  'https://graph.instagram.com/v21.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

応答の例

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

更新

POST /<IG_MEDIA_ID>

IGメディアに対するコメントを有効または無効にします。

制限

ライブ動画IGメディアはサポートされていません。

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic` `instagram_business_manage_comments`	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `business_management`