Partilhar via

Objeto de Dados ClientLink - Gestão de Clientes

  • Artigo

Define um objeto de ligação de cliente. A aceitação de um convite de ligação de cliente permite que uma agência faça a gestão das contas de anunciante cliente correspondentes. Para enviar um convite para gerir uma conta de anunciante cliente, ligue para a operação AddClientLinks e especifique uma ligação de cliente por conta para gerir.

Uma ligação de cliente não tem um identificador de sistema público. Pode identificar ligações de cliente distintas por ClientEntityId e ManagingCustomerId.

Sugestão

Para obter mais informações sobre o ciclo de vida da ligação do cliente, veja o Guia técnico da Hierarquia de Contas . Para obter mais informações sobre como se tornar uma agência, consulte os Recursos para parceiros de agência. Para obter mais informações do ponto de vista de um cliente, veja Como fazer com que uma agência faça a gestão da sua conta microsoft Advertising.

Nota

Os clientes da agência no piloto Criar Contas em Nome do Cliente (GetCustomerPilotFeatures devolve 793) também podem estabelecer ligações de cliente ao nível da conta de anúncio através da operação de serviço SignupCustomer . Consulte SignupCustomer para obter mais informações.

Sintaxe

<xs:complexType name="ClientLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ClientEntityNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ManagingCustomerNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Note" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterPhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsBillToClient" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ClientLinkStatus" />
    <xs:element minOccurs="0" name="SuppressNotification" type="xs:boolean" />
    <xs:element minOccurs="0" name="LastModifiedDateTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" type="xs:long" />
    <xs:element minOccurs="0" name="Timestamp" nillable="true" type="xs:base64Binary" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elementos

O objeto ClientLink tem os seguintes elementos: ClientEntityId, ClientEntityName, ClientEntityNumber, CustomerLinkPermission, ForwardCompatibilityMap, InviterEmail, InviterName, InviterPhone, IsBillToClient, LastModifiedByUserId, LastModifiedDateTime, ManagingCustomerId, ManagingCustomerName, ManagingCustomerNumber, Name, Note, StartDate, Status, SuppressNotification, Timestamp, Type.

Elemento Descrição Tipo de Dados
ClientEntityId O identificador da conta do anunciante cliente ou cliente cliente a gerir

O elemento Tipo determina se a ligação é para uma conta de anunciante cliente ou um cliente cliente.

Adicionar: Necessário. O ClientEntityId ou o ClientEntityNumber são necessários, mas especificar ambos fará com que a operação falhe.
Atualização: Só de leitura e Obrigatório.		 Longo
ClientEntityName O nome da conta do anunciante cliente ou do cliente cliente a gerir

O elemento Tipo determina se a ligação é para uma conta de anunciante cliente ou um cliente cliente.

Adicionar: Só de leitura
Atualização: Só de leitura		 cadeia
ClientEntityNumber O número da conta do anunciante cliente ou do cliente cliente a gerir

O elemento Tipo determina se a ligação é para uma conta de anunciante cliente ou um cliente cliente.

Adicionar: Necessário. O ClientEntityId ou o ClientEntityNumber são necessários, mas especificar ambos fará com que a operação falhe.
Atualização: Só de leitura e Obrigatório.		 cadeia
CustomerLinkPermission Determina se o acesso do utilizador às contas é restringido pela hierarquia do cliente, ou seja, pela ligação do cliente ao nível do cliente.

Este elemento só é aplicável se o Tipo estiver definido como CustomerLink. Nesse caso, os valores possíveis incluem Administrativo e Standard. Caso contrário, este campo deve ser nulo ou estar vazio.

Se este campo estiver definido como "Administrativo", o utilizador tem acesso ao ClientEntityId através de uma ligação de cliente Administrativo.

Se este campo estiver definido como "Standard", o utilizador tem acesso ao ClientEntityId através de uma ligação de cliente Standard.

O ClientEntityId faz parte de uma hierarquia de ligação de cliente através da qual o utilizador pode aceder a outros clientes abaixo da mesma.

Para obter mais informações, veja o Guia técnico das Funções de Utilizador .

Adicionar: Opcional
Atualização: Só de leitura		 cadeia
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 o objeto ClientLink .		 Matriz KeyValuePairOfstringstring
InviterEmail O e-mail do utilizador que criou o pedido de ligação do cliente.

Este valor não tem de ser o mesmo que, nem é utilizado para modificar, o e-mail já armazenado no Microsoft Advertising para o utilizador autenticado atual.

Se não for especificado, o serviço definirá este valor para o e-mail já armazenado no Microsoft Advertising para o utilizador autenticado atual.

Adicionar: Opcional
Atualização: Só de leitura		 cadeia
InviterName O nome do cliente principal do utilizador que criou o pedido de ligação do cliente.

Este valor não tem de ser o mesmo que, nem é utilizado para modificar, o nome do cliente já armazenado no Microsoft Advertising.

Se não for especificado, o serviço definirá este valor para o nome do cliente principal já armazenado no Microsoft Advertising para o utilizador autenticado atual.

Adicionar: Opcional
Atualização: Só de leitura		 cadeia
InviterPhone O número de telefone do utilizador que criou o pedido de ligação do cliente.

Este valor não tem de ser o mesmo que, nem é utilizado para modificar, o número de telefone já armazenado no Microsoft Advertising para o utilizador autenticado atual.

Se não for especificado, o serviço definirá este valor para o número de telefone já armazenado no Microsoft Advertising para o utilizador autenticado atual.

Adicionar: Opcional
Atualização: Só de leitura		 cadeia
IsBillToClient Determina se o proprietário da conta do anunciante cliente ou o cliente de gestão é responsável pelos pagamentos de faturação.

Este elemento só é aplicável às ligações de cliente da conta de anunciante e não é aplicável às ligações do cliente. A conta do anunciante cliente tem de ser configurada para faturação pós-pagamento. As contas pré-pagas não são suportadas para gestão por agências. Se definido como verdadeiro, o cliente é responsável pela faturação. Se definido como falso, o cliente de gestão é responsável pela faturação.

Adicionar: Necessário para ligações de conta de anunciante; Não aplicável às ligações do cliente.
Atualização: Só de leitura		 booleano
LastModifiedByUserId O identificador do último utilizador a atualizar as informações da ligação do cliente.

Adicionar: Só de leitura
Atualização: Só de leitura		 Longo
LastModifiedDateTime A data e hora em que a ligação do cliente foi atualizada 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.

Adicionar: Só de leitura
Atualização: Só de leitura		 dateTime
ManagingCustomerId O identificador do cliente que gere ou está a pedir para gerir a conta do anunciante cliente.

Adicionar: Necessário. É necessário o ManagingCustomerId ou o ManagingCustomerNumber , mas especificar ambos fará com que a operação falhe.
Atualização: Só de leitura e Obrigatório		 Longo
ManagingCustomerName O nome do cliente que gere ou está a pedir para gerir a conta do anunciante cliente.

Adicionar: Só de leitura
Atualização: Só de leitura		 cadeia
ManagingCustomerNumber O número de clientes que gere ou está a pedir para gerir a conta do anunciante cliente.

Adicionar: Necessário. É necessário o ManagingCustomerId ou o ManagingCustomerNumber , mas especificar ambos fará com que a operação falhe.
Atualização: Só de leitura e Obrigatório		 cadeia
Nome O nome amigável que pode ser utilizado para referenciar esta ligação de cliente.

O nome pode conter um máximo de 40 carateres.

Será fornecido um nome predefinido se não for especificado nenhum. O nome não tem de ser exclusivo em comparação com outras ligações de cliente para o utilizador.

Adicionar: Opcional
Atualização: Só de leitura		 cadeia
Nota Mensagem opcional do requerente que fornece contexto e detalhes sobre o convite de ligação do cliente.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 cadeia
Data De Início A data em que o estado será atualizado. Para um pedido de ligação aceite, o estado transitaria para Ativo nesta data e, para um pedido de desassociação, o estado passaria para Inativo nesta data.

Se não for especificado, este valor será definido como a data e hora atuais.

Adicionar: Opcional
Atualização: Só de leitura		 dateTime
Estado Determina o estado do ciclo de vida da ligação do cliente, por exemplo, se a ligação do cliente foi aceite ou recusada.

Ao adicionar uma ligação de cliente, este elemento não pode ser especificado e o serviço define o estado efetivo como LinkPending.

Adicionar: Só de leitura
Atualização: Necessário		 ClientLinkStatus
SuppressNotification Determina se deve ou não enviar uma notificação por e-mail do convite de ligação de cliente para o utilizador principal da conta do anunciante cliente.

Se for definido como verdadeiro, o cliente não receberá um e-mail e, caso contrário, uma vez que o valor predefinido é falso, o cliente receberá uma notificação por e-mail.

Adicionar: Opcional
Atualização: Só de leitura		 booleano
Carimbo de data/hora Reservado para utilização futura. base64Binary
Tipo Determina se a ligação é para uma conta de anunciante cliente ou um cliente cliente.

Os valores possíveis são AccountLink e CustomerLink. Se este elemento estiver vazio ou estiver definido como AccountLink, o ClientEntityId, ClientEntityName e ClientEntityNumber representam uma conta de anunciante cliente. Se este elemento estiver definido como CustomerLink, clientEntityId, ClientEntityName e ClientEntityNumber representam um cliente cliente.

Adicionar: Opcional. Se este elemento não estiver definido, o serviço tenta criar uma ligação de cliente de conta de anunciante.
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

AddClientLinks
SearchClientLinks
UpdateClientLinks