SearchInsertionOrders Hizmeti İşlemi - Müşteri Faturalaması

Makale
04/01/2024

Belirtilen ölçütlere uyan ekleme siparişlerini arar.

İstek Öğeleri

SearchInsertionOrdersRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar. Öğelerin İstek SOAP'sinde gösterildiği gibi aynı sırada olması gerekir.

Not

Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.

İstek Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
Sipariş	Sonuçların sırasını hesabın belirtilen özelliğine göre belirler. Dizide yalnızca bir OrderBy öğesi belirtmelisiniz. Ek öğeler desteklenmez ve hizmet tarafından yoksayılır. Bu hizmet işlemi için, bir OrderBy nesnesinin Field öğesinde aşağıdaki değerler desteklenir. Id - Sipariş, döndürülen InsertOrder öğesinin Id öğesi tarafından belirlenir. Ad - Sıra, döndürülen InsertOrder öğesinin Name öğesi tarafından belirlenir.	OrderBy dizisi
PageInfo	Sayfa başına sonuçların dizinini ve boyutunu belirler.	Sayfalama
Yüklemler	İstek koşullarını belirler. Bu işlemin yanıtı, belirtilen tüm koşullarla eşleşen hesapları içerir. En fazla 6 koşul belirtebilirsiniz ve koşul alanlarından biri AccountId olmalıdır. Başlangıç ve bitiş tarihi aralıklarını belirtmek için StartDate ve EndDate koşul alanlarını her iki kez kullanabilirsiniz ve aksi takdirde her koşul alanını yalnızca bir kez kullanabilirsiniz. Bu hizmet işlemi için bir Koşul nesnesinin desteklenen Alan ve İşleç öğelerinin listesi için bkz. Koşul Açıklamaları.	Koşul dizisi
ReturnAdditionalFields	Döndürülen her ekleme sırasına eklenmesini istediğiniz ek özelliklerin listesi. Ek alan değerleri, Müşteri Faturalama API'sinin geçerli sürümünü kullanarak en son özellikleri edinmenizi sağlar. Not: İlgili öğeler, gelecek bir güncelleştirmede varsayılan olarak eklenecektir. Bu istek öğesi isteğe bağlıdır.	InsertOrderAdditionalField

İstek Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
AuthenticationToken	Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması.	Dize
DeveloperToken	Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma.	Dize
Password	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize
Username	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize

Yanıt Öğeleri

SearchInsertionOrdersResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt SOAP'sinde gösterildiği gibi aynı sırada döndürülür.

Yanıt Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
InsertOrders	Belirtilen ölçütlere uyan ekleme siparişlerinin listesi.	InsertOrder dizisi

Yanıt Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
TrackingId	API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı.	Dize

SOAP isteme

Bu şablon, SOAP isteği için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.

<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>

Yanıt SOAP

Bu şablon, SOAP yanıtı için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur.

<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>

Kod Söz Dizimi

Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .

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)

Gereksinimler

Hizmet: CustomerBillingService.svc v13
Ad alanı: https://bingads.microsoft.com/Billing/v13

Aracılığıyla paylaş