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

กําหนดวัตถุลิงก์ไคลเอ็นต์ การยอมรับคําเชิญลิงก์ลูกค้าช่วยให้หน่วยงานสามารถจัดการบัญชีผู้โฆษณาของลูกค้าที่เกี่ยวข้องได้ หากต้องการส่งคําเชิญเพื่อจัดการบัญชีผู้โฆษณาไคลเอ็นต์ ให้เรียกใช้การดําเนินการ AddClientLinks และระบุลิงก์ไคลเอ็นต์หนึ่งลิงก์ต่อบัญชีเพื่อจัดการ

ลิงก์ไคลเอ็นต์ไม่มีตัวระบุระบบสาธารณะ คุณสามารถระบุลิงก์ไคลเอ็นต์ที่แตกต่างกันโดย ClientEntityId และ การจัดการ CustomerId ได้

เคล็ดลับ

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับวงจรการใช้งานของลิงก์ไคลเอ็นต์ ให้ดูคู่มือทางเทคนิคของลําดับชั้นบัญชี สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการเป็นหน่วยงาน ดูทรัพยากรสําหรับคู่ค้าตัวแทน สําหรับข้อมูลเพิ่มเติมจากมุมมองของลูกค้า ดูวิธีการให้ตัวแทนจัดการบัญชี Microsoft Advertising ของคุณ

หมายเหตุ

ลูกค้าตัวแทนในสร้างบัญชีในนามของนักบินไคลเอ็นต์ (GetCustomerPilotFeatures ส่งกลับ 793) ยังสามารถสร้างลิงก์ไคลเอ็นต์ระดับบัญชีโฆษณาผ่านการดําเนินการบริการ SignupCustomer สําหรับข้อมูลเพิ่มเติม โปรดดู SignupCustomer

วากยสัมพันธ์

<xs:complexType name="ClientLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ClientEntityNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ManagingCustomerNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Note" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterPhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsBillToClient" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ClientLinkStatus" />
    <xs:element minOccurs="0" name="SuppressNotification" type="xs:boolean" />
    <xs:element minOccurs="0" name="LastModifiedDateTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" type="xs:long" />
    <xs:element minOccurs="0" name="Timestamp" nillable="true" type="xs:base64Binary" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

องค์ ประกอบ

วัตถุ ClientLink มีองค์ประกอบต่อไปนี้: ClientEntityIdClientEntityName, ClientEntityNumber, CustomerLinkPermission, ForwardCompatibilityMap, InviterEmail, InviterName, InviterPhone, IsBillToClient, LastModifiedByUserId, LastModifiedDateTime, การจัดการ CustomerId, การจัดการ CustomerName, การจัดการ CustomerNumber, Name, Note, StartDate, Status, SuppressNotification, Timestamp, Type

ธาตุ	คำอธิบาย	ชนิดข้อมูล
ClientEntityId	ตัวระบุบัญชีผู้โฆษณาไคลเอ็นต์หรือลูกค้าที่จะจัดการ องค์ประกอบ ชนิด จะกําหนดว่าลิงก์เป็นบัญชีผู้ลงโฆษณาไคลเอ็นต์หรือลูกค้า เพิ่ม: ต้องระบุ จําเป็นต้องมี ClientEntityId หรือ ClientEntityNumber แต่การระบุทั้งสองอย่างจะทําให้การดําเนินการล้มเหลว อัพเดต: อ่านอย่างเดียวและจําเป็น	ยาว
ClientEntityName	ชื่อของบัญชีผู้โฆษณาไคลเอ็นต์หรือลูกค้าที่จะจัดการ องค์ประกอบ ชนิด จะกําหนดว่าลิงก์เป็นบัญชีผู้ลงโฆษณาไคลเอ็นต์หรือลูกค้า เพิ่ม: อ่านอย่างเดียว อัพเดต: อ่านอย่างเดียว	เชือก
ClientEntityNumber	จํานวนบัญชีผู้โฆษณาไคลเอ็นต์หรือลูกค้าที่จะจัดการ องค์ประกอบ ชนิด จะกําหนดว่าลิงก์เป็นบัญชีผู้ลงโฆษณาไคลเอ็นต์หรือลูกค้า เพิ่ม: ต้องระบุ จําเป็นต้องมี ClientEntityId หรือ ClientEntityNumber แต่การระบุทั้งสองอย่างจะทําให้การดําเนินการล้มเหลว อัพเดต: อ่านอย่างเดียวและจําเป็น	เชือก
CustomerLinkPermission	กําหนดว่าการเข้าถึงบัญชีของผู้ใช้จะถูกจํากัดตามลําดับชั้นลูกค้าหรือไม่ เช่น การเชื่อมโยงลูกค้าระดับลูกค้า องค์ประกอบนี้ใช้ได้เฉพาะเมื่อ ชนิด ถูกตั้งค่าเป็น CustomerLink ในกรณีดังกล่าว ค่าที่เป็นไปได้รวมถึงการดูแลระบบและมาตรฐาน มิฉะนั้น เขตข้อมูลนี้ควรเป็น nil หรือค่าว่าง ถ้าเขตข้อมูลนี้ถูกตั้งค่าเป็น "การดูแลระบบ" ผู้ใช้จะสามารถเข้าถึง ClientEntityId ผ่าน ลิงก์ลูกค้าระดับผู้ดูแลได้ ถ้าเขตข้อมูลนี้ถูกตั้งค่าเป็น "มาตรฐาน" ผู้ใช้จะสามารถเข้าถึง ClientEntityId ผ่าน ลิงก์ลูกค้ามาตรฐาน ClientEntityId เป็นส่วนหนึ่งของลําดับชั้นลิงก์ลูกค้าโดยที่ผู้ใช้สามารถเข้าถึงลูกค้ารายอื่นด้านล่างได้ สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือทางเทคนิคเกี่ยวกับบทบาทผู้ใช้ เพิ่ม: เสริม อัพเดต: อ่านอย่างเดียว	เชือก
ForwardCompatibilityMap	รายการของคีย์และสตริงค่าสําหรับความเข้ากันได้แบบไปข้างหน้าเพื่อหลีกเลี่ยงการเปลี่ยนแปลงที่เสียหายเป็นอย่างอื่นเมื่อมีการเพิ่มองค์ประกอบใหม่ในเวอร์ชัน API ปัจจุบัน การเปลี่ยนแปลงความเข้ากันได้ในอนาคตจะถูกบันทึกไว้ที่นี่ในรุ่นต่อ ๆ ไป ไม่มีการเปลี่ยนแปลงความเข้ากันได้ไปข้างหน้าในขณะนี้สําหรับวัตถุ ClientLink	อาร์เรย์ KeyValuePairOfstringstring
InviterEmail	อีเมลของผู้ใช้ที่สร้างคําขอลิงก์ไคลเอ็นต์ ค่านี้ไม่จําเป็นต้องเหมือนกับหรือใช้เพื่อปรับเปลี่ยนอีเมลที่จัดเก็บไว้ใน Microsoft Advertising สําหรับผู้ใช้ที่ได้รับการรับรองความถูกต้องในปัจจุบัน หากไม่ได้ระบุ บริการจะตั้งค่านี้เป็นอีเมลที่จัดเก็บไว้แล้วใน Microsoft Advertising สําหรับผู้ใช้ที่ได้รับการรับรองความถูกต้องในปัจจุบัน เพิ่ม: เสริม อัพเดต: อ่านอย่างเดียว	เชือก
InviterName	ชื่อของลูกค้าหลักของผู้ใช้ที่สร้างคําขอลิงก์ไคลเอ็นต์ ค่านี้ไม่จําเป็นต้องเหมือนกับหรือใช้เพื่อปรับเปลี่ยน ชื่อลูกค้าที่จัดเก็บไว้ใน Microsoft Advertising อยู่แล้ว หากไม่ได้ระบุ บริการจะตั้งค่านี้เป็นชื่อลูกค้าหลักที่จัดเก็บไว้ใน Microsoft Advertising สําหรับผู้ใช้ที่ได้รับการรับรองความถูกต้องในปัจจุบัน เพิ่ม: เสริม อัพเดต: อ่านอย่างเดียว	เชือก
InviterPhone	หมายเลขโทรศัพท์ของผู้ใช้ที่สร้างคําขอลิงก์ไคลเอ็นต์ ค่านี้ไม่จําเป็นต้องเหมือนกับหรือใช้เพื่อปรับเปลี่ยนหมายเลขโทรศัพท์ที่จัดเก็บไว้ใน Microsoft Advertising สําหรับผู้ใช้ที่ได้รับการรับรองความถูกต้องในปัจจุบัน ถ้าไม่ได้ระบุ บริการจะตั้งค่านี้เป็นหมายเลขโทรศัพท์ที่จัดเก็บไว้ใน Microsoft Advertising สําหรับผู้ใช้ที่ได้รับการรับรองความถูกต้องในปัจจุบัน เพิ่ม: เสริม อัพเดต: อ่านอย่างเดียว	เชือก
IsBillToClient	กําหนดว่าเจ้าของบัญชีผู้โฆษณาไคลเอ็นต์หรือการจัดการลูกค้าเป็นผู้รับผิดชอบในการชําระเงินที่เรียกเก็บเงินหรือไม่ องค์ประกอบนี้ใช้ได้กับลิงก์ไคลเอ็นต์บัญชีผู้โฆษณาเท่านั้น และไม่สามารถใช้ได้กับลิงก์ลูกค้า ต้องตั้งค่าบัญชีผู้ลงโฆษณาของลูกค้าสําหรับการเรียกเก็บเงินหลังการชําระเงิน บัญชีที่ชําระเงินล่วงหน้าไม่ได้รับการสนับสนุนสําหรับการจัดการโดยหน่วยงาน หากตั้งค่าเป็น จริง ลูกค้าจะเป็นผู้รับผิดชอบในการเรียกเก็บเงิน หากตั้งค่าเป็น เท็จ ลูกค้าที่จัดการจะต้องรับผิดชอบในการเรียกเก็บเงิน เพิ่ม: จําเป็นสําหรับลิงก์บัญชีผู้โฆษณา ไม่สามารถใช้กับลิงก์ลูกค้าได้ อัพเดต: อ่านอย่างเดียว	บูลีน
LastModifiedByUserId	ตัวระบุของผู้ใช้คนล่าสุดที่จะอัปเดตข้อมูลของลิงก์ไคลเอ็นต์ เพิ่ม: อ่านอย่างเดียว อัพเดต: อ่านอย่างเดียว	ยาว
LastModifiedDateTime	วันที่และเวลาที่อัปเดตลิงก์ไคลเอ็นต์ครั้งล่าสุด ค่าอยู่ในเวลามาตรฐานสากล (UTC) ค่าวันที่และเวลาแสดงวันที่และเวลาที่เซิร์ฟเวอร์ ไม่ใช่ไคลเอ็นต์ สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML เพิ่ม: อ่านอย่างเดียว อัพเดต: อ่านอย่างเดียว	วันที่เวลา
การจัดการ CustomerId	ตัวระบุของลูกค้าที่จัดการหรือกําลังร้องขอจัดการบัญชีผู้โฆษณาไคลเอ็นต์ เพิ่ม: ต้องระบุ จําเป็นต้องมี ManageringCustomerId หรือ ManageringCustomerNumber แต่การระบุทั้งสองอย่างจะทําให้การดําเนินการล้มเหลว อัพเดต: อ่านอย่างเดียวและจําเป็น	ยาว
การจัดการ CustomerName	ชื่อของลูกค้าที่จัดการหรือกําลังร้องขอจัดการบัญชีผู้โฆษณาไคลเอ็นต์ เพิ่ม: อ่านอย่างเดียว อัพเดต: อ่านอย่างเดียว	เชือก
ManageringCustomerNumber	จํานวนลูกค้าที่จัดการหรือร้องขอเพื่อจัดการบัญชีผู้โฆษณาของลูกค้า เพิ่ม: ต้องระบุ จําเป็นต้องมี ManageringCustomerId หรือ ManageringCustomerNumber แต่การระบุทั้งสองอย่างจะทําให้การดําเนินการล้มเหลว อัพเดต: อ่านอย่างเดียวและจําเป็น	เชือก
ชื่อ	ชื่อที่เรียกง่ายที่สามารถใช้เพื่ออ้างอิงลิงก์ไคลเอ็นต์นี้ได้ ชื่อสามารถมีอักขระได้สูงสุด 40 อักขระ ชื่อเริ่มต้นจะถูกระบุถ้าไม่มีการระบุ ชื่อไม่จําเป็นต้องไม่ซ้ํากันเมื่อเปรียบเทียบกับลิงก์ไคลเอ็นต์อื่นๆ สําหรับผู้ใช้ เพิ่ม: เสริม อัพเดต: อ่านอย่างเดียว	เชือก
หมายเหตุ	ข้อความเพิ่มเติมจากผู้ร้องขอที่ให้บริบทและรายละเอียดเกี่ยวกับการเชิญลิงก์ไคลเอ็นต์ เพิ่ม: เสริม อัพเดต: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง	เชือก
วันที่เริ่มต้น	วันที่ที่สถานะจะอัปเดต สําหรับคําขอลิงก์ที่ยอมรับ สถานะจะเปลี่ยนเป็น ใช้งานอยู่ ในวันที่นี้ และสําหรับการยกเลิกลิงก์ สถานะจะเปลี่ยนเป็น ไม่ใช้งาน ในวันที่นี้ ถ้าไม่ได้ระบุ ค่านี้จะถูกตั้งค่าเป็นวันที่และเวลาปัจจุบัน เพิ่ม: เสริม อัพเดต: อ่านอย่างเดียว	วันที่เวลา
สถานะ	กําหนดสถานะวงจรชีวิตของลิงก์ไคลเอ็นต์ ตัวอย่างเช่น ลิงก์ไคลเอ็นต์ได้รับการยอมรับหรือปฏิเสธ เมื่อเพิ่มลิงก์ไคลเอ็นต์ องค์ประกอบนี้ไม่สามารถระบุได้ และบริการจะตั้งค่าสถานะมีผลบังคับใช้เป็น LinkPending เพิ่ม: อ่านอย่างเดียว อัพเดต: ต้องระบุ	ClientLinkStatus
ไม่แสดงคําอธิบายประกอบ	กําหนดว่าจะส่งการแจ้งเตือนทางอีเมลของคําเชิญลิงก์ไคลเอ็นต์ไปยังผู้ใช้หลักของบัญชีผู้โฆษณาลูกค้าหรือไม่ ถ้าตั้งค่าเป็น จริง ไคลเอ็นต์จะไม่ได้รับอีเมลและมิฉะนั้น เนื่องจากค่าเริ่มต้นเป็น เท็จ ไคลเอ็นต์จะได้รับการแจ้งเตือนทางอีเมล เพิ่ม: เสริม อัพเดต: อ่านอย่างเดียว	บูลีน
ประทับเวลา	สงวนไว้สําหรับใช้ในอนาคต	base64Binary
ประเภท	กําหนดว่าลิงก์จะเชื่อมโยงไปยังบัญชีผู้ลงโฆษณาไคลเอ็นต์หรือลูกค้า ค่าที่เป็นไปได้คือ AccountLink และ CustomerLink ถ้าองค์ประกอบนี้ว่างเปล่าหรือตั้งค่าเป็น AccountLink ClientEntityId, ClientEntityName และ ClientEntityNumber แสดงบัญชีผู้ลงโฆษณาไคลเอ็นต์ ถ้าองค์ประกอบนี้ถูกตั้งค่าเป็น CustomerLink ClientEntityId, ClientEntityName และ ClientEntityNumber แสดงถึงลูกค้าไคลเอ็นต์ เพิ่ม: เสริม ถ้าไม่ได้ตั้งค่าองค์ประกอบนี้ บริการจะพยายามสร้างลิงก์ไคลเอ็นต์บัญชีผู้ลงโฆษณา อัพเดต: อ่านอย่างเดียว	เชือก

ข้อกําหนด

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

ใช้โดย

AddClientLinks
SearchClientLinks
UpdateClientLinks