slash-e/proto/gen/store/README.md
2023-09-03 10:43:28 +08:00

8.5 KiB
Raw Blame History

Protocol Documentation

Table of Contents

Top

store/activity.proto

ActivityShorcutCreatePayload

Field Type Label Description
shortcut_id int32

Top

store/common.proto

RowStatus

Name Number Description
ROW_STATUS_UNSPECIFIED 0
NORMAL 1
ARCHIVED 2

Top

store/shortcut.proto

OpenGraphMetadata

Field Type Label Description
title string
description string
image string

Shortcut

Field Type Label Description
id int32
creator_id int32
created_ts int64
updated_ts int64
row_status RowStatus
name string
link string
title string
tags string repeated
description string
visibility Visibility
og_metadata OpenGraphMetadata

Visibility

Name Number Description
VISIBILITY_UNSPECIFIED 0
PRIVATE 1
WORKSPACE 2
PUBLIC 3

Top

store/user_setting.proto

AccessTokensUserSetting

Field Type Label Description
access_tokens AccessTokensUserSetting.AccessToken repeated

AccessTokensUserSetting.AccessToken

Field Type Label Description
access_token string The access token is a JWT token. Including expiration time, issuer, etc.
description string A description for the access token.

UserSetting

Field Type Label Description
user_id int32
key UserSettingKey
access_tokens AccessTokensUserSetting
locale LocaleUserSetting

LocaleUserSetting

Name Number Description
LOCALE_USER_SETTING_UNSPECIFIED 0
LOCALE_USER_SETTING_EN 1
LOCALE_USER_SETTING_ZH 2

UserSettingKey

Name Number Description
USER_SETTING_KEY_UNSPECIFIED 0
USER_SETTING_ACCESS_TOKENS 1 Access tokens for the user.
USER_SETTING_LOCALE 2 Locale for the user.

Top

store/workspace_setting.proto

AutoBackupWorkspaceSetting

Field Type Label Description
enabled bool Whether auto backup is enabled.
cron_expression string The cron expression for auto backup. For example, "0 0 0 * * *" means backup at 00:00:00 every day. See https://en.wikipedia.org/wiki/Cron for more details.
max_keep int32 The maximum number of backups to keep.

WorkspaceSetting

Field Type Label Description
key WorkspaceSettingKey
auto_backup AutoBackupWorkspaceSetting

WorkspaceSettingKey

Name Number Description
WORKSPACE_SETTING_KEY_UNSPECIFIED 0
WORKSPACE_SETTING_AUTO_BACKUP 1

Scalar Value Types

.proto Type Notes C++ Java Python Go C# PHP Ruby
double double double float float64 double float Float
float float float float float32 float float Float
int32 Uses variable-length encoding. Inefficient for encoding negative numbers if your field is likely to have negative values, use sint32 instead. int32 int int int32 int integer Bignum or Fixnum (as required)
int64 Uses variable-length encoding. Inefficient for encoding negative numbers if your field is likely to have negative values, use sint64 instead. int64 long int/long int64 long integer/string Bignum
uint32 Uses variable-length encoding. uint32 int int/long uint32 uint integer Bignum or Fixnum (as required)
uint64 Uses variable-length encoding. uint64 long int/long uint64 ulong integer/string Bignum or Fixnum (as required)
sint32 Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. int32 int int int32 int integer Bignum or Fixnum (as required)
sint64 Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. int64 long int/long int64 long integer/string Bignum
fixed32 Always four bytes. More efficient than uint32 if values are often greater than 2^28. uint32 int int uint32 uint integer Bignum or Fixnum (as required)
fixed64 Always eight bytes. More efficient than uint64 if values are often greater than 2^56. uint64 long int/long uint64 ulong integer/string Bignum
sfixed32 Always four bytes. int32 int int int32 int integer Bignum or Fixnum (as required)
sfixed64 Always eight bytes. int64 long int/long int64 long integer/string Bignum
bool bool boolean boolean bool bool boolean TrueClass/FalseClass
string A string must always contain UTF-8 encoded or 7-bit ASCII text. string String str/unicode string string string String (UTF-8)
bytes May contain any arbitrary sequence of bytes. string ByteString str []byte ByteString string String (ASCII-8BIT)