แชร์ผ่าน

การดําเนินการบริการ SetAutoApplyOptInStatus - ข้อมูลเชิงลึกของโฆษณา

  • บทความ

ตั้งค่าสถานะการเลือกรับคําแนะนําการปรับใช้โดยอัตโนมัติสําหรับบัญชีเดียว

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

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

หมายเหตุ

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

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

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
AutoApplyOptInStatusInputs อาร์เรย์สตริงที่ระบุสถานะการเลือกใช้อัตโนมัติของชนิดคําแนะนําที่ระบุในคําขอ ไม่อนุญาตให้มีคีย์ป้อนเข้าที่ซ้ํากันในการโทรเดียวกัน
ฟิลด์นี้รวมถึงรายการของชนิดคําแนะนําที่มีสถานะการเลือกใช้อัตโนมัติที่จะระบุ
คีย์และคู่ค่าที่มีอยู่มีดังนี้ (ตรงตามตัวพิมพ์ใหญ่-เล็ก):
  • ResponsiveSearchAdsOpportunity = false
  • MultiMediaAdsOpportunity = true
  • RemoveConflictingNegativeKeywordOpportunity = false
  • FixConversionGoalSettings โอกาส = เท็จ
  • CreateConversionGoalOpportunity = false
ถ้าค่าของคีย์ถูกตั้งค่าเป็น จริง บัญชีจะเลือกใช้โดยอัตโนมัติสําหรับประเภทคําแนะนําที่เกี่ยวข้อง
คุณสามารถระบุองค์ประกอบป้อนเข้าได้สูงสุด 100 องค์ประกอบ		 อาร์เรย์สตริง

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

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

สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth		 สาย อักขระ
CustomerAccountId ตัวระบุบัญชีโฆษณาที่เป็นเจ้าของหรือเชื่อมโยงกับเอนทิตีในคําขอ องค์ประกอบส่วนหัวนี้ต้องมีค่าเดียวกันกับองค์ประกอบเนื้อความ AccountId เมื่อต้องการทั้งสองอย่าง องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ

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

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

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

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

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

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

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

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

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
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/AdInsight/v13">
    <Action mustUnderstand="1">SetAutoApplyOptInStatus</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <SetAutoApplyOptInStatusRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <AutoApplyOptInStatusInputs i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </AutoApplyOptInStatusInputs>
    </SetAutoApplyOptInStatusRequest>
  </s:Body>
</s:Envelope>

Response SOAP

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

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <SetAutoApplyOptInStatusResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <BatchError>
          <Code>ValueHere</Code>
          <Details d4p1:nil="false">ValueHere</Details>
          <ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
          <Index>ValueHere</Index>
          <Message d4p1:nil="false">ValueHere</Message>
        </BatchError>
      </PartialErrors>
    </SetAutoApplyOptInStatusResponse>
  </s:Body>
</s:Envelope>

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

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

public async Task<SetAutoApplyOptInStatusResponse> SetAutoApplyOptInStatusAsync(
	IList<string> autoApplyOptInStatusInputs)
{
	var request = new SetAutoApplyOptInStatusRequest
	{
		AutoApplyOptInStatusInputs = autoApplyOptInStatusInputs
	};

	return (await AdInsightService.CallAsync((s, r) => s.SetAutoApplyOptInStatusAsync(r), request));
}

static SetAutoApplyOptInStatusResponse setAutoApplyOptInStatus(
	ArrayOfstring autoApplyOptInStatusInputs) throws RemoteException, Exception
{
	SetAutoApplyOptInStatusRequest request = new SetAutoApplyOptInStatusRequest();

	request.setAutoApplyOptInStatusInputs(autoApplyOptInStatusInputs);

	return AdInsightService.getService().setAutoApplyOptInStatus(request);
}

static function SetAutoApplyOptInStatus(
	$autoApplyOptInStatusInputs)
{

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

	$request = new SetAutoApplyOptInStatusRequest();

	$request->AutoApplyOptInStatusInputs = $autoApplyOptInStatusInputs;

	return $GLOBALS['AdInsightProxy']->GetService()->SetAutoApplyOptInStatus($request);
}

response=adinsight_service.SetAutoApplyOptInStatus(
	AutoApplyOptInStatusInputs=AutoApplyOptInStatusInputs)

ข้อกําหนด

บริการ: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13