Objeto de Dados de Utilizador - Gestão de Clientes

Artigo
07/19/2024

Define informações de contacto pessoais e empresariais sobre um utilizador do Microsoft Advertising.

Vários objetos de utilizador podem ser atribuídos à mesma pessoa, ou seja, um utilizador por pessoa por cliente. As definições de utilizador Nome, Lcid, JobTitle e ContactInfo para a mesma pessoa serão automaticamente sincronizadas com quaisquer atualizações que ocorram após a consolidação do utilizador. O LastModifiedByUserId e o LastModifiedTime também estão sincronizados em cada objeto de Utilizador devolvido, a menos que tenha um nome de utilizador antigo intercalado e não tenha atualizado as definições de utilizador desde a consolidação.

Sugestão

Com as credenciais multiutilizador do Microsoft Advertising, pode aceitar um convite para gerir um cliente separado com as suas credenciais existentes do Microsoft Advertising. Para obter mais informações, veja o guia técnico Credenciais multiutilizador .

Sintaxe

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

Elementos

O objeto Utilizador tem os seguintes elementos: AuthenticationToken, ContactInfo, CustomerId, ForwardCompatibilityMap, Id, JobTitle, LastModifiedByUserId, LastModifiedTime, Lcid, Name, Password, SecretAnswer, SecretQuestion, TimeStamp, UserLifeCycleStatus, UserName.

Elemento	Descrição	Tipo de Dados
AuthenticationToken	O token de acesso OAuth que representa as credenciais do utilizador que tem permissões para contas do Microsoft Advertising. Para obter mais informações, veja Authentication with OAuth (Autenticação com OAuth). Atualização: Só de leitura	cadeia
ContactInfo	As informações de contacto do utilizador. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	ContactInfo
CustomerId	O identificador do cliente para este utilizador aceder. Atualização: Só de leitura	long
ForwardCompatibilityMap	A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API. As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.	Matriz KeyValuePairOfstringstring
ID	O identificador do Microsoft Advertising do utilizador. Atualização: Necessário	long
JobTitle	O cargo do utilizador. O título pode conter um máximo de 50 carateres. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	cadeia
LastModifiedByUserId	O identificador do último utilizador a atualizar as informações do utilizador. Atualização: Só de leitura	long
LastModifiedTime	A data e hora em que as informações do utilizador foram atualizadas pela última vez. O valor está em Hora Universal Coordenada (UTC). O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos. Atualização: Só de leitura	dateTime
Lcid	A região a utilizar ao enviar correspondência ao utilizador por e-mail ou correio postal. A predefinição é EnglishUS. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	LCID
Nome	O nome do utilizador. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	PersonName
Palavra-passe	Este elemento está reservado para utilização interna e será removido de uma versão futura da API. A operação GetUser não devolve a palavra-passe. Atualização: Só de leitura	cadeia
SecretAnswer	Este elemento está reservado para utilização interna e será removido de uma versão futura da API. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	cadeia
SecretQuestion	Este elemento está reservado para utilização interna e será removido de uma versão futura da API. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	SecretQuestion
Carimbo de Data/Hora	Um valor de carimbo de data/hora que o sistema utiliza internamente para reconciliar as atualizações quando chama UpdateUser ou DeleteUser. Atualização: Necessário	base64Binary
UserLifeCycleStatus	O estado do utilizador. Atualização: Só de leitura	UserLifeCycleStatus
Nome de Utilizador	O nome de utilizador de início de sessão do utilizador. O endereço de e-mail da Conta Microsoft pode ser diferente do elemento Email do objeto ContactInfo. Atualização: Só de leitura	cadeia

Requisitos

Serviço: CustomerManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Customer/v13/Entities

Utilizado Por

GetUser
SignupCustomer
UpdateUser

Partilhar via