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

 更新現有使用者。