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

รับคีย์เวิร์ดเชิงลบที่กําหนดให้กับแคมเปญหรือกลุ่มโฆษณาโดยตรง

การดําเนินการนี้จะไม่ส่งกลับคําสําคัญเชิงลบของรายการคําสําคัญเชิงลบที่แชร์ ดู GetListItemsBySharedList สําหรับข้อมูลเพิ่มเติม

เคล็ดลับ

สําหรับภาพรวม โปรดดูคู่มือทางเทคนิคเกี่ยวกับคําหลักเชิงลบ

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

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

หมายเหตุ

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

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

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

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

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

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

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

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
EntityNegativeKeywords	อาร์เรย์ของวัตถุ EntityNegativeKeyword ที่สอดคล้องกับตัวระบุเอนทิตีที่คุณระบุในคําขอโดยตรง ข้อมูลในรายการอาจถูกส่งกลับเป็น Null สําหรับแต่ละดัชนีรายการที่ไม่มีการเรียกคําสําคัญเชิงลบสําหรับเอนทิตี องค์ประกอบที่สอดคล้องกันจะเป็น Null	อาร์เรย์ EntityNegativeKeyword
ตัวแก้ไขบางส่วน	อาร์เรย์ของออบเจ็กต์ 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">GetNegativeKeywordsByEntityIds</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>
    <GetNegativeKeywordsByEntityIdsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <EntityIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </EntityIds>
      <EntityType i:nil="false">ValueHere</EntityType>
      <ParentEntityId i:nil="false">ValueHere</ParentEntityId>
    </GetNegativeKeywordsByEntityIdsRequest>
  </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>
    <GetNegativeKeywordsByEntityIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <EntityNegativeKeywords d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <EntityNegativeKeyword>
          <EntityId>ValueHere</EntityId>
          <EntityType d4p1:nil="false">ValueHere</EntityType>
          <NegativeKeywords d4p1:nil="false">
            <NegativeKeyword>
              <Id d4p1:nil="false">ValueHere</Id>
              <MatchType d4p1:nil="false">ValueHere</MatchType>
              <Text d4p1:nil="false">ValueHere</Text>
            </NegativeKeyword>
          </NegativeKeywords>
        </EntityNegativeKeyword>
      </EntityNegativeKeywords>
      <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:e161="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e161:KeyValuePairOfstringstring>
              <e161:key d4p1:nil="false">ValueHere</e161:key>
              <e161:value d4p1:nil="false">ValueHere</e161:value>
            </e161: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>
    </GetNegativeKeywordsByEntityIdsResponse>
  </s:Body>
</s:Envelope>

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

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

public async Task<GetNegativeKeywordsByEntityIdsResponse> GetNegativeKeywordsByEntityIdsAsync(
	IList<long> entityIds,
	string entityType,
	long? parentEntityId)
{
	var request = new GetNegativeKeywordsByEntityIdsRequest
	{
		EntityIds = entityIds,
		EntityType = entityType,
		ParentEntityId = parentEntityId
	};

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

static GetNegativeKeywordsByEntityIdsResponse getNegativeKeywordsByEntityIds(
	ArrayOflong entityIds,
	java.lang.String entityType,
	java.lang.Long parentEntityId) throws RemoteException, Exception
{
	GetNegativeKeywordsByEntityIdsRequest request = new GetNegativeKeywordsByEntityIdsRequest();

	request.setEntityIds(entityIds);
	request.setEntityType(entityType);
	request.setParentEntityId(parentEntityId);

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

static function GetNegativeKeywordsByEntityIds(
	$entityIds,
	$entityType,
	$parentEntityId)
{

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

	$request = new GetNegativeKeywordsByEntityIdsRequest();

	$request->EntityIds = $entityIds;
	$request->EntityType = $entityType;
	$request->ParentEntityId = $parentEntityId;

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

response=campaignmanagement_service.GetNegativeKeywordsByEntityIds(
	EntityIds=EntityIds,
	EntityType=EntityType,
	ParentEntityId=ParentEntityId)

ข้อกําหนด

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