Skip to content

Commit 5da78db

Browse files
Google APIscopybara-github
Google APIs
authored and
copybara-github
committed
fix!: Remove resource_reference from UpdateAnswerRecord.
Committer: @sheimi PiperOrigin-RevId: 363947872
1 parent c80d148 commit 5da78db

2 files changed

Lines changed: 62 additions & 45 deletions

File tree

‎google/cloud/dialogflow/v2/answer_record.proto‎

Lines changed: 31 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,8 @@ option java_outer_classname = "AnswerRecordsProto";
3333
option java_package = "com.google.cloud.dialogflow.v2";
3434
option objc_class_prefix = "DF";
3535

36-
// Service for managing [AnswerRecords][google.cloud.dialogflow.v2.AnswerRecord].
36+
// Service for managing
37+
// [AnswerRecords][google.cloud.dialogflow.v2.AnswerRecord].
3738
service AnswerRecords {
3839
option (google.api.default_host) = "dialogflow.googleapis.com";
3940
option (google.api.oauth_scopes) =
@@ -42,7 +43,8 @@ service AnswerRecords {
4243

4344
// Returns the list of all answer records in the specified project in reverse
4445
// chronological order.
45-
rpc ListAnswerRecords(ListAnswerRecordsRequest) returns (ListAnswerRecordsResponse) {
46+
rpc ListAnswerRecords(ListAnswerRecordsRequest)
47+
returns (ListAnswerRecordsResponse) {
4648
option (google.api.http) = {
4749
get: "/v2/{parent=projects/*}/answerRecords"
4850
additional_bindings {
@@ -87,9 +89,11 @@ service AnswerRecords {
8789
// A typical workflow for customers provide feedback to an answer is:
8890
//
8991
// 1. For human agent assistant, customers get suggestion via ListSuggestions
90-
// API. Together with the answers, [AnswerRecord.name][google.cloud.dialogflow.v2.AnswerRecord.name] are returned to the
91-
// customers.
92-
// 2. The customer uses the [AnswerRecord.name][google.cloud.dialogflow.v2.AnswerRecord.name] to call the
92+
// API. Together with the answers,
93+
// [AnswerRecord.name][google.cloud.dialogflow.v2.AnswerRecord.name] are
94+
// returned to the customers.
95+
// 2. The customer uses the
96+
// [AnswerRecord.name][google.cloud.dialogflow.v2.AnswerRecord.name] to call the
9397
// [UpdateAnswerRecord][] method to send feedback about a specific answer
9498
// that they believe is wrong.
9599
message AnswerRecord {
@@ -105,18 +109,20 @@ message AnswerRecord {
105109
string name = 1;
106110

107111
// Required. The AnswerFeedback for this record. You can set this with
108-
// [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2.AnswerRecords.UpdateAnswerRecord] in order to give us feedback about
109-
// this answer.
112+
// [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2.AnswerRecords.UpdateAnswerRecord]
113+
// in order to give us feedback about this answer.
110114
AnswerFeedback answer_feedback = 2 [(google.api.field_behavior) = REQUIRED];
111115

112116
// The record for this answer.
113117
oneof record {
114118
// Output only. The record for human agent assistant.
115-
AgentAssistantRecord agent_assistant_record = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
119+
AgentAssistantRecord agent_assistant_record = 4
120+
[(google.api.field_behavior) = OUTPUT_ONLY];
116121
}
117122
}
118123

119-
// Request message for [AnswerRecords.ListAnswerRecords][google.cloud.dialogflow.v2.AnswerRecords.ListAnswerRecords].
124+
// Request message for
125+
// [AnswerRecords.ListAnswerRecords][google.cloud.dialogflow.v2.AnswerRecords.ListAnswerRecords].
120126
message ListAnswerRecordsRequest {
121127
// Required. The project to list all answer records for in reverse
122128
// chronological order. Format: `projects/<Project ID>/locations/<Location
@@ -148,7 +154,8 @@ message ListAnswerRecordsRequest {
148154
string page_token = 4 [(google.api.field_behavior) = OPTIONAL];
149155
}
150156

151-
// Response message for [AnswerRecords.ListAnswerRecords][google.cloud.dialogflow.v2.AnswerRecords.ListAnswerRecords].
157+
// Response message for
158+
// [AnswerRecords.ListAnswerRecords][google.cloud.dialogflow.v2.AnswerRecords.ListAnswerRecords].
152159
message ListAnswerRecordsResponse {
153160
// The list of answer records.
154161
repeated AnswerRecord answer_records = 1;
@@ -162,18 +169,15 @@ message ListAnswerRecordsResponse {
162169
string next_page_token = 2;
163170
}
164171

165-
// Request message for [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2.AnswerRecords.UpdateAnswerRecord].
172+
// Request message for
173+
// [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2.AnswerRecords.UpdateAnswerRecord].
166174
message UpdateAnswerRecordRequest {
167175
// Required. Answer record to update.
168-
AnswerRecord answer_record = 1 [
169-
(google.api.field_behavior) = REQUIRED,
170-
(google.api.resource_reference) = {
171-
type: "dialogflow.googleapis.com/AnswerRecord"
172-
}
173-
];
176+
AnswerRecord answer_record = 1 [(google.api.field_behavior) = REQUIRED];
174177

175178
// Required. The mask to control which fields get updated.
176-
google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
179+
google.protobuf.FieldMask update_mask = 2
180+
[(google.api.field_behavior) = REQUIRED];
177181
}
178182

179183
// Represents feedback the customer has about the quality & correctness of a
@@ -275,21 +279,26 @@ message AgentAssistantFeedback {
275279
// days of the purchase date."
276280
// * Ground truth: "No return or exchange is allowed."
277281
// * [document_correctness]: INCORRECT
278-
DocumentCorrectness document_correctness = 2 [(google.api.field_behavior) = OPTIONAL];
282+
DocumentCorrectness document_correctness = 2
283+
[(google.api.field_behavior) = OPTIONAL];
279284

280285
// Optional. Whether or not the suggested document is efficient. For example,
281286
// if the document is poorly written, hard to understand, hard to use or
282-
// too long to find useful information, [document_efficiency][google.cloud.dialogflow.v2.AgentAssistantFeedback.document_efficiency] is
287+
// too long to find useful information,
288+
// [document_efficiency][google.cloud.dialogflow.v2.AgentAssistantFeedback.document_efficiency]
289+
// is
283290
// [DocumentEfficiency.INEFFICIENT][google.cloud.dialogflow.v2.AgentAssistantFeedback.DocumentEfficiency.INEFFICIENT].
284-
DocumentEfficiency document_efficiency = 3 [(google.api.field_behavior) = OPTIONAL];
291+
DocumentEfficiency document_efficiency = 3
292+
[(google.api.field_behavior) = OPTIONAL];
285293
}
286294

287295
// Represents a record of a human agent assist answer.
288296
message AgentAssistantRecord {
289297
// Output only. The agent assist answer.
290298
oneof answer {
291299
// Output only. The article suggestion answer.
292-
ArticleAnswer article_suggestion_answer = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
300+
ArticleAnswer article_suggestion_answer = 5
301+
[(google.api.field_behavior) = OUTPUT_ONLY];
293302

294303
// Output only. The FAQ answer.
295304
FaqAnswer faq_answer = 6 [(google.api.field_behavior) = OUTPUT_ONLY];

‎google/cloud/dialogflow/v2beta1/answer_record.proto‎

Lines changed: 31 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,8 @@ option java_outer_classname = "AnswerRecordsProto";
3333
option java_package = "com.google.cloud.dialogflow.v2beta1";
3434
option objc_class_prefix = "DF";
3535

36-
// Service for managing [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
36+
// Service for managing
37+
// [AnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecord].
3738
service AnswerRecords {
3839
option (google.api.default_host) = "dialogflow.googleapis.com";
3940
option (google.api.oauth_scopes) =
@@ -54,7 +55,8 @@ service AnswerRecords {
5455

5556
// Returns the list of all answer records in the specified project in reverse
5657
// chronological order.
57-
rpc ListAnswerRecords(ListAnswerRecordsRequest) returns (ListAnswerRecordsResponse) {
58+
rpc ListAnswerRecords(ListAnswerRecordsRequest)
59+
returns (ListAnswerRecordsResponse) {
5860
option (google.api.http) = {
5961
get: "/v2beta1/{parent=projects/*}/answerRecords"
6062
additional_bindings {
@@ -99,9 +101,12 @@ service AnswerRecords {
99101
// A typical workflow for customers provide feedback to an answer is:
100102
//
101103
// 1. For human agent assistant, customers get suggestion via ListSuggestions
102-
// API. Together with the answers, [AnswerRecord.name][google.cloud.dialogflow.v2beta1.AnswerRecord.name] are returned to the
103-
// customers.
104-
// 2. The customer uses the [AnswerRecord.name][google.cloud.dialogflow.v2beta1.AnswerRecord.name] to call the
104+
// API. Together with the answers,
105+
// [AnswerRecord.name][google.cloud.dialogflow.v2beta1.AnswerRecord.name] are
106+
// returned to the customers.
107+
// 2. The customer uses the
108+
// [AnswerRecord.name][google.cloud.dialogflow.v2beta1.AnswerRecord.name] to
109+
// call the
105110
// [UpdateAnswerRecord][] method to send feedback about a specific answer
106111
// that they believe is wrong.
107112
message AnswerRecord {
@@ -112,14 +117,15 @@ message AnswerRecord {
112117
};
113118

114119
// The unique identifier of this answer record.
115-
// Required for [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2beta1.AnswerRecords.UpdateAnswerRecord] method.
116-
// Format: `projects/<Project ID>/locations/<Location
120+
// Required for
121+
// [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2beta1.AnswerRecords.UpdateAnswerRecord]
122+
// method. Format: `projects/<Project ID>/locations/<Location
117123
// ID>/answerRecords/<Answer Record ID>`.
118124
string name = 1;
119125

120126
// Optional. The AnswerFeedback for this record. You can set this with
121-
// [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2beta1.AnswerRecords.UpdateAnswerRecord] in order to give us feedback about
122-
// this answer.
127+
// [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2beta1.AnswerRecords.UpdateAnswerRecord]
128+
// in order to give us feedback about this answer.
123129
AnswerFeedback answer_feedback = 3;
124130

125131
// Output only. The record for this answer.
@@ -134,7 +140,8 @@ message AgentAssistantRecord {
134140
// Output only. The agent assistant answer.
135141
oneof answer {
136142
// Output only. The article suggestion answer.
137-
ArticleAnswer article_suggestion_answer = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
143+
ArticleAnswer article_suggestion_answer = 5
144+
[(google.api.field_behavior) = OUTPUT_ONLY];
138145

139146
// Output only. The FAQ answer.
140147
FaqAnswer faq_answer = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
@@ -256,30 +263,34 @@ message AgentAssistantFeedback {
256263

257264
// Optional. Whether or not the suggested document is efficient. For example,
258265
// if the document is poorly written, hard to understand, hard to use or
259-
// too long to find useful information, [document_efficiency][google.cloud.dialogflow.v2beta1.AgentAssistantFeedback.document_efficiency] is
266+
// too long to find useful information,
267+
// [document_efficiency][google.cloud.dialogflow.v2beta1.AgentAssistantFeedback.document_efficiency]
268+
// is
260269
// [DocumentEfficiency.INEFFICIENT][google.cloud.dialogflow.v2beta1.AgentAssistantFeedback.DocumentEfficiency.INEFFICIENT].
261270
DocumentEfficiency document_efficiency = 3;
262271

263272
// Feedback for conversation summarization.
264273
SummarizationFeedback summarization_feedback = 4;
265274
}
266275

267-
// Request message for [AnswerRecords.GetAnswerRecord][google.cloud.dialogflow.v2beta1.AnswerRecords.GetAnswerRecord].
276+
// Request message for
277+
// [AnswerRecords.GetAnswerRecord][google.cloud.dialogflow.v2beta1.AnswerRecords.GetAnswerRecord].
268278
message GetAnswerRecordRequest {
269279
// Required. The name of the answer record to retrieve.
270280
// Format: `projects/<Project ID>/locations/<Location
271281
// ID>/answerRecords/<Answer Record Id>`.
272282
string name = 1;
273283
}
274284

275-
// Request message for [AnswerRecords.ListAnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecords.ListAnswerRecords].
285+
// Request message for
286+
// [AnswerRecords.ListAnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecords.ListAnswerRecords].
276287
message ListAnswerRecordsRequest {
277288
// Required. The project to list all answer records for in reverse
278289
// chronological order. Format: `projects/<Project ID>/locations/<Location
279290
// ID>`.
280291
string parent = 1 [(google.api.resource_reference) = {
281-
child_type: "dialogflow.googleapis.com/AnswerRecord"
282-
}];
292+
child_type: "dialogflow.googleapis.com/AnswerRecord"
293+
}];
283294

284295
// Optional. The maximum number of records to return in a single page.
285296
// The server may return fewer records than this. If unspecified, we use 10.
@@ -293,7 +304,8 @@ message ListAnswerRecordsRequest {
293304
string page_token = 4;
294305
}
295306

296-
// Response message for [AnswerRecords.ListAnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecords.ListAnswerRecords].
307+
// Response message for
308+
// [AnswerRecords.ListAnswerRecords][google.cloud.dialogflow.v2beta1.AnswerRecords.ListAnswerRecords].
297309
message ListAnswerRecordsResponse {
298310
// The list of answer records.
299311
repeated AnswerRecord answer_records = 1;
@@ -307,15 +319,11 @@ message ListAnswerRecordsResponse {
307319
string next_page_token = 2;
308320
}
309321

310-
// Request message for [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2beta1.AnswerRecords.UpdateAnswerRecord].
322+
// Request message for
323+
// [AnswerRecords.UpdateAnswerRecord][google.cloud.dialogflow.v2beta1.AnswerRecords.UpdateAnswerRecord].
311324
message UpdateAnswerRecordRequest {
312325
// Required. Answer record to update.
313-
AnswerRecord answer_record = 1 [
314-
(google.api.field_behavior) = REQUIRED,
315-
(google.api.resource_reference) = {
316-
type: "dialogflow.googleapis.com/AnswerRecord"
317-
}
318-
];
326+
AnswerRecord answer_record = 1 [(google.api.field_behavior) = REQUIRED];
319327

320328
// Required. The mask to control which fields get updated.
321329
google.protobuf.FieldMask update_mask = 2;

0 commit comments

Comments
 (0)