วัตถุข้อมูล CustomerRole - การจัดการลูกค้า

กําหนดสิทธิ์การเข้าถึงบัญชีสําหรับบุคคลที่ดําเนินการในนามของลูกค้าที่ระบุ

บุคคลหนึ่งสามารถใช้ข้อมูลประจําตัวการเข้าสู่ระบบเดียวกันเพื่อเข้าถึงบัญชีของลูกค้าหลายราย และสามารถส่งกลับวัตถุ CustomerRole หลายรายการสําหรับหนึ่งบุคคลผ่านการดําเนินการ GetUser ได้ ตัวอย่างเช่น ออบเจ็กต์ CustomerRole สองรายการจะถูกส่งกลับถ้า user@contoso.com ได้รับเชิญไปยัง Customer 123 และผู้ใช้ยังมีสิทธิ์ในการจัดการบัญชีที่เชื่อมโยงภายใต้ Customer 234

ผู้ใช้มีบทบาทเดียวกันใน CustomerId, AccountIds และ LinkedAccountIds สําหรับ CustomerRole ที่กําหนด อย่างไรก็ตาม ถ้าผู้ใช้มีบทบาทลูกค้าหลายบทบาท จากนั้นใช้เป็นสิทธิ์ที่มีผลบังคับใช้ทั้งหมดจะขึ้นอยู่กับชุดเต็มของ CustomerRoles ที่GetUser ส่งกลับ ตัวอย่างหลายตัวอย่างมีให้ด้านล่าง

เคล็ดลับ

โปรดดูคู่มือ ความสัมพันธ์ของบัญชีและสิทธิ์ผู้ใช้ สําหรับภาพรวมของบทบาทลูกค้าพร้อมตัวอย่าง

ไวยากรณ์

<xs:complexType name="CustomerRole" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="RoleId" type="xs:int" />
    <xs:element minOccurs="0" name="CustomerId" type="xs:long" />
    <xs:element xmlns:q7="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AccountIds" nillable="true" type="q7:ArrayOflong" />
    <xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="LinkedAccountIds" nillable="true" type="q8:ArrayOflong" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

องค์ ประกอบ

วัตถุ CustomerRole มีองค์ประกอบต่อไปนี้: AccountIds, CustomerId, CustomerLinkPermission, LinkedAccountIds, RoleId

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AccountIds	รายการของบัญชีที่ผู้ใช้สามารถเข้าถึงได้ในลูกค้า ถ้าผู้ใช้มีระดับการเข้าถึง CID จะไม่ส่งกลับ AccountIDs สําหรับการเข้าถึงระดับบัญชี AccountIDs จะถูกส่งกลับในวัตถุ CustomerRole ของ GetUser API	อาร์เรย์ยาว
CustomerId	ตัวระบุของลูกค้าที่ผู้ใช้ได้ลงทะเบียนหรือมีความสัมพันธ์ ตามลําดับชั้นของบัญชี บางอย่าง	ยาว
CustomerLinkPermission	กําหนดว่าการเข้าถึงบัญชีของผู้ใช้จะถูกจํากัดตามลําดับชั้นลูกค้าหรือไม่ เช่น การเชื่อมโยงลูกค้าระดับลูกค้า ค่าที่เป็นไปได้รวมถึง Administrative, Standard และ LinkedEntityOnly นอกจากนี้ อาจเป็นไปได้ว่าเขตข้อมูลนี้อาจเป็นแบบ nil หรือค่าว่าง ถ้าฟิลด์นี้เป็นเลขศูนย์หรือว่างเปล่า ผู้ใช้จะลงทะเบียนโดยตรงบน CustomerId ถ้าเขตข้อมูลนี้ถูกตั้งค่าเป็น "การดูแลระบบ" ผู้ใช้จะสามารถเข้าถึง CustomerId ผ่าน ลิงก์ลูกค้าระดับผู้ดูแลได้ ถ้าเขตข้อมูลนี้ถูกตั้งค่าเป็น "มาตรฐาน" ผู้ใช้จะสามารถเข้าถึง CustomerId ผ่าน ลิงก์ลูกค้ามาตรฐาน ถ้าเขตข้อมูลนี้ถูกตั้งค่าเป็น "LinkedEntityOnly" ผู้ใช้จะลงทะเบียนโดยตรงบน CustomerId แต่ไม่สามารถเข้าถึงบัญชีผู้โฆษณาได้ CustomerId เป็นส่วนหนึ่งของลําดับชั้นลิงก์ลูกค้าโดยที่ผู้ใช้สามารถเข้าถึงลูกค้าอื่น ๆ ที่อยู่ด้านล่างได้ สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือทางเทคนิคเกี่ยวกับบทบาทผู้ใช้	สาย อักขระ
LinkedAccountIds	รายการของบัญชีที่เชื่อมโยงที่ผู้ใช้สามารถเข้าถึงผ่านทาง CustomerId ในฐานะตัวแทนในนามของลูกค้ารายอื่น หากองค์ประกอบนี้ไม่มีอยู่ ผู้ใช้จะไม่สามารถเข้าถึงบัญชีผู้ลงโฆษณาที่เชื่อมโยงแต่ละรายการผ่าน CustomerId ได้ ผู้ใช้อาจมีสิทธิ์เข้าถึงบัญชีผู้ลงโฆษณาในลูกค้าที่เชื่อมโยงอื่น ๆ ดังนั้นอย่าลืมคํานึงถึง CustomerRoles ทั้งหมดที่GetUser ส่งกลับ โปรดทราบว่าบัญชีที่สร้างขึ้นเป็นตัวรวมผ่าน SignupCustomer จะถูกส่งกลับในองค์ประกอบนี้ด้วย คุณสามารถลบบัญชีรวมผ่าน DeleteAccount แต่คุณไม่สามารถยกเลิกลิงก์ผ่าน UpdateClientLinks ได้ เรียกใช้การดําเนินการ SearchClientLinks เพื่อช่วยกําหนดว่าบัญชีใดที่สามารถยกเลิกการเชื่อมโยงได้	อาร์เรย์ยาว
RoleId	บทบาทที่ผู้ใช้มีเมื่อเข้าถึงบัญชีผู้ลงโฆษณาผ่าน CustomerId ค่าที่เป็นไปได้มีดังนี้: 16 - ผู้ใช้มีบทบาทตัวจัดการแคมเปญของผู้ลงโฆษณา 33 - ผู้ใช้มีบทบาทตัวรวม 41 - ผู้ใช้มีบทบาท Super Admin 100 - ผู้ใช้มีบทบาทผู้ชม 203 - ผู้ใช้มีบทบาทผู้ใช้มาตรฐาน สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือทางเทคนิคเกี่ยวกับบทบาทผู้ใช้	Int

ข้อกําหนด

บริการ: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

ใช้โดย

GetUser