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 |