get_updates_caller_info.proto 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. // Copyright (c) 2012 The Chromium Authors. All rights reserved.
  2. // Use of this source code is governed by a BSD-style license that can be
  3. // found in the LICENSE file.
  4. // If you change or add any fields in this file, update proto_visitors.h and
  5. // potentially proto_enum_conversions.{h, cc}.
  6. syntax = "proto2";
  7. option java_multiple_files = true;
  8. option java_package = "org.chromium.components.sync.protocol";
  9. option optimize_for = LITE_RUNTIME;
  10. package sync_pb;
  11. message GetUpdatesCallerInfo {
  12. // This enum was deprecated in M28. The preferred represenation of this
  13. // information is now the GetUpdatesOrigin enum, which is defined in
  14. // sync_enums.proto.
  15. // TODO(crbug.com/510165): Remove all values except for UNKNOWN and stop
  16. // filling the field once the server doesn't depend on it anymore.
  17. enum GetUpdatesSource {
  18. UNKNOWN = 0; // The source was not set by the caller.
  19. FIRST_UPDATE = 1; // First request after browser restart. Not to
  20. // be confused with "NEW_CLIENT".
  21. LOCAL = 2; // The source of the update was a local change.
  22. NOTIFICATION = 3; // The source of the update was a p2p notification.
  23. PERIODIC = 4; // The source of the update was periodic polling.
  24. SYNC_CYCLE_CONTINUATION = 5; // The source of the update was a
  25. // continuation of a previous sync cycle.
  26. // No longer sent as of M24.
  27. // This value is deprecated and was never used in production.
  28. // CLEAR_PRIVATE_DATA = 6;
  29. NEWLY_SUPPORTED_DATATYPE = 7; // The client is in configuration mode
  30. // because it's syncing all datatypes, and
  31. // support for a new datatype was recently
  32. // released via a software auto-update.
  33. MIGRATION = 8; // The client is in configuration mode because a
  34. // MIGRATION_DONE error previously returned by the
  35. // server necessitated resynchronization.
  36. NEW_CLIENT = 9; // The client is in configuration mode because the
  37. // user enabled sync for the first time. Not to be
  38. // confused with FIRST_UPDATE.
  39. RECONFIGURATION = 10; // The client is in configuration mode because the
  40. // user opted to sync a different set of datatypes.
  41. DATATYPE_REFRESH = 11; // A datatype has requested a refresh. This is
  42. // typically used when datatype's have custom
  43. // sync UI, e.g. sessions.
  44. RETRY = 13; // A follow-up GU to pick up updates missed by previous GU.
  45. PROGRAMMATIC = 14; // The client is programmatically enabling/disabling
  46. // a type, typically for error handling purposes.
  47. }
  48. required GetUpdatesSource source = 1 [deprecated = true];
  49. // True only if notifications were enabled for this GetUpdateMessage.
  50. // TODO(crbug.com/510165): Move this bool out of GetUpdatesCallerInfo so that
  51. // GetUpdatesCallerInfo can eventually be removed.
  52. optional bool notifications_enabled = 2;
  53. }