google-cloud-advisory_notifications-v1 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. checksums.yaml +7 -0
  2. data/.yardopts +12 -0
  3. data/AUTHENTICATION.md +149 -0
  4. data/LICENSE.md +201 -0
  5. data/README.md +144 -0
  6. data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/client.rb +521 -0
  7. data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/credentials.rb +47 -0
  8. data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/paths.rb +69 -0
  9. data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/rest/client.rb +451 -0
  10. data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/rest/service_stub.rb +166 -0
  11. data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/rest.rb +52 -0
  12. data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service.rb +55 -0
  13. data/lib/google/cloud/advisory_notifications/v1/rest.rb +37 -0
  14. data/lib/google/cloud/advisory_notifications/v1/version.rb +28 -0
  15. data/lib/google/cloud/advisory_notifications/v1.rb +45 -0
  16. data/lib/google/cloud/advisorynotifications/v1/service_pb.rb +100 -0
  17. data/lib/google/cloud/advisorynotifications/v1/service_services_pb.rb +47 -0
  18. data/lib/google-cloud-advisory_notifications-v1.rb +21 -0
  19. data/proto_docs/README.md +4 -0
  20. data/proto_docs/google/api/client.rb +318 -0
  21. data/proto_docs/google/api/field_behavior.rb +71 -0
  22. data/proto_docs/google/api/launch_stage.rb +71 -0
  23. data/proto_docs/google/api/resource.rb +222 -0
  24. data/proto_docs/google/cloud/advisorynotifications/v1/service.rb +234 -0
  25. data/proto_docs/google/protobuf/duration.rb +98 -0
  26. data/proto_docs/google/protobuf/timestamp.rb +129 -0
  27. metadata +216 -0
@@ -0,0 +1,71 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # An indicator of the behavior of a given field (for example, that a field
23
+ # is required in requests, or given as output but ignored as input).
24
+ # This **does not** change the behavior in protocol buffers itself; it only
25
+ # denotes the behavior and may affect how API tooling handles the field.
26
+ #
27
+ # Note: This enum **may** receive new values in the future.
28
+ module FieldBehavior
29
+ # Conventional default for enums. Do not use this.
30
+ FIELD_BEHAVIOR_UNSPECIFIED = 0
31
+
32
+ # Specifically denotes a field as optional.
33
+ # While all fields in protocol buffers are optional, this may be specified
34
+ # for emphasis if appropriate.
35
+ OPTIONAL = 1
36
+
37
+ # Denotes a field as required.
38
+ # This indicates that the field **must** be provided as part of the request,
39
+ # and failure to do so will cause an error (usually `INVALID_ARGUMENT`).
40
+ REQUIRED = 2
41
+
42
+ # Denotes a field as output only.
43
+ # This indicates that the field is provided in responses, but including the
44
+ # field in a request does nothing (the server *must* ignore it and
45
+ # *must not* throw an error as a result of the field's presence).
46
+ OUTPUT_ONLY = 3
47
+
48
+ # Denotes a field as input only.
49
+ # This indicates that the field is provided in requests, and the
50
+ # corresponding field is not included in output.
51
+ INPUT_ONLY = 4
52
+
53
+ # Denotes a field as immutable.
54
+ # This indicates that the field may be set once in a request to create a
55
+ # resource, but may not be changed thereafter.
56
+ IMMUTABLE = 5
57
+
58
+ # Denotes that a (repeated) field is an unordered list.
59
+ # This indicates that the service may provide the elements of the list
60
+ # in any arbitrary order, rather than the order the user originally
61
+ # provided. Additionally, the list's order may or may not be stable.
62
+ UNORDERED_LIST = 6
63
+
64
+ # Denotes that this field returns a non-empty default value if not set.
65
+ # This indicates that if the user provides the empty value in a request,
66
+ # a non-empty value will be returned. The user will not be aware of what
67
+ # non-empty value to expect.
68
+ NON_EMPTY_DEFAULT = 7
69
+ end
70
+ end
71
+ end
@@ -0,0 +1,71 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # The launch stage as defined by [Google Cloud Platform
23
+ # Launch Stages](https://cloud.google.com/terms/launch-stages).
24
+ module LaunchStage
25
+ # Do not use this default value.
26
+ LAUNCH_STAGE_UNSPECIFIED = 0
27
+
28
+ # The feature is not yet implemented. Users can not use it.
29
+ UNIMPLEMENTED = 6
30
+
31
+ # Prelaunch features are hidden from users and are only visible internally.
32
+ PRELAUNCH = 7
33
+
34
+ # Early Access features are limited to a closed group of testers. To use
35
+ # these features, you must sign up in advance and sign a Trusted Tester
36
+ # agreement (which includes confidentiality provisions). These features may
37
+ # be unstable, changed in backward-incompatible ways, and are not
38
+ # guaranteed to be released.
39
+ EARLY_ACCESS = 1
40
+
41
+ # Alpha is a limited availability test for releases before they are cleared
42
+ # for widespread use. By Alpha, all significant design issues are resolved
43
+ # and we are in the process of verifying functionality. Alpha customers
44
+ # need to apply for access, agree to applicable terms, and have their
45
+ # projects allowlisted. Alpha releases don't have to be feature complete,
46
+ # no SLAs are provided, and there are no technical support obligations, but
47
+ # they will be far enough along that customers can actually use them in
48
+ # test environments or for limited-use tests -- just like they would in
49
+ # normal production cases.
50
+ ALPHA = 2
51
+
52
+ # Beta is the point at which we are ready to open a release for any
53
+ # customer to use. There are no SLA or technical support obligations in a
54
+ # Beta release. Products will be complete from a feature perspective, but
55
+ # may have some open outstanding issues. Beta releases are suitable for
56
+ # limited production use cases.
57
+ BETA = 3
58
+
59
+ # GA features are open to all developers and are considered stable and
60
+ # fully qualified for production use.
61
+ GA = 4
62
+
63
+ # Deprecated features are scheduled to be shut down and removed. For more
64
+ # information, see the "Deprecation Policy" section of our [Terms of
65
+ # Service](https://cloud.google.com/terms/)
66
+ # and the [Google Cloud Platform Subject to the Deprecation
67
+ # Policy](https://cloud.google.com/terms/deprecation) documentation.
68
+ DEPRECATED = 5
69
+ end
70
+ end
71
+ end
@@ -0,0 +1,222 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # A simple descriptor of a resource type.
23
+ #
24
+ # ResourceDescriptor annotates a resource message (either by means of a
25
+ # protobuf annotation or use in the service config), and associates the
26
+ # resource's schema, the resource type, and the pattern of the resource name.
27
+ #
28
+ # Example:
29
+ #
30
+ # message Topic {
31
+ # // Indicates this message defines a resource schema.
32
+ # // Declares the resource type in the format of {service}/{kind}.
33
+ # // For Kubernetes resources, the format is {api group}/{kind}.
34
+ # option (google.api.resource) = {
35
+ # type: "pubsub.googleapis.com/Topic"
36
+ # pattern: "projects/{project}/topics/{topic}"
37
+ # };
38
+ # }
39
+ #
40
+ # The ResourceDescriptor Yaml config will look like:
41
+ #
42
+ # resources:
43
+ # - type: "pubsub.googleapis.com/Topic"
44
+ # pattern: "projects/{project}/topics/{topic}"
45
+ #
46
+ # Sometimes, resources have multiple patterns, typically because they can
47
+ # live under multiple parents.
48
+ #
49
+ # Example:
50
+ #
51
+ # message LogEntry {
52
+ # option (google.api.resource) = {
53
+ # type: "logging.googleapis.com/LogEntry"
54
+ # pattern: "projects/{project}/logs/{log}"
55
+ # pattern: "folders/{folder}/logs/{log}"
56
+ # pattern: "organizations/{organization}/logs/{log}"
57
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
58
+ # };
59
+ # }
60
+ #
61
+ # The ResourceDescriptor Yaml config will look like:
62
+ #
63
+ # resources:
64
+ # - type: 'logging.googleapis.com/LogEntry'
65
+ # pattern: "projects/{project}/logs/{log}"
66
+ # pattern: "folders/{folder}/logs/{log}"
67
+ # pattern: "organizations/{organization}/logs/{log}"
68
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
69
+ # @!attribute [rw] type
70
+ # @return [::String]
71
+ # The resource type. It must be in the format of
72
+ # \\{service_name}/\\{resource_type_kind}. The `resource_type_kind` must be
73
+ # singular and must not include version numbers.
74
+ #
75
+ # Example: `storage.googleapis.com/Bucket`
76
+ #
77
+ # The value of the resource_type_kind must follow the regular expression
78
+ # /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and
79
+ # should use PascalCase (UpperCamelCase). The maximum number of
80
+ # characters allowed for the `resource_type_kind` is 100.
81
+ # @!attribute [rw] pattern
82
+ # @return [::Array<::String>]
83
+ # Optional. The relative resource name pattern associated with this resource
84
+ # type. The DNS prefix of the full resource name shouldn't be specified here.
85
+ #
86
+ # The path pattern must follow the syntax, which aligns with HTTP binding
87
+ # syntax:
88
+ #
89
+ # Template = Segment { "/" Segment } ;
90
+ # Segment = LITERAL | Variable ;
91
+ # Variable = "{" LITERAL "}" ;
92
+ #
93
+ # Examples:
94
+ #
95
+ # - "projects/\\{project}/topics/\\{topic}"
96
+ # - "projects/\\{project}/knowledgeBases/\\{knowledge_base}"
97
+ #
98
+ # The components in braces correspond to the IDs for each resource in the
99
+ # hierarchy. It is expected that, if multiple patterns are provided,
100
+ # the same component name (e.g. "project") refers to IDs of the same
101
+ # type of resource.
102
+ # @!attribute [rw] name_field
103
+ # @return [::String]
104
+ # Optional. The field on the resource that designates the resource name
105
+ # field. If omitted, this is assumed to be "name".
106
+ # @!attribute [rw] history
107
+ # @return [::Google::Api::ResourceDescriptor::History]
108
+ # Optional. The historical or future-looking state of the resource pattern.
109
+ #
110
+ # Example:
111
+ #
112
+ # // The InspectTemplate message originally only supported resource
113
+ # // names with organization, and project was added later.
114
+ # message InspectTemplate {
115
+ # option (google.api.resource) = {
116
+ # type: "dlp.googleapis.com/InspectTemplate"
117
+ # pattern:
118
+ # "organizations/{organization}/inspectTemplates/{inspect_template}"
119
+ # pattern: "projects/{project}/inspectTemplates/{inspect_template}"
120
+ # history: ORIGINALLY_SINGLE_PATTERN
121
+ # };
122
+ # }
123
+ # @!attribute [rw] plural
124
+ # @return [::String]
125
+ # The plural name used in the resource name and permission names, such as
126
+ # 'projects' for the resource name of 'projects/\\{project}' and the permission
127
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
128
+ # concept of the `plural` field in k8s CRD spec
129
+ # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
130
+ #
131
+ # Note: The plural form is required even for singleton resources. See
132
+ # https://aip.dev/156
133
+ # @!attribute [rw] singular
134
+ # @return [::String]
135
+ # The same concept of the `singular` field in k8s CRD spec
136
+ # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
137
+ # Such as "project" for the `resourcemanager.googleapis.com/Project` type.
138
+ # @!attribute [rw] style
139
+ # @return [::Array<::Google::Api::ResourceDescriptor::Style>]
140
+ # Style flag(s) for this resource.
141
+ # These indicate that a resource is expected to conform to a given
142
+ # style. See the specific style flags for additional information.
143
+ class ResourceDescriptor
144
+ include ::Google::Protobuf::MessageExts
145
+ extend ::Google::Protobuf::MessageExts::ClassMethods
146
+
147
+ # A description of the historical or future-looking state of the
148
+ # resource pattern.
149
+ module History
150
+ # The "unset" value.
151
+ HISTORY_UNSPECIFIED = 0
152
+
153
+ # The resource originally had one pattern and launched as such, and
154
+ # additional patterns were added later.
155
+ ORIGINALLY_SINGLE_PATTERN = 1
156
+
157
+ # The resource has one pattern, but the API owner expects to add more
158
+ # later. (This is the inverse of ORIGINALLY_SINGLE_PATTERN, and prevents
159
+ # that from being necessary once there are multiple patterns.)
160
+ FUTURE_MULTI_PATTERN = 2
161
+ end
162
+
163
+ # A flag representing a specific style that a resource claims to conform to.
164
+ module Style
165
+ # The unspecified value. Do not use.
166
+ STYLE_UNSPECIFIED = 0
167
+
168
+ # This resource is intended to be "declarative-friendly".
169
+ #
170
+ # Declarative-friendly resources must be more strictly consistent, and
171
+ # setting this to true communicates to tools that this resource should
172
+ # adhere to declarative-friendly expectations.
173
+ #
174
+ # Note: This is used by the API linter (linter.aip.dev) to enable
175
+ # additional checks.
176
+ DECLARATIVE_FRIENDLY = 1
177
+ end
178
+ end
179
+
180
+ # Defines a proto annotation that describes a string field that refers to
181
+ # an API resource.
182
+ # @!attribute [rw] type
183
+ # @return [::String]
184
+ # The resource type that the annotated field references.
185
+ #
186
+ # Example:
187
+ #
188
+ # message Subscription {
189
+ # string topic = 2 [(google.api.resource_reference) = {
190
+ # type: "pubsub.googleapis.com/Topic"
191
+ # }];
192
+ # }
193
+ #
194
+ # Occasionally, a field may reference an arbitrary resource. In this case,
195
+ # APIs use the special value * in their resource reference.
196
+ #
197
+ # Example:
198
+ #
199
+ # message GetIamPolicyRequest {
200
+ # string resource = 2 [(google.api.resource_reference) = {
201
+ # type: "*"
202
+ # }];
203
+ # }
204
+ # @!attribute [rw] child_type
205
+ # @return [::String]
206
+ # The resource type of a child collection that the annotated field
207
+ # references. This is useful for annotating the `parent` field that
208
+ # doesn't have a fixed resource type.
209
+ #
210
+ # Example:
211
+ #
212
+ # message ListLogEntriesRequest {
213
+ # string parent = 1 [(google.api.resource_reference) = {
214
+ # child_type: "logging.googleapis.com/LogEntry"
215
+ # };
216
+ # }
217
+ class ResourceReference
218
+ include ::Google::Protobuf::MessageExts
219
+ extend ::Google::Protobuf::MessageExts::ClassMethods
220
+ end
221
+ end
222
+ end
@@ -0,0 +1,234 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module AdvisoryNotifications
23
+ module V1
24
+ # A notification object for notifying customers about security and privacy
25
+ # issues.
26
+ # @!attribute [rw] name
27
+ # @return [::String]
28
+ # The resource name of the notification.
29
+ # Format:
30
+ # organizations/\\{organization}/locations/\\{location}/notifications/\\{notification}.
31
+ # @!attribute [rw] subject
32
+ # @return [::Google::Cloud::AdvisoryNotifications::V1::Subject]
33
+ # The subject line of the notification.
34
+ # @!attribute [rw] messages
35
+ # @return [::Array<::Google::Cloud::AdvisoryNotifications::V1::Message>]
36
+ # A list of messages in the notification.
37
+ # @!attribute [r] create_time
38
+ # @return [::Google::Protobuf::Timestamp]
39
+ # Output only. Time the notification was created.
40
+ class Notification
41
+ include ::Google::Protobuf::MessageExts
42
+ extend ::Google::Protobuf::MessageExts::ClassMethods
43
+ end
44
+
45
+ # A text object containing the English text and its localized copies.
46
+ # @!attribute [rw] en_text
47
+ # @return [::String]
48
+ # The English copy.
49
+ # @!attribute [rw] localized_text
50
+ # @return [::String]
51
+ # The requested localized copy (if applicable).
52
+ # @!attribute [rw] localization_state
53
+ # @return [::Google::Cloud::AdvisoryNotifications::V1::LocalizationState]
54
+ # Status of the localization.
55
+ class Text
56
+ include ::Google::Protobuf::MessageExts
57
+ extend ::Google::Protobuf::MessageExts::ClassMethods
58
+ end
59
+
60
+ # A subject line of a notification.
61
+ # @!attribute [rw] text
62
+ # @return [::Google::Cloud::AdvisoryNotifications::V1::Text]
63
+ # The text content.
64
+ class Subject
65
+ include ::Google::Protobuf::MessageExts
66
+ extend ::Google::Protobuf::MessageExts::ClassMethods
67
+ end
68
+
69
+ # A message which contains notification details.
70
+ # @!attribute [rw] body
71
+ # @return [::Google::Cloud::AdvisoryNotifications::V1::Message::Body]
72
+ # The message content.
73
+ # @!attribute [rw] attachments
74
+ # @return [::Array<::Google::Cloud::AdvisoryNotifications::V1::Attachment>]
75
+ # The attachments to download.
76
+ # @!attribute [rw] create_time
77
+ # @return [::Google::Protobuf::Timestamp]
78
+ # The Message creation timestamp.
79
+ # @!attribute [rw] localization_time
80
+ # @return [::Google::Protobuf::Timestamp]
81
+ # Time when Message was localized
82
+ class Message
83
+ include ::Google::Protobuf::MessageExts
84
+ extend ::Google::Protobuf::MessageExts::ClassMethods
85
+
86
+ # A message body containing text.
87
+ # @!attribute [rw] text
88
+ # @return [::Google::Cloud::AdvisoryNotifications::V1::Text]
89
+ # The text content of the message body.
90
+ class Body
91
+ include ::Google::Protobuf::MessageExts
92
+ extend ::Google::Protobuf::MessageExts::ClassMethods
93
+ end
94
+ end
95
+
96
+ # Attachment with specific information about the issue.
97
+ # @!attribute [rw] csv
98
+ # @return [::Google::Cloud::AdvisoryNotifications::V1::Csv]
99
+ # A CSV file attachment. Max size is 10 MB.
100
+ # @!attribute [rw] display_name
101
+ # @return [::String]
102
+ # The title of the attachment.
103
+ class Attachment
104
+ include ::Google::Protobuf::MessageExts
105
+ extend ::Google::Protobuf::MessageExts::ClassMethods
106
+ end
107
+
108
+ # A representation of a CSV file attachment, as a list of column headers and
109
+ # a list of data rows.
110
+ # @!attribute [rw] headers
111
+ # @return [::Array<::String>]
112
+ # The list of headers for data columns in a CSV file.
113
+ # @!attribute [rw] data_rows
114
+ # @return [::Array<::Google::Cloud::AdvisoryNotifications::V1::Csv::CsvRow>]
115
+ # The list of data rows in a CSV file, as string arrays rather than as a
116
+ # single comma-separated string.
117
+ class Csv
118
+ include ::Google::Protobuf::MessageExts
119
+ extend ::Google::Protobuf::MessageExts::ClassMethods
120
+
121
+ # A representation of a single data row in a CSV file.
122
+ # @!attribute [rw] entries
123
+ # @return [::Array<::String>]
124
+ # The data entries in a CSV file row, as a string array rather than a
125
+ # single comma-separated string.
126
+ class CsvRow
127
+ include ::Google::Protobuf::MessageExts
128
+ extend ::Google::Protobuf::MessageExts::ClassMethods
129
+ end
130
+ end
131
+
132
+ # Request for fetching all notifications for a given parent.
133
+ # @!attribute [rw] parent
134
+ # @return [::String]
135
+ # Required. The parent, which owns this collection of notifications.
136
+ # Must be of the form "organizations/\\{organization}/locations/\\{location}".
137
+ # @!attribute [rw] page_size
138
+ # @return [::Integer]
139
+ # The maximum number of notifications to return. The service may return
140
+ # fewer than this value. If unspecified or equal to 0, at most 50
141
+ # notifications will be returned. The maximum value is 50; values above 50
142
+ # will be coerced to 50.
143
+ # @!attribute [rw] page_token
144
+ # @return [::String]
145
+ # A page token returned from a previous request.
146
+ # When paginating, all other parameters provided in the request
147
+ # must match the call that returned the page token.
148
+ # @!attribute [rw] view
149
+ # @return [::Google::Cloud::AdvisoryNotifications::V1::NotificationView]
150
+ # Specifies which parts of the notification resource should be returned
151
+ # in the response.
152
+ # @!attribute [rw] language_code
153
+ # @return [::String]
154
+ # ISO code for requested localization language. If unset, will be
155
+ # interpereted as "en". If the requested language is valid, but not supported
156
+ # for this notification, English will be returned with an "Not applicable"
157
+ # LocalizationState. If the ISO code is invalid (i.e. not a real language),
158
+ # this RPC will throw an error.
159
+ class ListNotificationsRequest
160
+ include ::Google::Protobuf::MessageExts
161
+ extend ::Google::Protobuf::MessageExts::ClassMethods
162
+ end
163
+
164
+ # Response of ListNotifications endpoint.
165
+ # @!attribute [rw] notifications
166
+ # @return [::Array<::Google::Cloud::AdvisoryNotifications::V1::Notification>]
167
+ # List of notifications under a given parent.
168
+ # @!attribute [rw] next_page_token
169
+ # @return [::String]
170
+ # A token, which can be sent as `page_token` to retrieve the next page.
171
+ # If this field is omitted, there are no subsequent pages.
172
+ # @!attribute [rw] total_size
173
+ # @return [::Integer]
174
+ # Estimation of a total number of notifications.
175
+ class ListNotificationsResponse
176
+ include ::Google::Protobuf::MessageExts
177
+ extend ::Google::Protobuf::MessageExts::ClassMethods
178
+ end
179
+
180
+ # Request for fetching a notification.
181
+ # @!attribute [rw] name
182
+ # @return [::String]
183
+ # Required. A name of the notification to retrieve.
184
+ # Format:
185
+ # organizations/\\{organization}/locations/\\{location}/notifications/\\{notification}.
186
+ # @!attribute [rw] language_code
187
+ # @return [::String]
188
+ # ISO code for requested localization language. If unset, will be
189
+ # interpereted as "en". If the requested language is valid, but not supported
190
+ # for this notification, English will be returned with an "Not applicable"
191
+ # LocalizationState. If the ISO code is invalid (i.e. not a real language),
192
+ # this RPC will throw an error.
193
+ class GetNotificationRequest
194
+ include ::Google::Protobuf::MessageExts
195
+ extend ::Google::Protobuf::MessageExts::ClassMethods
196
+ end
197
+
198
+ # Notification view.
199
+ module NotificationView
200
+ # Not specified, equivalent to BASIC.
201
+ NOTIFICATION_VIEW_UNSPECIFIED = 0
202
+
203
+ # Server responses only include title, creation time and Notification ID.
204
+ # Note: for internal use responses also include the last update time,
205
+ # the latest message text and whether notification has attachments.
206
+ BASIC = 1
207
+
208
+ # Include everything.
209
+ FULL = 2
210
+ end
211
+
212
+ # Status of localized text.
213
+ module LocalizationState
214
+ # Not used.
215
+ LOCALIZATION_STATE_UNSPECIFIED = 0
216
+
217
+ # Localization is not applicable for requested language. This can happen
218
+ # when:
219
+ # - The requested language was not supported by Advisory Notifications at the
220
+ # time of localization (including notifications created before the
221
+ # localization feature was launched).
222
+ # - The requested language is English, so only the English text is returned.
223
+ LOCALIZATION_STATE_NOT_APPLICABLE = 1
224
+
225
+ # Localization for requested language is in progress, and not ready yet.
226
+ LOCALIZATION_STATE_PENDING = 2
227
+
228
+ # Localization for requested language is completed.
229
+ LOCALIZATION_STATE_COMPLETED = 3
230
+ end
231
+ end
232
+ end
233
+ end
234
+ end