ApplyAssetGroupListingGroupActions Hizmet İşlemi - Kampanya Yönetimi

Makale
04/01/2024

Varlık grubu listeleme grubuna bir eylem uygular.

Lütfen aşağıdaki doğrulama kurallarını not edin:

En azından listeleme grubu ağaç yapısı için en az kök düğümü belirtmeniz gerekir. Listeleme grubunun kök AssetGroupListingGroup'unun koşulu İşleneni "Tümü" olarak, Öznitelikise null olarak ayarlanmalıdır. Katalogdaki tüm ürünler için reklam yayınlanıyorsa PartitionType değerini "Unit" olarak ayarlayın. Daha belirli ürün koşullarında reklam yayınlanıyorsa YPartitionTypeY değerini "Subdivision", ParentCriterionId değerini null, Kimliği ise negatif bir değer olarak ayarlayın. Alt düğümler için ParentCriterionId olarak negatif değeri kullanacaksınız.
Kök düğüm düzey 0 olarak kabul edilir ve bir ağaç 7 düzey derine kadar dallara sahip olabilir.
Çağrı başına en fazla 5.000 AssetGroupListingGroupAction nesnesi belirtebilirsiniz. Birden çok çağrı aracılığıyla oluşturulan tüm ağacın en fazla 20.000 düğümü olabilir.
AssetGroupListingGroup nesnelerinin her biri aynı AssetGroupId'ye sahip olmalıdır, aksi takdirde çağrı başarısız olur.
Koşul veya Öznitelik özelliklerini güncelleştirmek için mevcut ürün bölümü ağacı düğümünü silmeniz ve yeni bir tanımlayıcı alacak yeni bir ürün bölümü ağacı düğümü eklemeniz gerekir. Dışlanmayan bir Varlık GrubuListingGroup'a veya başka bir yolla güncelleştirilmek için, mevcut ürün bölümü ağacı düğümünü silmeniz ve yeni bir tanımlayıcı alacak yeni bir ürün bölümü ağacı düğümü eklemeniz gerekir.
Herhangi bir eylem başarısız olursa, aksi takdirde başarılı olabilecek kalan tüm eylemler de başarısız olur.
Bir çağrıdaki tüm eylemler tam bir ağaç yapısına neden olmalıdır. Varlık grubu başına 5.000'den fazla eylem uygulamanız gerekiyorsa, birden çok arama yapmanız gerekir. İlk çağrıdan üst varlık grubu tanımlayıcılarını alın ve ardından sonraki çağrılarda gerektiğinde daha fazla alt öğe ekleyin.
Kök düğümden dalın sonuna kadar olan her yol bir yaprak düğüm (ProductPartitionType=Unit) ile sonlandırılmalıdır.
Alt bölüm koşullarının geri kalanı için her alt bölüm en az bir yaprak düğüme sahip olmalıdır. Örneğin, eşdüzey birimleriyle aynı işleneni kullanın ve özniteliğini null olarak ayarlayın.
Alt düğümü yalnızca üst öğesinden sonra belirtebilirsiniz.
Üst veya alt öğe olmayan birden çok düzeye sahip bölümler ekliyorsanız, üst öğeyi tanımlamak için başvuru olarak negatif bir int değeri kullanın. Örneğin hem üst öğenin kimliğini hem de alt öğenin ParentListingGroupId öğesini aynı negatif değere ayarlayın. Negatif kimlikler yalnızca çağrı süresi boyunca geçerlidir. Başarıyla eklenen her varlık grubu listeleme grubu için benzersiz sistem tanımlayıcıları yanıt iletisinde döndürülür.
Herhangi bir ürün bölümünü duraklatmak için UpdateAssetGroups'u çağırarak varlık grubunun tamamını duraklatmalısınız. Kampanyanın tamamını duraklatmak için UpdateCampaigns'i çağırabilirsiniz.
Sil eylemi için yalnızca AssetGroupListingGroup'taId ve AssetGroupId değerini belirtmeniz gerekir.
Bir üst ürün bölümünü silerseniz, tüm alt öğeleri ve alt öğeleri de silinir.
Dalda yinelenen ürün koşulları belirtemeyebilirsiniz.

İstek Öğeleri

ApplyAssetGroupListingGroupActionsRequest 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ü
ListingGroupActions	Her biri bir Action öğesi ve bir ListingGroup öğesi içeren AssetGroupListingGroupAction nesnelerinin listesi. Grup eylemlerini listeleyen tüm varlık grubu eylemleri aynı varlık grubu için olmalıdır. Çağrı başına 5.000 AssetGroupListingGroupAction geçirebilir ve her varlık grubuna en fazla 20.000 listeleme grubu uygulayabilirsiniz.	AssetGroupListingGroupAction dizisi

İ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

ApplyAssetGroupListingGroupActionsResponse 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ü
AssetGroupListingGroupIds	Eylemin uygulandığı listeleme grupları için kimliklerin listesi. Kimlik listesi doğrudan istekteki grup listeleme listesine karşılık gelir. Herhangi bir listeleme grubu eylemi başarısız olursa, kalan tüm listeleme grubu eylemleri başarısız olur ve bu listedeki tüm öğeler null olur.	uzun dizi
PartialErrors	Başarılı olmayan istek öğelerinin ayrıntılarını içeren batcherror nesneleri dizisi.	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">ApplyAssetGroupListingGroupActions</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>
    <ApplyAssetGroupListingGroupActionsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <ListingGroupActions i:nil="false">
        <AssetGroupListingGroupAction>
          <Action>ValueHere</Action>
          <ListingGroup i:nil="false">
            <AssetGroupId>ValueHere</AssetGroupId>
            <AssetGroupListingType>ValueHere</AssetGroupListingType>
            <Dimension i:nil="false">
              <Attribute i:nil="false">ValueHere</Attribute>
              <Operand i:nil="false">ValueHere</Operand>
              <Operator i:nil="false">ValueHere</Operator>
            </Dimension>
            <Id i:nil="false">ValueHere</Id>
            <IsExcluded>ValueHere</IsExcluded>
            <ParentListingGroupId i:nil="false">ValueHere</ParentListingGroupId>
          </ListingGroup>
        </AssetGroupListingGroupAction>
      </ListingGroupActions>
    </ApplyAssetGroupListingGroupActionsRequest>
  </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>
    <ApplyAssetGroupListingGroupActionsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <AssetGroupListingGroupIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <a1:long>ValueHere</a1:long>
      </AssetGroupListingGroupIds>
      <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:e63="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e63:KeyValuePairOfstringstring>
              <e63:key d4p1:nil="false">ValueHere</e63:key>
              <e63:value d4p1:nil="false">ValueHere</e63:value>
            </e63: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>
    </ApplyAssetGroupListingGroupActionsResponse>
  </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<ApplyAssetGroupListingGroupActionsResponse> ApplyAssetGroupListingGroupActionsAsync(
	IList<AssetGroupListingGroupAction> listingGroupActions)
{
	var request = new ApplyAssetGroupListingGroupActionsRequest
	{
		ListingGroupActions = listingGroupActions
	};

	return (await CampaignManagementService.CallAsync((s, r) => s.ApplyAssetGroupListingGroupActionsAsync(r), request));
}

static ApplyAssetGroupListingGroupActionsResponse applyAssetGroupListingGroupActions(
	ArrayOfAssetGroupListingGroupAction listingGroupActions) throws RemoteException, Exception
{
	ApplyAssetGroupListingGroupActionsRequest request = new ApplyAssetGroupListingGroupActionsRequest();

	request.setListingGroupActions(listingGroupActions);

	return CampaignManagementService.getService().applyAssetGroupListingGroupActions(request);
}

static function ApplyAssetGroupListingGroupActions(
	$listingGroupActions)
{

	$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];

	$request = new ApplyAssetGroupListingGroupActionsRequest();

	$request->ListingGroupActions = $listingGroupActions;

	return $GLOBALS['CampaignManagementProxy']->GetService()->ApplyAssetGroupListingGroupActions($request);
}

response=campaignmanagement_service.ApplyAssetGroupListingGroupActions(
	ListingGroupActions=ListingGroupActions)

Gereksinimler

Hizmet: CampaignManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/CampaignManagement/v13

Aracılığıyla paylaş