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 - 必須為 1 
                  TIME_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 (世界標準時間)。"],[],[]]