REST Resource: users

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

ผู้ใช้รายเดียวใน Display และ วิดีโอ 360

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

string

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

userId

string (int64 format)

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

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

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

userRole

enum (UserRole)

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

ช่องการรวม entity_id ต้องระบุ

รหัสของเอนทิตีที่ใช้บทบาทของผู้ใช้ที่มอบหมาย entity_id ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้

partnerId

string (int64 format)

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

advertiserId

string (int64 format)

รหัสของผู้ลงโฆษณาที่มีบทบาทเป็นผู้ใช้ที่เกี่ยวข้อง

UserRole

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

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

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