Objet de données utilisateur - Gestion des clients

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

XML

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

JSON

{
  "AuthenticationToken": "ValueHere",
  "ContactInfo": {
    "Address": {
      "BusinessName": "ValueHere",
      "City": "ValueHere",
      "CountryCode": "ValueHere",
      "Id": "LongValueHere",
      "Line1": "ValueHere",
      "Line2": "ValueHere",
      "Line3": "ValueHere",
      "Line4": "ValueHere",
      "PostalCode": "ValueHere",
      "StateOrProvince": "ValueHere",
      "TimeStamp": "ValueHere"
    },
    "ContactByPhone": "ValueHere",
    "ContactByPostalMail": "ValueHere",
    "Email": "ValueHere",
    "EmailFormat": "ValueHere",
    "Fax": "ValueHere",
    "HomePhone": "ValueHere",
    "Id": "LongValueHere",
    "Mobile": "ValueHere",
    "Phone1": "ValueHere",
    "Phone2": "ValueHere"
  },
  "CustomerId": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "JobTitle": "ValueHere",
  "LastModifiedByUserId": "LongValueHere",
  "LastModifiedTime": "ValueHere",
  "Lcid": "ValueHere",
  "Name": {
    "FirstName": "ValueHere",
    "LastName": "ValueHere",
    "MiddleInitial": "ValueHere"
  },
  "Password": "ValueHere",
  "SecretAnswer": "ValueHere",
  "SecretQuestion": "ValueHere",
  "TimeStamp": "ValueHere",
  "UserLifeCycleStatus": "ValueHere",
  "UserName": "ValueHere"
}

É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
Horodatage	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
UserName	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
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Utilisé par

GetUser
SignupCustomer
UpdateUser