IGメディア

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

以下のフィールドを紹介します。

• legacy_instagram_media_id

次のマーケティングAPI Instagram広告エンドポイントフィールドはサポートされていません。

• filter_name
• location
• location_name
• latitude
• longitude

作成

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

読み取り

GET /<IG_MEDIA_ID>

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

要件

制限

• comments_countやlike_countなどのフィールドはターゲットInstagramメディアのエンゲージメントのみを返します。他のサーフェスのデータは含まれません。例えば、comments_countは写真に付けられたコメントの数を返しますが、その写真を使用した広告に付けられたコメントは返しません。宣伝/広告メディアのエンゲージメントを含む集計数を取得するには、total_comments_countやtotal_like_countを使用してください。クロス投稿されたFacebook投稿の数が含まれるのは、その投稿がセッションのユーザーからアクセス可能な場合です。
• アプリユーザーが管理者と同等のタスクをアプリで実行できない限り、キャプションに@記号は含まれません。
• permalinkなど一部のフィールドは、アルバム内の写真(子)には使えません。
• ライブ動画Instagramメディアは、配信中のみ読み取り可能です。
• このAPIは、Instagramプロアカウントが所有するメディアのデータのみを返します。個人用Instagramアカウントが所有するメディアのデータを取得するために使用することはできません。
• reposts_count、saved_count、shares_count、total_like_count、total_comments_count、total_views_countフィールドはカルーセルの子メディアでは利用できず、トップレベルのメディアオブジェクトの場合のみ返されます。メディア所有者は、「いいね！」の数、コメント数、閲覧数、再投稿数、シェア数の表示を無効にできます。その場合、対応するフィールドは返されません。

リクエストの構文

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

パスパラメーター

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

フィールド

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

エッジ

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

cURLの例

リクエストの例

curl -X GET \
  'https://graph.instagram.com/v26.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>

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

制限

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

リクエストの構文

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

パスパラメーター

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

cURLの例

リクエストの例

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

応答の例

{
  "success": true
}

削除

DELETE /<IG_MEDIA_ID>

Instagramメディアを削除します。

要件

制限

このAPIはFacebookログインを利用したInstagram APIのみをサポートしています。広告以外の投稿、ストーリーズ、リール、カルーセルアルバム全体がサポートされています。カルーセルアルバム内のメディアを削除するには、カルーセルコンテナメディアIDを指定してカルーセルアルバム全体を削除する必要があります。カルーセル内のメディアを個別に削除することはできません。

リクエストの構文

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

パスパラメーター

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

cURLの例

リクエストの例

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

応答の例(成功)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

応答の例(失敗、メディアタイプがサポートされていない)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}