Einige Anzeigentypen wie ImageAd und ResponsiveDisplayAd enthalten Bilder und andere Medienelemente. In diesem Leitfaden wird beschrieben, wie Sie Medien mithilfe von Google Ads-Skripts hochladen und abfragen.
Bilder hochladen
Bilder können mit der Klasse ImageBuilder
hochgeladen werden. Dafür sind ein Name und Bilddaten erforderlich. Die Daten werden als Blob
-Datenaustauschobjekt bereitgestellt, das von Diensten wie Drive oder URL-Abruf erstellt werden kann.
Mit dem folgenden Snippet wird ein Bild von einer externen URL hochgeladen:
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();
Alternativ kann das Bild-Blob-Objekt aus Google Drive hochgeladen werden:
let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
.withName("IMAGE_NAME")
.withData(imageBlob)
.build();
MediaBundles hochladen
Mediasets sind ZIP-Archive mit HTML5-Assets, mit denen HTML5-Anzeigen erstellt werden können.
Laden Sie Mediasets mit der Klasse MediaBundleBuilder
hoch, für die ein Name und Dateidaten erforderlich sind. Wie bei Bildern werden Daten als Blob
-Datenaustauschobjekt bereitgestellt.
Mit dem folgenden Snippet wird ein MediaBundle von einer externen URL hochgeladen:
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();
Medien abfragen
In Google Ads-Skripts können mit einem MediaSelector
Medien jedes Typs abgefragt werden.
Verwenden Sie das Prädikat withCondition()
, um Medien nach Name, Typ oder anderen Feldern zu filtern. Mit dem folgenden Snippet werden beispielsweise alle Bilder in einem Konto gesucht:
let mediaIterator = AdsApp.adMedia().media()
.withCondition("Type = IMAGE")
.get();
while (mediaIterator.hasNext()) {
let image = mediaIterator.next();
}
Anzeigen mit Medien erstellen
In unserem Artikel zu Anzeigen finden Sie einige Codebeispiele zum Erstellen unterstützter Anzeigen mit angehängten Medien.