Configuration of the timespan of the items to include in
scanning. Currently only supported when inspecting Cloud Storage
and BigQuery.
Attributes
Name
Description
start_time
google.protobuf.timestamp_pb2.Timestamp
Exclude files, tables, or rows older than
this value. If not set, no lower time limit is
applied.
end_time
google.protobuf.timestamp_pb2.Timestamp
Exclude files, tables, or rows newer than
this value. If not set, no upper time limit is
applied.
timestamp_field
google.cloud.dlp_v2.types.FieldId
Specification of the field containing the timestamp of
scanned items. Used for data sources like Datastore and
BigQuery.
**For BigQuery**
If this value is not specified and the table was modified
between the given start and end times, the entire table will
be scanned. If this value is specified, then rows are
filtered based on the given start and end times. Rows with a
NULL value in the provided BigQuery column are skipped.
Valid data types of the provided BigQuery column are:
INTEGER, DATE, TIMESTAMP, and DATETIME.
If your BigQuery table is `partitioned at ingestion
time
enable_auto_population_of_timespan_config
bool
When the job is started by a JobTrigger we will
automatically figure out a valid start_time to avoid
scanning files that have not been modified since the last
time the JobTrigger executed. This will be based on the time
of the execution of the last run of the JobTrigger or the
timespan end_time used in the last run of the JobTrigger.
**For BigQuery**
Inspect jobs triggered by automatic population will scan
data that is at least three hours old when the job starts.
This is because streaming buffer rows are not read during
inspection and reading up to the current timestamp will
result in skipped rows.
See the `known
issue
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class TimespanConfig (3.31.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.31.0 (latest)](/python/docs/reference/dlp/latest/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.30.0](/python/docs/reference/dlp/3.30.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.29.0](/python/docs/reference/dlp/3.29.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.28.0](/python/docs/reference/dlp/3.28.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.27.0](/python/docs/reference/dlp/3.27.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.26.0](/python/docs/reference/dlp/3.26.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.25.1](/python/docs/reference/dlp/3.25.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.24.0](/python/docs/reference/dlp/3.24.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.23.0](/python/docs/reference/dlp/3.23.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.22.0](/python/docs/reference/dlp/3.22.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.20.0](/python/docs/reference/dlp/3.20.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.19.0](/python/docs/reference/dlp/3.19.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.18.1](/python/docs/reference/dlp/3.18.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.17.0](/python/docs/reference/dlp/3.17.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.16.0](/python/docs/reference/dlp/3.16.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.15.3](/python/docs/reference/dlp/3.15.3/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.14.0](/python/docs/reference/dlp/3.14.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.13.0](/python/docs/reference/dlp/3.13.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.12.3](/python/docs/reference/dlp/3.12.3/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.11.1](/python/docs/reference/dlp/3.11.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.10.1](/python/docs/reference/dlp/3.10.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.9.2](/python/docs/reference/dlp/3.9.2/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.8.1](/python/docs/reference/dlp/3.8.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.7.1](/python/docs/reference/dlp/3.7.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.6.2](/python/docs/reference/dlp/3.6.2/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.5.0](/python/docs/reference/dlp/3.5.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.4.0](/python/docs/reference/dlp/3.4.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.3.1](/python/docs/reference/dlp/3.3.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.2.4](/python/docs/reference/dlp/3.2.4/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.1.1](/python/docs/reference/dlp/3.1.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [3.0.1](/python/docs/reference/dlp/3.0.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [2.0.2](/python/docs/reference/dlp/2.0.2/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [1.0.2](/python/docs/reference/dlp/1.0.2/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [0.15.2](/python/docs/reference/dlp/0.15.2/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [0.14.0](/python/docs/reference/dlp/0.14.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [0.13.0](/python/docs/reference/dlp/0.13.0/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig)\n- [0.12.1](/python/docs/reference/dlp/0.12.1/google.cloud.dlp_v2.types.StorageConfig.TimespanConfig) \n\n TimespanConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nConfiguration of the timespan of the items to include in\nscanning. Currently only supported when inspecting Cloud Storage\nand BigQuery."]]