การดําเนินการบริการ AddClientLinks - การจัดการลูกค้า
เริ่มต้นกระบวนการลิงก์ไคลเอ็นต์เพื่อจัดการบัญชีของลูกค้ารายอื่น ส่งคําขอลิงก์จากลูกค้ารายหนึ่งไปยังลูกค้าหรือบัญชีอื่น
หมายเหตุ
เฉพาะผู้ใช้ที่มีข้อมูลประจําตัวแบบ Super Admin หรือ Standard เท่านั้นที่สามารถเพิ่ม อัปเดต และค้นหาลิงก์ไคลเอ็นต์ไปยังบัญชีผู้ลงโฆษณาได้ เฉพาะผู้ใช้ที่มีข้อมูลประจําตัว Super Admin เท่านั้นที่สามารถเพิ่ม อัปเดต และค้นหาลิงก์ไคลเอ็นต์ไปยังลูกค้าได้ สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือทางเทคนิคเกี่ยวกับบทบาทผู้ใช้
ไม่มีการจํากัดจํานวนบัญชีลูกค้าที่สามารถเชื่อมโยงกับตัวแทนได้ บัญชีลูกค้าต้องมีการตั้งค่าเครื่องมือในการชําระเงินที่ถูกต้องสําหรับการเรียกเก็บเงินหลังการชําระเงิน บัญชีที่ชําระเงินล่วงหน้าไม่ได้รับการสนับสนุนสําหรับการจัดการโดยหน่วยงาน
เคล็ดลับ
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับวงจรการใช้งานของลิงก์ไคลเอ็นต์ ให้ดูคู่มือทางเทคนิคของลําดับชั้นบัญชี สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการเป็นหน่วยงาน ดูทรัพยากรสําหรับคู่ค้าตัวแทน สําหรับข้อมูลเพิ่มเติมจากมุมมองของลูกค้า ดูวิธีการให้ตัวแทนจัดการบัญชี Microsoft Advertising ของคุณ
หมายเหตุ
ลูกค้าตัวแทนในสร้างบัญชีในนามของนักบินไคลเอ็นต์ (GetCustomerPilotFeatures ส่งกลับ 793) ยังสามารถสร้างลิงก์ไคลเอ็นต์ระดับบัญชีโฆษณาผ่านการดําเนินการบริการ SignupCustomer สําหรับข้อมูลเพิ่มเติม โปรดดู SignupCustomer
ร้องขอองค์ประกอบ
วัตถุ AddClientLinksRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของคําขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
ClientLinks | รายการของลิงก์ไคลเอ็นต์ที่จะเพิ่ม คุณควรจํากัดการร้องขอของคุณไปยังลิงก์ไคลเอ็นต์ 10 ลิงก์ต่อการโทร |
อาร์เรย์ ClientLink |
องค์ประกอบส่วนหัวของคําขอ
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
เชือก |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
เชือก |
รหัสผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | เชือก |
ชื่อผู้ใช้ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | เชือก |
องค์ประกอบการตอบสนอง
วัตถุ AddClientLinksResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
OperationErrors | รายการสาเหตุอย่างน้อยหนึ่งประการที่การดําเนินการบริการล้มเหลว และไม่มีการเพิ่มลิงก์ไคลเอ็นต์ | อาร์เรย์ OperationError |
ตัวแก้ไขบางส่วน | อาร์เรย์ของ รายการ OperationError ที่มีรายละเอียดสําหรับลิงก์ไคลเอ็นต์ที่ไม่สามารถเพิ่มได้สําเร็จ ผลลัพธ์จะถูกส่งกลับในลําดับเดียวกันที่สอดคล้องกับลิงก์ไคลเอ็นต์ที่ร้องขอ จํานวนองค์ประกอบรายการมิติแรกจะเท่ากับจํานวนลิงก์ไคลเอ็นต์ที่ร้องขอ สําหรับการเพิ่มลิงก์ไคลเอ็นต์ได้สําเร็จ องค์ประกอบ OperationError ที่ดัชนีที่สอดคล้องกันเป็น Null |
อาร์เรย์ OperationError |
องค์ประกอบส่วนหัวการตอบสนอง
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
TrackingId | ตัวระบุของรายการบันทึกที่ประกอบด้วยรายละเอียดของการเรียกใช้ API | เชือก |
ร้องขอ SOAP
เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดง ลําดับ ขององค์ประกอบ เนื้อความ และ ส่วนหัว สําหรับคําขอ SOAP สําหรับชนิดที่สนับสนุนที่คุณสามารถใช้กับการดําเนินการบริการนี้ โปรดดูการอ้างอิง องค์ประกอบเนื้อความคําขอ ด้านบน
<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
<Action mustUnderstand="1">AddClientLinks</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<AddClientLinksRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<ClientLinks xmlns:e9="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e9:ClientLink>
<e9:Type i:nil="false">ValueHere</e9:Type>
<e9:ClientEntityId i:nil="false">ValueHere</e9:ClientEntityId>
<e9:ClientEntityNumber i:nil="false">ValueHere</e9:ClientEntityNumber>
<e9:ClientEntityName i:nil="false">ValueHere</e9:ClientEntityName>
<e9:ManagingCustomerId i:nil="false">ValueHere</e9:ManagingCustomerId>
<e9:ManagingCustomerNumber i:nil="false">ValueHere</e9:ManagingCustomerNumber>
<e9:ManagingCustomerName i:nil="false">ValueHere</e9:ManagingCustomerName>
<e9:Note i:nil="false">ValueHere</e9:Note>
<e9:Name i:nil="false">ValueHere</e9:Name>
<e9:InviterEmail i:nil="false">ValueHere</e9:InviterEmail>
<e9:InviterName i:nil="false">ValueHere</e9:InviterName>
<e9:InviterPhone i:nil="false">ValueHere</e9:InviterPhone>
<e9:IsBillToClient i:nil="false">ValueHere</e9:IsBillToClient>
<e9:StartDate i:nil="false">ValueHere</e9:StartDate>
<e9:Status i:nil="false">ValueHere</e9:Status>
<e9:SuppressNotification>ValueHere</e9:SuppressNotification>
<e9:LastModifiedDateTime>ValueHere</e9:LastModifiedDateTime>
<e9:LastModifiedByUserId>ValueHere</e9:LastModifiedByUserId>
<e9:Timestamp i:nil="false">ValueHere</e9:Timestamp>
<e9:ForwardCompatibilityMap xmlns:e10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e10:KeyValuePairOfstringstring>
<e10:key i:nil="false">ValueHere</e10:key>
<e10:value i:nil="false">ValueHere</e10:value>
</e10:KeyValuePairOfstringstring>
</e9:ForwardCompatibilityMap>
<e9:CustomerLinkPermission i:nil="false">ValueHere</e9:CustomerLinkPermission>
</e9:ClientLink>
</ClientLinks>
</AddClientLinksRequest>
</s:Body>
</s:Envelope>
Response SOAP
เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงลําดับขององค์ประกอบ เนื้อ ความและ ส่วนหัว สําหรับการตอบสนอง SOAP
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
<TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
</s:Header>
<s:Body>
<AddClientLinksResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<OperationErrors xmlns:e11="https://bingads.microsoft.com/Customer/v13/Exception" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e11:OperationError>
<e11:Code>ValueHere</e11:Code>
<e11:Details d4p1:nil="false">ValueHere</e11:Details>
<e11:Message d4p1:nil="false">ValueHere</e11:Message>
</e11:OperationError>
</OperationErrors>
<PartialErrors xmlns:e12="https://bingads.microsoft.com/Customer/v13/Exception" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e12:ArrayOfOperationError>
<e12:OperationError>
<e12:Code>ValueHere</e12:Code>
<e12:Details d4p1:nil="false">ValueHere</e12:Details>
<e12:Message d4p1:nil="false">ValueHere</e12:Message>
</e12:OperationError>
</e12:ArrayOfOperationError>
</PartialErrors>
</AddClientLinksResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<AddClientLinksResponse> AddClientLinksAsync(
IList<ClientLink> clientLinks)
{
var request = new AddClientLinksRequest
{
ClientLinks = clientLinks
};
return (await CustomerManagementService.CallAsync((s, r) => s.AddClientLinksAsync(r), request));
}
static AddClientLinksResponse addClientLinks(
ArrayOfClientLink clientLinks) throws RemoteException, Exception
{
AddClientLinksRequest request = new AddClientLinksRequest();
request.setClientLinks(clientLinks);
return CustomerManagementService.getService().addClientLinks(request);
}
static function AddClientLinks(
$clientLinks)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new AddClientLinksRequest();
$request->ClientLinks = $clientLinks;
return $GLOBALS['CustomerManagementProxy']->GetService()->AddClientLinks($request);
}
response=customermanagement_service.AddClientLinks(
ClientLinks=ClientLinks)
ข้อกําหนด
บริการ: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13
URL การร้องขอ
https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13/ClientLinks
ร้องขอองค์ประกอบ
วัตถุ AddClientLinksRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของคําขอการดําเนินการบริการ
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
ClientLinks | รายการของลิงก์ไคลเอ็นต์ที่จะเพิ่ม คุณควรจํากัดการร้องขอของคุณไปยังลิงก์ไคลเอ็นต์ 10 ลิงก์ต่อการโทร |
อาร์เรย์ ClientLink |
องค์ประกอบส่วนหัวของคําขอ
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
การอนุญาต | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising โปรดตรวจสอบให้แน่ใจว่าโทเค็นขึ้นต้นด้วย "Bearer " ซึ่งจําเป็นสําหรับการรับรองความถูกต้องที่เหมาะสม สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
เชือก |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
เชือก |
รหัสผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | เชือก |
ชื่อผู้ใช้ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | เชือก |
องค์ประกอบการตอบสนอง
วัตถุ AddClientLinksResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงในการตอบสนอง JSON
องค์ประกอบเนื้อความการตอบสนอง
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
OperationErrors | รายการสาเหตุอย่างน้อยหนึ่งประการที่การดําเนินการบริการล้มเหลว และไม่มีการเพิ่มลิงก์ไคลเอ็นต์ | อาร์เรย์ OperationError |
ตัวแก้ไขบางส่วน | อาร์เรย์ของ รายการ OperationError ที่มีรายละเอียดสําหรับลิงก์ไคลเอ็นต์ที่ไม่สามารถเพิ่มได้สําเร็จ ผลลัพธ์จะถูกส่งกลับในลําดับเดียวกันที่สอดคล้องกับลิงก์ไคลเอ็นต์ที่ร้องขอ จํานวนองค์ประกอบรายการมิติแรกจะเท่ากับจํานวนลิงก์ไคลเอ็นต์ที่ร้องขอ สําหรับการเพิ่มลิงก์ไคลเอ็นต์ได้สําเร็จ องค์ประกอบ OperationError ที่ดัชนีที่สอดคล้องกันเป็น Null |
อาร์เรย์ OperationError |
องค์ประกอบส่วนหัวการตอบสนอง
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
TrackingId | ตัวระบุของรายการบันทึกที่ประกอบด้วยรายละเอียดของการเรียกใช้ API | เชือก |
ร้องขอ JSON
เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงองค์ประกอบ เนื้อความ และ ส่วนหัว สําหรับคําขอ JSON สําหรับชนิดที่สนับสนุนที่คุณสามารถใช้กับการดําเนินการบริการนี้ โปรดดูการอ้างอิง องค์ประกอบเนื้อความคําขอ ด้านบน
{
"ClientLinks": [
{
"ClientEntityId": "LongValueHere",
"ClientEntityName": "ValueHere",
"ClientEntityNumber": "ValueHere",
"CustomerLinkPermission": "ValueHere",
"ForwardCompatibilityMap": [
{
"key": "ValueHere",
"value": "ValueHere"
}
],
"InviterEmail": "ValueHere",
"InviterName": "ValueHere",
"InviterPhone": "ValueHere",
"IsBillToClient": "ValueHere",
"LastModifiedByUserId": "LongValueHere",
"LastModifiedDateTime": "ValueHere",
"ManagingCustomerId": "LongValueHere",
"ManagingCustomerName": "ValueHere",
"ManagingCustomerNumber": "ValueHere",
"Name": "ValueHere",
"Note": "ValueHere",
"StartDate": "ValueHere",
"Status": "ValueHere",
"SuppressNotification": "ValueHere",
"Timestamp": "ValueHere",
"Type": "ValueHere"
}
]
}
การตอบสนอง JSON
เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงองค์ประกอบ เนื้อความ และ ส่วนหัว สําหรับการตอบสนอง JSON
{
"OperationErrors": [
{
"Code": IntValueHere,
"Details": "ValueHere",
"Message": "ValueHere"
}
],
"PartialErrors": [
{
"Code": IntValueHere,
"Details": "ValueHere",
"Message": "ValueHere"
}
]
}
ไวยากรณ์โค้ด
หากต้องการเรียกใช้ REST API ผ่าน SDK คุณจําเป็นต้องอัปเกรด SDK เป็นเวอร์ชันเฉพาะและกําหนดค่าพารามิเตอร์ระบบ ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<AddClientLinksResponse> AddClientLinksAsync(
IList<ClientLink> clientLinks)
{
var request = new AddClientLinksRequest
{
ClientLinks = clientLinks
};
return (await CustomerManagementService.CallAsync((s, r) => s.AddClientLinksAsync(r), request));
}
static AddClientLinksResponse addClientLinks(
ArrayOfClientLink clientLinks) throws RemoteException, Exception
{
AddClientLinksRequest request = new AddClientLinksRequest();
request.setClientLinks(clientLinks);
return CustomerManagementService.getService().addClientLinks(request);
}
static function AddClientLinks(
$clientLinks)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new AddClientLinksRequest();
$request->ClientLinks = $clientLinks;
return $GLOBALS['CustomerManagementProxy']->GetService()->AddClientLinks($request);
}
response=customermanagement_service.AddClientLinks(
ClientLinks=ClientLinks)