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

Makale
12/21/2023

Belirtilen ayda hesap tarafından harcanan tutarı alır.

İstek Öğeleri

GetAccountMonthlySpendRequest 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ü
AccountId	Elde etmek için harcama bilgilerini içeren hesabın tanımlayıcısı. Hesap fatura ödeme yöntemini kullanmalıdır; kredi kartı hesapları desteklenmez. Hesap tanımlayıcısı bir toplayıcıya aitse, işlem toplayıcının yönettiği tüm müşterilerin tüm hesaplarının hesap bakiyelerini hesaplar. Toplayıcının on müşterisi varsa ve her müşterinin on hesabı varsa, işlem 100 hesabın tamamının aylık harcamasının toplamını döndürür. Toplayıcının yönettiği tek bir müşterinin hesabının aylık harcamasını almak için AccountId öğesini belirtilen hesap tanımlayıcısı olarak ayarlayın. Toplayıcının yönettiği bir müşterinin tüm hesaplarının aylık harcamasını almak için her hesap için bu işlemi çağırın ve ardından aylık harcama tutarlarını toplama.	Uzun
MonthYear	Aylık harcama bilgilerini almak istediğiniz ay ve yıl (işlem gün ve saat değerlerini yoksayar). Hizmet, belirtilen dateTime değerine karşılık gelen ay ve yıl bileşenlerini kullanır. Örneğin, 2020-05-15T00:00:00 ve 2020-05 hem geçerlidir hem de aynı sonuçları döndürür. Geçerli ayı belirtirseniz, işlem aylık harcama tutarını döndürür. Örneğin, geçerli tarih 15 Mayıs 2020 ise ve MonthYear değerini Mayıs 2020 olarak ayarlarsanız, işlem 1 Mayıs ile 15 Mayıs (dahil) için harcama tutarını döndürür. Gelecek ay ve yıl belirtemezsiniz. Veri bulunmayan bir önceki ay belirtirseniz, çağrı 0 (sıfır) döndürür. Harcama tutarı birden çok ekleme siparişine (GÇ) yayılabilir. Krediler gerçek harcamadan büyükse, döndürülen aylık harcama tutarı negatif bir değerdir.	Datetime

İ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

GetAccountMonthlySpendResponse 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ü
Tutar	Belirtilen dönemde hesap tarafından harcanan tutar. Hesap Yahoo!yönetilen olmalıdır. Hesap Yahoo!-managed değilse, dönüş değeri 0'dır.	Çift

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">GetAccountMonthlySpend</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <GetAccountMonthlySpendRequest xmlns="https://bingads.microsoft.com/Billing/v13">
      <AccountId>ValueHere</AccountId>
      <MonthYear>ValueHere</MonthYear>
    </GetAccountMonthlySpendRequest>
  </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>
    <GetAccountMonthlySpendResponse xmlns="https://bingads.microsoft.com/Billing/v13">
      <Amount>ValueHere</Amount>
    </GetAccountMonthlySpendResponse>
  </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<GetAccountMonthlySpendResponse> GetAccountMonthlySpendAsync(
	long accountId,
	DateTime monthYear)
{
	var request = new GetAccountMonthlySpendRequest
	{
		AccountId = accountId,
		MonthYear = monthYear
	};

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

static GetAccountMonthlySpendResponse getAccountMonthlySpend(
	java.lang.Long accountId,
	Calendar monthYear) throws RemoteException, Exception
{
	GetAccountMonthlySpendRequest request = new GetAccountMonthlySpendRequest();

	request.setAccountId(accountId);
	request.setMonthYear(monthYear);

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

static function GetAccountMonthlySpend(
	$accountId,
	$monthYear)
{

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

	$request = new GetAccountMonthlySpendRequest();

	$request->AccountId = $accountId;
	$request->MonthYear = $monthYear;

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

response=customerbilling_service.GetAccountMonthlySpend(
	AccountId=AccountId,
	MonthYear=MonthYear)

Gereksinimler

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

Aracılığıyla paylaş