2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合(EU)の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ&ビデオ 360 API と SDF のアップロードは失敗します。統合を更新してこの宣言を行う方法について詳しくは、
非推奨のページをご覧ください。
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
この期間中に 1 人のユーザーに同じ広告を表示できる最大回数。0 より大きくする必要があります。 unlimited が false で、maxViews が設定されていない場合は必須です。
|
maxViews |
integer
省略可。ユーザーに広告が表示されなくなるまでの期間に、ユーザーが広告をクリックまたは完全に表示できる回数の上限。0 より大きくする必要があります。 YouTube とパートナーのリソースにのみ適用されます。 unlimited が false で、maxImpressions が設定されていない場合は必須です。
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eFrequency capping settings determine how often a user sees the same ad within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThese settings offer control over the maximum impressions or views a user receives within a defined period.\u003c/p\u003e\n"],["\u003cp\u003eYou can set frequency caps based on various time units (lifetime, months, weeks, days, hours, minutes) and limits.\u003c/p\u003e\n"],["\u003cp\u003eThe "unlimited" option bypasses other frequency cap settings, allowing for unlimited ad exposure.\u003c/p\u003e\n"],["\u003cp\u003eFor YouTube and Partner resources, you can set limits for both impressions (ad displays) and views (clicks or full views).\u003c/p\u003e\n"]]],[],null,["# FrequencyCap\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nSettings that control the number of times a user may be shown with the same ad during a given time period.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"unlimited\": boolean, \"timeUnit\": enum (/display-video/api/reference/rest/v3/TimeUnit), \"timeUnitCount\": integer, \"maxImpressions\": integer, \"maxViews\": integer } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unlimited` | `boolean` Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. |\n| `timeUnit` | `enum (`[TimeUnit](/display-video/api/reference/rest/v3/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_MONTHS` - must be 1 - `TIME_UNIT_WEEKS` - must be between 1 and 4 - `TIME_UNIT_DAYS` - must be between 1 and 6 - `TIME_UNIT_HOURS` - must be between 1 and 23 - `TIME_UNIT_MINUTES` - must be between 1 and 59 |\n| `maxImpressions` | `integer` The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.max_views) is not set. |\n| `maxViews` | `integer` Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.max_impressions) is not set. |"]]