Görüntü Kaydı - Toplu

Toplu bir dosyaya yüklenip indirilebilen bir görüntü tanımlar.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğindeki GörüntülerinDownloadEntity değerini ekleyerek hesaptaki tüm Görüntü kayıtlarını indirebilirsiniz. Ayrıca indirme isteğinin EntityData kapsamını içermesi gerekir. En iyi yöntemler de dahil olmak üzere Toplu hizmet hakkında daha fazla ayrıntı için bkz. Toplu İndirme ve Karşıya Yükleme.

Aşağıdaki Toplu CSV örneği yeni bir görüntü ekler.

Type,Status,Id,Parent Id,Client Id,Modified Time,Text,Url,Name
Format Version,,,,,,,,,,6.0
Image,Active,-20,0,ClientIdGoesHere,,My Image,https://contoso.com/PhotoStock_123.jpg,

.NET, Java veya Python için Bing Ads SDK'larını kullanıyorsanız, toplu dosyadaki her alanı ayrıştırmak için hizmet işlemlerini doğrudan çağırmak ve özel kod yazmak yerine BulkServiceManager kullanarak BulkImage nesnesini karşıya yükleyip indirebilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkImage
var bulkImage = new BulkImage
{
    // 'Id' column header in the Bulk file
    Id = imageIdKey,
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Height' column header in the Bulk file
    Height = null,
    // 'Width' column header in the Bulk file
    Width = null,
    // 'Url' column header in the Bulk file
    Url = "https://contoso.com/PhotoStock_123.jpg",
    // 'Sub Type' column header in the Bulk file
    SubType = "GenericImage",
    // 'Text' column header in the Bulk file
    Text = "My Image",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImage);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Görüntü kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

• İstemci Kimliği
• Yükseklik
• Kimliği
• Değiştirme Zamanı
• Üst Kimlik
• Durum
• Alt Tür
• Metin
• URL
• Genişlik

İstemci Kimliği

Toplu karşıya yükleme dosyasındaki kayıtları sonuç dosyasındaki kayıtlarla ilişkilendirmek için kullanılır. Bu alanın değeri sunucu tarafından kullanılmaz veya depolanmaz; yalnızca karşıya yüklenen kayıttan ilgili sonuç kaydına kopyalanır. Uzunluğu 100'e kadar olan geçerli bir dize olabilir.

Eklemek: Opsiyonel
Silmek: Salt okunur

Yükseklik

Medya kitaplığınızda depolanan görüntünün yüksekliği.

Görüntülenen görüntü boyutları kısmen varlık bağlantınızın en boy oranlarına (örneğin, Duyarlı Reklam'ınGörüntüler alanında tanımlandığı gibi) bağlıdır.

Eklemek: Salt okunur
Silmek: Salt okunur

Kimlik

Görüntünün sistem tarafından oluşturulan tanımlayıcısı.

Eklemek: Opsiyonel. Bu alanı boş bırakmanız veya negatif bir tanımlayıcı belirtmeniz gerekir. Daha sonra, duyarlı bir reklamınGörüntüler alanı gibi bağımlı kayıt türlerinde görüntü için negatif tanımlayıcı kümesine başvurulabilir. Aynı Toplu dosyaya yeni görüntü ve yeni bağımlı kayıtlar ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Silmek: Salt okunur ve Gerekli

Değiştirme Zamanı

Varlığın son güncelleştirildiği tarih ve saat. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir.

Not

Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.

Eklemek: Salt okunur
Silmek: Salt okunur

Üst Kimlik

Görüntüyü içeren hesabın sistem tarafından oluşturulan tanımlayıcısı.

Bu toplu alan, Firma kaydının Kimlik alanına eşler.

Eklemek: Salt okunur
Silmek: Salt okunur

Durum

Görüntünün durumu.

Olası değerler Etkin veya Silinmiş değerlerdir.

Eklemek: Opsiyonel. Varsayılan değer Etkin'dir.
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.

Alt Tür

Resim alt türü, karşıya yüklenen görüntünün desteklenen en boy oranını gösterir.

Piksel cinsinden 703 genişlik x 368 yükseklik veya üzeri boyuta sahip "GenericImage" değerini öneririz.

Resim bir reklamla "LandscapeLogoMedia" veya "SquareLogoMedia" olarak ilişkilendirilmişse alt türü "Logo" olarak ayarlanmalıdır.

İlgili boyut ve en boy oranı kısıtlamalarına sahip desteklenen tüm alt tür değerleri aşağıda açıklanmıştır.

Alt Tür	En Boy Oranı	En Küçük Boyut
GenericImage	Değişir	40 genişlik x 40 yükseklik, piksel cinsinden
LandscapeLogoMedia	4:1	512 genişlik x 128 yükseklik, piksel cinsinden
SquareLogoMedia	1:1	Piksel cinsinden 128 genişlik x 128 yükseklik
Resim16x9	16:9	Piksel cinsinden 640 genişlik x 360 yükseklik
Resim15x10	1.5:1	Piksel cinsinden 300 genişlik x 200 yükseklik
Resim4x3	4:3	100 genişlik x 75 yükseklik, piksel cinsinden
Resim1x1	1:1	Piksel cinsinden 128 genişlik x 128 yükseklik
Resim191x100	1.91:1	Piksel cinsinden 703 genişlik x 368 yükseklik
Resim4x1	4:1	512 genişlik x 128 yükseklik, piksel cinsinden

Not

Piksel cinsinden maksimum genişlik ve yükseklik 2592 ve 2048'tir ve desteklenen en boy oranlarından birini korumanız gerekir. Örneğin, alt tür Image191x100 ve genişlik 2592 ise, yükseklik 1357 olmalıdır.

Animasyonlu görüntüler desteklenmez. Aşağıdaki MIME türleri desteklenir.

• GIF
• JPEG
• PNG

İpucu

PNG görüntüleri JPEG'e dönüştürülür. Dönüştürmeden sonra kaliteden memnun değilseniz, doğrudan JPEG sağlamanızı öneririz.

Eklemek: Gerekli
Silmek: Salt okunur

Metin

Medya kitaplığınızda depolanan görüntünün özel metni veya etiketi.

Eklemek: Opsiyonel
Silmek: Salt okunur

URL

Görüntüye erişilebilen URL.

Yeni bir görüntüyü karşıya yüklemek için Toplu hizmetin görüntünüze erişebileceği ve görüntünüzü alabildiği geçici bir URL sağlamanız gerekir.

Görüntüyü indirdiğinizde bu alan, toplu hizmet tarafından sağlanan ve depolanmış görüntüye gerektiği gibi erişebileceğiniz ve görüntü alabildiğiniz bir URL içerir.

PNG veya JPEG görüntüsünü karşıya yükleyebilirsiniz. Animasyonlu görüntüler desteklenmez. PNG görüntüleri JPEG'e dönüştürülür. Dönüştürmeden sonra kaliteden memnun değilseniz, doğrudan JPEG sağlamanızı öneririz.

Eklemek: Gerekli
Silmek: Salt okunur

Genişlik

Medya kitaplığınızda depolanan görüntünün genişliği.

Görüntülenen görüntü boyutları kısmen varlık bağlantınızın en boy oranlarına (örneğin, Duyarlı Reklam'ınGörüntüler alanında tanımlandığı gibi) bağlıdır.

Eklemek: Salt okunur
Silmek: Salt okunur