การดําเนินการ GetAccount Service - การจัดการลูกค้า
รับรายละเอียดของบัญชี
ร้องขอองค์ประกอบ
วัตถุ GetAccountRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AccountId | ตัวระบุของบัญชีที่จะรับ | ยาว |
ReturnAdditionalFields | รายการของคุณสมบัติเพิ่มเติมที่คุณต้องการรวมไว้ภายในแต่ละบัญชีที่ส่งกลับ ค่าเขตข้อมูลเพิ่มเติมช่วยให้คุณสามารถรับคุณลักษณะล่าสุดโดยใช้ API การจัดการลูกค้าเวอร์ชันปัจจุบัน และในเวอร์ชันถัดไป องค์ประกอบที่สอดคล้องกันจะถูกรวมตามค่าเริ่มต้น องค์ประกอบการร้องขอนี้เป็นทางเลือก |
AccountAdditionalField |
องค์ประกอบส่วนหัวของคําขอ
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
เชือก |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
เชือก |
รหัสผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | เชือก |
ชื่อผู้ใช้ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | เชือก |
องค์ประกอบการตอบสนอง
วัตถุ GetAccountResponse จะกําหนดองค์ประกอบ เนื้อ ความและ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
บัญชี | ออบเจ็กต์บัญชีที่ประกอบด้วยข้อมูลเกี่ยวกับบัญชี เช่น วิธีการชําระเงิน ชนิดบัญชี และลูกค้าหลัก | AdvertiserAccount |
องค์ประกอบส่วนหัวการตอบสนอง
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
TrackingId | ตัวระบุของรายการบันทึกที่ประกอบด้วยรายละเอียดของการเรียกใช้ API | เชือก |
ร้องขอ 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>
Response 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:e23="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e23:BillToCustomerId d4p1:nil="false">ValueHere</e23:BillToCustomerId>
<e23:CurrencyCode d4p1:nil="false">ValueHere</e23:CurrencyCode>
<e23:AccountFinancialStatus d4p1:nil="false">ValueHere</e23:AccountFinancialStatus>
<e23:Id d4p1:nil="false">ValueHere</e23:Id>
<e23:Language d4p1:nil="false">ValueHere</e23:Language>
<e23:LastModifiedByUserId d4p1:nil="false">ValueHere</e23:LastModifiedByUserId>
<e23:LastModifiedTime d4p1:nil="false">ValueHere</e23:LastModifiedTime>
<e23:Name d4p1:nil="false">ValueHere</e23:Name>
<e23:Number d4p1:nil="false">ValueHere</e23:Number>
<e23:ParentCustomerId>ValueHere</e23:ParentCustomerId>
<e23:PaymentMethodId d4p1:nil="false">ValueHere</e23:PaymentMethodId>
<e23:PaymentMethodType d4p1:nil="false">ValueHere</e23:PaymentMethodType>
<e23:PrimaryUserId d4p1:nil="false">ValueHere</e23:PrimaryUserId>
<e23:AccountLifeCycleStatus d4p1:nil="false">ValueHere</e23:AccountLifeCycleStatus>
<e23:TimeStamp d4p1:nil="false">ValueHere</e23:TimeStamp>
<e23:TimeZone d4p1:nil="false">ValueHere</e23:TimeZone>
<e23:PauseReason d4p1:nil="false">ValueHere</e23:PauseReason>
<e23:ForwardCompatibilityMap xmlns:e24="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e24:KeyValuePairOfstringstring>
<e24:key d4p1:nil="false">ValueHere</e24:key>
<e24:value d4p1:nil="false">ValueHere</e24:value>
</e24:KeyValuePairOfstringstring>
</e23:ForwardCompatibilityMap>
<e23:LinkedAgencies d4p1:nil="false">
<e23:CustomerInfo>
<e23:Id d4p1:nil="false">ValueHere</e23:Id>
<e23:Name d4p1:nil="false">ValueHere</e23:Name>
</e23:CustomerInfo>
</e23:LinkedAgencies>
<e23:SalesHouseCustomerId d4p1:nil="false">ValueHere</e23:SalesHouseCustomerId>
<e23:TaxInformation xmlns:e25="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e25:KeyValuePairOfstringstring>
<e25:key d4p1:nil="false">ValueHere</e25:key>
<e25:value d4p1:nil="false">ValueHere</e25:value>
</e25:KeyValuePairOfstringstring>
</e23:TaxInformation>
<e23:BackUpPaymentInstrumentId d4p1:nil="false">ValueHere</e23:BackUpPaymentInstrumentId>
<e23:BillingThresholdAmount d4p1:nil="false">ValueHere</e23:BillingThresholdAmount>
<e23:BusinessAddress d4p1:nil="false">
<e23:City d4p1:nil="false">ValueHere</e23:City>
<e23:CountryCode d4p1:nil="false">ValueHere</e23:CountryCode>
<e23:Id d4p1:nil="false">ValueHere</e23:Id>
<e23:Line1 d4p1:nil="false">ValueHere</e23:Line1>
<e23:Line2 d4p1:nil="false">ValueHere</e23:Line2>
<e23:Line3 d4p1:nil="false">ValueHere</e23:Line3>
<e23:Line4 d4p1:nil="false">ValueHere</e23:Line4>
<e23:PostalCode d4p1:nil="false">ValueHere</e23:PostalCode>
<e23:StateOrProvince d4p1:nil="false">ValueHere</e23:StateOrProvince>
<e23:TimeStamp d4p1:nil="false">ValueHere</e23:TimeStamp>
<e23:BusinessName d4p1:nil="false">ValueHere</e23:BusinessName>
</e23:BusinessAddress>
<e23:AutoTagType d4p1:nil="false">ValueHere</e23:AutoTagType>
<e23:SoldToPaymentInstrumentId d4p1:nil="false">ValueHere</e23:SoldToPaymentInstrumentId>
<e23:TaxCertificate d4p1:nil="false">
<e23:TaxCertificateBlobContainerName d4p1:nil="false">ValueHere</e23:TaxCertificateBlobContainerName>
<e23:TaxCertificates xmlns:e26="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e26:KeyValuePairOfstringbase64Binary>
<e26:key d4p1:nil="false">ValueHere</e26:key>
<e26:value d4p1:nil="false">ValueHere</e26:value>
</e26:KeyValuePairOfstringbase64Binary>
</e23:TaxCertificates>
<e23:Status d4p1:nil="false">ValueHere</e23:Status>
</e23:TaxCertificate>
<e23:AccountMode d4p1:nil="false">ValueHere</e23:AccountMode>
</Account>
</GetAccountResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
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
Namespace: https://bingads.microsoft.com/Customer/v13
URL การร้องขอ
https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13/Account/Query
ร้องขอองค์ประกอบ
วัตถุ GetAccountRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AccountId | ตัวระบุของบัญชีที่จะรับ | ยาว |
ReturnAdditionalFields | รายการของคุณสมบัติเพิ่มเติมที่คุณต้องการรวมไว้ภายในแต่ละบัญชีที่ส่งกลับ ค่าเขตข้อมูลเพิ่มเติมช่วยให้คุณสามารถรับคุณลักษณะล่าสุดโดยใช้ API การจัดการลูกค้าเวอร์ชันปัจจุบัน และในเวอร์ชันถัดไป องค์ประกอบที่สอดคล้องกันจะถูกรวมตามค่าเริ่มต้น องค์ประกอบการร้องขอนี้เป็นทางเลือก |
AccountAdditionalField |
องค์ประกอบส่วนหัวของคําขอ
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
การอนุญาต | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising โปรดตรวจสอบให้แน่ใจว่าโทเค็นขึ้นต้นด้วย "Bearer " ซึ่งจําเป็นสําหรับการรับรองความถูกต้องที่เหมาะสม สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
เชือก |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
เชือก |
รหัสผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | เชือก |
ชื่อผู้ใช้ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | เชือก |
องค์ประกอบการตอบสนอง
วัตถุ GetAccountResponse จะกําหนดองค์ประกอบ เนื้อ ความและ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงในการตอบสนอง JSON
องค์ประกอบเนื้อความการตอบสนอง
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
บัญชี | ออบเจ็กต์บัญชีที่ประกอบด้วยข้อมูลเกี่ยวกับบัญชี เช่น วิธีการชําระเงิน ชนิดบัญชี และลูกค้าหลัก | AdvertiserAccount |
องค์ประกอบส่วนหัวการตอบสนอง
ธาตุ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
TrackingId | ตัวระบุของรายการบันทึกที่ประกอบด้วยรายละเอียดของการเรียกใช้ API | เชือก |
ร้องขอ JSON
เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงองค์ประกอบ เนื้อความ และ ส่วนหัว สําหรับคําขอ JSON สําหรับชนิดที่สนับสนุนที่คุณสามารถใช้กับการดําเนินการบริการนี้ โปรดดูการอ้างอิง องค์ประกอบเนื้อความคําขอ ด้านบน
{
"AccountId": "LongValueHere",
"ReturnAdditionalFields": "ValueHere"
}
การตอบสนอง JSON
เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงองค์ประกอบ เนื้อความ และ ส่วนหัว สําหรับการตอบสนอง JSON
{
"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"
}
}
ไวยากรณ์โค้ด
หากต้องการเรียกใช้ REST API ผ่าน SDK คุณจําเป็นต้องอัปเกรด SDK เป็นเวอร์ชันเฉพาะและกําหนดค่าพารามิเตอร์ระบบ ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
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)