SearchAccounts Hizmet İşlemi - Müşteri Yönetimi
İstek ölçütlerine uyan hesapları arar.
Örneğin, geçerli kimliği doğrulanmış kullanıcının erişebileceği hesapları arayabilirsiniz.
İpucu
Örnekleri içeren bir genel bakış için lütfen Hesap Hiyerarşisi ve Kullanıcı İzinleri kılavuzuna bakın.
İstek Öğeleri
SearchAccountsRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar. Öğelerin İstek SOAP'sinde gösterildiği gibi aynı sırada olması gerekir.
Not
Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.
İstek Gövdesi Öğeleri
| Öğe | Açıklama | Veri Türü |
|---|---|---|
| Sipariş | Sonuçların sırasını hesabın belirtilen özelliğine göre belirler. Bu istek öğesi isteğe bağlıdır. Dizide en fazla bir OrderBy öğesi belirtebilirsiniz. Ek öğeler desteklenmez ve hizmet tarafından yoksayılır. OrderBy nesnesinin Field öğesini "Id", "Name" veya "Number" olarak ayarlarsanız, döndürülen Hesaplar hesap tanımlayıcılarına, adlarına veya numaralarına göre sıralanır. Bu istek öğesi isteğe bağlıdır. |
OrderBy dizisi |
| PageInfo | Sayfa başına sonuçların dizinini ve boyutunu belirler. | Sayfalama |
| Yüklemler | Hesapları döndürmek için tümünün karşılanması gereken koşulları belirler. Tam olarak bir koşul eklemeniz gerekir. Koşul Alanı "AccountLifeCycleStatus" olarak ayarlandıysa, Field değeri UserId gibi başka bir değere ayarlanmış bir ek koşul belirtmeniz gerekir. Desteklenen her koşul Alan değeri hakkında ayrıntılı bilgi için bkz. Koşul Açıklamaları. |
Koşul dizisi |
| ReturnAdditionalFields | Döndürülen her hesaba eklenmesini istediğiniz ek özelliklerin listesi. Ek alan değerleri, Müşteri Yönetimi API'sinin geçerli sürümünü kullanarak en son özellikleri almanıza olanak tanır ve sonraki sürümde karşılık gelen öğeler varsayılan olarak eklenir. Bu istek öğesi isteğe bağlıdır. |
AccountAdditionalField |
İstek Üst Bilgisi Öğeleri
| Öğe | Açıklama | Veri Türü |
|---|---|---|
| AuthenticationToken | Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması. |
Dize |
| DeveloperToken | Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma. |
Dize |
| Password | Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir. | Dize |
| Username | Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir. | Dize |
Yanıt Öğeleri
SearchAccountsResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt SOAP'sinde gösterildiği gibi aynı sırada döndürülür.
Yanıt Gövdesi Öğeleri
| Öğe | Açıklama | Veri Türü |
|---|---|---|
| Hesaplar | İstek ölçütlerini karşılayan hesapların listesi. | ReklamverenHesap dizisi |
Yanıt Üst Bilgisi Öğeleri
| Öğe | Açıklama | Veri Türü |
|---|---|---|
| TrackingId | API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı. | Dize |
SOAP isteme
Bu şablon, SOAP isteği için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.
<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">SearchAccounts</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<SearchAccountsRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<Predicates xmlns:e243="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e243:Predicate>
<e243:Field i:nil="false">ValueHere</e243:Field>
<e243:Operator>ValueHere</e243:Operator>
<e243:Value i:nil="false">ValueHere</e243:Value>
</e243:Predicate>
</Predicates>
<Ordering xmlns:e244="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e244:OrderBy>
<e244:Field>ValueHere</e244:Field>
<e244:Order>ValueHere</e244:Order>
</e244:OrderBy>
</Ordering>
<PageInfo xmlns:e245="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
<e245:Index>ValueHere</e245:Index>
<e245:Size>ValueHere</e245:Size>
</PageInfo>
<ReturnAdditionalFields i:nil="false">ValueHere</ReturnAdditionalFields>
</SearchAccountsRequest>
</s:Body>
</s:Envelope>
Yanıt SOAP
Bu şablon, SOAP yanıtı için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur.
<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>
<SearchAccountsResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<Accounts xmlns:e246="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e246:AdvertiserAccount>
<e246:BillToCustomerId d4p1:nil="false">ValueHere</e246:BillToCustomerId>
<e246:CurrencyCode d4p1:nil="false">ValueHere</e246:CurrencyCode>
<e246:AccountFinancialStatus d4p1:nil="false">ValueHere</e246:AccountFinancialStatus>
<e246:Id d4p1:nil="false">ValueHere</e246:Id>
<e246:Language d4p1:nil="false">ValueHere</e246:Language>
<e246:LastModifiedByUserId d4p1:nil="false">ValueHere</e246:LastModifiedByUserId>
<e246:LastModifiedTime d4p1:nil="false">ValueHere</e246:LastModifiedTime>
<e246:Name d4p1:nil="false">ValueHere</e246:Name>
<e246:Number d4p1:nil="false">ValueHere</e246:Number>
<e246:ParentCustomerId>ValueHere</e246:ParentCustomerId>
<e246:PaymentMethodId d4p1:nil="false">ValueHere</e246:PaymentMethodId>
<e246:PaymentMethodType d4p1:nil="false">ValueHere</e246:PaymentMethodType>
<e246:PrimaryUserId d4p1:nil="false">ValueHere</e246:PrimaryUserId>
<e246:AccountLifeCycleStatus d4p1:nil="false">ValueHere</e246:AccountLifeCycleStatus>
<e246:TimeStamp d4p1:nil="false">ValueHere</e246:TimeStamp>
<e246:TimeZone d4p1:nil="false">ValueHere</e246:TimeZone>
<e246:PauseReason d4p1:nil="false">ValueHere</e246:PauseReason>
<e246:ForwardCompatibilityMap xmlns:e247="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e247:KeyValuePairOfstringstring>
<e247:key d4p1:nil="false">ValueHere</e247:key>
<e247:value d4p1:nil="false">ValueHere</e247:value>
</e247:KeyValuePairOfstringstring>
</e246:ForwardCompatibilityMap>
<e246:LinkedAgencies d4p1:nil="false">
<e246:CustomerInfo>
<e246:Id d4p1:nil="false">ValueHere</e246:Id>
<e246:Name d4p1:nil="false">ValueHere</e246:Name>
</e246:CustomerInfo>
</e246:LinkedAgencies>
<e246:SalesHouseCustomerId d4p1:nil="false">ValueHere</e246:SalesHouseCustomerId>
<e246:TaxInformation xmlns:e248="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e248:KeyValuePairOfstringstring>
<e248:key d4p1:nil="false">ValueHere</e248:key>
<e248:value d4p1:nil="false">ValueHere</e248:value>
</e248:KeyValuePairOfstringstring>
</e246:TaxInformation>
<e246:BackUpPaymentInstrumentId d4p1:nil="false">ValueHere</e246:BackUpPaymentInstrumentId>
<e246:BillingThresholdAmount d4p1:nil="false">ValueHere</e246:BillingThresholdAmount>
<e246:BusinessAddress d4p1:nil="false">
<e246:City d4p1:nil="false">ValueHere</e246:City>
<e246:CountryCode d4p1:nil="false">ValueHere</e246:CountryCode>
<e246:Id d4p1:nil="false">ValueHere</e246:Id>
<e246:Line1 d4p1:nil="false">ValueHere</e246:Line1>
<e246:Line2 d4p1:nil="false">ValueHere</e246:Line2>
<e246:Line3 d4p1:nil="false">ValueHere</e246:Line3>
<e246:Line4 d4p1:nil="false">ValueHere</e246:Line4>
<e246:PostalCode d4p1:nil="false">ValueHere</e246:PostalCode>
<e246:StateOrProvince d4p1:nil="false">ValueHere</e246:StateOrProvince>
<e246:TimeStamp d4p1:nil="false">ValueHere</e246:TimeStamp>
<e246:BusinessName d4p1:nil="false">ValueHere</e246:BusinessName>
</e246:BusinessAddress>
<e246:AutoTagType d4p1:nil="false">ValueHere</e246:AutoTagType>
<e246:SoldToPaymentInstrumentId d4p1:nil="false">ValueHere</e246:SoldToPaymentInstrumentId>
<e246:TaxCertificate d4p1:nil="false">
<e246:TaxCertificateBlobContainerName d4p1:nil="false">ValueHere</e246:TaxCertificateBlobContainerName>
<e246:TaxCertificates xmlns:e249="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e249:KeyValuePairOfstringbase64Binary>
<e249:key d4p1:nil="false">ValueHere</e249:key>
<e249:value d4p1:nil="false">ValueHere</e249:value>
</e249:KeyValuePairOfstringbase64Binary>
</e246:TaxCertificates>
<e246:Status d4p1:nil="false">ValueHere</e246:Status>
</e246:TaxCertificate>
<e246:AccountMode d4p1:nil="false">ValueHere</e246:AccountMode>
</e246:AdvertiserAccount>
</Accounts>
</SearchAccountsResponse>
</s:Body>
</s:Envelope>
Kod Söz Dizimi
Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .
public async Task<SearchAccountsResponse> SearchAccountsAsync(
IList<Predicate> predicates,
IList<OrderBy> ordering,
Paging pageInfo,
AccountAdditionalField? returnAdditionalFields)
{
var request = new SearchAccountsRequest
{
Predicates = predicates,
Ordering = ordering,
PageInfo = pageInfo,
ReturnAdditionalFields = returnAdditionalFields
};
return (await CustomerManagementService.CallAsync((s, r) => s.SearchAccountsAsync(r), request));
}
static SearchAccountsResponse searchAccounts(
ArrayOfPredicate predicates,
ArrayOfOrderBy ordering,
Paging pageInfo,
ArrayList<AccountAdditionalField> returnAdditionalFields) throws RemoteException, Exception
{
SearchAccountsRequest request = new SearchAccountsRequest();
request.setPredicates(predicates);
request.setOrdering(ordering);
request.setPageInfo(pageInfo);
request.setReturnAdditionalFields(returnAdditionalFields);
return CustomerManagementService.getService().searchAccounts(request);
}
static function SearchAccounts(
$predicates,
$ordering,
$pageInfo,
$returnAdditionalFields)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new SearchAccountsRequest();
$request->Predicates = $predicates;
$request->Ordering = $ordering;
$request->PageInfo = $pageInfo;
$request->ReturnAdditionalFields = $returnAdditionalFields;
return $GLOBALS['CustomerManagementProxy']->GetService()->SearchAccounts($request);
}
response=customermanagement_service.SearchAccounts(
Predicates=Predicates,
Ordering=Ordering,
PageInfo=PageInfo,
ReturnAdditionalFields=ReturnAdditionalFields)
Gereksinimler
Hizmet: CustomerManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/Customer/v13