REST Resource: users

リソース: User

ディスプレイ &ビデオ 360 の 1 人のユーザー。

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

string

出力のみ。ユーザーのリソース名。
userId

string (int64 format)

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

string

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

string

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

UTF-8 でエンコードする必要があります。最大サイズは 240 バイトです。
assignedUserRoles[]

object (AssignedUserRole)

割り当てられているユーザー役割。

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

string (Timestamp format)

出力のみ。ユーザーがディスプレイ&ビデオ 360 の UI に最後にログインしたときのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

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 共同編集に必要なメディアプランの情報は表示できますが、費用関連のデータやマーケットプレイスを表示することはできません。また、他のクリエイティブ管理者やクリエイティブ ユーザーをエンティティに追加することもできます。

Methods

bulkEditAssignedUserRoles

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

create

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

delete

 ユーザーを削除します。

get

 ユーザーを取得します。

list

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

patch

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