提交版本 4.13.1

lpw

2026-07-16 5c57c740c1a3a7acbb384dcf2557fd129fa7328c

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
//
//  GADAppOpenAdPreloader_Beta.h
//  Google Mobile Ads SDK
//
//  Copyright © 2025 Google Inc. All rights reserved.
//
 
#import <Foundation/Foundation.h>
#import <GoogleMobileAds/GADAppOpenAd.h>
#import <GoogleMobileAds/GADMobileAds.h>
#import <GoogleMobileAds/GADPreloadDelegate_Beta.h>
 
@class GADAppOpenAd;
@class GADPreloadConfigurationV2;
 
NS_SWIFT_NAME(AppOpenAdPreloader)
@interface GADAppOpenAdPreloader : NSObject
 
/// Returns the shared GADAppOpenAdPreloader instance.
@property(class, nonatomic, readonly, nonnull)
    GADAppOpenAdPreloader *sharedInstance NS_SWIFT_NAME(shared);
 
/// Starts preloading app open ads from the configuration for the given preload ID.
/// If a delegate is provided, ad events will be forwarded to the delegate.
/// Returns false if preload failed to start. Check console for error log.
///
/// @param preloadID A string that refers to a set of preloaded ads.
/// @param configuration A GADPreloadConfigurationV2 instance.
/// @param delegate An optional delegate to receive ad event callbacks.
- (BOOL)preloadForPreloadID:(nonnull NSString *)preloadID
              configuration:(nonnull GADPreloadConfigurationV2 *)configuration
                   delegate:(nullable id<GADPreloadDelegate>)delegate
    NS_SWIFT_NAME(preload(for:configuration:delegate:));
 
/// Returns whether an app open ad is preloaded for the given preload ID.
///
/// @param preloadID A string that refers to a set of preloaded ads.
- (BOOL)isAdAvailableWithPreloadID:(nonnull NSString *)preloadID
    NS_SWIFT_NAME(isAdAvailable(with:));
 
/// Returns a preloaded app open ad for the given preload ID. Returns nil if an ad is not
/// available.
///
/// @param preloadID A string that refers to a set of preloaded ads.
- (nullable GADAppOpenAd *)adWithPreloadID:(nonnull NSString *)preloadID NS_SWIFT_NAME(ad(with:));
 
/// Returns the responseInfo of a preloaded app open ad for the given preload ID without removing
/// the ad from the queue. Returns nil if an ad is not available.
///
/// @param preloadID A string that refers to a set of preloaded ads.
- (nullable GADResponseInfo *)adResponseInfoWithPreloadID:(nonnull NSString *)preloadID
    NS_SWIFT_NAME(responseInfo(with:));
 
/// Returns the number of preloaded app open ads available for the given preload ID.
///
/// @param preloadID A string that refers to a set of preloaded ads.
- (NSUInteger)numberOfAdsAvailableWithPreloadID:(nonnull NSString *)preloadID
    NS_SWIFT_NAME(numberOfAdsAvailable(with:));
 
/// Stops preloading app open ads and removes preloaded app open ads for the given preload ID.
///
/// @param preloadID A string that refers to a set of preloaded ads.
- (void)stopPreloadingAndRemoveAdsForPreloadID:(nonnull NSString *)preloadID
    NS_SWIFT_NAME(stopPreloadingAndRemoveAds(for:));
 
/// Stops preloading all app open ads and removes all preloaded app open ads.
- (void)stopPreloadingAndRemoveAllAds;
 
/// Returns the corresponding configuration for the given preload ID.
///
/// @param preloadID A string that refers to a set of preloaded ads.
- (nullable GADPreloadConfigurationV2 *)configurationWithPreloadID:(nonnull NSString *)preloadID
    NS_SWIFT_NAME(configuration(with:));
 
/// Returns a map of preload IDs to their corresponding configurations.
- (nonnull NSDictionary<NSString *, GADPreloadConfigurationV2 *> *)configurations;
 
@end