وسائط الإعلان

تتضمّن بعض أنواع الإعلانات، مثل ImageAd و ResponsiveDisplayAd، صورًا وعناصر وسائط أخرى. يصف هذا الدليل كيفية تحميل للاستعلام عن الوسائط باستخدام نصوص "إعلانات Google" البرمجية.

جارٍ تحميل الصور

يمكن تحميل الصور باستخدام ImageBuilder التي تتخذ بيانات الاسم والصورة. يتم توفير البيانات على شكل Blob كائن تبادل البيانات الذي يمكن تم إنشاؤها من خلال خدمات، مثل Drive أو استرجاع عنوان URL

يوضّح المقتطف التالي كيفية تحميل صورة من عنوان URL خارجي:

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

بدلاً من ذلك، يمكن أن يتم تحميل الكائن الثنائي الكبير (blob) للصورة من 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.

يوضِّح المقتطف التالي كيفية تحميل حِزمة وسائط من عنوان URL خارجي:

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" البرمجية باستخدام علامة MediaSelector. استخدِم العبارة withCondition() لفلترة الوسائط حسب الاسم أو النوع أو حقول أخرى. على سبيل المثال، يعثر المقتطف التالي على جميع الصور في الحساب:

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

إنشاء إعلانات باستخدام الوسائط

اطّلِع على مقالة الإعلانات لمعرفة بعض الأمثلة على الرموز التي تُستخدم لإنشاء إعلانات متوافقة مع الوسائط المرفقة.