GetAccount サービス操作 - 顧客管理
アカウントの詳細を取得します。
Request 要素
GetAccountRequest オブジェクトは、サービス操作要求の本文要素とヘッダー要素を定義します。 要素は、 要求 SOAP に示されている順序と同じ順序である必要があります。
注:
以下に特に記載がない限り、すべての要求要素が必要です。
要求本文要素
要素 | 説明 | データ型 |
---|---|---|
AccountId | 取得するアカウントの識別子。 | long |
ReturnAdditionalFields | 返された各アカウントに含めたい追加のプロパティの一覧。 追加のフィールド値を使用すると、現在のバージョンの Customer Management API を使用して最新の機能を取得できます。次のバージョンでは、対応する要素が既定で含まれます。 この要求要素は省略可能です。 |
AccountAdditionalField |
要求ヘッダー要素
要素 | 説明 | データ型 |
---|---|---|
AuthenticationToken | Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセス トークン。 詳細については、「 OAuth による認証」を参照してください。 |
string |
DeveloperToken | Bing Ads API へのアクセスに使用される開発者トークン。 詳細については、「 開発者トークンを取得する」を参照してください。 |
string |
Password | この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 | string |
UserName | この要素は内部使用のために予約されており、今後のバージョンの API から削除されます。 ユーザー資格情報を設定するには、AuthenticationToken 要素を使用する必要があります。 | string |
Response 要素
GetAccountResponse オブジェクトは、サービス操作応答の本文要素とヘッダー要素を定義します。 要素は、 応答 SOAP に示されている順序と同じ順序で返されます。
応答本文の要素
要素 | 説明 | データ型 |
---|---|---|
アカウント | 支払い方法、アカウントの種類、親顧客など、アカウントに関する情報を含むアカウント オブジェクト。 | AdvertiserAccount |
応答ヘッダー要素
要素 | 説明 | データ型 |
---|---|---|
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">GetAccount</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<GetAccountRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<AccountId>ValueHere</AccountId>
<ReturnAdditionalFields i:nil="false">ValueHere</ReturnAdditionalFields>
</GetAccountRequest>
</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>
<GetAccountResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<Account xmlns:e228="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e228:BillToCustomerId d4p1:nil="false">ValueHere</e228:BillToCustomerId>
<e228:CurrencyCode d4p1:nil="false">ValueHere</e228:CurrencyCode>
<e228:AccountFinancialStatus d4p1:nil="false">ValueHere</e228:AccountFinancialStatus>
<e228:Id d4p1:nil="false">ValueHere</e228:Id>
<e228:Language d4p1:nil="false">ValueHere</e228:Language>
<e228:LastModifiedByUserId d4p1:nil="false">ValueHere</e228:LastModifiedByUserId>
<e228:LastModifiedTime d4p1:nil="false">ValueHere</e228:LastModifiedTime>
<e228:Name d4p1:nil="false">ValueHere</e228:Name>
<e228:Number d4p1:nil="false">ValueHere</e228:Number>
<e228:ParentCustomerId>ValueHere</e228:ParentCustomerId>
<e228:PaymentMethodId d4p1:nil="false">ValueHere</e228:PaymentMethodId>
<e228:PaymentMethodType d4p1:nil="false">ValueHere</e228:PaymentMethodType>
<e228:PrimaryUserId d4p1:nil="false">ValueHere</e228:PrimaryUserId>
<e228:AccountLifeCycleStatus d4p1:nil="false">ValueHere</e228:AccountLifeCycleStatus>
<e228:TimeStamp d4p1:nil="false">ValueHere</e228:TimeStamp>
<e228:TimeZone d4p1:nil="false">ValueHere</e228:TimeZone>
<e228:PauseReason d4p1:nil="false">ValueHere</e228:PauseReason>
<e228:ForwardCompatibilityMap xmlns:e229="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e229:KeyValuePairOfstringstring>
<e229:key d4p1:nil="false">ValueHere</e229:key>
<e229:value d4p1:nil="false">ValueHere</e229:value>
</e229:KeyValuePairOfstringstring>
</e228:ForwardCompatibilityMap>
<e228:LinkedAgencies d4p1:nil="false">
<e228:CustomerInfo>
<e228:Id d4p1:nil="false">ValueHere</e228:Id>
<e228:Name d4p1:nil="false">ValueHere</e228:Name>
</e228:CustomerInfo>
</e228:LinkedAgencies>
<e228:SalesHouseCustomerId d4p1:nil="false">ValueHere</e228:SalesHouseCustomerId>
<e228:TaxInformation xmlns:e230="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e230:KeyValuePairOfstringstring>
<e230:key d4p1:nil="false">ValueHere</e230:key>
<e230:value d4p1:nil="false">ValueHere</e230:value>
</e230:KeyValuePairOfstringstring>
</e228:TaxInformation>
<e228:BackUpPaymentInstrumentId d4p1:nil="false">ValueHere</e228:BackUpPaymentInstrumentId>
<e228:BillingThresholdAmount d4p1:nil="false">ValueHere</e228:BillingThresholdAmount>
<e228:BusinessAddress d4p1:nil="false">
<e228:City d4p1:nil="false">ValueHere</e228:City>
<e228:CountryCode d4p1:nil="false">ValueHere</e228:CountryCode>
<e228:Id d4p1:nil="false">ValueHere</e228:Id>
<e228:Line1 d4p1:nil="false">ValueHere</e228:Line1>
<e228:Line2 d4p1:nil="false">ValueHere</e228:Line2>
<e228:Line3 d4p1:nil="false">ValueHere</e228:Line3>
<e228:Line4 d4p1:nil="false">ValueHere</e228:Line4>
<e228:PostalCode d4p1:nil="false">ValueHere</e228:PostalCode>
<e228:StateOrProvince d4p1:nil="false">ValueHere</e228:StateOrProvince>
<e228:TimeStamp d4p1:nil="false">ValueHere</e228:TimeStamp>
<e228:BusinessName d4p1:nil="false">ValueHere</e228:BusinessName>
</e228:BusinessAddress>
<e228:AutoTagType d4p1:nil="false">ValueHere</e228:AutoTagType>
<e228:SoldToPaymentInstrumentId d4p1:nil="false">ValueHere</e228:SoldToPaymentInstrumentId>
<e228:TaxCertificate d4p1:nil="false">
<e228:TaxCertificateBlobContainerName d4p1:nil="false">ValueHere</e228:TaxCertificateBlobContainerName>
<e228:TaxCertificates xmlns:e231="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e231:KeyValuePairOfstringbase64Binary>
<e231:key d4p1:nil="false">ValueHere</e231:key>
<e231:value d4p1:nil="false">ValueHere</e231:value>
</e231:KeyValuePairOfstringbase64Binary>
</e228:TaxCertificates>
<e228:Status d4p1:nil="false">ValueHere</e228:Status>
</e228:TaxCertificate>
<e228:AccountMode d4p1:nil="false">ValueHere</e228:AccountMode>
</Account>
</GetAccountResponse>
</s:Body>
</s:Envelope>
コード構文
構文の例は、 Bing広告 SDK で使用できます。 その他 の例については、「Bing広告 API コードの例 」を参照してください。
public async Task<GetAccountResponse> GetAccountAsync(
long accountId,
AccountAdditionalField? returnAdditionalFields)
{
var request = new GetAccountRequest
{
AccountId = accountId,
ReturnAdditionalFields = returnAdditionalFields
};
return (await CustomerManagementService.CallAsync((s, r) => s.GetAccountAsync(r), request));
}
static GetAccountResponse getAccount(
java.lang.Long accountId,
ArrayList<AccountAdditionalField> returnAdditionalFields) throws RemoteException, Exception
{
GetAccountRequest request = new GetAccountRequest();
request.setAccountId(accountId);
request.setReturnAdditionalFields(returnAdditionalFields);
return CustomerManagementService.getService().getAccount(request);
}
static function GetAccount(
$accountId,
$returnAdditionalFields)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new GetAccountRequest();
$request->AccountId = $accountId;
$request->ReturnAdditionalFields = $returnAdditionalFields;
return $GLOBALS['CustomerManagementProxy']->GetService()->GetAccount($request);
}
response=customermanagement_service.GetAccount(
AccountId=AccountId,
ReturnAdditionalFields=ReturnAdditionalFields)
要件
サービス: CustomerManagementService.svc v13
名前 空間: https://bingads.microsoft.com/Customer/v13