Lines Matching +full:api +full:- +full:name
7 // http://www.apache.org/licenses/LICENSE-2.0
20 import "google/api/annotations.proto";
21 import "google/api/client.proto";
22 import "google/api/field_behavior.proto";
23 import "google/api/resource.proto";
33 // This API represents a simple digital library. It lets you manage Shelf
37 // - The API has a collection of [Shelf][google.example.library.v1.Shelf]
40 // - Each Shelf has a collection of [Book][google.example.library.v1.Book]
43 option (google.api.default_host) = "library-example.googleapis.com";
47 option (google.api.http) = {
51 option (google.api.method_signature) = "shelf";
56 option (google.api.http) = {
57 get: "/v1/{name=shelves/*}"
59 option (google.api.method_signature) = "name";
65 option (google.api.http) = {
72 option (google.api.http) = {
73 delete: "/v1/{name=shelves/*}"
75 option (google.api.method_signature) = "name";
79 // `other_shelf_name` to shelf `name`, and deletes
84 // This call is a no-op if the specified shelves are the same.
86 option (google.api.http) = {
87 post: "/v1/{name=shelves/*}:merge"
90 option (google.api.method_signature) = "name,other_shelf";
95 option (google.api.http) = {
99 option (google.api.method_signature) = "parent,book";
104 option (google.api.http) = {
105 get: "/v1/{name=shelves/*/books/*}"
107 option (google.api.method_signature) = "name";
114 option (google.api.http) = {
117 option (google.api.method_signature) = "parent";
122 option (google.api.http) = {
123 delete: "/v1/{name=shelves/*/books/*}"
125 option (google.api.method_signature) = "name";
128 // Updates a book. Returns INVALID_ARGUMENT if the name of the book
129 // is non-empty and does not equal the existing name.
131 option (google.api.http) = {
132 patch: "/v1/{book.name=shelves/*/books/*}"
135 option (google.api.method_signature) = "book,update_mask";
141 option (google.api.http) = {
142 post: "/v1/{name=shelves/*/books/*}:move"
145 option (google.api.method_signature) = "name,other_shelf_name";
151 option (google.api.resource) = {
152 type: "library-example.googleapis.com/Book",
156 // The resource name of the book.
158 // The name is ignored when creating a book.
159 string name = 1;
161 // The name of the book author.
173 option (google.api.resource) = {
174 type: "library-example.googleapis.com/Shelf",
178 // The resource name of the shelf.
180 // The name is ignored when creating a shelf.
181 string name = 1;
190 Shelf shelf = 1 [(google.api.field_behavior) = REQUIRED];
195 // The name of the shelf to retrieve.
196 string name = 1 [ field
197 (google.api.field_behavior) = REQUIRED,
198 (google.api.resource_reference).type =
199 "library-example.googleapis.com/Shelf"
231 // The name of the shelf to delete.
232 string name = 1 [ field
233 (google.api.field_behavior) = REQUIRED,
234 (google.api.resource_reference).type =
235 "library-example.googleapis.com/Shelf"
240 // (name) in this merge.
242 // The name of the shelf we're adding books to.
243 string name = 1 [ field
244 (google.api.field_behavior) = REQUIRED,
245 (google.api.resource_reference).type =
246 "library-example.googleapis.com/Shelf"
249 // The name of the shelf we're removing books from and deleting.
251 (google.api.field_behavior) = REQUIRED,
252 (google.api.resource_reference).type =
253 "library-example.googleapis.com/Shelf"
259 // The name of the shelf in which the book is created.
261 (google.api.field_behavior) = REQUIRED,
262 (google.api.resource_reference).type =
263 "library-example.googleapis.com/Shelf"
267 Book book = 2 [(google.api.field_behavior) = REQUIRED];
272 // The name of the book to retrieve.
273 string name = 1 [ field
274 (google.api.field_behavior) = REQUIRED,
275 (google.api.resource_reference).type = "library-example.googleapis.com/Book"
281 // The name of the shelf whose books we'd like to list.
283 (google.api.field_behavior) = REQUIRED,
284 (google.api.resource_reference).type =
285 "library-example.googleapis.com/Shelf"
314 // The name of the book to update.
315 Book book = 1 [(google.api.field_behavior) = REQUIRED];
319 [(google.api.field_behavior) = REQUIRED];
324 // The name of the book to delete.
325 string name = 1 [ field
326 (google.api.field_behavior) = REQUIRED,
327 (google.api.resource_reference).type = "library-example.googleapis.com/Book"
331 // Describes what book to move (name) and what shelf we're moving it
334 // The name of the book to move.
335 string name = 1 [ field
336 (google.api.field_behavior) = REQUIRED,
337 (google.api.resource_reference).type = "library-example.googleapis.com/Book"
340 // The name of the destination shelf.
342 (google.api.field_behavior) = REQUIRED,
343 (google.api.resource_reference).type =
344 "library-example.googleapis.com/Shelf"