การดําเนินการ SearchCustomers Service - การจัดการลูกค้า
ค้นหาลูกค้าที่ตรงกับเกณฑ์คําขอ
ร้องขอองค์ประกอบ
วัตถุ SearchCustomersRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
DateRange | กําหนดช่วงวันที่สร้างลูกค้าต่ําสุดและสูงสุด องค์ประกอบการร้องขอนี้เป็นทางเลือก |
DateRange |
สั่ง ซื้อ | กําหนดลําดับของผลลัพธ์ตามคุณสมบัติที่ระบุของลูกค้า องค์ประกอบการร้องขอนี้เป็นทางเลือก คุณสามารถระบุองค์ประกอบ OrderBy ได้สูงสุดหนึ่งองค์ประกอบในอาร์เรย์ องค์ประกอบเพิ่มเติมไม่ได้รับการสนับสนุนและจะถูกละเว้นโดยบริการ สําหรับการดําเนินการบริการนี้ ค่าต่อไปนี้ได้รับการสนับสนุนในองค์ประกอบ Field ของวัตถุ OrderBy : Id - ลําดับจะถูกกําหนดโดยองค์ประกอบ ID ของลูกค้าที่ส่งกลับ ชื่อ - ลําดับจะถูกกําหนดโดยองค์ประกอบ ชื่อ ของลูกค้าที่ส่งกลับ Number - ลําดับถูกกําหนดโดยองค์ประกอบตัวเลขของลูกค้าที่ส่งกลับ |
อาร์เรย์ OrderBy |
PageInfo | กําหนดดัชนีและขนาดของผลลัพธ์ต่อหน้า | เพ จจิ้ง |
เพรดิเคต | กําหนดเงื่อนไขที่ทั้งหมดต้องเป็นไปตามเพื่อส่งคืนลูกค้า คุณต้องรวมเพรดิเคตระหว่างหนึ่งและ 10 เพรดิเคต เมื่อต้องการกรองตามช่วงวันที่ที่สร้างขึ้น คุณสามารถมีเพรดิเคตสองรายการที่มีค่า เขตข้อมูล ที่ตั้งค่าเป็น CreatedDate และอาจใช้แต่ละเขตข้อมูลเพรดิเคตได้เพียงครั้งเดียวเท่านั้น สําหรับรายละเอียดเกี่ยวกับค่าเขตข้อมูลเพรดิเคตที่รองรับแต่ละค่า โปรดดู หมายเหตุเพรดิเคต |
เพรดิเคต อาร์เรย์ |
องค์ประกอบส่วนหัวของคําขอ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
สาย อักขระ |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
สาย อักขระ |
รหัส ผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
ชื่อ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
องค์ประกอบการตอบสนอง
วัตถุ SearchCustomersResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
ลูกค้า | รายการของลูกค้าที่ตรงตามเกณฑ์คําขอ | อาร์เรย์ของลูกค้า |
องค์ประกอบส่วนหัวการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
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/Customer/v13">
<Action mustUnderstand="1">SearchCustomers</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<SearchCustomersRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<Predicates xmlns:e255="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e255:Predicate>
<e255:Field i:nil="false">ValueHere</e255:Field>
<e255:Operator>ValueHere</e255:Operator>
<e255:Value i:nil="false">ValueHere</e255:Value>
</e255:Predicate>
</Predicates>
<DateRange xmlns:e256="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e256:MinDate i:nil="false">ValueHere</e256:MinDate>
<e256:MaxDate i:nil="false">ValueHere</e256:MaxDate>
</DateRange>
<Ordering xmlns:e257="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e257:OrderBy>
<e257:Field>ValueHere</e257:Field>
<e257:Order>ValueHere</e257:Order>
</e257:OrderBy>
</Ordering>
<PageInfo xmlns:e258="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e258:Index>ValueHere</e258:Index>
<e258:Size>ValueHere</e258:Size>
</PageInfo>
</SearchCustomersRequest>
</s:Body>
</s:Envelope>
Response SOAP
เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงลําดับขององค์ประกอบ เนื้อ ความและ ส่วนหัว สําหรับการตอบสนอง SOAP
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
<TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
</s:Header>
<s:Body>
<SearchCustomersResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<Customers xmlns:e259="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e259:Customer>
<e259:CustomerFinancialStatus d4p1:nil="false">ValueHere</e259:CustomerFinancialStatus>
<e259:Id d4p1:nil="false">ValueHere</e259:Id>
<e259:Industry d4p1:nil="false">ValueHere</e259:Industry>
<e259:LastModifiedByUserId d4p1:nil="false">ValueHere</e259:LastModifiedByUserId>
<e259:LastModifiedTime d4p1:nil="false">ValueHere</e259:LastModifiedTime>
<e259:MarketCountry d4p1:nil="false">ValueHere</e259:MarketCountry>
<e259:ForwardCompatibilityMap xmlns:e260="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e260:KeyValuePairOfstringstring>
<e260:key d4p1:nil="false">ValueHere</e260:key>
<e260:value d4p1:nil="false">ValueHere</e260:value>
</e260:KeyValuePairOfstringstring>
</e259:ForwardCompatibilityMap>
<e259:MarketLanguage d4p1:nil="false">ValueHere</e259:MarketLanguage>
<e259:Name d4p1:nil="false">ValueHere</e259:Name>
<e259:ServiceLevel d4p1:nil="false">ValueHere</e259:ServiceLevel>
<e259:CustomerLifeCycleStatus d4p1:nil="false">ValueHere</e259:CustomerLifeCycleStatus>
<e259:TimeStamp d4p1:nil="false">ValueHere</e259:TimeStamp>
<e259:Number d4p1:nil="false">ValueHere</e259:Number>
<e259:CustomerAddress d4p1:nil="false">
<e259:City d4p1:nil="false">ValueHere</e259:City>
<e259:CountryCode d4p1:nil="false">ValueHere</e259:CountryCode>
<e259:Id d4p1:nil="false">ValueHere</e259:Id>
<e259:Line1 d4p1:nil="false">ValueHere</e259:Line1>
<e259:Line2 d4p1:nil="false">ValueHere</e259:Line2>
<e259:Line3 d4p1:nil="false">ValueHere</e259:Line3>
<e259:Line4 d4p1:nil="false">ValueHere</e259:Line4>
<e259:PostalCode d4p1:nil="false">ValueHere</e259:PostalCode>
<e259:StateOrProvince d4p1:nil="false">ValueHere</e259:StateOrProvince>
<e259:TimeStamp d4p1:nil="false">ValueHere</e259:TimeStamp>
<e259:BusinessName d4p1:nil="false">ValueHere</e259:BusinessName>
</e259:CustomerAddress>
</e259:Customer>
</Customers>
</SearchCustomersResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<SearchCustomersResponse> SearchCustomersAsync(
IList<Predicate> predicates,
DateRange dateRange,
IList<OrderBy> ordering,
Paging pageInfo)
{
var request = new SearchCustomersRequest
{
Predicates = predicates,
DateRange = dateRange,
Ordering = ordering,
PageInfo = pageInfo
};
return (await CustomerManagementService.CallAsync((s, r) => s.SearchCustomersAsync(r), request));
}
static SearchCustomersResponse searchCustomers(
ArrayOfPredicate predicates,
DateRange dateRange,
ArrayOfOrderBy ordering,
Paging pageInfo) throws RemoteException, Exception
{
SearchCustomersRequest request = new SearchCustomersRequest();
request.setPredicates(predicates);
request.setDateRange(dateRange);
request.setOrdering(ordering);
request.setPageInfo(pageInfo);
return CustomerManagementService.getService().searchCustomers(request);
}
static function SearchCustomers(
$predicates,
$dateRange,
$ordering,
$pageInfo)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new SearchCustomersRequest();
$request->Predicates = $predicates;
$request->DateRange = $dateRange;
$request->Ordering = $ordering;
$request->PageInfo = $pageInfo;
return $GLOBALS['CustomerManagementProxy']->GetService()->SearchCustomers($request);
}
response=customermanagement_service.SearchCustomers(
Predicates=Predicates,
DateRange=DateRange,
Ordering=Ordering,
PageInfo=PageInfo)
ข้อกําหนด
บริการ: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13
คำติชม
https://aka.ms/ContentUserFeedback
เร็วๆ นี้: ตลอดปี 2024 เราจะขจัดปัญหา GitHub เพื่อเป็นกลไกคำติชมสำหรับเนื้อหา และแทนที่ด้วยระบบคำติชมใหม่ สำหรับข้อมูลเพิ่มเติม ให้ดู:ส่งและดูข้อคิดเห็นสำหรับ