IGメディア

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

作成

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

読み取り

GET /{ig-media-id}

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

制限

  • 集計された値を返すフィールドに、広告ドリブンデータは含まれません。例えば、comments_countは写真に付けられたコメントの数をカウントしますが、その写真を含む広告に付けられたコメントはカウントしません。
  • アプリユーザーが管理者と同等のタスクをアプリで実行できない限り、キャプションに@記号は含まれません。
  • permalinkなど、一部のフィールドは、アルバム(子)内の写真には使えません。
  • APIを介してInstagram TVメディアにアクセスできるようにするには、公開時に([プレビューを投稿する]または[プレビューをフィードにシェアする]を有効にして) Instagram TVメディアをInstagramにシェアする必要があります。
  • ライブ動画IGメディアは、配信中のみ読み取り可能です。

要件

説明

アクセストークン

ユーザー

アクセス許可

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management
business_management

リクエストの構文

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

パスパラメーター

プレースホルダー

{api-version}

APIのバージョン

{ig-media-id}

必須。IGメディアID。

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

キープレースホルダー

access_token

{access-token}

必須。アプリユーザーのユーザーアクセストークン

fields

{fields}

戻り値を取得するフィールドのコンマ区切りリスト。

フィールド

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

フィールド説明

caption
公開

キャプション。アルバムの子を除きます。@記号は、キャプションの作成に使用された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_typeAUDIOまたはVIDEOのいずれか * start_time_in_seconds – 動画の開始時間に設定

owner_copyright_policy

返されるオブジェクトには次のものが含まれます。

  • name – 著作権所有者のポリシーの名前。
  • actions – 著作権所有者のポリシーで定義された緩和ステップを含むactionオブジェクトの配列。場所によって異なる緩和ステップが含まれる場合があります。

    • action – 著作権違反をしている動画に対する緩和措置。緩和の手順は、国によって異なる可能性があります。次のいずれかの値になります。
      • BLOCK – 動画は、geos配列にリストされているオーディエンスに対してブロックされます
      • MUTE - 動画は、geos配列にリストされているオーディエンスに対してミュートされます

id
公開

メディアID。

ig_id
公開

InstagramメディアID。レガシーInstagram APIで使用。現在は廃止。代わりにidを使用します。

is_comment_enabled

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

is_shared_to_feed
公開

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

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

like_count

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


別のエンドポイントまたはフィールド拡張機能経由で間接的にクエリされた場合。


  • v10.0以前の呼び出し: メディア所有者の「いいね!」の数が非表示の場合は値が0になります。
  • v11.0以降の呼び出し: メディア所有者が「いいね!」の数を非表示にしている場合、like_countフィールドは省かれます。

media_product_type
公開

メディアが公開されるサーフェス。ADFEEDSTORY、またはREELS

media_type
公開

メディアタイプ。CAROUSEL_ALBUMIMAGE、または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
公開

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

video_title
公開

廃止。応答から省略。

エッジ

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

エッジ説明

children
公開。

アルバムIGメディアIGメディアオブジェクトのコレクションを表します。

collaborators

IGメディアオブジェクトにコラボレーターとして追加されたユーザーのリストを表示します。

comments

IGメディアオブジェクトに関するIGコメントのコレクションを表します。

insights

IGメディアオブジェクトについてのソーシャルインタラクション指標を表します。

cURLの例

リクエスト

curl -X GET \
  'https://graph.facebook.com/v19.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メディアはサポートされていません。

要件

説明

アクセストークン

ユーザー

アクセス許可

instagram_basic
instagram_manage_comments
pages_show_list


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


ads_management
business_management

リクエストの構文

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

パスパラメーター

プレースホルダー

{api-version}

APIのバージョン

{ig-media-id}

必須。IGメディアID。

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

キープレースホルダー

access_token

{access-token}

必須。アプリユーザーのユーザーアクセストークン

comment_enabled

{comment-enabled}

必須。コメントを有効にするにはtrueに設定し、無効にするにはfalseに設定します。

cURLの例

リクエスト

curl -i -X POST \
 "https://graph.facebook.com/v19.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

応答

{
  "success": true
}

削除

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