แชร์ผ่าน

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

  • บทความ

รับจํานวนเงินที่ใช้โดยบัญชีในเดือนที่ระบุ

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

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

หมายเหตุ

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

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

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
AccountId ตัวระบุของบัญชีที่ประกอบด้วยข้อมูลการใช้จ่ายที่จะได้รับ

บัญชีต้องใช้วิธีการชําระเงินของใบแจ้งหนี้ ซึ่งไม่มีการลงรายการบัญชีใบแจ้งหนี้ บัญชีบัตรเครดิตไม่ได้รับการสนับสนุน

ถ้าตัวระบุบัญชีเป็นของตัวรวม การดําเนินการจะรวมยอดคงเหลือของบัญชีทั้งหมดของลูกค้าทั้งหมดที่ตัวรวมจัดการ หากตัวรวมมีลูกค้าสิบรายและลูกค้าแต่ละรายมีบัญชีสิบบัญชี การดําเนินการจะส่งกลับผลรวมของค่าใช้จ่ายรายเดือนของบัญชีทั้งหมด 100 บัญชี หากต้องการรับค่าใช้จ่ายรายเดือนของบัญชีเดียวของลูกค้าที่ตัวรวมจัดการ ให้ตั้งค่าองค์ประกอบ AccountId เป็นตัวระบุบัญชีที่ระบุ หากต้องการรับค่าใช้จ่ายรายเดือนของบัญชีทั้งหมดของลูกค้าที่ตัวรวมจัดการ ให้เรียกใช้การดําเนินการนี้สําหรับแต่ละบัญชี แล้วรวมยอดค่าใช้จ่ายรายเดือน		 ยาว
MonthYear เดือนและปีที่คุณต้องการรับข้อมูลการใช้จ่ายรายเดือน (การดําเนินการจะละเว้นค่าวันและเวลา)

บริการใช้คอมโพเนนต์เดือนและปีที่สอดคล้องกับ วันที่เวลาที่ระบุ ตัวอย่างเช่น 2020-05-15T00:00:00 และ 2020-05 ถูกต้องและจะส่งกลับผลลัพธ์เดียวกัน

ถ้าคุณระบุเดือนปัจจุบัน การดําเนินการจะส่งกลับยอดการใช้จ่ายแบบรายเดือนจนถึงปัจจุบัน ตัวอย่างเช่น หากวันที่ปัจจุบันคือ 15 พฤษภาคม 2020 และคุณตั้งค่า MonthYear เป็นเดือนพฤษภาคม 2020 การดําเนินการจะส่งกลับจํานวนเงินค่าใช้จ่ายสําหรับวันที่ 1 พฤษภาคม ถึง 15 พฤษภาคม โดยรวมแล้ว

คุณไม่สามารถระบุเดือนและปีในอนาคตได้ ถ้าคุณระบุเดือนก่อนหน้าซึ่งไม่มีข้อมูลการโทรจะส่งกลับค่า 0 (ศูนย์)

ยอดการใช้จ่ายอาจครอบคลุมการสั่งการแทรกหลายรายการ (IOs) ถ้าเครดิตมากกว่าการใช้จ่ายจริง ยอดใช้จ่ายรายเดือนที่ส่งคืนจะเป็นค่าลบ		 Datetime

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

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
AuthenticationToken โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising

สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth		 สาย อักขระ
DeveloperToken โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API

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

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

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

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

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
ยอด จํานวนเงินที่บัญชีใช้จ่ายในรอบระยะเวลาที่ระบุ

บัญชีผู้ใช้ต้องเป็น Yahoo!-managed

ถ้าบัญชีผู้ใช้ไม่ใช่ Yahoo!-managed ค่าที่ส่งกลับคือ 0		 คู่

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

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
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">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>

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>
    <GetAccountMonthlySpendResponse xmlns="https://bingads.microsoft.com/Billing/v13">
      <Amount>ValueHere</Amount>
    </GetAccountMonthlySpendResponse>
  </s:Body>
</s:Envelope>

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

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

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)

ข้อกําหนด

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