Operación de servicio SignupCustomer: Administración de clientes

Crea un nuevo cliente y una cuenta.

Normalmente, debe ser un usuario con credenciales de agregador para llamar a esta operación. En ese caso, la operación crea un nuevo cliente y una cuenta que se acumulan en el método de pago del agregador. El objeto AdvertiserAccount debe incluir el nombre de la cuenta, el tipo de moneda que se usará para liquidar la cuenta y el identificador del método de pago debe establecerse en null. La operación genera una cuenta de factura y establece el identificador del método de pago en el identificador asociado a la factura del agregador. Se le facturan todos los cargos incurridos por los clientes que administra.

Nota:

Los clientes de la agencia en el proyecto piloto Crear cuentas en nombre del cliente (GetCustomerPilotFeatures devuelve 793) pueden registrarse en un nuevo cliente en nombre de un cliente y, opcionalmente, vincularse a la nueva cuenta como una agencia. En este caso, se envía una userInvitation y el cliente debe completar los pasos de registro a través de la interfaz de usuario de Microsoft Advertising, como aceptar los términos y condiciones.

Nota:

Los clientes del piloto de campañas inteligentes unificadas cerradas pueden registrarse en un nuevo cliente con una cuenta para las campañas inteligentes unificadas. Opcionalmente, pueden vincularse a la nueva cuenta como una agencia. El superadministrador se aprovisiona estableciendo el elemento UserId o UserInvitation .

Nota:

Los clientes de la cuenta de cliente configurada sin problemas y el piloto de PI pueden registrar un nuevo cliente con una cuenta y crear un usuario administrador simultáneamente. El usuario administrador se aprovisiona estableciendo el elemento User . Y el cliente debe completar los pasos de registro a través de la interfaz de usuario de Microsoft Advertising en la página activando el cliente de Microsoft Advertising.

Elementos Request

El objeto SignupCustomerRequest define los elementos body y header de la solicitud de operación de servicio. Los elementos deben estar en el mismo orden que se muestra en la solicitud SOAP.

Nota:

A menos que se indique lo contrario a continuación, se requieren todos los elementos de solicitud.

Elementos del cuerpo de la solicitud

Elemento	Descripción	Tipo de datos
Cuenta	Una advertiseraccount que especifica los detalles de la cuenta principal del cliente. Los clientes de la prueba piloto de campañas inteligentes unificadas cerradas deben establecer el elemento AccountMode en "UnifiedSmart".	AdvertiserAccount
Clientes	Un cliente que especifica los detalles del cliente que va a agregar.	Cliente
ParentCustomerId	Identificador de cliente del agregador o la agencia que administrará el nuevo cliente secundario. Este elemento es necesario para los agregadores, pero se omite para las agencias cuando se establece el elemento de solicitud UserInvitation . Los clientes del piloto de campañas inteligentes unificadas cerradas pueden vincular al nuevo cliente con el identificador de la agencia primaria o dejar este elemento vacío.	Largo
User	El usuario que se va a crear. Puede cumplir este elemento si desea registrarse en un nuevo cliente y crear un nuevo usuario administrador simultáneamente. Una vez registrado el nuevo cliente, el usuario administrador recién creado debe completar los pasos de registro a través de la interfaz de usuario de Microsoft Advertising en la página de cliente activando Microsoft Advertising. La dirección URL es https://ads.microsoft.com/ActivateCustomer?cid={new_customer_Id}& aid={new_account_Id} donde new_customer_Id y new_account_Id son los identificadores que se obtienen en SignupCustomerResponse. AuthenticationToken en el elemento User es el token de acceso de OAuth que representa las credenciales del nuevo usuario administrador que se creará durante la suscripción. Los clientes de la cuenta de cliente y pi piloto de configuración sin problemas deben establecer uno o varios userid , userinvitation o user. Los campos necesarios del objeto User son ContactInfo.Email, Name.FirstName, Name.LastName y AuthenticationToken.	Usuario
UserId	Identificador de un usuario existente que se agregará como Super Administración en el nuevo cliente. Este elemento solo está disponible para los clientes en el piloto de campañas inteligentes unificadas cerradas. Se debe establecer uno o varios elementos UserId o UserInvitation .	Largo
UserInvitation	La invitación de usuario que se va a enviar si desea registrar un nuevo cliente en nombre de un cliente y, opcionalmente, vincular a la nueva cuenta como una agencia. Un usuario de Super Administración cliente debe completar los pasos de registro a través de la interfaz de usuario de Microsoft Advertising, como aceptar los términos y condiciones. Este elemento es opcional para los clientes de la agencia en la prueba piloto Crear cuentas en nombre del cliente. Los clientes de la prueba piloto de campañas inteligentes unificadas cerradas deben establecer uno o varios de los elementos UserId o UserInvitation .	UserInvitation

Elementos de encabezado de solicitud

Elemento	Descripción	Tipo de datos
AuthenticationToken	Token de acceso de OAuth que representa las credenciales de un usuario que tiene permisos para cuentas de Microsoft Advertising. Para obtener más información, consulte Autenticación con OAuth.	string
DeveloperToken	Token de desarrollador que se usa para acceder a Bing Ads API. Para obtener más información, consulte Obtención de un token de desarrollador.	string
Password	Este elemento está reservado para uso interno y se quitará de una versión futura de la API. Debe usar el elemento AuthenticationToken para establecer las credenciales de usuario.	string
UserName	Este elemento está reservado para uso interno y se quitará de una versión futura de la API. Debe usar el elemento AuthenticationToken para establecer las credenciales de usuario.	string

Elementos de respuesta

El objeto SignupCustomerResponse define los elementos body y header de la respuesta de la operación de servicio. Los elementos se devuelven en el mismo orden que se muestra en soap de respuesta.

Elementos del cuerpo de la respuesta

Elemento	Descripción	Tipo de datos
AccountId	Identificador de cuenta generado por el sistema correspondiente a la nueva cuenta especificada en la solicitud. Use este identificador con solicitudes de operación que requieran un elemento de cuerpo AccountId y un elemento de encabezado SOAP CustomerAccountId .	Largo
AccountNumber	Número de cuenta generado por el sistema que se usa para identificar la cuenta en la aplicación web de Microsoft Advertising. El número de cuenta tiene el formato xxxxxxxx, donde xxxxxxxx es una serie de ocho caracteres alfanuméricos.	string
CreateTime	Fecha y hora en que se agregó la cuenta. El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.	dateTime
Customerid	Identificador de cliente generado por el sistema correspondiente al nuevo cliente especificado en la solicitud. Use este identificador con solicitudes de operación que requieran un elemento de encabezado SOAP CustomerId .	Largo
CustomerNumber	Número de cliente generado por el sistema que se usa en la aplicación web de Microsoft Advertising. El número de cliente tiene el formato xxxxxxxxxx, donde xxxxxxxxxx es una serie de diez caracteres alfanuméricos.	string

Elementos de encabezado de respuesta

Elemento	Descripción	Tipo de datos
Seguimiento del Id.	Identificador de la entrada de registro que contiene los detalles de la llamada API.	string

Solicitud de SOAP

Esta plantilla se generó mediante una herramienta para mostrar el orden del cuerpo y los elementos de encabezado de la solicitud SOAP. Para ver los tipos admitidos que puede usar con esta operación de servicio, consulte la referencia de elementos de cuerpo de solicitud anterior.

<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:e252="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e252:CustomerFinancialStatus i:nil="false">ValueHere</e252:CustomerFinancialStatus>
        <e252:Id i:nil="false">ValueHere</e252:Id>
        <e252:Industry i:nil="false">ValueHere</e252:Industry>
        <e252:LastModifiedByUserId i:nil="false">ValueHere</e252:LastModifiedByUserId>
        <e252:LastModifiedTime i:nil="false">ValueHere</e252:LastModifiedTime>
        <e252:MarketCountry i:nil="false">ValueHere</e252:MarketCountry>
        <e252:ForwardCompatibilityMap xmlns:e253="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e253:KeyValuePairOfstringstring>
            <e253:key i:nil="false">ValueHere</e253:key>
            <e253:value i:nil="false">ValueHere</e253:value>
          </e253:KeyValuePairOfstringstring>
        </e252:ForwardCompatibilityMap>
        <e252:MarketLanguage i:nil="false">ValueHere</e252:MarketLanguage>
        <e252:Name i:nil="false">ValueHere</e252:Name>
        <e252:ServiceLevel i:nil="false">ValueHere</e252:ServiceLevel>
        <e252:CustomerLifeCycleStatus i:nil="false">ValueHere</e252:CustomerLifeCycleStatus>
        <e252:TimeStamp i:nil="false">ValueHere</e252:TimeStamp>
        <e252:Number i:nil="false">ValueHere</e252:Number>
        <e252:CustomerAddress i:nil="false">
          <e252:City i:nil="false">ValueHere</e252:City>
          <e252:CountryCode i:nil="false">ValueHere</e252:CountryCode>
          <e252:Id i:nil="false">ValueHere</e252:Id>
          <e252:Line1 i:nil="false">ValueHere</e252:Line1>
          <e252:Line2 i:nil="false">ValueHere</e252:Line2>
          <e252:Line3 i:nil="false">ValueHere</e252:Line3>
          <e252:Line4 i:nil="false">ValueHere</e252:Line4>
          <e252:PostalCode i:nil="false">ValueHere</e252:PostalCode>
          <e252:StateOrProvince i:nil="false">ValueHere</e252:StateOrProvince>
          <e252:TimeStamp i:nil="false">ValueHere</e252:TimeStamp>
          <e252:BusinessName i:nil="false">ValueHere</e252:BusinessName>
        </e252:CustomerAddress>
      </Customer>
      <Account xmlns:e254="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e254:BillToCustomerId i:nil="false">ValueHere</e254:BillToCustomerId>
        <e254:CurrencyCode i:nil="false">ValueHere</e254:CurrencyCode>
        <e254:AccountFinancialStatus i:nil="false">ValueHere</e254:AccountFinancialStatus>
        <e254:Id i:nil="false">ValueHere</e254:Id>
        <e254:Language i:nil="false">ValueHere</e254:Language>
        <e254:LastModifiedByUserId i:nil="false">ValueHere</e254:LastModifiedByUserId>
        <e254:LastModifiedTime i:nil="false">ValueHere</e254:LastModifiedTime>
        <e254:Name i:nil="false">ValueHere</e254:Name>
        <e254:Number i:nil="false">ValueHere</e254:Number>
        <e254:ParentCustomerId>ValueHere</e254:ParentCustomerId>
        <e254:PaymentMethodId i:nil="false">ValueHere</e254:PaymentMethodId>
        <e254:PaymentMethodType i:nil="false">ValueHere</e254:PaymentMethodType>
        <e254:PrimaryUserId i:nil="false">ValueHere</e254:PrimaryUserId>
        <e254:AccountLifeCycleStatus i:nil="false">ValueHere</e254:AccountLifeCycleStatus>
        <e254:TimeStamp i:nil="false">ValueHere</e254:TimeStamp>
        <e254:TimeZone i:nil="false">ValueHere</e254:TimeZone>
        <e254:PauseReason i:nil="false">ValueHere</e254:PauseReason>
        <e254:ForwardCompatibilityMap xmlns:e255="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e255:KeyValuePairOfstringstring>
            <e255:key i:nil="false">ValueHere</e255:key>
            <e255:value i:nil="false">ValueHere</e255:value>
          </e255:KeyValuePairOfstringstring>
        </e254:ForwardCompatibilityMap>
        <e254:LinkedAgencies i:nil="false">
          <e254:CustomerInfo>
            <e254:Id i:nil="false">ValueHere</e254:Id>
            <e254:Name i:nil="false">ValueHere</e254:Name>
          </e254:CustomerInfo>
        </e254:LinkedAgencies>
        <e254:SalesHouseCustomerId i:nil="false">ValueHere</e254:SalesHouseCustomerId>
        <e254:TaxInformation xmlns:e256="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e256:KeyValuePairOfstringstring>
            <e256:key i:nil="false">ValueHere</e256:key>
            <e256:value i:nil="false">ValueHere</e256:value>
          </e256:KeyValuePairOfstringstring>
        </e254:TaxInformation>
        <e254:BackUpPaymentInstrumentId i:nil="false">ValueHere</e254:BackUpPaymentInstrumentId>
        <e254:BillingThresholdAmount i:nil="false">ValueHere</e254:BillingThresholdAmount>
        <e254:BusinessAddress i:nil="false">
          <e254:City i:nil="false">ValueHere</e254:City>
          <e254:CountryCode i:nil="false">ValueHere</e254:CountryCode>
          <e254:Id i:nil="false">ValueHere</e254:Id>
          <e254:Line1 i:nil="false">ValueHere</e254:Line1>
          <e254:Line2 i:nil="false">ValueHere</e254:Line2>
          <e254:Line3 i:nil="false">ValueHere</e254:Line3>
          <e254:Line4 i:nil="false">ValueHere</e254:Line4>
          <e254:PostalCode i:nil="false">ValueHere</e254:PostalCode>
          <e254:StateOrProvince i:nil="false">ValueHere</e254:StateOrProvince>
          <e254:TimeStamp i:nil="false">ValueHere</e254:TimeStamp>
          <e254:BusinessName i:nil="false">ValueHere</e254:BusinessName>
        </e254:BusinessAddress>
        <e254:AutoTagType i:nil="false">ValueHere</e254:AutoTagType>
        <e254:SoldToPaymentInstrumentId i:nil="false">ValueHere</e254:SoldToPaymentInstrumentId>
        <e254:TaxCertificate i:nil="false">
          <e254:TaxCertificateBlobContainerName i:nil="false">ValueHere</e254:TaxCertificateBlobContainerName>
          <e254:TaxCertificates xmlns:e257="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
            <e257:KeyValuePairOfstringbase64Binary>
              <e257:key i:nil="false">ValueHere</e257:key>
              <e257:value i:nil="false">ValueHere</e257:value>
            </e257:KeyValuePairOfstringbase64Binary>
          </e254:TaxCertificates>
          <e254:Status i:nil="false">ValueHere</e254:Status>
        </e254:TaxCertificate>
        <e254:AccountMode i:nil="false">ValueHere</e254:AccountMode>
      </Account>
      <ParentCustomerId i:nil="false">ValueHere</ParentCustomerId>
      <UserInvitation xmlns:e258="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e258:Id>ValueHere</e258:Id>
        <e258:FirstName i:nil="false">ValueHere</e258:FirstName>
        <e258:LastName i:nil="false">ValueHere</e258:LastName>
        <e258:Email i:nil="false">ValueHere</e258:Email>
        <e258:CustomerId>ValueHere</e258:CustomerId>
        <e258:RoleId>ValueHere</e258:RoleId>
        <e258:AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </e258:AccountIds>
        <e258:ExpirationDate>ValueHere</e258:ExpirationDate>
        <e258:Lcid>ValueHere</e258:Lcid>
      </UserInvitation>
      <UserId i:nil="false">ValueHere</UserId>
      <User xmlns:e259="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e259:ContactInfo i:nil="false">
          <e259:Address i:nil="false">
            <e259:City i:nil="false">ValueHere</e259:City>
            <e259:CountryCode i:nil="false">ValueHere</e259:CountryCode>
            <e259:Id i:nil="false">ValueHere</e259:Id>
            <e259:Line1 i:nil="false">ValueHere</e259:Line1>
            <e259:Line2 i:nil="false">ValueHere</e259:Line2>
            <e259:Line3 i:nil="false">ValueHere</e259:Line3>
            <e259:Line4 i:nil="false">ValueHere</e259:Line4>
            <e259:PostalCode i:nil="false">ValueHere</e259:PostalCode>
            <e259:StateOrProvince i:nil="false">ValueHere</e259:StateOrProvince>
            <e259:TimeStamp i:nil="false">ValueHere</e259:TimeStamp>
            <e259:BusinessName i:nil="false">ValueHere</e259:BusinessName>
          </e259:Address>
          <e259:ContactByPhone i:nil="false">ValueHere</e259:ContactByPhone>
          <e259:ContactByPostalMail i:nil="false">ValueHere</e259:ContactByPostalMail>
          <e259:Email i:nil="false">ValueHere</e259:Email>
          <e259:EmailFormat i:nil="false">ValueHere</e259:EmailFormat>
          <e259:Fax i:nil="false">ValueHere</e259:Fax>
          <e259:HomePhone i:nil="false">ValueHere</e259:HomePhone>
          <e259:Id i:nil="false">ValueHere</e259:Id>
          <e259:Mobile i:nil="false">ValueHere</e259:Mobile>
          <e259:Phone1 i:nil="false">ValueHere</e259:Phone1>
          <e259:Phone2 i:nil="false">ValueHere</e259:Phone2>
        </e259:ContactInfo>
        <e259:CustomerId i:nil="false">ValueHere</e259:CustomerId>
        <e259:Id i:nil="false">ValueHere</e259:Id>
        <e259:JobTitle i:nil="false">ValueHere</e259:JobTitle>
        <e259:LastModifiedByUserId i:nil="false">ValueHere</e259:LastModifiedByUserId>
        <e259:LastModifiedTime i:nil="false">ValueHere</e259:LastModifiedTime>
        <e259:Lcid i:nil="false">ValueHere</e259:Lcid>
        <e259:Name i:nil="false">
          <e259:FirstName i:nil="false">ValueHere</e259:FirstName>
          <e259:LastName i:nil="false">ValueHere</e259:LastName>
          <e259:MiddleInitial i:nil="false">ValueHere</e259:MiddleInitial>
        </e259:Name>
        <e259:Password i:nil="false">ValueHere</e259:Password>
        <e259:SecretAnswer i:nil="false">ValueHere</e259:SecretAnswer>
        <e259:SecretQuestion>ValueHere</e259:SecretQuestion>
        <e259:UserLifeCycleStatus i:nil="false">ValueHere</e259:UserLifeCycleStatus>
        <e259:TimeStamp i:nil="false">ValueHere</e259:TimeStamp>
        <e259:UserName i:nil="false">ValueHere</e259:UserName>
        <e259:ForwardCompatibilityMap xmlns:e260="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e260:KeyValuePairOfstringstring>
            <e260:key i:nil="false">ValueHere</e260:key>
            <e260:value i:nil="false">ValueHere</e260:value>
          </e260:KeyValuePairOfstringstring>
        </e259:ForwardCompatibilityMap>
        <e259:AuthenticationToken i:nil="false">ValueHere</e259:AuthenticationToken>
      </User>
    </SignupCustomerRequest>
  </s:Body>
</s:Envelope>

SOAP de respuesta

Esta plantilla se generó mediante una herramienta para mostrar el orden de los elementos body y header para la respuesta 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>

Sintaxis de código

La sintaxis de ejemplo se puede usar con los SDK de Bing Ads. Consulte Ejemplos de código de API de Bing Ads para obtener más ejemplos.

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

Servicio: CustomerManagementService.svc v13
Nombres: https://bingads.microsoft.com/Customer/v13