GetAudiencesByIds Hizmeti İşlemi - Kampanya Yönetimi
Belirtilen hesaptan belirtilen hedef kitleleri alır.
İstek Öğeleri
GetAudiencesByIdsRequest 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ü |
|---|---|---|
| AudienceId'ler | İstenen hedef kitlenin en fazla 100 tanımlayıcısı. Bu istek öğesi isteğe bağlıdır. Bu öğe null veya boşsa, belirtilen hesap için tüm müşteri ve hesap kapsamına alınmış hedef kitleleri etkili bir şekilde isteyebilirsiniz. hedef kitle tanımlayıcıları istenen hedef kitle türleriyle eşleşmiyorsa, işlem istenen her hedef kitle kimliği için bir toplu iş hatası döndürür. |
uzun dizi |
| ReturnAdditionalFields | Ek alan değerleri, Kampanya Yönetimi API'sinin geçerli sürümünü kullanarak en son özellikleri edinmenizi sağlar ve sonraki sürümde karşılık gelen öğeler varsayılan olarak eklenir. Bu istek öğesi isteğe bağlıdır. |
AudienceAdditionalField |
| Tür | Döndürülecek izleyicilerin türü. Bayrak olarak birden çok değer ekleyebilirsiniz. Birden çok bayrağı nasıl belirttiğiniz, kullandığınız programlama diline bağlıdır. Örneğin, C# bu değerleri bayrak değerleri olarak değerlendirir ve Java bunları bir dize dizisi olarak değerlendirir. SOAP, boşlukla ayrılmış bir değer listesi içeren bir dize içermelidir. Örneğin, <Type>RemarketingList SimilarRemarketingList</Type>. |
AudienceType |
İ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 |
| CustomerAccountId | İstekteki varlıklara sahip olan veya bunlarla ilişkilendirilmiş reklam hesabının tanımlayıcısı. Her ikisi de gerektiğinde bu üst bilgi öğesi AccountId gövde öğesiyle aynı değere sahip olmalıdır. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir. Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma. |
Dize |
| Customerıd | Kullanıcının eriştiği veya faaliyette olduğu yönetici hesabının (müşteri) tanımlayıcısı. Bir kullanıcı birden çok yönetici hesabına erişebilir. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir. Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma. |
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
GetAudiencesByIdsResponse 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ü |
|---|---|---|
| Kitle -lere | İstekte belirttiğiniz hedef kitle tanımlayıcılarına doğrudan karşılık gelen hedef kitlelerin listesi. Listedeki öğeler null olarak döndürülebilir. Hedef kitlenin alınmadığı her liste dizini için ilgili öğe null olur. | İzleyici dizisi |
| PartialErrors | Başarılı olmayan istek öğelerinin ayrıntılarını içeren batcherror nesneleri dizisi. Hata listesi doğrudan istekteki öğe listesine karşılık gelir. Hata yoksa liste boş olabilir veya istekteki başarısız liste öğelerine karşılık gelen bir veya daha fazla hata nesnesi içerebilir. |
BatchError 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/CampaignManagement/v13">
<Action mustUnderstand="1">GetAudiencesByIds</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
<CustomerId i:nil="false">ValueHere</CustomerId>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<GetAudiencesByIdsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<AudienceIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</AudienceIds>
<Type>ValueHere</Type>
<ReturnAdditionalFields i:nil="false">ValueHere</ReturnAdditionalFields>
</GetAudiencesByIdsRequest>
</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/CampaignManagement/v13">
<TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
</s:Header>
<s:Body>
<GetAudiencesByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<Audiences d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<Audience d4p1:type="-- derived type specified here with the appropriate prefix --">
<AudienceNetworkSize d4p1:nil="false">ValueHere</AudienceNetworkSize>
<CustomerShare d4p1:nil="false">
<CustomerAccountShares d4p1:nil="false">
<CustomerAccountShare>
<AccountId d4p1:nil="false">ValueHere</AccountId>
<Associations d4p1:nil="false">
<CustomerAccountShareAssociation>
<AssociationCount d4p1:nil="false">ValueHere</AssociationCount>
<UsageType d4p1:nil="false">ValueHere</UsageType>
</CustomerAccountShareAssociation>
</Associations>
<CustomerId d4p1:nil="false">ValueHere</CustomerId>
</CustomerAccountShare>
</CustomerAccountShares>
<OwnerCustomerId d4p1:nil="false">ValueHere</OwnerCustomerId>
</CustomerShare>
<Description d4p1:nil="false">ValueHere</Description>
<ForwardCompatibilityMap xmlns:e126="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e126:KeyValuePairOfstringstring>
<e126:key d4p1:nil="false">ValueHere</e126:key>
<e126:value d4p1:nil="false">ValueHere</e126:value>
</e126:KeyValuePairOfstringstring>
</ForwardCompatibilityMap>
<Id d4p1:nil="false">ValueHere</Id>
<MembershipDuration d4p1:nil="false">ValueHere</MembershipDuration>
<Name d4p1:nil="false">ValueHere</Name>
<ParentId d4p1:nil="false">ValueHere</ParentId>
<Scope d4p1:nil="false">ValueHere</Scope>
<SearchSize d4p1:nil="false">ValueHere</SearchSize>
<SupportedCampaignTypes d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:string>ValueHere</a1:string>
</SupportedCampaignTypes>
<Type>ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to RemarketingList-->
<Rule d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to PageVisitorsRule-->
<NormalForm d4p1:nil="false">ValueHere</NormalForm>
<RuleItemGroups d4p1:nil="false">
<RuleItemGroup>
<Items d4p1:nil="false">
<RuleItem d4p1:type="-- derived type specified here with the appropriate prefix --">
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to StringRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
<!--These fields are applicable if the derived type attribute is set to NumberRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
</RuleItem>
</Items>
</RuleItemGroup>
</RuleItemGroups>
<!--These fields are applicable if the derived type attribute is set to PageVisitorsWhoVisitedAnotherPageRule-->
<AnotherRuleItemGroups d4p1:nil="false">
<RuleItemGroup>
<Items d4p1:nil="false">
<RuleItem d4p1:type="-- derived type specified here with the appropriate prefix --">
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to StringRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
<!--These fields are applicable if the derived type attribute is set to NumberRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
</RuleItem>
</Items>
</RuleItemGroup>
</AnotherRuleItemGroups>
<RuleItemGroups d4p1:nil="false">
<RuleItemGroup>
<Items d4p1:nil="false">
<RuleItem d4p1:type="-- derived type specified here with the appropriate prefix --">
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to StringRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
<!--These fields are applicable if the derived type attribute is set to NumberRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
</RuleItem>
</Items>
</RuleItemGroup>
</RuleItemGroups>
<!--These fields are applicable if the derived type attribute is set to PageVisitorsWhoDidNotVisitAnotherPageRule-->
<ExcludeRuleItemGroups d4p1:nil="false">
<RuleItemGroup>
<Items d4p1:nil="false">
<RuleItem d4p1:type="-- derived type specified here with the appropriate prefix --">
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to StringRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
<!--These fields are applicable if the derived type attribute is set to NumberRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
</RuleItem>
</Items>
</RuleItemGroup>
</ExcludeRuleItemGroups>
<IncludeRuleItemGroups d4p1:nil="false">
<RuleItemGroup>
<Items d4p1:nil="false">
<RuleItem d4p1:type="-- derived type specified here with the appropriate prefix --">
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to StringRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
<!--These fields are applicable if the derived type attribute is set to NumberRuleItem-->
<Operand d4p1:nil="false">ValueHere</Operand>
<Operator>ValueHere</Operator>
<Value d4p1:nil="false">ValueHere</Value>
</RuleItem>
</Items>
</RuleItemGroup>
</IncludeRuleItemGroups>
<!--These fields are applicable if the derived type attribute is set to CustomEventsRule-->
<Action d4p1:nil="false">ValueHere</Action>
<ActionOperator>ValueHere</ActionOperator>
<Category d4p1:nil="false">ValueHere</Category>
<CategoryOperator>ValueHere</CategoryOperator>
<Label d4p1:nil="false">ValueHere</Label>
<LabelOperator>ValueHere</LabelOperator>
<Value d4p1:nil="false">ValueHere</Value>
<ValueOperator>ValueHere</ValueOperator>
</Rule>
<TagId d4p1:nil="false">ValueHere</TagId>
<!--No additional fields are applicable if the derived type attribute is set to CustomAudience-->
<!--No additional fields are applicable if the derived type attribute is set to InMarketAudience-->
<!--These fields are applicable if the derived type attribute is set to ProductAudience-->
<ProductAudienceType d4p1:nil="false">ValueHere</ProductAudienceType>
<TagId d4p1:nil="false">ValueHere</TagId>
<!--This field is applicable if the derived type attribute is set to SimilarRemarketingList-->
<SourceId>ValueHere</SourceId>
<!--This field is applicable if the derived type attribute is set to CombinedList-->
<CombinationRules d4p1:nil="false">
<CombinationRule>
<AudienceIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</AudienceIds>
<Operator>ValueHere</Operator>
</CombinationRule>
</CombinationRules>
<!--No additional fields are applicable if the derived type attribute is set to CustomerList-->
<!--These fields are applicable if the derived type attribute is set to ImpressionBasedRemarketingList-->
<AdGroupId d4p1:nil="false">ValueHere</AdGroupId>
<CampaignId d4p1:nil="false">ValueHere</CampaignId>
<EntityType>ValueHere</EntityType>
</Audience>
</Audiences>
<PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<BatchError d4p1:type="-- derived type specified here with the appropriate prefix --">
<Code>ValueHere</Code>
<Details d4p1:nil="false">ValueHere</Details>
<ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
<FieldPath d4p1:nil="false">ValueHere</FieldPath>
<ForwardCompatibilityMap xmlns:e127="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e127:KeyValuePairOfstringstring>
<e127:key d4p1:nil="false">ValueHere</e127:key>
<e127:value d4p1:nil="false">ValueHere</e127:value>
</e127:KeyValuePairOfstringstring>
</ForwardCompatibilityMap>
<Index>ValueHere</Index>
<Message d4p1:nil="false">ValueHere</Message>
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to EditorialError-->
<Appealable d4p1:nil="false">ValueHere</Appealable>
<DisapprovedText d4p1:nil="false">ValueHere</DisapprovedText>
<Location d4p1:nil="false">ValueHere</Location>
<PublisherCountry d4p1:nil="false">ValueHere</PublisherCountry>
<ReasonCode>ValueHere</ReasonCode>
</BatchError>
</PartialErrors>
</GetAudiencesByIdsResponse>
</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<GetAudiencesByIdsResponse> GetAudiencesByIdsAsync(
IList<long> audienceIds,
AudienceType type,
AudienceAdditionalField? returnAdditionalFields)
{
var request = new GetAudiencesByIdsRequest
{
AudienceIds = audienceIds,
Type = type,
ReturnAdditionalFields = returnAdditionalFields
};
return (await CampaignManagementService.CallAsync((s, r) => s.GetAudiencesByIdsAsync(r), request));
}
static GetAudiencesByIdsResponse getAudiencesByIds(
ArrayOflong audienceIds,
ArrayList<AudienceType> type,
ArrayList<AudienceAdditionalField> returnAdditionalFields) throws RemoteException, Exception
{
GetAudiencesByIdsRequest request = new GetAudiencesByIdsRequest();
request.setAudienceIds(audienceIds);
request.setType(type);
request.setReturnAdditionalFields(returnAdditionalFields);
return CampaignManagementService.getService().getAudiencesByIds(request);
}
static function GetAudiencesByIds(
$audienceIds,
$type,
$returnAdditionalFields)
{
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
$request = new GetAudiencesByIdsRequest();
$request->AudienceIds = $audienceIds;
$request->Type = $type;
$request->ReturnAdditionalFields = $returnAdditionalFields;
return $GLOBALS['CampaignManagementProxy']->GetService()->GetAudiencesByIds($request);
}
response=campaignmanagement_service.GetAudiencesByIds(
AudienceIds=AudienceIds,
Type=Type,
ReturnAdditionalFields=ReturnAdditionalFields)
Gereksinimler
Hizmet: CampaignManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/CampaignManagement/v13