Partager via

Objet de données utilisateur - Gestion des clients

  • Article

Définit les coordonnées personnelles et professionnelles d’un utilisateur Microsoft Advertising.

Plusieurs objets utilisateur peuvent être attribués à la même personne, c’est-à-dire un utilisateur par personne et par client. Les paramètres utilisateur Name, Lcid, JobTitle et ContactInfo pour la même personne sont automatiquement synchronisés avec toutes les mises à jour qui se produisent après la consolidation de l’utilisateur. LastModifiedByUserId et LastModifiedTime sont également synchronisés sur chaque objet User retourné, sauf si vous aviez un ancien nom d’utilisateur fusionné et que vous n’avez pas mis à jour les paramètres utilisateur depuis la consolidation.

Conseil

Avec les informations d’identification multi-utilisateur Microsoft Advertising, vous pouvez accepter une invitation à gérer un client distinct avec vos informations d’identification Microsoft Advertising existantes. Pour plus d’informations, consultez le guide technique des informations d’identification multi-utilisateur .

Syntaxe

<xs:complexType name="User" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ContactInfo" nillable="true" type="tns:ContactInfo" />
    <xs:element minOccurs="0" name="CustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="JobTitle" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Lcid" nillable="true" type="tns:LCID" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="tns:PersonName" />
    <xs:element minOccurs="0" name="Password" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SecretAnswer" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SecretQuestion" type="tns:SecretQuestion" />
    <xs:element minOccurs="0" name="UserLifeCycleStatus" nillable="true" type="tns:UserLifeCycleStatus" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="UserName" nillable="true" type="xs:string" />
    <xs:element xmlns:q6="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q6:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="AuthenticationToken" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Éléments

L’objet User a les éléments suivants : AuthenticationToken, ContactInfo, CustomerId, ForwardCompatibilityMap, Id, JobTitle, LastModifiedByUserId, LastModifiedTime, Lcid, Name, Password, SecretAnswer, SecretQuestion, TimeStamp, UserLifeCycleStatus, UserName.

Élément Description Type de données
AuthenticationToken Jeton d’accès OAuth qui représente les informations d’identification de l’utilisateur qui dispose d’autorisations sur les comptes Microsoft Advertising.

Pour plus d’informations, consultez Authentification avec OAuth.

Mettre à jour: En lecture seule		 chaîne
ContactInfo Informations de contact de l’utilisateur.

Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 ContactInfo
Customerid Identificateur du client pour lequel cet utilisateur doit accéder.

Mettre à jour: En lecture seule		 Long
ForwardCompatibilityMap Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API.

Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.		 Tableau KeyValuePairOfstringstring
ID Identificateur Microsoft Advertising de l’utilisateur.

Mettre à jour: Obligatoire		 Long
Jobtitle Fonction de l’utilisateur. Le titre peut contenir un maximum de 50 caractères.

Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 chaîne
LastModifiedByUserId Identificateur du dernier utilisateur à mettre à jour les informations de l’utilisateur.

Mettre à jour: En lecture seule		 Long
LastModifiedTime Date et heure auxquelles les informations utilisateur ont été mises à jour pour la dernière fois. La valeur est exprimée au format UTC (temps universel coordonné).

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Mettre à jour: En lecture seule		 dateTime
Lcid Paramètres régionaux à utiliser lors de l’envoi de la correspondance à l’utilisateur par courrier électronique ou postal. La valeur par défaut est EnglishUS.

Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 LCID
Nom Nom de l’utilisateur

Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 PersonName
Mot de passe Cet élément est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API.

L’opération GetUser ne retourne pas le mot de passe.

Mettre à jour: En lecture seule		 chaîne
SecretAnswer Cet élément est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API.

Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 chaîne
SecretQuestion Cet élément est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API.

Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 SecretQuestion
Timestamp Valeur d’horodatage que le système utilise en interne pour rapprocher les mises à jour lorsque vous appelez UpdateUser ou DeleteUser.

Mettre à jour: Obligatoire		 base64Binary
UserLifeCycleStatus Status de l’utilisateur.

Mettre à jour: En lecture seule		 UserLifeCycleStatus
Nom d'utilisateur Nom d’utilisateur d’ouverture de session de l’utilisateur.

L’adresse e-mail du compte Microsoft peut différer de l’élément Email de l’objet ContactInfo.

Mettre à jour: En lecture seule		 chaîne

Configuration requise

Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13/Entities

Utilisé par

GetUser
SignupCustomer
UpdateUser