Compartilhar via

Objeto de Dados de Utilizador - Gestão de Clientes

  • Artigo

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