Partilhar via

Operação signupCustomer Service – Gestão de Clientes

  • Artigo

Cria um novo cliente e uma conta.

Normalmente, tem de ser um utilizador com credenciais de agregador para chamar esta operação. Nesse caso, a operação cria um novo cliente e uma conta que são agregados ao método de pagamento do agregador. O objeto AdvertiserAccount tem de incluir o nome da conta, o tipo de moeda a utilizar para liquidar a conta e o identificador do método de pagamento tem de ser definido como nulo. A operação gera uma conta de fatura e define o identificador do método de pagamento para o identificador associado à fatura do agregador. É faturado por todos os custos incorridos pelos clientes que gere.

Nota

Os clientes da agência no piloto Criar Contas em Nome do Cliente (GetCustomerPilotFeatures devolve 793) podem inscrever um novo cliente em nome de um cliente e, opcionalmente, ligar à nova conta como uma agência. Neste caso, é enviada uma UserInvitation e o cliente tem de concluir os passos de inscrição através da IU do Microsoft Advertising, como aceitar os termos e condições.

Nota

Os clientes do piloto de campanhas inteligentes Unificadas fechados podem inscrever um novo cliente com uma conta para campanhas inteligentes unificadas. Opcionalmente, podem ligar à nova conta como uma agência. O super administrador é aprovisionado ao definir o elemento UserId ou UserInvitation .

Nota

Os clientes na conta de cliente configurada de forma totalmente integrada e o piloto de PI podem inscrever um novo cliente com uma conta e criar um utilizador administrador em simultâneo. O utilizador administrador é aprovisionado ao definir o elemento Utilizador . Além disso, o cliente tem de concluir os passos de inscrição através da IU de Publicidade da Microsoft na página de cliente de ativação do Microsoft Advertising.

Elementos do Pedido

O objeto SignupCustomerRequest define os elementos do corpo e do cabeçalho do pedido de operação do serviço. Os elementos têm de estar na mesma ordem mostrada no Pedido SOAP.

Nota

Salvo indicação em contrário abaixo, todos os elementos do pedido são necessários.

Elementos do Corpo do Pedido

Elemento Descrição Tipo de Dados
Conta Uma AdvertiserAccount que especifica os detalhes da conta principal do cliente.

Os clientes do piloto de campanhas inteligentes unificadas fechados têm de definir o elemento AccountMode como "UnifiedSmart".		 AdvertiserAccount
Cliente Um Cliente que especifica os detalhes do cliente que está a adicionar. Cliente
ParentCustomerId O identificador do cliente do agregador ou agência que irá gerir o novo cliente subordinado.

Este elemento é necessário para os agregadores, mas ignorado para as agências quando o elemento de pedido UserInvitation está definido. Os clientes no piloto de campanhas inteligentes Unificadas fechado podem ligar o novo cliente ao ID da agência principal ou deixar este elemento vazio.		 long
Utilizador O utilizador a criar. Pode cumprir este elemento se quiser inscrever um novo cliente e criar um novo utilizador administrador em simultâneo.

Após a inscrição do novo cliente, o utilizador administrador recém-criado tem de concluir os passos de inscrição através da IU de Publicidade da Microsoft na página do cliente de ativação do Microsoft Advertising. O URL é https://ads.microsoft.com/ActivateCustomer?cid={new_customer_Id}& aid={new_account_Id} em que new_customer_Id e new_account_Id são os IDs que obtém no SignupCustomerResponse.

O AuthenticationToken no elemento Utilizador é o token de acesso OAuth que representa as credenciais do novo utilizador administrador que será criado durante a inscrição.

Os clientes na conta de cliente configurada de forma totalmente integrada e o piloto de PI têm de definir um ou mais userId , UserInvitation ou Utilizador.

Os campos necessários no objeto Utilizador são ContactInfo.Email, Name.FirstName, Name.LastName e AuthenticationToken.		 Utilizador
UserId O identificador de um utilizador existente que será adicionado como Super Administração no novo cliente.

Este elemento só está disponível para clientes no piloto de campanhas inteligentes unificadas fechado. Um ou mais dos elementos UserId ou UserInvitation têm de ser definidos.		 long
UserInvitation O convite de utilizador para enviar se pretender inscrever um novo cliente em nome de um cliente e, opcionalmente, ligar à nova conta como uma agência.

Um utilizador cliente do Super Administração tem de concluir os passos de inscrição através da IU do Microsoft Advertising, como aceitar os termos e condições.

Este elemento é opcional para clientes de agências no piloto Criar Contas em Nome do Cliente.

Os clientes no piloto de campanhas inteligentes unificadas fechados têm de definir um ou mais dos elementos UserId ou UserInvitation .		 UserInvitation

Elementos do Cabeçalho do Pedido

Elemento Descrição Tipo de Dados
AuthenticationToken O token de acesso OAuth que representa as credenciais de um utilizador que tem permissões para contas do Microsoft Advertising.

Para obter mais informações, veja Authentication with OAuth (Autenticação com OAuth).		 cadeia
DeveloperToken O token de programador utilizado para aceder à API de Anúncios do Bing.

Para obter mais informações, veja Obter um Token de Programador.		 cadeia
Palavra-passe Este elemento está reservado para utilização interna e será removido de uma versão futura da API. Tem de utilizar o elemento AuthenticationToken para definir credenciais de utilizador. cadeia
Nome de Utilizador Este elemento está reservado para utilização interna e será removido de uma versão futura da API. Tem de utilizar o elemento AuthenticationToken para definir credenciais de utilizador. cadeia

Elementos de Resposta

O objeto SignupCustomerResponse define os elementos do corpo e do cabeçalho da resposta da operação do serviço. Os elementos são devolvidos pela mesma ordem mostrada no SOAP de Resposta.

Elementos do Corpo da Resposta

Elemento Descrição Tipo de Dados
AccountId Um identificador de conta gerado pelo sistema correspondente à nova conta especificada no pedido.

Utilize este identificador com pedidos de operação que requerem um elemento do corpo AccountId e um elemento de cabeçalho SOAP CustomerAccountId .		 long
AccountNumber O número de conta gerado pelo sistema que é utilizado para identificar a conta na aplicação Web Microsoft Advertising.

O número da conta tem o formulário xxxxxxxx, em que xxxxxxxx é uma série de oito carateres alfanuméricos.		 cadeia
CreateTime A data e hora em que a conta foi adicionada. 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. dateTime
CustomerId Um identificador de cliente gerado pelo sistema correspondente ao novo cliente especificado no pedido.

Utilize este identificador com pedidos de operação que requerem um elemento de cabeçalho SOAP CustomerId .		 long
Número de Cliente Um número de cliente gerado pelo sistema que é utilizado na aplicação Web Microsoft Advertising.

O número de cliente tem o formulário xxxxxxxxxx, em que xxxxxxxxxx é uma série de dez carateres alfanuméricos.		 cadeia

Elementos do Cabeçalho de Resposta

Elemento Descrição Tipo de Dados
TrackingId O identificador da entrada de registo que contém os detalhes da chamada à API. cadeia

Pedir SOAP

Este modelo foi gerado por uma ferramenta para mostrar a ordem dos elementos do corpo e do cabeçalho do pedido SOAP. Para tipos suportados que pode utilizar com esta operação de serviço, veja a referência Request Body Elements (Elementos do Corpo do Pedido ) acima.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <Action mustUnderstand="1">SignupCustomer</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <SignupCustomerRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <Customer xmlns:e264="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e264:CustomerFinancialStatus i:nil="false">ValueHere</e264:CustomerFinancialStatus>
        <e264:Id i:nil="false">ValueHere</e264:Id>
        <e264:Industry i:nil="false">ValueHere</e264:Industry>
        <e264:LastModifiedByUserId i:nil="false">ValueHere</e264:LastModifiedByUserId>
        <e264:LastModifiedTime i:nil="false">ValueHere</e264:LastModifiedTime>
        <e264:MarketCountry i:nil="false">ValueHere</e264:MarketCountry>
        <e264:ForwardCompatibilityMap xmlns:e265="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e265:KeyValuePairOfstringstring>
            <e265:key i:nil="false">ValueHere</e265:key>
            <e265:value i:nil="false">ValueHere</e265:value>
          </e265:KeyValuePairOfstringstring>
        </e264:ForwardCompatibilityMap>
        <e264:MarketLanguage i:nil="false">ValueHere</e264:MarketLanguage>
        <e264:Name i:nil="false">ValueHere</e264:Name>
        <e264:ServiceLevel i:nil="false">ValueHere</e264:ServiceLevel>
        <e264:CustomerLifeCycleStatus i:nil="false">ValueHere</e264:CustomerLifeCycleStatus>
        <e264:TimeStamp i:nil="false">ValueHere</e264:TimeStamp>
        <e264:Number i:nil="false">ValueHere</e264:Number>
        <e264:CustomerAddress i:nil="false">
          <e264:City i:nil="false">ValueHere</e264:City>
          <e264:CountryCode i:nil="false">ValueHere</e264:CountryCode>
          <e264:Id i:nil="false">ValueHere</e264:Id>
          <e264:Line1 i:nil="false">ValueHere</e264:Line1>
          <e264:Line2 i:nil="false">ValueHere</e264:Line2>
          <e264:Line3 i:nil="false">ValueHere</e264:Line3>
          <e264:Line4 i:nil="false">ValueHere</e264:Line4>
          <e264:PostalCode i:nil="false">ValueHere</e264:PostalCode>
          <e264:StateOrProvince i:nil="false">ValueHere</e264:StateOrProvince>
          <e264:TimeStamp i:nil="false">ValueHere</e264:TimeStamp>
          <e264:BusinessName i:nil="false">ValueHere</e264:BusinessName>
        </e264:CustomerAddress>
      </Customer>
      <Account xmlns:e266="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e266:BillToCustomerId i:nil="false">ValueHere</e266:BillToCustomerId>
        <e266:CurrencyCode i:nil="false">ValueHere</e266:CurrencyCode>
        <e266:AccountFinancialStatus i:nil="false">ValueHere</e266:AccountFinancialStatus>
        <e266:Id i:nil="false">ValueHere</e266:Id>
        <e266:Language i:nil="false">ValueHere</e266:Language>
        <e266:LastModifiedByUserId i:nil="false">ValueHere</e266:LastModifiedByUserId>
        <e266:LastModifiedTime i:nil="false">ValueHere</e266:LastModifiedTime>
        <e266:Name i:nil="false">ValueHere</e266:Name>
        <e266:Number i:nil="false">ValueHere</e266:Number>
        <e266:ParentCustomerId>ValueHere</e266:ParentCustomerId>
        <e266:PaymentMethodId i:nil="false">ValueHere</e266:PaymentMethodId>
        <e266:PaymentMethodType i:nil="false">ValueHere</e266:PaymentMethodType>
        <e266:PrimaryUserId i:nil="false">ValueHere</e266:PrimaryUserId>
        <e266:AccountLifeCycleStatus i:nil="false">ValueHere</e266:AccountLifeCycleStatus>
        <e266:TimeStamp i:nil="false">ValueHere</e266:TimeStamp>
        <e266:TimeZone i:nil="false">ValueHere</e266:TimeZone>
        <e266:PauseReason i:nil="false">ValueHere</e266:PauseReason>
        <e266:ForwardCompatibilityMap xmlns:e267="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e267:KeyValuePairOfstringstring>
            <e267:key i:nil="false">ValueHere</e267:key>
            <e267:value i:nil="false">ValueHere</e267:value>
          </e267:KeyValuePairOfstringstring>
        </e266:ForwardCompatibilityMap>
        <e266:LinkedAgencies i:nil="false">
          <e266:CustomerInfo>
            <e266:Id i:nil="false">ValueHere</e266:Id>
            <e266:Name i:nil="false">ValueHere</e266:Name>
          </e266:CustomerInfo>
        </e266:LinkedAgencies>
        <e266:SalesHouseCustomerId i:nil="false">ValueHere</e266:SalesHouseCustomerId>
        <e266:TaxInformation xmlns:e268="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e268:KeyValuePairOfstringstring>
            <e268:key i:nil="false">ValueHere</e268:key>
            <e268:value i:nil="false">ValueHere</e268:value>
          </e268:KeyValuePairOfstringstring>
        </e266:TaxInformation>
        <e266:BackUpPaymentInstrumentId i:nil="false">ValueHere</e266:BackUpPaymentInstrumentId>
        <e266:BillingThresholdAmount i:nil="false">ValueHere</e266:BillingThresholdAmount>
        <e266:BusinessAddress i:nil="false">
          <e266:City i:nil="false">ValueHere</e266:City>
          <e266:CountryCode i:nil="false">ValueHere</e266:CountryCode>
          <e266:Id i:nil="false">ValueHere</e266:Id>
          <e266:Line1 i:nil="false">ValueHere</e266:Line1>
          <e266:Line2 i:nil="false">ValueHere</e266:Line2>
          <e266:Line3 i:nil="false">ValueHere</e266:Line3>
          <e266:Line4 i:nil="false">ValueHere</e266:Line4>
          <e266:PostalCode i:nil="false">ValueHere</e266:PostalCode>
          <e266:StateOrProvince i:nil="false">ValueHere</e266:StateOrProvince>
          <e266:TimeStamp i:nil="false">ValueHere</e266:TimeStamp>
          <e266:BusinessName i:nil="false">ValueHere</e266:BusinessName>
        </e266:BusinessAddress>
        <e266:AutoTagType i:nil="false">ValueHere</e266:AutoTagType>
        <e266:SoldToPaymentInstrumentId i:nil="false">ValueHere</e266:SoldToPaymentInstrumentId>
        <e266:TaxCertificate i:nil="false">
          <e266:TaxCertificateBlobContainerName i:nil="false">ValueHere</e266:TaxCertificateBlobContainerName>
          <e266:TaxCertificates xmlns:e269="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
            <e269:KeyValuePairOfstringbase64Binary>
              <e269:key i:nil="false">ValueHere</e269:key>
              <e269:value i:nil="false">ValueHere</e269:value>
            </e269:KeyValuePairOfstringbase64Binary>
          </e266:TaxCertificates>
          <e266:Status i:nil="false">ValueHere</e266:Status>
        </e266:TaxCertificate>
        <e266:AccountMode i:nil="false">ValueHere</e266:AccountMode>
      </Account>
      <ParentCustomerId i:nil="false">ValueHere</ParentCustomerId>
      <UserInvitation xmlns:e270="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e270:Id>ValueHere</e270:Id>
        <e270:FirstName i:nil="false">ValueHere</e270:FirstName>
        <e270:LastName i:nil="false">ValueHere</e270:LastName>
        <e270:Email i:nil="false">ValueHere</e270:Email>
        <e270:CustomerId>ValueHere</e270:CustomerId>
        <e270:RoleId>ValueHere</e270:RoleId>
        <e270:AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </e270:AccountIds>
        <e270:ExpirationDate>ValueHere</e270:ExpirationDate>
        <e270:Lcid>ValueHere</e270:Lcid>
      </UserInvitation>
      <UserId i:nil="false">ValueHere</UserId>
      <User xmlns:e271="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e271:ContactInfo i:nil="false">
          <e271:Address i:nil="false">
            <e271:City i:nil="false">ValueHere</e271:City>
            <e271:CountryCode i:nil="false">ValueHere</e271:CountryCode>
            <e271:Id i:nil="false">ValueHere</e271:Id>
            <e271:Line1 i:nil="false">ValueHere</e271:Line1>
            <e271:Line2 i:nil="false">ValueHere</e271:Line2>
            <e271:Line3 i:nil="false">ValueHere</e271:Line3>
            <e271:Line4 i:nil="false">ValueHere</e271:Line4>
            <e271:PostalCode i:nil="false">ValueHere</e271:PostalCode>
            <e271:StateOrProvince i:nil="false">ValueHere</e271:StateOrProvince>
            <e271:TimeStamp i:nil="false">ValueHere</e271:TimeStamp>
            <e271:BusinessName i:nil="false">ValueHere</e271:BusinessName>
          </e271:Address>
          <e271:ContactByPhone i:nil="false">ValueHere</e271:ContactByPhone>
          <e271:ContactByPostalMail i:nil="false">ValueHere</e271:ContactByPostalMail>
          <e271:Email i:nil="false">ValueHere</e271:Email>
          <e271:EmailFormat i:nil="false">ValueHere</e271:EmailFormat>
          <e271:Fax i:nil="false">ValueHere</e271:Fax>
          <e271:HomePhone i:nil="false">ValueHere</e271:HomePhone>
          <e271:Id i:nil="false">ValueHere</e271:Id>
          <e271:Mobile i:nil="false">ValueHere</e271:Mobile>
          <e271:Phone1 i:nil="false">ValueHere</e271:Phone1>
          <e271:Phone2 i:nil="false">ValueHere</e271:Phone2>
        </e271:ContactInfo>
        <e271:CustomerId i:nil="false">ValueHere</e271:CustomerId>
        <e271:Id i:nil="false">ValueHere</e271:Id>
        <e271:JobTitle i:nil="false">ValueHere</e271:JobTitle>
        <e271:LastModifiedByUserId i:nil="false">ValueHere</e271:LastModifiedByUserId>
        <e271:LastModifiedTime i:nil="false">ValueHere</e271:LastModifiedTime>
        <e271:Lcid i:nil="false">ValueHere</e271:Lcid>
        <e271:Name i:nil="false">
          <e271:FirstName i:nil="false">ValueHere</e271:FirstName>
          <e271:LastName i:nil="false">ValueHere</e271:LastName>
          <e271:MiddleInitial i:nil="false">ValueHere</e271:MiddleInitial>
        </e271:Name>
        <e271:Password i:nil="false">ValueHere</e271:Password>
        <e271:SecretAnswer i:nil="false">ValueHere</e271:SecretAnswer>
        <e271:SecretQuestion>ValueHere</e271:SecretQuestion>
        <e271:UserLifeCycleStatus i:nil="false">ValueHere</e271:UserLifeCycleStatus>
        <e271:TimeStamp i:nil="false">ValueHere</e271:TimeStamp>
        <e271:UserName i:nil="false">ValueHere</e271:UserName>
        <e271:ForwardCompatibilityMap xmlns:e272="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e272:KeyValuePairOfstringstring>
            <e272:key i:nil="false">ValueHere</e272:key>
            <e272:value i:nil="false">ValueHere</e272:value>
          </e272:KeyValuePairOfstringstring>
        </e271:ForwardCompatibilityMap>
        <e271:AuthenticationToken i:nil="false">ValueHere</e271:AuthenticationToken>
      </User>
    </SignupCustomerRequest>
  </s:Body>
</s:Envelope>

Soap de Resposta

Este modelo foi gerado por uma ferramenta para mostrar a ordem dos elementos do corpo e do cabeçalho para a resposta SOAP.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <SignupCustomerResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <CustomerId>ValueHere</CustomerId>
      <CustomerNumber d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</CustomerNumber>
      <AccountId d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</AccountId>
      <AccountNumber d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</AccountNumber>
      <CreateTime>ValueHere</CreateTime>
    </SignupCustomerResponse>
  </s:Body>
</s:Envelope>

Sintaxe de Código

A sintaxe de exemplo pode ser utilizada com os SDKs de Anúncios do Bing. Veja Exemplos de Código da API de Anúncios do Bing para obter mais exemplos.

public async Task<SignupCustomerResponse> SignupCustomerAsync(
	Customer customer,
	AdvertiserAccount account,
	long? parentCustomerId,
	UserInvitation userInvitation,
	long? userId,
	User user)
{
	var request = new SignupCustomerRequest
	{
		Customer = customer,
		Account = account,
		ParentCustomerId = parentCustomerId,
		UserInvitation = userInvitation,
		UserId = userId,
		User = user
	};

	return (await CustomerManagementService.CallAsync((s, r) => s.SignupCustomerAsync(r), request));
}

static SignupCustomerResponse signupCustomer(
	Customer customer,
	AdvertiserAccount account,
	java.lang.Long parentCustomerId,
	UserInvitation userInvitation,
	java.lang.Long userId,
	User user) throws RemoteException, Exception
{
	SignupCustomerRequest request = new SignupCustomerRequest();

	request.setCustomer(customer);
	request.setAccount(account);
	request.setParentCustomerId(parentCustomerId);
	request.setUserInvitation(userInvitation);
	request.setUserId(userId);
	request.setUser(user);

	return CustomerManagementService.getService().signupCustomer(request);
}

static function SignupCustomer(
	$customer,
	$account,
	$parentCustomerId,
	$userInvitation,
	$userId,
	$user)
{

	$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];

	$request = new SignupCustomerRequest();

	$request->Customer = $customer;
	$request->Account = $account;
	$request->ParentCustomerId = $parentCustomerId;
	$request->UserInvitation = $userInvitation;
	$request->UserId = $userId;
	$request->User = $user;

	return $GLOBALS['CustomerManagementProxy']->GetService()->SignupCustomer($request);
}

response=customermanagement_service.SignupCustomer(
	Customer=Customer,
	Account=Account,
	ParentCustomerId=ParentCustomerId,
	UserInvitation=UserInvitation,
	UserId=UserId,
	User=User)

Requisitos

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