GetCustomer 服務作業 - 客戶管理
取得客戶的詳細資料。
要求專案
GetCustomerRequest物件會定義服務作業要求的主體和標頭元素。 元素的順序必須與 要求 SOAP中所示的順序相同。
注意事項
除非下面另有說明,否則所有要求專案都是必要的。
要求本文專案
元素 | 說明 | 資料類型 |
---|---|---|
CustomerId | 您想要取得其資訊的客戶識別碼。 | 長 |
要求標頭元素
元素 | 說明 | 資料類型 |
---|---|---|
AuthenticationToken | OAuth 存取權杖,代表具有 Microsoft Advertising 帳戶許可權之使用者的認證。 如需詳細資訊,請 參閱使用 OAuth 進行驗證。 |
string |
DeveloperToken | 用來存取 Bing 廣告 API 的開發人員權杖。 如需詳細資訊 ,請參閱取得開發人員權杖。 |
string |
密碼 | 此元素會保留供內部使用,並會從未來的 API 版本中移除。 您必須使用 AuthenticationToken 元素來設定使用者認證。 | string |
UserName | 此元素會保留供內部使用,並會從未來的 API 版本中移除。 您必須使用 AuthenticationToken 元素來設定使用者認證。 | string |
Response 元素
GetCustomerResponse物件會定義服務作業回應的主體和標頭元素。 這些元素的傳回順序與 回應 SOAP中所示的順序相同。
回應本文專案
元素 | 說明 | 資料類型 |
---|---|---|
客戶 | 包含客戶相關資訊的 Customer 物件。 | 客戶 |
回應標頭元素
元素 | 說明 | 資料類型 |
---|---|---|
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">GetCustomer</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<GetCustomerRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<CustomerId>ValueHere</CustomerId>
</GetCustomerRequest>
</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>
<GetCustomerResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<Customer xmlns:e221="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e221:CustomerFinancialStatus d4p1:nil="false">ValueHere</e221:CustomerFinancialStatus>
<e221:Id d4p1:nil="false">ValueHere</e221:Id>
<e221:Industry d4p1:nil="false">ValueHere</e221:Industry>
<e221:LastModifiedByUserId d4p1:nil="false">ValueHere</e221:LastModifiedByUserId>
<e221:LastModifiedTime d4p1:nil="false">ValueHere</e221:LastModifiedTime>
<e221:MarketCountry d4p1:nil="false">ValueHere</e221:MarketCountry>
<e221:ForwardCompatibilityMap xmlns:e222="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e222:KeyValuePairOfstringstring>
<e222:key d4p1:nil="false">ValueHere</e222:key>
<e222:value d4p1:nil="false">ValueHere</e222:value>
</e222:KeyValuePairOfstringstring>
</e221:ForwardCompatibilityMap>
<e221:MarketLanguage d4p1:nil="false">ValueHere</e221:MarketLanguage>
<e221:Name d4p1:nil="false">ValueHere</e221:Name>
<e221:ServiceLevel d4p1:nil="false">ValueHere</e221:ServiceLevel>
<e221:CustomerLifeCycleStatus d4p1:nil="false">ValueHere</e221:CustomerLifeCycleStatus>
<e221:TimeStamp d4p1:nil="false">ValueHere</e221:TimeStamp>
<e221:Number d4p1:nil="false">ValueHere</e221:Number>
<e221:CustomerAddress d4p1:nil="false">
<e221:City d4p1:nil="false">ValueHere</e221:City>
<e221:CountryCode d4p1:nil="false">ValueHere</e221:CountryCode>
<e221:Id d4p1:nil="false">ValueHere</e221:Id>
<e221:Line1 d4p1:nil="false">ValueHere</e221:Line1>
<e221:Line2 d4p1:nil="false">ValueHere</e221:Line2>
<e221:Line3 d4p1:nil="false">ValueHere</e221:Line3>
<e221:Line4 d4p1:nil="false">ValueHere</e221:Line4>
<e221:PostalCode d4p1:nil="false">ValueHere</e221:PostalCode>
<e221:StateOrProvince d4p1:nil="false">ValueHere</e221:StateOrProvince>
<e221:TimeStamp d4p1:nil="false">ValueHere</e221:TimeStamp>
<e221:BusinessName d4p1:nil="false">ValueHere</e221:BusinessName>
</e221:CustomerAddress>
</Customer>
</GetCustomerResponse>
</s:Body>
</s:Envelope>
程式碼語法
範例語法可以與 Bing 廣告 SDK搭配使用。 如需更多範例,請參閱 Bing 廣告 API 程式碼范 例。
public async Task<GetCustomerResponse> GetCustomerAsync(
long customerId)
{
var request = new GetCustomerRequest
{
CustomerId = customerId
};
return (await CustomerManagementService.CallAsync((s, r) => s.GetCustomerAsync(r), request));
}
static GetCustomerResponse getCustomer(
java.lang.Long customerId) throws RemoteException, Exception
{
GetCustomerRequest request = new GetCustomerRequest();
request.setCustomerId(customerId);
return CustomerManagementService.getService().getCustomer(request);
}
static function GetCustomer(
$customerId)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new GetCustomerRequest();
$request->CustomerId = $customerId;
return $GLOBALS['CustomerManagementProxy']->GetService()->GetCustomer($request);
}
response=customermanagement_service.GetCustomer(
CustomerId=CustomerId)
需求
服務: CustomerManagementService.svc v13
命名 空間: https://bingads.microsoft.com/Customer/v13