GetUser サービス操作 - 顧客管理
ユーザーの詳細を取得します。
ヒント
例を含む概要については、 アカウント Hierchy とユーザーのアクセス許可 に関するガイドを参照してください。
Request 要素
GetUserRequest オブジェクトは、サービス操作要求の本文要素とヘッダー要素を定義します。 要素は、 要求 SOAP に示されている順序と同じ順序である必要があります。
注:
以下に特に記載がない限り、すべての要求要素が必要です。
要求本文要素
| 要素 | 説明 | データ型 |
|---|---|---|
| UserId | 取得するユーザーの識別子。 この要素が null または指定されていない場合、応答には、要求ヘッダーで指定された認証済みユーザーの詳細が含まれます。 |
long |
要求ヘッダー要素
| 要素 | 説明 | データ型 |
|---|---|---|
| AuthenticationToken | Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセス トークン。 詳細については、「 OAuth による認証」を参照してください。 |
string |
| DeveloperToken | Bing Ads API へのアクセスに使用される開発者トークン。 詳細については、「 開発者トークンを取得する」を参照してください。 |
string |
| Password | この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 | string |
| UserName | この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 | string |
Response 要素
GetUserResponse オブジェクトは、サービス操作応答の本文要素とヘッダー要素を定義します。 要素は、 応答 SOAP に示されている順序と同じ順序で返されます。
応答本文の要素
| 要素 | 説明 | データ型 |
|---|---|---|
| CustomerRoles | 各顧客またはアカウントの一覧に対してユーザーが持つロールの一覧。 少なくとも 1 つのリスト アイテムが返されます。 ユーザーの資格情報が複数の顧客にアクセスできる場合は、顧客ごとに 1 つの CustomerRole オブジェクトが返されます。 すべての顧客に対して、独自のすべてのロールを表示できます。ただし、アクセスできる顧客に関連する他のユーザーのロールのみが表示されます。 たとえば、顧客 A にアクセスできるとanother-user@contoso.comしますyou@contoso.com。他のユーザーは、顧客 B と C にもアクセスできる可能性があります。ただし、ユーザー識別子を使用してこの操作を呼び出すと、顧客 A の下にのみロールが表示されます。この操作を独自の資格情報で呼び出すとanother-user@contoso.com、操作は 3 つの CustomerRole オブジェクトを返します。 |
CustomerRole 配列 |
| User | ユーザーに関する情報を含むユーザー オブジェクト。 | ユーザー |
応答ヘッダー要素
| 要素 | 説明 | データ型 |
|---|---|---|
| TrackingId | API 呼び出しの詳細を含むログ エントリの識別子。 | string |
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>
応答 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:e239="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e239:ContactInfo d4p1:nil="false">
<e239:Address d4p1:nil="false">
<e239:City d4p1:nil="false">ValueHere</e239:City>
<e239:CountryCode d4p1:nil="false">ValueHere</e239:CountryCode>
<e239:Id d4p1:nil="false">ValueHere</e239:Id>
<e239:Line1 d4p1:nil="false">ValueHere</e239:Line1>
<e239:Line2 d4p1:nil="false">ValueHere</e239:Line2>
<e239:Line3 d4p1:nil="false">ValueHere</e239:Line3>
<e239:Line4 d4p1:nil="false">ValueHere</e239:Line4>
<e239:PostalCode d4p1:nil="false">ValueHere</e239:PostalCode>
<e239:StateOrProvince d4p1:nil="false">ValueHere</e239:StateOrProvince>
<e239:TimeStamp d4p1:nil="false">ValueHere</e239:TimeStamp>
<e239:BusinessName d4p1:nil="false">ValueHere</e239:BusinessName>
</e239:Address>
<e239:ContactByPhone d4p1:nil="false">ValueHere</e239:ContactByPhone>
<e239:ContactByPostalMail d4p1:nil="false">ValueHere</e239:ContactByPostalMail>
<e239:Email d4p1:nil="false">ValueHere</e239:Email>
<e239:EmailFormat d4p1:nil="false">ValueHere</e239:EmailFormat>
<e239:Fax d4p1:nil="false">ValueHere</e239:Fax>
<e239:HomePhone d4p1:nil="false">ValueHere</e239:HomePhone>
<e239:Id d4p1:nil="false">ValueHere</e239:Id>
<e239:Mobile d4p1:nil="false">ValueHere</e239:Mobile>
<e239:Phone1 d4p1:nil="false">ValueHere</e239:Phone1>
<e239:Phone2 d4p1:nil="false">ValueHere</e239:Phone2>
</e239:ContactInfo>
<e239:CustomerId d4p1:nil="false">ValueHere</e239:CustomerId>
<e239:Id d4p1:nil="false">ValueHere</e239:Id>
<e239:JobTitle d4p1:nil="false">ValueHere</e239:JobTitle>
<e239:LastModifiedByUserId d4p1:nil="false">ValueHere</e239:LastModifiedByUserId>
<e239:LastModifiedTime d4p1:nil="false">ValueHere</e239:LastModifiedTime>
<e239:Lcid d4p1:nil="false">ValueHere</e239:Lcid>
<e239:Name d4p1:nil="false">
<e239:FirstName d4p1:nil="false">ValueHere</e239:FirstName>
<e239:LastName d4p1:nil="false">ValueHere</e239:LastName>
<e239:MiddleInitial d4p1:nil="false">ValueHere</e239:MiddleInitial>
</e239:Name>
<e239:Password d4p1:nil="false">ValueHere</e239:Password>
<e239:SecretAnswer d4p1:nil="false">ValueHere</e239:SecretAnswer>
<e239:SecretQuestion>ValueHere</e239:SecretQuestion>
<e239:UserLifeCycleStatus d4p1:nil="false">ValueHere</e239:UserLifeCycleStatus>
<e239:TimeStamp d4p1:nil="false">ValueHere</e239:TimeStamp>
<e239:UserName d4p1:nil="false">ValueHere</e239:UserName>
<e239:ForwardCompatibilityMap xmlns:e240="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e240:KeyValuePairOfstringstring>
<e240:key d4p1:nil="false">ValueHere</e240:key>
<e240:value d4p1:nil="false">ValueHere</e240:value>
</e240:KeyValuePairOfstringstring>
</e239:ForwardCompatibilityMap>
<e239:AuthenticationToken d4p1:nil="false">ValueHere</e239:AuthenticationToken>
</User>
<CustomerRoles xmlns:e241="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e241:CustomerRole>
<e241:RoleId>ValueHere</e241:RoleId>
<e241:CustomerId>ValueHere</e241:CustomerId>
<e241:AccountIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</e241:AccountIds>
<e241:LinkedAccountIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</e241:LinkedAccountIds>
<e241:CustomerLinkPermission d4p1:nil="false">ValueHere</e241:CustomerLinkPermission>
</e241:CustomerRole>
</CustomerRoles>
</GetUserResponse>
</s:Body>
</s:Envelope>
コード構文
構文の例は、 Bing広告 SDK で使用できます。 その他 の例については、「Bing広告 API コードの例 」を参照してください。
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
名前 空間： https://bingads.microsoft.com/Customer/v13
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示