Anzeigenmedien

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. Sie nimmt einen Namen und Bilddaten an. Die Daten werden als Blob-Datenaustauschobjekt bereitgestellt, das mit 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

Media-Bundles sind ZIP-Archive, die HTML5-Assets enthalten, mit denen HTML5-Anzeigen erstellt werden können. Lade Medienpakete mit der Klasse MediaBundleBuilder hoch. Sie nimmt einen Namen und Dateidaten an. Wie bei Bildern werden die 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. Mit dem Prädikat withCondition() können Sie Medien nach Name, Typ oder anderen Feldern 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 Codebeispiele zum Erstellen unterstützter Anzeigen mit angehängten Medien.