วัตถุข้อมูล UserInvitation - การจัดการลูกค้า
กําหนดคําเชิญให้ผู้ใช้ลงทะเบียนสําหรับการโฆษณา Microsoft คําเชิญจะจํากัดการเข้าถึงและสิทธิ์ของบัญชี
สิ่งสำคัญ
เมื่อส่งคําเชิญแล้ว คุณสามารถเลือกที่จะจํากัดการเข้าถึงชุดย่อยของบัญชีผู้โฆษณาที่อยู่ใต้ลูกค้าของคุณได้โดยตรง ถ้า ลําดับชั้นของหน่วยงาน ถูกตั้งค่า (ตอนนี้หรือในอนาคต) ภายใต้ลูกค้าที่ได้รับเชิญ และถ้าคุณไม่จํากัดการเข้าถึงบัญชีเฉพาะ ผู้ใช้จะสามารถเข้าถึงบัญชีทั้งหมดในลําดับชั้นได้
คุณสามารถส่งคําเชิญที่ค้างอยู่หลายรายการไปยังที่อยู่อีเมลเดียวกันซึ่งยังไม่หมดอายุ นอกจากนี้ยังเป็นไปได้สําหรับคําเชิญเหล่านั้นที่จะระบุบทบาทผู้ใช้ที่แตกต่างกัน ตัวอย่างเช่น ถ้าคุณส่งคําเชิญที่มีบทบาทผู้ใช้ที่ไม่ถูกต้อง แล้วส่งคําเชิญที่สองด้วยบทบาทผู้ใช้ที่ถูกต้อง ผู้รับสามารถยอมรับคําเชิญและสามารถลงทะเบียนด้วยข้อมูลประจําตัวที่แตกต่างจากที่อยู่อีเมลคําเชิญ ผู้ใช้ Microsoft Advertising สามารถยอมรับคําเชิญไปยังลูกค้าหลายรายที่มีข้อมูลประจําตัวเดียวกันได้ สําหรับข้อมูลเพิ่มเติม ให้ดูคู่มือทางเทคนิคเกี่ยวกับข้อมูลประจําตัวผู้ใช้หลายราย
คุณสามารถค้นหาคําเชิญที่ค้างอยู่ด้วย ID คําเชิญ และดูว่าคําเชิญได้รับการยอมรับหรือหมดอายุแล้วหรือไม่ การดําเนินการ SearchUserInvitations จะส่งกลับคําเชิญที่ค้างอยู่ทั้งหมด ไม่ว่าจะหมดอายุแล้วหรือไม่ คําเชิญที่ยอมรับแล้วจะไม่รวมอยู่ในการตอบกลับ SearchUserInvitations
หลังจากยอมรับคําเชิญแล้ว คุณสามารถเรียก GetUsersInfo และ GetUser เพื่อเข้าถึงรายละเอียดผู้ใช้ Microsoft Advertising ได้ อย่างไรก็ตาม เนื่องจากผู้รับสามารถยอมรับคําเชิญและลงทะเบียนด้วยข้อมูลประจําตัวที่แตกต่างจากที่อยู่อีเมลของคําเชิญ คุณจึงไม่สามารถกําหนดได้ว่าจะแมปจาก UserInvitation ไปยังวัตถุ User หรือ UserInfo หรือไม่ ด้วย ID ผู้ใช้ที่ส่งกลับโดย GetUsersInfo หรือ GetUser คุณสามารถเรียก DeleteUser เพื่อเอาผู้ใช้ออกได้ตามต้องการ API โฆษณา Bing ไม่สนับสนุนการดําเนินการใด ๆ เพื่อลบคําเชิญผู้ใช้ที่ค้างอยู่ หลังจากที่คุณเชิญผู้ใช้ วิธีเดียวที่จะยกเลิกคําเชิญได้คือผ่านทางเว็บแอปพลิเคชัน Microsoft Advertising คุณสามารถค้นหาคําเชิญทั้งที่ค้างอยู่และที่ยอมรับได้ในส่วนผู้ใช้ของบัญชี & การเรียกเก็บเงิน
ไวยากรณ์
<xs:complexType name="UserInvitation" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="Id" type="xs:long" />
<xs:element minOccurs="0" name="FirstName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="LastName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Email" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="CustomerId" type="xs:long" />
<xs:element minOccurs="0" name="RoleId" type="xs:int" />
<xs:element xmlns:q5="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AccountIds" nillable="true" type="q5:ArrayOflong" />
<xs:element minOccurs="0" name="ExpirationDate" type="xs:dateTime" />
<xs:element minOccurs="0" name="Lcid" type="tns:LCID" />
</xs:sequence>
</xs:complexType>
องค์ ประกอบ
วัตถุ UserInvitation มีองค์ประกอบต่อไปนี้: AccountIds, CustomerId, Email, ExpirationDate, FirstName, Id, LastName, Lcid, RoleId
| องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
|---|---|---|
| AccountIds | อาร์เรย์ของตัวระบุของบัญชีที่ผู้ใช้สามารถจัดการได้ เมื่อต้องการระบุว่าผู้ใช้สามารถจัดการบัญชีปัจจุบันและในอนาคตทั้งหมดของลูกค้าที่ผู้ใช้เป็นสมาชิกให้ตั้งค่าเป็น NULL ผู้ใช้ที่มีบทบาทระดับบัญชี เช่น ผู้จัดการแคมเปญผู้ลงโฆษณาสามารถจํากัดเฉพาะบัญชีได้ ผู้ใช้ที่มีบทบาทระดับลูกค้า เช่น Super Admin สามารถเข้าถึงบัญชีทั้งหมดภายในลูกค้าของผู้ใช้ และไม่สามารถจํากัดการเข้าถึงบัญชีเฉพาะได้ เมื่อพยายามจํากัดบทบาทผู้ใช้ระดับลูกค้า ตัวอย่างเช่น เมื่อพยายามจํากัด Super Admin สําหรับบัญชีเฉพาะ การดําเนินการจะไม่ล้มเหลว และผู้ใช้จะได้รับสิทธิ์การเข้าถึงบัญชีทั้งหมดภายในลูกค้าที่ระบุ ส่ง: เสริม ลง ทะเบียน: เสริม |
อาร์เรย์ยาว |
| CustomerId | ตัวระบุของลูกค้าที่ได้รับเชิญให้ผู้ใช้รายนี้จัดการ องค์ประกอบ AccountIds จะกําหนดบัญชีลูกค้าที่ผู้ใช้สามารถจัดการได้ ส่ง: ต้องระบุ ลง ทะเบียน: อ่านอย่างเดียว |
ยาว |
| อีเมล | ที่อยู่อีเมลที่สอดคล้องกับบัญชี Microsoft ของผู้ใช้ ที่อยู่สามารถมีอักขระได้สูงสุด 100 อักขระ ส่ง: ต้องระบุ ลง ทะเบียน: ต้องระบุ |
สาย อักขระ |
| วันหมดอายุ | วันที่และเวลาที่คําเชิญผู้ใช้จะหมดอายุ ค่าอยู่ในเวลามาตรฐานสากล (UTC) ระยะเวลาของการเชิญผู้ใช้อาจเปลี่ยนแปลงได้ และตั้งค่าไว้ที่ 30 วันในขณะนี้ คุณไม่สามารถตั้งค่าหรืออัปเดตค่านี้ได้ ส่ง: อ่านอย่างเดียว ลง ทะเบียน: อ่านอย่างเดียว |
Datetime |
| ชื่อ | ชื่อของผู้ใช้ ชื่อถูกจํากัดไว้ที่ 40 ตัวอักษร ส่ง: ต้องระบุ ลง ทะเบียน: ต้องระบุ |
สาย อักขระ |
| Id | ตัวระบุที่ไม่ซ้ํากันที่ระบบสร้างขึ้นสําหรับการเชิญผู้ใช้ ส่ง: อ่านอย่างเดียว ลง ทะเบียน: อ่านอย่างเดียว |
ยาว |
| นาม สกุล | นามสกุลของผู้ใช้ นามสกุลจะถูกจํากัดไว้ที่ 40 ตัวอักษร ส่ง: ต้องระบุ ลง ทะเบียน: ต้องระบุ |
สาย อักขระ |
| Lcid | ตําแหน่งที่ตั้งที่จะใช้เมื่อส่งการโต้ตอบไปยังผู้ใช้ทางอีเมลหรือทางไปรษณีย์ ค่าเริ่มต้นคือ EnglishUS ส่ง: ต้องระบุ ลง ทะเบียน: ต้องระบุ |
LCID |
| RoleId | บทบาทที่ผู้ใช้มีสําหรับลูกค้าแต่ละรายหรือรายการบัญชี ค่าที่เป็นไปได้มีดังนี้: 16 - ผู้ใช้มีบทบาทตัวจัดการแคมเปญของผู้ลงโฆษณา 33 - ผู้ใช้มีบทบาทตัวรวม 41 - ผู้ใช้มีบทบาท Super Admin 100 - ผู้ใช้มีบทบาทผู้ชม 203 - ผู้ใช้มีบทบาทผู้ใช้มาตรฐาน สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือทางเทคนิคเกี่ยวกับบทบาทผู้ใช้ ส่ง: ต้องระบุ ลง ทะเบียน: ต้องระบุ ID บทบาทต้องตั้งค่าเป็น 41 หรือ 203 |
Int |
ข้อกําหนด
บริการ: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities