認証済みユーザーアクセス

GET accounts/:account_id/authenticated_user_access

指定した広告アカウントに関連している場合に、現在認証されているユーザーの権限(access_token)を取得します。これらの許可はads.twitter.comに公開されているものと一致します。

使用可能な値:

  • ACCOUNT_ADMIN: ユーザーの追加や削除、設定の変更などの機能を含む、キャンペーンを変更したり、統計情報を表示したりできるフルアクセス
  • AD_MANAGER: キャンペーンを変更したり、統計情報を表示したりできるフルアクセス。ただし、ユーザーの追加や削除、設定の変更はできません
  • CREATIVE_MANAGER: クリエイティブを変更したり、プレビューを表示したりできるアクセス。ただし、キャンペーンを作成、修正するためのアクセス権はありません
  • CAMPAIGN_ANALYST: キャンペーンを表示したり、統計情報を表示したりできるアクセス。ただし、キャンペーンを作成、修正するためのアクセス権はありません
  • ANALYST(ads.twitter.comの「オーガニックアナリスト」):オーガニックアナリティクスやオーディエンスインサイトを表示できるアクセス。ただし、キャンペーンを作成、変更、表示するためのアクセス権はありません
  • PARTNER_AUDIENCE_MANAGER: パートナーオーディエンスを表示したり変更したりできるAPI専用のアクセス。ただし、キャンペーン、クリエイティブ、他のオーディエンスタイプへのアクセス権はありません。

また、TWEET_COMPOSER権限は、認証済みユーザーが、広告主に代わってヌルキャスト(または「プロモーションのみ」)ツイートを作成できることを表します。これは、ACCOUNT_ADMINAD_MANAGERCREATIVE_MANAGERのアクセス権を持つユーザーのみが利用できます。

リソースURL

https://ads-api.x.com/10/accounts/:account_id/authenticated_user_access

パラメーター

なし

リクエストの例

GET https://ads-api.x.com/10/accounts/18ce54d4x5t/authenticated_user_access

応答の例

{
  "data": {
    "user_id": 2417045708,
    "permissions": [
      "ACCOUNT_ADMIN",
      "TWEET_COMPOSER"
    ]
  },
  "request": {
    "params": {
      "account_id": "18ce54d4x5t"
    }
  }
}