Display & Video 360 API 第 3 版已停用。
遷移至第 4 版。
  
        
 
     
  
  
  
    
  
  
  
    
  
  
    
      FrequencyCap
    
    
      
    
    
      
      透過集合功能整理內容
    
    
      
      你可以依據偏好儲存及分類內容。
    
  
    
  
      
    
  
  
  
  
  
    
    
    
  
  
    
    
    
    
    
    
    
      
      
        這項設定可控管在指定時間範圍內,同一位使用者看到同一則廣告的次數。
      
      
        
          
            
              | JSON 表示法 | 
          
          
            
              | {
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": integer
} | 
          
        
      
      
        
          
            
            
          
          
            
              | 欄位 | 
          
          
            
              | unlimited | boolean
 是否套用展示頻率無上限。如果這個欄位設為 true,其餘展示頻率上限欄位就不適用。 | 
            
              | timeUnit | enum (TimeUnit)
 套用展示頻率上限的時間單位。 如果 unlimited為false,則為必填屬性。 | 
            
              | timeUnitCount | integer
 展示頻率上限的持續時間。timeUnit 如果 unlimited為false,則為必要屬性。以下限制適用於timeUnit的值: 
                  TIME_UNIT_MONTHS- 必須為 1TIME_UNIT_WEEKS- 必須介於 1 到 4 之間TIME_UNIT_DAYS- 必須介於 1 到 6 之間TIME_UNIT_HOURS- 必須介於 1 至 23 之間TIME_UNIT_MINUTES- 必須介於 1 到 59 之間 | 
            
              | maxImpressions | integer
 使用者在這段期間內看到同一則廣告的次數上限。必須大於 0。 如果 unlimited為false且未設定maxViews,則為必要欄位。 | 
            
              | maxViews | integer
 (選用步驟) 在此期間,使用者最多可點閱或完整觀看廣告的次數,達到上限後,系統就不會再向他們放送廣告。必須大於 0。 僅適用於 YouTube 和合作夥伴資源。 如果 unlimited為false且未設定maxImpressions,則為必要欄位。 | 
          
        
      
    
  
  
  
  
    
  
 
  
    
      
      
    
    
      
    
    
  
       
         
  
       
    
    
      
    
  
  
  除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
  上次更新時間:2025-10-08 (世界標準時間)。
  
  
    
    
    
      
  
    
  
  
    
      [[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-10-08 (世界標準時間)。"],[],[]]