REST Resource: users

リソース: User

ディスプレイ＆ビデオ 360 の単一のユーザー。

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 に最後にログインしたときのタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

AssignedUserRole

指定されたパートナーまたは広告主とのユーザーの承認済みインタラクションを定義する、割り当てられた単一のユーザーロール。

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
フィールド
assignedUserRoleId

string

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

enum (UserRole)

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

必須。

割り当てられたユーザーロールが適用されるエンティティの ID。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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 ユーザーはコラボレーションに必要なメディア プラン情報を表示できますが、費用関連のデータや Marketplace は表示できません。
CREATIVE_ADMIN ユーザーは、コラボレーションに必要なメディア プランの情報を表示できますが、費用関連のデータや Marketplace は表示できません。また、他のクリエイティブ管理者やクリエイティブ ユーザーをエンティティに追加することもできます。

メソッド

bulkEditAssignedUserRoles

 ユーザーのユーザーロールを一括編集します。

create

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

delete

 ユーザーを削除します。

get

 ユーザーを取得します。

list

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

patch

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