Skip to content

Instantly share code, notes, and snippets.

@r3code
Created April 2, 2021 12:17
Show Gist options
  • Save r3code/8395264cd83a36680d4b976caf81b886 to your computer and use it in GitHub Desktop.
Save r3code/8395264cd83a36680d4b976caf81b886 to your computer and use it in GitHub Desktop.
Protobuf Guidelines

Используем protobuff версии 3 https://developers.google.com/protocol-buffers/docs/proto3

Придерживаемся стиля https://developers.google.com/protocol-buffers/docs/style

Если вы удалили поля message определенные ранее, то для сохранения совместимости, их номера должны быть помечены как reserved, чтобы их нельзя было использовать повторно после.

Поддержка версионирования API - см. https://google.aip.dev/215

Переиспользуем готовые определения часто используемых типов (время, деньги, дата и др.) см. https://google.aip.dev/213

Аннтотируем определения для генерации REST представления - см. https://google.aip.dev/127

Описание времени (Time and duration) https://google.aip.dev/142

Название стандартных полей https://google.aip.dev/148

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment