| OLD | NEW |
| (Empty) |
| 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 | |
| 5 #ifndef COMPONENTS_SYNC_DRIVER_DEVICE_INFO_H_ | |
| 6 #define COMPONENTS_SYNC_DRIVER_DEVICE_INFO_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 | |
| 10 #include "base/callback.h" | |
| 11 #include "base/macros.h" | |
| 12 #include "components/sync/protocol/sync.pb.h" | |
| 13 | |
| 14 namespace base { | |
| 15 class DictionaryValue; | |
| 16 } | |
| 17 | |
| 18 namespace sync_driver { | |
| 19 | |
| 20 // A class that holds information regarding the properties of a device. | |
| 21 class DeviceInfo { | |
| 22 public: | |
| 23 DeviceInfo(const std::string& guid, | |
| 24 const std::string& client_name, | |
| 25 const std::string& chrome_version, | |
| 26 const std::string& sync_user_agent, | |
| 27 const sync_pb::SyncEnums::DeviceType device_type, | |
| 28 const std::string& signin_scoped_device_id); | |
| 29 ~DeviceInfo(); | |
| 30 | |
| 31 // Sync specific unique identifier for the device. Note if a device | |
| 32 // is wiped and sync is set up again this id WILL be different. | |
| 33 // The same device might have more than 1 guid if the device has multiple | |
| 34 // accounts syncing. | |
| 35 const std::string& guid() const; | |
| 36 | |
| 37 // The host name for the client. | |
| 38 const std::string& client_name() const; | |
| 39 | |
| 40 // Chrome version string. | |
| 41 const std::string& chrome_version() const; | |
| 42 | |
| 43 // The user agent is the combination of OS type, chrome version and which | |
| 44 // channel of chrome(stable or beta). For more information see | |
| 45 // |LocalDeviceInfoProviderImpl::MakeUserAgentForSyncApi|. | |
| 46 const std::string& sync_user_agent() const; | |
| 47 | |
| 48 // Third party visible id for the device. See |public_id_| for more details. | |
| 49 const std::string& public_id() const; | |
| 50 | |
| 51 // Device Type. | |
| 52 sync_pb::SyncEnums::DeviceType device_type() const; | |
| 53 | |
| 54 // Device_id that is stable until user signs out. This device_id is used for | |
| 55 // annotating login scoped refresh token. | |
| 56 const std::string& signin_scoped_device_id() const; | |
| 57 | |
| 58 // Gets the OS in string form. | |
| 59 std::string GetOSString() const; | |
| 60 | |
| 61 // Gets the device type in string form. | |
| 62 std::string GetDeviceTypeString() const; | |
| 63 | |
| 64 // Compares this object's fields with another's. | |
| 65 bool Equals(const DeviceInfo& other) const; | |
| 66 | |
| 67 // Apps can set ids for a device that is meaningful to them but | |
| 68 // not unique enough so the user can be tracked. Exposing |guid| | |
| 69 // would lead to a stable unique id for a device which can potentially | |
| 70 // be used for tracking. | |
| 71 void set_public_id(const std::string& id); | |
| 72 | |
| 73 // Converts the |DeviceInfo| values to a JS friendly DictionaryValue, | |
| 74 // which extension APIs can expose to third party apps. | |
| 75 base::DictionaryValue* ToValue(); | |
| 76 | |
| 77 private: | |
| 78 const std::string guid_; | |
| 79 | |
| 80 const std::string client_name_; | |
| 81 | |
| 82 const std::string chrome_version_; | |
| 83 | |
| 84 const std::string sync_user_agent_; | |
| 85 | |
| 86 const sync_pb::SyncEnums::DeviceType device_type_; | |
| 87 | |
| 88 std::string signin_scoped_device_id_; | |
| 89 | |
| 90 // Exposing |guid| would lead to a stable unique id for a device which | |
| 91 // can potentially be used for tracking. Public ids are privacy safe | |
| 92 // ids in that the same device will have different id for different apps | |
| 93 // and they are also reset when app/extension is uninstalled. | |
| 94 std::string public_id_; | |
| 95 | |
| 96 DISALLOW_COPY_AND_ASSIGN(DeviceInfo); | |
| 97 }; | |
| 98 | |
| 99 } // namespace sync_driver | |
| 100 | |
| 101 #endif // COMPONENTS_SYNC_DRIVER_DEVICE_INFO_H_ | |
| OLD | NEW |