Opération de service SignupCustomer - Gestion des clients

Article
12/21/2023

Crée un client et un compte.

En règle générale, vous devez être un utilisateur disposant d’informations d’identification d’agrégateur pour appeler cette opération. Dans ce cas, l’opération crée un client et un compte qui sont cumulables sur votre mode de paiement agrégateur. L’objet AdvertiserAccount doit inclure le nom du compte, le type de devise à utiliser pour régler le compte et l’identificateur du mode de paiement doit avoir la valeur Null. L’opération génère un compte de facture et définit l’identificateur du mode de paiement sur l’identificateur associé à la facture de l’agrégateur. Vous êtes facturé pour tous les frais encourus par les clients que vous gérez.

Remarque

Les clients de l’agence dans le pilote Créer des comptes pour le compte du client (GetCustomerPilotFeatures renvoie la valeur 793) peuvent inscrire un nouveau client au nom d’un client et éventuellement créer un lien vers le nouveau compte en tant qu’agence. Dans ce cas, un UserInvitation est envoyé et le client doit effectuer les étapes d’inscription via l’interface utilisateur Microsoft Advertising, par exemple accepter les conditions générales.

Remarque

Les clients du pilote de campagnes intelligentes unifiées fermées peuvent inscrire un nouveau client avec un compte pour les campagnes intelligentes unifiées. Si vous le souhaitez, ils peuvent établir un lien vers le nouveau compte en tant qu’agence. Le super administrateur est approvisionné en définissant l’élément UserId ou UserInvitation .

Remarque

Les clients du compte client et du pilote PI configurés de manière transparente peuvent inscrire un nouveau client avec un compte et créer un utilisateur administrateur simultanément. L’utilisateur administrateur est approvisionné en définissant l’élément User . Et le client doit effectuer les étapes d’inscription via l’interface utilisateur Microsoft Advertising sur la page client d’activation de Microsoft Advertising.

Éléments de demande

L’objet SignupCustomerRequest définit les éléments body et header de la demande d’opération de service. Les éléments doivent être dans le même ordre que celui indiqué dans la requête SOAP.

Remarque

Sauf indication contraire ci-dessous, tous les éléments de requête sont requis.

Éléments du corps de la requête

Élément	Description	Type de données
Compte	Un AdvertiserAccount qui spécifie les détails du compte principal du client. Les clients du pilote de campagnes intelligentes Unifiées fermées doivent définir l’élément AccountMode sur « UnifiedSmart ».	AdvertiserAccount
Client	Client qui spécifie les détails du client que vous ajoutez.	Client
ParentCustomerId	Identificateur du client de l’agrégateur ou de l’agence qui gérera le nouveau client enfant. Cet élément est requis pour les agrégateurs, mais ignoré pour les agences lorsque l’élément de demande UserInvitation est défini. Les clients du pilote de campagnes intelligentes unifiées fermées peuvent lier le nouveau client à l’ID de l’agence parente ou laisser cet élément vide.	Long
Utilisateur	Utilisateur à créer. Vous pouvez remplir cet élément si vous souhaitez inscrire un nouveau client et créer un utilisateur administrateur simultanément. Une fois le nouveau client inscrit, l’utilisateur administrateur nouvellement créé doit effectuer les étapes d’inscription via l’interface utilisateur Microsoft Advertising sur la page client d’activation de Microsoft Advertising. L’URL est https://ads.microsoft.com/ActivateCustomer?cid={new_customer_Id}& aid={new_account_Id} où new_customer_Id et new_account_Id sont les ID que vous obtenez dans signupCustomerResponse. AuthenticationToken dans l’élément User est le jeton d’accès OAuth qui représente les informations d’identification du nouvel utilisateur administrateur qui sera créé lors de l’inscription. Les clients dans le compte client et le pilote PI configurés de manière transparente doivent définir un ou plusieurs des UserId ou UserInvitation ou User. Les champs obligatoires dans l’objet User sont ContactInfo.Email, Name.FirstName, Name.LastName et AuthenticationToken.	Utilisateur
UserId	Identificateur d’un utilisateur existant qui sera ajouté en tant que Super Administration dans le nouveau client. Cet élément est uniquement disponible pour les clients du pilote de campagnes intelligentes unifiées fermées. Un ou plusieurs éléments UserId ou UserInvitation doivent être définis.	Long
UserInvitation	Invitation utilisateur à envoyer si vous souhaitez inscrire un nouveau client pour le compte d’un client et éventuellement créer un lien vers le nouveau compte en tant qu’agence. Un utilisateur Super Administration client doit effectuer les étapes d’inscription via l’interface utilisateur Microsoft Advertising, par exemple accepter les conditions générales. Cet élément est facultatif pour les clients de l’agence dans le pilote Créer des comptes pour le compte du client. Les clients du pilote de campagnes intelligentes unifiées fermées doivent définir un ou plusieurs éléments UserId ou UserInvitation .	UserInvitation

Éléments d’en-tête de requête

Élément	Description	Type de données
AuthenticationToken	Jeton d’accès OAuth qui représente les informations d’identification d’un utilisateur disposant d’autorisations sur les comptes Microsoft Advertising. Pour plus d’informations, consultez Authentification avec OAuth.	chaîne
DeveloperToken	Jeton de développeur utilisé pour accéder à l’API Bing Ads. Pour plus d’informations, consultez Obtenir un jeton de développeur.	chaîne
Mot de passe	Cet élément est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API. Vous devez utiliser l’élément AuthenticationToken pour définir les informations d’identification de l’utilisateur.	chaîne
UserName	Cet élément est réservé à un usage interne et sera supprimé d’une version ultérieure de l’API. Vous devez utiliser l’élément AuthenticationToken pour définir les informations d’identification de l’utilisateur.	chaîne

Éléments Response

L’objet SignupCustomerResponse définit les éléments body et header de la réponse de l’opération de service. Les éléments sont retournés dans le même ordre que celui indiqué dans la réponse SOAP.

Response Body, éléments

Élément	Description	Type de données
AccountId	Identificateur de compte généré par le système correspondant au nouveau compte spécifié dans la demande. Utilisez cet identificateur avec les demandes d’opération qui nécessitent un élément de corps AccountId et un élément d’en-tête SOAP CustomerAccountId .	Long
Numéro de compte	Numéro de compte généré par le système utilisé pour identifier le compte dans l’application web Microsoft Advertising. Le numéro de compte a la forme xxxxxxxx, où xxxxxxxx est une série de huit caractères alphanumériques.	chaîne
CreateTime	Date et heure auxquelles le compte a été ajouté. La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.	dateTime
Customerid	Identificateur de client généré par le système correspondant au nouveau client spécifié dans la demande. Utilisez cet identificateur avec les demandes d’opération qui nécessitent un élément d’en-tête SOAP CustomerId .	Long
CustomerNumber	Numéro de client généré par le système utilisé dans l’application web Microsoft Advertising. Le numéro de client a la forme xxxxxxxxxxxx, où xxxxxxxxxx est une série de dix caractères alphanumériques.	chaîne

Éléments d’en-tête de réponse

Élément	Description	Type de données
TrackingId	Identificateur de l’entrée de journal qui contient les détails de l’appel d’API.	chaîne

Requête SOAP

Ce modèle a été généré par un outil pour afficher l’ordre des éléments body et header pour la requête SOAP. Pour connaître les types pris en charge que vous pouvez utiliser avec cette opération de service, consultez la référence Éléments du corps de la demande ci-dessus.

<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 réponse

Ce modèle a été généré par un outil pour afficher l’ordre des éléments de corps et d’en-tête pour la réponse 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>

Syntaxe du code

L’exemple de syntaxe peut être utilisé avec les Kits de développement logiciel (SDK) Bing Ads. Pour plus d’exemples, consultez Exemples de code de l’API Bing Ads .

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)

Configuration requise

Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13

Opération de service SignupCustomer - Gestion des clients

Éléments de demande

Éléments du corps de la requête

Éléments d’en-tête de requête

Éléments Response

Response Body, éléments

Éléments d’en-tête de réponse

Requête SOAP

Soap de réponse

Syntaxe du code

Configuration requise

Ressources supplémentaires