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; | |
191 }; | 175 }; |
192 | 176 |
193 message GetUpdatesCallerInfo { | 177 message GetUpdatesCallerInfo { |
194 enum GET_UPDATES_SOURCE { | 178 enum GET_UPDATES_SOURCE { |
195 UNKNOWN = 0; // The source was not set by the caller. | 179 UNKNOWN = 0; // The source was not set by the caller. |
196 FIRST_UPDATE = 1; // First update from an instance of Chrome. | 180 FIRST_UPDATE = 1; // First update from an instance of Chrome. |
197 LOCAL = 2; // The source of the update was a local change. | 181 LOCAL = 2; // The source of the update was a local change. |
198 NOTIFICATION = 3; // The source of the update was a p2p notification. | 182 NOTIFICATION = 3; // The source of the update was a p2p notification. |
199 PERIODIC = 4; // The source of the update was periodic polling. | 183 PERIODIC = 4; // The source of the update was periodic polling. |
200 SYNC_CYCLE_CONTINUATION = 5; // The source of the update was a | 184 SYNC_CYCLE_CONTINUATION = 5; // The source of the update was a |
(...skipping 11 matching lines...) Expand all Loading... |
212 // Indicates the reason for the GetUpdatesMessage. | 196 // Indicates the reason for the GetUpdatesMessage. |
213 optional GetUpdatesCallerInfo caller_info = 2; | 197 optional GetUpdatesCallerInfo caller_info = 2; |
214 }; | 198 }; |
215 | 199 |
216 message AuthenticateMessage { | 200 message AuthenticateMessage { |
217 required string auth_token = 1; | 201 required string auth_token = 1; |
218 }; | 202 }; |
219 | 203 |
220 message ClientToServerMessage { | 204 message ClientToServerMessage { |
221 required string share = 1; | 205 required string share = 1; |
222 optional int32 protocol_version = 2 [default = 22]; | 206 optional int32 protocol_version = 2 [default = 21]; |
223 enum CONTENTS { | 207 enum CONTENTS { |
224 COMMIT = 1; | 208 COMMIT = 1; |
225 GET_UPDATES = 2; | 209 GET_UPDATES = 2; |
226 AUTHENTICATE = 3; | 210 AUTHENTICATE = 3; |
227 } | 211 } |
228 | 212 |
229 required CONTENTS message_contents = 3; | 213 required CONTENTS message_contents = 3; |
230 optional CommitMessage commit = 4; | 214 optional CommitMessage commit = 4; |
231 optional GetUpdatesMessage get_updates = 5; | 215 optional GetUpdatesMessage get_updates = 5; |
232 optional AuthenticateMessage authenticate = 6; | 216 optional AuthenticateMessage authenticate = 6; |
(...skipping 19 matching lines...) Expand all Loading... |
252 required RESPONSE_TYPE response_type = 2; | 236 required RESPONSE_TYPE response_type = 2; |
253 | 237 |
254 // Sync servers may also return a new ID for an existing item, indicating | 238 // Sync servers may also return a new ID for an existing item, indicating |
255 // a new entry's been created to hold the data the client's sending up. | 239 // a new entry's been created to hold the data the client's sending up. |
256 optional string id_string = 3; | 240 optional string id_string = 3; |
257 | 241 |
258 // should be filled if our parent was assigned a new ID. | 242 // should be filled if our parent was assigned a new ID. |
259 optional string parent_id_string = 4; | 243 optional string parent_id_string = 4; |
260 | 244 |
261 // This value is the same as the position_in_parent value returned within | 245 // This value is the same as the position_in_parent value returned within |
262 // the SyncEntity message in GetUpdatesResponse. | 246 // the SyncEntity message in GetUpdatesResponse. It is returned if the |
| 247 // item was assigned a new position. |
263 optional int64 position_in_parent = 5; | 248 optional int64 position_in_parent = 5; |
264 | 249 |
265 // The item's current version. | 250 // The item's current version. |
266 optional int64 version = 6; | 251 optional int64 version = 6; |
267 | 252 |
268 // Allows the server to move-aside an entry as it's being committed. | 253 // Allows the server to move-aside an entry as it's being committed. |
269 // This name is the same as the name field returned within the SyncEntity | 254 // This name is the same as the name field returned within the SyncEntity |
270 // message in GetUpdatesResponse. | 255 // message in GetUpdatesResponse. |
271 optional string name = 7; | 256 optional string name = 7; |
272 | 257 |
(...skipping 76 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
349 // Opaque store ID; if it changes, the contents of the client's cache | 334 // Opaque store ID; if it changes, the contents of the client's cache |
350 // is meaningless to this server. This happens most typically when | 335 // is meaningless to this server. This happens most typically when |
351 // you switch from one storage backend instance (say, a test instance) | 336 // you switch from one storage backend instance (say, a test instance) |
352 // to another (say, the official instance). | 337 // to another (say, the official instance). |
353 optional string store_birthday = 6; | 338 optional string store_birthday = 6; |
354 | 339 |
355 optional ClientCommand client_command = 7; | 340 optional ClientCommand client_command = 7; |
356 optional ProfilingData profiling_data = 8; | 341 optional ProfilingData profiling_data = 8; |
357 }; | 342 }; |
358 | 343 |
OLD | NEW |