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

รับคําหลักเชิงลบของรายการคีย์เวิร์ดเชิงลบหรือเว็บไซต์ลบของรายการยกเว้นเว็บไซต์

การดําเนินการจะใช้สําหรับคําสําคัญเชิงลบและไซต์เชิงลบผ่านรายการที่แชร์เท่านั้น หากต้องการรับคีย์เวิร์ดเชิงลบที่กําหนดให้กับแคมเปญหรือกลุ่มโฆษณาโดยตรง โปรดดู GetNegativeKeywordsByEntityIds หากต้องการรับไซต์เชิงลบที่กําหนดให้กับแคมเปญหรือกลุ่มโฆษณาโดยตรง โปรดดู GetNegativeSitesByCampaignIds และ GetNegativeSitesByAdGroupIds

เคล็ดลับ

สําหรับภาพรวม โปรดดูคําแนะนําทางเทคนิคเกี่ยวกับคําสําคัญเชิงลบและไซต์เชิงลบ

สิ่งสำคัญ

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

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

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

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

หมายเหตุ

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

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
SharedEntityScope	ระบุว่าเอนทิตีที่แชร์จะพร้อมใช้งานที่ระดับบัญชีโฆษณา (บัญชี) หรือบัญชีผู้จัดการ (ลูกค้า) องค์ประกอบนี้เป็นตัวเลือกและค่าเริ่มต้นเป็นขอบเขตบัญชี ขอบเขตบัญชีโฆษณาใช้ได้กับรายการคีย์เวิร์ดเชิงลบเท่านั้น ตั้งค่าองค์ประกอบนี้เป็น ลูกค้า เพื่อรับไซต์เชิงลบสําหรับรายการการยกเว้นเว็บไซต์ในไลบรารีที่แชร์ของบัญชีผู้จัดการ (ลูกค้า) ของคุณ	ขอบเขตเอนทิตี
SharedList	รายการคีย์เวิร์ดเชิงลบหรือรายการการยกเว้นเว็บไซต์ ถ้า SharedEntityScope เป็นค่าว่างหรือตั้งค่าเป็น บัญชี และถ้า SharedList เป็น NegativeKeywordListรายการที่แสดงจะเป็นวัตถุคําสําคัญเชิงลบ (NegativeKeyword) ถ้า SharedEntityScope ถูกตั้งค่าเป็น ลูกค้า และถ้า SharedList เป็น PlacementExclusionListดังนั้นข้อมูลในรายการ ที่ส่งกลับจะเป็นวัตถุไซต์เชิงลบ (NegativeSite) คุณต้องรวม ID ของ SharedList เมื่อคุณทําการร้องขอบริการ	SharedList

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

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

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

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

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
ListItems	รายการของคําหลักเชิงลบหรือไซต์เชิงลบ ถ้าไม่มีหน่วยข้อมูลในรายการอยู่ในรายการที่แชร์ อาร์เรย์ที่ว่างเปล่าจะถูกส่งกลับ	อาร์เรย์ SharedListItem

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
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">GetListItemsBySharedList</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>
    <GetListItemsBySharedListRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <SharedList i:nil="false" i:type="-- derived type specified here with the appropriate prefix --">
        <ItemCount i:nil="false">ValueHere</ItemCount>
        <!--No additional fields are applicable if the derived type attribute is set to NegativeKeywordList-->
        <!--No additional fields are applicable if the derived type attribute is set to PlacementExclusionList-->
        <!--No additional fields are applicable if the derived type attribute is set to AccountNegativeKeywordList-->
        <!--No additional fields are applicable if the derived type attribute is set to BrandList-->
      </SharedList>
      <SharedEntityScope i:nil="false">ValueHere</SharedEntityScope>
    </GetListItemsBySharedListRequest>
  </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>
    <GetListItemsBySharedListResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <ListItems d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <SharedListItem d4p1:type="-- derived type specified here with the appropriate prefix --">
          <ForwardCompatibilityMap xmlns:e158="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e158:KeyValuePairOfstringstring>
              <e158:key d4p1:nil="false">ValueHere</e158:key>
              <e158:value d4p1:nil="false">ValueHere</e158:value>
            </e158:KeyValuePairOfstringstring>
          </ForwardCompatibilityMap>
          <Type d4p1:nil="false">ValueHere</Type>
          <!--These fields are applicable if the derived type attribute is set to NegativeKeyword-->
          <Id d4p1:nil="false">ValueHere</Id>
          <MatchType d4p1:nil="false">ValueHere</MatchType>
          <Text d4p1:nil="false">ValueHere</Text>
          <!--These fields are applicable if the derived type attribute is set to NegativeSite-->
          <Id d4p1:nil="false">ValueHere</Id>
          <Url d4p1:nil="false">ValueHere</Url>
          <!--This field is applicable if the derived type attribute is set to BrandItem-->
          <BrandId>ValueHere</BrandId>
        </SharedListItem>
      </ListItems>
    </GetListItemsBySharedListResponse>
  </s:Body>
</s:Envelope>

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

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

public async Task<GetListItemsBySharedListResponse> GetListItemsBySharedListAsync(
	SharedList sharedList,
	EntityScope? sharedEntityScope)
{
	var request = new GetListItemsBySharedListRequest
	{
		SharedList = sharedList,
		SharedEntityScope = sharedEntityScope
	};

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

static GetListItemsBySharedListResponse getListItemsBySharedList(
	SharedList sharedList,
	EntityScope sharedEntityScope) throws RemoteException, Exception
{
	GetListItemsBySharedListRequest request = new GetListItemsBySharedListRequest();

	request.setSharedList(sharedList);
	request.setSharedEntityScope(sharedEntityScope);

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

static function GetListItemsBySharedList(
	$sharedList,
	$sharedEntityScope)
{

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

	$request = new GetListItemsBySharedListRequest();

	$request->SharedList = $sharedList;
	$request->SharedEntityScope = $sharedEntityScope;

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

response=campaignmanagement_service.GetListItemsBySharedList(
	SharedList=SharedList,
	SharedEntityScope=SharedEntityScope)

ข้อกําหนด

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