気になるところを読んでみる。メモ。
AIP-121: Resource-oriented design
- リソース指向 API ではリソースに対する実行される操作を重視する
- 標準メソッド
- Create, Get, Update, Delete, List
- カスタムメソッド
POST- URI にカスタム動詞を定義する
AIP-122: Resource names
- コレクション識別子とリソース ID を交互に使用する
- リソース名は
nameフィールド- 親リソースは
parentフィールド
- 親リソースは
nameとは別にリソース ID (ex.book_id) のフィールドを定義してもいい (OUTPUT_ONLY)- リソース ID は RFC-1034 準拠
- 英小文字, 数字, ハイフン (文字始まり)
- 最大63文字
- ユーザーは UUID ライクな ID 入力は避ける
- 完全リソース名
- リソース URI
- スキーム, API バージョン, サービスエンドポイント を含む
AIP-123: Resource types
- リソースタイプ
{SERVICE_NAME}/{TYPE} google.api.resource- リソースの型を指定する
AIP-124: Resource association
- リソースの親は最大1つ
- 他の親リソースは (たぶん
parentとは) 別のフィールドで指定する
