From c181b96c1b867318be651cdbc5f0cd44e0fbc99c Mon Sep 17 00:00:00 2001 From: Yusuke Tsutsumi Date: Thu, 12 Sep 2024 07:01:12 -0700 Subject: [PATCH] addressing feedback. --- aep/general/0162/aep.md.j2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/aep/general/0162/aep.md.j2 b/aep/general/0162/aep.md.j2 index a6c94a29..25377f6f 100644 --- a/aep/general/0162/aep.md.j2 +++ b/aep/general/0162/aep.md.j2 @@ -48,7 +48,7 @@ message BookRevision { [(google.api.field_behavior) = OUTPUT_ONLY]; // Other revision IDs that share the same snapshot. - repeated string alternate_ids = 4 + repeated string aliases = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } ``` @@ -129,6 +129,8 @@ Services **may** reserve specific IDs to be [aliases][alias] (e.g. GET /v1/publishers/{publisher_id}/books/{book_id}/revisions/{revision_id} ``` +If specific IDs are reserved, services **should** document those IDs. + - If a `latest` ID exists, it **must** represent the most recently created revision. The content of `publishers/{publisher}/books/{book}/revisions/latest` and `publishers/{publisher}/books/{book}` can differ, as the latest revision may