SignupCustomer サービス操作 - 顧客管理

[アーティクル]
10/04/2023

新しい顧客とアカウントを作成します。

通常、この操作を呼び出すには、アグリゲーター資格情報を持つユーザーである必要があります。その場合、アグリゲーターの支払い方法にロールアップする新しい顧客とアカウントが作成されます。 AdvertiserAccount オブジェクトには、アカウントの名前、アカウントの決済に使用する通貨の種類、支払い方法識別子を null に設定する必要があります。操作によって請求書アカウントが生成され、支払方法識別子がアグリゲーターの請求書に関連付けられている識別子に設定されます。管理している顧客によって発生したすべての料金に対して請求されます。

注:

クライアントの代理でアカウントを作成するパイロット (GetCustomerPilotFeatures が 793 を返す) の代理店のお客様は、クライアントに代わって新しい顧客にサインアップし、必要に応じて新しいアカウントに代理店としてリンクできます。この場合、 UserInvitation が送信され、クライアントは、契約条件に同意するなど、Microsoft Advertising UI を使用してサインアップ手順を完了する必要があります。

注:

終了した統合スマートキャンペーンパイロットのお客様は、統合スマートキャンペーンのアカウントで新しい顧客にサインアップできます。必要に応じて、新しいアカウントに代理店としてリンクできます。スーパー管理者は、 UserId 要素または UserInvitation 要素を設定することによってプロビジョニングされます。

注:

クライアントアカウントと PI パイロットをシームレスに設定した顧客は、アカウントで新しい顧客にサインアップし、同時に管理者ユーザーを作成できます。管理者ユーザーは、 User 要素を設定することによってプロビジョニングされます。また、顧客は、Microsoft Advertising のアクティブ化顧客ページの Microsoft Advertising UI を使用してサインアップ手順を完了する必要があります。

Request 要素

SignupCustomerRequest オブジェクトは、サービス操作要求の本文要素とヘッダー要素を定義します。要素は、要求 SOAP に示されている順序と同じ順序である必要があります。

注:

以下に特に記載がない限り、すべての要求要素が必要です。

要求本文要素

要素	説明	データ型
アカウント	顧客のプライマリアカウントの詳細を指定する AdvertiserAccount 。終了した統合スマートキャンペーンパイロットのお客様は、 AccountMode 要素を "UnifiedSmart" に設定する必要があります。	AdvertiserAccount
Customer	追加する顧客の詳細を指定する顧客。	お客様
ParentCustomerId	新しい子顧客を管理するアグリゲーターまたはエージェンシーの顧客識別子。この要素はアグリゲーターに必要ですが、 UserInvitation 要求要素が設定されている場合、エージェンシーでは無視されます。閉じた統合スマートキャンペーンパイロットの顧客は、新しい顧客を親機関 ID にリンクするか、この要素を空のままにすることができます。	long
User	作成するユーザー。新しい顧客にサインアップし、新しい管理者ユーザーを同時に作成する場合は、この要素を満たすことができます。新しい顧客がサインアップした後、新しく作成された管理者ユーザーは、Microsoft Advertising のアクティブ化顧客ページの Microsoft Advertising UI を使用してサインアップ手順を完了する必要があります。 URL はですhttps://ads.microsoft.com/ActivateCustomer?cid={new_customer_Id}&。aid={new_account_Id} ここで、new_customer_Idとnew_account_Idは SignupCustomerResponse で取得する ID です。 User 要素の AuthenticationToken は、サインアップ時に作成される新しい管理者ユーザーの資格情報を表す OAuth アクセストークンです。クライアントアカウントと PI パイロットをシームレスに設定する顧客は、1 つ以上の UserId または UserInvitation または User を設定する必要があります。 User オブジェクトの必須フィールドは ContactInfo.Email、Name.FirstName、Name.LastName、AuthenticationToken です。	ユーザー
UserId	新しい顧客に Super 管理として追加される既存のユーザーの識別子。この要素は、閉じられた統合スマートキャンペーンのパイロットのお客様にのみ使用できます。 1 つ以上の UserId または UserInvitation 要素を設定する必要があります。	long
UserInvitation	クライアントの代わりに新しい顧客にサインアップし、必要に応じて代理店として新しいアカウントにリンクする場合は、送信するユーザーの招待。クライアント Super 管理ユーザーは、契約条件に同意するなど、Microsoft Advertising UI を使用してサインアップ手順を完了する必要があります。この要素は、クライアントの代理でアカウントを作成するパイロットの代理店のお客様には省略可能です。閉じられた統合スマートキャンペーンのパイロットのお客様は、 UserId または UserInvitation 要素を 1 つ以上設定する必要があります。	UserInvitation

要求ヘッダー要素

要素	説明	データ型
AuthenticationToken	Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセストークン。詳細については、「 OAuth による認証」を参照してください。	string
DeveloperToken	Bing Ads API へのアクセスに使用される開発者トークン。詳細については、「開発者トークンを取得する」を参照してください。	string
Password	この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。	string
UserName	この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。	string

Response 要素

SignupCustomerResponse オブジェクトは、サービス操作応答の本文要素とヘッダー要素を定義します。要素は、応答 SOAP に示されている順序と同じ順序で返されます。

応答本文の要素

要素	説明	データ型
AccountId	要求で指定された新しいアカウントに対応するシステム生成のアカウント識別子。 AccountId 本文要素と CustomerAccountId SOAP ヘッダー要素を必要とする操作要求で、この識別子を使用します。	long
AccountNumber	Microsoft Advertising Web アプリケーションのアカウントを識別するために使用されるシステム生成のアカウント番号。アカウント番号は xxxxxxxx という形式で、 xxxxxxxx は 8 文字の英数字の系列です。	string
CreateTime	アカウントが追加された日付と時刻。日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。日付と時刻の形式については、「プリミティブ XML データ型」の dateTime エントリを参照してください。	dateTime
Customerid	要求で指定された新しい顧客に対応するシステム生成の顧客識別子。この識別子は、 CustomerId SOAP ヘッダー要素を必要とする操作要求で使用します。	long
CustomerNumber	Microsoft Advertising Web アプリケーションで使用されるシステム生成の顧客番号。顧客番号には xxxxxxxxxx という形式があります。ここで、xxxxxxxxxx は任意の 10 文字の英数字の系列です。	string

応答ヘッダー要素

要素	説明	データ型
TrackingId	API 呼び出しの詳細を含むログエントリの識別子。	string

SOAP を要求する

このテンプレートは、SOAP 要求の本文要素とヘッダー要素の順序を示すツールによって生成されました。このサービス操作で使用できるサポートされる型については、上記の要求本文要素のリファレンスを参照してください。

<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

このテンプレートは、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>

コード構文

構文の例は、 Bing広告 SDK で使用できます。その他の例については、「Bing広告 API コードの例」を参照してください。

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)

要件

サービス: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13

次の方法で共有