@google-cloud/discoveryengine 1.1.0 → 1.2.0
Sign up to get free protection for your applications and to get access to all the features.
- package/CHANGELOG.md +7 -0
- package/README.md +26 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/common.proto +155 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/completion_service.proto +134 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/conversation.proto +138 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/conversational_search_service.proto +306 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/document.proto +121 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/document_service.proto +318 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/import_config.proto +343 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/purge_config.proto +159 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/recommendation_service.proto +221 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/schema.proto +312 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/schema_service.proto +260 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/search_service.proto +851 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/site_search_engine_service.proto +152 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/user_event.proto +475 -0
- package/build/protos/google/cloud/discoveryengine/v1alpha/user_event_service.proto +154 -0
- package/build/protos/protos.d.ts +12587 -7
- package/build/protos/protos.js +34918 -3126
- package/build/protos/protos.json +3458 -5
- package/build/src/index.d.ts +3 -1
- package/build/src/index.js +4 -1
- package/build/src/v1alpha/completion_service_client.d.ts +603 -0
- package/build/src/v1alpha/completion_service_client.js +843 -0
- package/build/src/v1alpha/completion_service_client_config.json +43 -0
- package/build/src/v1alpha/conversational_search_service_client.d.ts +998 -0
- package/build/src/v1alpha/conversational_search_service_client.js +1275 -0
- package/build/src/v1alpha/conversational_search_service_client_config.json +68 -0
- package/build/src/v1alpha/document_service_client.d.ts +1140 -0
- package/build/src/v1alpha/document_service_client.js +1393 -0
- package/build/src/v1alpha/document_service_client_config.json +82 -0
- package/build/src/v1alpha/index.d.ts +8 -0
- package/build/src/v1alpha/index.js +37 -0
- package/build/src/v1alpha/recommendation_service_client.d.ts +735 -0
- package/build/src/v1alpha/recommendation_service_client.js +938 -0
- package/build/src/v1alpha/recommendation_service_client_config.json +43 -0
- package/build/src/v1alpha/schema_service_client.d.ts +935 -0
- package/build/src/v1alpha/schema_service_client.js +1327 -0
- package/build/src/v1alpha/schema_service_client_config.json +63 -0
- package/build/src/v1alpha/search_service_client.d.ts +1208 -0
- package/build/src/v1alpha/search_service_client.js +1432 -0
- package/build/src/v1alpha/search_service_client_config.json +43 -0
- package/build/src/v1alpha/site_search_engine_service_client.d.ts +704 -0
- package/build/src/v1alpha/site_search_engine_service_client.js +1087 -0
- package/build/src/v1alpha/site_search_engine_service_client_config.json +30 -0
- package/build/src/v1alpha/user_event_service_client.d.ts +853 -0
- package/build/src/v1alpha/user_event_service_client.js +1174 -0
- package/build/src/v1alpha/user_event_service_client_config.json +67 -0
- package/package.json +3 -3
@@ -0,0 +1,306 @@
|
|
1
|
+
// Copyright 2022 Google LLC
|
2
|
+
//
|
3
|
+
// Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
// you may not use this file except in compliance with the License.
|
5
|
+
// You may obtain a copy of the License at
|
6
|
+
//
|
7
|
+
// http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
//
|
9
|
+
// Unless required by applicable law or agreed to in writing, software
|
10
|
+
// distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
// See the License for the specific language governing permissions and
|
13
|
+
// limitations under the License.
|
14
|
+
|
15
|
+
syntax = "proto3";
|
16
|
+
|
17
|
+
package google.cloud.discoveryengine.v1alpha;
|
18
|
+
|
19
|
+
import "google/api/annotations.proto";
|
20
|
+
import "google/api/client.proto";
|
21
|
+
import "google/api/field_behavior.proto";
|
22
|
+
import "google/api/resource.proto";
|
23
|
+
import "google/cloud/discoveryengine/v1alpha/conversation.proto";
|
24
|
+
import "google/cloud/discoveryengine/v1alpha/search_service.proto";
|
25
|
+
import "google/protobuf/empty.proto";
|
26
|
+
import "google/protobuf/field_mask.proto";
|
27
|
+
|
28
|
+
option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Alpha";
|
29
|
+
option go_package = "cloud.google.com/go/discoveryengine/apiv1alpha/discoveryenginepb;discoveryenginepb";
|
30
|
+
option java_multiple_files = true;
|
31
|
+
option java_outer_classname = "ConversationalSearchServiceProto";
|
32
|
+
option java_package = "com.google.cloud.discoveryengine.v1alpha";
|
33
|
+
option objc_class_prefix = "DISCOVERYENGINE";
|
34
|
+
option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1alpha";
|
35
|
+
option ruby_package = "Google::Cloud::DiscoveryEngine::V1alpha";
|
36
|
+
|
37
|
+
// Service for conversational search.
|
38
|
+
service ConversationalSearchService {
|
39
|
+
option (google.api.default_host) = "discoveryengine.googleapis.com";
|
40
|
+
option (google.api.oauth_scopes) =
|
41
|
+
"https://www.googleapis.com/auth/cloud-platform";
|
42
|
+
|
43
|
+
// Converses a conversation.
|
44
|
+
rpc ConverseConversation(ConverseConversationRequest)
|
45
|
+
returns (ConverseConversationResponse) {
|
46
|
+
option (google.api.http) = {
|
47
|
+
post: "/v1alpha/{name=projects/*/locations/*/dataStores/*/conversations/*}:converse"
|
48
|
+
body: "*"
|
49
|
+
additional_bindings {
|
50
|
+
post: "/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}:converse"
|
51
|
+
body: "*"
|
52
|
+
}
|
53
|
+
};
|
54
|
+
option (google.api.method_signature) = "name,query";
|
55
|
+
}
|
56
|
+
|
57
|
+
// Creates a Conversation.
|
58
|
+
//
|
59
|
+
// If the [Conversation][google.cloud.discoveryengine.v1alpha.Conversation] to
|
60
|
+
// create already exists, an ALREADY_EXISTS error is returned.
|
61
|
+
rpc CreateConversation(CreateConversationRequest) returns (Conversation) {
|
62
|
+
option (google.api.http) = {
|
63
|
+
post: "/v1alpha/{parent=projects/*/locations/*/dataStores/*}/conversations"
|
64
|
+
body: "conversation"
|
65
|
+
additional_bindings {
|
66
|
+
post: "/v1alpha/{parent=projects/*/locations/*/collections/*/dataStores/*}/conversations"
|
67
|
+
body: "conversation"
|
68
|
+
}
|
69
|
+
};
|
70
|
+
option (google.api.method_signature) = "parent,conversation";
|
71
|
+
}
|
72
|
+
|
73
|
+
// Deletes a Conversation.
|
74
|
+
//
|
75
|
+
// If the [Conversation][google.cloud.discoveryengine.v1alpha.Conversation] to
|
76
|
+
// delete does not exist, a NOT_FOUND error is returned.
|
77
|
+
rpc DeleteConversation(DeleteConversationRequest)
|
78
|
+
returns (google.protobuf.Empty) {
|
79
|
+
option (google.api.http) = {
|
80
|
+
delete: "/v1alpha/{name=projects/*/locations/*/dataStores/*/conversations/*}"
|
81
|
+
additional_bindings {
|
82
|
+
delete: "/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}"
|
83
|
+
}
|
84
|
+
};
|
85
|
+
option (google.api.method_signature) = "name";
|
86
|
+
}
|
87
|
+
|
88
|
+
// Updates a Conversation.
|
89
|
+
//
|
90
|
+
// [Conversation][google.cloud.discoveryengine.v1alpha.Conversation] action
|
91
|
+
// type cannot be changed. If the
|
92
|
+
// [Conversation][google.cloud.discoveryengine.v1alpha.Conversation] to update
|
93
|
+
// does not exist, a NOT_FOUND error is returned.
|
94
|
+
rpc UpdateConversation(UpdateConversationRequest) returns (Conversation) {
|
95
|
+
option (google.api.http) = {
|
96
|
+
patch: "/v1alpha/{conversation.name=projects/*/locations/*/dataStores/*/conversations/*}"
|
97
|
+
body: "conversation"
|
98
|
+
additional_bindings {
|
99
|
+
patch: "/v1alpha/{conversation.name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}"
|
100
|
+
body: "conversation"
|
101
|
+
}
|
102
|
+
};
|
103
|
+
option (google.api.method_signature) = "conversation,update_mask";
|
104
|
+
}
|
105
|
+
|
106
|
+
// Gets a Conversation.
|
107
|
+
rpc GetConversation(GetConversationRequest) returns (Conversation) {
|
108
|
+
option (google.api.http) = {
|
109
|
+
get: "/v1alpha/{name=projects/*/locations/*/dataStores/*/conversations/*}"
|
110
|
+
additional_bindings {
|
111
|
+
get: "/v1alpha/{name=projects/*/locations/*/collections/*/dataStores/*/conversations/*}"
|
112
|
+
}
|
113
|
+
};
|
114
|
+
option (google.api.method_signature) = "name";
|
115
|
+
}
|
116
|
+
|
117
|
+
// Lists all Conversations by their parent
|
118
|
+
// [DataStore][google.cloud.discoveryengine.v1alpha.DataStore].
|
119
|
+
rpc ListConversations(ListConversationsRequest)
|
120
|
+
returns (ListConversationsResponse) {
|
121
|
+
option (google.api.http) = {
|
122
|
+
get: "/v1alpha/{parent=projects/*/locations/*/dataStores/*}/conversations"
|
123
|
+
additional_bindings {
|
124
|
+
get: "/v1alpha/{parent=projects/*/locations/*/collections/*/dataStores/*}/conversations"
|
125
|
+
}
|
126
|
+
};
|
127
|
+
option (google.api.method_signature) = "parent";
|
128
|
+
}
|
129
|
+
}
|
130
|
+
|
131
|
+
// Request message for
|
132
|
+
// [ConversationalSearchService.ConverseConversation][google.cloud.discoveryengine.v1alpha.ConversationalSearchService.ConverseConversation]
|
133
|
+
// method.
|
134
|
+
message ConverseConversationRequest {
|
135
|
+
// Required. The resource name of the Conversation to get. Format:
|
136
|
+
// `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`.
|
137
|
+
// Use
|
138
|
+
// `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-`
|
139
|
+
// to activate auto session mode, which automatically creates a new
|
140
|
+
// conversation inside a ConverseConversation session.
|
141
|
+
string name = 1 [
|
142
|
+
(google.api.field_behavior) = REQUIRED,
|
143
|
+
(google.api.resource_reference) = {
|
144
|
+
type: "discoveryengine.googleapis.com/Conversation"
|
145
|
+
}
|
146
|
+
];
|
147
|
+
|
148
|
+
// Required. Current user input.
|
149
|
+
TextInput query = 2 [(google.api.field_behavior) = REQUIRED];
|
150
|
+
|
151
|
+
// The resource name of the Serving Config to use. Format:
|
152
|
+
// `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}`
|
153
|
+
// If this is not set, the default serving config will be used.
|
154
|
+
string serving_config = 3 [(google.api.resource_reference) = {
|
155
|
+
type: "discoveryengine.googleapis.com/ServingConfig"
|
156
|
+
}];
|
157
|
+
|
158
|
+
// The conversation to be used by auto session only. The name field will be
|
159
|
+
// ignored as we automatically assign new name for the conversation in auto
|
160
|
+
// session.
|
161
|
+
Conversation conversation = 5;
|
162
|
+
|
163
|
+
// Whether to turn on safe search.
|
164
|
+
bool safe_search = 6;
|
165
|
+
|
166
|
+
// The user labels applied to a resource must meet the following requirements:
|
167
|
+
//
|
168
|
+
// * Each resource can have multiple labels, up to a maximum of 64.
|
169
|
+
// * Each label must be a key-value pair.
|
170
|
+
// * Keys have a minimum length of 1 character and a maximum length of 63
|
171
|
+
// characters and cannot be empty. Values can be empty and have a maximum
|
172
|
+
// length of 63 characters.
|
173
|
+
// * Keys and values can contain only lowercase letters, numeric characters,
|
174
|
+
// underscores, and dashes. All characters must use UTF-8 encoding, and
|
175
|
+
// international characters are allowed.
|
176
|
+
// * The key portion of a label must be unique. However, you can use the same
|
177
|
+
// key with multiple resources.
|
178
|
+
// * Keys must start with a lowercase letter or international character.
|
179
|
+
//
|
180
|
+
// See [Google Cloud
|
181
|
+
// Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
|
182
|
+
// for more details.
|
183
|
+
map<string, string> user_labels = 7;
|
184
|
+
|
185
|
+
// A specification for configuring the summary returned in the response.
|
186
|
+
SearchRequest.ContentSearchSpec.SummarySpec summary_spec = 8;
|
187
|
+
}
|
188
|
+
|
189
|
+
// Response message for
|
190
|
+
// [ConversationalSearchService.ConverseConversation][google.cloud.discoveryengine.v1alpha.ConversationalSearchService.ConverseConversation]
|
191
|
+
// method.
|
192
|
+
message ConverseConversationResponse {
|
193
|
+
// Answer to the current query.
|
194
|
+
Reply reply = 1;
|
195
|
+
|
196
|
+
// Updated conversation including the answer.
|
197
|
+
Conversation conversation = 2;
|
198
|
+
|
199
|
+
// Suggested related questions.
|
200
|
+
repeated string related_questions = 6;
|
201
|
+
|
202
|
+
// Search Results.
|
203
|
+
repeated SearchResponse.SearchResult search_results = 3;
|
204
|
+
}
|
205
|
+
|
206
|
+
// Request for CreateConversation method.
|
207
|
+
message CreateConversationRequest {
|
208
|
+
// Required. Full resource name of parent data store. Format:
|
209
|
+
// `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`
|
210
|
+
string parent = 1 [
|
211
|
+
(google.api.field_behavior) = REQUIRED,
|
212
|
+
(google.api.resource_reference) = {
|
213
|
+
type: "discoveryengine.googleapis.com/DataStore"
|
214
|
+
}
|
215
|
+
];
|
216
|
+
|
217
|
+
// Required. The conversation to create.
|
218
|
+
Conversation conversation = 2 [(google.api.field_behavior) = REQUIRED];
|
219
|
+
}
|
220
|
+
|
221
|
+
// Request for UpdateConversation method.
|
222
|
+
message UpdateConversationRequest {
|
223
|
+
// Required. The Conversation to update.
|
224
|
+
Conversation conversation = 1 [(google.api.field_behavior) = REQUIRED];
|
225
|
+
|
226
|
+
// Indicates which fields in the provided
|
227
|
+
// [Conversation][google.cloud.discoveryengine.v1alpha.Conversation] to
|
228
|
+
// update. The following are NOT supported:
|
229
|
+
//
|
230
|
+
// * [conversation.name][]
|
231
|
+
//
|
232
|
+
// If not set or empty, all supported fields are updated.
|
233
|
+
google.protobuf.FieldMask update_mask = 2;
|
234
|
+
}
|
235
|
+
|
236
|
+
// Request for DeleteConversation method.
|
237
|
+
message DeleteConversationRequest {
|
238
|
+
// Required. The resource name of the Conversation to delete. Format:
|
239
|
+
// `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`
|
240
|
+
string name = 1 [
|
241
|
+
(google.api.field_behavior) = REQUIRED,
|
242
|
+
(google.api.resource_reference) = {
|
243
|
+
type: "discoveryengine.googleapis.com/Conversation"
|
244
|
+
}
|
245
|
+
];
|
246
|
+
}
|
247
|
+
|
248
|
+
// Request for GetConversation method.
|
249
|
+
message GetConversationRequest {
|
250
|
+
// Required. The resource name of the Conversation to get. Format:
|
251
|
+
// `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`
|
252
|
+
string name = 1 [
|
253
|
+
(google.api.field_behavior) = REQUIRED,
|
254
|
+
(google.api.resource_reference) = {
|
255
|
+
type: "discoveryengine.googleapis.com/Conversation"
|
256
|
+
}
|
257
|
+
];
|
258
|
+
}
|
259
|
+
|
260
|
+
// Request for ListConversations method.
|
261
|
+
message ListConversationsRequest {
|
262
|
+
// Required. The data store resource name. Format:
|
263
|
+
// `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`
|
264
|
+
string parent = 1 [
|
265
|
+
(google.api.field_behavior) = REQUIRED,
|
266
|
+
(google.api.resource_reference) = {
|
267
|
+
type: "discoveryengine.googleapis.com/DataStore"
|
268
|
+
}
|
269
|
+
];
|
270
|
+
|
271
|
+
// Maximum number of results to return. If unspecified, defaults
|
272
|
+
// to 50. Max allowed value is 1000.
|
273
|
+
int32 page_size = 2;
|
274
|
+
|
275
|
+
// A page token, received from a previous `ListConversations` call.
|
276
|
+
// Provide this to retrieve the subsequent page.
|
277
|
+
string page_token = 3;
|
278
|
+
|
279
|
+
// A filter to apply on the list results. The supported features are:
|
280
|
+
// user_pseudo_id, state.
|
281
|
+
//
|
282
|
+
// Example:
|
283
|
+
// "user_pseudo_id = some_id"
|
284
|
+
string filter = 4;
|
285
|
+
|
286
|
+
// A comma-separated list of fields to order by, sorted in ascending order.
|
287
|
+
// Use "desc" after a field name for descending.
|
288
|
+
// Supported fields:
|
289
|
+
// * `update_time`
|
290
|
+
// * `create_time`
|
291
|
+
// * `conversation_name`
|
292
|
+
//
|
293
|
+
// Example:
|
294
|
+
// "update_time desc"
|
295
|
+
// "create_time"
|
296
|
+
string order_by = 5;
|
297
|
+
}
|
298
|
+
|
299
|
+
// Response for ListConversations method.
|
300
|
+
message ListConversationsResponse {
|
301
|
+
// All the Conversations for a given data store.
|
302
|
+
repeated Conversation conversations = 1;
|
303
|
+
|
304
|
+
// Pagination token, if not returned indicates the last page.
|
305
|
+
string next_page_token = 2;
|
306
|
+
}
|
@@ -0,0 +1,121 @@
|
|
1
|
+
// Copyright 2022 Google LLC
|
2
|
+
//
|
3
|
+
// Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
// you may not use this file except in compliance with the License.
|
5
|
+
// You may obtain a copy of the License at
|
6
|
+
//
|
7
|
+
// http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
//
|
9
|
+
// Unless required by applicable law or agreed to in writing, software
|
10
|
+
// distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
// See the License for the specific language governing permissions and
|
13
|
+
// limitations under the License.
|
14
|
+
|
15
|
+
syntax = "proto3";
|
16
|
+
|
17
|
+
package google.cloud.discoveryengine.v1alpha;
|
18
|
+
|
19
|
+
import "google/api/field_behavior.proto";
|
20
|
+
import "google/api/resource.proto";
|
21
|
+
import "google/protobuf/struct.proto";
|
22
|
+
|
23
|
+
option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Alpha";
|
24
|
+
option go_package = "cloud.google.com/go/discoveryengine/apiv1alpha/discoveryenginepb;discoveryenginepb";
|
25
|
+
option java_multiple_files = true;
|
26
|
+
option java_outer_classname = "DocumentProto";
|
27
|
+
option java_package = "com.google.cloud.discoveryengine.v1alpha";
|
28
|
+
option objc_class_prefix = "DISCOVERYENGINE";
|
29
|
+
option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1alpha";
|
30
|
+
option ruby_package = "Google::Cloud::DiscoveryEngine::V1alpha";
|
31
|
+
|
32
|
+
// Document captures all raw metadata information of items to be recommended or
|
33
|
+
// searched.
|
34
|
+
message Document {
|
35
|
+
option (google.api.resource) = {
|
36
|
+
type: "discoveryengine.googleapis.com/Document"
|
37
|
+
pattern: "projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}"
|
38
|
+
pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}"
|
39
|
+
};
|
40
|
+
|
41
|
+
// Unstructured data linked to this document.
|
42
|
+
message Content {
|
43
|
+
oneof content {
|
44
|
+
// The content represented as a stream of bytes. The maximum length is
|
45
|
+
// 1,000,000 bytes (1 MB / ~0.95 MiB).
|
46
|
+
//
|
47
|
+
// Note: As with all `bytes` fields, this field is represented as pure
|
48
|
+
// binary in Protocol Buffers and base64-encoded string in JSON. For
|
49
|
+
// example, `abc123!?$*&()'-=@~` should be represented as
|
50
|
+
// `YWJjMTIzIT8kKiYoKSctPUB+` in JSON. See
|
51
|
+
// https://developers.google.com/protocol-buffers/docs/proto3#json.
|
52
|
+
bytes raw_bytes = 2;
|
53
|
+
|
54
|
+
// The URI of the content. Only Cloud Storage URIs (e.g.
|
55
|
+
// `gs://bucket-name/path/to/file`) are supported. The maximum file size
|
56
|
+
// is 100 MB.
|
57
|
+
string uri = 3;
|
58
|
+
}
|
59
|
+
|
60
|
+
// The MIME type of the content. Supported types:
|
61
|
+
//
|
62
|
+
// * `application/pdf` (PDF, only native PDFs are supported for now)
|
63
|
+
// * `text/html` (HTML)
|
64
|
+
// * `application/vnd.openxmlformats-officedocument.wordprocessingml.document` (DOCX)
|
65
|
+
// * `application/vnd.openxmlformats-officedocument.presentationml.presentation` (PPTX)
|
66
|
+
// * `text/plain` (TXT)
|
67
|
+
//
|
68
|
+
// See https://www.iana.org/assignments/media-types/media-types.xhtml.
|
69
|
+
string mime_type = 1;
|
70
|
+
}
|
71
|
+
|
72
|
+
// Data representation. One of
|
73
|
+
// [struct_data][google.cloud.discoveryengine.v1alpha.Document.struct_data] or
|
74
|
+
// [json_data][google.cloud.discoveryengine.v1alpha.Document.json_data] should
|
75
|
+
// be provided otherwise an `INVALID_ARGUMENT` error is thrown.
|
76
|
+
oneof data {
|
77
|
+
// The structured JSON data for the document. It should conform to the
|
78
|
+
// registered [Schema][google.cloud.discoveryengine.v1alpha.Schema] or an
|
79
|
+
// `INVALID_ARGUMENT` error is thrown.
|
80
|
+
google.protobuf.Struct struct_data = 4;
|
81
|
+
|
82
|
+
// The JSON string representation of the document. It should conform to the
|
83
|
+
// registered [Schema][google.cloud.discoveryengine.v1alpha.Schema] or an
|
84
|
+
// `INVALID_ARGUMENT` error is thrown.
|
85
|
+
string json_data = 5;
|
86
|
+
}
|
87
|
+
|
88
|
+
// Immutable. The full resource name of the document.
|
89
|
+
// Format:
|
90
|
+
// `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document_id}`.
|
91
|
+
//
|
92
|
+
// This field must be a UTF-8 encoded string with a length limit of 1024
|
93
|
+
// characters.
|
94
|
+
string name = 1 [(google.api.field_behavior) = IMMUTABLE];
|
95
|
+
|
96
|
+
// Immutable. The identifier of the document.
|
97
|
+
//
|
98
|
+
// Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
|
99
|
+
// standard with a length limit of 63 characters.
|
100
|
+
string id = 2 [(google.api.field_behavior) = IMMUTABLE];
|
101
|
+
|
102
|
+
// The identifier of the schema located in the same data store.
|
103
|
+
string schema_id = 3;
|
104
|
+
|
105
|
+
// The unstructured data linked to this document. Content must be set if this
|
106
|
+
// document is under a
|
107
|
+
// `CONTENT_REQUIRED` data store.
|
108
|
+
Content content = 10;
|
109
|
+
|
110
|
+
// The identifier of the parent document. Currently supports at most two level
|
111
|
+
// document hierarchy.
|
112
|
+
//
|
113
|
+
// Id should conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
|
114
|
+
// standard with a length limit of 63 characters.
|
115
|
+
string parent_document_id = 7;
|
116
|
+
|
117
|
+
// Output only. This field is OUTPUT_ONLY.
|
118
|
+
// It contains derived data that are not in the original input document.
|
119
|
+
google.protobuf.Struct derived_struct_data = 6
|
120
|
+
[(google.api.field_behavior) = OUTPUT_ONLY];
|
121
|
+
}
|