GetBulkUploadStatus Hizmet İşlemi - Toplu

Makale
07/04/2024

Toplu karşıya yükleme isteğinin durumunu ve tamamlanma ilerleme durumunu alır.

İstek Öğeleri

GetBulkUploadStatusRequest 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ü
RequestId	Karşıya yükleme isteğinin tanımlayıcısı. Tanımlayıcı 15 dakikaya kadar geçerlidir. Bu süre içinde dosyayı başarıyla karşıya yüklemediyseniz, yeni bir istek tanımlayıcısı almanız ve URL'yi karşıya yüklemeniz gerekir.	dizgi

İ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ı.	dizgi
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.	dizgi
CustomerId	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.	dizgi
DeveloperToken	Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma.	dizgi
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.	dizgi
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.	dizgi

Yanıt Öğeleri

GetBulkUploadStatusResponse 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ü
Hata	HTTP POST karşıya yüklemeniz tamamlandıktan sonra toplu dosyanın sistem işlemi sırasında karşılaşılan hatalara karşılık gelen OperationError nesneleri dizisi. Örneğin, bir OperationError , karşıya yüklenen dosya ilgili dosya biçimi sürümüyle desteklenmeyen bir veya daha fazla toplu kayıt içeriyorsa BulkServiceFormatVersionNotSupported hata kodunu içerir.	OperationError dizisi
İletme Uyumluluğu Haritası	Geçerli API sürümüne yeni öğeler eklendiğinde başka değişikliklerden kaçınmak için ileriye dönük uyumluluk için anahtar ve değer dizelerinin listesi. İleriye dönük uyumluluk değişiklikleri gelecek sürümlerde burada not alınacaktır. Şu anda bu işlem için ileriye dönük uyumluluk değişikliği yoktur.	KeyValuePairOfstringstring dizisi
Yüzde Tamamlama	Karşıya yüklenen toplu dosyanın sistem işlemesi için ilerleme tamamlanma yüzdesi. Değer aralığı 0 ile 100 arasındadır. Karşıya yükleme durumunu da karşılaştırmanız gerekir. Karşıya yükleme başarısız olursa tamamlanma yüzdesi sıfıra (0) sıfırlanır.	Int
RequestStatus	Karşıya yüklemenin durumu. Aşağıdakiler olası döndürülen durum değerleridir. Tamamlandı - Karşıya yükleme dosyası kabul edildi ve hatasız olarak başarıyla işlendi. CompletedWithErrors - Karşıya yükleme bir veya daha fazla hatayla tamamlandı. Genel karşıya yükleme başarılı olsa da bir veya daha fazla ekleme veya güncelleştirme hatası oluşmuş olabilir. En iyi yöntem olarak, GetBulkUploadUrl çağrılırken ResponseMode öğesi aracılığıyla hata bilgileri istemeniz ve hataların ResultFileUrl öğesini denetlemeniz gerekir. Başarısız - Yüklemenin tamamı beklenmeyen bir hata nedeniyle başarısız oldu. Daha az varlık içeren yeni bir karşıya yükleme gönderebilir veya aynı yüklemeyi daha sonra göndermeyi yeniden deneyebilirsiniz. FileUploaded - Karşıya yükleme isteği alındı ve işlenmek üzere kuyrukta. InProgress - Karşıya yükleme dosyası kabul edildi ve karşıya yükleme işlemi devam ediyor. PendingFileUpload - Karşıya yükleme dosyası ilgili RequestId için alınmadı. UploadFileRowCountExceeded - Karşıya yükleme dosyasındaki toplu kayıt sınırı aşıldı. Sınırlar ve karşıya yükleme ile ilgili en iyi yöntemler hakkında daha fazla bilgi için bkz. Toplu Yükleme. UploadFileFormatNotSupported - Yüklemede belirtilen SürümAdını Biçimlendir alanı, Toplu API'nin bu sürümü için desteklenmiyor.	dizgi
ResultFileUrl	İstenen sonuçları içeren dosyanın URL'si, örneğin karşıya yükleme hatası bilgileri. URL, GetBulkUploadStatus işleminin Completed veya CompletedWithErrors durum yanıt dizesini döndürdüğü beş dakika içinde kullanılmalıdır. İndirme işlemini bu süre içinde başlatmazsanız, yeni bir URL almak için GetBulkUploadStatus'ı yeniden çağırmanız gerekir. İndirme URL'sinin etki alanına bağımlılık almamalısınız, bu durum değiştirilebilir.	dizgi

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ı.	dizgi

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">GetBulkUploadStatus</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>
    <GetBulkUploadStatusRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <RequestId i:nil="false">ValueHere</RequestId>
    </GetBulkUploadStatusRequest>
  </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>
    <GetBulkUploadStatusResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <Errors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <OperationError>
          <Code>ValueHere</Code>
          <Details d4p1:nil="false">ValueHere</Details>
          <ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
          <Message d4p1:nil="false">ValueHere</Message>
        </OperationError>
      </Errors>
      <ForwardCompatibilityMap xmlns:e216="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e216:KeyValuePairOfstringstring>
          <e216:key d4p1:nil="false">ValueHere</e216:key>
          <e216:value d4p1:nil="false">ValueHere</e216:value>
        </e216:KeyValuePairOfstringstring>
      </ForwardCompatibilityMap>
      <PercentComplete>ValueHere</PercentComplete>
      <RequestStatus d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</RequestStatus>
      <ResultFileUrl d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</ResultFileUrl>
    </GetBulkUploadStatusResponse>
  </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<GetBulkUploadStatusResponse> GetBulkUploadStatusAsync(
	string requestId)
{
	var request = new GetBulkUploadStatusRequest
	{
		RequestId = requestId
	};

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

static GetBulkUploadStatusResponse getBulkUploadStatus(
	java.lang.String requestId) throws RemoteException, Exception
{
	GetBulkUploadStatusRequest request = new GetBulkUploadStatusRequest();

	request.setRequestId(requestId);

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

static function GetBulkUploadStatus(
	$requestId)
{

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

	$request = new GetBulkUploadStatusRequest();

	$request->RequestId = $requestId;

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

response=bulk_service.GetBulkUploadStatus(
	RequestId=RequestId)

Gereksinimler

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

Aracılığıyla paylaş