[monorail go api] add IssuesList rpc

go/src/infra/monorail/monorail.proto

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // This file *partially* describes Monorail API.
 // It is derived from
 // https://chromium.googlesource.com/infra/infra/+/f2e2a4d/appengine/monorail/services/api_svc_v1.py
 // and
 // https://chromium.googlesource.com/infra/infra/+/f2e2a4d/appengine/monorail/proto/api_pb2_v1.py
 
 syntax = "proto3";
 
 package monorail;
 
 // Monorail service can manipulate issues.
 service Monorail {
     // Creates an issue.
     rpc InsertIssue(InsertIssueRequest) returns (InsertIssueResponse){};
     // Posts a comment to an issue. Can update issue attributes, such as status.
     rpc InsertComment(InsertCommentRequest) returns (InsertCommentResponse){};
+    // Lists issues from a project.
+    rpc IssuesList(IssuesListRequest) returns (IssuesListResponse){};
 }
 
 // A monorail issue.
 message Issue {
     // Reporter of the issue.
     AtomPerson author = 1;
     // Issues that must be fixed before this one can be fixed.
     repeated IssueRef blockedOn = 2;
     // People participating in the issue discussion.
     repeated AtomPerson cc = 6;
@@ skipping 62 matching lines @@
         Update updates = 8;
     }
     // Definition of the comment.
     Comment comment = 1;
     // The reference to post the comment to.
     IssueRef issue = 2;
 }
 
 message InsertCommentResponse{}
 
+// Request for a list of Issues.
+message IssuesListRequest {
+  // String name of the project, e.g. "chromium".
+  string projectId = 1;
+  // Additional projects to search.
+  repeated string additionalProject = 2;
+  enum CannedQuery {
+    ALL = 0;
+    NEW = 1;
+    OPEN = 2;
+    OWNED = 3;
+    REPORTED = 4;
+    STARRED = 5;
+    TO_VERIFY = 6;
+  }
+  // Use a canned query.
+  CannedQuery can = 3;
+  // Issue label or space separated list of labels.
+  string label = 4;
+  // Maximum results to retrieve.
+  int32 maxResults = 5;
+  // Issue owner.
+  string owner = 6;
+  // Search for Issues published before this timestamp.
+  int64 publishedMax = 7;
+  // Search for Issues published after this timestamp.
+  int64 publishedMin = 8;
+  // Free-form text query.
+  string q = 9;
+  // Sort-by field or fields, concatenated with leading + or - to indicate

[nodir, 2016/06/09 16:31:00]

it should have mentioned that the list is space-separated

+  // direction.
+  string sort = 10;
+  // Starting index for pagination.
+  int32 startIndex = 11;
+  // Issue status.
+  string status = 12;
+  // Search for Issues most recently updated before this timestamp.
+  int64 updatedMax = 13;
+  // Search for Issues most recently updated after this timestamp.
+  int64 updatedMin = 14;
+}
+
+message ErrorMessage {
+  int32 code = 1;
+  string reason = 2;
+  string message = 3;
+}
+
+message IssuesListResponse {
+  ErrorMessage error = 1;
+  // Search results.
+  repeated Issue items = 2;
+  // Total size of matching result set, regardless of how many are included
+  // in this response.
+  int32 totalResults = 3;
+}
+
 // Defines a mutation to an issue.
 // This message is partial.
 // Derived from Update type in api_pb2_v1.py.
 message Update {
     // If set, the new status of the issue.
     string status = 2;
 }
 
 // Identifies a Monorail user.
 message AtomPerson {
     // User email.
     string name = 1;
 }