การดําเนินงานบริการอุทธรณ์ Rejections - การจัดการแคมเปญ
โฆษณาอุทธรณ์หรือคีย์เวิร์ดที่ไม่สามารถตรวจสอบบรรณาธิการได้
ร้องขอองค์ประกอบ
วัตถุ AppealEditorialRejectionsRequest จะกําหนดองค์ประกอบ เนื้อ ความและ ส่วนหัว ของคําขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
EntityIdToParentIdAssociations | รายการตัวระบุที่ไม่ซ้ํากันของโฆษณาหรือคีย์เวิร์ดที่ไม่สามารถตรวจสอบบรรณาธิการได้ รายการสามารถมีวัตถุ EntityIdToParentIdAssociation ได้สูงสุด 1,000 วัตถุ คุณส่งโฆษณาหรือตัวระบุคําหลักแต่ละรายการพร้อมกับตัวระบุหลักของกลุ่มโฆษณาที่เกี่ยวข้องในออบเจ็กต์ EntityIdToParentIdAssociation รายการของ EntityIdToParentIdAssociation ต้องมีตัวระบุโฆษณาหรือตัวระบุคําหลัก รายการไม่สามารถมีตัวระบุเอนทิตีโฆษณาแบบผสมและคีย์เวิร์ดได้ ถ้าเอนทิตีในรายการได้รับการอนุมัติแล้ว เอนทิตีจะถูกละเว้น ถ้าเอนทิตีในรายการไม่สามารถอุทธรณ์ได้ การโทรจะล้มเหลว หากเอนทิตีในรายการมีคําขออุทธรณ์ที่ค้างอยู่ คําขอนี้จะแทนที่คําขอที่รอดําเนินการ หมาย เหตุ: เพื่อสนับสนุน AssetGroups, EntityId = AssetGroupId และ ParentId = CampaignId สําหรับการอุทธรณ์ของกลุ่มสินทรัพย์ เราจํากัดจํานวนออบเจ็กต์ไว้ที่ 100 แทนที่จะเป็น 1,000 |
อาร์เรย์ EntityIdToParentIdAssociation |
EntityType | ชนิดของเอนทิตีที่เอนทิตีมีในรายการแม่ ค่าประเภทเอนทิตีที่สนับสนุนคือ Ad และ Keyword |
EntityType |
เต็มแนวข้อความ | เหตุผลสําหรับการอุทธรณ์ สตริงสามารถมีอักขระได้สูงสุด 1,000 อักขระ เหตุผลนําไปใช้กับเอนทิตีที่ระบุทั้งหมด เหตุผลที่มีประโยชน์ควรรวมถึงเหตุผลที่โฆษณาหรือคําหลักเป็นไปตามนโยบายบรรณาธิการตัวอย่างเช่น JustificationText = "โฆษณาของฉันสําหรับปืนทาสีไม่ใช่อาวุธ พวกเขาเป็นเครื่องมือวาดภาพ" |
สาย อักขระ |
องค์ประกอบส่วนหัวของคําขอ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
สาย อักขระ |
CustomerAccountId | ตัวระบุบัญชีโฆษณาที่เป็นเจ้าของหรือเชื่อมโยงกับเอนทิตีในคําขอ องค์ประกอบส่วนหัวนี้ต้องมีค่าเดียวกันกับองค์ประกอบเนื้อความ AccountId เมื่อต้องการทั้งสองอย่าง องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ |
สาย อักขระ |
CustomerId | ตัวระบุบัญชีผู้จัดการ (ลูกค้า) ที่ผู้ใช้กําลังเข้าถึงหรือดําเนินการ ผู้ใช้สามารถเข้าถึงบัญชีผู้จัดการได้หลายบัญชี องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ |
สาย อักขระ |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
สาย อักขระ |
รหัส ผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
ชื่อ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
องค์ประกอบการตอบสนอง
วัตถุ AppealEditorialRejectionsResponse จะกําหนดองค์ประกอบ เนื้อ ความและ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
ตัวแก้ไขบางส่วน | อาร์เรย์ของออบเจ็กต์ BatchError ที่มีรายละเอียดสําหรับการอุทธรณ์ใด ๆ ที่ส่งไม่สําเร็จ รายการของข้อผิดพลาดจะสอดคล้องกับรายการของ EntityIdToParentIdAssociation ในคําขอโดยตรง ข้อมูลในรายการอาจถูกส่งกลับเป็น 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">AppealEditorialRejections</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>
<AppealEditorialRejectionsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<EntityIdToParentIdAssociations i:nil="false">
<EntityIdToParentIdAssociation>
<EntityId>ValueHere</EntityId>
<ParentId>ValueHere</ParentId>
</EntityIdToParentIdAssociation>
</EntityIdToParentIdAssociations>
<EntityType>ValueHere</EntityType>
<JustificationText i:nil="false">ValueHere</JustificationText>
</AppealEditorialRejectionsRequest>
</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>
<AppealEditorialRejectionsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<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:e62="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e62:KeyValuePairOfstringstring>
<e62:key d4p1:nil="false">ValueHere</e62:key>
<e62:value d4p1:nil="false">ValueHere</e62:value>
</e62: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>
</AppealEditorialRejectionsResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<AppealEditorialRejectionsResponse> AppealEditorialRejectionsAsync(
IList<EntityIdToParentIdAssociation> entityIdToParentIdAssociations,
EntityType entityType,
string justificationText)
{
var request = new AppealEditorialRejectionsRequest
{
EntityIdToParentIdAssociations = entityIdToParentIdAssociations,
EntityType = entityType,
JustificationText = justificationText
};
return (await CampaignManagementService.CallAsync((s, r) => s.AppealEditorialRejectionsAsync(r), request));
}
static AppealEditorialRejectionsResponse appealEditorialRejections(
ArrayOfEntityIdToParentIdAssociation entityIdToParentIdAssociations,
EntityType entityType,
java.lang.String justificationText) throws RemoteException, Exception
{
AppealEditorialRejectionsRequest request = new AppealEditorialRejectionsRequest();
request.setEntityIdToParentIdAssociations(entityIdToParentIdAssociations);
request.setEntityType(entityType);
request.setJustificationText(justificationText);
return CampaignManagementService.getService().appealEditorialRejections(request);
}
static function AppealEditorialRejections(
$entityIdToParentIdAssociations,
$entityType,
$justificationText)
{
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
$request = new AppealEditorialRejectionsRequest();
$request->EntityIdToParentIdAssociations = $entityIdToParentIdAssociations;
$request->EntityType = $entityType;
$request->JustificationText = $justificationText;
return $GLOBALS['CampaignManagementProxy']->GetService()->AppealEditorialRejections($request);
}
response=campaignmanagement_service.AppealEditorialRejections(
EntityIdToParentIdAssociations=EntityIdToParentIdAssociations,
EntityType=EntityType,
JustificationText=JustificationText)
ข้อกําหนด
บริการ: การส่งเสริมการขายการจัดการบริการ.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13