วัตถุข้อมูลผู้ใช้ - การจัดการลูกค้า
กําหนดข้อมูลที่ติดต่อส่วนบุคคลและธุรกิจเกี่ยวกับผู้ใช้ Microsoft Advertising
สามารถกําหนดวัตถุของผู้ใช้หลายรายการให้กับบุคคลเดียวกันได้ เช่น ผู้ใช้หนึ่งรายต่อหนึ่งบุคคลต่อลูกค้าหนึ่งราย การตั้งค่าผู้ใช้ชื่อ Lcid, JobTitle และ ContactInfo สําหรับบุคคลเดียวกันจะถูกซิงโครไนซ์โดยอัตโนมัติกับการอัปเดตใด ๆ ที่เกิดขึ้นหลังจากการรวมผู้ใช้ LastModifiedByUserId และ LastModifiedTime ยังซิงค์กันระหว่างวัตถุ ผู้ใช้ ที่ส่งกลับแต่ละรายการ เว้นแต่ว่าคุณมีการผสานชื่อผู้ใช้เก่าและไม่ได้อัปเดตการตั้งค่าผู้ใช้ใดๆ ตั้งแต่การรวมข้อมูล
เคล็ดลับ
ด้วยข้อมูลประจําตัวผู้ใช้หลายรายของ Microsoft Advertising คุณสามารถยอมรับคําเชิญเพื่อจัดการลูกค้าแยกต่างหากด้วยข้อมูลประจําตัว Microsoft Advertising ที่มีอยู่ของคุณ สําหรับข้อมูลเพิ่มเติม ให้ดูคู่มือทางเทคนิคเกี่ยวกับข้อมูลประจําตัวผู้ใช้หลายราย
ไวยากรณ์
<xs:complexType name="User" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="ContactInfo" nillable="true" type="tns:ContactInfo" />
<xs:element minOccurs="0" name="CustomerId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="JobTitle" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
<xs:element minOccurs="0" name="Lcid" nillable="true" type="tns:LCID" />
<xs:element minOccurs="0" name="Name" nillable="true" type="tns:PersonName" />
<xs:element minOccurs="0" name="Password" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="SecretAnswer" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="SecretQuestion" type="tns:SecretQuestion" />
<xs:element minOccurs="0" name="UserLifeCycleStatus" nillable="true" type="tns:UserLifeCycleStatus" />
<xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
<xs:element minOccurs="0" name="UserName" nillable="true" type="xs:string" />
<xs:element xmlns:q6="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q6:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="AuthenticationToken" nillable="true" type="xs:string">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
องค์ ประกอบ
วัตถุผู้ใช้มีองค์ประกอบต่อไปนี้: AuthenticationToken, ContactInfo, CustomerId, ForwardCompatibilityMap, Id, JobTitle, LastModifiedByUserId, LastModifiedTime, Lcid, Name, Password, SecretAnswer, SecretQuestion, TimeStamp, UserLifeCycleStatus, UserName
| องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
|---|---|---|
| AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth ปรับ ปรุง: อ่านอย่างเดียว |
สาย อักขระ |
| ContactInfo | ข้อมูลที่ติดต่อของผู้ใช้ ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง |
ContactInfo |
| CustomerId | ตัวระบุของลูกค้าสําหรับผู้ใช้รายนี้ในการเข้าถึง ปรับ ปรุง: อ่านอย่างเดียว |
ยาว |
| ForwardCompatibilityMap | รายการของคีย์และสตริงค่าสําหรับความเข้ากันได้แบบไปข้างหน้าเพื่อหลีกเลี่ยงการเปลี่ยนแปลงที่เสียหายเป็นอย่างอื่นเมื่อมีการเพิ่มองค์ประกอบใหม่ในเวอร์ชัน API ปัจจุบัน การเปลี่ยนแปลงความเข้ากันได้ในอนาคตจะถูกบันทึกไว้ที่นี่ในรุ่นต่อ ๆ ไป ไม่มีการเปลี่ยนแปลงความเข้ากันได้ไปข้างหน้าในขณะนี้สําหรับวัตถุนี้ |
อาร์เรย์ KeyValuePairOfstringstring |
| Id | ตัวระบุ Microsoft Advertising ของผู้ใช้ ปรับ ปรุง: ต้องระบุ |
ยาว |
| ตําแหน่งงาน | ตําแหน่งงานของผู้ใช้ ชื่อเรื่องสามารถมีอักขระได้สูงสุด 50 อักขระ ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง |
สาย อักขระ |
| LastModifiedByUserId | ตัวระบุของผู้ใช้คนล่าสุดที่จะอัปเดตข้อมูลของผู้ใช้ ปรับ ปรุง: อ่านอย่างเดียว |
ยาว |
| LastModifiedTime | วันที่และเวลาที่อัปเดตข้อมูลผู้ใช้ครั้งล่าสุด ค่าอยู่ในเวลามาตรฐานสากล (UTC) ค่าวันที่และเวลาแสดงวันที่และเวลาที่เซิร์ฟเวอร์ ไม่ใช่ไคลเอ็นต์ สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML ปรับ ปรุง: อ่านอย่างเดียว |
Datetime |
| Lcid | ตําแหน่งที่ตั้งที่จะใช้เมื่อส่งการโต้ตอบไปยังผู้ใช้ทางอีเมลหรือทางไปรษณีย์ ค่าเริ่มต้นคือ EnglishUS ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง |
LCID |
| ชื่อ | ชื่อของผู้ใช้ ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง |
ชื่อบุคคล |
| รหัส ผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API การดําเนินการ GetUser ไม่ส่งกลับรหัสผ่าน ปรับ ปรุง: อ่านอย่างเดียว |
สาย อักขระ |
| SecretAnswer | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง |
สาย อักขระ |
| SecretQuestion | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง |
SecretQuestion |
| ประทับเวลา | ค่าประทับเวลาที่ระบบใช้ภายในเพื่อกระทบยอดการปรับปรุงเมื่อคุณเรียกใช้ UpdateUser หรือ DeleteUser ปรับ ปรุง: ต้องระบุ |
base64Binary |
| UserLifeCycleStatus | สถานะของผู้ใช้ ปรับ ปรุง: อ่านอย่างเดียว |
UserLifeCycleStatus |
| ชื่อ | ชื่อผู้ใช้ที่เข้าสู่ระบบของผู้ใช้ ที่อยู่อีเมลของบัญชี Microsoft อาจแตกต่างจากองค์ประกอบอีเมลของวัตถุ ContactInfo ปรับ ปรุง: อ่านอย่างเดียว |
สาย อักขระ |
ข้อกําหนด
บริการ: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities