REST Resource: users

資源:User

「多媒體和」中的單一使用者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

更新現有使用者。