次の方法で共有

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

  • [アーティクル]

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

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

注:

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

注:

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

注:

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

Request 要素

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

注:

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

要求本文要素

要素 説明 データ型
アカウント 顧客のプライマリ アカウントの詳細を指定する AdvertiserAccount 。

終了した統合スマート キャンペーン パイロットのお客様は、 AccountMode 要素を "UnifiedSmart" に設定する必要があります。		 AdvertiserAccount
顧客 追加する 顧客 の詳細を指定する顧客。 お客様
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:e95="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e95:CustomerFinancialStatus i:nil="false">ValueHere</e95:CustomerFinancialStatus>
        <e95:Id i:nil="false">ValueHere</e95:Id>
        <e95:Industry i:nil="false">ValueHere</e95:Industry>
        <e95:LastModifiedByUserId i:nil="false">ValueHere</e95:LastModifiedByUserId>
        <e95:LastModifiedTime i:nil="false">ValueHere</e95:LastModifiedTime>
        <e95:MarketCountry i:nil="false">ValueHere</e95:MarketCountry>
        <e95:ForwardCompatibilityMap xmlns:e96="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e96:KeyValuePairOfstringstring>
            <e96:key i:nil="false">ValueHere</e96:key>
            <e96:value i:nil="false">ValueHere</e96:value>
          </e96:KeyValuePairOfstringstring>
        </e95:ForwardCompatibilityMap>
        <e95:MarketLanguage i:nil="false">ValueHere</e95:MarketLanguage>
        <e95:Name i:nil="false">ValueHere</e95:Name>
        <e95:ServiceLevel i:nil="false">ValueHere</e95:ServiceLevel>
        <e95:CustomerLifeCycleStatus i:nil="false">ValueHere</e95:CustomerLifeCycleStatus>
        <e95:TimeStamp i:nil="false">ValueHere</e95:TimeStamp>
        <e95:Number i:nil="false">ValueHere</e95:Number>
        <e95:CustomerAddress i:nil="false">
          <e95:City i:nil="false">ValueHere</e95:City>
          <e95:CountryCode i:nil="false">ValueHere</e95:CountryCode>
          <e95:Id i:nil="false">ValueHere</e95:Id>
          <e95:Line1 i:nil="false">ValueHere</e95:Line1>
          <e95:Line2 i:nil="false">ValueHere</e95:Line2>
          <e95:Line3 i:nil="false">ValueHere</e95:Line3>
          <e95:Line4 i:nil="false">ValueHere</e95:Line4>
          <e95:PostalCode i:nil="false">ValueHere</e95:PostalCode>
          <e95:StateOrProvince i:nil="false">ValueHere</e95:StateOrProvince>
          <e95:TimeStamp i:nil="false">ValueHere</e95:TimeStamp>
          <e95:BusinessName i:nil="false">ValueHere</e95:BusinessName>
        </e95:CustomerAddress>
      </Customer>
      <Account xmlns:e97="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e97:BillToCustomerId i:nil="false">ValueHere</e97:BillToCustomerId>
        <e97:CurrencyCode i:nil="false">ValueHere</e97:CurrencyCode>
        <e97:AccountFinancialStatus i:nil="false">ValueHere</e97:AccountFinancialStatus>
        <e97:Id i:nil="false">ValueHere</e97:Id>
        <e97:Language i:nil="false">ValueHere</e97:Language>
        <e97:LastModifiedByUserId i:nil="false">ValueHere</e97:LastModifiedByUserId>
        <e97:LastModifiedTime i:nil="false">ValueHere</e97:LastModifiedTime>
        <e97:Name i:nil="false">ValueHere</e97:Name>
        <e97:Number i:nil="false">ValueHere</e97:Number>
        <e97:ParentCustomerId>ValueHere</e97:ParentCustomerId>
        <e97:PaymentMethodId i:nil="false">ValueHere</e97:PaymentMethodId>
        <e97:PaymentMethodType i:nil="false">ValueHere</e97:PaymentMethodType>
        <e97:PrimaryUserId i:nil="false">ValueHere</e97:PrimaryUserId>
        <e97:AccountLifeCycleStatus i:nil="false">ValueHere</e97:AccountLifeCycleStatus>
        <e97:TimeStamp i:nil="false">ValueHere</e97:TimeStamp>
        <e97:TimeZone i:nil="false">ValueHere</e97:TimeZone>
        <e97:PauseReason i:nil="false">ValueHere</e97:PauseReason>
        <e97:ForwardCompatibilityMap xmlns:e98="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e98:KeyValuePairOfstringstring>
            <e98:key i:nil="false">ValueHere</e98:key>
            <e98:value i:nil="false">ValueHere</e98:value>
          </e98:KeyValuePairOfstringstring>
        </e97:ForwardCompatibilityMap>
        <e97:LinkedAgencies i:nil="false">
          <e97:CustomerInfo>
            <e97:Id i:nil="false">ValueHere</e97:Id>
            <e97:Name i:nil="false">ValueHere</e97:Name>
          </e97:CustomerInfo>
        </e97:LinkedAgencies>
        <e97:SalesHouseCustomerId i:nil="false">ValueHere</e97:SalesHouseCustomerId>
        <e97:TaxInformation xmlns:e99="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e99:KeyValuePairOfstringstring>
            <e99:key i:nil="false">ValueHere</e99:key>
            <e99:value i:nil="false">ValueHere</e99:value>
          </e99:KeyValuePairOfstringstring>
        </e97:TaxInformation>
        <e97:BackUpPaymentInstrumentId i:nil="false">ValueHere</e97:BackUpPaymentInstrumentId>
        <e97:BillingThresholdAmount i:nil="false">ValueHere</e97:BillingThresholdAmount>
        <e97:BusinessAddress i:nil="false">
          <e97:City i:nil="false">ValueHere</e97:City>
          <e97:CountryCode i:nil="false">ValueHere</e97:CountryCode>
          <e97:Id i:nil="false">ValueHere</e97:Id>
          <e97:Line1 i:nil="false">ValueHere</e97:Line1>
          <e97:Line2 i:nil="false">ValueHere</e97:Line2>
          <e97:Line3 i:nil="false">ValueHere</e97:Line3>
          <e97:Line4 i:nil="false">ValueHere</e97:Line4>
          <e97:PostalCode i:nil="false">ValueHere</e97:PostalCode>
          <e97:StateOrProvince i:nil="false">ValueHere</e97:StateOrProvince>
          <e97:TimeStamp i:nil="false">ValueHere</e97:TimeStamp>
          <e97:BusinessName i:nil="false">ValueHere</e97:BusinessName>
        </e97:BusinessAddress>
        <e97:AutoTagType i:nil="false">ValueHere</e97:AutoTagType>
        <e97:SoldToPaymentInstrumentId i:nil="false">ValueHere</e97:SoldToPaymentInstrumentId>
        <e97:TaxCertificate i:nil="false">
          <e97:TaxCertificateBlobContainerName i:nil="false">ValueHere</e97:TaxCertificateBlobContainerName>
          <e97:TaxCertificates xmlns:e100="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
            <e100:KeyValuePairOfstringbase64Binary>
              <e100:key i:nil="false">ValueHere</e100:key>
              <e100:value i:nil="false">ValueHere</e100:value>
            </e100:KeyValuePairOfstringbase64Binary>
          </e97:TaxCertificates>
          <e97:Status i:nil="false">ValueHere</e97:Status>
        </e97:TaxCertificate>
        <e97:AccountMode i:nil="false">ValueHere</e97:AccountMode>
      </Account>
      <ParentCustomerId i:nil="false">ValueHere</ParentCustomerId>
      <UserInvitation xmlns:e101="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e101:Id>ValueHere</e101:Id>
        <e101:FirstName i:nil="false">ValueHere</e101:FirstName>
        <e101:LastName i:nil="false">ValueHere</e101:LastName>
        <e101:Email i:nil="false">ValueHere</e101:Email>
        <e101:CustomerId>ValueHere</e101:CustomerId>
        <e101:RoleId>ValueHere</e101:RoleId>
        <e101:AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </e101:AccountIds>
        <e101:ExpirationDate>ValueHere</e101:ExpirationDate>
        <e101:Lcid>ValueHere</e101:Lcid>
      </UserInvitation>
      <UserId i:nil="false">ValueHere</UserId>
      <User xmlns:e102="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e102:ContactInfo i:nil="false">
          <e102:Address i:nil="false">
            <e102:City i:nil="false">ValueHere</e102:City>
            <e102:CountryCode i:nil="false">ValueHere</e102:CountryCode>
            <e102:Id i:nil="false">ValueHere</e102:Id>
            <e102:Line1 i:nil="false">ValueHere</e102:Line1>
            <e102:Line2 i:nil="false">ValueHere</e102:Line2>
            <e102:Line3 i:nil="false">ValueHere</e102:Line3>
            <e102:Line4 i:nil="false">ValueHere</e102:Line4>
            <e102:PostalCode i:nil="false">ValueHere</e102:PostalCode>
            <e102:StateOrProvince i:nil="false">ValueHere</e102:StateOrProvince>
            <e102:TimeStamp i:nil="false">ValueHere</e102:TimeStamp>
            <e102:BusinessName i:nil="false">ValueHere</e102:BusinessName>
          </e102:Address>
          <e102:ContactByPhone i:nil="false">ValueHere</e102:ContactByPhone>
          <e102:ContactByPostalMail i:nil="false">ValueHere</e102:ContactByPostalMail>
          <e102:Email i:nil="false">ValueHere</e102:Email>
          <e102:EmailFormat i:nil="false">ValueHere</e102:EmailFormat>
          <e102:Fax i:nil="false">ValueHere</e102:Fax>
          <e102:HomePhone i:nil="false">ValueHere</e102:HomePhone>
          <e102:Id i:nil="false">ValueHere</e102:Id>
          <e102:Mobile i:nil="false">ValueHere</e102:Mobile>
          <e102:Phone1 i:nil="false">ValueHere</e102:Phone1>
          <e102:Phone2 i:nil="false">ValueHere</e102:Phone2>
        </e102:ContactInfo>
        <e102:CustomerId i:nil="false">ValueHere</e102:CustomerId>
        <e102:Id i:nil="false">ValueHere</e102:Id>
        <e102:JobTitle i:nil="false">ValueHere</e102:JobTitle>
        <e102:LastModifiedByUserId i:nil="false">ValueHere</e102:LastModifiedByUserId>
        <e102:LastModifiedTime i:nil="false">ValueHere</e102:LastModifiedTime>
        <e102:Lcid i:nil="false">ValueHere</e102:Lcid>
        <e102:Name i:nil="false">
          <e102:FirstName i:nil="false">ValueHere</e102:FirstName>
          <e102:LastName i:nil="false">ValueHere</e102:LastName>
          <e102:MiddleInitial i:nil="false">ValueHere</e102:MiddleInitial>
        </e102:Name>
        <e102:Password i:nil="false">ValueHere</e102:Password>
        <e102:SecretAnswer i:nil="false">ValueHere</e102:SecretAnswer>
        <e102:SecretQuestion>ValueHere</e102:SecretQuestion>
        <e102:UserLifeCycleStatus i:nil="false">ValueHere</e102:UserLifeCycleStatus>
        <e102:TimeStamp i:nil="false">ValueHere</e102:TimeStamp>
        <e102:UserName i:nil="false">ValueHere</e102:UserName>
        <e102:ForwardCompatibilityMap xmlns:e103="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e103:KeyValuePairOfstringstring>
            <e103:key i:nil="false">ValueHere</e103:key>
            <e103:value i:nil="false">ValueHere</e103:value>
          </e103:KeyValuePairOfstringstring>
        </e102:ForwardCompatibilityMap>
        <e102:AuthenticationToken i:nil="false">ValueHere</e102: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

要求 URL

https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13/Customer/Signup

Request 要素

SignupCustomerRequest オブジェクトは、サービス操作要求の本文要素とヘッダー要素を定義します。

注:

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

要求本文要素

要素 説明 データ型
アカウント 顧客のプライマリ アカウントの詳細を指定する AdvertiserAccount 。

終了した統合スマート キャンペーン パイロットのお客様は、 AccountMode 要素を "UnifiedSmart" に設定する必要があります。		 AdvertiserAccount
顧客 追加する 顧客 の詳細を指定する顧客。 お客様
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

要求ヘッダー要素

要素 説明 データ型
Authorization Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセス トークン。 トークンのプレフィックスに "Bearer" があることを確認してください。これは、適切な認証に必要です。

詳細については、「 OAuth による認証」を参照してください。		 string
DeveloperToken Bing Ads API へのアクセスに使用される開発者トークン。

詳細については、「 開発者トークンを取得する」を参照してください。		 string
Password この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 string
UserName この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 string

Response 要素

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

応答本文の要素

要素 説明 データ型
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

JSON を要求する

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

{
  "Customer": {
    "CustomerAddress": {
      "BusinessName": "ValueHere",
      "City": "ValueHere",
      "CountryCode": "ValueHere",
      "Id": "LongValueHere",
      "Line1": "ValueHere",
      "Line2": "ValueHere",
      "Line3": "ValueHere",
      "Line4": "ValueHere",
      "PostalCode": "ValueHere",
      "StateOrProvince": "ValueHere",
      "TimeStamp": "ValueHere"
    },
    "CustomerFinancialStatus": "ValueHere",
    "CustomerLifeCycleStatus": "ValueHere",
    "ForwardCompatibilityMap": [
      {
        "key": "ValueHere",
        "value": "ValueHere"
      }
    ],
    "Id": "LongValueHere",
    "Industry": "ValueHere",
    "LastModifiedByUserId": "LongValueHere",
    "LastModifiedTime": "ValueHere",
    "MarketCountry": "ValueHere",
    "MarketLanguage": "ValueHere",
    "Name": "ValueHere",
    "Number": "ValueHere",
    "ServiceLevel": "ValueHere",
    "TimeStamp": "ValueHere"
  },
  "Account": {
    "AccountFinancialStatus": "ValueHere",
    "AccountLifeCycleStatus": "ValueHere",
    "AccountMode": "ValueHere",
    "AutoTagType": "ValueHere",
    "BackUpPaymentInstrumentId": "LongValueHere",
    "BillingThresholdAmount": DecimalValueHere,
    "BillToCustomerId": "LongValueHere",
    "BusinessAddress": {
      "BusinessName": "ValueHere",
      "City": "ValueHere",
      "CountryCode": "ValueHere",
      "Id": "LongValueHere",
      "Line1": "ValueHere",
      "Line2": "ValueHere",
      "Line3": "ValueHere",
      "Line4": "ValueHere",
      "PostalCode": "ValueHere",
      "StateOrProvince": "ValueHere",
      "TimeStamp": "ValueHere"
    },
    "CurrencyCode": "ValueHere",
    "ForwardCompatibilityMap": [
      {
        "key": "ValueHere",
        "value": "ValueHere"
      }
    ],
    "Id": "LongValueHere",
    "Language": "ValueHere",
    "LastModifiedByUserId": "LongValueHere",
    "LastModifiedTime": "ValueHere",
    "LinkedAgencies": [
      {
        "Id": "LongValueHere",
        "Name": "ValueHere"
      }
    ],
    "Name": "ValueHere",
    "Number": "ValueHere",
    "ParentCustomerId": "LongValueHere",
    "PauseReason": "ValueHere",
    "PaymentMethodId": "LongValueHere",
    "PaymentMethodType": "ValueHere",
    "PrimaryUserId": "LongValueHere",
    "SalesHouseCustomerId": "LongValueHere",
    "SoldToPaymentInstrumentId": "LongValueHere",
    "TaxCertificate": {
      "Status": "ValueHere",
      "TaxCertificateBlobContainerName": "ValueHere",
      "TaxCertificates": [
        {
          "key": "ValueHere",
          "value": "ValueHere"
        }
      ]
    },
    "TaxInformation": [
      {
        "key": "ValueHere",
        "value": "ValueHere"
      }
    ],
    "TimeStamp": "ValueHere",
    "TimeZone": "ValueHere"
  },
  "ParentCustomerId": "LongValueHere",
  "UserInvitation": {
    "AccountIds": [
      "LongValueHere"
    ],
    "CustomerId": "LongValueHere",
    "Email": "ValueHere",
    "ExpirationDate": "ValueHere",
    "FirstName": "ValueHere",
    "Id": "LongValueHere",
    "LastName": "ValueHere",
    "Lcid": "ValueHere",
    "RoleId": IntValueHere
  },
  "UserId": "LongValueHere",
  "User": {
    "AuthenticationToken": "ValueHere",
    "ContactInfo": {
      "Address": {
        "BusinessName": "ValueHere",
        "City": "ValueHere",
        "CountryCode": "ValueHere",
        "Id": "LongValueHere",
        "Line1": "ValueHere",
        "Line2": "ValueHere",
        "Line3": "ValueHere",
        "Line4": "ValueHere",
        "PostalCode": "ValueHere",
        "StateOrProvince": "ValueHere",
        "TimeStamp": "ValueHere"
      },
      "ContactByPhone": "ValueHere",
      "ContactByPostalMail": "ValueHere",
      "Email": "ValueHere",
      "EmailFormat": "ValueHere",
      "Fax": "ValueHere",
      "HomePhone": "ValueHere",
      "Id": "LongValueHere",
      "Mobile": "ValueHere",
      "Phone1": "ValueHere",
      "Phone2": "ValueHere"
    },
    "CustomerId": "LongValueHere",
    "ForwardCompatibilityMap": [
      {
        "key": "ValueHere",
        "value": "ValueHere"
      }
    ],
    "Id": "LongValueHere",
    "JobTitle": "ValueHere",
    "LastModifiedByUserId": "LongValueHere",
    "LastModifiedTime": "ValueHere",
    "Lcid": "ValueHere",
    "Name": {
      "FirstName": "ValueHere",
      "LastName": "ValueHere",
      "MiddleInitial": "ValueHere"
    },
    "Password": "ValueHere",
    "SecretAnswer": "ValueHere",
    "SecretQuestion": "ValueHere",
    "TimeStamp": "ValueHere",
    "UserLifeCycleStatus": "ValueHere",
    "UserName": "ValueHere"
  }
}

応答 JSON

このテンプレートは、JSON 応答の 本文 と ヘッダー 要素を表示するツールによって生成されました。

{
  "CustomerId": "LongValueHere",
  "CustomerNumber": "ValueHere",
  "AccountId": "LongValueHere",
  "AccountNumber": "ValueHere",
  "CreateTime": "ValueHere"
}

コード構文

SDK を使用して REST API を呼び出すには、SDK を特定のバージョンにアップグレードし、システム パラメーターを構成する必要があります。構文の例は、 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)