การดําเนินการบริการ GetEditorialReasonsByIds - การจัดการแคมเปญ

รับสาเหตุที่เอนทิตีที่ระบุล้มเหลวในการตรวจทานบรรณาธิการและว่าปัญหานั้นน่าสนใจหรือไม่

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

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

หมายเหตุ

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

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AccountId	ตัวระบุของบัญชีที่ประกอบด้วยเอนทิตีที่ระบุ	ยาว
EntityIdToParentIdAssociations	รายการของวัตถุ EntityIdToParentIdAssociation ที่แต่ละรายการประกอบด้วยตัวระบุระบบที่ไม่ซ้ํากันของเอนทิตี เช่น โฆษณาหรือคําสําคัญ และตัวระบุของเอนทิตีหลัก กลุ่มโฆษณาเป็นกลุ่มหลักของโฆษณาหรือคีย์เวิร์ด รายการต้องมีโฆษณาทั้งหมดหรือคีย์เวิร์ดทั้งหมดที่ไม่สามารถตรวจสอบบทบรรณาธิการได้ รายการจะรวมโฆษณาแบบผสมและคีย์เวิร์ดไม่ได้ รายการสามารถมีตัวระบุได้สูงสุด 1,000 ตัว	อาร์เรย์ EntityIdToParentIdAssociation
EntityType	ชนิดของเอนทิตีที่รายการเอนทิตีประกอบด้วย ค่าประเภทเอนทิตีที่สนับสนุนคือ Ad และ Keyword	EntityType

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

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

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

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

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
EditorialReasons	อาร์เรย์ของวัตถุ EditorialReasonCollection ที่สอดคล้องกับวัตถุ EntityIdToParentIdAssociation ที่คุณระบุในคําขอโดยตรง แต่ละวัตถุระบุเหตุผลสําหรับความล้มเหลวและระบุว่าสามารถอุทธรณ์ได้หรือไม่ ข้อมูลในรายการอาจถูกส่งกลับเป็น Null สําหรับแต่ละดัชนีรายการที่ไม่ได้เรียก EditorialReasonCollection องค์ประกอบที่สอดคล้องกันจะเป็น Null ถ้าเอนทิตีไม่ผ่านการตรวจสอบโดยบรรณาธิการ รายการที่สอดคล้องกันในคอลเลกชันนี้เป็น NULL นอกจากนี้ รายการจะเป็น NULL หากตัวระบุโฆษณาหรือคีย์เวิร์ดที่ระบุไม่ถูกต้อง	อาร์เรย์ EditorialReasonCollection
ตัวแก้ไขบางส่วน	อาร์เรย์ของออบเจ็กต์ 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/CampaignManagement/v13">
    <Action mustUnderstand="1">GetEditorialReasonsByIds</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>
    <GetEditorialReasonsByIdsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <AccountId>ValueHere</AccountId>
      <EntityIdToParentIdAssociations i:nil="false">
        <EntityIdToParentIdAssociation>
          <EntityId>ValueHere</EntityId>
          <ParentId>ValueHere</ParentId>
        </EntityIdToParentIdAssociation>
      </EntityIdToParentIdAssociations>
      <EntityType>ValueHere</EntityType>
    </GetEditorialReasonsByIdsRequest>
  </s:Body>
</s:Envelope>

Response SOAP

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

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <GetEditorialReasonsByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <EditorialReasons d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <EditorialReasonCollection>
          <AdGroupId>ValueHere</AdGroupId>
          <AdOrKeywordId>ValueHere</AdOrKeywordId>
          <AppealStatus>ValueHere</AppealStatus>
          <Reasons d4p1:nil="false">
            <EditorialReason>
              <Location d4p1:nil="false">ValueHere</Location>
              <PublisherCountries d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <a1:string>ValueHere</a1:string>
              </PublisherCountries>
              <ReasonCode>ValueHere</ReasonCode>
              <Term d4p1:nil="false">ValueHere</Term>
            </EditorialReason>
          </Reasons>
        </EditorialReasonCollection>
      </EditorialReasons>
      <PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <BatchError d4p1:type="-- derived type specified here with the appropriate prefix --">
          <Code>ValueHere</Code>
          <Details d4p1:nil="false">ValueHere</Details>
          <ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
          <FieldPath d4p1:nil="false">ValueHere</FieldPath>
          <ForwardCompatibilityMap xmlns:e143="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e143:KeyValuePairOfstringstring>
              <e143:key d4p1:nil="false">ValueHere</e143:key>
              <e143:value d4p1:nil="false">ValueHere</e143:value>
            </e143:KeyValuePairOfstringstring>
          </ForwardCompatibilityMap>
          <Index>ValueHere</Index>
          <Message d4p1:nil="false">ValueHere</Message>
          <Type d4p1:nil="false">ValueHere</Type>
          <!--These fields are applicable if the derived type attribute is set to EditorialError-->
          <Appealable d4p1:nil="false">ValueHere</Appealable>
          <DisapprovedText d4p1:nil="false">ValueHere</DisapprovedText>
          <Location d4p1:nil="false">ValueHere</Location>
          <PublisherCountry d4p1:nil="false">ValueHere</PublisherCountry>
          <ReasonCode>ValueHere</ReasonCode>
        </BatchError>
      </PartialErrors>
    </GetEditorialReasonsByIdsResponse>
  </s:Body>
</s:Envelope>

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

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

public async Task<GetEditorialReasonsByIdsResponse> GetEditorialReasonsByIdsAsync(
	long accountId,
	IList<EntityIdToParentIdAssociation> entityIdToParentIdAssociations,
	EntityType entityType)
{
	var request = new GetEditorialReasonsByIdsRequest
	{
		AccountId = accountId,
		EntityIdToParentIdAssociations = entityIdToParentIdAssociations,
		EntityType = entityType
	};

	return (await CampaignManagementService.CallAsync((s, r) => s.GetEditorialReasonsByIdsAsync(r), request));
}

static GetEditorialReasonsByIdsResponse getEditorialReasonsByIds(
	java.lang.Long accountId,
	ArrayOfEntityIdToParentIdAssociation entityIdToParentIdAssociations,
	EntityType entityType) throws RemoteException, Exception
{
	GetEditorialReasonsByIdsRequest request = new GetEditorialReasonsByIdsRequest();

	request.setAccountId(accountId);
	request.setEntityIdToParentIdAssociations(entityIdToParentIdAssociations);
	request.setEntityType(entityType);

	return CampaignManagementService.getService().getEditorialReasonsByIds(request);
}

static function GetEditorialReasonsByIds(
	$accountId,
	$entityIdToParentIdAssociations,
	$entityType)
{

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

	$request = new GetEditorialReasonsByIdsRequest();

	$request->AccountId = $accountId;
	$request->EntityIdToParentIdAssociations = $entityIdToParentIdAssociations;
	$request->EntityType = $entityType;

	return $GLOBALS['CampaignManagementProxy']->GetService()->GetEditorialReasonsByIds($request);
}

response=campaignmanagement_service.GetEditorialReasonsByIds(
	AccountId=AccountId,
	EntityIdToParentIdAssociations=EntityIdToParentIdAssociations,
	EntityType=EntityType)

ข้อกําหนด

บริการ: การส่งเสริมการขายการจัดการบริการ.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13