google-cloud-essential_contacts-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.
- checksums.yaml +7 -0
- data/.yardopts +12 -0
- data/AUTHENTICATION.md +169 -0
- data/LICENSE.md +201 -0
- data/README.md +139 -0
- data/lib/google-cloud-essential_contacts-v1.rb +21 -0
- data/lib/google/cloud/essential_contacts/v1.rb +38 -0
- data/lib/google/cloud/essential_contacts/v1/essential_contacts_service.rb +49 -0
- data/lib/google/cloud/essential_contacts/v1/essential_contacts_service/client.rb +901 -0
- data/lib/google/cloud/essential_contacts/v1/essential_contacts_service/credentials.rb +51 -0
- data/lib/google/cloud/essential_contacts/v1/essential_contacts_service/paths.rb +127 -0
- data/lib/google/cloud/essential_contacts/v1/version.rb +28 -0
- data/lib/google/cloud/essentialcontacts/v1/enums_pb.rb +36 -0
- data/lib/google/cloud/essentialcontacts/v1/service_pb.rb +82 -0
- data/lib/google/cloud/essentialcontacts/v1/service_services_pb.rb +61 -0
- data/proto_docs/README.md +4 -0
- data/proto_docs/google/api/field_behavior.rb +65 -0
- data/proto_docs/google/api/resource.rb +283 -0
- data/proto_docs/google/cloud/essentialcontacts/v1/enums.rb +81 -0
- data/proto_docs/google/cloud/essentialcontacts/v1/service.rb +219 -0
- data/proto_docs/google/protobuf/empty.rb +36 -0
- data/proto_docs/google/protobuf/field_mask.rb +229 -0
- data/proto_docs/google/protobuf/timestamp.rb +129 -0
- metadata +216 -0
@@ -0,0 +1,283 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2021 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
|
+
# name_descriptor: {
|
37
|
+
# pattern: "projects/{project}/topics/{topic}"
|
38
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
39
|
+
# parent_name_extractor: "projects/{project}"
|
40
|
+
# }
|
41
|
+
# };
|
42
|
+
# }
|
43
|
+
#
|
44
|
+
# The ResourceDescriptor Yaml config will look like:
|
45
|
+
#
|
46
|
+
# resources:
|
47
|
+
# - type: "pubsub.googleapis.com/Topic"
|
48
|
+
# name_descriptor:
|
49
|
+
# - pattern: "projects/{project}/topics/{topic}"
|
50
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
51
|
+
# parent_name_extractor: "projects/{project}"
|
52
|
+
#
|
53
|
+
# Sometimes, resources have multiple patterns, typically because they can
|
54
|
+
# live under multiple parents.
|
55
|
+
#
|
56
|
+
# Example:
|
57
|
+
#
|
58
|
+
# message LogEntry {
|
59
|
+
# option (google.api.resource) = {
|
60
|
+
# type: "logging.googleapis.com/LogEntry"
|
61
|
+
# name_descriptor: {
|
62
|
+
# pattern: "projects/{project}/logs/{log}"
|
63
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
64
|
+
# parent_name_extractor: "projects/{project}"
|
65
|
+
# }
|
66
|
+
# name_descriptor: {
|
67
|
+
# pattern: "folders/{folder}/logs/{log}"
|
68
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Folder"
|
69
|
+
# parent_name_extractor: "folders/{folder}"
|
70
|
+
# }
|
71
|
+
# name_descriptor: {
|
72
|
+
# pattern: "organizations/{organization}/logs/{log}"
|
73
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Organization"
|
74
|
+
# parent_name_extractor: "organizations/{organization}"
|
75
|
+
# }
|
76
|
+
# name_descriptor: {
|
77
|
+
# pattern: "billingAccounts/{billing_account}/logs/{log}"
|
78
|
+
# parent_type: "billing.googleapis.com/BillingAccount"
|
79
|
+
# parent_name_extractor: "billingAccounts/{billing_account}"
|
80
|
+
# }
|
81
|
+
# };
|
82
|
+
# }
|
83
|
+
#
|
84
|
+
# The ResourceDescriptor Yaml config will look like:
|
85
|
+
#
|
86
|
+
# resources:
|
87
|
+
# - type: 'logging.googleapis.com/LogEntry'
|
88
|
+
# name_descriptor:
|
89
|
+
# - pattern: "projects/{project}/logs/{log}"
|
90
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
91
|
+
# parent_name_extractor: "projects/{project}"
|
92
|
+
# - pattern: "folders/{folder}/logs/{log}"
|
93
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Folder"
|
94
|
+
# parent_name_extractor: "folders/{folder}"
|
95
|
+
# - pattern: "organizations/{organization}/logs/{log}"
|
96
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Organization"
|
97
|
+
# parent_name_extractor: "organizations/{organization}"
|
98
|
+
# - pattern: "billingAccounts/{billing_account}/logs/{log}"
|
99
|
+
# parent_type: "billing.googleapis.com/BillingAccount"
|
100
|
+
# parent_name_extractor: "billingAccounts/{billing_account}"
|
101
|
+
#
|
102
|
+
# For flexible resources, the resource name doesn't contain parent names, but
|
103
|
+
# the resource itself has parents for policy evaluation.
|
104
|
+
#
|
105
|
+
# Example:
|
106
|
+
#
|
107
|
+
# message Shelf {
|
108
|
+
# option (google.api.resource) = {
|
109
|
+
# type: "library.googleapis.com/Shelf"
|
110
|
+
# name_descriptor: {
|
111
|
+
# pattern: "shelves/{shelf}"
|
112
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
113
|
+
# }
|
114
|
+
# name_descriptor: {
|
115
|
+
# pattern: "shelves/{shelf}"
|
116
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Folder"
|
117
|
+
# }
|
118
|
+
# };
|
119
|
+
# }
|
120
|
+
#
|
121
|
+
# The ResourceDescriptor Yaml config will look like:
|
122
|
+
#
|
123
|
+
# resources:
|
124
|
+
# - type: 'library.googleapis.com/Shelf'
|
125
|
+
# name_descriptor:
|
126
|
+
# - pattern: "shelves/{shelf}"
|
127
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
128
|
+
# - pattern: "shelves/{shelf}"
|
129
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Folder"
|
130
|
+
# @!attribute [rw] type
|
131
|
+
# @return [::String]
|
132
|
+
# The resource type. It must be in the format of
|
133
|
+
# \\{service_name}/\\{resource_type_kind}. The `resource_type_kind` must be
|
134
|
+
# singular and must not include version numbers.
|
135
|
+
#
|
136
|
+
# Example: `storage.googleapis.com/Bucket`
|
137
|
+
#
|
138
|
+
# The value of the resource_type_kind must follow the regular expression
|
139
|
+
# /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and
|
140
|
+
# should use PascalCase (UpperCamelCase). The maximum number of
|
141
|
+
# characters allowed for the `resource_type_kind` is 100.
|
142
|
+
# @!attribute [rw] pattern
|
143
|
+
# @return [::Array<::String>]
|
144
|
+
# Optional. The relative resource name pattern associated with this resource
|
145
|
+
# type. The DNS prefix of the full resource name shouldn't be specified here.
|
146
|
+
#
|
147
|
+
# The path pattern must follow the syntax, which aligns with HTTP binding
|
148
|
+
# syntax:
|
149
|
+
#
|
150
|
+
# Template = Segment { "/" Segment } ;
|
151
|
+
# Segment = LITERAL | Variable ;
|
152
|
+
# Variable = "{" LITERAL "}" ;
|
153
|
+
#
|
154
|
+
# Examples:
|
155
|
+
#
|
156
|
+
# - "projects/\\{project}/topics/\\{topic}"
|
157
|
+
# - "projects/\\{project}/knowledgeBases/\\{knowledge_base}"
|
158
|
+
#
|
159
|
+
# The components in braces correspond to the IDs for each resource in the
|
160
|
+
# hierarchy. It is expected that, if multiple patterns are provided,
|
161
|
+
# the same component name (e.g. "project") refers to IDs of the same
|
162
|
+
# type of resource.
|
163
|
+
# @!attribute [rw] name_field
|
164
|
+
# @return [::String]
|
165
|
+
# Optional. The field on the resource that designates the resource name
|
166
|
+
# field. If omitted, this is assumed to be "name".
|
167
|
+
# @!attribute [rw] history
|
168
|
+
# @return [::Google::Api::ResourceDescriptor::History]
|
169
|
+
# Optional. The historical or future-looking state of the resource pattern.
|
170
|
+
#
|
171
|
+
# Example:
|
172
|
+
#
|
173
|
+
# // The InspectTemplate message originally only supported resource
|
174
|
+
# // names with organization, and project was added later.
|
175
|
+
# message InspectTemplate {
|
176
|
+
# option (google.api.resource) = {
|
177
|
+
# type: "dlp.googleapis.com/InspectTemplate"
|
178
|
+
# pattern:
|
179
|
+
# "organizations/{organization}/inspectTemplates/{inspect_template}"
|
180
|
+
# pattern: "projects/{project}/inspectTemplates/{inspect_template}"
|
181
|
+
# history: ORIGINALLY_SINGLE_PATTERN
|
182
|
+
# };
|
183
|
+
# }
|
184
|
+
# @!attribute [rw] plural
|
185
|
+
# @return [::String]
|
186
|
+
# The plural name used in the resource name and permission names, such as
|
187
|
+
# 'projects' for the resource name of 'projects/\\{project}' and the permission
|
188
|
+
# name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
|
189
|
+
# concept of the `plural` field in k8s CRD spec
|
190
|
+
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
191
|
+
#
|
192
|
+
# Note: The plural form is required even for singleton resources. See
|
193
|
+
# https://aip.dev/156
|
194
|
+
# @!attribute [rw] singular
|
195
|
+
# @return [::String]
|
196
|
+
# The same concept of the `singular` field in k8s CRD spec
|
197
|
+
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
198
|
+
# Such as "project" for the `resourcemanager.googleapis.com/Project` type.
|
199
|
+
# @!attribute [rw] style
|
200
|
+
# @return [::Array<::Google::Api::ResourceDescriptor::Style>]
|
201
|
+
# Style flag(s) for this resource.
|
202
|
+
# These indicate that a resource is expected to conform to a given
|
203
|
+
# style. See the specific style flags for additional information.
|
204
|
+
class ResourceDescriptor
|
205
|
+
include ::Google::Protobuf::MessageExts
|
206
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
207
|
+
|
208
|
+
# A description of the historical or future-looking state of the
|
209
|
+
# resource pattern.
|
210
|
+
module History
|
211
|
+
# The "unset" value.
|
212
|
+
HISTORY_UNSPECIFIED = 0
|
213
|
+
|
214
|
+
# The resource originally had one pattern and launched as such, and
|
215
|
+
# additional patterns were added later.
|
216
|
+
ORIGINALLY_SINGLE_PATTERN = 1
|
217
|
+
|
218
|
+
# The resource has one pattern, but the API owner expects to add more
|
219
|
+
# later. (This is the inverse of ORIGINALLY_SINGLE_PATTERN, and prevents
|
220
|
+
# that from being necessary once there are multiple patterns.)
|
221
|
+
FUTURE_MULTI_PATTERN = 2
|
222
|
+
end
|
223
|
+
|
224
|
+
# A flag representing a specific style that a resource claims to conform to.
|
225
|
+
module Style
|
226
|
+
# The unspecified value. Do not use.
|
227
|
+
STYLE_UNSPECIFIED = 0
|
228
|
+
|
229
|
+
# This resource is intended to be "declarative-friendly".
|
230
|
+
#
|
231
|
+
# Declarative-friendly resources must be more strictly consistent, and
|
232
|
+
# setting this to true communicates to tools that this resource should
|
233
|
+
# adhere to declarative-friendly expectations.
|
234
|
+
#
|
235
|
+
# Note: This is used by the API linter (linter.aip.dev) to enable
|
236
|
+
# additional checks.
|
237
|
+
DECLARATIVE_FRIENDLY = 1
|
238
|
+
end
|
239
|
+
end
|
240
|
+
|
241
|
+
# Defines a proto annotation that describes a string field that refers to
|
242
|
+
# an API resource.
|
243
|
+
# @!attribute [rw] type
|
244
|
+
# @return [::String]
|
245
|
+
# The resource type that the annotated field references.
|
246
|
+
#
|
247
|
+
# Example:
|
248
|
+
#
|
249
|
+
# message Subscription {
|
250
|
+
# string topic = 2 [(google.api.resource_reference) = {
|
251
|
+
# type: "pubsub.googleapis.com/Topic"
|
252
|
+
# }];
|
253
|
+
# }
|
254
|
+
#
|
255
|
+
# Occasionally, a field may reference an arbitrary resource. In this case,
|
256
|
+
# APIs use the special value * in their resource reference.
|
257
|
+
#
|
258
|
+
# Example:
|
259
|
+
#
|
260
|
+
# message GetIamPolicyRequest {
|
261
|
+
# string resource = 2 [(google.api.resource_reference) = {
|
262
|
+
# type: "*"
|
263
|
+
# }];
|
264
|
+
# }
|
265
|
+
# @!attribute [rw] child_type
|
266
|
+
# @return [::String]
|
267
|
+
# The resource type of a child collection that the annotated field
|
268
|
+
# references. This is useful for annotating the `parent` field that
|
269
|
+
# doesn't have a fixed resource type.
|
270
|
+
#
|
271
|
+
# Example:
|
272
|
+
#
|
273
|
+
# message ListLogEntriesRequest {
|
274
|
+
# string parent = 1 [(google.api.resource_reference) = {
|
275
|
+
# child_type: "logging.googleapis.com/LogEntry"
|
276
|
+
# };
|
277
|
+
# }
|
278
|
+
class ResourceReference
|
279
|
+
include ::Google::Protobuf::MessageExts
|
280
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
281
|
+
end
|
282
|
+
end
|
283
|
+
end
|
@@ -0,0 +1,81 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2021 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 EssentialContacts
|
23
|
+
module V1
|
24
|
+
# The notification categories that an essential contact can be subscribed to.
|
25
|
+
# Each notification will be categorized by the sender into one of the following
|
26
|
+
# categories. All contacts that are subscribed to that category will receive
|
27
|
+
# the notification.
|
28
|
+
module NotificationCategory
|
29
|
+
# Notification category is unrecognized or unspecified.
|
30
|
+
NOTIFICATION_CATEGORY_UNSPECIFIED = 0
|
31
|
+
|
32
|
+
# All notifications related to the resource, including notifications
|
33
|
+
# pertaining to categories added in the future.
|
34
|
+
ALL = 2
|
35
|
+
|
36
|
+
# Notifications related to imminent account suspension.
|
37
|
+
SUSPENSION = 3
|
38
|
+
|
39
|
+
# Notifications related to security/privacy incidents, notifications, and
|
40
|
+
# vulnerabilities.
|
41
|
+
SECURITY = 5
|
42
|
+
|
43
|
+
# Notifications related to technical events and issues such as outages,
|
44
|
+
# errors, or bugs.
|
45
|
+
TECHNICAL = 6
|
46
|
+
|
47
|
+
# Notifications related to billing and payments notifications, price updates,
|
48
|
+
# errors, or credits.
|
49
|
+
BILLING = 7
|
50
|
+
|
51
|
+
# Notifications related to enforcement actions, regulatory compliance, or
|
52
|
+
# government notices.
|
53
|
+
LEGAL = 8
|
54
|
+
|
55
|
+
# Notifications related to new versions, product terms updates, or
|
56
|
+
# deprecations.
|
57
|
+
PRODUCT_UPDATES = 9
|
58
|
+
|
59
|
+
# Child category of TECHNICAL. If assigned, technical incident notifications
|
60
|
+
# will go to these contacts instead of TECHNICAL.
|
61
|
+
TECHNICAL_INCIDENTS = 10
|
62
|
+
end
|
63
|
+
|
64
|
+
# A contact's validation state indicates whether or not it is the correct
|
65
|
+
# contact to be receiving notifications for a particular resource.
|
66
|
+
module ValidationState
|
67
|
+
# The validation state is unknown or unspecified.
|
68
|
+
VALIDATION_STATE_UNSPECIFIED = 0
|
69
|
+
|
70
|
+
# The contact is marked as valid. This is usually done manually by the
|
71
|
+
# contact admin. All new contacts begin in the valid state.
|
72
|
+
VALID = 1
|
73
|
+
|
74
|
+
# The contact is considered invalid. This may become the state if the
|
75
|
+
# contact's email is found to be unreachable.
|
76
|
+
INVALID = 2
|
77
|
+
end
|
78
|
+
end
|
79
|
+
end
|
80
|
+
end
|
81
|
+
end
|
@@ -0,0 +1,219 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2021 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 EssentialContacts
|
23
|
+
module V1
|
24
|
+
# A contact that will receive notifications from Google Cloud.
|
25
|
+
# @!attribute [rw] name
|
26
|
+
# @return [::String]
|
27
|
+
# The identifier for the contact.
|
28
|
+
# Format: \\{resource_type}/\\{resource_id}/contacts/\\{contact_id}
|
29
|
+
# @!attribute [rw] email
|
30
|
+
# @return [::String]
|
31
|
+
# Required. The email address to send notifications to. This does not need to
|
32
|
+
# be a Google account.
|
33
|
+
# @!attribute [rw] notification_category_subscriptions
|
34
|
+
# @return [::Array<::Google::Cloud::EssentialContacts::V1::NotificationCategory>]
|
35
|
+
# The categories of notifications that the contact will receive
|
36
|
+
# communications for.
|
37
|
+
# @!attribute [rw] language_tag
|
38
|
+
# @return [::String]
|
39
|
+
# The preferred language for notifications, as a ISO 639-1 language code. See
|
40
|
+
# [Supported
|
41
|
+
# languages](https://cloud.google.com/resource-manager/docs/managing-notification-contacts#supported-languages)
|
42
|
+
# for a list of supported languages.
|
43
|
+
# @!attribute [rw] validation_state
|
44
|
+
# @return [::Google::Cloud::EssentialContacts::V1::ValidationState]
|
45
|
+
# The validity of the contact. A contact is considered valid if it is the
|
46
|
+
# correct recipient for notifications for a particular resource.
|
47
|
+
# @!attribute [rw] validate_time
|
48
|
+
# @return [::Google::Protobuf::Timestamp]
|
49
|
+
# The last time the validation_state was updated, either manually or
|
50
|
+
# automatically. A contact is considered stale if its validation state was
|
51
|
+
# updated more than 1 year ago.
|
52
|
+
class Contact
|
53
|
+
include ::Google::Protobuf::MessageExts
|
54
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
55
|
+
end
|
56
|
+
|
57
|
+
# Request message for the ListContacts method.
|
58
|
+
# @!attribute [rw] parent
|
59
|
+
# @return [::String]
|
60
|
+
# Required. The parent resource name.
|
61
|
+
# Format: organizations/\\{organization_id}, folders/\\{folder_id} or
|
62
|
+
# projects/\\{project_id}
|
63
|
+
# @!attribute [rw] page_size
|
64
|
+
# @return [::Integer]
|
65
|
+
# Optional. The maximum number of results to return from this request.
|
66
|
+
# Non-positive values are ignored. The presence of `next_page_token` in the
|
67
|
+
# response indicates that more results might be available.
|
68
|
+
# If not specified, the default page_size is 100.
|
69
|
+
# @!attribute [rw] page_token
|
70
|
+
# @return [::String]
|
71
|
+
# Optional. If present, retrieves the next batch of results from the
|
72
|
+
# preceding call to this method. `page_token` must be the value of
|
73
|
+
# `next_page_token` from the previous response. The values of other method
|
74
|
+
# parameters should be identical to those in the previous call.
|
75
|
+
class ListContactsRequest
|
76
|
+
include ::Google::Protobuf::MessageExts
|
77
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
78
|
+
end
|
79
|
+
|
80
|
+
# Response message for the ListContacts method.
|
81
|
+
# @!attribute [rw] contacts
|
82
|
+
# @return [::Array<::Google::Cloud::EssentialContacts::V1::Contact>]
|
83
|
+
# The contacts for the specified resource.
|
84
|
+
# @!attribute [rw] next_page_token
|
85
|
+
# @return [::String]
|
86
|
+
# If there are more results than those appearing in this response, then
|
87
|
+
# `next_page_token` is included. To get the next set of results, call this
|
88
|
+
# method again using the value of `next_page_token` as `page_token` and the
|
89
|
+
# rest of the parameters the same as the original request.
|
90
|
+
class ListContactsResponse
|
91
|
+
include ::Google::Protobuf::MessageExts
|
92
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
93
|
+
end
|
94
|
+
|
95
|
+
# Request message for the GetContact method.
|
96
|
+
# @!attribute [rw] name
|
97
|
+
# @return [::String]
|
98
|
+
# Required. The name of the contact to retrieve.
|
99
|
+
# Format: organizations/\\{organization_id}/contacts/\\{contact_id},
|
100
|
+
# folders/\\{folder_id}/contacts/\\{contact_id} or
|
101
|
+
# projects/\\{project_id}/contacts/\\{contact_id}
|
102
|
+
class GetContactRequest
|
103
|
+
include ::Google::Protobuf::MessageExts
|
104
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
105
|
+
end
|
106
|
+
|
107
|
+
# Request message for the DeleteContact method.
|
108
|
+
# @!attribute [rw] name
|
109
|
+
# @return [::String]
|
110
|
+
# Required. The name of the contact to delete.
|
111
|
+
# Format: organizations/\\{organization_id}/contacts/\\{contact_id},
|
112
|
+
# folders/\\{folder_id}/contacts/\\{contact_id} or
|
113
|
+
# projects/\\{project_id}/contacts/\\{contact_id}
|
114
|
+
class DeleteContactRequest
|
115
|
+
include ::Google::Protobuf::MessageExts
|
116
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
117
|
+
end
|
118
|
+
|
119
|
+
# Request message for the CreateContact method.
|
120
|
+
# @!attribute [rw] parent
|
121
|
+
# @return [::String]
|
122
|
+
# Required. The resource to save this contact for.
|
123
|
+
# Format: organizations/\\{organization_id}, folders/\\{folder_id} or
|
124
|
+
# projects/\\{project_id}
|
125
|
+
# @!attribute [rw] contact
|
126
|
+
# @return [::Google::Cloud::EssentialContacts::V1::Contact]
|
127
|
+
# Required. The contact to create. Must specify an email address and language
|
128
|
+
# tag.
|
129
|
+
class CreateContactRequest
|
130
|
+
include ::Google::Protobuf::MessageExts
|
131
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
132
|
+
end
|
133
|
+
|
134
|
+
# Request message for the UpdateContact method.
|
135
|
+
# @!attribute [rw] contact
|
136
|
+
# @return [::Google::Cloud::EssentialContacts::V1::Contact]
|
137
|
+
# Required. The contact resource to replace the existing saved contact. Note:
|
138
|
+
# the email address of the contact cannot be modified.
|
139
|
+
# @!attribute [rw] update_mask
|
140
|
+
# @return [::Google::Protobuf::FieldMask]
|
141
|
+
# Optional. The update mask applied to the resource. For the `FieldMask`
|
142
|
+
# definition, see
|
143
|
+
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
|
144
|
+
class UpdateContactRequest
|
145
|
+
include ::Google::Protobuf::MessageExts
|
146
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
147
|
+
end
|
148
|
+
|
149
|
+
# Request message for the ComputeContacts method.
|
150
|
+
# @!attribute [rw] parent
|
151
|
+
# @return [::String]
|
152
|
+
# Required. The name of the resource to compute contacts for.
|
153
|
+
# Format: organizations/\\{organization_id},
|
154
|
+
# folders/\\{folder_id} or projects/\\{project_id}
|
155
|
+
# @!attribute [rw] notification_categories
|
156
|
+
# @return [::Array<::Google::Cloud::EssentialContacts::V1::NotificationCategory>]
|
157
|
+
# The categories of notifications to compute contacts for. If ALL is included
|
158
|
+
# in this list, contacts subscribed to any notification category will be
|
159
|
+
# returned.
|
160
|
+
# @!attribute [rw] page_size
|
161
|
+
# @return [::Integer]
|
162
|
+
# Optional. The maximum number of results to return from this request.
|
163
|
+
# Non-positive values are ignored. The presence of `next_page_token` in the
|
164
|
+
# response indicates that more results might be available.
|
165
|
+
# If not specified, the default page_size is 100.
|
166
|
+
# @!attribute [rw] page_token
|
167
|
+
# @return [::String]
|
168
|
+
# Optional. If present, retrieves the next batch of results from the
|
169
|
+
# preceding call to this method. `page_token` must be the value of
|
170
|
+
# `next_page_token` from the previous response. The values of other method
|
171
|
+
# parameters should be identical to those in the previous call.
|
172
|
+
class ComputeContactsRequest
|
173
|
+
include ::Google::Protobuf::MessageExts
|
174
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
175
|
+
end
|
176
|
+
|
177
|
+
# Response message for the ComputeContacts method.
|
178
|
+
# @!attribute [rw] contacts
|
179
|
+
# @return [::Array<::Google::Cloud::EssentialContacts::V1::Contact>]
|
180
|
+
# All contacts for the resource that are subscribed to the specified
|
181
|
+
# notification categories, including contacts inherited from any parent
|
182
|
+
# resources.
|
183
|
+
# @!attribute [rw] next_page_token
|
184
|
+
# @return [::String]
|
185
|
+
# If there are more results than those appearing in this response, then
|
186
|
+
# `next_page_token` is included. To get the next set of results, call this
|
187
|
+
# method again using the value of `next_page_token` as `page_token` and the
|
188
|
+
# rest of the parameters the same as the original request.
|
189
|
+
class ComputeContactsResponse
|
190
|
+
include ::Google::Protobuf::MessageExts
|
191
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
192
|
+
end
|
193
|
+
|
194
|
+
# Request message for the SendTestMessage method.
|
195
|
+
# @!attribute [rw] contacts
|
196
|
+
# @return [::Array<::String>]
|
197
|
+
# Required. The list of names of the contacts to send a test message to.
|
198
|
+
# Format: organizations/\\{organization_id}/contacts/\\{contact_id},
|
199
|
+
# folders/\\{folder_id}/contacts/\\{contact_id} or
|
200
|
+
# projects/\\{project_id}/contacts/\\{contact_id}
|
201
|
+
# @!attribute [rw] resource
|
202
|
+
# @return [::String]
|
203
|
+
# Required. The name of the resource to send the test message for. All
|
204
|
+
# contacts must either be set directly on this resource or inherited from
|
205
|
+
# another resource that is an ancestor of this one. Format:
|
206
|
+
# organizations/\\{organization_id}, folders/\\{folder_id} or
|
207
|
+
# projects/\\{project_id}
|
208
|
+
# @!attribute [rw] notification_category
|
209
|
+
# @return [::Google::Cloud::EssentialContacts::V1::NotificationCategory]
|
210
|
+
# Required. The notification category to send the test message for. All
|
211
|
+
# contacts must be subscribed to this category.
|
212
|
+
class SendTestMessageRequest
|
213
|
+
include ::Google::Protobuf::MessageExts
|
214
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
215
|
+
end
|
216
|
+
end
|
217
|
+
end
|
218
|
+
end
|
219
|
+
end
|