Opération du service GetUser - Gestion des clients
Obtient les détails d’un utilisateur.
Conseil
Pour obtenir une vue d’ensemble avec des exemples, consultez le Guide des autorisations utilisateur et hierchy de compte.
Éléments de demande
L’objet GetUserRequest définit le corps et les éléments d’en-tête de la demande d’opération de service. Les éléments doivent être dans le même ordre que celui indiqué dans la requête SOAP.
Remarque
Sauf indication contraire ci-dessous, tous les éléments de requête sont requis.
Éléments du corps de la requête
Éléments d’en-tête de requête
| Élément | Description | Type de données |
|---|---|---|
| AuthenticationToken | Jeton d’accès OAuth qui représente les informations d’identification d’un utilisateur disposant d’autorisations sur les comptes Microsoft Advertising. Pour plus d’informations, consultez Authentification avec OAuth. |
chaîne |
| DeveloperToken | Jeton de développeur utilisé pour accéder à l’API Bing Ads. Pour plus d’informations, consultez Obtenir un jeton de développeur. |
chaîne |
| Password | Cet élément est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API. Vous devez utiliser l’élément AuthenticationToken pour définir les informations d’identification de l’utilisateur. | chaîne |
| UserName | Cet élément est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API. Vous devez utiliser l’élément AuthenticationToken pour définir les informations d’identification de l’utilisateur. | chaîne |
Éléments Response
L’objet GetUserResponse définit les éléments body et header de la réponse de l’opération de service. Les éléments sont retournés dans le même ordre que celui indiqué dans la réponse SOAP.
Response Body, éléments
| Élément | Description | Type de données |
|---|---|---|
| CustomerRoles | Liste des rôles qu’un utilisateur a pour chaque client ou liste de comptes. Au moins un élément de liste sera retourné. Si les informations d’identification d’un utilisateur peuvent accéder à plusieurs clients, un objet CustomerRole par client est retourné. Vous pouvez afficher tous vos propres rôles sur tous les clients ; Toutefois, vous verrez uniquement les rôles des autres utilisateurs en ce qui concerne les clients auxquels vous pouvez accéder. Par exemple, supposons que you@contoso.com et another-user@contoso.com peuvent accéder au client A. L’autre utilisateur peut également avoir accès au client B et C ; Toutefois, lorsque vous appelez cette opération avec son identificateur d’utilisateur, vous voyez uniquement son rôle sous Client A. Quand another-user@contoso.com elle appelle cette opération avec leurs propres informations d’identification, l’opération retourne trois objets CustomerRole . |
Tableau CustomerRole |
| Utilisateur | Objet utilisateur qui contient des informations sur l’utilisateur. | Utilisateur |
Éléments d’en-tête de réponse
| Élément | Description | Type de données |
|---|---|---|
| TrackingId | Identificateur de l’entrée de journal qui contient les détails de l’appel d’API. | chaîne |
Requête SOAP
Ce modèle a été généré par un outil pour afficher l’ordre des éléments body et header pour la requête SOAP. Pour connaître les types pris en charge que vous pouvez utiliser avec cette opération de service, consultez la référence Éléments du corps de la demande ci-dessus.
<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 de réponse
Ce modèle a été généré par un outil pour afficher l’ordre des éléments de corps et d’en-tête pour la réponse 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>
Syntaxe du code
L’exemple de syntaxe peut être utilisé avec les Kits de développement logiciel (SDK) Bing Ads. Pour plus d’exemples, consultez Exemples de code de l’API Bing Ads .
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)
Configuration requise
Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13