การจัดการโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา

การสร้างตัววนซ้ำโฆษณาที่มีเงื่อนไข Type = RESPONSIVE_DISPLAY_AD จะวนซ้ำโฆษณาเดิมเท่านั้นในขณะนี้ เงื่อนไขนี้เลิกใช้งานแล้ว โปรด อัปเดตรหัสที่มีอยู่ให้ใช้ Type = LEGACY_RESPONSIVE_DISPLAY_AD อย่างชัดเจน หากต้องการ สร้างตัววนซ้ำโฆษณาสำหรับโฆษณาที่รองรับชิ้นงานข้อความ รูปภาพ และวิดีโอหลายรายการ ให้ใช้เงื่อนไข Type = MULTI_ASSET_RESPONSIVE_DISPLAY_AD

ข้อมูลโค้ดต่อไปนี้แสดงความแตกต่างและความคล้ายคลึงบางอย่างของ API ระหว่างโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา 2 ประเภท โปรดอ่านรายละเอียดเพิ่มเติมใน ข้อมูลอ้างอิงเกี่ยวกับโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา

    // let legacyRdaIterator = AdsApp.ads().withCondition("Type = RESPONSIVE_DISPLAY_AD").get();
    let legacyRdaIterator = AdsApp.ads().withCondition("Type = LEGACY_RESPONSIVE_DISPLAY_AD").get();
    while (legacyRdaIterator.hasNext()) {
      let responsiveDisplayAd = legacyRdaIterator.next().asType().responsiveDisplayAd();

      // Legacy responsive display ads have just one long headline.
      let longHeadline = responsiveDisplayAd.getLongHeadline();

      // And they have one short headline, too.
      let shortHeadline = responsiveDisplayAd.getShortHeadline();

      // This call to .getHeadlines() returns null, because the method is not
      // meaningful when called on a legacy responsive display ad.
      assert(responsiveDisplayAd.getHeadlines() === null);

      // ... etc. ...
    }

    let rdaIterator = AdsApp.ads().withCondition("Type = MULTI_ASSET_RESPONSIVE_DISPLAY_AD").get();
    while (rdaIterator.hasNext()) {
      let responsiveDisplayAd = rdaIterator.next().asType().responsiveDisplayAd();

      // Responsive display ads have just one long headline.
      let longHeadline = responsiveDisplayAd.getLongHeadline();

      // But they can have multiple short headline text assets.
      let shortHeadlineAssets = responsiveDisplayAd.getHeadlines();

      // This call to .getShortHeadline() returns null, because the method is only
      // meaningful when called on a legacy responsive display ad.
      assert(responsiveDisplayAd.getShortHeadline() === null);

      // ... etc. ...
    }

    let rdaAndLegacyIterator = AdsApp.ads().withCondition("Type IN [LEGACY_RESPONSIVE_DISPLAY_AD, MULTI_ASSET_RESPONSIVE_DISPLAY_AD]").get();
    while (rdaAndLegacyIterator.hasNext()) {
      let responsiveDisplayAd = legacyRdaIterator.next().asType().responsiveDisplayAd();
      let longHeadline = responsiveDisplayAd.getLongHeadline();

      // The .isLegacy() method can be used to differentiate between responsive
      // display ad types within an iterator over both.
      if (responsiveDisplayAd.isLegacy()) {
        let shortHeadline = responsiveDisplayAd.getShortHeadline();
        // ... etc. ...
      } else {
        let shortHeadlineAssets = responsiveDisplayAd.getHeadlines();
        // ... etc. ...
      }
    }