DownloadCampaignsByAccountIds Hizmeti İşlemi - Toplu

Makale
12/21/2023

Hesabın tüm kampanyaları için ayarları ve performans verilerini indirir. Tüm kampanya verilerini veya yalnızca hesabı son indirdiğinizden bu yana değişen verileri isteyebilirsiniz.

İndirme isteği işlemi ( DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds) ve GetBulkDownloadStatus yoklama işlemi için aynı kullanıcı kimlik bilgilerini kullanmanız gerekir.

İpucu

Toplu Dosya Şeması, indirebileceğiniz ve karşıya yükleyebileceğiniz kayıtlar hakkında ayrıntılar sağlar. Kendiniz ve tüm Microsoft Advertising müşterileri için adil kullanım sağlamak için lütfen en iyi yöntemlere uyun. Ayrıntılar için bkz . Toplu İndirme En İyi Yöntemleri ve Toplu Yükleme En İyi Yöntemleri.

İstek Öğeleri

DownloadCampaignsByAccountIdsRequest 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ü
AccountIds	İndirilmesi gereken kampanya verilerini içeren hesabın tanımlayıcısı. Belirtebileceğiniz en fazla hesap sayısı birdir. İndirebileceğiniz hesabın boyutu dört milyon anahtar sözcükle sınırlıdır. 4 milyondan fazla anahtar sözcük içeren bir hesabı indirmeye çalışırsanız, çağrı 3207 (AccountTooBigToDownload) hatasıyla başarısız olur. Arama başarısız olursa, hesabı kampanyalara göre indirmek için lütfen DownloadCampaignsByCampaignIds işlemini çağırın. Hatanın Details öğesi, hesabın sahip olduğu kampanya kimliklerinin virgülle ayrılmış listesini içerir.	uzun dizi
Compressiontype	İndirme dosyasının sıkıştırma türü. Olası değerler için bkz . CompressionType. Varsayılan sıkıştırma türü Zip'tir.	Compressiontype
DataScope	Kampanya ayarları gibi varlık verilerine ek olarak reklam ilgi düzeyi gibi kalite puanı verilerini de ekleyebilirsiniz. Varsayılan değer EntityData'dı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, `<DataScope>EntityData QualityScoreData</DataScope>`. BidSuggestionsData veya QualityScoreData dahil edilirse, tam eşitleme istemeniz gerekir. Tam eşitleme gerçekleştirmek için LastSyncTimeInUTC'yi ayarlamayın, sıfır bırakın.	DataScope
Varlıkları İndir	İndirmeye eklenecek varlıklar. İndirebileceğiniz varlıkların listesi için bkz. DownloadEntity değer kümesi. En az bir indirme varlığı belirtmeniz gerekir; aksi takdirde işlem hata verir.	DownloadEntity dizisi
DownloadFileType	İndirme dosyasının dosya türü. Olası değerler için bkz. DownloadFileType. Varsayılan değer CSV'dir.	DownloadFileType
Formatversion	İndirme dosyasının kayıtlarının biçimi. En iyi yöntem olarak her zaman en son biçim sürümünü belirtmeniz gerekir. Şu anda Bing Ads API Sürüm 13 için desteklenen tek biçim sürümü 6.0'dır. Kayıtları ilgili biçim sürümü için Toplu Dosya Şemasına göre yönetmeniz gerekir.	Dize
LastSyncTimeInUTC	En son indirme isteğinde bulunduysanız. Tarih ve saat Eşgüdümlü Evrensel Saat (UTC) cinsinden ifade edilir. Son eşitleme zamanını belirtirseniz, yalnızca belirtilen tarih ve saatten sonra değiştirilen (eklenen, güncelleştirilen veya silinen) varlıklar indirilir. Ana kampanya veya reklam grubu belirtilen son eşitleme zamanından bu yana silinmişse, yalnızca silinen ana kampanya veya reklam grubu için silinmiş bir kayıt görürsünüz. Örneğin, bir kampanya silindiyse, toplu dosya kampanyadaki reklam grupları, ölçütler, reklamlar ve anahtar sözcükler için silinmiş kayıtları içermez. Hedef ölçüt diğer varlıklardan biraz farklı olarak değerlendirilir ve silinen kayıtlar döndürülemez. Bir kampanya veya reklam grubunun hedefine herhangi bir değişiklik yapıldıysa, o anda etkin olan tüm alt hedef ölçüt kayıtları döndürülür. Genellikle, bu öğeyi null olarak ayarlayarak işlemi ilk kez çağırdığınızda tam indirme isteğinde bulunursunuz. Sonraki tüm çağrılarda, son eşitleme zamanını önceki indirmenin zaman damgasına ayarlarsınız. İndirme dosyası, Hesap kaydının Eşitleme Zamanı sütununda indirmenin zaman damgasını içerir. Bu öğeyi bir sonraki indirme isteğinde bulunurken ayarlamak için Eşitleme Zamanı hesabını kullanmanız gerekir. 30 günden daha eski bir tarih ve saat ayarlarsanız bir hata döndürülür.	Datetime

İ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

DownloadCampaignsByAccountIdsResponse 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ü
DownloadRequestId	İndirme isteğinin tanımlayıcısı. İndirilme durumunu denetlemek için GetBulkDownloadStatus işlemini çağırmak için tanımlayıcıyı kullanırsınız. Tanımlayıcı en fazla iki gün geçerlidir. Dosyayı bu süre içinde başarıyla indirmediyseniz, indirme sitesinden kaldırılır ve yeni bir indirme isteği tanımlayıcısı almanız gerekir. Dizenin uzunluğu 40'a kadardır ve herhangi bir karakter içerebilir.	Dize

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">DownloadCampaignsByAccountIds</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>
    <DownloadCampaignsByAccountIdsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </AccountIds>
      <CompressionType i:nil="false">ValueHere</CompressionType>
      <DataScope>ValueHere</DataScope>
      <DownloadEntities i:nil="false">
        <DownloadEntity>ValueHere</DownloadEntity>
      </DownloadEntities>
      <DownloadFileType i:nil="false">ValueHere</DownloadFileType>
      <FormatVersion i:nil="false">ValueHere</FormatVersion>
      <LastSyncTimeInUTC i:nil="false">ValueHere</LastSyncTimeInUTC>
    </DownloadCampaignsByAccountIdsRequest>
  </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>
    <DownloadCampaignsByAccountIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <DownloadRequestId d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</DownloadRequestId>
    </DownloadCampaignsByAccountIdsResponse>
  </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<DownloadCampaignsByAccountIdsResponse> DownloadCampaignsByAccountIdsAsync(
	IList<long> accountIds,
	CompressionType? compressionType,
	DataScope dataScope,
	IList<DownloadEntity> downloadEntities,
	DownloadFileType? downloadFileType,
	string formatVersion,
	DateTime? lastSyncTimeInUTC)
{
	var request = new DownloadCampaignsByAccountIdsRequest
	{
		AccountIds = accountIds,
		CompressionType = compressionType,
		DataScope = dataScope,
		DownloadEntities = downloadEntities,
		DownloadFileType = downloadFileType,
		FormatVersion = formatVersion,
		LastSyncTimeInUTC = lastSyncTimeInUTC
	};

	return (await BulkService.CallAsync((s, r) => s.DownloadCampaignsByAccountIdsAsync(r), request));
}

static DownloadCampaignsByAccountIdsResponse downloadCampaignsByAccountIds(
	ArrayOflong accountIds,
	CompressionType compressionType,
	ArrayList<DataScope> dataScope,
	ArrayOfDownloadEntity downloadEntities,
	DownloadFileType downloadFileType,
	java.lang.String formatVersion,
	Calendar lastSyncTimeInUTC) throws RemoteException, Exception
{
	DownloadCampaignsByAccountIdsRequest request = new DownloadCampaignsByAccountIdsRequest();

	request.setAccountIds(accountIds);
	request.setCompressionType(compressionType);
	request.setDataScope(dataScope);
	request.setDownloadEntities(downloadEntities);
	request.setDownloadFileType(downloadFileType);
	request.setFormatVersion(formatVersion);
	request.setLastSyncTimeInUTC(lastSyncTimeInUTC);

	return BulkService.getService().downloadCampaignsByAccountIds(request);
}

static function DownloadCampaignsByAccountIds(
	$accountIds,
	$compressionType,
	$dataScope,
	$downloadEntities,
	$downloadFileType,
	$formatVersion,
	$lastSyncTimeInUTC)
{

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

	$request = new DownloadCampaignsByAccountIdsRequest();

	$request->AccountIds = $accountIds;
	$request->CompressionType = $compressionType;
	$request->DataScope = $dataScope;
	$request->DownloadEntities = $downloadEntities;
	$request->DownloadFileType = $downloadFileType;
	$request->FormatVersion = $formatVersion;
	$request->LastSyncTimeInUTC = $lastSyncTimeInUTC;

	return $GLOBALS['BulkProxy']->GetService()->DownloadCampaignsByAccountIds($request);
}

response=bulk_service.DownloadCampaignsByAccountIds(
	AccountIds=AccountIds,
	CompressionType=CompressionType,
	DataScope=DataScope,
	DownloadEntities=DownloadEntities,
	DownloadFileType=DownloadFileType,
	FormatVersion=FormatVersion,
	LastSyncTimeInUTC=LastSyncTimeInUTC)

Gereksinimler

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

Aracılığıyla paylaş