Oggetto dati utente - Gestione clienti

  • Articolo

Definisce le informazioni di contatto personali e aziendali relative a un utente di Microsoft Advertising.

È possibile assegnare più oggetti utente alla stessa persona, ad esempio un utente per persona per cliente. Le impostazioni utente Name, Lcid, JobTitle e ContactInfo per la stessa persona verranno sincronizzate automaticamente con tutti gli aggiornamenti che si verificano dopo il consolidamento degli utenti. Anche LastModifiedByUserId e LastModifiedTime sono sincronizzati tra ogni oggetto User restituito, a meno che non sia stato unito un nome utente precedente e non siano state aggiornate le impostazioni utente dopo il consolidamento.

Consiglio

Con le credenziali multiutente di Microsoft Advertising è possibile accettare un invito a gestire un cliente separato con le credenziali di Microsoft Advertising esistenti. Per altre informazioni, vedere la guida tecnica Multi-User Credentials .

Sintassi

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

Elementi

L'oggetto User include gli elementi seguenti: AuthenticationToken, ContactInfo, CustomerId, ForwardCompatibilityMap, Id, JobTitle, LastModifiedByUserId, LastModifiedTime, Lcid, Name, Password, SecretAnswer, SecretQuestion, TimeStamp, UserLifeCycleStatus, UserName.

Elemento Descrizione Tipo di dati
AuthenticationToken Token di accesso OAuth che rappresenta le credenziali dell'utente che dispone delle autorizzazioni per gli account Microsoft Advertising.

Per altre informazioni, vedere Autenticazione con OAuth.

Aggiornamento: Sola lettura		 Stringa
Contactinfo Informazioni di contatto dell'utente.

Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 Contactinfo
Customerid Identificatore del cliente a cui l'utente può accedere.

Aggiornamento: Sola lettura		 long
ForwardCompatibilityMap Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API.

Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per questo oggetto.		 Matrice KeyValuePairOfstringstring
Id Identificatore microsoft advertising dell'utente.

Aggiornamento: Obbligatorio		 long
JobTitle Titolo del processo dell'utente. Il titolo può contenere un massimo di 50 caratteri.

Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 Stringa
LastModifiedByUserId Identificatore dell'ultimo utente per aggiornare le informazioni dell'utente.

Aggiornamento: Sola lettura		 long
LastModifiedTime Data e ora dell'ultimo aggiornamento delle informazioni utente. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiornamento: Sola lettura		 Datetime
Lcid Impostazioni locali da utilizzare per l'invio di corrispondenza all'utente tramite posta elettronica o posta postale. Il valore predefinito è EnglishUS.

Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 LCID
Nome Nome dell'utente.

Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 PersonName
Password Questo elemento è riservato per l'uso interno e verrà rimosso da una versione futura dell'API.

L'operazione GetUser non restituisce la password.

Aggiornamento: Sola lettura		 Stringa
SecretAnswer Questo elemento è riservato per l'uso interno e verrà rimosso da una versione futura dell'API.

Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 Stringa
SecretQuestion Questo elemento è riservato per l'uso interno e verrà rimosso da una versione futura dell'API.

Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 SecretQuestion
Timestamp Valore di timestamp usato internamente dal sistema per riconciliare gli aggiornamenti quando si chiama UpdateUser o DeleteUser.

Aggiornamento: Obbligatorio		 base64Binary
UserLifeCycleStatus Stato dell'utente.

Aggiornamento: Sola lettura		 UserLifeCycleStatus
Nome utente Nome utente di accesso dell'utente.

L'indirizzo di posta elettronica dell'account Microsoft può essere diverso dall'elemento Email dell'oggetto ContactInfo.

Aggiornamento: Sola lettura		 Stringa

Requisiti

Servizio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Usato da

Getuser
SignupCustomer
UpdateUser