API

Instagram API を使ってインスタに投稿した画像データを取得する

インスタに投稿した画像を自動でホームページでも更新されるようにしたい。
もっとも簡単に実現する方法を紹介する。

公式リファレンス
InstagramグラフAPI
IGメディア

実装するには、「事前準備」「リクエストURLに必要なIDとアクセストークンの取得」「データの取得」の三部構成となる。

1) 事前準備

  1. インスタのアカウントをプロアカウントに変更する(無料)
  2. Facebookページを用意して、インスタのアカウントとFacebookを連携する

インスタをプロアカウントに変更する(無料)

PCでのFacebookページの作り方

PCのFacebookページでインスタを関連づける

複数のインスタアカウントと連携するには、インスタアカウントごとにFacebookページを用意し、それぞれ連携する。

2) リクエストURLに必要なIDとアクセストークンの取得

リクエスト時に必要なIDとアクセストークンは、Facebook for Developers でFacebookアプリを作成することで取得できる。

Facebookアプリ作成まで(画像横スクロール)

IDとアクセストークン取得まで(画像横スクロール)

Facebookアプリを作成して、IDとアクセストークン取得まで

  1. Facebook for Developers にアクセスしてログインする
  2. 「マイアプリ」からアプリを作成する
    2-1. 「ビジネス統合の管理」を選択して「次へ」
    2-2. アプリ表示名、メールアドレス、アプリの目的はどちらかを選択して、「アプリを作成」
    2-3. 「InstagramグラフAPI」の「設定」
  3. 「ツール」の「グラフAPIエクスプローラ」からアクセストークンユーザーとアクセス許可を設定して、アクセストークンを取得する(このアクセストークンの有効期限は1時間)
    3-1. Facebookアプリから該当アプリを選択
    3-2. 「ユーザーアクセストークンを取得」を選択
    3-3. 許可を追加から「Instagram_basic」「pages_show_list」「pages_read_engagement」「ads_management」「business_management」を選択
    3-4. 「Generate Access Token」ボタンをクリック
    3-5. 表示されたアクセストークンをコピー
  4. 「ツール」の「アクセストークンデバッガー」で、「アクセストークンの延長」して、アクセストークンを取得する(このアクセストークンの有効期限は2ヶ月)
    4-1. 3-5でコピーしたアクセストークンをペーストし、「デバッグ」ボタンをクリック
    4-2. 画面下の「アクセストークンを延長」ボタンをクリック
    4-3. 画面右下の「デバッグ」をクリック
    4-4. 新規タブで表示されるアクセストークンをコピー
  5. 「ツール」の「グラフAPIエクスプローラ」で、IDと無期限のアクセストークンを取得する
    5-1. アクセストークンのフィールドに、4-4でコピーしたアクセストークンを入力
    5-2. URL入力欄に「me?fields=accounts{name,instagram_business_account,access_token}」と入力して、「送信」
    5-3. 結果画面にid が複数あるが、instagram_business_accountの中のid情報がリクエストに必要なIDとなる。また、ここで表示されているaccess_tokenは有効期限なしのアクセストークン。

5-3. で取得したinstagram_business_accountのIDとアクセストークンは、インスタのデータを取得する際(リクエスト時)に必要となるため、別ファイルか何かにコピーして保存しておく。第三者に見られないよう扱い要注意。

補足1) 複数のFacebookページと連携されている場合、Facebookページごとに、instagram_business_accountのidとaccess_tokenをペアにしてコピーしておく。instagram_business_accountがない場合は、インスタアカウントとFacebookページが紐づいていないということになるので、Facebookページでインスタと紐づいているか設定を見直す必要がある。

補足2) 5-3. で取得したアクセストークンは「ツール」の「アクセストークンデバッガー」で有効期限が「受け取らない」と無期限になっているのが確認できる。

3) データの取得

第二部で取得したIDとアクセストークンを使うことで、インスタのデータを取得できるわけだが、セキュリティに配慮すると、これらの値がフロント側で露出するケースが発生してはいけない。

あとはサーバーサイド処理で、phpでもpythonでも利用して、公式リファレンスを参考に必要なデータを取得する。

公式リファレンスのリクエスト構文だとうまくいかないので要注意

ちなみに、公式リファレンスで紹介されているリクエストどおりのURLだとうまく取得できず、エラーが表示され、原因の特定ができずにガッツリハマってしまった。最終的には、URLのGETパラメータ前に「/media」を追加することで修正できた。リファレンスの記述ミスかもしれない(2021年2月18日現在)。

公式では、リクエストの構文として、

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

と紹介されているが、これだとエラーになる。実際は、

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

と「/media」を追加することで期待した挙動となる。リクエストの例も同様に、

https://graph.facebook.com/v9.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...

ではなく、

https://graph.facebook.com/v9.0/17895695668004550/media?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...

と「/media」を追加して、IDとアクセストークンを入れ変えることでデータを取得できる。

一度に取得する件数を設定できる

また、公式には掲載されていないが、limitパラメータを追加するとリクエスト時に取得できる件数をセットできる。

過度なリクエストはしない

ページが表示されるたびに、リクエストするのではなく、cronなどで事前にインスタデータをjsonなどで生成しておく。

最近の記事

cronっぽいことをPHPでjsonとして実装する

外部のAPIを利用する際、リクエスト回数が制限されることがある。また、リクエスト回数が制限され、かつ毎日更新をルールとする外部のAPIもある。 そんなと・・・

php

Instagram API を使ってインスタに投稿した画像データを取得する

インスタに投稿した画像を自動でホームページでも更新されるようにしたい。もっとも簡単に実現する方法を紹介する。 公式リファレンスInstagram・・・

API

名刺代わりの超絶ミニマムなブランディングページ

このたび、ハンドメイドアクセサリー作家さんのWebサイト制作させていただきました! Sunny Side Accessory(サニーサイド アクセサリー・・・

お仕事・制作日記

案件、承っております

2021年2月現在、案件承っております。とくに短期、週2、3日での外注をお考えでしたら、ぜひご連絡ください。 当方、2015年2月より「シンプルシンプル・・・

お仕事・制作日記

インタラクションデザイン

5年くらい前に購入した書籍「インタラクションデザイン」。この書籍内ではたくさんの事例が紹介されている。残念ながらその多くは現在閲覧することができなくなっていた・・・

デザイン

Advanced Custom Fields 名前を変更して、データも反映させる

WordPressを自作する上でもはや欠かせないプラグインの一つが、「Advanced Custom Fields」。 名前を変更しようと思って、Wor・・・

WordPress

配列の重複を削除する

配列の場合 /** * 配列の重複を削除する * * @param {array} ary* * @return {array} 処理後のary・・・

JavaScript

MAMP を 5.7 から 6.2 にアップデートした

5年以上前と比べると、アップデートが簡単で驚く。とくに記事にするまでもないと思いつつ、一応備忘録。 インストールすると、既存のディレクトリはそのままに別・・・

MAMP

Briefly unavailable for scheduled maintenance. Check back in a minute. → . maintenance を削除

プラグインを更新中に、誤って、違うページにアクセスしまいました。すると、管理画面だけでなく、公開中のすべての画面が「briefly unavailable f・・・

WordPress

GulpでERRが出てテンパった → gyp: No Xcode or CLT version detected! → PostCSS plugin autoprefixer requires PostCSS 8

Gulp。いつもは正常に動いている環境をそのままコピーして再利用するようにしている。そうすることで、案件ごとに毎回環境作りをする手間を省くことができ、何よりG・・・

制作効率化

人気の記事

WP_Queryを使って絞り込み検索するのにコレは便利!

めっちゃ参考になるページを見つけた。 絞り込みをするたびに色々ググっていたが、これがあればほとんどのことが解決できそうな気がする。 参考: これは便利!Word・・・

WordPress

overflowをautoにした要素のスクロール位置を変更する → scrollTop scrollLeft

まずはサンプル。 これは、overflowをautoにした要素のスクロール位置を変更するサンプルです。 これは、overflowをautoにした要素のスクロ・・・

JavaScript

iframeの高さを自動調整する

iframeで呼び出した際、iframe自体はスクロールさせずに高さを取得してiframe全体を表示させます。 サンプル:iframeの高さを自動調整するデモ・・・

JavaScript

http://localhost:8888/ → http://localhost/

http://localhost:8888/ での参照ではなく、http://localhost/ で参照できるようにします。 MAMPの設定を変更する M・・・

MAMP

カウントアップ、カウントダウンするJavaScript

ポイントを使ったり、増やしたりしたときに、結果のポイント数に差し替えるのではなくて、カウントアップしたり、カウントダウンして動的に動かそうと思って作ってみた。・・・

JavaScript

アーカイブページでカスタムフィールドやタクソノミーで絞り込みした状態でリスト表示する

<?php $args = array( 'paged' => 1, 'posts_per_page' => 20, 'post・・・

WordPress

WordPressのカテゴリー一覧ページでカテゴリー名とスラッグを取得する → get_queried_object()

やりたいこと カテゴリー一覧ページで、そのカテゴリー一覧ページに属する記事一覧を取得するためにループさせるのとは別に、タイトルやカテゴリー別にデザインを変・・・

WordPress

イラストレーターでレイヤーごとにPNGで書き出す

【2020年07月13日】 macOS Catalina(10.15.5) / Adobe iLLustrator 2020(24.2.1) にて動作確認済・・・

Illustorator

管理画面のカスタム投稿一覧で並び順を変更する

WordPressの管理画面。「投稿」や「固定ページ」の一覧は、公開日順に並んでいる。ところが、カスタム投稿を追加した場合、公開順ではなく名前順に並んでいること・・・

WordPress

Advanced Custom Fields を使った条件分岐(セレクトボックス、チェックボックス、ラジオボタン、真偽)のテンプレート記述方法

前回、「入力フォームを自由にカスタマイズできる「Advanced Custom Fields」」で基本的なフィールド名を出力方法を紹介したが、今度は条件分岐に関・・・

WordPress

WEB制作マークアップAPIInstagram API を使ってインスタに投稿した画像データを取得する | シンプルシンプルデザイン