REST Resource: users

資源：User

Display & Video 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)

僅供輸出。使用者上次登入 DV360 UI 的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

AssignedUserRole

單一指派的使用者角色，定義使用者與指定夥伴或廣告主之間的授權互動。

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

 更新現有的使用者。