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

รับความสัมพันธ์ของป้ายชื่อตามตัวระบุเอนทิตี

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

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

หมายเหตุ

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

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

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

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

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

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

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

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

ธาตุ	คำอธิบาย	ชนิดข้อมูล
LabelAssociations	อาร์เรย์ของความสัมพันธ์ของป้ายชื่อ สําหรับแต่ละตัวระบุเอนทิตีที่ระบุในคําขอ จะส่งกลับออบเจ็กต์ LabelAssociation เป็นศูนย์หรือมากกว่า ในขณะที่ลําดับของออบเจ็กต์ LabelAssociation ที่ส่งกลับนั้นรับประกันตามลําดับของตัวระบุเอนทิตีที่ร้องขอ โปรดทราบว่าสามารถส่งคืนออบเจ็กต์ LabelAssociation หลายรายการสําหรับตัวระบุเอนทิตีเดียวกันได้	อาร์เรย์ LabelAssociation
ตัวแก้ไขบางส่วน	อาร์เรย์ของวัตถุ BatchError ที่มีรายละเอียดสําหรับความสัมพันธ์ที่ไม่สามารถเรียกข้อมูลได้สําเร็จ รายการของข้อผิดพลาดจะสอดคล้องกับรายการความสัมพันธ์ในคําขอโดยตรง ข้อมูลในรายการอาจถูกส่งกลับเป็น Null สําหรับแต่ละดัชนีรายการที่มีการเรียกใช้ความสัมพันธ์สําเร็จแล้ว องค์ประกอบข้อผิดพลาดที่สอดคล้องกันจะเป็น Null ตามอุดมคติแล้วความสัมพันธ์ทั้งหมดจะถูกเรียกใช้ได้สําเร็จและองค์ประกอบทั้งหมดในรายการนี้เป็น Null	อาร์เรย์ 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">GetLabelAssociationsByEntityIds</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>
    <GetLabelAssociationsByEntityIdsRequest 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>ValueHere</EntityType>
    </GetLabelAssociationsByEntityIdsRequest>
  </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>
    <GetLabelAssociationsByEntityIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <LabelAssociations d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <LabelAssociation>
          <EntityId>ValueHere</EntityId>
          <LabelId>ValueHere</LabelId>
        </LabelAssociation>
      </LabelAssociations>
      <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:e475="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e475:KeyValuePairOfstringstring>
              <e475:key d4p1:nil="false">ValueHere</e475:key>
              <e475:value d4p1:nil="false">ValueHere</e475:value>
            </e475: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>
    </GetLabelAssociationsByEntityIdsResponse>
  </s:Body>
</s:Envelope>

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

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

public async Task<GetLabelAssociationsByEntityIdsResponse> GetLabelAssociationsByEntityIdsAsync(
	IList<long> entityIds,
	EntityType entityType)
{
	var request = new GetLabelAssociationsByEntityIdsRequest
	{
		EntityIds = entityIds,
		EntityType = entityType
	};

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

static GetLabelAssociationsByEntityIdsResponse getLabelAssociationsByEntityIds(
	ArrayOflong entityIds,
	EntityType entityType) throws RemoteException, Exception
{
	GetLabelAssociationsByEntityIdsRequest request = new GetLabelAssociationsByEntityIdsRequest();

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

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

static function GetLabelAssociationsByEntityIds(
	$entityIds,
	$entityType)
{

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

	$request = new GetLabelAssociationsByEntityIdsRequest();

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

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

response=campaignmanagement_service.GetLabelAssociationsByEntityIds(
	EntityIds=EntityIds,
	EntityType=EntityType)

ข้อกําหนด

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

URL การร้องขอ

URL การผลิต

https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/LabelAssociations/QueryByEntityIds

Sandbox URL

https://campaign.api.sandbox.bingads.microsoft.com/CampaignManagement/v13/LabelAssociations/QueryByEntityIds

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

วัตถุ GetLabelAssociationsByEntityIdsRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ

หมายเหตุ

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

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

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

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

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

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

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

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

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

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

ธาตุ	คำอธิบาย	ชนิดข้อมูล
TrackingId	ตัวระบุของรายการบันทึกที่ประกอบด้วยรายละเอียดของการเรียกใช้ API	เชือก

ร้องขอ JSON

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

{
  "EntityIds": [
    "LongValueHere"
  ],
  "EntityType": "ValueHere"
}

การตอบสนอง JSON

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

ด้านล่างนี้คือตัวอย่างที่สามารถใช้ได้หากชนิดของ BatchError คือ EditorialError

{
  "LabelAssociations": [
    {
      "EntityId": "LongValueHere",
      "LabelId": "LongValueHere"
    }
  ],
  "PartialErrors": [
    {
      "Code": IntValueHere,
      "Details": "ValueHere",
      "ErrorCode": "ValueHere",
      "FieldPath": "ValueHere",
      "ForwardCompatibilityMap": [
        {
          "key": "ValueHere",
          "value": "ValueHere"
        }
      ],
      "Index": IntValueHere,
      "Message": "ValueHere",
      "Type": "EditorialError",
      "Appealable": "ValueHere",
      "DisapprovedText": "ValueHere",
      "Location": "ValueHere",
      "PublisherCountry": "ValueHere",
      "ReasonCode": IntValueHere
    }
  ]
}

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

หากต้องการเรียกใช้ REST API ผ่าน SDK คุณจําเป็นต้องอัปเกรด SDK เป็นเวอร์ชันเฉพาะและกําหนดค่าพารามิเตอร์ระบบ ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม

public async Task<GetLabelAssociationsByEntityIdsResponse> GetLabelAssociationsByEntityIdsAsync(
	IList<long> entityIds,
	EntityType entityType)
{
	var request = new GetLabelAssociationsByEntityIdsRequest
	{
		EntityIds = entityIds,
		EntityType = entityType
	};

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

static GetLabelAssociationsByEntityIdsResponse getLabelAssociationsByEntityIds(
	ArrayOflong entityIds,
	EntityType entityType) throws RemoteException, Exception
{
	GetLabelAssociationsByEntityIdsRequest request = new GetLabelAssociationsByEntityIdsRequest();

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

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

static function GetLabelAssociationsByEntityIds(
	$entityIds,
	$entityType)
{

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

	$request = new GetLabelAssociationsByEntityIdsRequest();

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

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

response=campaignmanagement_service.GetLabelAssociationsByEntityIds(
	EntityIds=EntityIds,
	EntityType=EntityType)