IGメディア

Instagramの写真、動画、ストーリーズ、アルバムのいずれかを表します。IGTVとリールはサポートされていません。

このノードでは、以下を行えます。

IG利用者のすべてのメディアオブジェクトを取得するには、代わりにIG利用者メディアエッジを使用します。

作成

この操作はサポートされていません。IGコメントを作成するには、代わりにIGメディアコメントエッジを使用します。

読み取り

GET /{ig-media-id}?fields={fields}

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

制限

  • 集計された値を返すフィールドには広告ドリブンデータは含まれません。たとえば、comments_countは写真に付けられたコメントの数をカウントしますが、その写真を含む広告に付けられたコメントはカウントしません。
  • アプリユーザーも管理者と同等のタスクをアプリで実行できるのでない限り、キャプションに(@)の記号は含まれません。
  • 一部のフィールドは、アルバム(子)内の写真で使用できません。
  • IGメディアに著作権対象コンテンツが含まれている場合、または著作権違反のフラグが付いている場合、media_urlフィールドは応答から除外されます。
  • IGTVとリールはサポートされていません。

要件

タイプ説明

アクセストークン

ユーザー

アクセス許可

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management
business_management

リクエストの構文

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

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

パラメーター

{access-token}
必須
文字列

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

{fields}
コンマ区切りリスト

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

フィールド

  • caption* (子アルバムを除く)。(@)記号は含まれません。ただし、アプリユーザーが管理者と同等のアプリのタスクもアプリで実行できる場合は除きます。
  • comments_count* (子アルバムとキャプションを除く。返信を含む)
  • id*
  • ig_id
  • is_comment_enabled (アルバムの子を除く)
  • like_count* (アルバムの子、およびメディアオブジェクトから作成された宣伝投稿への「いいね!」を除く。返信を含む)
  • media_type*
  • media_url* (IGメディアに著作権対象コンテンツが含まれている場合、または著作権違反のフラグが付いている場合、応答から除外されます)
  • owner (クエリを実行したIG利用者IGメディアオブジェクトも所有している場合にのみ返されます。それ以外の場合は、usernameフィールドが含まれます)
  • permalink*
  • shortcode
  • thumbnail_url (動画のIGメディアオブジェクトでのみ表示可能)
  • timestamp* — ISO 8601フォーマットによるUTCでの作成日(デフォルトはUTC ±00:00)
  • username*

アスタリスク(*)の付いたフィールドは公開フィールドです。つまり、フィールド拡張機能により値が返されます。

エッジ

  • children* (カルーセルアルバムのみ)
  • comments (アルバムの子、コメントへの返信、キャプションを除く)

アスタリスク(*)の付いたエッジは公開エッジです。つまり、フィールド拡張機能により値が返されます。

リクエストの例

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

応答の例

{ "id": "17895695668004550", "media_type": "IMAGE", "media_url": "https://fb-s-b-a.akamaihd.net/h-ak-fbx/t51.2885-9/21227247_1640962412602631_3222510491855224832_n.jpg?_nc_log=1", "owner": { "id": "17841405822304914" }, "timestamp":"2017-08-31T18:10:00+0000"

更新

コメントの有効化/無効化

POST /{ig-media-id}?comment_enabled={comment_enabled}

メディアオブジェクトに対するコメントを有効または無効にします。

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

必須として指定されていない限り、クエリ文字列パラメーターは省略可能です。

  • {comment_enabled} (必須) - コメントを有効にするにはtrueに設定し、コメントを無効にするにはfalseに設定します。

アクセス許可

次のアクセス許可を持つ、メディアオブジェクトを作成したユーザーからのアクセストークン

  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagementまたはpages_show_list

ビジネスマネージャを介してページの管理権限を付与されたユーザーのトークンの場合、次のいずれかのアクセス許可が必要です。

  • ads_management
  • pages_read_engagement
  • business_management

リクエストの例

POST graph.facebook.com
  /17895695668004550?comment_enabled=false

応答の例

{
  "success": true
}

削除

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