การดําเนินการบริการ GetUser - การจัดการลูกค้า
รับรายละเอียดของผู้ใช้
เคล็ดลับ
โปรดดูคู่มือ Account Hierchy และ User Permissions สําหรับภาพรวมพร้อมตัวอย่าง
ร้องขอองค์ประกอบ
วัตถุ GetUserRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
องค์ประกอบส่วนหัวของคําขอ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
สาย อักขระ |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
สาย อักขระ |
รหัส ผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
ชื่อ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
องค์ประกอบการตอบสนอง
วัตถุ GetUserResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
CustomerRoles | รายการบทบาทที่ผู้ใช้มีสําหรับลูกค้าแต่ละรายหรือรายการบัญชี จะมีการแสดงหน่วยข้อมูลในรายการอย่างน้อยหนึ่งรายการ ถ้าข้อมูลประจําตัวของผู้ใช้สามารถเข้าถึงลูกค้าหลายราย ระบบจะส่งคืนออบเจ็กต์ CustomerRole หนึ่งออบเจ็กต์ต่อลูกค้าหนึ่งราย คุณสามารถดูบทบาทของคุณเองทั้งหมดสําหรับลูกค้าทั้งหมด อย่างไรก็ตาม คุณจะเห็นเฉพาะบทบาทของผู้ใช้รายอื่นเนื่องจากเกี่ยวข้องกับลูกค้าที่คุณสามารถเข้าถึงได้ ตัวอย่างเช่น สมมติว่า you@contoso.com และ another-user@contoso.com สามารถเข้าถึงลูกค้า A ได้ ผู้ใช้รายอื่นอาจมีสิทธิ์เข้าถึง Customer B และ C อย่างไรก็ตาม เมื่อคุณเรียกใช้การดําเนินการนี้ด้วยตัวระบุผู้ใช้ คุณจะเห็นเฉพาะบทบาทของพวกเขาภายใต้ลูกค้า A เมื่อ another-user@contoso.com เรียกใช้การดําเนินการนี้ด้วยข้อมูลประจําตัวของตนเอง การดําเนินการจะส่งกลับวัตถุ CustomerRole สามรายการ |
อาร์เรย์ CustomerRole |
ผู้ใช้ | วัตถุผู้ใช้ที่มีข้อมูลเกี่ยวกับผู้ใช้ | ผู้ใช้ |
องค์ประกอบส่วนหัวการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
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">GetUser</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<GetUserRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<UserId i:nil="false">ValueHere</UserId>
</GetUserRequest>
</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>
<GetUserResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<User xmlns:e227="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e227:ContactInfo d4p1:nil="false">
<e227:Address d4p1:nil="false">
<e227:City d4p1:nil="false">ValueHere</e227:City>
<e227:CountryCode d4p1:nil="false">ValueHere</e227:CountryCode>
<e227:Id d4p1:nil="false">ValueHere</e227:Id>
<e227:Line1 d4p1:nil="false">ValueHere</e227:Line1>
<e227:Line2 d4p1:nil="false">ValueHere</e227:Line2>
<e227:Line3 d4p1:nil="false">ValueHere</e227:Line3>
<e227:Line4 d4p1:nil="false">ValueHere</e227:Line4>
<e227:PostalCode d4p1:nil="false">ValueHere</e227:PostalCode>
<e227:StateOrProvince d4p1:nil="false">ValueHere</e227:StateOrProvince>
<e227:TimeStamp d4p1:nil="false">ValueHere</e227:TimeStamp>
<e227:BusinessName d4p1:nil="false">ValueHere</e227:BusinessName>
</e227:Address>
<e227:ContactByPhone d4p1:nil="false">ValueHere</e227:ContactByPhone>
<e227:ContactByPostalMail d4p1:nil="false">ValueHere</e227:ContactByPostalMail>
<e227:Email d4p1:nil="false">ValueHere</e227:Email>
<e227:EmailFormat d4p1:nil="false">ValueHere</e227:EmailFormat>
<e227:Fax d4p1:nil="false">ValueHere</e227:Fax>
<e227:HomePhone d4p1:nil="false">ValueHere</e227:HomePhone>
<e227:Id d4p1:nil="false">ValueHere</e227:Id>
<e227:Mobile d4p1:nil="false">ValueHere</e227:Mobile>
<e227:Phone1 d4p1:nil="false">ValueHere</e227:Phone1>
<e227:Phone2 d4p1:nil="false">ValueHere</e227:Phone2>
</e227:ContactInfo>
<e227:CustomerId d4p1:nil="false">ValueHere</e227:CustomerId>
<e227:Id d4p1:nil="false">ValueHere</e227:Id>
<e227:JobTitle d4p1:nil="false">ValueHere</e227:JobTitle>
<e227:LastModifiedByUserId d4p1:nil="false">ValueHere</e227:LastModifiedByUserId>
<e227:LastModifiedTime d4p1:nil="false">ValueHere</e227:LastModifiedTime>
<e227:Lcid d4p1:nil="false">ValueHere</e227:Lcid>
<e227:Name d4p1:nil="false">
<e227:FirstName d4p1:nil="false">ValueHere</e227:FirstName>
<e227:LastName d4p1:nil="false">ValueHere</e227:LastName>
<e227:MiddleInitial d4p1:nil="false">ValueHere</e227:MiddleInitial>
</e227:Name>
<e227:Password d4p1:nil="false">ValueHere</e227:Password>
<e227:SecretAnswer d4p1:nil="false">ValueHere</e227:SecretAnswer>
<e227:SecretQuestion>ValueHere</e227:SecretQuestion>
<e227:UserLifeCycleStatus d4p1:nil="false">ValueHere</e227:UserLifeCycleStatus>
<e227:TimeStamp d4p1:nil="false">ValueHere</e227:TimeStamp>
<e227:UserName d4p1:nil="false">ValueHere</e227:UserName>
<e227:ForwardCompatibilityMap xmlns:e228="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e228:KeyValuePairOfstringstring>
<e228:key d4p1:nil="false">ValueHere</e228:key>
<e228:value d4p1:nil="false">ValueHere</e228:value>
</e228:KeyValuePairOfstringstring>
</e227:ForwardCompatibilityMap>
<e227:AuthenticationToken d4p1:nil="false">ValueHere</e227:AuthenticationToken>
</User>
<CustomerRoles xmlns:e229="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e229:CustomerRole>
<e229:RoleId>ValueHere</e229:RoleId>
<e229:CustomerId>ValueHere</e229:CustomerId>
<e229:AccountIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</e229:AccountIds>
<e229:LinkedAccountIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</e229:LinkedAccountIds>
<e229:CustomerLinkPermission d4p1:nil="false">ValueHere</e229:CustomerLinkPermission>
</e229:CustomerRole>
</CustomerRoles>
</GetUserResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<GetUserResponse> GetUserAsync(
long? userId)
{
var request = new GetUserRequest
{
UserId = userId
};
return (await CustomerManagementService.CallAsync((s, r) => s.GetUserAsync(r), request));
}
static GetUserResponse getUser(
java.lang.Long userId) throws RemoteException, Exception
{
GetUserRequest request = new GetUserRequest();
request.setUserId(userId);
return CustomerManagementService.getService().getUser(request);
}
static function GetUser(
$userId)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new GetUserRequest();
$request->UserId = $userId;
return $GLOBALS['CustomerManagementProxy']->GetService()->GetUser($request);
}
response=customermanagement_service.GetUser(
UserId=UserId)
ข้อกําหนด
บริการ: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13