เรกคอร์ดรูปภาพ - จํานวนมาก

กําหนดรูปภาพที่สามารถอัปโหลดและดาวน์โหลดได้ในไฟล์จํานวนมาก

คุณสามารถดาวน์โหลดเรกคอร์ดรูปภาพทั้งหมดในบัญชีได้โดยการรวมค่า DownloadEntity ของรูปภาพในคําขอบริการ DownloadCampaignsByAccountIds หรือ DownloadCampaignsByCampaignIds นอกจากนี้ คําขอดาวน์โหลดต้องมีขอบเขต EntityData ด้วย สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับบริการแบบกลุ่ม รวมถึงแนวทางปฏิบัติที่ดีที่สุด ดูดาวน์โหลดและอัปโหลดเป็นกลุ่ม

ตัวอย่าง CSV จํานวนมากต่อไปนี้จะเพิ่มรูปภาพใหม่

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,

ถ้าคุณกําลังใช้ Bing Ads SDKs สําหรับ .NET, Java หรือ Python คุณสามารถประหยัดเวลาโดยใช้ BulkServiceManager เพื่ออัปโหลดและดาวน์โหลดวัตถุ BulkImage แทนที่จะเรียกใช้การดําเนินการบริการโดยตรง และเขียนโค้ดแบบกําหนดเองเพื่อแยกวิเคราะห์แต่ละเขตข้อมูลในไฟล์จํานวนมาก

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();

สําหรับระเบียนรูปภาพ เขตข้อมูลแอตทริบิวต์ต่อไปนี้จะพร้อมใช้งานใน Schema ไฟล์จํานวนมาก

• ID ไคลเอ็นต์
• ความสูง
• ID
• เวลาที่ปรับเปลี่ยน
• ID แม่
• สถานะ
• ชนิดย่อย
• ข้อความ
• URL
• ความกว้าง

ID ไคลเอ็นต์

ใช้เพื่อเชื่อมโยงระเบียนในไฟล์อัปโหลดจํานวนมากกับระเบียนในไฟล์ผลลัพธ์ ค่าของเขตข้อมูลนี้ไม่ได้ถูกใช้หรือเก็บโดยเซิร์ฟเวอร์ ให้ตั้งค่าเขตข้อมูลนี้ก่อนแล้วจึงเปิดใช้งานเขตข้อมูลนี้ เพียงแค่คัดลอกจากระเบียนที่อัปโหลดไปยังระเบียนผลลัพธ์ที่สอดคล้องกัน ซึ่งอาจเป็นสตริงที่ถูกต้องที่มีความยาวสูงสุด 100

เพิ่ม: เสริม
ลบ: อ่านอย่างเดียว

ความสูง

ความสูงของรูปที่จัดเก็บไว้ในไลบรารีสื่อของคุณ

ขนาดรูปภาพที่แสดงจะขึ้นอยู่กับอัตราส่วนกว้างยาวลิงก์สินทรัพย์ของคุณ เช่น ตามที่กําหนดไว้ในเขตข้อมูลรูปภาพของโฆษณาแบบตอบสนอง

เพิ่ม: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

ID

ตัวระบุที่ระบบสร้างขึ้นของรูป

เพิ่ม: เสริม คุณต้องปล่อยฟิลด์นี้ว่างไว้ หรือระบุตัวระบุค่าลบ จากนั้น สามารถอ้างอิงชุดตัวระบุที่เป็นลบสําหรับรูปภาพในชนิดระเบียนที่ไม่เป็นพึ่งพาได้ เช่น เขตข้อมูลรูปภาพของโฆษณาที่ตอบสนอง ขอแนะนําให้คุณเพิ่มรูปภาพใหม่และระเบียนที่ขึ้นต่อกันใหม่ในไฟล์ Bulk เดียวกัน สําหรับข้อมูลเพิ่มเติม ดูคีย์การอ้างอิง Schema ของไฟล์จํานวนมาก
ลบ: อ่านอย่างเดียวและจําเป็น

เวลาที่ปรับเปลี่ยน

วันที่และเวลาที่มีการอัปเดตเอนทิตีครั้งล่าสุด ค่าอยู่ในเวลามาตรฐานสากล (UTC)

หมายเหตุ

ค่าวันที่และเวลาแสดงวันที่และเวลาที่เซิร์ฟเวอร์ ไม่ใช่ไคลเอ็นต์ สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML

เพิ่ม: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

ID แม่

ตัวระบุที่ระบบสร้างขึ้นของบัญชีที่มีรูปภาพ

เขตข้อมูลจํานวนมากนี้จะแมปไปยังเขตข้อมูล Id ของระเบียนบัญชี

เพิ่ม: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

สถานะ

สถานะของรูป

ค่าที่เป็นไปได้คือ ใช้งานอยู่ หรือ ถูกลบ

เพิ่ม: เสริม ค่าเริ่มต้นคือ ใช้งานอยู่
ลบ: ต้องระบุ ต้องตั้งค่า สถานะ เป็น ลบ

ชนิดย่อย

ชนิดย่อยของรูปภาพระบุอัตราส่วนกว้างยาวที่สนับสนุนของรูปที่อัปโหลด

เราขอแนะนํา "GenericImage" ที่มีขนาดความกว้าง 703 x ความสูง 368 หรือสูงกว่า เป็นพิกเซล

ต้องตั้งค่าชนิดย่อยเป็น "โลโก้" หากรูปภาพเชื่อมโยงกับโฆษณาเป็น "LandscapeLogoMedia" หรือ "SquareLogoMedia"

ค่าชนิดย่อยที่สนับสนุนทั้งหมดที่มีข้อจํากัดด้านมิติและอัตราส่วนกว้างยาวที่สอดคล้องกันจะอธิบายไว้ด้านล่าง

ชนิดย่อย	อัตรา	มิติต่ําสุด
GenericImage	แตก ต่าง กัน	ความกว้าง 40 x ความสูง 40 เป็นพิกเซล
LandscapeLogoMedia	4:1	ความกว้าง 512 x ความสูง 128 เป็นพิกเซล
SquareLogoMedia	1:1	ความกว้าง 128 x ความสูง 128 เป็นพิกเซล
Image16x9	16:9	ความกว้าง 640 x ความสูง 360 เป็นพิกเซล
Image15x10	1.5:1	ความกว้าง 300 x ความสูง 200 เป็นพิกเซล
Image4x3	4:3	ความกว้าง 100 x 75 ความสูง เป็นพิกเซล
Image1x1	1:1	ความกว้าง 128 x ความสูง 128 เป็นพิกเซล
Image191x100	1.91:1	ความกว้าง 703 x ความสูง 368 เป็นพิกเซล
Image4x1	4:1	ความกว้าง 512 x ความสูง 128 เป็นพิกเซล

หมายเหตุ

ความกว้างและความสูงสูงสุดเป็นพิกเซลคือ 2592 และ 2048 เป็นอิสระจากกัน และคุณยังคงต้องรักษาอัตราส่วนกว้างยาวที่สนับสนุนอย่างใดอย่างหนึ่ง ตัวอย่างเช่น หากชนิดย่อยคือ Image191x100 และความกว้างคือ 2592 ความสูงต้องเป็น 1357

รูปภาพที่มีภาพเคลื่อนไหวไม่ได้รับการสนับสนุน ชนิด MIME ต่อไปนี้ได้รับการสนับสนุน

• GIF
• JPEG
• PNG

เคล็ดลับ

รูปภาพ PNG จะถูกแปลงเป็น JPEG หากคุณไม่พอใจกับคุณภาพหลังจากการแปลงเราขอแนะนําให้คุณระบุ JPEG โดยตรง

เพิ่ม: ต้องระบุ
ลบ: อ่านอย่างเดียว

ข้อความ

ข้อความแบบกําหนดเองหรือป้ายชื่อของรูปที่เก็บไว้ในไลบรารีสื่อของคุณ

เพิ่ม: เสริม
ลบ: อ่านอย่างเดียว

URL

URL ที่สามารถเข้าถึงรูปภาพได้

หากต้องการอัปโหลดรูปภาพใหม่ คุณต้องใส่ URL ชั่วคราวที่บริการจํานวนมากสามารถเข้าถึงและเรียกใช้รูปภาพของคุณได้

เมื่อคุณดาวน์โหลดรูปภาพ เขตข้อมูลนี้มี URL ที่ให้ไว้โดยบริการจํานวนมากซึ่งคุณสามารถเข้าถึงและเรียกใช้รูปภาพที่จัดเก็บไว้ได้ตามความจําเป็น

คุณสามารถอัปโหลดรูปภาพ PNG หรือ JPEG ได้ รูปภาพที่มีภาพเคลื่อนไหวไม่ได้รับการสนับสนุน รูปภาพ PNG จะถูกแปลงเป็น JPEG หากคุณไม่พอใจกับคุณภาพหลังจากการแปลงเราขอแนะนําให้คุณระบุ JPEG โดยตรง

เพิ่ม: ต้องระบุ
ลบ: อ่านอย่างเดียว

ความกว้าง

ความกว้างของรูปที่จัดเก็บไว้ในไลบรารีสื่อของคุณ

ขนาดรูปภาพที่แสดงจะขึ้นอยู่กับอัตราส่วนกว้างยาวลิงก์สินทรัพย์ของคุณ เช่น ตามที่กําหนดไว้ในเขตข้อมูลรูปภาพของโฆษณาแบบตอบสนอง

เพิ่ม: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว