विज्ञापन मीडिया

कुछ तरह के विज्ञापनों में इमेज और दूसरे मीडिया एलिमेंट शामिल होते हैं. जैसे, ImageAd और ResponsiveDisplayAd. इस गाइड में, Google Ads स्क्रिप्ट का इस्तेमाल करके मीडिया अपलोड करने और उससे जुड़ी क्वेरी करने का तरीका बताया गया है.

इमेज अपलोड की जा रही हैं

इमेज को ImageBuilder क्लास का इस्तेमाल करके अपलोड किया जा सकता है. इसमें नाम और इमेज का डेटा शामिल होता है. डेटा को Blob डेटा इंटरचेंज ऑब्जेक्ट के तौर पर दिया जाता है. इसे Drive या यूआरएल फ़ेच जैसी सेवाओं से बनाया जा सकता है.

यहां दिए गए स्निपेट में, किसी बाहरी यूआरएल से इमेज अपलोड करने का तरीका बताया गया है:

let imageUrl = "http://www.example.com/example.png";
let imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

इसके अलावा, इमेज ब्लॉब को Google Drive से भी लोड किया जा सकता है:

let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

मीडिया बंडल अपलोड करना

मीडिया बंडल, ZIP फ़ॉर्मैट में मौजूद ऐसे संग्रह होते हैं जिनमें HTML5 एसेट होती हैं. इनका इस्तेमाल HTML5 विज्ञापन बनाने के लिए किया जा सकता है. MediaBundleBuilder क्लास वाले मीडिया बंडल अपलोड करें. क्लास में नाम और फ़ाइल का डेटा होता है. इमेज की तरह ही, डेटा को Blob डेटा इंटरचेंज ऑब्जेक्ट के तौर पर उपलब्ध कराया जाता है.

यहां दिए गए स्निपेट में, किसी बाहरी यूआरएल से मीडिया बंडल अपलोड करने का तरीका बताया गया है:

let mediaBundleUrl = "http://www.example.com/example.zip";
let mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

मीडिया के बारे में क्वेरी करना

Google Ads स्क्रिप्ट में, MediaSelector का इस्तेमाल करके हर तरह के मीडिया की क्वेरी की जा सकती है. मीडिया को नाम, टाइप या अन्य फ़ील्ड के हिसाब से फ़िल्टर करने के लिए, withCondition() का इस्तेमाल करें. उदाहरण के लिए, यहां दिया गया स्निपेट, किसी खाते में मौजूद सभी इमेज ढूंढता है:

let mediaIterator = AdsApp.adMedia().media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  let image = mediaIterator.next();
}

मीडिया के साथ विज्ञापन बनाना

अटैच किए गए मीडिया के साथ काम करने वाले विज्ञापन बनाने के लिए, कोड के कुछ उदाहरण देखने के लिए, विज्ञापन लेख देखें.