SignupCustomer 服務作業 - 客戶管理

發行項
01/12/2024

建立新的客戶和帳戶。

一般而言，您必須是具有匯總工具認證的使用者，才能呼叫此作業。在此情況下，作業會建立匯總至匯總工具付款方式的新客戶和帳戶。並必須包含 Account 的名稱、用來結算帳戶的貨幣類型，而且付款方式標識碼必須設定為 Null。作業會產生發票帳戶，並將付款方式標識符設定為與匯總工具發票相關聯的標識碼。系統會針對您所管理的客戶所產生的所有費用向您開立發票。

注意事項

在代表用戶端建立帳戶試驗中建立帳戶的代理商 (GetCustomerPilotFeatures 會傳回 793) 可以代表用戶端註冊新客戶，並選擇性地以代理商身分連結至新帳戶。在此情況下，會傳送 UserInvitation ，而且客戶端必須透過 Microsoft Advertising UI 完成註冊步驟，例如接受條款和條件。

注意事項

在已關閉的整合智慧行銷活動試驗中，客戶可以使用統一智慧營銷活動的帳戶來註冊新客戶。他們也可以選擇性地以機構身分連結至新帳戶。進階系統管理員是藉由設定 UserId 或 UserInvitation 元素來布建。

注意事項

在順暢設定客戶客戶客戶和 PI 試驗中的客戶可以使用帳戶註冊新客戶，並同時建立系統管理員使用者。系統管理員用戶是藉由設定 User 元素來佈建。此外，客戶必須在 Microsoft Advertising 啟用客戶頁面上，透過 Microsoft Advertising UI 完成註冊步驟。

要求專案

SignupCustomerRequest 物件會定義服務作業要求的主體和標頭元素。元素的順序必須與要求SOAP中所示的順序相同。

注意事項

除非下面另有說明，否則所有要求專案都是必要的。

要求本文專案

元素	描述	資料類型
帳戶	指定客戶主要帳戶詳細數據的一個要點。在已關閉的整合智慧營銷活動試驗中，客戶必須將 AccountMode 元素設定為 “UnifiedSmart”。	廣告客戶帳戶
客戶	客戶，指定您要新增之客戶的詳細數據。	客戶
ParentCustomerId	將管理新子客戶之匯總工具或代理商的客戶標識碼。匯總工具需要此元素，但在設定 UserInvitation 要求元素時會忽略機構。在已關閉的整合智慧行銷活動試驗中，客戶可以將新客戶連結至父機構標識符，或將此元素保留空白。	長
使用者	要建立的使用者。如果您想要註冊新客戶，並同時建立新的系統管理員使用者，您可以完成此元素。新客戶註冊之後，新建立的系統管理員用戶必須透過 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 中取得的標識符。 User 元素中的 AuthenticationToken 是 OAuth 存取令牌，代表將在註冊期間建立之新系統管理員用戶的認證。順暢設定客戶客戶客戶和 PI 試驗的客戶必須設定一或多個 UserId 或 UserInvitation 或 User。 User 物件中的必要字段為 ContactInfo.Email、Name.FirstName、Name.LastName 和 AuthenticationToken。	使用者
UserId	將在新客戶中新增為超級管理員的現有使用者識別碼。此元素僅適用於已關閉的整合智慧行銷活動試驗中的客戶。必須設定一或多個 UserId 或 UserInvitation 元素。	長
UserInvitation	如果您想要代表客戶註冊新客戶，並選擇性地以代理商身分連結至新帳戶，則要傳送的用戶邀請。用戶端進階管理員用戶必須透過 Microsoft Advertising UI 完成註冊步驟，例如接受條款和條件。對於代理程式客戶在代表用戶端建立帳戶試驗中，此元素是選擇性的。已關閉整合智慧營銷活動試驗的客戶必須設定一或多個 UserId 或 UserInvitation 元素。	UserInvitation

要求標頭元素

元素	描述	資料類型
AuthenticationToken	OAuth 存取令牌，代表具有 Microsoft Advertising 帳戶許可權之用戶的認證。如需詳細資訊，請參閱使用 OAuth 進行驗證。	string
DeveloperToken	用來存取 Bing 廣告 API 的開發人員令牌。如需詳細資訊，請參閱取得開發人員令牌。	string
密碼	此元素會保留供內部使用，並會從未來的 API 版本中移除。您必須使用 AuthenticationToken 元素來設定用戶認證。	string
UserName	此元素會保留供內部使用，並會從未來的 API 版本中移除。您必須使用 AuthenticationToken 元素來設定用戶認證。	string

Response 元素

SignupCustomerResponse 物件會定義服務作業響應的主體和標頭元素。這些元素的傳回順序與回應SOAP中所示的順序相同。

回應本文專案

元素	描述	資料類型
AccountId	系統產生的帳戶標識碼，對應至要求中指定的新帳戶。使用此標識碼搭配需要 AccountId body 元素和 CustomerAccountId SOAP 標頭元素的作業要求。	長
AccountNumber	系統產生的帳戶號碼，用來識別 Microsoft Advertising Web 應用程式中的帳戶。帳戶編號的格式為 xxxxxxxxxx，其中 xxxxxxxxxx 是任何八個英數位元數的序列。	string
CreateTime	新增帳戶的日期和時間。日期和時間值會反映伺服器上的日期和時間，而不是用戶端。如需日期和時間格式的相關信息，請參閱基本 XML 數據類型中的 dateTime 專案。	Datetime
CustomerId	系統產生的客戶標識碼，對應至要求中指定的新客戶。使用此標識碼搭配需要 CustomerId SOAP 標頭元素的作業要求。	長
CustomerNumber	系統產生的客戶號碼，用於 Microsoft Advertising Web 應用程式。客戶編號的格式為 xxxxxxxxxxxx，其中 xxxxxxxxxxxx 是一系列的十個英數位元。	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: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

此範本是由工具所產生，用來顯示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
命名空間： https://bingads.microsoft.com/Customer/v13

共用方式為

SignupCustomer 服務作業 - 客戶管理

要求專案

要求本文專案

要求標頭元素

Response 元素

回應本文專案

回應標頭元素

要求SOAP

回應 SOAP

程序代碼語法

需求

其他資源