feat(field_info): use aep.api.field_info

With new aep.api.field_info annotations, we should
use those rather than google.api.resource_reference
and google.api.field_behavior.

Author: toumorokoshi

aep/general/0122/aep.md.j2

@@ -214,19 +214,16 @@ When defining a method that retrieves or acts on an already-existing resource
 (such as `GetBook` or `ArchiveBook`), the first field of the request message
 **should** be the resource path, which **must** be of type `string` and
 **must** be called `path` for the resource path. The field **should** also be
-annotated with the `google.api.resource_reference` annotation, referencing the
-resource type (AEP-4).
+annotated with `api.api.field_info`, referencing the resource type (AEP-4).
 
 ```proto
 // Request message for ArchiveBook
 message ArchiveBookRequest {
 // The book to archive.
 // Format: publishers/{publisher_id}/books/{book_id}
 string path = 1 [
-  (google.api.field_behavior) = REQUIRED,
-  (google.api.resource_reference) = {
-    type: "apis.example.com/library/Book"
-  }];
+  (aep.api.field_info) = { resource_reference: [ "apis.example.com/library/Book" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }
+];
 
 // Other fields...
 }
@@ -242,25 +239,23 @@ When defining a method that retrieves resources from a collection or adds a new
 resource to a collection (such as `ListBooks` or `CreateBook`), the first field
 of the request message **should** be of type `string` and **should** be called
 `parent` for the resource path of the collection. The `parent` field **should**
-also be annotated with the `google.api.resource_reference` annotation,
-referencing the parent's resource type (AEP-4).
+also be annotated with `api.api.field_info`, referencing the parent's resource
+type (AEP-4).
 
 ```proto
 // Request message for ListBooks.
 message ListBooksRequest {
 // The publisher to list books from.
 // Format: publishers/{publisher_id}
-string parent = 1 [(google.api.resource_reference) = {
-  type: "apis.example.com/library/Publisher"
-}];
+string parent = 1 [(aep.api.field_info) = { resource_reference: [ "apis.example.com/library/Publisher" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }];
 
 // Other fields (e.g. max_page_size, page_token, filter, etc.)...
 }
 ```
 
 If there is more than one possible parent type, the `parent` field **should**
-be annotated with the `child_type` key on `google.api.resource_reference`
-instead:
+be annotated with multiple `resource_reference` types using
+`aep.api.field_info`:
 
 ```proto
 // Request message for ListBooks.
@@ -270,10 +265,8 @@ message ListBooksRequest {
 //   - publishers/{publisher_id}
 //   - authors/{author_id}
 string parent = 1 [
-  (google.api.field_behavior) = REQUIRED,
-  (google.api.resource_reference) = {
-    child_type: "apis.example.com/library/Book"
-  }];
+  (aep.api.field_info) = { resource_reference: [ "apis.example.com/library/Book" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }
+];
 
 // Other fields (e.g. max_page_size, page_token, filter, etc.)...
 }
@@ -298,8 +291,7 @@ When referencing a resource path for a different resource:
 - Field names **should not** use the `_path` suffix unless the field would be
   ambiguous without it (e.g., `crypto_key_path`)
 - In protobuf, fields representing another resource **should** provide the
-  `google.api.resource_reference` annotation with the resource type being
-  referenced.
+  `aep.api.field_info` annotation with the resource type being referenced.
 
 ```proto
 // A representation of a book in a library.
@@ -315,9 +307,7 @@ string path = 1;
 
 // The shelf where the book currently sits.
 // Format is `shelves/{shelf}`.
-string shelf = 2 [(google.api.resource_reference) = {
-  type: "apis.example.com/library/Shelf"
-}];
+string shelf = 2 [(aep.api.field_info) = { resource_reference: [ "apis.example.com/library/Shelf" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }];
 
 // Other fields...
 }

aep/general/0124/embedded_resource.proto

@@ -1,5 +1,6 @@
 syntax = "proto3";
 
+import "aep/api/field_info.proto";
 import "google/api/resource.proto";
 
 message Book {
@@ -16,13 +17,11 @@ message Book {
   // The resource path of the book's author.
   //
   // By default, only the `path` field of the author is populated.
-  // However, the full author can be retrieved by specifying the 
+  // However, the full author can be retrieved by specifying the
   // FULL_WITH_AUTHOR view. This **will not** dereference resource
   // references within the author, such as `Author.pen_names`; only
   // the `path` subfield of these fields will be populated.
-  Author author = 2 [(google.api.resource_reference) = {
-    type: "library.googleapis.com/Author"
-  }];
+  Author author = 2 [(aep.api.field_info) = { resource_reference: [ "library.googleapis.com/Author" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }];
 
   // Different views of a book.
   enum View {

aep/general/0124/many_to_many_repeated.proto

@@ -1,5 +1,6 @@
 syntax = "proto3";
 
+import "aep/api/field_info.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 
@@ -12,7 +13,5 @@ message Book {
   string path = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // The resource paths for the book's authors.
-  repeated string authors = 2 [(google.api.resource_reference) = {
-    type: "library.googleapis.com/Author"
-  }];
+  repeated string authors = 2 [(aep.api.field_info) = { resource_reference: [ "library.googleapis.com/Author" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }];
 }

aep/general/0124/many_to_many_subresource.proto

@@ -1,5 +1,6 @@
 syntax = "proto3";
 
+import "aep/api/field_info.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 
@@ -15,9 +16,7 @@ message BookAuthor {
   string path = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // The resource path for the author.
-  string author = 2 [(google.api.resource_reference) = {
-    type: "library.googleapis.com/Author"
-  }];
+  string author = 2 [(aep.api.field_info) = { resource_reference: [ "library.googleapis.com/Author" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }];
 
   // Other fields...
 }

aep/general/0124/multiple_many_to_one.proto

@@ -1,5 +1,6 @@
 syntax = "proto3";
 
+import "aep/api/field_info.proto";
 import "google/api/resource.proto";
 
 message Book {
@@ -14,7 +15,5 @@ message Book {
   string path = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // The resource name for the book's author.
-  string author = 2 [(google.api.resource_reference) = {
-    type: "library.googleapis.com/Author"
-  }];
+  string author = 2 [(aep.api.field_info) = { resource_reference: [ "library.googleapis.com/Author" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }];
 }

aep/general/0127/aep.md.j2

@@ -33,10 +33,8 @@ message CreateBookRequest {
   // When using HTTP/JSON, this field is automatically populated based
   // on the URI, because of the `{parent=publishers/*}` syntax.
   string parent = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = {
-      child_type: "library.example.com/Book"
-    }];
+    (aep.api.field_info) = { resource_reference: [ "library.example.com/Book" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }
+  ];
 
   // The book to create.
   // When using HTTP/JSON, this field is populated based on the HTTP body,

aep/general/0132/aep.md.j2

@@ -77,7 +77,7 @@ collection's URI:
   top-level resource. It **should** be called `parent`.
   - The field **must** be [annotated as required][aep-203].
   - The field **must** identify the [resource type][] of the resource being
-    listed with a `google.api.resource_reference` annotation.
+    listed with a `aepi.api.field_info.resource_reference` annotation.
   - The field **must** accept the parent [path, _not_ the id](./0122)
 - The `max_page_size` and `page_token` fields, which support pagination,
   **must** be specified on all list request messages. For more information, see

aep/general/0135/aep.md.j2

@@ -134,10 +134,8 @@ message DeletePublisherRequest {
   // The path of the publisher to delete.
   // Format: publishers/{publisher_id}
   string path = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = {
-      type: "library.example.com/Publisher"
-    }];
+    (aep.api.field_info) = { resource_reference: [ "library.example.com/Publisher" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }
+  ];
 
   // If set to true, any books from this publisher will also be deleted.
   // (Otherwise, the request will only work if the publisher has no books.)

aep/general/0136/library.proto

@@ -14,6 +14,7 @@
 
 syntax = "proto3";
 
+import "aep/api/field_info.proto";
 import "google/api/annotations.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
@@ -41,10 +42,8 @@ service Library {
 message ArchiveBookRequest {
   // The path of the book to retrieve.
   string path = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = {
-      type: "library.googleapis.com/Book"
-    }];
+    (aep.api.field_info) = { resource_reference: [ "library.googleapis.com/Book" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }
+  ];
 
   // The target format for the archived book.
   // Must be "application/pdf", "application/rtf", or "application/epub+zip"
@@ -61,10 +60,8 @@ message ArchiveBookResponse {
 message SortBooksRequest {
   // The path of the publisher to sort books for.
   string parent = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = {
-      type: "library.googleapis.com/Publisher"
-    }];
+    (aep.api.field_info) = { resource_reference: [ "library.googleapis.com/Publisher" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }
+  ];
 
   // The property of the book to sort by.
   // If not provided, "title" is used.

aep/general/0144/add_remove.proto

@@ -1,5 +1,6 @@
 syntax = "proto3";
 
+import "aep/api/field_info.proto";
 import "google/api/annotations.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
@@ -26,8 +27,7 @@ service Library {
 message AddAuthorRequest {
   // The name of the book to add an author to.
   string book = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference).type = "library.googleapis.com/Book"
+    (aep.api.field_info) = { resource_reference: [ "library.googleapis.com/Book" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }
   ];
 
   // The author to be added.
@@ -38,8 +38,7 @@ message AddAuthorRequest {
 message RemoveAuthorRequest {
   // The name of the book to remove an author from.
   string book = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference).type = "library.googleapis.com/Book"
+    (aep.api.field_info) = { resource_reference: [ "library.googleapis.com/Book" ], field_behavior: [ FIELD_BEHAVIOR_REQUIRED ] }
   ];
 
   // The author to be removed.