Instagramプラットフォーム

コラボレーター

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

FacebookログインによるInstagram APIで利用可能です。

作成

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

読み取り

コラボレーターであるInstagramユーザーのリストと、IGメディアオブジェクトでの招待ステータスを取得します。

GET /<IG_MEDIA_ID>

制限

  • 最大5つのInstagramアカウントをコラボレーターとして追加できます。
  • コラボレーターのタグ付けを有効にしているIGユーザーのみが応答で返されます。
  • コラボレーターのタグ付けは、フィード画像、リール、カルーセルではサポートされていますが、ストーリーズではサポートされていません

要件

型説明

アクセストークン

ユーザー – ユーザーはIGメディアオブジェクトを作成している必要があります

アクセス許可

instagram_basic
pages_read_engagement

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

ads_management
ads_read

リクエストの構文

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>/collaborators&<USER_ACCESS_TOKEN>

応答の例

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    }
  ]
}

パスパラメーター

プレースホルダー値

<API_VERSION>

APIのバージョン。

<IG_MEDIA_ID>

必須。アプリユーザーのInstagramメディアのID。

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

キープレースホルダー値

access_token

<USER_ACCESS_TOKEN>

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

応答フィールド

フィールド名説明

id

コラボレーター候補者のInstagramアカウントのapp-scoped ID

invite_status

コラボレーター候補者に送信された招待のステータス。次のいずれかになります。

  • Accepted
  • Pending

username

コラボレーター候補者のInstagramプロフィールのユーザー名

更新

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

削除

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