REST Resource: users

แหล่งข้อมูล: ผู้ใช้

ผู้ใช้รายเดียวใน Display & Video 360

การแสดง JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของผู้ใช้
userId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ใช้ ระบบกำหนด
email

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ อีเมลที่ใช้เพื่อระบุตัวตนผู้ใช้
displayName

string

ต้องระบุ ชื่อที่แสดงของผู้ใช้

ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 240 ไบต์
assignedUserRoles[]

object (AssignedUserRole)

บทบาทของผู้ใช้ที่ได้รับมอบหมาย

ต้องระบุใน users.create แสดงผลใน users.patch เท่านั้น อัปเดตได้ผ่าน users.bulkEditAssignedUserRoles เท่านั้น
lastLoginTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาเมื่อผู้ใช้เข้าสู่ระบบ UI ของ 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),

  // 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.
}
ช่อง
assignedUserRoleId

string

เอาต์พุตเท่านั้น รหัสของบทบาทของผู้ใช้ที่ได้รับมอบหมาย
userRole

enum (UserRole)

ต้องระบุ บทบาทของผู้ใช้ที่จะมอบหมายให้กับผู้ใช้สำหรับเอนทิตี

ต้องระบุ

รหัสของเอนทิตีที่บทบาทผู้ใช้ที่กำหนดมีผล ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
partnerId

string (int64 format)

รหัสของพาร์ทเนอร์ที่บทบาทของผู้ใช้ที่กำหนดมีผล
advertiserId

string (int64 format)

รหัสของผู้ลงโฆษณาที่ใช้บทบาทของผู้ใช้ที่กำหนด
สิ้นสุดฟิลด์ที่แยกกัน

UserRole

บทบาทของผู้ใช้ที่เป็นไปได้

Enum
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 ผู้ใช้จะสร้างและจัดการรายงานที่ปลอดภัยสำหรับไคลเอ็นต์ต่อไปนี้ได้เท่านั้น ได้แก่ ทั่วไป ประสิทธิภาพของกลุ่มเป้าหมาย ข้ามพาร์ทเนอร์ คีย์เวิร์ด รหัสคำสั่งซื้อ หมวดหมู่ และผู้ให้บริการข้อมูลบุคคลที่สาม
CREATIVE ผู้ใช้จะดูข้อมูลแผนการโฆษณาที่จำเป็นต่อการทำงานร่วมกันได้ แต่จะดูข้อมูลที่เกี่ยวข้องกับค่าใช้จ่ายหรือมาร์เก็ตเพลสไม่ได้
CREATIVE_ADMIN ผู้ใช้จะดูข้อมูลแผนการโฆษณาที่จำเป็นต่อการทำงานร่วมกันได้ แต่จะดูข้อมูลที่เกี่ยวข้องกับค่าใช้จ่ายหรือมาร์เก็ตเพลสไม่ได้ นอกจากนี้ ผู้ดูแลระบบยังเพิ่มผู้ดูแลระบบครีเอทีฟโฆษณาหรือผู้ใช้ครีเอทีฟโฆษณารายอื่นลงในเอนทิตีได้ด้วย

เมธอด

bulkEditAssignedUserRoles

 แก้ไขบทบาทของผู้ใช้หลายรายพร้อมกัน

create

 สร้างผู้ใช้ใหม่

delete

 ลบผู้ใช้

get

 รับผู้ใช้

list

 แสดงรายชื่อผู้ใช้ที่ผู้ใช้ปัจจุบันเข้าถึงได้

patch

 อัปเดตผู้ใช้ที่มีอยู่