FindAccounts Hizmeti İşlemi - Müşteri Yönetimi
Belirtilen müşteri tarafından sahip olunan ve belirtilen filtre ölçütlerine uyan hesapların listesini alır.
İstek Öğeleri
FindAccountsRequest 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ü |
---|---|---|
AccountFilter | Hesap listesini filtrelemek için kullanılacak ölçüt. Hesap adı veya hesap numarası belirtebilirsiniz. Filtre değeriniz Xnnnnn biçimindeyse, burada nn bir basamak dizisidir, işlem hesap numarasına göre filtrelenir. Filtre değeri, almak istediğiniz hesapların kısmi veya tam hesap adını veya sayısını içerebilir. Hesabın adı veya numarası belirtilen filtre değeriyle başlıyorsa işlem sonucuna hesabı ekler. İşlem, filtre değerinizi hesap adı veya numarasıyla karşılaştırdığında büyük/küçük harfe duyarlı olmayan bir karşılaştırma gerçekleştirir. Örneğin, filtre değeri olarak "t" belirtirseniz, listede adları "t" veya "T" ile başlayan hesaplar yer alır. Bu öğeyi boş bir dizeye ayarlamak , GetAccountsInfo'nun çağrılmasıyla aynıdır. |
dize |
CustomerId | Hesaplarını almak istediğiniz müşterinin tanımlayıcısı. null ise, işlem kullanıcının yönettiği ve sahip olduğu müşterilerin tüm hesapları arasında bir eşleşme arar. |
uzun |
TopN | Sonuçta döndürülecek hesap sayısını belirten sıfır olmayan pozitif bir tamsayı. 1 ile 5.000 arasında bir değer belirtmeniz gerekir. | Int |
İ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 |
Kullanıcı adı | 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
FindAccountsResponse 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ü |
---|---|---|
AccountsInfo | Belirtilen filtre ölçütlerine uyan hesapların AccountInfo nesnelerinin listesi. Listedeki bir hesabın tüm ayrıntılarını almak için AccountInfo nesnesinin Id öğesine erişin ve GetAccount'ı çağırmak için kullanın. |
AccountInfo 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">FindAccounts</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<FindAccountsRequest xmlns="https://bingads.microsoft.com/Customer/v13">
<CustomerId i:nil="false">ValueHere</CustomerId>
<AccountFilter i:nil="false">ValueHere</AccountFilter>
<TopN>ValueHere</TopN>
</FindAccountsRequest>
</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>
<FindAccountsResponse xmlns="https://bingads.microsoft.com/Customer/v13">
<AccountsInfo xmlns:e19="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<e19:AccountInfo>
<e19:Id>ValueHere</e19:Id>
<e19:Name d4p1:nil="false">ValueHere</e19:Name>
<e19:Number d4p1:nil="false">ValueHere</e19:Number>
<e19:AccountLifeCycleStatus>ValueHere</e19:AccountLifeCycleStatus>
<e19:PauseReason d4p1:nil="false">ValueHere</e19:PauseReason>
</e19:AccountInfo>
</AccountsInfo>
</FindAccountsResponse>
</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<FindAccountsResponse> FindAccountsAsync(
long? customerId,
string accountFilter,
int topN)
{
var request = new FindAccountsRequest
{
CustomerId = customerId,
AccountFilter = accountFilter,
TopN = topN
};
return (await CustomerManagementService.CallAsync((s, r) => s.FindAccountsAsync(r), request));
}
static FindAccountsResponse findAccounts(
java.lang.Long customerId,
java.lang.String accountFilter,
int topN) throws RemoteException, Exception
{
FindAccountsRequest request = new FindAccountsRequest();
request.setCustomerId(customerId);
request.setAccountFilter(accountFilter);
request.setTopN(topN);
return CustomerManagementService.getService().findAccounts(request);
}
static function FindAccounts(
$customerId,
$accountFilter,
$topN)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new FindAccountsRequest();
$request->CustomerId = $customerId;
$request->AccountFilter = $accountFilter;
$request->TopN = $topN;
return $GLOBALS['CustomerManagementProxy']->GetService()->FindAccounts($request);
}
response=customermanagement_service.FindAccounts(
CustomerId=CustomerId,
AccountFilter=AccountFilter,
TopN=TopN)
Gereksinimler
Hizmet: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13
İstek Url'si
https://clientcenter.api.bingads.microsoft.com/CustomerManagement/v13/Accounts/Find
İstek Öğeleri
FindAccountsRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar.
Not
Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.
İstek Gövdesi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
AccountFilter | Hesap listesini filtrelemek için kullanılacak ölçüt. Hesap adı veya hesap numarası belirtebilirsiniz. Filtre değeriniz Xnnnnn biçimindeyse, burada nn bir basamak dizisidir, işlem hesap numarasına göre filtrelenir. Filtre değeri, almak istediğiniz hesapların kısmi veya tam hesap adını veya sayısını içerebilir. Hesabın adı veya numarası belirtilen filtre değeriyle başlıyorsa işlem sonucuna hesabı ekler. İşlem, filtre değerinizi hesap adı veya numarasıyla karşılaştırdığında büyük/küçük harfe duyarlı olmayan bir karşılaştırma gerçekleştirir. Örneğin, filtre değeri olarak "t" belirtirseniz, listede adları "t" veya "T" ile başlayan hesaplar yer alır. Bu öğeyi boş bir dizeye ayarlamak , GetAccountsInfo'nun çağrılmasıyla aynıdır. |
dize |
CustomerId | Hesaplarını almak istediğiniz müşterinin tanımlayıcısı. null ise, işlem kullanıcının yönettiği ve sahip olduğu müşterilerin tüm hesapları arasında bir eşleşme arar. |
uzun |
TopN | Sonuçta döndürülecek hesap sayısını belirten sıfır olmayan pozitif bir tamsayı. 1 ile 5.000 arasında bir değer belirtmeniz gerekir. | Int |
İstek Üst Bilgisi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
İzin | Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Belirtecin ön ekinin "Taşıyıcı" olduğundan emin olun, bu doğru kimlik doğrulaması için gereklidir. 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 |
Kullanıcı adı | 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
FindAccountsResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt JSON'unda gösterildiği gibi aynı sırada döndürülür.
Yanıt Gövdesi Öğeleri
Öğe | Açıklama | Veri Türü |
---|---|---|
AccountsInfo | Belirtilen filtre ölçütlerine uyan hesapların AccountInfo nesnelerinin listesi. Listedeki bir hesabın tüm ayrıntılarını almak için AccountInfo nesnesinin Id öğesine erişin ve GetAccount'ı çağırmak için kullanın. |
AccountInfo 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 |
JSON isteme
Bu şablon, JSON isteğinin gövde ve üst bilgi öğelerini 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.
{
"CustomerId": "LongValueHere",
"AccountFilter": "ValueHere",
"TopN": IntValueHere
}
Yanıt JSON
Bu şablon, JSON yanıtının gövde ve üst bilgi öğelerini göstermek için bir araç tarafından oluşturulmuştur.
{
"AccountsInfo": [
{
"AccountLifeCycleStatus": "ValueHere",
"Id": "LongValueHere",
"Name": "ValueHere",
"Number": "ValueHere",
"PauseReason": "ValueHere"
}
]
}
Kod Söz Dizimi
SDK'lar aracılığıyla REST API'yi çağırmak için SDK'yı belirli bir sürüme yükseltmeniz ve sistem parametrelerini yapılandırmanız gerekir. Ö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<FindAccountsResponse> FindAccountsAsync(
long? customerId,
string accountFilter,
int topN)
{
var request = new FindAccountsRequest
{
CustomerId = customerId,
AccountFilter = accountFilter,
TopN = topN
};
return (await CustomerManagementService.CallAsync((s, r) => s.FindAccountsAsync(r), request));
}
static FindAccountsResponse findAccounts(
java.lang.Long customerId,
java.lang.String accountFilter,
int topN) throws RemoteException, Exception
{
FindAccountsRequest request = new FindAccountsRequest();
request.setCustomerId(customerId);
request.setAccountFilter(accountFilter);
request.setTopN(topN);
return CustomerManagementService.getService().findAccounts(request);
}
static function FindAccounts(
$customerId,
$accountFilter,
$topN)
{
$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];
$request = new FindAccountsRequest();
$request->CustomerId = $customerId;
$request->AccountFilter = $accountFilter;
$request->TopN = $topN;
return $GLOBALS['CustomerManagementProxy']->GetService()->FindAccounts($request);
}
response=customermanagement_service.FindAccounts(
CustomerId=CustomerId,
AccountFilter=AccountFilter,
TopN=TopN)