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 使用者介面的時間戳記。

使用 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),

  // 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

 更新現有使用者。