REST Resource: users

資源：User

Display & Video 360 中的單一使用者。

JSON 表示法 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
欄位
name

string

僅供輸出。使用者的資源名稱。
userId

string (int64 format)

僅供輸出。使用者的專屬 ID。由系統指派。
email

string

必要欄位。無法變更。用來識別使用者的電子郵件地址。
displayName

string

必要欄位。使用者的顯示名稱。

必須採用 UTF-8 編碼，且大小不得超過 240 個位元組。
assignedUserRoles[]

object (AssignedUserRole)

指派的使用者角色。

users.create的必填屬性。僅輸出至 users.patch。只能透過 users.bulkEditAssignedUserRoles 更新。

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

 更新現有使用者。