การดําเนินการบริการ AddInsertionOrder - การเรียกเก็บเงินของลูกค้า
เพิ่มลําดับการแทรกให้กับบัญชีที่ระบุ
ร้องขอองค์ประกอบ
วัตถุ AddInsertionOrderRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
InsertionOrder | ลําดับการแทรกเพื่อเพิ่มไปยังบัญชีผู้ใช้ | InsertionOrder |
องค์ประกอบส่วนหัวของคําขอ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
สาย อักขระ |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
สาย อักขระ |
รหัส ผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
ชื่อ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
องค์ประกอบการตอบสนอง
วัตถุ AddInsertionOrderResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
CreateTime | ระบุเวลาเซิร์ฟเวอร์ใน UTC เมื่อมีการเพิ่มลําดับการแทรก | Datetime |
InsertionOrderId | ค่า ยาว ที่แสดงถึงตัวระบุสําหรับลําดับการแทรกที่ถูกเพิ่ม | ยาว |
องค์ประกอบส่วนหัวการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
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/Billing/v13">
<Action mustUnderstand="1">AddInsertionOrder</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<AddInsertionOrderRequest xmlns="https://bingads.microsoft.com/Billing/v13">
<InsertionOrder xmlns:e1="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e1:AccountId>ValueHere</e1:AccountId>
<e1:BookingCountryCode i:nil="false">ValueHere</e1:BookingCountryCode>
<e1:Comment i:nil="false">ValueHere</e1:Comment>
<e1:EndDate i:nil="false">ValueHere</e1:EndDate>
<e1:Id i:nil="false">ValueHere</e1:Id>
<e1:LastModifiedByUserId i:nil="false">ValueHere</e1:LastModifiedByUserId>
<e1:LastModifiedTime i:nil="false">ValueHere</e1:LastModifiedTime>
<e1:NotificationThreshold i:nil="false">ValueHere</e1:NotificationThreshold>
<e1:ReferenceId i:nil="false">ValueHere</e1:ReferenceId>
<e1:SpendCapAmount i:nil="false">ValueHere</e1:SpendCapAmount>
<e1:StartDate i:nil="false">ValueHere</e1:StartDate>
<e1:Name i:nil="false">ValueHere</e1:Name>
<e1:Status i:nil="false">ValueHere</e1:Status>
<e1:PurchaseOrder i:nil="false">ValueHere</e1:PurchaseOrder>
<e1:PendingChanges i:nil="false">
<e1:Comment i:nil="false">ValueHere</e1:Comment>
<e1:EndDate i:nil="false">ValueHere</e1:EndDate>
<e1:RequestedByUserId i:nil="false">ValueHere</e1:RequestedByUserId>
<e1:ModifiedDateTime i:nil="false">ValueHere</e1:ModifiedDateTime>
<e1:NotificationThreshold i:nil="false">ValueHere</e1:NotificationThreshold>
<e1:ReferenceId i:nil="false">ValueHere</e1:ReferenceId>
<e1:SpendCapAmount i:nil="false">ValueHere</e1:SpendCapAmount>
<e1:StartDate i:nil="false">ValueHere</e1:StartDate>
<e1:Name i:nil="false">ValueHere</e1:Name>
<e1:PurchaseOrder i:nil="false">ValueHere</e1:PurchaseOrder>
<e1:ChangeStatus i:nil="false">ValueHere</e1:ChangeStatus>
</e1:PendingChanges>
<e1:AccountNumber i:nil="false">ValueHere</e1:AccountNumber>
<e1:BudgetRemaining i:nil="false">ValueHere</e1:BudgetRemaining>
<e1:BudgetSpent i:nil="false">ValueHere</e1:BudgetSpent>
<e1:BudgetRemainingPercent i:nil="false">ValueHere</e1:BudgetRemainingPercent>
<e1:BudgetSpentPercent i:nil="false">ValueHere</e1:BudgetSpentPercent>
<e1:SeriesName i:nil="false">ValueHere</e1:SeriesName>
<e1:IsInSeries i:nil="false">ValueHere</e1:IsInSeries>
<e1:SeriesFrequencyType i:nil="false">ValueHere</e1:SeriesFrequencyType>
<e1:IsUnlimited i:nil="false">ValueHere</e1:IsUnlimited>
<e1:IsEndless i:nil="false">ValueHere</e1:IsEndless>
</InsertionOrder>
</AddInsertionOrderRequest>
</s:Body>
</s:Envelope>
Response SOAP
เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงลําดับขององค์ประกอบ เนื้อ ความและ ส่วนหัว สําหรับการตอบสนอง SOAP
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/Billing/v13">
<TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
</s:Header>
<s:Body>
<AddInsertionOrderResponse xmlns="https://bingads.microsoft.com/Billing/v13">
<InsertionOrderId>ValueHere</InsertionOrderId>
<CreateTime>ValueHere</CreateTime>
</AddInsertionOrderResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<AddInsertionOrderResponse> AddInsertionOrderAsync(
InsertionOrder insertionOrder)
{
var request = new AddInsertionOrderRequest
{
InsertionOrder = insertionOrder
};
return (await CustomerBillingService.CallAsync((s, r) => s.AddInsertionOrderAsync(r), request));
}
static AddInsertionOrderResponse addInsertionOrder(
InsertionOrder insertionOrder) throws RemoteException, Exception
{
AddInsertionOrderRequest request = new AddInsertionOrderRequest();
request.setInsertionOrder(insertionOrder);
return CustomerBillingService.getService().addInsertionOrder(request);
}
static function AddInsertionOrder(
$insertionOrder)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerBillingProxy'];
$request = new AddInsertionOrderRequest();
$request->InsertionOrder = $insertionOrder;
return $GLOBALS['CustomerBillingProxy']->GetService()->AddInsertionOrder($request);
}
response=customerbilling_service.AddInsertionOrder(
InsertionOrder=InsertionOrder)
ข้อกําหนด
บริการ: CustomerBillingService.svc v13
Namespace: https://bingads.microsoft.com/Billing/v13