การดําเนินการบริการ SearchInsertionOrders - การเรียกเก็บเงินของลูกค้า

ค้นหาลําดับการแทรกที่ตรงกับเกณฑ์ที่ระบุ

ร้องขอองค์ประกอบ

วัตถุ SearchInsertionOrdersRequest กําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP

หมายเหตุ

เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด

ร้องขอองค์ประกอบเนื้อความ

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
สั่ง ซื้อ	กําหนดลําดับของผลลัพธ์ตามคุณสมบัติที่ระบุของบัญชี คุณควรระบุองค์ประกอบ OrderBy เพียงองค์ประกอบเดียวในอาร์เรย์ องค์ประกอบเพิ่มเติมไม่ได้รับการสนับสนุนและจะถูกละเว้นโดยบริการ สําหรับการดําเนินการบริการนี้ ค่าต่อไปนี้ได้รับการสนับสนุนในองค์ประกอบ Field ของวัตถุ OrderBy Id - ลําดับจะถูกกําหนดโดยองค์ประกอบ ID ของ InsertionOrder ที่ส่งกลับ Name - ลําดับจะถูกกําหนดโดยองค์ประกอบ Name ของ InsertionOrder ที่ส่งกลับ	อาร์เรย์ OrderBy
PageInfo	กําหนดดัชนีและขนาดของผลลัพธ์ต่อหน้า	เพ จจิ้ง
เพรดิเคต	กําหนดเงื่อนไขของคําขอ การตอบสนองของการดําเนินการนี้จะรวมบัญชีผู้ใช้ที่ตรงกับเพรดิเคตที่ระบุทั้งหมด คุณสามารถระบุเพรดิเคตได้สูงสุด 6 เพรดิเคต และหนึ่งในเขตข้อมูลเพรดิเคตต้องเป็น AccountId คุณสามารถใช้เขตข้อมูลเพรดิเคต StartDate และ EndDate สองครั้งในการระบุช่วงวันที่เริ่มต้นและสิ้นสุด และมิฉะนั้นอาจใช้แต่ละเขตข้อมูลเพรดิเคตเพียงครั้งเดียวก็ได้ สําหรับรายการขององค์ประกอบเขตข้อมูลและตัวดําเนินการที่สนับสนุนของวัตถุเพรดิเคตสําหรับการดําเนินการบริการนี้ ดู หมายเหตุเพรดิเคต	เพรดิเคต อาร์เรย์
ReturnAdditionalFields	รายการของคุณสมบัติเพิ่มเติมที่คุณต้องการรวมไว้ภายในแต่ละลําดับการแทรกที่ถูกส่งกลับ ค่าเขตข้อมูลเพิ่มเติมช่วยให้คุณสามารถรับคุณลักษณะล่าสุดโดยใช้ API การเรียกเก็บเงินของลูกค้าเวอร์ชันปัจจุบัน หมายเหตุ: องค์ประกอบที่เกี่ยวข้องจะถูกรวมตามค่าเริ่มต้นในการอัปเดตในอนาคต องค์ประกอบการร้องขอนี้เป็นทางเลือก	InsertionOrderAdditionalField

องค์ประกอบส่วนหัวของคําขอ

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AuthenticationToken	โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth	สาย อักขระ
DeveloperToken	โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา	สาย อักขระ
รหัส ผ่าน	องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้	สาย อักขระ
ชื่อ	องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้	สาย อักขระ

องค์ประกอบการตอบสนอง

วัตถุ SearchInsertionOrdersResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP

องค์ประกอบเนื้อความการตอบสนอง

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
InsertionOrders	รายการของใบสั่งการแทรกที่ตรงกับเกณฑ์ที่ระบุ	อาร์เรย์ InsertionOrder

องค์ประกอบส่วนหัวการตอบสนอง

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
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">SearchInsertionOrders</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <SearchInsertionOrdersRequest xmlns="https://bingads.microsoft.com/Billing/v13">
      <Predicates xmlns:e14="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e14:Predicate>
          <e14:Field i:nil="false">ValueHere</e14:Field>
          <e14:Operator>ValueHere</e14:Operator>
          <e14:Value i:nil="false">ValueHere</e14:Value>
        </e14:Predicate>
      </Predicates>
      <Ordering xmlns:e15="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e15:OrderBy>
          <e15:Field>ValueHere</e15:Field>
          <e15:Order>ValueHere</e15:Order>
        </e15:OrderBy>
      </Ordering>
      <PageInfo xmlns:e16="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e16:Index>ValueHere</e16:Index>
        <e16:Size>ValueHere</e16:Size>
      </PageInfo>
      <ReturnAdditionalFields i:nil="false">ValueHere</ReturnAdditionalFields>
    </SearchInsertionOrdersRequest>
  </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>
    <SearchInsertionOrdersResponse xmlns="https://bingads.microsoft.com/Billing/v13">
      <InsertionOrders xmlns:e17="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e17:InsertionOrder>
          <e17:AccountId>ValueHere</e17:AccountId>
          <e17:BookingCountryCode d4p1:nil="false">ValueHere</e17:BookingCountryCode>
          <e17:Comment d4p1:nil="false">ValueHere</e17:Comment>
          <e17:EndDate d4p1:nil="false">ValueHere</e17:EndDate>
          <e17:Id d4p1:nil="false">ValueHere</e17:Id>
          <e17:LastModifiedByUserId d4p1:nil="false">ValueHere</e17:LastModifiedByUserId>
          <e17:LastModifiedTime d4p1:nil="false">ValueHere</e17:LastModifiedTime>
          <e17:NotificationThreshold d4p1:nil="false">ValueHere</e17:NotificationThreshold>
          <e17:ReferenceId d4p1:nil="false">ValueHere</e17:ReferenceId>
          <e17:SpendCapAmount d4p1:nil="false">ValueHere</e17:SpendCapAmount>
          <e17:StartDate d4p1:nil="false">ValueHere</e17:StartDate>
          <e17:Name d4p1:nil="false">ValueHere</e17:Name>
          <e17:Status d4p1:nil="false">ValueHere</e17:Status>
          <e17:PurchaseOrder d4p1:nil="false">ValueHere</e17:PurchaseOrder>
          <e17:PendingChanges d4p1:nil="false">
            <e17:Comment d4p1:nil="false">ValueHere</e17:Comment>
            <e17:EndDate d4p1:nil="false">ValueHere</e17:EndDate>
            <e17:RequestedByUserId d4p1:nil="false">ValueHere</e17:RequestedByUserId>
            <e17:ModifiedDateTime d4p1:nil="false">ValueHere</e17:ModifiedDateTime>
            <e17:NotificationThreshold d4p1:nil="false">ValueHere</e17:NotificationThreshold>
            <e17:ReferenceId d4p1:nil="false">ValueHere</e17:ReferenceId>
            <e17:SpendCapAmount d4p1:nil="false">ValueHere</e17:SpendCapAmount>
            <e17:StartDate d4p1:nil="false">ValueHere</e17:StartDate>
            <e17:Name d4p1:nil="false">ValueHere</e17:Name>
            <e17:PurchaseOrder d4p1:nil="false">ValueHere</e17:PurchaseOrder>
            <e17:ChangeStatus d4p1:nil="false">ValueHere</e17:ChangeStatus>
          </e17:PendingChanges>
          <e17:AccountNumber d4p1:nil="false">ValueHere</e17:AccountNumber>
          <e17:BudgetRemaining d4p1:nil="false">ValueHere</e17:BudgetRemaining>
          <e17:BudgetSpent d4p1:nil="false">ValueHere</e17:BudgetSpent>
          <e17:BudgetRemainingPercent d4p1:nil="false">ValueHere</e17:BudgetRemainingPercent>
          <e17:BudgetSpentPercent d4p1:nil="false">ValueHere</e17:BudgetSpentPercent>
          <e17:SeriesName d4p1:nil="false">ValueHere</e17:SeriesName>
          <e17:IsInSeries d4p1:nil="false">ValueHere</e17:IsInSeries>
          <e17:SeriesFrequencyType d4p1:nil="false">ValueHere</e17:SeriesFrequencyType>
          <e17:IsUnlimited d4p1:nil="false">ValueHere</e17:IsUnlimited>
          <e17:IsEndless d4p1:nil="false">ValueHere</e17:IsEndless>
        </e17:InsertionOrder>
      </InsertionOrders>
    </SearchInsertionOrdersResponse>
  </s:Body>
</s:Envelope>

ไวยากรณ์โค้ด

ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม

public async Task<SearchInsertionOrdersResponse> SearchInsertionOrdersAsync(
	IList<Predicate> predicates,
	IList<OrderBy> ordering,
	Paging pageInfo,
	InsertionOrderAdditionalField? returnAdditionalFields)
{
	var request = new SearchInsertionOrdersRequest
	{
		Predicates = predicates,
		Ordering = ordering,
		PageInfo = pageInfo,
		ReturnAdditionalFields = returnAdditionalFields
	};

	return (await CustomerBillingService.CallAsync((s, r) => s.SearchInsertionOrdersAsync(r), request));
}

static SearchInsertionOrdersResponse searchInsertionOrders(
	ArrayOfPredicate predicates,
	ArrayOfOrderBy ordering,
	Paging pageInfo,
	ArrayList<InsertionOrderAdditionalField> returnAdditionalFields) throws RemoteException, Exception
{
	SearchInsertionOrdersRequest request = new SearchInsertionOrdersRequest();

	request.setPredicates(predicates);
	request.setOrdering(ordering);
	request.setPageInfo(pageInfo);
	request.setReturnAdditionalFields(returnAdditionalFields);

	return CustomerBillingService.getService().searchInsertionOrders(request);
}

static function SearchInsertionOrders(
	$predicates,
	$ordering,
	$pageInfo,
	$returnAdditionalFields)
{

	$GLOBALS['Proxy'] = $GLOBALS['CustomerBillingProxy'];

	$request = new SearchInsertionOrdersRequest();

	$request->Predicates = $predicates;
	$request->Ordering = $ordering;
	$request->PageInfo = $pageInfo;
	$request->ReturnAdditionalFields = $returnAdditionalFields;

	return $GLOBALS['CustomerBillingProxy']->GetService()->SearchInsertionOrders($request);
}

response=customerbilling_service.SearchInsertionOrders(
	Predicates=Predicates,
	Ordering=Ordering,
	PageInfo=PageInfo,
	ReturnAdditionalFields=ReturnAdditionalFields)

ข้อกําหนด

บริการ: CustomerBillingService.svc v13
Namespace: https://bingads.microsoft.com/Billing/v13