रिस्पॉन्सिव डिसप्ले विज्ञापनों को मैनेज करना

Type = RESPONSIVE_DISPLAY_AD शर्त के साथ विज्ञापन इटरेटर बनाने से, फ़िलहाल सिर्फ़ लेगसी विज्ञापनों पर इसे दोहराया जाएगा. यह शर्त हटा दी गई है: कृपया मौजूदा कोड को अपडेट करें, ताकि Type = LEGACY_RESPONSIVE_DISPLAY_AD का इस्तेमाल किया जा सके. कई टेक्स्ट, इमेज, और वीडियो एसेट दिखाने वाले विज्ञापनों पर विज्ञापन इटरेटर बनाने के लिए, स्थिति Type = MULTI_ASSET_RESPONSIVE_DISPLAY_AD का इस्तेमाल करें.

इस स्निपेट में, दो तरह के रिस्पॉन्सिव डिसप्ले विज्ञापनों के बीच एपीआई में होने वाले कुछ अंतर और समानताओं को दिखाया गया है. ज़्यादा जानकारी के लिए रिस्पॉन्सिव डिसप्ले विज्ञापन (स्क्रीन के हिसाब से साइज़ बदलने वाले विज्ञापन) की जानकारी पढ़ें.

// 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. ...
  }
}