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ément	Description	Type de données
Userid	Identificateur de l’utilisateur à obtenir. Si cet élément est null ou n’est pas fourni, la réponse inclut les détails de l’utilisateur authentifié spécifié dans l’en-tête de requête.	Long

É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: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>

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