InstagramグラフAPI

コラボレーター

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

作成

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

読み取り

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

GET /{ig-media-id}

制限

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

要件

タイプ説明

アクセストークン

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

アクセス許可

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management
business_management

リクエストの構文

GET https://graph.facebook.com/{appi-version}/{ig-media-id}/collaborators

応答の例

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

パスパラメーター

プレースホルダー値

{api-version}

APIのバージョン。

{ig-user-id}

必須。IGユーザーID。

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

キープレースホルダー値

access_token

{access-token}

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

応答フィールド

フィールド名説明

id

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

invite_status

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

  • Accepted
  • Declined
  • Pending

username

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

更新

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

削除

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