REST Resource: users

リソース: User

ディスプレイ &ビデオ 360 で 1 人のユーザーを動画 360

JSON 表現
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
フィールド
name

string

出力専用。ユーザーのリソース名。

userId

string (int64 format)

出力専用。ユーザーの一意の ID。システムによって割り当てられます。

email

string

必須。変更不可。ユーザーの識別に使用されるメールアドレス。

displayName

string

必須。ユーザーの表示名。

UTF-8 でエンコードし、最大サイズを 240 バイトにする必要があります。

assignedUserRoles[]

object (AssignedUserRole)

割り当てられたユーザー役割。

users.create では必須です。users.patch 内でのみ出力されます。users.bulkEditAssignedUserRoles でのみ更新できます。

AssignedUserRole

割り当てられた 1 つのユーザー役割。特定のパートナーまたは広告主とユーザーとの間の認証済みインタラクションを定義します。

JSON 表現
{
  "assignedUserRoleId": string,
  "userRole": enum (UserRole),

  // Union field entity_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field entity_id.
}
フィールド
assignedUserRoleId

string

出力専用。割り当てられたユーザー役割の ID。

userRole

enum (UserRole)

必須。エンティティのユーザーに割り当てるユーザーロール。

共用体フィールド entity_id。必須。

割り当てられたユーザー役割が適用されるエンティティの ID。entity_id は次のいずれかになります。

partnerId

string (int64 format)

割り当てられたユーザー役割が適用されるパートナーの ID。

advertiserId

string (int64 format)

割り当て先のユーザー役割が適用される広告主の ID。

UserRole

使用可能なユーザー役割。

列挙型
USER_ROLE_UNSPECIFIED ユーザーロールが指定されていないか、このバージョンで不明な場合のデフォルト値。
ADMIN このユーザーは、エンティティのキャンペーン、クリエイティブ、広告掲載オーダー、広告申込情報、レポートを管理できます。お支払い情報の表示と編集、ユーザーの作成と変更、エクスチェンジの有効化と無効化を行うことができます。このロールはパートナー エンティティにのみ割り当てることができます。
ADMIN_PARTNER_CLIENT このユーザーは、エンティティのキャンペーン、クリエイティブ、広告掲載オーダー、広告申込情報、レポートを管理できます。他の ADMIN_PARTNER_CLIENT ユーザーの作成と変更、お支払い情報の表示を行うことができます。収益モデル、マークアップ、その他販売パートナーが重要な項目を表示することはできません。このロールはパートナー エンティティにのみ割り当てることができます。
STANDARD このユーザーは、エンティティのキャンペーン、クリエイティブ、広告掲載オーダー、広告申込情報、レポートを管理できます。ユーザーの作成と変更、お支払い情報の表示はできません。
STANDARD_PLANNER エンティティのすべてのキャンペーン、クリエイティブ、広告掲載オーダー、広告申込情報、レポート(すべての費用データを含む)を表示できます。プランや在庫など、プランニング関連の機能を作成、変更できます。
STANDARD_PLANNER_LIMITED このユーザーは、エンティティのすべてのキャンペーン、クリエイティブ、広告掲載オーダー、広告申込情報、レポートを表示できます。プランや在庫など、プランニング関連の機能を作成、変更できます。費用データにアクセスすることはできません。また、取引の開始、承認、交渉もできません。
STANDARD_PARTNER_CLIENT このユーザーは、エンティティのキャンペーン、クリエイティブ、広告掲載オーダー、広告申込情報、レポートを管理できます。他のユーザーの作成や変更、お支払い情報の表示はできません。収益モデル、マークアップ、その他販売パートナーが重要な項目を表示することはできません。このロールは、広告主エンティティにのみ割り当てることができます。
READ_ONLY このユーザーは、レポートの作成とエンティティのデータの表示のみを行うことができます。
REPORTING_ONLY このユーザーはレポートの作成と管理のみを行うことができます。
LIMITED_REPORTING_ONLY このユーザーは、クライアント保護レポート(全般、オーディエンス パフォーマンス、クロスパートナー、キーワード、オーダー ID、カテゴリ、第三者データ提供元)のみを作成、管理できます。
CREATIVE このユーザーは、共同編集に必要なメディアプランの情報を表示できますが、費用関連のデータやマーケットプレイスを表示することはできません。
CREATIVE_ADMIN このユーザーは、共同編集に必要なメディアプランの情報を表示できますが、費用関連のデータやマーケットプレイスを表示することはできません。さらに、他のクリエイティブ管理者やクリエイティブ ユーザーをエンティティに追加することもできます。

メソッド

bulkEditAssignedUserRoles

ユーザーのユーザー役割を一括編集します。

create

新しいユーザーを作成します。

delete

ユーザーを削除します。

get

ユーザーを取得します。

list

現在のユーザーがアクセスできるユーザーを一覧表示します。

patch

既存のユーザーを更新します。