Class: Google::Privacy::Dlp::V2::CustomInfoType

Inherits:
Object
  • Object
show all
Defined in:
lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb

Overview

Custom information type provided by the user. Used to find domain-specific sensitive information configurable to the data in question.

Defined Under Namespace

Modules: ExclusionType Classes: DetectionRule, Dictionary, Regex, SurrogateType

Instance Attribute Summary collapse

Instance Attribute Details

#detection_rules ⇒ Array<Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule>

Returns Set of detection rules to apply to all findings of this CustomInfoType. Rules are applied in order that they are specified. Not supported for the surrogate_type CustomInfoType.

Returns:



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb', line 80

class CustomInfoType
  # Custom information type based on a dictionary of words or phrases. This can
  # be used to match sensitive information specific to the data, such as a list
  # of employee IDs or job titles.
  #
  # Dictionary words are case-insensitive and all characters other than letters
  # and digits in the unicode [Basic Multilingual
  # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
  # will be replaced with whitespace when scanning for matches, so the
  # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
  # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
  # surrounding any match must be of a different type than the adjacent
  # characters within the word, so letters must be next to non-letters and
  # digits next to non-digits. For example, the dictionary word "jen" will
  # match the first three letters of the text "jen123" but will return no
  # matches for "jennifer".
  #
  # Dictionary words containing a large number of characters that are not
  # letters or digits may result in unexpected findings because such characters
  # are treated as whitespace. The
  # [limits](https://cloud.google.com/dlp/limits) page contains details about
  # the size limits of dictionaries. For dictionaries that do not fit within
  # these constraints, consider using `LargeCustomDictionaryConfig` in the
  # `StoredInfoType` API.
  # @!attribute [rw] word_list
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary::WordList]
  #     List of words or phrases to search for.
  # @!attribute [rw] cloud_storage_path
  #   @return [Google::Privacy::Dlp::V2::CloudStoragePath]
  #     Newline-delimited file of words in Cloud Storage. Only a single file
  #     is accepted.
  class Dictionary
    # Message defining a list of words or phrases to search for in the data.
    # @!attribute [rw] words
    #   @return [Array<String>]
    #     Words or phrases defining the dictionary. The dictionary must contain
    #     at least one phrase and every phrase must contain at least 2 characters
    #     that are letters or digits. [required]
    class WordList; end
  end

  # Message defining a custom regular expression.
  # @!attribute [rw] pattern
  #   @return [String]
  #     Pattern defining the regular expression. Its syntax
  #     (https://github.com/google/re2/wiki/Syntax) can be found under the
  #     google/re2 repository on GitHub.
  # @!attribute [rw] group_indexes
  #   @return [Array<Integer>]
  #     The index of the submatch to extract as findings. When not
  #     specified, the entire match is returned. No more than 3 may be included.
  class Regex; end

  # Message for detecting output from deidentification transformations
  # such as
  # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
  # These types of transformations are
  # those that perform pseudonymization, thereby producing a "surrogate" as
  # output. This should be used in conjunction with a field on the
  # transformation such as `surrogate_info_type`. This CustomInfoType does
  # not support the use of `detection_rules`.
  class SurrogateType; end

  # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
  # `CustomInfoType` to alter behavior under certain circumstances, depending
  # on the specific details of the rule. Not supported for the `surrogate_type`
  # custom infoType.
  # @!attribute [rw] hotword_rule
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::HotwordRule]
  #     Hotword-based detection rule.
  class DetectionRule
    # Message for specifying a window around a finding to apply a detection
    # rule.
    # @!attribute [rw] window_before
    #   @return [Integer]
    #     Number of characters before the finding to consider.
    # @!attribute [rw] window_after
    #   @return [Integer]
    #     Number of characters after the finding to consider.
    class Proximity; end

    # Message for specifying an adjustment to the likelihood of a finding as
    # part of a detection rule.
    # @!attribute [rw] fixed_likelihood
    #   @return [Google::Privacy::Dlp::V2::Likelihood]
    #     Set the likelihood of a finding to a fixed value.
    # @!attribute [rw] relative_likelihood
    #   @return [Integer]
    #     Increase or decrease the likelihood by the specified number of
    #     levels. For example, if a finding would be `POSSIBLE` without the
    #     detection rule and `relative_likelihood` is 1, then it is upgraded to
    #     `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
    #     Likelihood may never drop below `VERY_UNLIKELY` or exceed
    #     `VERY_LIKELY`, so applying an adjustment of 1 followed by an
    #     adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
    #     a final likelihood of `LIKELY`.
    class LikelihoodAdjustment; end

    # The rule that adjusts the likelihood of findings within a certain
    # proximity of hotwords.
    # @!attribute [rw] hotword_regex
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
    #     Regular expression pattern defining what qualifies as a hotword.
    # @!attribute [rw] proximity
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
    #     Proximity of the finding within which the entire hotword must reside.
    #     The total length of the window cannot exceed 1000 characters. Note that
    #     the finding itself will be included in the window, so that hotwords may
    #     be used to match substrings of the finding itself. For example, the
    #     certainty of a phone number regex "\(\d\\{3}\) \d\\{3}-\d\\{4}" could be
    #     adjusted upwards if the area code is known to be the local area code of
    #     a company office using the hotword regex "\(xxx\)", where "xxx"
    #     is the area code in question.
    # @!attribute [rw] likelihood_adjustment
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::LikelihoodAdjustment]
    #     Likelihood adjustment to apply to all matching findings.
    class HotwordRule; end
  end

  module ExclusionType
    # A finding of this custom info type will not be excluded from results.
    EXCLUSION_TYPE_UNSPECIFIED = 0

    # A finding of this custom info type will be excluded from final results,
    # but can still affect rule execution.
    EXCLUSION_TYPE_EXCLUDE = 1
  end
end

#dictionary ⇒ Google::Privacy::Dlp::V2::CustomInfoType::Dictionary

Returns A list of phrases to detect as a CustomInfoType.

Returns:



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb', line 80

class CustomInfoType
  # Custom information type based on a dictionary of words or phrases. This can
  # be used to match sensitive information specific to the data, such as a list
  # of employee IDs or job titles.
  #
  # Dictionary words are case-insensitive and all characters other than letters
  # and digits in the unicode [Basic Multilingual
  # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
  # will be replaced with whitespace when scanning for matches, so the
  # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
  # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
  # surrounding any match must be of a different type than the adjacent
  # characters within the word, so letters must be next to non-letters and
  # digits next to non-digits. For example, the dictionary word "jen" will
  # match the first three letters of the text "jen123" but will return no
  # matches for "jennifer".
  #
  # Dictionary words containing a large number of characters that are not
  # letters or digits may result in unexpected findings because such characters
  # are treated as whitespace. The
  # [limits](https://cloud.google.com/dlp/limits) page contains details about
  # the size limits of dictionaries. For dictionaries that do not fit within
  # these constraints, consider using `LargeCustomDictionaryConfig` in the
  # `StoredInfoType` API.
  # @!attribute [rw] word_list
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary::WordList]
  #     List of words or phrases to search for.
  # @!attribute [rw] cloud_storage_path
  #   @return [Google::Privacy::Dlp::V2::CloudStoragePath]
  #     Newline-delimited file of words in Cloud Storage. Only a single file
  #     is accepted.
  class Dictionary
    # Message defining a list of words or phrases to search for in the data.
    # @!attribute [rw] words
    #   @return [Array<String>]
    #     Words or phrases defining the dictionary. The dictionary must contain
    #     at least one phrase and every phrase must contain at least 2 characters
    #     that are letters or digits. [required]
    class WordList; end
  end

  # Message defining a custom regular expression.
  # @!attribute [rw] pattern
  #   @return [String]
  #     Pattern defining the regular expression. Its syntax
  #     (https://github.com/google/re2/wiki/Syntax) can be found under the
  #     google/re2 repository on GitHub.
  # @!attribute [rw] group_indexes
  #   @return [Array<Integer>]
  #     The index of the submatch to extract as findings. When not
  #     specified, the entire match is returned. No more than 3 may be included.
  class Regex; end

  # Message for detecting output from deidentification transformations
  # such as
  # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
  # These types of transformations are
  # those that perform pseudonymization, thereby producing a "surrogate" as
  # output. This should be used in conjunction with a field on the
  # transformation such as `surrogate_info_type`. This CustomInfoType does
  # not support the use of `detection_rules`.
  class SurrogateType; end

  # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
  # `CustomInfoType` to alter behavior under certain circumstances, depending
  # on the specific details of the rule. Not supported for the `surrogate_type`
  # custom infoType.
  # @!attribute [rw] hotword_rule
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::HotwordRule]
  #     Hotword-based detection rule.
  class DetectionRule
    # Message for specifying a window around a finding to apply a detection
    # rule.
    # @!attribute [rw] window_before
    #   @return [Integer]
    #     Number of characters before the finding to consider.
    # @!attribute [rw] window_after
    #   @return [Integer]
    #     Number of characters after the finding to consider.
    class Proximity; end

    # Message for specifying an adjustment to the likelihood of a finding as
    # part of a detection rule.
    # @!attribute [rw] fixed_likelihood
    #   @return [Google::Privacy::Dlp::V2::Likelihood]
    #     Set the likelihood of a finding to a fixed value.
    # @!attribute [rw] relative_likelihood
    #   @return [Integer]
    #     Increase or decrease the likelihood by the specified number of
    #     levels. For example, if a finding would be `POSSIBLE` without the
    #     detection rule and `relative_likelihood` is 1, then it is upgraded to
    #     `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
    #     Likelihood may never drop below `VERY_UNLIKELY` or exceed
    #     `VERY_LIKELY`, so applying an adjustment of 1 followed by an
    #     adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
    #     a final likelihood of `LIKELY`.
    class LikelihoodAdjustment; end

    # The rule that adjusts the likelihood of findings within a certain
    # proximity of hotwords.
    # @!attribute [rw] hotword_regex
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
    #     Regular expression pattern defining what qualifies as a hotword.
    # @!attribute [rw] proximity
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
    #     Proximity of the finding within which the entire hotword must reside.
    #     The total length of the window cannot exceed 1000 characters. Note that
    #     the finding itself will be included in the window, so that hotwords may
    #     be used to match substrings of the finding itself. For example, the
    #     certainty of a phone number regex "\(\d\\{3}\) \d\\{3}-\d\\{4}" could be
    #     adjusted upwards if the area code is known to be the local area code of
    #     a company office using the hotword regex "\(xxx\)", where "xxx"
    #     is the area code in question.
    # @!attribute [rw] likelihood_adjustment
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::LikelihoodAdjustment]
    #     Likelihood adjustment to apply to all matching findings.
    class HotwordRule; end
  end

  module ExclusionType
    # A finding of this custom info type will not be excluded from results.
    EXCLUSION_TYPE_UNSPECIFIED = 0

    # A finding of this custom info type will be excluded from final results,
    # but can still affect rule execution.
    EXCLUSION_TYPE_EXCLUDE = 1
  end
end

#exclusion_type ⇒ Google::Privacy::Dlp::V2::CustomInfoType::ExclusionType

Returns If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding to be returned. It still can be used for rules matching.

Returns:



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb', line 80

class CustomInfoType
  # Custom information type based on a dictionary of words or phrases. This can
  # be used to match sensitive information specific to the data, such as a list
  # of employee IDs or job titles.
  #
  # Dictionary words are case-insensitive and all characters other than letters
  # and digits in the unicode [Basic Multilingual
  # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
  # will be replaced with whitespace when scanning for matches, so the
  # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
  # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
  # surrounding any match must be of a different type than the adjacent
  # characters within the word, so letters must be next to non-letters and
  # digits next to non-digits. For example, the dictionary word "jen" will
  # match the first three letters of the text "jen123" but will return no
  # matches for "jennifer".
  #
  # Dictionary words containing a large number of characters that are not
  # letters or digits may result in unexpected findings because such characters
  # are treated as whitespace. The
  # [limits](https://cloud.google.com/dlp/limits) page contains details about
  # the size limits of dictionaries. For dictionaries that do not fit within
  # these constraints, consider using `LargeCustomDictionaryConfig` in the
  # `StoredInfoType` API.
  # @!attribute [rw] word_list
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary::WordList]
  #     List of words or phrases to search for.
  # @!attribute [rw] cloud_storage_path
  #   @return [Google::Privacy::Dlp::V2::CloudStoragePath]
  #     Newline-delimited file of words in Cloud Storage. Only a single file
  #     is accepted.
  class Dictionary
    # Message defining a list of words or phrases to search for in the data.
    # @!attribute [rw] words
    #   @return [Array<String>]
    #     Words or phrases defining the dictionary. The dictionary must contain
    #     at least one phrase and every phrase must contain at least 2 characters
    #     that are letters or digits. [required]
    class WordList; end
  end

  # Message defining a custom regular expression.
  # @!attribute [rw] pattern
  #   @return [String]
  #     Pattern defining the regular expression. Its syntax
  #     (https://github.com/google/re2/wiki/Syntax) can be found under the
  #     google/re2 repository on GitHub.
  # @!attribute [rw] group_indexes
  #   @return [Array<Integer>]
  #     The index of the submatch to extract as findings. When not
  #     specified, the entire match is returned. No more than 3 may be included.
  class Regex; end

  # Message for detecting output from deidentification transformations
  # such as
  # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
  # These types of transformations are
  # those that perform pseudonymization, thereby producing a "surrogate" as
  # output. This should be used in conjunction with a field on the
  # transformation such as `surrogate_info_type`. This CustomInfoType does
  # not support the use of `detection_rules`.
  class SurrogateType; end

  # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
  # `CustomInfoType` to alter behavior under certain circumstances, depending
  # on the specific details of the rule. Not supported for the `surrogate_type`
  # custom infoType.
  # @!attribute [rw] hotword_rule
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::HotwordRule]
  #     Hotword-based detection rule.
  class DetectionRule
    # Message for specifying a window around a finding to apply a detection
    # rule.
    # @!attribute [rw] window_before
    #   @return [Integer]
    #     Number of characters before the finding to consider.
    # @!attribute [rw] window_after
    #   @return [Integer]
    #     Number of characters after the finding to consider.
    class Proximity; end

    # Message for specifying an adjustment to the likelihood of a finding as
    # part of a detection rule.
    # @!attribute [rw] fixed_likelihood
    #   @return [Google::Privacy::Dlp::V2::Likelihood]
    #     Set the likelihood of a finding to a fixed value.
    # @!attribute [rw] relative_likelihood
    #   @return [Integer]
    #     Increase or decrease the likelihood by the specified number of
    #     levels. For example, if a finding would be `POSSIBLE` without the
    #     detection rule and `relative_likelihood` is 1, then it is upgraded to
    #     `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
    #     Likelihood may never drop below `VERY_UNLIKELY` or exceed
    #     `VERY_LIKELY`, so applying an adjustment of 1 followed by an
    #     adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
    #     a final likelihood of `LIKELY`.
    class LikelihoodAdjustment; end

    # The rule that adjusts the likelihood of findings within a certain
    # proximity of hotwords.
    # @!attribute [rw] hotword_regex
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
    #     Regular expression pattern defining what qualifies as a hotword.
    # @!attribute [rw] proximity
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
    #     Proximity of the finding within which the entire hotword must reside.
    #     The total length of the window cannot exceed 1000 characters. Note that
    #     the finding itself will be included in the window, so that hotwords may
    #     be used to match substrings of the finding itself. For example, the
    #     certainty of a phone number regex "\(\d\\{3}\) \d\\{3}-\d\\{4}" could be
    #     adjusted upwards if the area code is known to be the local area code of
    #     a company office using the hotword regex "\(xxx\)", where "xxx"
    #     is the area code in question.
    # @!attribute [rw] likelihood_adjustment
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::LikelihoodAdjustment]
    #     Likelihood adjustment to apply to all matching findings.
    class HotwordRule; end
  end

  module ExclusionType
    # A finding of this custom info type will not be excluded from results.
    EXCLUSION_TYPE_UNSPECIFIED = 0

    # A finding of this custom info type will be excluded from final results,
    # but can still affect rule execution.
    EXCLUSION_TYPE_EXCLUDE = 1
  end
end

#info_type ⇒ Google::Privacy::Dlp::V2::InfoType

Returns CustomInfoType can either be a new infoType, or an extension of built-in infoType, when the name matches one of existing infoTypes and that infoType is specified in InspectContent.info_types field. Specifying the latter adds findings to the one detected by the system. If built-in info type is not specified in InspectContent.info_types list then the name is treated as a custom info type.

Returns:

  • (Google::Privacy::Dlp::V2::InfoType) —

    CustomInfoType can either be a new infoType, or an extension of built-in infoType, when the name matches one of existing infoTypes and that infoType is specified in InspectContent.info_types field. Specifying the latter adds findings to the one detected by the system. If built-in info type is not specified in InspectContent.info_types list then the name is treated as a custom info type.



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb', line 80

class CustomInfoType
  # Custom information type based on a dictionary of words or phrases. This can
  # be used to match sensitive information specific to the data, such as a list
  # of employee IDs or job titles.
  #
  # Dictionary words are case-insensitive and all characters other than letters
  # and digits in the unicode [Basic Multilingual
  # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
  # will be replaced with whitespace when scanning for matches, so the
  # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
  # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
  # surrounding any match must be of a different type than the adjacent
  # characters within the word, so letters must be next to non-letters and
  # digits next to non-digits. For example, the dictionary word "jen" will
  # match the first three letters of the text "jen123" but will return no
  # matches for "jennifer".
  #
  # Dictionary words containing a large number of characters that are not
  # letters or digits may result in unexpected findings because such characters
  # are treated as whitespace. The
  # [limits](https://cloud.google.com/dlp/limits) page contains details about
  # the size limits of dictionaries. For dictionaries that do not fit within
  # these constraints, consider using `LargeCustomDictionaryConfig` in the
  # `StoredInfoType` API.
  # @!attribute [rw] word_list
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary::WordList]
  #     List of words or phrases to search for.
  # @!attribute [rw] cloud_storage_path
  #   @return [Google::Privacy::Dlp::V2::CloudStoragePath]
  #     Newline-delimited file of words in Cloud Storage. Only a single file
  #     is accepted.
  class Dictionary
    # Message defining a list of words or phrases to search for in the data.
    # @!attribute [rw] words
    #   @return [Array<String>]
    #     Words or phrases defining the dictionary. The dictionary must contain
    #     at least one phrase and every phrase must contain at least 2 characters
    #     that are letters or digits. [required]
    class WordList; end
  end

  # Message defining a custom regular expression.
  # @!attribute [rw] pattern
  #   @return [String]
  #     Pattern defining the regular expression. Its syntax
  #     (https://github.com/google/re2/wiki/Syntax) can be found under the
  #     google/re2 repository on GitHub.
  # @!attribute [rw] group_indexes
  #   @return [Array<Integer>]
  #     The index of the submatch to extract as findings. When not
  #     specified, the entire match is returned. No more than 3 may be included.
  class Regex; end

  # Message for detecting output from deidentification transformations
  # such as
  # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
  # These types of transformations are
  # those that perform pseudonymization, thereby producing a "surrogate" as
  # output. This should be used in conjunction with a field on the
  # transformation such as `surrogate_info_type`. This CustomInfoType does
  # not support the use of `detection_rules`.
  class SurrogateType; end

  # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
  # `CustomInfoType` to alter behavior under certain circumstances, depending
  # on the specific details of the rule. Not supported for the `surrogate_type`
  # custom infoType.
  # @!attribute [rw] hotword_rule
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::HotwordRule]
  #     Hotword-based detection rule.
  class DetectionRule
    # Message for specifying a window around a finding to apply a detection
    # rule.
    # @!attribute [rw] window_before
    #   @return [Integer]
    #     Number of characters before the finding to consider.
    # @!attribute [rw] window_after
    #   @return [Integer]
    #     Number of characters after the finding to consider.
    class Proximity; end

    # Message for specifying an adjustment to the likelihood of a finding as
    # part of a detection rule.
    # @!attribute [rw] fixed_likelihood
    #   @return [Google::Privacy::Dlp::V2::Likelihood]
    #     Set the likelihood of a finding to a fixed value.
    # @!attribute [rw] relative_likelihood
    #   @return [Integer]
    #     Increase or decrease the likelihood by the specified number of
    #     levels. For example, if a finding would be `POSSIBLE` without the
    #     detection rule and `relative_likelihood` is 1, then it is upgraded to
    #     `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
    #     Likelihood may never drop below `VERY_UNLIKELY` or exceed
    #     `VERY_LIKELY`, so applying an adjustment of 1 followed by an
    #     adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
    #     a final likelihood of `LIKELY`.
    class LikelihoodAdjustment; end

    # The rule that adjusts the likelihood of findings within a certain
    # proximity of hotwords.
    # @!attribute [rw] hotword_regex
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
    #     Regular expression pattern defining what qualifies as a hotword.
    # @!attribute [rw] proximity
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
    #     Proximity of the finding within which the entire hotword must reside.
    #     The total length of the window cannot exceed 1000 characters. Note that
    #     the finding itself will be included in the window, so that hotwords may
    #     be used to match substrings of the finding itself. For example, the
    #     certainty of a phone number regex "\(\d\\{3}\) \d\\{3}-\d\\{4}" could be
    #     adjusted upwards if the area code is known to be the local area code of
    #     a company office using the hotword regex "\(xxx\)", where "xxx"
    #     is the area code in question.
    # @!attribute [rw] likelihood_adjustment
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::LikelihoodAdjustment]
    #     Likelihood adjustment to apply to all matching findings.
    class HotwordRule; end
  end

  module ExclusionType
    # A finding of this custom info type will not be excluded from results.
    EXCLUSION_TYPE_UNSPECIFIED = 0

    # A finding of this custom info type will be excluded from final results,
    # but can still affect rule execution.
    EXCLUSION_TYPE_EXCLUDE = 1
  end
end

#likelihood ⇒ Google::Privacy::Dlp::V2::Likelihood

Returns Likelihood to return for this CustomInfoType. This base value can be altered by a detection rule if the finding meets the criteria specified by the rule. Defaults to VERY_LIKELY if not specified.

Returns:

  • (Google::Privacy::Dlp::V2::Likelihood) —

    Likelihood to return for this CustomInfoType. This base value can be altered by a detection rule if the finding meets the criteria specified by the rule. Defaults to VERY_LIKELY if not specified.



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb', line 80

class CustomInfoType
  # Custom information type based on a dictionary of words or phrases. This can
  # be used to match sensitive information specific to the data, such as a list
  # of employee IDs or job titles.
  #
  # Dictionary words are case-insensitive and all characters other than letters
  # and digits in the unicode [Basic Multilingual
  # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
  # will be replaced with whitespace when scanning for matches, so the
  # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
  # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
  # surrounding any match must be of a different type than the adjacent
  # characters within the word, so letters must be next to non-letters and
  # digits next to non-digits. For example, the dictionary word "jen" will
  # match the first three letters of the text "jen123" but will return no
  # matches for "jennifer".
  #
  # Dictionary words containing a large number of characters that are not
  # letters or digits may result in unexpected findings because such characters
  # are treated as whitespace. The
  # [limits](https://cloud.google.com/dlp/limits) page contains details about
  # the size limits of dictionaries. For dictionaries that do not fit within
  # these constraints, consider using `LargeCustomDictionaryConfig` in the
  # `StoredInfoType` API.
  # @!attribute [rw] word_list
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary::WordList]
  #     List of words or phrases to search for.
  # @!attribute [rw] cloud_storage_path
  #   @return [Google::Privacy::Dlp::V2::CloudStoragePath]
  #     Newline-delimited file of words in Cloud Storage. Only a single file
  #     is accepted.
  class Dictionary
    # Message defining a list of words or phrases to search for in the data.
    # @!attribute [rw] words
    #   @return [Array<String>]
    #     Words or phrases defining the dictionary. The dictionary must contain
    #     at least one phrase and every phrase must contain at least 2 characters
    #     that are letters or digits. [required]
    class WordList; end
  end

  # Message defining a custom regular expression.
  # @!attribute [rw] pattern
  #   @return [String]
  #     Pattern defining the regular expression. Its syntax
  #     (https://github.com/google/re2/wiki/Syntax) can be found under the
  #     google/re2 repository on GitHub.
  # @!attribute [rw] group_indexes
  #   @return [Array<Integer>]
  #     The index of the submatch to extract as findings. When not
  #     specified, the entire match is returned. No more than 3 may be included.
  class Regex; end

  # Message for detecting output from deidentification transformations
  # such as
  # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
  # These types of transformations are
  # those that perform pseudonymization, thereby producing a "surrogate" as
  # output. This should be used in conjunction with a field on the
  # transformation such as `surrogate_info_type`. This CustomInfoType does
  # not support the use of `detection_rules`.
  class SurrogateType; end

  # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
  # `CustomInfoType` to alter behavior under certain circumstances, depending
  # on the specific details of the rule. Not supported for the `surrogate_type`
  # custom infoType.
  # @!attribute [rw] hotword_rule
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::HotwordRule]
  #     Hotword-based detection rule.
  class DetectionRule
    # Message for specifying a window around a finding to apply a detection
    # rule.
    # @!attribute [rw] window_before
    #   @return [Integer]
    #     Number of characters before the finding to consider.
    # @!attribute [rw] window_after
    #   @return [Integer]
    #     Number of characters after the finding to consider.
    class Proximity; end

    # Message for specifying an adjustment to the likelihood of a finding as
    # part of a detection rule.
    # @!attribute [rw] fixed_likelihood
    #   @return [Google::Privacy::Dlp::V2::Likelihood]
    #     Set the likelihood of a finding to a fixed value.
    # @!attribute [rw] relative_likelihood
    #   @return [Integer]
    #     Increase or decrease the likelihood by the specified number of
    #     levels. For example, if a finding would be `POSSIBLE` without the
    #     detection rule and `relative_likelihood` is 1, then it is upgraded to
    #     `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
    #     Likelihood may never drop below `VERY_UNLIKELY` or exceed
    #     `VERY_LIKELY`, so applying an adjustment of 1 followed by an
    #     adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
    #     a final likelihood of `LIKELY`.
    class LikelihoodAdjustment; end

    # The rule that adjusts the likelihood of findings within a certain
    # proximity of hotwords.
    # @!attribute [rw] hotword_regex
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
    #     Regular expression pattern defining what qualifies as a hotword.
    # @!attribute [rw] proximity
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
    #     Proximity of the finding within which the entire hotword must reside.
    #     The total length of the window cannot exceed 1000 characters. Note that
    #     the finding itself will be included in the window, so that hotwords may
    #     be used to match substrings of the finding itself. For example, the
    #     certainty of a phone number regex "\(\d\\{3}\) \d\\{3}-\d\\{4}" could be
    #     adjusted upwards if the area code is known to be the local area code of
    #     a company office using the hotword regex "\(xxx\)", where "xxx"
    #     is the area code in question.
    # @!attribute [rw] likelihood_adjustment
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::LikelihoodAdjustment]
    #     Likelihood adjustment to apply to all matching findings.
    class HotwordRule; end
  end

  module ExclusionType
    # A finding of this custom info type will not be excluded from results.
    EXCLUSION_TYPE_UNSPECIFIED = 0

    # A finding of this custom info type will be excluded from final results,
    # but can still affect rule execution.
    EXCLUSION_TYPE_EXCLUDE = 1
  end
end

#regex ⇒ Google::Privacy::Dlp::V2::CustomInfoType::Regex

Returns Regular expression based CustomInfoType.

Returns:



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb', line 80

class CustomInfoType
  # Custom information type based on a dictionary of words or phrases. This can
  # be used to match sensitive information specific to the data, such as a list
  # of employee IDs or job titles.
  #
  # Dictionary words are case-insensitive and all characters other than letters
  # and digits in the unicode [Basic Multilingual
  # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
  # will be replaced with whitespace when scanning for matches, so the
  # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
  # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
  # surrounding any match must be of a different type than the adjacent
  # characters within the word, so letters must be next to non-letters and
  # digits next to non-digits. For example, the dictionary word "jen" will
  # match the first three letters of the text "jen123" but will return no
  # matches for "jennifer".
  #
  # Dictionary words containing a large number of characters that are not
  # letters or digits may result in unexpected findings because such characters
  # are treated as whitespace. The
  # [limits](https://cloud.google.com/dlp/limits) page contains details about
  # the size limits of dictionaries. For dictionaries that do not fit within
  # these constraints, consider using `LargeCustomDictionaryConfig` in the
  # `StoredInfoType` API.
  # @!attribute [rw] word_list
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary::WordList]
  #     List of words or phrases to search for.
  # @!attribute [rw] cloud_storage_path
  #   @return [Google::Privacy::Dlp::V2::CloudStoragePath]
  #     Newline-delimited file of words in Cloud Storage. Only a single file
  #     is accepted.
  class Dictionary
    # Message defining a list of words or phrases to search for in the data.
    # @!attribute [rw] words
    #   @return [Array<String>]
    #     Words or phrases defining the dictionary. The dictionary must contain
    #     at least one phrase and every phrase must contain at least 2 characters
    #     that are letters or digits. [required]
    class WordList; end
  end

  # Message defining a custom regular expression.
  # @!attribute [rw] pattern
  #   @return [String]
  #     Pattern defining the regular expression. Its syntax
  #     (https://github.com/google/re2/wiki/Syntax) can be found under the
  #     google/re2 repository on GitHub.
  # @!attribute [rw] group_indexes
  #   @return [Array<Integer>]
  #     The index of the submatch to extract as findings. When not
  #     specified, the entire match is returned. No more than 3 may be included.
  class Regex; end

  # Message for detecting output from deidentification transformations
  # such as
  # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
  # These types of transformations are
  # those that perform pseudonymization, thereby producing a "surrogate" as
  # output. This should be used in conjunction with a field on the
  # transformation such as `surrogate_info_type`. This CustomInfoType does
  # not support the use of `detection_rules`.
  class SurrogateType; end

  # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
  # `CustomInfoType` to alter behavior under certain circumstances, depending
  # on the specific details of the rule. Not supported for the `surrogate_type`
  # custom infoType.
  # @!attribute [rw] hotword_rule
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::HotwordRule]
  #     Hotword-based detection rule.
  class DetectionRule
    # Message for specifying a window around a finding to apply a detection
    # rule.
    # @!attribute [rw] window_before
    #   @return [Integer]
    #     Number of characters before the finding to consider.
    # @!attribute [rw] window_after
    #   @return [Integer]
    #     Number of characters after the finding to consider.
    class Proximity; end

    # Message for specifying an adjustment to the likelihood of a finding as
    # part of a detection rule.
    # @!attribute [rw] fixed_likelihood
    #   @return [Google::Privacy::Dlp::V2::Likelihood]
    #     Set the likelihood of a finding to a fixed value.
    # @!attribute [rw] relative_likelihood
    #   @return [Integer]
    #     Increase or decrease the likelihood by the specified number of
    #     levels. For example, if a finding would be `POSSIBLE` without the
    #     detection rule and `relative_likelihood` is 1, then it is upgraded to
    #     `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
    #     Likelihood may never drop below `VERY_UNLIKELY` or exceed
    #     `VERY_LIKELY`, so applying an adjustment of 1 followed by an
    #     adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
    #     a final likelihood of `LIKELY`.
    class LikelihoodAdjustment; end

    # The rule that adjusts the likelihood of findings within a certain
    # proximity of hotwords.
    # @!attribute [rw] hotword_regex
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
    #     Regular expression pattern defining what qualifies as a hotword.
    # @!attribute [rw] proximity
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
    #     Proximity of the finding within which the entire hotword must reside.
    #     The total length of the window cannot exceed 1000 characters. Note that
    #     the finding itself will be included in the window, so that hotwords may
    #     be used to match substrings of the finding itself. For example, the
    #     certainty of a phone number regex "\(\d\\{3}\) \d\\{3}-\d\\{4}" could be
    #     adjusted upwards if the area code is known to be the local area code of
    #     a company office using the hotword regex "\(xxx\)", where "xxx"
    #     is the area code in question.
    # @!attribute [rw] likelihood_adjustment
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::LikelihoodAdjustment]
    #     Likelihood adjustment to apply to all matching findings.
    class HotwordRule; end
  end

  module ExclusionType
    # A finding of this custom info type will not be excluded from results.
    EXCLUSION_TYPE_UNSPECIFIED = 0

    # A finding of this custom info type will be excluded from final results,
    # but can still affect rule execution.
    EXCLUSION_TYPE_EXCLUDE = 1
  end
end

#stored_type ⇒ Google::Privacy::Dlp::V2::StoredType

Returns Load an existing StoredInfoType resource for use in InspectDataSource. Not currently supported in InspectContent.

Returns:



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb', line 80

class CustomInfoType
  # Custom information type based on a dictionary of words or phrases. This can
  # be used to match sensitive information specific to the data, such as a list
  # of employee IDs or job titles.
  #
  # Dictionary words are case-insensitive and all characters other than letters
  # and digits in the unicode [Basic Multilingual
  # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
  # will be replaced with whitespace when scanning for matches, so the
  # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
  # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
  # surrounding any match must be of a different type than the adjacent
  # characters within the word, so letters must be next to non-letters and
  # digits next to non-digits. For example, the dictionary word "jen" will
  # match the first three letters of the text "jen123" but will return no
  # matches for "jennifer".
  #
  # Dictionary words containing a large number of characters that are not
  # letters or digits may result in unexpected findings because such characters
  # are treated as whitespace. The
  # [limits](https://cloud.google.com/dlp/limits) page contains details about
  # the size limits of dictionaries. For dictionaries that do not fit within
  # these constraints, consider using `LargeCustomDictionaryConfig` in the
  # `StoredInfoType` API.
  # @!attribute [rw] word_list
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary::WordList]
  #     List of words or phrases to search for.
  # @!attribute [rw] cloud_storage_path
  #   @return [Google::Privacy::Dlp::V2::CloudStoragePath]
  #     Newline-delimited file of words in Cloud Storage. Only a single file
  #     is accepted.
  class Dictionary
    # Message defining a list of words or phrases to search for in the data.
    # @!attribute [rw] words
    #   @return [Array<String>]
    #     Words or phrases defining the dictionary. The dictionary must contain
    #     at least one phrase and every phrase must contain at least 2 characters
    #     that are letters or digits. [required]
    class WordList; end
  end

  # Message defining a custom regular expression.
  # @!attribute [rw] pattern
  #   @return [String]
  #     Pattern defining the regular expression. Its syntax
  #     (https://github.com/google/re2/wiki/Syntax) can be found under the
  #     google/re2 repository on GitHub.
  # @!attribute [rw] group_indexes
  #   @return [Array<Integer>]
  #     The index of the submatch to extract as findings. When not
  #     specified, the entire match is returned. No more than 3 may be included.
  class Regex; end

  # Message for detecting output from deidentification transformations
  # such as
  # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
  # These types of transformations are
  # those that perform pseudonymization, thereby producing a "surrogate" as
  # output. This should be used in conjunction with a field on the
  # transformation such as `surrogate_info_type`. This CustomInfoType does
  # not support the use of `detection_rules`.
  class SurrogateType; end

  # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
  # `CustomInfoType` to alter behavior under certain circumstances, depending
  # on the specific details of the rule. Not supported for the `surrogate_type`
  # custom infoType.
  # @!attribute [rw] hotword_rule
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::HotwordRule]
  #     Hotword-based detection rule.
  class DetectionRule
    # Message for specifying a window around a finding to apply a detection
    # rule.
    # @!attribute [rw] window_before
    #   @return [Integer]
    #     Number of characters before the finding to consider.
    # @!attribute [rw] window_after
    #   @return [Integer]
    #     Number of characters after the finding to consider.
    class Proximity; end

    # Message for specifying an adjustment to the likelihood of a finding as
    # part of a detection rule.
    # @!attribute [rw] fixed_likelihood
    #   @return [Google::Privacy::Dlp::V2::Likelihood]
    #     Set the likelihood of a finding to a fixed value.
    # @!attribute [rw] relative_likelihood
    #   @return [Integer]
    #     Increase or decrease the likelihood by the specified number of
    #     levels. For example, if a finding would be `POSSIBLE` without the
    #     detection rule and `relative_likelihood` is 1, then it is upgraded to
    #     `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
    #     Likelihood may never drop below `VERY_UNLIKELY` or exceed
    #     `VERY_LIKELY`, so applying an adjustment of 1 followed by an
    #     adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
    #     a final likelihood of `LIKELY`.
    class LikelihoodAdjustment; end

    # The rule that adjusts the likelihood of findings within a certain
    # proximity of hotwords.
    # @!attribute [rw] hotword_regex
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
    #     Regular expression pattern defining what qualifies as a hotword.
    # @!attribute [rw] proximity
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
    #     Proximity of the finding within which the entire hotword must reside.
    #     The total length of the window cannot exceed 1000 characters. Note that
    #     the finding itself will be included in the window, so that hotwords may
    #     be used to match substrings of the finding itself. For example, the
    #     certainty of a phone number regex "\(\d\\{3}\) \d\\{3}-\d\\{4}" could be
    #     adjusted upwards if the area code is known to be the local area code of
    #     a company office using the hotword regex "\(xxx\)", where "xxx"
    #     is the area code in question.
    # @!attribute [rw] likelihood_adjustment
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::LikelihoodAdjustment]
    #     Likelihood adjustment to apply to all matching findings.
    class HotwordRule; end
  end

  module ExclusionType
    # A finding of this custom info type will not be excluded from results.
    EXCLUSION_TYPE_UNSPECIFIED = 0

    # A finding of this custom info type will be excluded from final results,
    # but can still affect rule execution.
    EXCLUSION_TYPE_EXCLUDE = 1
  end
end

#surrogate_type ⇒ Google::Privacy::Dlp::V2::CustomInfoType::SurrogateType

Returns Message for detecting output from deidentification transformations that support reversing.

Returns:



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb', line 80

class CustomInfoType
  # Custom information type based on a dictionary of words or phrases. This can
  # be used to match sensitive information specific to the data, such as a list
  # of employee IDs or job titles.
  #
  # Dictionary words are case-insensitive and all characters other than letters
  # and digits in the unicode [Basic Multilingual
  # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
  # will be replaced with whitespace when scanning for matches, so the
  # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
  # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
  # surrounding any match must be of a different type than the adjacent
  # characters within the word, so letters must be next to non-letters and
  # digits next to non-digits. For example, the dictionary word "jen" will
  # match the first three letters of the text "jen123" but will return no
  # matches for "jennifer".
  #
  # Dictionary words containing a large number of characters that are not
  # letters or digits may result in unexpected findings because such characters
  # are treated as whitespace. The
  # [limits](https://cloud.google.com/dlp/limits) page contains details about
  # the size limits of dictionaries. For dictionaries that do not fit within
  # these constraints, consider using `LargeCustomDictionaryConfig` in the
  # `StoredInfoType` API.
  # @!attribute [rw] word_list
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary::WordList]
  #     List of words or phrases to search for.
  # @!attribute [rw] cloud_storage_path
  #   @return [Google::Privacy::Dlp::V2::CloudStoragePath]
  #     Newline-delimited file of words in Cloud Storage. Only a single file
  #     is accepted.
  class Dictionary
    # Message defining a list of words or phrases to search for in the data.
    # @!attribute [rw] words
    #   @return [Array<String>]
    #     Words or phrases defining the dictionary. The dictionary must contain
    #     at least one phrase and every phrase must contain at least 2 characters
    #     that are letters or digits. [required]
    class WordList; end
  end

  # Message defining a custom regular expression.
  # @!attribute [rw] pattern
  #   @return [String]
  #     Pattern defining the regular expression. Its syntax
  #     (https://github.com/google/re2/wiki/Syntax) can be found under the
  #     google/re2 repository on GitHub.
  # @!attribute [rw] group_indexes
  #   @return [Array<Integer>]
  #     The index of the submatch to extract as findings. When not
  #     specified, the entire match is returned. No more than 3 may be included.
  class Regex; end

  # Message for detecting output from deidentification transformations
  # such as
  # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
  # These types of transformations are
  # those that perform pseudonymization, thereby producing a "surrogate" as
  # output. This should be used in conjunction with a field on the
  # transformation such as `surrogate_info_type`. This CustomInfoType does
  # not support the use of `detection_rules`.
  class SurrogateType; end

  # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
  # `CustomInfoType` to alter behavior under certain circumstances, depending
  # on the specific details of the rule. Not supported for the `surrogate_type`
  # custom infoType.
  # @!attribute [rw] hotword_rule
  #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::HotwordRule]
  #     Hotword-based detection rule.
  class DetectionRule
    # Message for specifying a window around a finding to apply a detection
    # rule.
    # @!attribute [rw] window_before
    #   @return [Integer]
    #     Number of characters before the finding to consider.
    # @!attribute [rw] window_after
    #   @return [Integer]
    #     Number of characters after the finding to consider.
    class Proximity; end

    # Message for specifying an adjustment to the likelihood of a finding as
    # part of a detection rule.
    # @!attribute [rw] fixed_likelihood
    #   @return [Google::Privacy::Dlp::V2::Likelihood]
    #     Set the likelihood of a finding to a fixed value.
    # @!attribute [rw] relative_likelihood
    #   @return [Integer]
    #     Increase or decrease the likelihood by the specified number of
    #     levels. For example, if a finding would be `POSSIBLE` without the
    #     detection rule and `relative_likelihood` is 1, then it is upgraded to
    #     `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
    #     Likelihood may never drop below `VERY_UNLIKELY` or exceed
    #     `VERY_LIKELY`, so applying an adjustment of 1 followed by an
    #     adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
    #     a final likelihood of `LIKELY`.
    class LikelihoodAdjustment; end

    # The rule that adjusts the likelihood of findings within a certain
    # proximity of hotwords.
    # @!attribute [rw] hotword_regex
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
    #     Regular expression pattern defining what qualifies as a hotword.
    # @!attribute [rw] proximity
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
    #     Proximity of the finding within which the entire hotword must reside.
    #     The total length of the window cannot exceed 1000 characters. Note that
    #     the finding itself will be included in the window, so that hotwords may
    #     be used to match substrings of the finding itself. For example, the
    #     certainty of a phone number regex "\(\d\\{3}\) \d\\{3}-\d\\{4}" could be
    #     adjusted upwards if the area code is known to be the local area code of
    #     a company office using the hotword regex "\(xxx\)", where "xxx"
    #     is the area code in question.
    # @!attribute [rw] likelihood_adjustment
    #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::LikelihoodAdjustment]
    #     Likelihood adjustment to apply to all matching findings.
    class HotwordRule; end
  end

  module ExclusionType
    # A finding of this custom info type will not be excluded from results.
    EXCLUSION_TYPE_UNSPECIFIED = 0

    # A finding of this custom info type will be excluded from final results,
    # but can still affect rule execution.
    EXCLUSION_TYPE_EXCLUDE = 1
  end
end