@google-cloud/discoveryengine 0.8.0 → 1.1.0
Sign up to get free protection for your applications and to get access to all the features.
- package/CHANGELOG.md +30 -0
- package/README.md +13 -1
- package/build/protos/google/cloud/discoveryengine/v1/common.proto +30 -2
- package/build/protos/google/cloud/discoveryengine/v1/completion_service.proto +15 -2
- package/build/protos/google/cloud/discoveryengine/v1/conversation.proto +114 -0
- package/build/protos/google/cloud/discoveryengine/v1/conversational_search_service.proto +303 -0
- package/build/protos/google/cloud/discoveryengine/v1/document.proto +8 -5
- package/build/protos/google/cloud/discoveryengine/v1/document_service.proto +4 -3
- package/build/protos/google/cloud/discoveryengine/v1/import_config.proto +27 -23
- package/build/protos/google/cloud/discoveryengine/v1/schema.proto +1 -1
- package/build/protos/google/cloud/discoveryengine/v1/search_service.proto +428 -20
- package/build/protos/google/cloud/discoveryengine/v1/user_event.proto +48 -39
- package/build/protos/google/cloud/discoveryengine/v1/user_event_service.proto +2 -2
- package/build/protos/google/cloud/discoveryengine/v1beta/common.proto +7 -2
- package/build/protos/google/cloud/discoveryengine/v1beta/completion_service.proto +13 -2
- package/build/protos/google/cloud/discoveryengine/v1beta/conversation.proto +138 -0
- package/build/protos/google/cloud/discoveryengine/v1beta/conversational_search_service.proto +306 -0
- package/build/protos/google/cloud/discoveryengine/v1beta/document.proto +2 -4
- package/build/protos/google/cloud/discoveryengine/v1beta/document_service.proto +2 -1
- package/build/protos/google/cloud/discoveryengine/v1beta/import_config.proto +17 -17
- package/build/protos/google/cloud/discoveryengine/v1beta/schema.proto +1 -1
- package/build/protos/google/cloud/discoveryengine/v1beta/search_service.proto +276 -64
- package/build/protos/google/cloud/discoveryengine/v1beta/user_event.proto +45 -36
- package/build/protos/google/cloud/discoveryengine/v1beta/user_event_service.proto +2 -2
- package/build/protos/protos.d.ts +13913 -8367
- package/build/protos/protos.js +36766 -22883
- package/build/protos/protos.json +3956 -2571
- package/build/src/index.d.ts +4 -1
- package/build/src/index.js +4 -1
- package/build/src/v1/completion_service_client.d.ts +161 -12
- package/build/src/v1/completion_service_client.js +188 -4
- package/build/src/v1/conversational_search_service_client.d.ts +947 -0
- package/build/src/v1/conversational_search_service_client.js +1205 -0
- package/build/src/v1/conversational_search_service_client_config.json +68 -0
- package/build/src/v1/document_service_client.d.ts +245 -109
- package/build/src/v1/document_service_client.js +231 -31
- package/build/src/v1/index.d.ts +1 -0
- package/build/src/v1/index.js +3 -1
- package/build/src/v1/schema_service_client.d.ts +187 -53
- package/build/src/v1/schema_service_client.js +224 -27
- package/build/src/v1/search_service_client.d.ts +266 -59
- package/build/src/v1/search_service_client.js +267 -41
- package/build/src/v1/user_event_service_client.d.ts +159 -19
- package/build/src/v1/user_event_service_client.js +208 -7
- package/build/src/v1beta/completion_service_client.d.ts +159 -12
- package/build/src/v1beta/completion_service_client.js +188 -4
- package/build/src/v1beta/conversational_search_service_client.d.ts +947 -0
- package/build/src/v1beta/conversational_search_service_client.js +1205 -0
- package/build/src/v1beta/conversational_search_service_client_config.json +68 -0
- package/build/src/v1beta/document_service_client.d.ts +237 -101
- package/build/src/v1beta/document_service_client.js +227 -27
- package/build/src/v1beta/index.d.ts +1 -0
- package/build/src/v1beta/index.js +3 -1
- package/build/src/v1beta/recommendation_service_client.d.ts +158 -15
- package/build/src/v1beta/recommendation_service_client.js +188 -4
- package/build/src/v1beta/schema_service_client.d.ts +187 -53
- package/build/src/v1beta/schema_service_client.js +224 -27
- package/build/src/v1beta/search_service_client.d.ts +305 -71
- package/build/src/v1beta/search_service_client.js +293 -49
- package/build/src/v1beta/user_event_service_client.d.ts +156 -16
- package/build/src/v1beta/user_event_service_client.js +208 -7
- package/package.json +10 -13
@@ -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.v1beta;
|
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/v1beta/conversation.proto";
|
24
|
+
import "google/cloud/discoveryengine/v1beta/search_service.proto";
|
25
|
+
import "google/protobuf/empty.proto";
|
26
|
+
import "google/protobuf/field_mask.proto";
|
27
|
+
|
28
|
+
option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
|
29
|
+
option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
|
30
|
+
option java_multiple_files = true;
|
31
|
+
option java_outer_classname = "ConversationalSearchServiceProto";
|
32
|
+
option java_package = "com.google.cloud.discoveryengine.v1beta";
|
33
|
+
option objc_class_prefix = "DISCOVERYENGINE";
|
34
|
+
option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1beta";
|
35
|
+
option ruby_package = "Google::Cloud::DiscoveryEngine::V1beta";
|
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: "/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}:converse"
|
48
|
+
body: "*"
|
49
|
+
additional_bindings {
|
50
|
+
post: "/v1beta/{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.v1beta.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: "/v1beta/{parent=projects/*/locations/*/dataStores/*}/conversations"
|
64
|
+
body: "conversation"
|
65
|
+
additional_bindings {
|
66
|
+
post: "/v1beta/{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.v1beta.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: "/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}"
|
81
|
+
additional_bindings {
|
82
|
+
delete: "/v1beta/{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.v1beta.Conversation] action
|
91
|
+
// type cannot be changed. If the
|
92
|
+
// [Conversation][google.cloud.discoveryengine.v1beta.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: "/v1beta/{conversation.name=projects/*/locations/*/dataStores/*/conversations/*}"
|
97
|
+
body: "conversation"
|
98
|
+
additional_bindings {
|
99
|
+
patch: "/v1beta/{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: "/v1beta/{name=projects/*/locations/*/dataStores/*/conversations/*}"
|
110
|
+
additional_bindings {
|
111
|
+
get: "/v1beta/{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.v1beta.DataStore].
|
119
|
+
rpc ListConversations(ListConversationsRequest)
|
120
|
+
returns (ListConversationsResponse) {
|
121
|
+
option (google.api.http) = {
|
122
|
+
get: "/v1beta/{parent=projects/*/locations/*/dataStores/*}/conversations"
|
123
|
+
additional_bindings {
|
124
|
+
get: "/v1beta/{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.v1beta.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.v1beta.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.v1beta.Conversation] to update.
|
228
|
+
// 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
|
+
}
|
@@ -75,14 +75,12 @@ message Document {
|
|
75
75
|
// be provided otherwise an `INVALID_ARGUMENT` error is thrown.
|
76
76
|
oneof data {
|
77
77
|
// The structured JSON data for the document. It should conform to the
|
78
|
-
// registered
|
79
|
-
// [Schema.schema][google.cloud.discoveryengine.v1beta.Schema.schema] or an
|
78
|
+
// registered [Schema][google.cloud.discoveryengine.v1beta.Schema] or an
|
80
79
|
// `INVALID_ARGUMENT` error is thrown.
|
81
80
|
google.protobuf.Struct struct_data = 4;
|
82
81
|
|
83
82
|
// The JSON string representation of the document. It should conform to the
|
84
|
-
// registered
|
85
|
-
// [Schema.schema][google.cloud.discoveryengine.v1beta.Schema.schema] or an
|
83
|
+
// registered [Schema][google.cloud.discoveryengine.v1beta.Schema] or an
|
86
84
|
// `INVALID_ARGUMENT` error is thrown.
|
87
85
|
string json_data = 5;
|
88
86
|
}
|
@@ -189,7 +189,8 @@ message ListDocumentsRequest {
|
|
189
189
|
// Use `default_branch` as the branch ID, to list documents under the default
|
190
190
|
// branch.
|
191
191
|
//
|
192
|
-
// If the caller does not have permission to list
|
192
|
+
// If the caller does not have permission to list
|
193
|
+
// [Document][google.cloud.discoveryengine.v1beta.Document]s under this
|
193
194
|
// branch, regardless of whether or not this branch exists, a
|
194
195
|
// `PERMISSION_DENIED` error is returned.
|
195
196
|
string parent = 1 [
|
@@ -55,15 +55,15 @@ message GcsSource {
|
|
55
55
|
// have a valid
|
56
56
|
// [Document.id][google.cloud.discoveryengine.v1beta.Document.id].
|
57
57
|
// * `content`: Unstructured data (e.g. PDF, HTML). Each file matched by
|
58
|
-
// `input_uris`
|
58
|
+
// `input_uris` becomes a document, with the ID set to the first 128
|
59
59
|
// bits of SHA256(URI) encoded as a hex string.
|
60
60
|
// * `custom`: One custom data JSON per row in arbitrary format that conforms
|
61
|
-
// the defined [Schema][google.cloud.discoveryengine.v1beta.Schema] of
|
62
|
-
// data store. This can only be used by
|
63
|
-
// * `csv`: A CSV file with header conforming the defined
|
61
|
+
// to the defined [Schema][google.cloud.discoveryengine.v1beta.Schema] of
|
62
|
+
// the data store. This can only be used by Gen App Builder.
|
63
|
+
// * `csv`: A CSV file with header conforming to the defined
|
64
64
|
// [Schema][google.cloud.discoveryengine.v1beta.Schema] of the
|
65
|
-
// data store. Each entry after the header
|
66
|
-
// This can only be used by
|
65
|
+
// data store. Each entry after the header is imported as a Document.
|
66
|
+
// This can only be used by Gen App Builder.
|
67
67
|
//
|
68
68
|
// Supported values for user even imports:
|
69
69
|
//
|
@@ -115,9 +115,9 @@ message BigQuerySource {
|
|
115
115
|
// [Document.json_data][google.cloud.discoveryengine.v1beta.Document.json_data]
|
116
116
|
// or
|
117
117
|
// [Document.struct_data][google.cloud.discoveryengine.v1beta.Document.struct_data].
|
118
|
-
// * `custom`: One custom data per row in arbitrary format that conforms
|
119
|
-
// defined [Schema][google.cloud.discoveryengine.v1beta.Schema] of the
|
120
|
-
// store. This can only be used by
|
118
|
+
// * `custom`: One custom data per row in arbitrary format that conforms to
|
119
|
+
// the defined [Schema][google.cloud.discoveryengine.v1beta.Schema] of the
|
120
|
+
// data store. This can only be used by Gen App Builder.
|
121
121
|
string data_schema = 6;
|
122
122
|
}
|
123
123
|
|
@@ -126,7 +126,7 @@ message ImportErrorConfig {
|
|
126
126
|
// Required. Errors destination.
|
127
127
|
oneof destination {
|
128
128
|
// Cloud Storage prefix for import errors. This must be an empty,
|
129
|
-
// existing Cloud Storage directory. Import errors
|
129
|
+
// existing Cloud Storage directory. Import errors are written to
|
130
130
|
// sharded files in this directory, one per line, as a JSON-encoded
|
131
131
|
// `google.rpc.Status` message.
|
132
132
|
string gcs_prefix = 1;
|
@@ -186,7 +186,7 @@ message ImportUserEventsResponse {
|
|
186
186
|
int64 unjoined_events_count = 4;
|
187
187
|
}
|
188
188
|
|
189
|
-
// Metadata related to the progress of the Import operation. This
|
189
|
+
// Metadata related to the progress of the Import operation. This is
|
190
190
|
// returned by the google.longrunning.Operation.metadata field.
|
191
191
|
message ImportUserEventsMetadata {
|
192
192
|
// Operation create time.
|
@@ -203,8 +203,8 @@ message ImportUserEventsMetadata {
|
|
203
203
|
int64 failure_count = 4;
|
204
204
|
}
|
205
205
|
|
206
|
-
// Metadata related to the progress of the ImportDocuments operation. This
|
207
|
-
//
|
206
|
+
// Metadata related to the progress of the ImportDocuments operation. This is
|
207
|
+
// returned by the google.longrunning.Operation.metadata field.
|
208
208
|
message ImportDocumentsMetadata {
|
209
209
|
// Operation create time.
|
210
210
|
google.protobuf.Timestamp create_time = 1;
|
@@ -233,7 +233,7 @@ message ImportDocumentsRequest {
|
|
233
233
|
// Indicates how imported documents are reconciled with the existing documents
|
234
234
|
// created or imported before.
|
235
235
|
enum ReconciliationMode {
|
236
|
-
// Defaults to INCREMENTAL
|
236
|
+
// Defaults to `INCREMENTAL`.
|
237
237
|
RECONCILIATION_MODE_UNSPECIFIED = 0;
|
238
238
|
|
239
239
|
// Inserts new documents or updates existing documents.
|
@@ -285,7 +285,7 @@ message ImportDocumentsRequest {
|
|
285
285
|
// `false`, [Document.id][google.cloud.discoveryengine.v1beta.Document.id]s
|
286
286
|
// have to be specified using
|
287
287
|
// [id_field][google.cloud.discoveryengine.v1beta.ImportDocumentsRequest.id_field],
|
288
|
-
//
|
288
|
+
// otherwise, documents without IDs fail to be imported.
|
289
289
|
//
|
290
290
|
// Only set this field when using
|
291
291
|
// [GcsSource][google.cloud.discoveryengine.v1beta.GcsSource] or
|
@@ -306,12 +306,12 @@ message ImportDocumentsRequest {
|
|
306
306
|
// [BigQuerySource][google.cloud.discoveryengine.v1beta.BigQuerySource] it is
|
307
307
|
// the column name of the BigQuery table where the unique ids are stored.
|
308
308
|
//
|
309
|
-
// The values of the JSON field or the BigQuery column
|
309
|
+
// The values of the JSON field or the BigQuery column are used as the
|
310
310
|
// [Document.id][google.cloud.discoveryengine.v1beta.Document.id]s. The JSON
|
311
311
|
// field or the BigQuery column must be of string type, and the values must be
|
312
312
|
// set as valid strings conform to
|
313
313
|
// [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters.
|
314
|
-
// Otherwise, documents without valid IDs
|
314
|
+
// Otherwise, documents without valid IDs fail to be imported.
|
315
315
|
//
|
316
316
|
// Only set this field when using
|
317
317
|
// [GcsSource][google.cloud.discoveryengine.v1beta.GcsSource] or
|
@@ -40,7 +40,7 @@ message Schema {
|
|
40
40
|
// Schema representation. One of
|
41
41
|
// [struct_schema][google.cloud.discoveryengine.v1beta.Schema.struct_schema]
|
42
42
|
// or [json_schema][google.cloud.discoveryengine.v1beta.Schema.json_schema]
|
43
|
-
// should be provided otherwise an INVALID_ARGUMENT error is thrown.
|
43
|
+
// should be provided otherwise an `INVALID_ARGUMENT` error is thrown.
|
44
44
|
oneof schema {
|
45
45
|
// The structured representation of the schema.
|
46
46
|
google.protobuf.Struct struct_schema = 2;
|