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