| OLD | NEW |
| 1 // Copyright (c) 2009 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2009 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 // | 4 // |
| 5 // Sync protocol for communication between sync client and server. | 5 // Sync protocol for communication between sync client and server. |
| 6 | 6 |
| 7 syntax = "proto2"; | 7 syntax = "proto2"; |
| 8 | 8 |
| 9 option optimize_for = LITE_RUNTIME; | 9 option optimize_for = LITE_RUNTIME; |
| 10 | 10 |
| (...skipping 154 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 165 // Present only in GetUpdatesResponse. | 165 // Present only in GetUpdatesResponse. |
| 166 optional string originator_client_item_id = 20; | 166 optional string originator_client_item_id = 20; |
| 167 }; | 167 }; |
| 168 | 168 |
| 169 message CommitMessage { | 169 message CommitMessage { |
| 170 repeated SyncEntity entries = 1; | 170 repeated SyncEntity entries = 1; |
| 171 | 171 |
| 172 // A GUID that identifies the committing sync client. This value will be | 172 // A GUID that identifies the committing sync client. This value will be |
| 173 // returned as originator_cache_guid for any new items. | 173 // returned as originator_cache_guid for any new items. |
| 174 optional string cache_guid = 2; | 174 optional string cache_guid = 2; |
| 175 |
| 176 // This message contains diagnostic information used to correlate |
| 177 // commit-related traffic with extensions-related mutations to the |
| 178 // data models in chromium. It plays no functional role in |
| 179 // processing this CommitMessage. |
| 180 message ChromiumExtensionsActivity { |
| 181 // The human-readable ID identifying the extension responsible |
| 182 // for the traffic reported in this ChromiumExtensionsActivity. |
| 183 optional string extension_id = 1; |
| 184 |
| 185 // How many times the extension successfully invoked a write |
| 186 // operation through the bookmarks API since the last CommitMessage. |
| 187 optional uint32 bookmark_writes_since_last_commit = 2; |
| 188 } |
| 189 |
| 190 repeated ChromiumExtensionsActivity extensions_activity = 3; |
| 175 }; | 191 }; |
| 176 | 192 |
| 177 message GetUpdatesCallerInfo { | 193 message GetUpdatesCallerInfo { |
| 178 enum GET_UPDATES_SOURCE { | 194 enum GET_UPDATES_SOURCE { |
| 179 UNKNOWN = 0; // The source was not set by the caller. | 195 UNKNOWN = 0; // The source was not set by the caller. |
| 180 FIRST_UPDATE = 1; // First update from an instance of Chrome. | 196 FIRST_UPDATE = 1; // First update from an instance of Chrome. |
| 181 LOCAL = 2; // The source of the update was a local change. | 197 LOCAL = 2; // The source of the update was a local change. |
| 182 NOTIFICATION = 3; // The source of the update was a p2p notification. | 198 NOTIFICATION = 3; // The source of the update was a p2p notification. |
| 183 PERIODIC = 4; // The source of the update was periodic polling. | 199 PERIODIC = 4; // The source of the update was periodic polling. |
| 184 SYNC_CYCLE_CONTINUATION = 5; // The source of the update was a | 200 SYNC_CYCLE_CONTINUATION = 5; // The source of the update was a |
| (...skipping 11 matching lines...) Expand all Loading... |
| 196 // Indicates the reason for the GetUpdatesMessage. | 212 // Indicates the reason for the GetUpdatesMessage. |
| 197 optional GetUpdatesCallerInfo caller_info = 2; | 213 optional GetUpdatesCallerInfo caller_info = 2; |
| 198 }; | 214 }; |
| 199 | 215 |
| 200 message AuthenticateMessage { | 216 message AuthenticateMessage { |
| 201 required string auth_token = 1; | 217 required string auth_token = 1; |
| 202 }; | 218 }; |
| 203 | 219 |
| 204 message ClientToServerMessage { | 220 message ClientToServerMessage { |
| 205 required string share = 1; | 221 required string share = 1; |
| 206 optional int32 protocol_version = 2 [default = 21]; | 222 optional int32 protocol_version = 2 [default = 22]; |
| 207 enum CONTENTS { | 223 enum CONTENTS { |
| 208 COMMIT = 1; | 224 COMMIT = 1; |
| 209 GET_UPDATES = 2; | 225 GET_UPDATES = 2; |
| 210 AUTHENTICATE = 3; | 226 AUTHENTICATE = 3; |
| 211 } | 227 } |
| 212 | 228 |
| 213 required CONTENTS message_contents = 3; | 229 required CONTENTS message_contents = 3; |
| 214 optional CommitMessage commit = 4; | 230 optional CommitMessage commit = 4; |
| 215 optional GetUpdatesMessage get_updates = 5; | 231 optional GetUpdatesMessage get_updates = 5; |
| 216 optional AuthenticateMessage authenticate = 6; | 232 optional AuthenticateMessage authenticate = 6; |
| (...skipping 19 matching lines...) Expand all Loading... |
| 236 required RESPONSE_TYPE response_type = 2; | 252 required RESPONSE_TYPE response_type = 2; |
| 237 | 253 |
| 238 // Sync servers may also return a new ID for an existing item, indicating | 254 // Sync servers may also return a new ID for an existing item, indicating |
| 239 // a new entry's been created to hold the data the client's sending up. | 255 // a new entry's been created to hold the data the client's sending up. |
| 240 optional string id_string = 3; | 256 optional string id_string = 3; |
| 241 | 257 |
| 242 // should be filled if our parent was assigned a new ID. | 258 // should be filled if our parent was assigned a new ID. |
| 243 optional string parent_id_string = 4; | 259 optional string parent_id_string = 4; |
| 244 | 260 |
| 245 // This value is the same as the position_in_parent value returned within | 261 // This value is the same as the position_in_parent value returned within |
| 246 // the SyncEntity message in GetUpdatesResponse. It is returned if the | 262 // the SyncEntity message in GetUpdatesResponse. |
| 247 // item was assigned a new position. | |
| 248 optional int64 position_in_parent = 5; | 263 optional int64 position_in_parent = 5; |
| 249 | 264 |
| 250 // The item's current version. | 265 // The item's current version. |
| 251 optional int64 version = 6; | 266 optional int64 version = 6; |
| 252 | 267 |
| 253 // Allows the server to move-aside an entry as it's being committed. | 268 // Allows the server to move-aside an entry as it's being committed. |
| 254 // This name is the same as the name field returned within the SyncEntity | 269 // This name is the same as the name field returned within the SyncEntity |
| 255 // message in GetUpdatesResponse. | 270 // message in GetUpdatesResponse. |
| 256 optional string name = 7; | 271 optional string name = 7; |
| 257 | 272 |
| (...skipping 76 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 334 // Opaque store ID; if it changes, the contents of the client's cache | 349 // Opaque store ID; if it changes, the contents of the client's cache |
| 335 // is meaningless to this server. This happens most typically when | 350 // is meaningless to this server. This happens most typically when |
| 336 // you switch from one storage backend instance (say, a test instance) | 351 // you switch from one storage backend instance (say, a test instance) |
| 337 // to another (say, the official instance). | 352 // to another (say, the official instance). |
| 338 optional string store_birthday = 6; | 353 optional string store_birthday = 6; |
| 339 | 354 |
| 340 optional ClientCommand client_command = 7; | 355 optional ClientCommand client_command = 7; |
| 341 optional ProfilingData profiling_data = 8; | 356 optional ProfilingData profiling_data = 8; |
| 342 }; | 357 }; |
| 343 | 358 |
| OLD | NEW |