Certains types d'annonces, ImageAd et ResponsiveDisplayAd, qui contiennent des images et d'autres éléments multimédias. Ce guide explique comment importer et d'interroger des médias à l'aide de scripts Google Ads.
Importation des images
Les images peuvent être importées à l'aide de l'
ImageBuilder
, qui accepte un nom et des données d'image. Les données sont fournies sous forme
objet d'échange de données Blob
pouvant être
créés par des services tels que Drive ou
Récupération d'URL.
L'extrait de code suivant montre comment importer une image à partir d'une URL externe:
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();
Vous pouvez également charger le blob de l'image depuis Google Drive:
let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
.withName("IMAGE_NAME")
.withData(imageBlob)
.build();
Importer des kits média
Les kits média sont des archives ZIP contenant des éléments HTML5, qui peuvent être utilisés pour
Créer des annonces HTML5
Importez des kits média avec
MediaBundleBuilder
, qui accepte un nom et des données de fichier. Comme pour les images, les données sont fournies
un objet d'échange de données Blob
.
L'extrait de code suivant montre comment importer un kit média à partir d'une URL externe:
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();
Interroger des médias
Les médias de tous types peuvent être interrogés dans les scripts Google Ads à l'aide d'un
MediaSelector
Utilisez les
withCondition()
prédicat pour filtrer les contenus multimédias par nom, type ou d'autres champs. Par exemple,
L'extrait de code suivant trouve toutes les images d'un compte:
let mediaIterator = AdsApp.adMedia().media()
.withCondition("Type = IMAGE")
.get();
while (mediaIterator.hasNext()) {
let image = mediaIterator.next();
}
Créer des annonces avec des médias
Consultez notre article sur les annonces pour obtenir du code. Exemples de création d'annonces compatibles avec des éléments multimédias associés