REST Resource: users

Tài nguyên: Người dùng

Một người dùng trong Display & Video 360.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của người dùng.
userId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của người dùng. Do hệ thống chỉ định.
email

string

Bắt buộc. Không thể thay đổi. Địa chỉ email dùng để xác định người dùng.
displayName

string

Bắt buộc. Tên hiển thị của người dùng.

Phải được mã hoá theo UTF-8 với kích thước tối đa là 240 byte.
assignedUserRoles[]

object (AssignedUserRole)

Vai trò được chỉ định của người dùng.

Bắt buộc ở users.create. Chỉ có đầu ra bằng users.patch. Chỉ có thể cập nhật thông qua users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi người dùng đăng nhập lần gần đây nhất vào giao diện người dùng của DV360.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

AssignedUserRole

Một vai trò người dùng được chỉ định, xác định hoạt động tương tác được uỷ quyền của người dùng với một đối tác hoặc nhà quảng cáo được chỉ định.

Biểu diễn dưới dạng JSON 
{
  "assignedUserRoleId": string,
  "userRole": enum (UserRole),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
Trường
assignedUserRoleId

string

Chỉ có đầu ra. Mã nhận dạng của vai trò người dùng được chỉ định.
userRole

enum (UserRole)

Bắt buộc. Vai trò người dùng cần chỉ định cho người dùng đối với pháp nhân.

Bắt buộc.

Mã nhận dạng của pháp nhân mà vai trò người dùng được chỉ định áp dụng. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
partnerId

string (int64 format)

Mã nhận dạng của đối tác mà vai trò người dùng được chỉ định áp dụng.
advertiserId

string (int64 format)

Mã nhận dạng của nhà quảng cáo mà vai trò người dùng được chỉ định áp dụng.
Kết thúc các trường loại trừ lẫn nhau.

UserRole

Vai trò có thể có của người dùng.

Enum
USER_ROLE_UNSPECIFIED Giá trị mặc định khi vai trò của người dùng không được chỉ định hoặc không xác định được trong phiên bản này.
ADMIN Người dùng có thể quản lý chiến dịch, mẫu quảng cáo, đơn đặt hàng quảng cáo, mục hàng và báo cáo cho pháp nhân. Họ có thể xem và chỉnh sửa thông tin thanh toán, tạo hoặc sửa đổi người dùng, cũng như bật hoặc tắt sàn giao dịch. Bạn chỉ có thể chỉ định vai trò này cho một pháp nhân đối tác.
ADMIN_PARTNER_CLIENT Người dùng có thể quản lý chiến dịch, mẫu quảng cáo, đơn đặt hàng quảng cáo, mục hàng và báo cáo cho pháp nhân. Họ có thể tạo và sửa đổi những người dùng ADMIN_PARTNER_CLIENT khác, cũng như xem thông tin thanh toán. Họ không thể xem mô hình doanh thu, mức tăng giá hoặc bất kỳ trường nào khác có thông tin nhạy cảm của đại lý. Bạn chỉ có thể chỉ định vai trò này cho một pháp nhân đối tác.
STANDARD Người dùng có thể quản lý chiến dịch, mẫu quảng cáo, đơn đặt hàng quảng cáo, mục hàng và báo cáo cho pháp nhân. Họ không thể tạo và sửa đổi người dùng hoặc xem thông tin thanh toán.
STANDARD_PLANNER Người dùng có thể xem tất cả chiến dịch, mẫu quảng cáo, đơn đặt hàng quảng cáo, mục hàng và báo cáo cho pháp nhân, bao gồm cả tất cả dữ liệu chi phí. Họ có thể tạo và sửa đổi các tính năng liên quan đến việc lập kế hoạch, bao gồm cả kế hoạch và khoảng không quảng cáo.
STANDARD_PLANNER_LIMITED Người dùng có thể xem tất cả chiến dịch, mẫu quảng cáo, đơn đặt hàng quảng cáo, mục hàng và báo cáo cho pháp nhân. Họ có thể tạo hoặc sửa đổi các tính năng liên quan đến việc lập kế hoạch, bao gồm cả kế hoạch và khoảng không quảng cáo. Họ không có quyền truy cập vào dữ liệu chi phí và không thể bắt đầu, chấp nhận hoặc thương lượng giao dịch.
STANDARD_PARTNER_CLIENT Người dùng có thể quản lý chiến dịch, mẫu quảng cáo, đơn đặt hàng quảng cáo, mục hàng và báo cáo cho pháp nhân. Họ không thể tạo hoặc sửa đổi người dùng khác hoặc xem thông tin thanh toán. Họ không thể xem mô hình doanh thu, mức tăng giá hoặc bất kỳ trường nào khác có thông tin nhạy cảm của đại lý. Bạn chỉ có thể chỉ định vai trò này cho một pháp nhân nhà quảng cáo.
READ_ONLY Người dùng chỉ có thể tạo báo cáo và xem dữ liệu cho thực thể.
REPORTING_ONLY Người dùng chỉ có thể tạo và quản lý báo cáo.
LIMITED_REPORTING_ONLY Người dùng chỉ có thể tạo và quản lý các báo cáo an toàn cho khách hàng sau đây: Chung, Hiệu suất đối tượng, Nhiều đối tác, Từ khoá, Mã đơn đặt hàng, Danh mục và Nhà cung cấp dữ liệu bên thứ ba.
CREATIVE Người dùng có thể xem thông tin về kế hoạch truyền thông mà họ cần để cộng tác, nhưng không thể xem dữ liệu liên quan đến chi phí hoặc Marketplace.
CREATIVE_ADMIN Người dùng có thể xem thông tin về kế hoạch truyền thông mà họ cần để cộng tác, nhưng không thể xem dữ liệu liên quan đến chi phí hoặc Marketplace. Ngoài ra, họ có thể thêm quản trị viên mẫu quảng cáo hoặc người dùng mẫu quảng cáo khác vào pháp nhân.

Phương thức

bulkEditAssignedUserRoles

 Chỉnh sửa hàng loạt vai trò của người dùng cho một người dùng.

create

 Tạo người dùng mới.

delete

 Xoá người dùng.

get

 Lấy thông tin người dùng.

list

 Liệt kê những người dùng mà người dùng hiện tại có thể truy cập.

patch

 Cập nhật người dùng hiện tại.