【2022年版】Instagram Graph API ver13.0とInstagramビジネスアカウントIDの取得方法

Instagram グラフ APIアクセストークンの取得してみた。

この記事は現在わたしが受講中の「デイトラ Pythonコース（Instagram分析アプリ編）」の備忘録ですが、「Instagram グラフ APIアクセストークン」と「InstagramビジネスアカウントID」の2つの取得方法をお探しの方のお役に立てる内容にもなっているかと思います。すべて無料で取得できます。

じょじお

結構時間をかかったので記録として記事にしました。

Instagram グラフ APIアクセストークンの取得に必要なステップ

下記の順番で作業が必要です。

Instagramプロアカウントの作成（プロアカウントへ切り替え）
Facebookページの作成
1. FacebookページとInstagramプロアカウントの紐づけ
Facebookアプリの作成
Instagram グラフ APIアクセストークンの取得
1. 1番目のアクセストークンの取得
2. 2番目のアクセストークンの取得
3. 3番目（無期限）のアクセストークンの取得
InstagramビジネスアカウントIDの取得

問題なく進めば30分～40分程度で取得できるかと思います。

トークンは3種類あるのですが、最終的に必要なのは3番目の無期限トークンです。

ぽこがみさま

それ以外のトークンは3番目のトークンを取得するためのトークンです。

じょじお

トークンがいっぱいあるので混乱しないように注意してくださいね。

Instagramプロアカウントへの変更方法

プロアカウントに変更する方法について解説します。無料で変更できます。

STEP

スマホでInstagramアプリを開く。

Instagramアカウントを持っていない場合はInstagramアプリから作成してください。

STEP

Instagramの設定を開きます。

スマホにてInstagramの設定を開きます。

STEP

設定を開き、「アカウントタイプの切り替え」を設定する

▼「アカウントタイプの切り替え」を選択します。

▼「プロアカウントに切り替える」を選択します。

プロアカウントは2種類から選べますが、この記事では「クリエイタータイプ」を選択しました。

ダイアログに従いプロアカウント設定を完了します。

Facebook ページの作成方法

既に紐づける予定のFacebookページをお持ちの方はこの項は飛ばしてください。

STEP

PCでFacebookを開く。

Facebookにログインします。個人用アカウントで大丈夫です。

STEP

Facebookページを作成する。

▼「設定」から「ページ」をクリックします。

▼Facebookページを作成します。

▼ページ名などを入力し「Facebookページを作成」をクリックします。

自分に合った情報を入力して「Facebookページを作成」をクリックします。

FacebookページとInstagramプロアカウントの紐づけ

Facebook側でInstagramプロアカウントを紐づけます。

STEP

FacebookページとInstagramプロアカウントの紐づけ

▼Facebookページの「設定」をクリックします。

▼Instagramをクリックします。

▼アカウントをリンクをクリックします。

1つのInstagramアカウントは、1つのFacebookページにのみリンクが可能です。既に他のFacebookページと連携している場合は解除するか、別のInstagramアカウントを選択する必要があります。

Instagramの認証画面が表示されますので認証をして連携は終わりです。

Facebookアプリ作成

STEP

Facebook for Developersにアクセスする。

「Facebook for Developers」ページからFacebook アプリを作成していきます。

▼画面右上「利用を開始する」をクリックします。

STEP

Facebook for Developersアカウントを作成する。

▼「次へ」をクリックします。

▼メールアドレスを入力して「認証」をクリックします。

▼当てはまるものを選択して「登録完了」をクリックします。

STEP

Facebookアプリを作成する。

▼「アプリを作成」をクリックします。（下図ページに遷移しなかった場合はこちらからジャンプできます。）

▼アプリタイプにビジネスを選択して「次へ」をクリックします。

各アプリタイプの詳細については、こちらのfacebook for developers公式ドキュメントをご覧ください。

Instagram Graph API（インスタグラムグラフAPI）を使用するにはビジネスを選択する必要があります。

▼アプリを作成画面でパラメータを入力します。

アプリ表示名：
好きな名前を付けて大丈夫です。「Instagram」という言葉を使うと怒られます。

アプリ連絡先メールアドレス：
メールアドレスを入力してください。

アプリの目的：
代理作成か自分用かを選択してください。

ビジネスマネージャーアカウントをお持ちですか？：
グラフAPIを使うだけであれば設定不要です。デイトラ生も不要です。

STEP

FacebookアプリにInstagram APIを追加する。

▼「InstagramグラフAPI」を追加します。

（図のアプリ設定画面に遷移しなかったときはコチラからジャンプできます。）

▼設定の中の「ベーシック」をクリックします。

STEP

アプリIDとApp Secretキーをメモする。

▽「アプリID」と「app secret」をメモします。のちの設定で必要になります。

メモできましたら「変更を保存」をクリックします。

プライバシーポリシーとアプリアイコンを設定をしないと警告が出ますが無視して問題ありません。

アプリの作成は以上です。

アクセストークンを取得する

STEP

1番目のアクセストークンを取得する。

1番目のアクセストークンの取得方法

▼「InstagramグラフAPIエクスプローラー」を開きます。

（前項の画面右上メニューの中の「ツール」→「InstagramグラフAPIエクスプローラー」からでも行けます。）

▼先程作成したアプリを選択し、「ページアクセストークンを取得」をクリックします。

▼認証画面が表示されたらログインします。

▼先程作成したFacebook ページを選択して「次へ」をクリックします。

（Facebook ページの作成がまだの場合、作成ボタンが表示されますので前項を参考に作成してください。）

▼画面が表示されますのでそのまま完了ボタンをクリックします。

画面上部の「ログインレビューの申請」の警告は無視しても大丈夫でした。

▼グラフAPIエクスプローラーの画面に戻ります。

下記のパラメータを入力してから「Generate Access Token」ボタンをクリックします。

Facebook アプリ：
先ほど作成したアプリを選択します。

ユーザまたはページ：
ページを選択します。

アクセス許可：
アプリで利用するアクセス許可設定をします。（各アクセス許可の詳細はこちらの公式ドキュメントを確認してください。）

▼今回はInstagramの情報を分析したいので、下記のようにInstagram系のアクセス許可をオンにしました。

アクセス許可

instagram_basic
instagram_manage_comments
instagram_manage_insights
instagram_manage_messages
instagram_content_publish
business_management
public_profile（Defaultで許可あり）
pages_show_list（Defaultで許可あり）
ipages_read_engagement（Defaultで許可あり）

▼Instagramプロアカウントを選択して次へをクリックします。

1番目のアクセストークン取得結果

▼1番目のアクセストークンが発行されますのでコピーします。

STEP

2番目のアクセストークンを取得する。

2番目のアクセストークンの取得方法

▼ブラウザで下記URLにアクセスします。

2番目のアクセストークンのURL（v11.0の部分は使用するグラフAPIのバージョンに合わせてください。）
https://graph.facebook.com/v11.0/oauth/access_token?grant_type=fb_exchange_token&client_id=[★アプリID]&client_secret=[★app secret]&fb_exchange_token=[★1番目のトークン]

★アプリid: こちらの前の項で取得したアプリid
★app secret: こちらの前の項で取得したアプリid
★token: 1番目のアクセストークン

2番目のアクセストークン取得結果

2番目のアクセストークンが発行されます。
{"access_token":"*******************************************":"bearer"}

STEP

3番目のアクセストークンを取得する。

3番目のアクセストークン（無期限トークン）取得方法

▼ブラウザで下記URLにアクセスします。

URL（v11.0の部分は使用するグラフAPIのバージョンに合わせてください。）
https://graph.facebook.com/v11.0/me?access_token=[★2番目のトークン]

▼下記のような結果が表示されますのでIDをコピーします。

IDをメモ
{
   "name": "****************",
   "id": "*****************"
}

▼上で取得したIDを使って、ブラウザで下記URLにアクセスします。

URL（v11.0の部分は使用するグラフAPIのバージョンに合わせてください。）
https://graph.facebook.com/v11.0/[★ここにIDを入力]/accounts?access_token=[★2番目のトークン]

3番目のアクセストークン（無期限トークン）取得結果

3番目のアクセストークンが発行されます。

{
   "data": [
      {
         "access_token": "*********************************",
         "category": "",
         "category_list": [
            {
               "id": "",
               "name": ""
            },
            {
              以下省略...

以上で3番目のアクセストークン（無期限トークン）が取得できました。

InstagramビジネスアカウントIDの取得

▼「InstagramグラフAPIエクスプローラー」に戻ります。

3番目のアクセストークンを張り付けます。
アプリを選択します。
「me?fields=instagram_business_account」とテキストボックスに入力します。
送信ボタンをクリックします。

InstagramビジネスアカウントID取得結果

これで「無期限アクセストークン」と「InstagramビジネスアカウントID」の取得は終わりです。

トークンを使用したアプリケーションにエラーが発生したら確認すること。

「3番目のトークンをPythonコードに埋め込んだつもりが、コピペミスで2番目のトークンだった・・・」とか、「間違えてページトークンではなくユーザトークンを取得してた・・・」なんてことがあるので、トークンを使用したプログラム・アプリでエラーが起こったら下記を確認してみてください。

トークンの正常性を確認してからプログラムコードのデバッグをした方が良いでしょう。

①「アクセストークンデバッガー」でトークンの正常性を確認する。

アクセストークンデバッガーで意図したトークンが取得できているかを確認します。

期限切れていたり、誤ってユーザタイプトークンを取得してしまったりしていたら1番目のトークンから取得しなおしましょう。

おもな確認ポイント

タイプがPageになっているか。
有効期限が「受け取らない（無期限）」になっているか。
スコープに適切なアクセス許可が付与されているか。

②「アクセストークンで良くあるエラー」を確認する。

アクセストークンで良くあるエラー（公式）はコチラ。

上記のようなエラーの場合は1番目から取得しなおしましょう。

③Facebook アプリを作り直す。(can’t decrypt エラーとか)

わたしは最初利用できたトークンが途中で「can’t decrypt」エラーになり使えなくなることがありました。デバッガーでトークンを確認しても正常でトークンを取得し直してもダメ。しかたなくアプリを作成し直したところエラー解消しました。どうしようもなくなったらアプリ作成の手順を一からやりなおしたほうがいいかもしれません。

（④デイトラ生向け）Key Error : like_countについて

デイトラで作成しているプログラムは、グラフAPIのバージョンが8.0で作成されています。現行最新バージョンをそのまま使おうとするとAPIの仕様変更（参考：仕様変更の公式記事）がされているためエラー（「key error : like_count」）になるので注意が必要です。バージョン10.0以前を使用するか例外処理を入れる必要があります。

Pythonおすすめ書籍