การดําเนินการ DeleteAccount Service - การจัดการลูกค้า

ลบบัญชี

หมายเหตุ

เฉพาะผู้ใช้ที่มีข้อมูลประจําตัว super Admin เท่านั้นที่สามารถลบบัญชีได้ สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือทางเทคนิคเกี่ยวกับบทบาทผู้ใช้

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

หลังจากลบบัญชีแล้ว จะสามารถค้นหาและแสดงเป็น ไม่ได้ใช้งาน ในเว็บแอปพลิเคชัน Microsoft Advertising คุณอาจหรืออาจไม่เลือกที่จะแสดงบัญชีที่ไม่ได้ใช้งานในแอปพลิเคชันของคุณ

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

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

หมายเหตุ

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

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AccountId	ตัวระบุของบัญชีที่จะลบ	ยาว
ประทับเวลา	ค่าประทับเวลาที่การดําเนินการใช้เพื่อทําให้การปรับปรุงสอดคล้องกัน คุณต้องเรียก GetAccount เพื่อรับค่าประทับเวลา การดําเนินการลบล้มเหลวถ้าวัตถุบัญชีผู้ใช้มีค่าประทับเวลาที่แตกต่างจากค่าที่คุณส่งไป	base64Binary

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

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

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

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

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

ไม่มีองค์ประกอบใด ๆ ในเนื้อความการตอบสนองของการดําเนินการ

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
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/Customer/v13">
    <Action mustUnderstand="1">DeleteAccount</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <DeleteAccountRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <AccountId>ValueHere</AccountId>
      <TimeStamp i:nil="false">ValueHere</TimeStamp>
    </DeleteAccountRequest>
  </s:Body>
</s:Envelope>

Response SOAP

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

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <DeleteAccountResponse xmlns="https://bingads.microsoft.com/Customer/v13" />
  </s:Body>
</s:Envelope>

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

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

public async Task<DeleteAccountResponse> DeleteAccountAsync(
	long accountId,
	base64Binary timeStamp)
{
	var request = new DeleteAccountRequest
	{
		AccountId = accountId,
		TimeStamp = timeStamp
	};

	return (await CustomerManagementService.CallAsync((s, r) => s.DeleteAccountAsync(r), request));
}

static DeleteAccountResponse deleteAccount(
	java.lang.Long accountId,
	byte[] timeStamp) throws RemoteException, Exception
{
	DeleteAccountRequest request = new DeleteAccountRequest();

	request.setAccountId(accountId);
	request.setTimeStamp(timeStamp);

	return CustomerManagementService.getService().deleteAccount(request);
}

static function DeleteAccount(
	$accountId,
	$timeStamp)
{

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

	$request = new DeleteAccountRequest();

	$request->AccountId = $accountId;
	$request->TimeStamp = $timeStamp;

	return $GLOBALS['CustomerManagementProxy']->GetService()->DeleteAccount($request);
}

response=customermanagement_service.DeleteAccount(
	AccountId=AccountId,
	TimeStamp=TimeStamp)

ข้อกําหนด

บริการ: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13