package sync_pb
Get desktop application:
View/edit binary Protocol Buffers messages
message
app_list_specifics.proto:22Properties of app list objects.
Used in:
optional string item_id = 1
Unique identifier for the item: * TYPE_FOLDER: Folder id (generated) * TYPE_APP: App Id
optional AppListSpecifics.AppListItemType item_type = 2
optional string item_name = 3
Item name (FOLDER).
optional string parent_id = 4
Id of the parent (folder) item.
optional string OBSOLETE_page_ordinal = 5
Marked OBSOLETE because this is unused for the app list. Which page this item will appear on in the app list.
optional string item_ordinal = 6
Where on a page this item will appear.
optional string item_pin_ordinal = 7
Where on a shelf this item will appear. Note that not all apps are pinned to the shelf by the user -- some might originate from the PinnedLauncherApps policy. See `is_user_pinned` for more details.
optional item_color = 8
optional bool is_user_pinned = 9
Whether the app was pinned to shelf by the user or not (apps can also be pinned by other means such as enterprise policies). The eventual consistency (a sufficient amount of time after the rollout) promise here is for this field to be synced with the pin ordinal: `item_pin_ordinal.IsValid() <=> is_user_pinned.has_value()`. However, it's okay for this contract to be violated in the meantine. * missing value indicates that either `item_pin_ordinal` is invalid or this field is new and hasn't yet been processed by sync. * `true` means that the app was pinned by the user. This definition is used in a relaxed way -- for instance, default OS apps that are shown in the shelf (like Chrome itself) also have this value set to true. * `false` means that the app was pinned by PinnedLauncherApps policy. Note that user pin has priority: if an app was first pinned by the user and then additionally specified in PinnedLauncherApps, this value will be set to true.
optional string promise_package_id = 10
Identifier for the app package of the item. Package Ids are stable and globally unique across app platforms, whereas App Id stored in item_id is not.
What type of item this is.
Used in:
TYPE_APP = 1
An app, whether a web app, Android app, etc. For bookmark apps (URL shortcuts), additional information such as their URLs are kept in the AppSpecifics.bookmark_app_foobar fields.
TYPE_REMOVE_DEFAULT_APP = 2
A request to remove any matching default installed apps.
TYPE_FOLDER = 3
A folder containing entries whose |parent_id| matches |item_id|.
TYPE_OBSOLETE_URL = 4
Obsolete type, intended for URL shortcuts, that was never implemented.
TYPE_PAGE_BREAK = 5
A "page break" item (Indicate creation of a new page in app list).
The color groups used for grouping together icons by colors.
Used in:
COLOR_EMPTY = 0
COLOR_WHITE = 1
COLOR_RED = 2
COLOR_ORANGE = 3
COLOR_YELLOW = 4
COLOR_GREEN = 5
COLOR_BLUE = 6
COLOR_MAGENTA = 7
COLOR_BLACK = 8
message
app_list_specifics.proto:78Used in:
optional ColorGroup background_color = 1
The item icon's background color.
optional int32 hue = 2
The item icon's hue.
message
app_specifics.proto:24Settings related to push notifications for apps.
Used in:
optional bool initial_setup_done = 1
DEPRECATED: Use oauth_client_id below. Whether or not the user has setup notifications at least once. The value for this field will start out false and will be set to true when the user accepts receiving notifications for the first time and then it will always remain true.
optional bool disabled = 2
Whether or not the user has disabled notifications.
optional string oauth_client_id = 3
OAuth2 client id to which the user granted the notification permission. This field will start out empty. It will be set when the user accepts receiving notifications. This field is used when the user revokes the notifications permission. Note that it is never cleared after it was set once. Hence, the presence of this field can be used to determine if the user has setup notifications at least once for the given app.
message
app_setting_specifics.proto:26Properties of app setting sync objects; just an extension setting.
Used in:
optional extension_setting = 1
message
app_specifics.proto:58Properties of app sync objects. For now, an app is just an extension. We keep the two data types separate for future-proofing purposes.
Used in:
optional extension = 1
Extension data.
optional notification_settings = 2
Notification settings.
optional string app_launch_ordinal = 3
This controls where on a page this application icon will appear.
optional string page_ordinal = 4
This specifics which page the application icon will appear on in the NTP. This values only provide the order within the application pages, not within all of the panels in the NTP.
optional AppSpecifics.LaunchType launch_type = 5
This describes how the extension should be launched.
optional string bookmark_app_url = 6
DEPRECATED. See https://crbug.com/1233303.
optional string bookmark_app_description = 7
DEPRECATED. See https://crbug.com/1233303.
optional string bookmark_app_icon_color = 8
DEPRECATED. See https://crbug.com/1233303.
repeated linked_app_icons = 9
This is information about linked icons (that is, icons that are downloaded from outside the app's bundle of files.
optional string bookmark_app_scope = 10
DEPRECATED. See https://crbug.com/1233303.
optional uint32 bookmark_app_theme_color = 11
DEPRECATED. See https://crbug.com/1233303.
The possible launch types for an app. This enum should be kept in sync with extensions::LaunchType.
Used in:
PINNED = 0
REGULAR = 1
FULLSCREEN = 2
WINDOW = 3
message
arc_package_specifics.proto:22Properties of arc package objects.
Used in:
optional string package_name = 1
Unique identifier for the item: Android package name.
optional int32 package_version = 2
Android package version.
optional int64 last_backup_android_id = 3
Last Android id generated when Android side backups data.
optional int64 last_backup_time = 4
Last time internal value that Android side backups data.
message
experiments_specifics.proto:35Whether this client should cull (delete) expired autofill entries when autofill sync is enabled.
Used in:
optional bool enabled = 1
Next tag: 11
Used in:
optional int64 id = 1
The id for this offer data. Will be used as the client tag.
optional string offer_details_url = 2
The link leading to the offer details page on Gpay app. Will be populated on Android only.
repeated string merchant_domain = 3
Merchant domain and merchant app package name refers to the merchant this offer is applied to.
repeated string merchant_app_package = 4
optional int64 offer_expiry_date = 5
The expiry of this offer. Will be represented in the form of unix epoch time in seconds. Once the offer is expired it will not be shown in the client.
oneof type_specific_offer_data
The unique offer data for different offer types.
card_linked_offer_data = 6
promo_code_offer_data = 9
optional display_strings = 10
oneof reward_type
The reward type of the offer. Will be used to generate the display text in the UI. Each type has its own client side text template.
percentage_reward = 7
fixed_amount_reward = 8
Proto containing data specific to a card-linked offer.
Used in:
repeated int64 instrument_id = 3
The server id of the card to which the offer is linked.
Strings to be shown in client UI, based on the offer type and details.
Used in:
optional string value_prop_text = 1
A message translated in the user's GPay app locale, explaining the value of the offer. For example, a promo code offer might display "$5 off on shoes, up to $50."
optional string see_details_text_mobile = 2
A message translated in the user's GPay app locale and shown on mobile as a link, prompting the user to click it to learn more about the offer. Generally, "See details".
optional string see_details_text_desktop = 3
A message translated in the user's GPay app locale and shown on desktop (not as a link), informing the user that exclusions and restrictions may apply to the value prop text. Generally, "Terms apply."
optional string usage_instructions_text_mobile = 4
A message translated in the user's GPay app locale and shown on mobile, instructing them on how to redeem the offer. For example, a promo code offer might display "Tap the promo code field at checkout to autofill it."
optional string usage_instructions_text_desktop = 5
A message translated in the user's GPay app locale and shown on desktop, instructing them on how to redeem the offer. For example, a promo code offer might display "Click the promo code field at checkout to autofill it."
This value will be shown in the offer text template as "XXX$ off".
Used in:
optional string amount = 1
The string contains a number and a currency sign.
This value will be shown in the offer text template as "XXX% cashback". Percentage has a range of (0, 100].
Used in:
optional string percentage = 1
The string contains a number and a percent sign.
Proto containing data specific to a promo code offer.
Used in:
optional string promo_code = 1
The actual promo code which can be applied at checkout.
message
autofill_specifics.proto:24An AutofillProfile.
Used in: ,
optional string guid = 15
optional string deprecated_origin = 16
Starting from M115, Autofill ignores the origin and doesn't distinguish between verified (meaning `deprecated_origin == kSettingsOrigin`) and unverified profiles anymore. However, clients prior to this milestone only accept updates to verified profiles through Sync if the remote profile is verified as well. For this reason, M115 clients and above always set the origin to kSettingsOrigin. TODO(crbug.com/1441905): Remove in a few milestones.
optional int64 use_count = 22
optional int64 use_date = 23
The time_t value of the last time this profile was used. This value makes sense wrt base::Time::To/FromTimeT, which measures from the Windows epoch.
optional string profile_label = 62
A user chosen profile label that is used to identify the profile. The value of the label can be freely chosen by the user. Two possible label values are '$HOME$' or '$WORK$' which have a special meaning.
repeated string name_first = 2
Contact info name fields.
repeated string name_middle = 3
repeated string name_last = 4
repeated string name_last_first = 27
Sometimes the last name is composed of two names as it is common for Hispanic/Latinx names. In the unstructured representation of the last name, there may be even a conjunction between the first and the second last name. For example, the more-complete version of Pablo Picasso's surname is "Ruiz y Picasso" containing a first last name, a conjunction (the y) and a second last name.
repeated string name_last_conjunction = 28
repeated string name_last_second = 29
repeated string name_full = 21
repeated AutofillProfileSpecifics.VerificationStatus name_first_status = 31
repeated AutofillProfileSpecifics.VerificationStatus name_middle_status = 32
repeated AutofillProfileSpecifics.VerificationStatus name_last_status = 33
repeated AutofillProfileSpecifics.VerificationStatus name_last_first_status = 34
repeated AutofillProfileSpecifics.VerificationStatus name_last_conjunction_status = 35
repeated AutofillProfileSpecifics.VerificationStatus name_last_second_status = 36
repeated AutofillProfileSpecifics.VerificationStatus name_full_status = 37
repeated string email_address = 5
Contact info additional fields.
optional string company_name = 6
optional string address_home_line1 = 7
Address field. The address_home_line1/2 fields are deprecated and address_home_street_address should be used instead by joining address_home_line1/2 with a newline ("\n"). Full deprecation can not be achieved before all sync profiles have been updated with a M86+ client. TODO(crbug/1111740): Remove usages of address_home_line1/2 and mark field as deprecated.
optional string address_home_line2 = 8
optional string address_home_city = 9
optional string address_home_state = 10
optional string address_home_zip = 11
optional string address_home_country = 12
optional string address_home_admin_level_2 = 71
optional string address_home_street_address = 17
Additional address fields for i18n.
optional string address_home_sorting_code = 18
optional string address_home_dependent_locality = 19
optional string address_home_language_code = 20
optional string address_home_thoroughfare_name = 38
optional string address_home_thoroughfare_number = 39
optional string address_home_street_location = 73
optional string address_home_subpremise_name = 42
optional string address_home_apt = 85
All the information related to the apartment. Normally a combination of the apartment type (address_home_apt_type) and number (address_home_apt_num). E.g. "Apt 5".
optional string address_home_apt_num = 56
The raw number (or identifier) of an apartment (e.g. "5") but without a prefix. The value "apt 5" would correspond to the address_home_apt.
optional string address_home_apt_type = 87
Information describing the type of apartment (e.g. Apt, Apartamento, Sala, Departamento).
optional string address_home_floor = 57
optional string address_home_landmark = 67
optional string address_home_between_streets = 69
The type indicates that the address is at the intersection between two streets. This is a common way of writing addresses in Mexico.
optional string address_home_between_streets_1 = 77
The meaning of the field is similar to address_home_between_streets. The type should be used for "Entre calle 1" in MX addresses which also contain the "Entre calle 2" field.
optional string address_home_between_streets_2 = 79
The meaning of the field is similar to address_home_between_streets. The type should be used for "Entre calle 2" in MX addresses which also contain the "Entre calle 1" field.
optional string address_home_overflow = 75
optional string address_home_between_streets_or_landmark = 81
Combination of types address_home_between_streets or address_home_landmark. Note that some address forms require the combination of both in a single field as opposed to each one separately.
optional string address_home_overflow_and_landmark = 83
Combination of types address_home_overflow and address_home_landmark. Note that some address forms require the combination of both in a single field as opposed to each one separately.
optional string address_home_street_location_and_locality = 89
Combination of types address_home_street_location and address_home_dependent_locality. Note that some address forms require the combination of both in a single field as opposed to each one separately.
optional AutofillProfileSpecifics.VerificationStatus address_home_city_status = 43
Validation status records for address fields.
optional AutofillProfileSpecifics.VerificationStatus address_home_state_status = 44
optional AutofillProfileSpecifics.VerificationStatus address_home_zip_status = 45
optional AutofillProfileSpecifics.VerificationStatus address_home_country_status = 46
optional AutofillProfileSpecifics.VerificationStatus address_home_landmark_status = 68
optional AutofillProfileSpecifics.VerificationStatus address_home_between_streets_status = 70
optional AutofillProfileSpecifics.VerificationStatus address_home_between_streets_1_status = 78
optional AutofillProfileSpecifics.VerificationStatus address_home_between_streets_2_status = 80
optional AutofillProfileSpecifics.VerificationStatus address_home_admin_level_2_status = 72
optional AutofillProfileSpecifics.VerificationStatus address_home_overflow_status = 76
optional AutofillProfileSpecifics.VerificationStatus address_home_between_streets_or_landmark_status = 82
optional AutofillProfileSpecifics.VerificationStatus address_home_overflow_and_landmark_status = 84
optional AutofillProfileSpecifics.VerificationStatus address_home_street_location_and_locality_status = 90
optional AutofillProfileSpecifics.VerificationStatus address_home_street_address_status = 47
optional AutofillProfileSpecifics.VerificationStatus address_home_sorting_code_status = 48
optional AutofillProfileSpecifics.VerificationStatus address_home_dependent_locality_status = 49
optional AutofillProfileSpecifics.VerificationStatus address_home_language_code_status = 50
optional AutofillProfileSpecifics.VerificationStatus address_home_thoroughfare_name_status = 51
optional AutofillProfileSpecifics.VerificationStatus address_home_thoroughfare_number_status = 52
optional AutofillProfileSpecifics.VerificationStatus address_home_street_location_status = 74
optional AutofillProfileSpecifics.VerificationStatus address_home_subpremise_name_status = 55
optional AutofillProfileSpecifics.VerificationStatus address_home_apt_status = 86
optional AutofillProfileSpecifics.VerificationStatus address_home_apt_num_status = 58
optional AutofillProfileSpecifics.VerificationStatus address_home_apt_type_status = 88
optional AutofillProfileSpecifics.VerificationStatus address_home_floor_status = 59
repeated string phone_home_whole_number = 13
Phone.
optional string deprecated_label = 1
Deprecated.
optional string phone_fax_whole_number = 14
optional int64 validity_state_bitfield = 24
The following validity-related fields have only been used in combination with an experimental features that are disabled for all clients and have been removed in M100.
optional bool is_client_validity_states_updated = 25
Represents the validation status of value stored in the AutofillProfile.
Used in:
VERIFICATION_STATUS_UNSPECIFIED = 0
No verification status assigned.
PARSED = 1
The value token was parsed from a parent token. For example, the first name was derived by splitting a full name into its components.
FORMATTED = 2
Value was built from its subcomponents. For example, the full name was built from the first, middle and last name.
OBSERVED = 3
The value was observed in a form transmission. For example, the user filled a form that contained at NAME_FULL field. The value of NAME_FULL will be stored as OBSERVED.
USER_VERIFIED = 4
The user used the autofill settings to verify and store this token. This is currently only applicable to the full name, since users cannot edit individual components of their name.
SERVER_PARSED = 5
The token was parsed remotely.
message
autofill_specifics.proto:232Used in:
optional string name = 1
If any of these 3 fields are present, then all 3 should be, and it implies that this entity represents a classic autofill object. In this case, none of the autofill++ objects below should be present.
optional string value = 2
repeated int64 usage_timestamp = 3
optional profile = 4
An autofill++ profile object. If present, indicates this entity represents an AutofillProfile exclusively, and no other fields (such as name/value or credit_card) should be present.
Autofill wallet data which stores the relevant card credential data.
Used in:
optional string instrument_id = 1
A server-generated unique ID for the instrument/card.
optional string cvc = 2
A 3 or 4 digit card verification code.
optional int64 last_updated_time_unix_epoch_millis = 3
The timestamp of the last update. Used to determine data freshness.
message
autofill_specifics.proto:589Used in:
optional AutofillWalletSpecifics.WalletInfoType type = 1
optional masked_card = 2
This field exists if and only if the "type" field equals to MASKED_CREDIT_CARD.
optional address = 3
Unused by the client since M121. This field exists if and only if the `type` equals POSTAL_ADDRESS. TODO(crbug.com/1457187): Some server-side code still relies on this field. To keep the protos in sync, it is kept until that code is cleaned up.
optional customer_data = 4
This field exists if and only if the "type" field equals to CUSTOMER_DATA.
optional cloud_token_data = 5
This field exists if and only if the "type" field equals to CREDIT_CARD_CLOUD_TOKEN_DATA.
optional payment_instrument = 6
This field exists if and only if the "type" field equals to PAYMENT_INSTRUMENT.
optional masked_iban = 7
This field exists if and only if the `type` field equals to MASKED_IBAN.
Used in:
UNKNOWN = 0
MASKED_CREDIT_CARD = 1
POSTAL_ADDRESS = 2
POSTAL_ADDRESS is unused by the client since M121.
CUSTOMER_DATA = 3
CREDIT_CARD_CLOUD_TOKEN_DATA = 4
PAYMENT_INSTRUMENT = 5
MASKED_IBAN = 6
Used in:
optional string guid = 1
A unique ID identifying this item. Used as the client tag.
oneof usage_data_type
The type of usage data this entity is associated with.
virtual_card_usage_data = 2
Used in:
optional int64 instrument_id = 1
The instrument id of the actual card that the virtual card is related to.
optional string virtual_card_last_four = 2
The last four of the virtual card number. This is tied to the usage data because the virtual card number may vary depending on merchants.
optional string merchant_url = 3
The url of the merchant where the virtual card is used.
optional string merchant_app_package = 4
The merchant the usage data is related to on the Android platform.
message
autofill_specifics.proto:569Details of a bank account required to show it in the payment instrument selector.
Used in:
optional string bank_name = 1
The name of the bank where the user has an account.
optional string account_number_suffix = 2
The last four digits of the account number to help the user identify their account.
optional BankAccountDetails.AccountType account_type = 3
The type of bank account.
Used in:
ACCOUNT_TYPE_UNSPECIFIED = 0
CHECKING = 1
SAVINGS = 2
CURRENT = 3
SALARY = 4
TRANSACTING_ACCOUNT = 5
message
bookmark_model_metadata.proto:20Corresponds to a single bookmark id/metadata pair.
Used in:
optional int64 id = 1
Bookmark local id.
optional metadata = 2
Bookmarks sync metadata.
message
bookmark_model_metadata.proto:30Sync proto to carry the sync metadata for the bookmarks model. It is used for persisting and loading sync metadata from disk.
optional model_type_state = 1
Bookmark global metadata.
repeated bookmarks_metadata = 2
A set of all bookmarks metadata.
optional bool bookmarks_hierarchy_fields_reuploaded = 6
Indicates whether the reupload of bookmarks has been triggered such that they include fields like |type|, |unique_position| and |parent_guid|, which means that their sequence number has been increased (independently of whether the commit has succeeded or even started). TODO(crbug.com/1232951): remove this code when most of bookmarks are reuploaded.
optional int64 num_ignored_updates_due_to_missing_parent = 7
Number of remote updates that were ignored because the parent folder could not be determined since sync (bookmark sync) started (since initial sync, including initial sync itself). Note that this excludes updates representing changes (moves) to existing/tracked bookmarks (i.e. the parent folder used to be known, but the new one specified in the update isn't). Only a minority of users should have a non-zero value, due to a) corrupt data, reasons unknown; or b) permanent folders that were unsupported at the time the update was received (either for the permanent folder itself or for descendants). The absence of this field should be interpreted as 'unknown', which roughly means the counter wasn't supported by the browser -M77 or below- at the time sync was enabled (it also means, it will remain 'unknown' until initial sync is exercised, e.g. sync disabled and reenabled).
optional int64 max_version_among_ignored_updates_due_to_missing_parent = 8
See field above. Among such ignored updates, this field tracks which was the highest server version. This may be useful -in the future- to get a sense of "time" (or, since versions are opaque to the client, at least a notion of ordering with respect to other updates). The absence of this field should be interpreted as 'unknown' and does not distinguish the case between a) no updates ignored; and b) field wasn't supported at the time the last update was ignored. To distinguish between these two, the field above can be used.
optional bool last_initial_merge_remote_updates_exceeded_limit = 9
Indicates whether the count of remote updates during the latest initial merge exceeded the bookmark limit. This field is mutually exclusive to all the other fields and is managed completely by the processor.
message
bookmark_specifics.proto:30Properties of bookmark sync objects.
Used in:
optional string url = 1
URL of the bookmarked page (unset for folders).
optional bytes favicon = 2
PNG-encoded content of the favicon image (in practice 16x16, as determined by |kFaviconSize|). Empty if the bookmark has no favicon (which includes bookmark folders).
optional string legacy_canonicalized_title = 3
Contains legacy title which is truncated and may contain escaped symbols.
optional int64 creation_time_us = 4
Corresponds to BookmarkNode::date_added() represented as microseconds since the Windows epoch.
optional string icon_url = 5
The URL of the favicon image encoded in field |favicon|. Note that there are various cases where this URL may be missing (field unset or empty) even if the |favicon| field (image content) is populated: 1. WebUI pages such as "chrome://bookmarks/" are missing a favicon URL but they have a favicon. 2. Data generated by ancient clients (prior to M25) may not contain the favicon URL. 3. If the favicon URL is too large (determined by |kMaxFaviconUrlSize|) it may be omitted by clients to avoid running into the max-entity-size limit. Most notably, this includes URLs prefixed with the data: scheme that may encode the image content itself in the URL.
repeated meta_info = 6
optional string guid = 10
Introduced in M81, it represents a globally unique and immutable ID. If present, it must be the same as originator_client_item_id in lowercase, unless originator client item ID is not a valid GUID. In such cases (which is the case for bookmarks created before 2015), this GUID must match the value inferred from the combination of originator cache GUID and originator client item ID, see InferGuidForLegacyBookmark(). If not present, the value can be safely inferred using the very same methods listed above.
optional string full_title = 11
Contains full title as is. |legacy_canonicalized_title| is a prefix of |full_title| with escaped symbols.
optional string parent_guid = 14
Introduced in M94, represents the GUID (field |guid|) of the parent.
optional BookmarkSpecifics.Type type = 15
optional unique_position = 16
Introduced in M94, determines ordering among siblings. This field is redundant to the similar field in SyncEntity. If this field in specifics is set, it takes precedence over the one in SyncEntity.
optional int64 last_used_time_us = 17
Introduced in M106, corresponds to BookmarkNode::date_last_used() represented as microseconds since the Windows epoch.
Introduced in M94, determines whether this entity represents a bookmark folder. This field is redundant to the similar field in SyncEntity. If this field in specifics is set, it takes precedence over the one in SyncEntity.
Used in:
UNSPECIFIED = 0
|UNSPECIFIED| is relevant only for the case where the field is not set. M94 and above should not use this value.
URL = 1
FOLDER = 2
Used in:
optional bool is_self_delete_supported = 1
message
autofill_specifics.proto:272Next id: 8
Used in:
optional string benefit_id = 7
The unique identifier of the benefit. Generated originally in Chrome Sync server.
optional string benefit_description = 1
The benefit description (Engligh only currently) to be shown in the UI.
optional int64 start_time_unix_epoch_milliseconds = 2
When the benefit should be displayed, in UTC time.
optional int64 end_time_unix_epoch_milliseconds = 3
oneof DomainSpecificBenefit
Proto data representing the actual data of the credit card benefit, depending on the benefit type.
flat_rate_benefit = 4
category_benefit = 5
merchant_benefit = 6
message
autofill_specifics.proto:302Proto containing data specific to a category benefit.
Used in:
optional CategoryBenefitType category_benefit_type = 1
The type of category purchases the benefit is eligible on.
For category benefits, represents the category of purchases that the benefit can be applied to.
Used in:
CATEGORY_BENEFIT_TYPE_UNKNOWN = 0
SUBSCRIPTION = 1
FLIGHTS = 2
DINING = 3
ENTERTAINMENT = 4
STREAMING = 5
GROCERY_STORES = 6
message
autofill_specifics.proto:287Proto containing data specific to a flat rate benefit. Empty as flat rate benefits don't have unique fields. The actual benefit (e.g. "2% cash back") is already included in the `benefit_description`.
Used in:
(message has no fields)
message
autofill_specifics.proto:308Proto containing data specific to a merchant benefit.
Used in:
repeated string merchant_domain = 1
The merchant domain that the benefit is eligible on. Example: https://www.acme.com
message
autofill_specifics.proto:323Used in:
optional CardIssuer.Issuer issuer = 1
optional string issuer_id = 2
Uniquely identifies the issuer of the card. This field is required when Issuer is EXTERNAL_ISSUER. Example: capitalone, amex.
Used in:
ISSUER_UNKNOWN = 0
GOOGLE = 1
Card where the issuer is Google.
EXTERNAL_ISSUER = 2
Card where the issuer is external.
message
sync.proto:242The client must preserve, store, and resend the chip bag with every request. The server depends on the chip bag in order to precisely choreograph a client-server state machines. Because the client stores and sends this data on every request, the contents of the chip bag should be kept relatively small. If the server does not return a chip bag, the client must assume that there has been no change to the chip bag. The client must resend the bag of chips it had prior on the next request. The client must make the chip bag durable if and only if it processes the response from the server.
Used in: ,
optional bytes server_chips = 1
Server chips are deliberately oqaque, allowing the server to encapsulate its state machine logic.
message
device_info_specifics.proto:218Used in:
optional string version_number = 1
Version number as per https://www.chromium.org/developers/version-numbers.
message
sync.proto:35This message contains diagnostic information used to correlate commit-related traffic with extensions-related mutations to the data models in chromium. It plays no functional role in processing this CommitMessage.
Used in:
optional string extension_id = 1
The human-readable ID identifying the extension responsible for the traffic reported in this ChromiumExtensionsActivity.
optional uint32 bookmark_writes_since_last_commit = 2
How many times the extension successfully invoked a write operation through the bookmarks API since the last CommitMessage.
message
sync.proto:218Message from a client asking the server to clear its data. This causes the server to generate a new store birthday, which allows dealing reliably with in-flight requests (in particular commits) from other clients.
No arguments needed as the store birthday and user identifier are part of an enclosing message.
Used in:
(message has no fields)
message
sync.proto:224Response to a ClearServerData request.
No result fields necessary. Success/failure is indicated in ClientToServerResponse.
Used in:
(message has no fields)
message
client_commands.proto:26Used in:
optional int32 set_sync_poll_interval = 1
Time to wait before sending any requests to the server.
in seconds
optional int32 set_sync_long_poll_interval = 2
This has been deprecated since M75.
optional int32 max_commit_batch_size = 3
optional int32 throttle_delay_seconds = 5
Number of seconds to delay before the throttled client should retry.
optional int32 client_invalidation_hint_buffer_size = 6
This has been deprecated since M109.
optional int32 gu_retry_delay_seconds = 7
Time to wait before issuing a retry GU.
repeated custom_nudge_delays = 8
A dictionary of custom nudge delays.
optional int32 extension_types_max_tokens = 9
Configuration for commit quota of extension-related data types. The maximum count of tokens (=initial at browser startup) and the interval for refilling one more token if not at maximum.
optional int32 extension_types_refill_interval_seconds = 10
optional int32 extension_types_depleted_quota_nudge_delay_seconds = 11
Extended nudge delay for data types with depleted quota.
message
sync.proto:46Client specific configuration information.
Used in:
repeated int32 enabled_type_ids = 1
The set of data types this client has enabled. Note that this does not include proxy types, as they do not have protocol field numbers and are placeholder types that implicitly enable protocol types.
optional bool tabs_datatype_enabled = 2
Whether the PROXY_TABS proxy datatype is enabled on this client. Deprecated and not populated anymore since M120.
optional bool cookie_jar_mismatch = 3
Whether the account(s) present in the content area's cookie jar match the chrome account. If multiple accounts are present in the cookie jar, a mismatch implies all of them are different from the chrome account.
optional bool single_client = 4
Indicates that the client is not aware of any other active clients interested in the committed data types. This flag shows that it is not necessary to send invalidations for the committed data. A client is considered active if it's DeviceInfo has updated recent enough. This flag does not take into account whether standalone invalidations are enabled (as opposed to |single_client_with_standalone_invalidations|). However, it's set depending on interested data types of other devices, e.g. if there are other devices but they are not interested in SESSION data type, and current commit request contains only SESSION, it will be set to true. Introduced in M88.
repeated string devices_fcm_registration_tokens = 5
A list of FCM registration tokens which are obtained from other clients. This list is used by the server to send invalidations to all other clients. If the list is empty, the server should treat this as "there is no information about other clients". In practice, this happens by the next causes: 1. This is the old client which doesn't set this field. 2. There are too many active devices and the list would have too many items. 3. An empty list could also mean that the current client is the only client. This case should be covered by the |single_client_with_standalone_invalidations| field instead (otherwise it could be mixed up with older clients). The server doesn't have to use this field and can ignore it. Note that this list does not take into account interested data types from the other clients. Introduced in M89.
optional bool single_client_with_standalone_invalidations = 6
Similar to |single_client| but takes into account only clients with enabled sync standalone invalidations. When set to true, there are no other clients with sync standalone invalidations interested in the committing types and hence it's not necessary to send out standalone invalidations (it may still be necessary to send out invalidations using the legacy system, see |single_client| instead). Introduced in M105.
repeated string fcm_registration_tokens_for_interested_clients = 7
Similar to |devices_fcm_registration_tokens| but takes into account clients which are subscribed to the data types which are committed in current commit request. A list of FCM registration tokens which are obtained from other clients. This list is used by the server to send invalidations to all other clients. If the list is empty, the server should treat this as "there is no information about other clients". In practice, this happens by the next causes: 1. This is the old client which doesn't set this field. 2. There are too many active devices and the list would have too many items. 3. An empty list could also mean that the current client is the only client. This case should be covered by the |single_client_with_standalone_invalidations| field instead (otherwise it could be mixed up with older clients). The server doesn't have to use this field and can ignore it. Introduced in M105.
optional bool single_client_with_old_invalidations = 8
Similar to |single_client| but takes into account only clients which are subscribed to old invalidations (i.e. not subscribed to sync standalone invalidations). When set to true, there are no other clients subscribed to old invalidations. Note that opposed to |single_client|, this flag does not always take into account the list of interested data types (because interested data types were introduced in M89). When the list is empty, a client is considered to be subscribed to all data types. Note that "single client" is a bit misleading since this will also be true if there are no clients with old invalidations at all. Introduced in M110.
message
sync.proto:249Information about the syncer's state.
Used in:
optional bool hierarchy_conflict_detected = 1
Flag to indicate if the client has detected hierarchy conflcits. The flag is left unset if update application has not been attempted yet. The server should attempt to resolve any hierarchy conflicts when this flag is set. The client may not assume that any particular action will be taken. There is no guarantee the problem will be addressed in a reasonable amount of time. TODO(crbug.com/1315573): Deprecated in M103.
optional bool is_sync_feature_enabled = 2
Whether the client has full sync (or, sync the feature) enabled or not.
message
sync.proto:264required string share = 1
|share| field is only used on the server for logging and can sometimes contain empty string. It is still useful for logging username when it can't be derived from access token in case of auth error.
optional int32 protocol_version = 2
required ClientToServerMessage.Contents message_contents = 3
Each ClientToServerMessage contains one request defined by the message_contents. Each type has a corresponding message field that will be present iff the message is of that type. E.g. a commit message will have a message_contents of COMMIT and its commit field will be present.
optional commit = 4
optional get_updates = 5
optional string store_birthday = 7
Opaque server-provided ID representing an "epoch" of the server-side data. Clients must hand this opaque ID back to the server as part of all requests within the same sync session (i.e. for all requests to the server except the very first GetUpdates request). See analogous field ClientToServerResponse.store_birthday for more details about its lifetime.
optional debug_info = 10
Client side state information for debugging purpose. This is only sent on the first getupdates of every sync cycle, as an optimization to save bandwidth.
optional bag_of_chips = 11
Per-client state for use by the server. Sent with every message sent to the server.
optional string api_key = 12
Google API key.
optional client_status = 13
Client's self-reported state. The client should set this on every message sent to the server, though its member fields may often be unset.
optional string invalidator_client_id = 14
The ID that our invalidation client used to identify itself to the server. Sending the ID here allows the server to not send notifications of our own changes to our invalidator. The field was deprecated in M117 and is no longer populated.
optional clear_server_data = 15
Identifies this ClientToServerMessage as a clear server data request. This field is present when message_contents is CLEAR_SERVER_DATA.
Used in:
COMMIT = 1
GET_UPDATES = 2
DEPRECATED_3 = 3
DEPRECATED_4 = 4
CLEAR_SERVER_DATA = 5
message
sync.proto:421optional commit = 1
optional get_updates = 2
optional SyncEnums.ErrorType error_code = 4
Up until protocol_version 24, the default was SUCCESS which made it impossible to add new enum values since older clients would parse any out-of-range value as SUCCESS. Starting with 25, unless explicitly set, the error_code will be UNKNOWN so that clients know when they're out-of-date. Note also that when using protocol_version < 25, TRANSIENT_ERROR is not supported. Instead, the server sends back a HTTP 400 error code. This is deprecated now.
optional string error_message = 5
optional string store_birthday = 6
Opaque server-provided ID representing an "epoch" of the server-side data, referred to as "birthday" or "store birthday". This ID remains fixed until server-side data gets cleared/reset (e.g. via ClearServerDataMessage), which clients experience as NOT_MY_BIRTHDAY error, and involves clearing all local sync metadata including the cached store birthday. This mechanism allows the server to implement clear-data/reset functionality that reliably identifies and deletes sync entities uploaded before the clear-data/reset event (e.g. via ClearServerDataMessage). Furthermore, it allows the server to deal reliably with in-flight changes from other clients upon clear-data event, because all writes issued with an outdated birthday (which in-flight writes would use) can be detected by the server.
optional client_command = 7
repeated int32 migrated_data_type_id = 12
The data types whose storage has been migrated. Present when the value of error_code is MIGRATION_DONE.
optional error = 13
optional new_bag_of_chips = 14
The new per-client state for this client. If set, should be persisted and sent with any subsequent ClientToServerMessages.
optional clear_server_data = 15
Present if this ClientToServerResponse is in response to a ClearServerData request.
message
sync.proto:465Used in:
optional SyncEnums.ErrorType error_type = 1
optional string error_description = 2
optional SyncEnums.Action action = 4
repeated int32 error_data_type_ids = 5
Currently meaningful if |error_type| is throttled or partial_failure. In the throttled case, if this field is absent then the whole client (all datatypes) is throttled. In the partial_failure case, this field denotes partial failures. The client should retry those datatypes with exponential backoff.
message
autofill_specifics.proto:253TODO(crbug.com/1020740): Deprecated, remove this once dependent change is done. Use WalletCreditCardCloudTokenData instead.
Used in:
optional string suffix = 1
Last 4-5 digits of the Cloud Primary Account Number (CPAN).
optional int32 exp_month = 2
CPAN Month number 1-12.
optional int32 exp_year = 3
CPAN Four-digit year (e.g. 2017).
optional string art_fife_url = 4
URL of the card art to be displayed for CPAN.
optional string instrument_token = 5
Opaque identifier for the cloud token associated with the payment instrument.
Special sync datatype to notify client about People Group changes.
Used in:
optional string collaboration_id = 1
Unique identifier for a collaboration group, also known as `group_id` or `group_name`.
optional int64 last_updated_timestamp_millis_since_unix_epoch = 2
Indicates staleness of the collaboration group, used to determine whether client should refresh cached group. Server-side derived from group `consistency_token`.
message
sync.proto:131Used in:
repeated entries = 1
optional string cache_guid = 2
A GUID that identifies the committing sync client. This value will be returned as originator_cache_guid for any new items.
repeated extensions_activity = 3
optional config_params = 4
The configuration of this client at commit time. Used by the server to make commit-time decisions about how to process datatypes that might involve server-side interaction, and e.g require explicit user intent for syncing a particular data type regardless of whether a commit for that datatype is currently being sent up.
repeated client_contexts = 5
Set of optional per-client datatype contexts.
optional string padding = 6
This field need to be 256 bytes if set. This attempts to mitigate CRIME attacks when sync communicate from client to server with compression. So if compression is used, this need to set a 256 random ASCII bytes. If no compression, this field should not be set. The server can ignore the padding.
message
sync.proto:328Used in:
repeated group sync_pb.CommitResponse.EntryResponse = 1
message
sync.proto:339Used in:
required ResponseType response_type = 2
optional string id_string = 3
Sync servers may also return a new ID for an existing item, indicating a new entry's been created to hold the data the client's sending up.
optional int64 version = 6
The item's current version.
optional string error_message = 9
optional int64 mtime = 10
Last modification time (in milliseconds since Unix epoch). Allows the server to override the client-supplied mtime during a commit operation. TODO(crbug.com/1182252): Delete this field too.
optional datatype_specific_error = 11
Datatype specific error (if any).
message
sync.proto:368Used in:
oneof datatype_error
sharing_message_error = 1
outgoing_password_sharing_invitation_error = 2
Used in:
SUCCESS = 1
CONFLICT = 2
You're out of date; update and check your data
RETRY = 3
TODO(ncarter): What's the difference between RETRY and TRANSIENT_ERROR?
Someone has a conflicting, non-expired session open
INVALID_MESSAGE = 4
What the client sent was invalid, and trying again
OVER_QUOTA = 5
won't help.
This operation would put you, or you are, over quota
TRANSIENT_ERROR = 6
Something went wrong; try again in a bit
message
compare_specifics.proto:22A Compare sync entity, containing sufficient data to enable all data acquisition for rendering the Compare experience.
Used in:
optional string uuid = 1
The primary key for local storage.
optional int64 creation_time_unix_epoch_micros = 2
Tracks when this entity was created.
optional int64 update_time_unix_epoch_micros = 3
Tracks when this entity was last modified.
optional string name = 4
The name of the comparison group.
repeated data = 5
The list of product URLs that constitute this comparison group.
message
compare_specifics.proto:39Used in:
optional string url = 1
The URL of the item in the comparison.
message
contact_info_specifics.proto:19Used in:
optional string guid = 1
A globally unique, immutable UUID represented in lowercase.
optional int64 use_count = 3
The number of time this profile has been used.
optional int64 use_date_unix_epoch_seconds = 4
The last time this profile was used.
optional int64 date_modified_unix_epoch_seconds = 37
The last time the profile was modified.
optional string language_code = 38
The BCP 47 language code used to format the address for display.
optional string profile_label = 5
A user chosen profile label that is used to identify the profile. The value of the label can be freely chosen by the user.
optional int32 initial_creator_id = 39
Tracks the application that initially created the profile. The integer represents a value in the server-side enum `BillableService`. A value of 70073 represents Chrome (enum value BILLABLE_SERVICE_CHROME_PAYMENTS).
optional int32 last_modifier_id = 40
Tracks the application that applied the last modification to the non-metadata content of the profile. It represents a value in the same `BillableService` enum. All StringTokens, and the `profile_label` are considered non-metadata.
optional name_first = 7
Contact info name fields.
optional name_middle = 8
optional name_last = 9
optional name_last_first = 10
Sometimes the last name is composed of two names as it is common for Hispanic/Latinx names. In the unstructured representation of the last name, there may be even a conjunction between the first and the second last name. For example, the more-complete version of Pablo Picasso's surname is "Ruiz y Picasso" containing a first last name, a conjunction (the y) and a second last name.
optional name_last_conjunction = 11
optional name_last_second = 12
optional name_full = 13
optional email_address = 15
Contact info additional fields.
optional company_name = 16
optional address_city = 17
Address fields: These are user-provided values with no particular guarantees about their format.
optional address_state = 18
optional address_zip = 19
optional address_country = 20
optional address_admin_level_2 = 43
optional address_street_address = 21
Additional address fields for i18n. Includes all of the lines of a street address, including newlines, e.g. 123 Main Street, Apt. #42
optional address_sorting_code = 22
A sorting code is similar to a postal code. However, whereas a postal code normally refers to a single geographical location, a sorting code often does not. Instead, a sorting code is assigned to an organization, which might be geographically distributed. The most prominent example of a sorting code system is CEDEX in France.
optional address_dependent_locality = 23
A dependent locality is a subunit of a locality, where a "locality" is roughly equivalent to a city. Examples of dependent localities include inner-city districts and suburbs.
optional address_thoroughfare_name = 25
The street name of the address, without a house number.
optional address_thoroughfare_number = 26
The house number, which may be alphanumeric.
optional address_subpremise_name = 30
Contains the floor, staircase or apartment number within a building.
optional address_apt = 50
All the information related to the apartment. Normally a combination of the apartment type (address_apt_type) and number (address_apt_num). E.g. "Apt 5".
optional address_apt_num = 31
The apartment number within a building.
optional address_apt_type = 51
Information describing the type of apartment (e.g. Apt, Apartamento, Sala, Departamento).
optional address_floor = 32
The floor number within a building.
optional address_street_location = 44
Contains both the street and house number.
optional address_landmark = 41
optional address_overflow = 45
optional address_between_streets = 42
Indicates that the address is at the intersection between two streets. It is normally a combination of between_streets_1 and _2. This is a common way of writing addresses in Mexico.
optional address_between_streets_1 = 46
The meaning of the field is similar to address_between_streets. The type should be used for "Entre calle 1" in MX addresses which also contain the "Entre calle 2" field.
optional address_between_streets_2 = 47
The meaning of the field is similar to address_between_streets. The type should be used for "Entre calle 2" in MX addresses which also contain the "Entre calle 1" field.
optional address_between_streets_or_landmark = 48
Combination of types address_between_streets or address_landmark. Note that some address forms require the combination of both in a single field as opposed to each one separately.
optional address_overflow_and_landmark = 49
Combination of types address_overflow and address_landmark. Note that some address forms require the combination of both in a single field as opposed to each one separately.
optional address_street_location_and_locality = 52
Combination of types address_street_location and address_dependent_locality. Note that some address forms require the combination of both in a single field as opposed to each one separately.
optional phone_home_whole_number = 33
Phone.
message
contact_info_specifics.proto:44Used in:
optional uint32 type = 1
An `autofill::ProfileTokenQuality::ObservationType`. Represented as a uint32 to retain future enum values (since this is proto2). The `ObservationType`'s underlying type is uint8_t, but this is not supported by protos. Since the uint32 Proto type uses variable-length encoding, uint32 has a similar size as a single element byte[].
optional uint32 form_hash = 2
The `autofill::ProfileTokenQuality::FormSignatureHash` has type uint8_t. Like for `type`, this should have the (non-existing) data type uint8.
message
contact_info_specifics.proto:67A token with a string interpretation of the value.
Used in:
optional string value = 1
optional metadata = 2
message
contact_info_specifics.proto:57Metadata that is attached to every token type.
Used in:
optional VerificationStatus status = 1
repeated observations = 2
optional uint32 value_hash = 3
Stores a hash of the token value that this metadata is associated with. This is used by Autofill to detect changes of the token value by external integrators.
Represents the validation status of a stored value.
Used in:
VERIFICATION_STATUS_UNSPECIFIED = 0
No verification status assigned.
PARSED = 1
The value token was parsed from a parent token. For example, the first name was derived by splitting a full name into its components.
FORMATTED = 2
Value was built from its subcomponents. For example, the full name was built from the first, middle and last name.
OBSERVED = 3
The value was observed in a form transmission. For example, the user filled a form that contained at NAME_FULL field. The value of NAME_FULL will be stored as OBSERVED.
USER_VERIFIED = 4
The user used the settings UI to verify and store this token. This is currently only applicable to the full name, since users cannot edit individual components of their name.
SERVER_PARSED = 5
The token was parsed remotely.
message
nigori_local_data.proto:24Used in:
repeated private_key = 1
Asymmetric private-keys used for cross user sharing.
message
nigori_specifics.proto:32Used in: ,
optional int32 version = 1
The key version, used for key rotation.
optional bytes x25519_private_key = 2
Private key on Curve25519 (32 bytes).
message
nigori_specifics.proto:39Used in: , ,
optional int32 version = 1
The key version, used for key rotation and consensus.
optional bytes x25519_public_key = 2
Public key on Curve25519 (32 bytes).
message
nigori_local_data.proto:34Used in:
optional key_bag = 1
Contains all known Nigori keys.
optional string default_key_name = 2
Default key is the key, that should be used for encryption. Can be empty in case we have pending keys (waiting for explicit passphrase, or client didn't received keystore keys).
optional cross_user_sharing_keys = 3
Contains cross user sharing related keys.
message
client_commands.proto:21Used in:
optional int32 datatype_id = 1
Datatype id.
optional int32 delay_ms = 2
Delay in milliseconds.
message
nigori_local_data.proto:47Used in:
optional NigoriSpecifics.KeyDerivationMethod custom_passphrase_key_derivation_method = 1
Method used for deriving keys from custom passphrase.
optional string custom_passphrase_key_derivation_salt = 2
Salt used for the derivation of the key from the custom passphrase. Should be set iff custom_passphrase_key_derivation_method == SCRYPT_8192_8_11.
A single datatype's sync context. Allows the datatype to pass along datatype specific information with its own server backend.
Used in: , , ,
optional int32 data_type_id = 1
The type this context is associated with.
optional bytes context = 2
The context for the datatype.
optional int64 version = 3
The version of the context.
Used in: , ,
optional int32 data_type_id = 1
An integer identifying the data type whose progress is tracked by this marker. The legitimate values of this field correspond to the protobuf field numbers of all EntitySpecifics fields supported by the server. These values are externally declared in per-datatype .proto files.
optional bytes token = 2
An opaque-to-the-client sequence of bytes that the server may interpret as an indicator of the client's knowledge state. If this is empty or omitted by the client, it indicates that the client is initiating a a first-time sync of this datatype. Otherwise, clients must supply a value previously returned by the server in an earlier GetUpdatesResponse. These values are not comparable or generable on the client. The opaque semantics of this field are to afford server implementations some flexibility in implementing progress tracking. For instance, a server implementation built on top of a distributed storage service -- or multiple heterogenous such services -- might need to supply a vector of totally ordered monotonic update timestamps, rather than a single monotonically increasing value. Other optimizations may also be possible if the server is allowed to embed arbitrary information in the progress token. Server implementations should keep the size of these tokens relatively small, on the order of tens of bytes, and they should remain small regardless of the number of items synchronized. (A possible bad server implementation would be for progress_token to contain a list of all the items ever sent to the client. Servers shouldn't do this.)
optional get_update_triggers = 5
This field will be included only in GetUpdates with origin GU_TRIGGER.
optional gc_directive = 6
The garbage collection directive for this data type. The client should purge items locally based on this directive. Since this directive is designed to be sent from server only, the client should persist it locally as needed and avoid sending it to the server.
message
client_debug_info.proto:66Used in:
optional SyncEnums.SingletonDebugEventType singleton_event = 1
Each of the following fields correspond to different kinds of events. as a result, only one is set during any single DebugEventInfo. A singleton event. See enum definition.
optional sync_cycle_completed_event_info = 2
A sync cycle completed.
optional int32 nudging_datatype = 3
A datatype triggered a nudge.
repeated int32 datatypes_notified_from_server = 4
A notification triggered a nudge.
message
client_debug_info.proto:82Used in:
repeated events = 1
optional bool cryptographer_ready = 2
Whether cryptographer is ready to encrypt and decrypt data.
optional bool cryptographer_has_pending_keys = 3
Cryptographer has pending keys which indicates the correct passphrase has not been provided yet.
optional bool events_dropped = 4
Indicates client has dropped some events to save bandwidth.
message
device_info_specifics.proto:27Information about a device that is running a sync-enabled Chrome browser. We are mapping the per-client cache guid to more specific information about the device.
Used in:
optional string cache_guid = 1
The cache_guid created to identify a sync client on this device.
optional string client_name = 2
A non-unique but human readable name to describe this client.
optional SyncEnums.DeviceType device_type = 3
The platform of the device. Deprecated in M110, but still populated for backwards compatibility. Replaced by os_type + device_form_factor.
optional string sync_user_agent = 4
The UserAgent used when contacting the Chrome Sync server. Only present when talking to the HTTP server.
optional string chrome_version = 5
The Chrome instance's version. Updated (if necessary) on every startup. DEPRECATED in M92. Still populated for backward compatibility.
optional int64 deprecated_backup_timestamp = 6
Last time when pre-sync data on the device was saved. The device can be restored to state back to this time. In millisecond since UNIX epoch. DEPRECATED in M50.
optional string signin_scoped_device_id = 7
Device_id that is stable until user signs out. This device_id is used for annotating login scoped refresh token. Present only for Chrome Clients.
optional int64 last_updated_timestamp = 8
This field is updated to be the current time periodically, and is also set to the current time whenever another field changes. By examining the difference between this field and the current time, it should be possible to reason about the inactivity of any device that was syncing at one time.
optional feature_fields = 9
Device info fields that are specific to a feature. This is information that can not be derived from the other fields in the proto and are not general enough to be used by another feature.
optional sharing_fields = 10
Device specific information for Sharing feature.
optional string model = 11
Model of device.
optional string manufacturer = 12
Name of device manufacturer.
optional int32 pulse_interval_in_minutes = 13
The interval in minutes with which |last_updated_timestamp| is updated to the sync servers if online and while sync is actively running (e.g. excludes backgrounded apps on Android). Introduced in M81. The legacy default was 1 day.
optional invalidation_fields = 14
Device specific information for Sync invalidations.
optional paask_fields = 15
Information for contacting this device in order to perform security key operations.
optional string full_hardware_class = 16
Unique hardware identifier string which details the HW combination of a ChromeOS device. This field will be empty on other OS devices.
oneof client_version_info
Version information to pin-point which client implementation this is.
chrome_version_info = 17
google_play_services_version_info = 18
optional SyncEnums.OsType os_type = 19
The OS type the device.
optional SyncEnums.DeviceFormFactor device_form_factor = 20
The form factor of the device.
optional brave_fields = 1000
message
dictionary_specifics.proto:22Properties of Dictionary objects.
Used in:
optional string word = 1
A spelling which when typed is treated as a correctly spelled word.
message
entity_specifics.proto:189Used in:
(message has no fields)
message
encryption.proto:33Encrypted sync data consists of two parts: a key name and a blob. Key name is the name of the key that was used to encrypt blob and blob is encrypted data itself. The reason we need to keep track of the key name is that a sync user can change their passphrase (and thus their encryption key) at any time. When that happens, we make a best effort to reencrypt all nodes with the new passphrase, but since we don't have transactions on the server-side, we cannot guarantee that every node will be reencrypted. As a workaround, we keep track of all keys, assign each key a name (by using that key to encrypt a well known string) and keep track of which key was used to encrypt each node.
Used in: , , ,
optional string key_name = 1
optional string blob = 2
base64-encoded.
message
nigori_specifics.proto:46repeated key = 2
Used for encrypting data in the user's account.
repeated cross_user_sharing_private_key = 3
Used for encrypting/authenticating using Public-private cryptography primarily across user accounts, e.g. sharing invitations.
message
experiments_specifics.proto:57Flags for enabling the experimental enhanced bookmarks feature.
Used in:
optional bool enabled = 1
optional string extension_id = 2
message
entity_metadata.proto:23Sync proto to store entity metadata in model type storage.
Used in: ,
optional string client_tag_hash = 1
A hash based on the client tag and model type. Used for various map lookups. Should always be available. Sent to the server as SyncEntity::client_tag_hash.
optional string server_id = 2
The entity's server-assigned ID. Prior to the item's first commit, we leave this value as an empty string. The initial ID for a newly created item has to meet certain uniqueness requirements, and we handle those on the sync thread.
optional bool is_deleted = 3
Whether or not the entity is deleted.
optional int64 sequence_number = 4
A version number used to track in-progress commits. Each local change increments this number.
optional int64 acked_sequence_number = 5
The sequence number of the last item known to be successfully committed.
optional int64 server_version = 6
The server version on which this item is based. If there are no local changes, this is the version of the entity as we see it here. If there are local changes, this is the version of the entity on which those changes are based.
optional int64 creation_time = 7
Entity creation and modification timestamps. Assigned by the client and synced by the server, though the server usually doesn't bother to inspect their values. They are encoded as milliseconds since the Unix epoch.
optional int64 modification_time = 8
optional string specifics_hash = 9
A hash of the current entity specifics value. Used to detect whether entity's specifics value has changed without having to keep specifics in memory.
optional string base_specifics_hash = 10
A hash of the last specifics known by both the client and server. Used to detect when local commits and remote updates are just for encryption. This value will be the empty string only in the following cases: the entity is in sync with the server, has never been synced, or is deleted.
optional unique_position = 11
Used for positioning entities among their siblings. Relevant only for data types that support positions (e.g bookmarks). Refer to its definition in unique_position.proto for more information about its internal representation.
optional fixed32 bookmark_favicon_hash = 12
Used only for bookmarks. It's analogous to |specifics_hash| but it exclusively hashes the content of the favicon image, as represented in proto field BookmarkSpecifics.favicon, using base::PersistentHash().
optional possibly_trimmed_base_specifics = 13
Last specifics known by both the client and server. Used during commits to the server in order to prevent data loss caused by older clients dealing with unknown proto fields (fields that were introduced later). Datatypes (ModelTypeSyncBridge) may implement logic to trim down (or fully clear) this proto prior to caching, to avoid the memory and I/O overhead of dealing with an extra copy of the data. Introduced in M101.
optional string deleted_by_version = 14
If the entity is deleted, this field will record the chromium version (e.g. 117.0.5875.1) that originated the deletion. Introduced in M117.
optional collaboration = 15
message
entity_metadata.proto:98Metadata used for shared data types. Must not be present for regular data types. Introduced in M124.
Used in:
optional string collaboration_id = 1
Collaboration ID which the current entity belongs to.
message
entity_specifics.proto:70Used in: , ,
optional encrypted = 1
If a datatype is encrypted, this field will contain the encrypted original EntitySpecifics. The extension for the datatype will continue to exist, but contain only the default values. Note that currently passwords employ their own legacy encryption scheme and do not use this field.
oneof specifics_variant
autofill = 31729
bookmark = 32904
preference = 37702
typed_url = 40781
theme = 41210
password = 45873
nigori = 47745
extension = 48119
app = 48364
session = 50119
autofill_profile = 63951
search_engine = 88610
extension_setting = 96159
app_setting = 103656
history_delete_directive = 150251
device_info = 154522
priority_preference = 163425
dictionary = 170540
managed_user_setting = 186662
app_list = 229170
autofill_wallet = 306270
wallet_metadata = 330441
arc_package = 340906
printer = 410745
reading_list = 411028
user_event = 455206
user_consent = 556014
send_tab_to_self = 601980
security_event = 600372
web_apk = 1117170
web_app = 673225
wifi_configuration = 662827
os_preference = 702141
os_priority_preference = 703915
sharing_message = 728866
autofill_offer = 774329
workspace_desk = 874841
webauthn_credential = 895275
history = 963985
printers_authorization_server = 974304
saved_tab_group = 1004874
autofill_wallet_usage = 1033580
contact_info = 1034378
segmentation = 1026052
power_bookmark = 1073150
incoming_password_sharing_invitation = 1141935
outgoing_password_sharing_invitation = 1142081
autofill_wallet_credential = 1164238
shared_tab_group_data = 1239418
collaboration_group = 1259076
compare = 1329438
plus_address = 1267844
When adding a new type, follow the docs below and keep this comment as the last entry. https://www.chromium.org/developers/design-documents/sync/integration-checklist/
app_notification = 45184
No-longer-supported data types, in various stages of removal. TODO(crbug.com/1395003): Eventually, these should all become "reserved" fields, or at least use "EmptySpecifics". But some of them are still needed by the server, e.g. to support older clients.
synced_notification = 153108
synced_notification_app_info = 235816
experiments = 161496
favicon_tracking = 181534
favicon_image = 182019
managed_user = 194582
managed_user_shared_setting = 202026
managed_user_allowlist = 306060
message
sync.proto:492A message to notify the server of certain sync events. Idempotent. Send these to the /event endpoint.
optional sync_disabled = 1
message
sync.proto:496(message has no fields)
message
experiment_status.proto:26This request allows an unauthenticated client to check the status of the experiments which do not require user authentication. The status of an experiment for a specific client can be determined based on the user agent string and/or the client id sent in the HTTPS POST request.
repeated string experiment_name = 1
Enumerates the experiments for which the status should be returned. An experiment name must be the same as one of the field names specified in ExperimentsSpecifics. See sync/protocol/experiments_specifics.proto.
message
experiment_status.proto:34Response to an experiment status request.
optional int32 poll_interval_seconds = 1
Minimal time to wait before issuing another request.
repeated experiment = 2
The experiments that the client has asked for, with each experiment containing exactly one experiment flag. The client can inspect the embedded flag to obtain the experiment status. Note that the number of experiments should be less than or equal to the number of experiment_name sent in the request since it is possible that there is no experiment matching an experiment_name.
message
experiments_specifics.proto:75Contains one flag or set of related flags. Each node of the experiments type will have a unique_client_tag identifying which flags it contains. By convention, the tag name should match the sub-message name.
Used in: ,
optional keystore_encryption = 1
optional history_delete_directives = 2
optional autofill_culling = 3
optional favicon_sync = 4
optional pre_commit_update_avoidance = 5
optional gcm_channel = 6
optional obsolete_enhanced_bookmarks = 7
No longer used as of M43.
optional gcm_invalidations = 8
No longer used as of M72.
optional obsolete_wallet_sync = 9
No longer used as of M51.
Properties of extension setting sync objects.
Used in: ,
optional string extension_id = 1
Id of the extension the setting is for.
optional string key = 2
Setting key.
optional string value = 3
Setting value serialized as JSON.
message
extension_specifics.proto:25Properties of extension sync objects. Merge policy: the settings for the higher version number win; in the case of a tie, server wins.
Used in: ,
optional string id = 1
Globally unique id for this extension.
optional string version = 2
The known installed version.
optional string update_url = 3
Auto-update URL to use for this extension. May be blank, in which case the default one (i.e., the one for the Chrome Extensions Gallery) is used.
optional bool enabled = 4
Whether or not this extension is enabled.
optional bool incognito_enabled = 5
Whether or not this extension is enabled in incognito mode.
optional string name = 6
DEPRECATED. See https://crbug.com/1233303.
optional bool remote_install = 7
Whether this extension was installed remotely, and hasn't been approved by a user in chrome yet.
optional bool installed_by_custodian = 8
DEPRECATED. See https://crbug.com/1014183.
optional bool all_urls_enabled = 9
DEPRECATED. See https://crbug.com/839681.
optional int32 disable_reasons = 10
Bitmask of the set of reasons why the extension is disabled (see extensions::disable_reason::DisableReason). Only relevant when enabled == false. Note that old clients (<M45) won't set this, even when enabled is false.
message
favicon_image_specifics.proto:23Used in:
optional bytes favicon = 1
The image data for the favicon (PNG encoded).
optional int32 width = 2
The favicon dimensions.
optional int32 height = 3
message
favicon_image_specifics.proto:32Image data for favicons. Multiple resolutions are supported.
Used in:
optional string favicon_url = 1
The url of the favicon image.
optional favicon_web = 2
A normal low-resolution web favicon (max resolution 16x16).
optional favicon_web_32 = 3
A slightly higher-resolution web favicon (max resolution 32x32).
optional favicon_touch_64 = 4
A high-resolution touch favicon (not precomposed, max resolution 64x64).
optional favicon_touch_precomposed_64 = 5
A high-resolution touch favicon (precomposed, max resolution 64x64).
message
experiments_specifics.proto:41Whether the favicon sync datatypes are enabled, and what parameters they should operate under.
Used in:
optional bool enabled = 1
optional int32 favicon_sync_limit = 2
Tracking info for of favicon images. These control expiration of images from sync based on recency, bookmark state, etc.
Used in:
optional string favicon_url = 1
The url of the favicon image.
optional int64 last_visit_time_ms = 3
The last time a page using this favicon was visited (in milliseconds since linux epoch).
optional bool is_bookmarked = 4
Whether this favicon is currently bookmarked or not.
message
device_info_specifics.proto:110Feature specific information about the device that is running a sync-enabled Chrome browser. Adding to this proto is discouraged and should only be added when the information can not be derived more generally.
Used in:
optional bool send_tab_to_self_receiving_enabled = 1
Tracks whether the SendTabToSelf feature is enabled on the device. For this to be true, two things must be true: (1) The receiving side of the feature must be enabled on the device (2) The user has enabled sync for this feature
message
gaia_password_reuse.proto:22User reused their GAIA password on another website.
Used in: ,
optional reuse_detected = 1
optional reuse_lookup = 2
Logged when we try to detect whether the password was reused on a Phishing or a Low-reputation site.
optional dialog_interaction = 3
message
gaia_password_reuse.proto:25Logged when we detect a password re-use event on a non-GAIA site. If the user hasn’t enabled SafeBrowsing, this will be the last event.
Used in:
optional status = 1
message
gaia_password_reuse.proto:26Used in:
optional bool enabled = 1
Is SafeBrowsing enabled?
optional SafeBrowsingStatus.ReportingPopulation safe_browsing_reporting_population = 2
enum GaiaPasswordReuse.PasswordReuseDetected.SafeBrowsingStatus.ReportingPopulation
gaia_password_reuse.proto:31If SafeBrowsing is enabled, is the user opted-in to extended reporting or Scout?
Used in:
REPORTING_POPULATION_UNSPECIFIED = 0
NONE = 1
EXTENDED_REPORTING = 2
SCOUT = 3
message
gaia_password_reuse.proto:90Logged when the user interacts with the warning UI shown to encourage password change if the site is Phishing or Low-reputation.
Used in:
optional PasswordReuseDialogInteraction.InteractionResult interaction_result = 1
Used in:
UNSPECIFIED = 0
WARNING_ACTION_TAKEN = 1
The user took the action suggested by the warning prompt.
WARNING_ACTION_IGNORED = 2
The user clicked ignore in the warning prompt.
WARNING_UI_IGNORED = 3
The warning UI was ignored, i.e. not interacted with by the user. This could happen if the user navigates away from the page.
WARNING_ACTION_TAKEN_ON_SETTINGS = 4
The user clicked "Change Password" on chrome://settings page.
message
gaia_password_reuse.proto:43Used in:
optional PasswordReuseLookup.LookupResult lookup_result = 1
optional PasswordReuseLookup.ReputationVerdict verdict = 2
optional bytes verdict_token = 3
PhishGuard token that identifies the verdict on the server.
Used in:
UNSPECIFIED = 0
ALLOWLIST_HIT = 1
URL did match the password reuse allowlist. No further action required related to this re-use event.
CACHE_HIT = 2
The URL exists in the client’s cache. No further action required related to this re-use event. This event also logs the ReputationVerdict.
REQUEST_SUCCESS = 3
A valid response received from the SafeBrowsing service. This event also logs the ReputationVerdict.
REQUEST_FAILURE = 4
Unable to get a valid response from the SafeBrowsing service.
URL_UNSUPPORTED = 5
We won't be able to compute reputation for the URL e.g. local IP address, localhost, not-yet-assigned by ICANN gTLD, etc.
ENTERPRISE_ALLOWLIST_HIT = 6
URL did match enterprise allowlist. No further action required related to this re-use event.
TURNED_OFF_BY_POLICY = 7
Password reuse lookup is turned off by enterprise policy. No further action required related to this re-use event.
The following two are only present for CACHE_HIT and REQUEST_SUCCESS. The verdict received from the Reputation service. This is set only if the user has SafeBrowsing enabled and we fetch the verdict from the cache or by sending a verdict request.
Used in:
VERDICT_UNSPECIFIED = 0
SAFE = 1
LOW_REPUTATION = 2
PHISHING = 3
Used in:
optional GarbageCollectionDirective.Type type = 1
Deprecated in M124. This field is unused because it would be hard to use `active_collaboration_ids`. The client should rely on the presence of the corresponding fields instead.
optional int64 version_watermark = 2
This field specifies the watermark for the versions which should get garbage collected. The client should purge all sync entities when receiving any value of this. This is a change from previous behavior, where the client would only be required to purge items older than the specified watermark. TODO(crbug.com/877951): Rename this to make clear that whenever it's set, the client will delete ALL data, regardless of its value.
optional collaboration_gc = 5
This field contains a list of active collaboration IDs which are available to the user. The client should stop tracking any shared sync entities with collaborations which are not in the list. Note that if the list is empty, an empty `collaboration_gc` is expected to be provided by the server. Introduced in M124.
Used in:
repeated string active_collaboration_ids = 1
Used in:
UNKNOWN = 0
VERSION_WATERMARK = 1
DEPRECATED_AGE_WATERMARK = 2
DEPRECATED_MAX_ITEM_COUNT = 3
message
experiments_specifics.proto:52Flags for enabling the GCM feature.
Used in:
optional bool enabled = 1
message
experiments_specifics.proto:63Flags for enabling GCM channel for invalidations.
Used in:
optional bool enabled = 1
This message communicates additional per-type information related to requests with origin GU_TRIGGER. This message is not relevant when any other origin value is used. Introduced in M29.
Used in:
repeated string notification_hint = 1
An opaque-to-the-client string of bytes, received through a notification, that the server may interpret as a hint about the location of the latest version of the data for this type. Introduced in M29.
optional bool client_dropped_hints = 2
This flag is set if the client was forced to drop hints because the number of queued hints exceeded its limit. The oldest hints will be discarded first. Introduced in M29.
optional bool invalidations_out_of_sync = 3
This flag is set when the client suspects that its list of invalidation hints may be incomplete. This may be the case if: - The client is syncing for the first time. - The client has just restarted and it was unable to keep track of invalidations that were received prior to the restart. - The client's connection to the invalidation server is currently or was recently broken. It's difficult to provide more details here. This is implemented by setting the flag to false whenever anything that might adversely affect notifications happens (eg. a crash, restart on a platform that doesn't support invalidation ack-tracking, transient invalidation error) and is unset only after we've experienced one successful sync cycle while notifications were enabled. This flag was introduced in M29.
optional int64 local_modification_nudges = 4
This counts the number of times the syncer has been asked to commit changes for this type since the last successful sync cycle. The number of nudges may not be related to the actual number of items modified. It often correlates with the number of user actions, but that's not always the case. Introduced in M29.
optional int64 datatype_refresh_nudges = 5
This counts the number of times the syncer has been explicitly asked to fetch updates for this type since the last successful sync cycle. These explicit refresh requests should be relatively rare on most platforms, and associated with user actions. For example, at the time of this writing the most common (only?) source of refresh requests is when a user opens the new tab page on a platform that does not support sessions invalidations. Introduced in M29.
optional bool server_dropped_hints = 6
This flag is set if the invalidation server reports that it may have dropped some invalidations at some point. Introduced in M33.
optional bool initial_sync_in_progress = 7
This flag is set if this GetUpdate request is due at least in part due to the fact that this type has not finished initial sync yet, and the client would like to initialize itself with the server data. Only some types support performing an initial sync as part of a normal GetUpdate request. Many types must be in configure mode when fetching initial sync data. Introduced in M38.
optional bool sync_for_resolve_conflict_in_progress = 8
This flag is set if this GetUpdate request is due to client receiving conflict response from server, so client needs to sync and then resolve conflict locally, and then commit again. Introduced in M42.
message
get_updates_caller_info.proto:19Used in: ,
optional bool notifications_enabled = 2
True if notifications were enabled for this GetUpdateMessage. Note: Ideally this would be moved out of GetUpdatesCallerInfo, so that GetUpdatesCallerInfo itself can be removed.
message
sync.proto:158Used in:
optional caller_info = 2
Indicates the reason for the GetUpdatesMessage. This was *mostly* deprecated in M29. GetUpdatesOrigin is the new way to encode the reason for the GetUpdates request, but some parts of the server still rely on this field. It also still contains the "notifications_enabled" flag which needs to be moved elsewhere before this can be fully removed. See https://crbug.com/510165.
optional bool fetch_folders = 3
Indicates whether related folders should be fetched.
repeated from_progress_marker = 6
Per-datatype progress marker. With the exception of certain configuration or initial sync requests, the client should include one instance of this field for each enabled data type.
optional bool streaming = 7
Indicates whether the response should be sent in chunks. This may be needed for devices with limited memory resources. If true, the response will include one or more ClientToServerResponses, with the first one containing GetUpdatesMetadataResponse, and the remaining ones, if any, containing GetUpdatesStreamingResponse. These ClientToServerResponses are delimited by a length prefix, which is encoded as a varint.
optional bool need_encryption_key = 8
Whether the client needs the server to provide an encryption key for this account. Note: this should typically only be set on the first GetUpdates a client requests. Clients are expected to persist the encryption key from then on. The allowed frequency for requesting encryption keys is much lower than other datatypes, so repeated usage will likely result in throttling.
optional SyncEnums.GetUpdatesOrigin get_updates_origin = 9
This value is an updated version of the GetUpdatesCallerInfo's GetUpdatesSource. It describes the reason for the GetUpdate request. Introduced in M29.
optional bool is_retry = 10
Whether this GU also serves as a retry GU. Any GU that happens after retry timer timeout is a retry GU effectively.
repeated client_contexts = 11
Set of optional per-client datatype contexts.
message
sync.proto:380Used in:
repeated entries = 1
New sync entries that the client should apply.
optional int64 changes_remaining = 4
Approximate count of changes remaining - use this for UI feedback. If present and zero, this estimate is firm: the server has no changes after the current batch.
repeated new_progress_marker = 5
Opaque, per-datatype timestamp-like tokens. Clients should retain and persist the values returned in this field, and present them back to the server to indicate the starting point for future update requests. This will be sent only if the client provided |from_progress_marker| in the update request. The server may provide a new progress marker even if this is the end of the batch, or if there were no new updates on the server; and the client must save these. If the server does not provide a |new_progress_marker| value for a particular datatype, when the request provided a |from_progress_marker| value for that datatype, the client should interpret this to mean "no change from the previous state" and retain its previous progress-marker value for that datatype.
repeated bytes encryption_keys = 6
The current encryption keys associated with this account. Will be set if the GetUpdatesMessage in the request had need_encryption_key == true or the server has updated the set of encryption keys (e.g. due to a key rotation).
repeated context_mutations = 7
Set of optional datatype contexts server mutations.
Used in:
repeated int64 global_id = 1
The global IDs of the navigations to delete.
optional int64 start_time_usec = 2
Time range for searching for navigations to delete. Client should delete all navigations to a URL between [start_time_usec, end_time_usec] if one of them matches a |global_id|.
optional int64 end_time_usec = 3
message
device_info_specifics.proto:223Used in:
optional string apk_version_name = 1
Properties of history delete directive sync objects.
Used in:
optional global_id_directive = 1
Exactly one of the fields below must be filled in. Otherwise, this delete directive must be ignored.
optional time_range_directive = 2
optional url_directive = 3
message
experiments_specifics.proto:29Whether history delete directives are enabled.
Used in:
optional bool enabled = 1
message
history_specifics.proto:26A history sync entity - this roughly represents one navigation, including its full redirect chain (but not referrals). Fields correspond to similarly named fields in history::VisitRow and history::URLRow.
Used in:
optional int64 visit_time_windows_epoch_micros = 1
Timestamp, also called "global ID" in some places (e.g. in delete directives). This uniquely identifies the entity.
optional string originator_cache_guid = 2
Cache GUID of the client that produced this entity, aka the "originator".
repeated redirect_entries = 3
The redirect chain. The first entry is the URL the user originally navigated to; the last one is where they ended up. If there were no redirects, this has only one entry.
optional bool redirect_chain_start_incomplete = 19
Whether the redirect chain in this entity is the continuation of a prior chain, and whether a continuation of this chain exists, in other entities. These are effectively the inverse of the CHAIN_START/CHAIN_END page transition qualifiers in Chrome. They are typically both false, since the whole chain is included in `redirect_entries`, but in some cases (notably, client redirects) a redirect chain may be split up across multiple entities.
optional bool redirect_chain_end_incomplete = 20
optional bool redirect_chain_middle_trimmed = 21
If this is set to true, then the redirect chain was too long and some entries were trimmed from the middle, so `redirect_entries` only corresponds to some of the first plus some of the last entries of the actual redirect chain.
optional page_transition = 4
The PageTransition for the navigation.
optional int64 originator_referring_visit_id = 5
The ID of the visit, on the originator client, that was a referrer for this one, or 0 if no referrer exists.
optional int64 originator_opener_visit_id = 6
The ID of the visit, on the originator client, that opened this one, or 0 if no opener exists.
optional int64 originator_cluster_id = 22
The ID of the cluster that this visit belongs to on the originator client, or 0 if the originator client does not support setting this field or the visit does not belong to any cluster.
optional int64 visit_duration_micros = 7
The duration of the visit, in microseconds. Zero if the visit hasn't been finished (or the duration wasn't updated for some other reason).
optional SyncEnums.BrowserType browser_type = 8
The kind of browser where this visit happened.
optional int32 window_id = 9
The SessionID of the window and tab where the visit happened. Can be used to link together possibly-related visits. Note: These are only unique per-client, so always use together with `originator_cache_guid`.
optional int32 tab_id = 10
optional int64 task_id = 11
The ID for the task associated with this navigation, which is globally unique with high probability.
optional int64 root_task_id = 12
The IDs of ancestor tasks. These can be used to construct a tree of related visits.
optional int64 parent_task_id = 13
optional int32 http_response_code = 14
The HTTP response code of the navigation.
optional string page_language = 15
The language of the content on the page, as an ISO 639 language code (usually two letters). May be "und" if the language couldn't be determined.
optional SyncEnums.PasswordState password_state = 16
Whether a password field was found on the page.
optional string favicon_url = 17
URL of the favicon for this page.
optional string referrer_url = 18
The URL of the referrer (indicated by `originator_referring_visit_id`), if any.
optional bool has_url_keyed_image = 23
Visit has an image derived from public version of the page. This can be used to provide more visual experience.
repeated categories = 24
Categories tagged for the visit.
repeated string related_searches = 25
Related search URLs for a Google SRP visit, to provide next steps to user.
optional string app_id = 26
ID of the app (non-BrApp) this entity was generated for, if any. Only visits originating from Android devices may have this set.
message
history_specifics.proto:137Used in:
optional string id = 1
ID of the category, this typically is an MID.
optional int32 weight = 2
Weight of the category, this is an integer value informing the confidence of a visit belonging to this category.
message
history_specifics.proto:67Used in:
optional SyncEnums.PageTransition core_transition = 1
The core transition type.
optional bool blocked = 2
Qualifiers: A supervised user tried to access this URL but was blocked.
optional bool forward_back = 3
User used the Forward or Back button to navigate among browsing history.
optional bool from_address_bar = 4
User used the address bar to trigger this navigation.
optional bool home_page = 5
User is navigating to the home page.
message
history_specifics.proto:34Used in:
optional int64 originator_visit_id = 1
ID of the visit on the originator client, unique within that client.
optional string url = 2
URL that was visited.
optional string title = 3
Title of the page corresponding to this URL.
optional bool hidden = 4
True if the URL should NOT be used for auto-complete.
optional SyncEnums.PageTransitionRedirectType redirect_type = 5
The redirect type (if any).
message
history_status.proto:16(message has no fields)
message
history_status.proto:19Response to a history status request.
optional int32 min_poll_interval_seconds = 1
Minimal time to wait before issuing another request.
optional bool has_derived_data = 2
Indicates whether the history corpuses have any derived data for a user.
Incoming invitations for password sending.
Used in:
optional string guid = 1
Unique client tag for the invitation. This does *not* have to be the same GUID as for the outgoing invitation.
optional sender_info = 2
Profile information about the sender of the password. Sender's public key is used to authenticate the sender for `encrypted_key_for_recipient`.
optional bytes encrypted_password_sharing_invitation_data = 3
Encrypted PasswordSharingInvitationData using recipient's public key corresponding to `recipient_key_version` and sender's private key to authenticate the sender, see https://www.rfc-editor.org/rfc/rfc9180.html.
optional client_only_unencrypted_data = 4
An unsynced field for use internally on the client. This field should never be set in any network-based communications because it contains unencrypted material.
optional uint32 recipient_key_version = 6
message
device_info_specifics.proto:177Device specific information telling how to send invalidations to this device.
Used in:
optional string instance_id_token = 1
FCM registration token of device (using Sync sender ID).
repeated int32 interested_data_type_ids = 2
This device wants to receive only invalidations which are related to these types. The legitimate values of this field correspond to the protobuf field numbers of all EntitySpecifics fields supported by the server (see components/sync/protocol/sync.proto).
message
experiments_specifics.proto:24A flag to enable support for keystore encryption.
Used in:
optional bool enabled = 1
message
app_specifics.proto:46Information about a linked app icon.
Used in:
optional string url = 1
The URL of the app icon.
optional uint32 size = 2
The size of the app icon in DIPs.
message
nigori_local_data.proto:29Used in:
repeated key = 2
Used for encrypting within the sync account boundary.
message
loopback_server.proto:21Serialization of the LoopbackServerEntity and its ancestors.
Used in:
optional LoopbackServerEntity.Type type = 1
optional entity = 2
optional int64 model_type = 3
Entity type mapping to one of the subclasses of LoopbackServerEntity.
Used in:
UNKNOWN = 0
BOOKMARK = 1
PERMANENT = 2
TOMBSTONE = 3
UNIQUE = 4
message
loopback_server.proto:37Contains the loopback server state.
optional int64 version = 1
The protocol buffer format version.
optional int64 store_birthday = 2
repeated entities = 3
repeated bytes keystore_keys = 4
All Keystore keys known to the server.
optional int64 last_version_assigned = 5
The last entity ID that was assigned to an entity.
Properties of managed user setting sync objects.
Used in:
optional string name = 1
optional string value = 2
Properties of managed user shared setting sync objects.
Used in:
optional string mu_id = 1
The MU ID for the managed user to whom the setting applies.
optional string key = 2
The key of the setting.
optional string value = 3
The setting value. The setting is a JSON encoding of an arbitrary Javascript value.
optional bool acknowledged = 4
This flag is set by the server to acknowledge that it has committed a change to a setting.
message
bookmark_specifics.proto:24Corresponds to a single meta info key/value pair for a bookmark node.
Used in:
optional string key = 1
optional string value = 2
message
model_type_state.proto:22Sync proto to store data type global metadata in model type storage.
Used in: ,
optional progress_marker = 1
The latest progress markers received from the server.
optional type_context = 2
A data type context. Sent to the server in every commit or update request. May be updated by either responses from the server or requests made on the model thread. The interpretation of this value may be data-type specific. Many data types ignore it.
optional string encryption_key_name = 3
This value is set if this type's data should be encrypted on the server. If this key changes, the client will need to re-commit all of its local data to the server using the new encryption key.
optional bool initial_sync_done_deprecated = 4
Deprecated in M113 and replaced by `initial_sync_state`. As of M115, this is not populated anymore, but existing values are still migrated to `initial_sync_state`. TODO(crbug.com/1423338): Fully remove this field after a migration period.
optional ModelTypeState.InitialSyncState initial_sync_state = 9
Indicates the status of "initial sync", i.e. whether the first download cycle and initial merge are complete.
optional string cache_guid = 5
A GUID that identifies the committing sync client. It's persisted within the sync metadata and should be used to check the integrity of the metadata. Mismatches with the guid of the running client indicates invalid persisted sync metadata, because cache_guid is reset when sync is disabled, and disabling sync is supposed to clear sync metadata.
optional string authenticated_account_id = 6
Syncing account ID, representing the user.
repeated invalidations = 7
The latest unprocessed invalidations received from the server. All incoming invalidations are stored in this message and persist until they are used in GetUpdate() message.
optional bool notes_enabled_before_initial_sync_for_passwords = 8
This is relevant for the passwords datatype. This indicates that the initial sync flow (downling all passwords from the server) has been run at least once after the password notes features is enabled. It is used to enforce redownload of passwords upon upgrading the browser to a version that supports password notes if necessary. It is false by default and set to true upon downloading passwords to make sure this download is executed only once.
Used in:
INITIAL_SYNC_STATE_UNSPECIFIED = 0
Default value, typically used when there is no metadata (e.g. because Sync is disabled).
INITIAL_SYNC_PARTIALLY_DONE = 2
Indicates that syncing has started and some, but not all updates from the initial download/sync have been delivered. This is only used for data types in ApplyUpdatesImmediatelyTypes().
INITIAL_SYNC_DONE = 3
Indicates that the initial sync (download + merge) has been completed.
INITIAL_SYNC_UNNECESSARY = 4
Indicates that no initial sync is necessary, used for CommitOnlyTypes().
message
model_type_state.proto:77Used in:
optional bytes hint = 1
Opaque field, which has to be provided as part of resulting GetUpdates back to the server.
optional int64 version = 2
Version of invalidation, used to order incoming invalidations.
optional int64 version_number = 1
message
session_specifics.proto:186Navigation information for a single redirection within a single navigation.
Used in:
optional string url = 1
A URL that redirected while navigating to the virtual_url.
message
nigori_specifics.proto:23Used in: , ,
optional string deprecated_name = 1
Note that M78 and before rely on the name being populated, at least for the main encrypted keybag within NigoriSpecifics.
optional bytes deprecated_user_key = 2
optional bytes encryption_key = 3
optional bytes mac_key = 4
message
nigori_specifics.proto:55Deprecated: use EncryptionKeys instead.
repeated key = 2
Used for encrypting data in the user's account.
message
nigori_local_data.proto:124Sync proto to store Nigori data in storage. Proto should be encrypted with os_crypt before storing it somewhere, because it contains sensitive data ( nigori_model.cryptographer_data.key_bag and nigori_model.keystore_keys).
optional model_type_state = 1
Global metadata.
optional entity_metadata = 2
Metadata for Nigori entity.
optional nigori_model = 3
Nigori model state.
message
nigori_local_data.proto:57Used in:
optional cryptographer_data = 1
Represents state of the cryptographer.
optional string current_keystore_key_name = 2
Contains the name of the key, used for encryption of NigoriSpecifics.keystore_decryptor_token, should always be the name of the latest keystore key. Equals to cryptographer_data.default_key_name iff it is Nigori in full keystore mode (not in backward compatible keystore mode).
optional pending_keys = 3
Contains keybag in encrypted form, should be empty once we were able to decrypt keybag from specifics.
optional NigoriSpecifics.PassphraseType passphrase_type = 4
PassphraseType used for encryption. IMPLICIT_PASSPRHASE shouldn't be used here.
optional int64 keystore_migration_time = 5
The time (in UNIX epoch milliseconds) at which the keystore migration was performed.
optional int64 custom_passphrase_time = 6
The time (in UNIX epoch milliseconds) at which a custom passphrase was set. Note: this field may not be set if the custom passphrase was applied before corresponding field in NigoriSpecifics was introduced.
optional custom_passphrase_key_derivation_params = 7
Params used for deriving keys from custom passphrase. Should be set iff |passphrase_type| is CUSTOM_PASSPHRASE.
optional bool encrypt_everything = 8
Indicates whether we need to encrypt all encryptable user types.
repeated int32 encrypted_types_specifics_field_number = 9
The list of encrypted UserEncryptableTypes, represented by their specifics field number.
repeated string keystore_key = 10
Keystore keys are used to decrypt keystore-based Nigori. Should be persisted in order to not ask the keystore server for them during every browser startup. Due to backward compatibility requirements keys are always Base64 encoded.
optional pending_keystore_decryptor_token = 11
Encryptor keystore decryptor token. Used for decryption of keystore Nigori in case keystore keys arrived after NigoriSpecifics.
optional string last_default_trusted_vault_key_name = 12
Contains the name of the latest available trusted vault key that was used as the default encryption key. Resets when the client go out of pending decryption state and transits to other passphrase types.
optional trusted_vault_debug_info = 13
Some debug-only fields for passphrase type TRUSTED_VAULT_PASSPHRASE.
optional cross_user_sharing_public_key = 14
Current Public-key.
message
nigori_specifics.proto:63Properties of nigori sync object.
Used in:
optional encryption_keybag = 1
Encrypted proto of type EncryptionKeys.
optional bool keybag_is_frozen = 2
Once keystore migration is performed, we have to freeze the keybag so that older clients (that don't support keystore encryption) do not attempt to update the keybag. Previously |using_explicit_passphrase|.
optional bool encrypt_bookmarks = 13
Booleans corresponding to whether a datatype should be encrypted. Passwords and Wi-Fi configurations are always encrypted, so we don't need a field here. History delete directives need to be consumable by the server, and thus can't be encrypted. USS clients don't read these values, datatypes are either always encrypted, never encrypted or encrypted when |encrypt_everything| set to true. TODO(crbug.com/1360022): complete deprecation of encrypt_* fields (replace fields with reserved) once <M82 clients aren't supported.
optional bool encrypt_preferences = 14
optional bool encrypt_autofill_profile = 15
optional bool encrypt_autofill = 16
optional bool encrypt_themes = 17
optional bool encrypt_typed_urls = 18
optional bool encrypt_extensions = 19
optional bool encrypt_sessions = 20
optional bool encrypt_apps = 21
optional bool encrypt_search_engines = 22
optional bool encrypt_everything = 24
If true, all current and future datatypes will be encrypted.
optional bool encrypt_extension_settings = 25
optional bool encrypt_app_notifications = 26
optional bool encrypt_app_settings = 27
optional bool sync_tab_favicons = 29
Enable syncing favicons as part of tab sync.
optional int32 passphrase_type = 30
An |int| field is used instead of enum PassphraseType so we can better handle unknown values coming from later versions. Prior to M77, this was an enum so old clients will assume IMPLICIT_PASSPHRASE for values greater than 4.
optional keystore_decryptor_token = 31
The keystore decryptor token blob. Encrypted with the keystore key, and contains the encryption key used to decrypt |encryption_keybag|. Only set if passphrase_state == KEYSTORE_PASSPHRASE.
optional int64 keystore_migration_time = 32
The time (in milliseconds since Unix epoch) at which the keystore migration was performed.
optional int64 custom_passphrase_time = 33
The time (in milliseconds since Unix epoch) at which a custom passphrase was set. Note: this field may not be set if the custom passphrase was applied before this field was introduced.
optional bool encrypt_dictionary = 34
Boolean corresponding to whether custom spelling dictionary should be encrypted.
optional bool encrypt_app_list = 38
Boolean corresponding to whether app list items should be encrypted.
optional bool encrypt_autofill_wallet_metadata = 39
Boolean corresponding to whether usage count and last use date of Wallet data should be encrypted.
optional bool server_only_was_missing_keystore_migration_time = 40
Boolean indicating whether this node was originally missing a |keystore_migration_time| field value, and was fixed on the server by giving the field a value. THIS FIELD SHOULD ONLY BE SET BY THE SERVER.
optional bool encrypt_arc_package = 41
Boolean corresponding to whether arc pakcage items should be encrypted.
optional bool encrypt_printers = 42
Boolean corresponding to whether printer items should be encrypted.
optional bool encrypt_reading_list = 43
Boolean corresponding to whether reading list items should be encrypted.
optional int32 custom_passphrase_key_derivation_method = 45
ID of the method used to derive the encryption key from a custom passphrase. Should be set only when |passphrase_type| is CUSTOM_PASSPHRASE and only based on CustomPassphraseKeyDerivationMethod. This field has been added in M70. All previous versions just ignore it, attempt to use PBKDF2_HMAC_SHA1_1003 and, thus, reject any passphrase if a different method has been used. The default corresponds to UNSPECIFIED. An |int| field is used so we can detect unknown values coming from later versions.
optional string custom_passphrase_key_derivation_salt = 46
Base64-encoded salt used for the derivation of the key from the custom passphrase. Valid only if custom_passphrase_key_derivation_method == SCRYPT_8192_8_11, ignored in other cases.
optional bool encrypt_send_tab_to_self = 47
Boolean corresponding to whether send tab should be encrypted.
optional bool encrypt_web_apps = 48
Boolean corresponding to whether Web Apps data should be encrypted.
optional bool encrypt_os_preferences = 49
Boolean corresponding to whether OS preferences should be encrypted.
optional trusted_vault_debug_info = 50
optional cross_user_sharing_public_key = 53
Current cross user sharing Public-key to expose in server registry for sharing offers outside account boundary.
message
nigori_specifics.proto:244Information useful for auto-upgrade to trusted vault.
Used in:
optional AutoUpgradeDebugInfo.AutoUpgradeState auto_upgrade_state = 1
Current state of an account after it was processed by auto-upgrade.
optional int32 eligibility_group_id = 2
ID of eligibility group account belongs to. Only use IDs defined within EligibilityGroup enum.
Used in:
STATE_UNSPECIFIED = 0
AUTO_UPGRADED = 1
CONTROL = 2
VALIDATION = 3
Each eligibility group can be ramped in different stages (e.g. 1%, 10%, 100%). Every ramp stage is differentiated with its own entry in the enum.
GROUP_UNSPECIFIED = 0
TEST_GROUP_1 = 1
Used in:
UNSPECIFIED = 0
This comes from a <= M69 client, who does not know about the field (but implicitly uses PBKDF2_HMAC_SHA1_1003).
PBKDF2_HMAC_SHA1_1003 = 1
PBKDF2-HMAC-SHA1 with 1003 iterations and constant hardcoded salt. Was implicitly used in <= M69.
SCRYPT_8192_8_11 = 2
scrypt with N = 2^13, r = 8, p = 11 and random salt. Was added in M70.
The state of the passphrase required to decrypt |encryption_keybag|.
Used in:
UNKNOWN = 0
Proto enums should begin with an 'unknown' value for switch statements, unknown fields, etc.
IMPLICIT_PASSPHRASE = 1
Gaia-based encryption passphrase. Legacy.
KEYSTORE_PASSPHRASE = 2
Keystore key encryption passphrase. Uses |keystore_bootstrap| to decrypt |encryption_keybag|.
FROZEN_IMPLICIT_PASSPHRASE = 3
Previous Gaia-based passphrase frozen and treated as a custom passphrase.
CUSTOM_PASSPHRASE = 4
User provided custom passphrase.
TRUSTED_VAULT_PASSPHRASE = 5
Encryption key provided by a trusted vault.
message
nigori_specifics.proto:267Some debug-only fields for passphrase type TRUSTED_VAULT_PASSPHRASE.
Used in: ,
optional int64 migration_time = 1
The time (in milliseconds since Unix epoch) at which the trusted vault migration was performed.
optional int32 key_version = 2
The version (aka key epoch) corresponding to the Nigori keybag.
optional auto_upgrade_debug_info = 3
DebugInfo written by a process that auto-upgrades to trusted vault.
optional int64 auto_upgrade_debug_info_modification_time_unix_epoch_millis = 4
The time (in milliseconds since Unix epoch) last update of the auto upgrade debug info was made.
message
note_entity.proto:16Used in:
optional string plain_text = 1
Plain text of the note.
optional string rich_text = 2
Rich text of the note. It will be used when plain_text is empty and the UI supports rich text.
optional NoteEntity.TargetType target_type = 3
required
optional int32 current_note_version = 4
required
Used in:
TARGET_TYPE_UNSPECIFIED = 0
TARGET_TYPE_PAGE = 1
Page target type makes the note global to the page. It does not associate with any user selection.
message
os_preference_specifics.proto:26Properties of a synced Chrome OS system preference. Uses PreferenceSpecifics instead of declaring name and value fields to allow more code sharing in the client (e.g. all PrefModelAssociators can operate on PreferenceSpecifics).
Used in:
optional preference = 1
Properties of a Chrome OS priority preference. Uses PreferenceSpecifics instead of declaring name and value fields to allow more code sharing in the client (e.g. all PrefModelAssociators can use PreferenceSpecifics).
Used in:
optional preference = 1
Used for the server to return fine-grained commit errors back to the client.
Used in:
optional OutgoingPasswordSharingInvitationCommitError.ErrorCode error_code = 1
enum OutgoingPasswordSharingInvitationCommitError.ErrorCode
password_sharing_invitation_specifics.proto:122This enum is used in histograms. Entries should not be renumbered and numeric values should never be reused. Also remember to update in tools/metrics/histograms/enums.xml.
Used in:
UNKNOWN = 0
PUBLIC_KEY_VERSION_MISMATCH = 1
Sender's public key version is different on the server.
NOT_FAMILY_MEMBER = 2
The sender and the recipient are not in the same family according to the Google family service.
Outgoing invitations for password sending.
Used in:
optional string guid = 1
Unique client tag for the invitation, generated by the client.
optional string recipient_user_id = 2
Recipient's user identifier (obfuscated Gaia ID).
optional bytes encrypted_password_sharing_invitation_data = 3
Encrypted PasswordSharingInvitationData using recipient's public key corresponding to `recipient_key_version` and sender's private key to authenticate the sender, see https://www.rfc-editor.org/rfc/rfc9180.html.
optional client_only_unencrypted_data = 4
An unsynced field for use internally on the client. This field should never be set in any network-based communications because it contains unencrypted material.
optional uint32 recipient_key_version = 6
optional uint32 sender_key_version = 7
Version of Public key of the sender which is used to authenticate the sender of the password. Must be equal to the latest committed version.
message
password_specifics.proto:64All the strings are encoded with UTF-8. URLs are encoded in Punycode.
Used in: ,
optional leaked_password_issue = 1
optional reused_password_issue = 2
optional weak_password_issue = 3
optional phished_password_issue = 4
message
password_specifics.proto:65Used in:
optional uint64 date_first_detection_windows_epoch_micros = 1
Timestamp set by a client detecting the issue for the first time. Number of microseconds since Windows epoch (1601). This can be unset even if is_muted is set in a few cases in storage (for a time mutes were written without setting this field - fixed starting 2021-11-10).
optional bool is_muted = 2
Whether the issue was muted by user.
optional bool trigger_notification_from_backend_on_detection = 3
Whether the backend should notify the user about this issue. Set to true if the user hasn't already seen a client notification for this issue (e.g. a leak detection prompt in Chrome). The backend sending notifications does not reset this field. All other sources can write this in both `PasswordSpecificsData` and `PasswordSpecificsMetadata` and do so.
Used in: ,
optional password_group_data = 2
Used in:
optional string username_value = 1
optional string password_value = 2
repeated element_data = 3
Contains password fields required for sending. See PasswordSpecificsData for field descriptions.
Used in:
optional int32 scheme = 2
See PasswordSpecificsData::Scheme for values.
optional string signon_realm = 3
optional string origin = 4
optional string username_element = 5
optional string password_element = 7
optional string display_name = 8
optional string avatar_url = 9
A message to obtain a list of recipients for sending a password.
The request returns family members for the user and that is why no additional fields are required.
(message has no fields)
optional PasswordSharingRecipientsResponse.PasswordSharingRecipientsResult result = 1
repeated recipients = 2
List of possible recipients for sending a password. Note that public key may be absent if a recipient can’t receive a password (e.g. due to an older Chrome version).
enum PasswordSharingRecipientsResponse.PasswordSharingRecipientsResult
password_sharing_recipients.proto:25Used in:
UNKNOWN = 0
SUCCESS = 1
The user is a member of a family and the request succeeded.
NOT_FAMILY_MEMBER = 2
Not a family member, used to distinguish from a family with only one member.
message
password_specifics.proto:333Properties of password sync objects.
Used in:
optional encrypted = 1
The actual password data. Contains an encrypted PasswordSpecificsData message.
optional client_only_encrypted_data = 2
An unsynced field for use internally on the client. This field should never be set in any network-based communications because it contains unencrypted material.
optional unencrypted_metadata = 3
Password related metadata, which is sent to the server side. The field should never be set for full encryption users. If encryption is enabled, this field must be cleared.
optional encrypted_notes_backup = 5
An encrypted backup of the notes field inside the PasswordSpecificsData. The Sync server preserves the contents of this field across commits from legacy clients that don't set this field. It is the responsibility of Sync clients to populate the contents of PasswordSpecificsData notes fields using the contents of this field. This should be deprecated together with the logic for preserving it on the server when clients without support for the |notes| field are no longer allowed by the server (below support version horizon). Encryption key considerations: a) For commits, the client must use the same key for both encrypted blobs. b) For handling getupdates, the two keys may NOT necessarily match the encryption key used, as in theory the new blob could be "behind" if key rotation took place. As of today, it is safe to assume that if |encrypted| is decryptable by a client, then |encrypted_notes_backup| must be decryptable too (i.e. the Nigori keybag should include older versions of the key). But not the other way round. If both `encrypted_notes_backup` and the `notes` in `encrypted` are populated, the one in notes is considered the authoritative value.
message
password_specifics.proto:90Used in:
optional int32 scheme = 1
See the enum above.
optional string signon_realm = 2
Signon realm stores information on where the saved password was stored, and where it's supposed to be filled again. It can take various formats depending on the exact circumstances where it was recorded. Note that the format is *not* guaranteed to be a valid URL or URI: * For parsed web forms and normal passwords saved through Credential Manager API: <http-scheme>://<url-host>[:<url-port>]/ where <http-scheme> is one of "http" or "https" <url-host> is the host for which the password was stored <url-port> is the option port on the host The signon realm is a valid URL in this case with an empty path. Examples: http://www.example.com/ https://127.0.0.1/ http://www.google.com:8080/ http://192.168.1.254/ https://accounts.google.com/ * For Android apps saved through Autofill with Google: android://<hash-of-cert>@<package-name>/ where <hash-of-cert> is the base64 encoded SHA512 of the app's public certificate <package-name> is the app's package name Examples: android://kCyQDzpaoAX2gs-1zdGPKNAeICb8LzRFOxa4NCq0jO8c8d_NFS_q-Y35bU3Nq3GmFV2lLurmNvIZa6YPYZwmWg==@com.pinterest/ android://mNUCvTnoWBkzIhSSkVj-uzAdK42YagmCmyUtPoC6JPmYAN3wKpmTdIRsdJtz6pzNBye8XL7nBbEcx-y9CJeo9A==@com.twitter.android.lite/ * For federated credentials: federation://<origin_host>/<federation_host> where <origin_host> is the host for which the login information was stored <federation_host> is the host of the federation provider that was used to sign in Examples: federation://www.example.com/accounts.google.com federation://uk.trustpilot.com/www.facebook.com * For proxy auth: <proxy-host>[:<proxy_port>]/<auth-realm> where <proxy-host> is the host of the proxy for which the password was stored <proxy-port> is the port of the proxy <auth-realm> is a string provided by the proxy during authentication. It can contain spaces. Examples: proxy2.eq.edu.au:80/MISldap proxy.det.nsw.edu.au:8080/NSW Department of Education 10.47.2.250:3128/Squid Proxy Server CPUT default.go2https.com:443/(******Get password from vpnso.com/account/ *****) * For HTTP basic auth: <http-scheme>://<url-host>[:<url-port>]/<auth-realm> where <http-scheme> is one of "http" or "https" <url-host> is the host for which the password was stored <url-port> is the option port on the host <auth-realm> is a string provided by the host during authentication. It can contain spaces. Examples: http://192.168.1.1/Broadband Router http://192.168.0.1/TP-LINK Wireless N Router WR841N http://192.168.1.1/index.htm https://www.edge.asic.gov.au/ASIC eBusiness
optional string origin = 3
For parsed web forms and Credential Management API: url-scheme://url-host[:url-port]/path For Android: "android://<hash of cert>@<package name>/" For proxy/HTTP auth: url-scheme://url-host[:url-port]/path
optional string action = 4
Only for web-parsed forms - the action target of the form: url-scheme://url-host[:url-port]/path
optional string username_element = 5
Only for web-parsed forms - the name of the element containing username.
optional string username_value = 6
For all: the username. For blacklisted forms: <empty>.
optional string password_element = 7
Only for web-parsed forms - the name of the element containing password.
optional string password_value = 8
For all: the password. For federated logins and blacklisted forms: <empty>
optional bool ssl_valid = 9
Deprecated: http://crbug.com/413020 True if the credential was saved for a HTTPS session with a valid SSL cert. Ignored for Android apps.
optional bool preferred = 10
True for the last credential used for logging in on a given site. Deprecated in M81.
optional int64 date_created = 11
Time when the credential was created. Amount of microseconds since 1601.
optional bool blacklisted = 12
True, if user chose permanently not to save the credentials for the form.
optional int32 type = 13
kFormSubmission(0), user manually filled the username and the password in the form. kGenerated(1), the credential was auto generated. kApi(2), the credential was generated from Credential Management API. kManuallyAdded(3), user manually created the password credential via Settings. kImported(4), the credential was imported using the import flow. kReceivedViaSharing(5), the credential has been received via the password sharing feature.
optional int32 times_used = 14
Number of times this login was used for logging in using an HTML form. Chrome uses this field to distinguish log-in and sign-up forms.
optional string display_name = 15
A human readable name of the account holder. Set by CredentialManager API and Android.
optional string avatar_url = 16
A URL of the avatar for the credential. Set by CredentialManager API and Android.
optional string federation_url = 17
A URL of the IdP used to verify the credential. Set by Credential Manager API and Android.
optional int64 date_last_used = 18
Time when the credential was last used. This covers *successful* logins to the website, and explicit updates to the password. It does *not* cover if the password just gets filled but not actually submitted, or if the login failed. Note that password consumers other than Chrome (e.g. Google Play Services) might not update this at all. Amount of microseconds since 1601, aka Windows epoch.
optional password_issues = 19
Set if an issue was detected that puts this password at risk. All the clients are expected to clear the field when the password value is updated. 'reused' part can be additionally reset when the analysis on the entire password store is completed.
optional int64 date_password_modified_windows_epoch_micros = 20
Time when the |password_value| was last modified. For new credentials it should be set to |date_created|. For subsequent updates the timestamp is changed if and only if the new password value was saved. Number of microseconds since Windows epoch (1601).
optional notes = 22
Set of extra notes that the user attached to the password. The presence of this field, even with an empty Notes message, becomes the authoritative value for notes and would disregard whatever `encrypted_notes_backup` contains.
optional string sender_email = 23
For credentials that have been shared by another user, this field captures the sender email. It's empty for credentials that weren't received via password sharing feature.
optional string sender_name = 24
Similar to `sender_email` but for the sender name.
optional int64 date_received_windows_epoch_micros = 25
The timestamp when the password was received via sharing feature from another user.
optional bool sharing_notification_displayed = 26
Whether the user has been already notified that they received this password from another user via the password sharing feature. This is synced to avoid showing the notification on multiple devices.
optional string sender_profile_image_url = 27
Similar to `sender_email` but for the url of the sender profile image.
message
password_specifics.proto:269Used in:
repeated note = 1
message
password_specifics.proto:270Used in:
optional string unique_display_name = 1
The display name must be unique within the scope of a password.
optional string value = 2
The user-defined value of the note.
optional int64 date_created_windows_epoch_micros = 3
The creation time of the note. Number of microseconds since 1601.
optional bool hide_by_default = 4
Whether the value of the note is not displayed in plain text by default.
The different types of the saved credential.
SCHEME_HTML = 0
SCHEME_HTML, the credential represents either a parsed HTML form, or an android credential or a password saved through Credential Management API (https://w3c.github.io/webappsec/specs/credentialmanagement/).
SCHEME_BASIC = 1
SCHEME_BASIC, basic access http authentication.
SCHEME_DIGEST = 2
SCHEME_DIGEST, digest access authentication.
SCHEME_OTHER = 3
SCHEME_OTHER, another proxy access authentication.
USERNAME_ONLY = 4
USERNAME_ONLY, partial credentials saved on Android that contain only username and miss the password.
message
password_specifics.proto:312Contains the password specifics metadata which simplifies its lookup.
Used in:
optional string url = 1
The signon realm for the credential. For more details, see the `signon_realm` field in PasswordSpecificsData.
optional bool blacklisted = 2
True, if user chose permanently not to save the credentials for the form. Introduced in M82. Copy from PasswordSpecificsData.blacklisted.
optional int64 date_last_used_windows_epoch_micros = 3
Copy from PasswordSpecificsData.date_last_used. Introduced in M112.
optional password_issues = 4
Copy from PasswordSpecificsData.password_issues. Introduced in M114.
optional int32 type = 13
Copy from PasswordSpecificsData.type. Introduced in M119.
message
autofill_specifics.proto:516Contains information of payment instruments that can be used by the user.
Used in:
optional int64 instrument_id = 1
Opaque identifier for the account stored in Payments Platform. This will be used to initiate the payment.
repeated PaymentInstrument.SupportedRail supported_rails = 2
The supported rails for which a payment can be made for the given account. For example, Pix is the open-banking rail in Brazil, UPI is the open-banking rail in India.
optional string display_icon_url = 3
The URL for the image to be displayed when showing the account to the user.
optional string nickname = 4
Nickname for the instrument.
oneof instrument_details
The backing source for the applicable rails.
bank_account = 5
iban = 6
Supported payment infrastructures (rail) that allow users to send money between the payer and the payee. https://en.wikipedia.org/wiki/Payment_rail
Used in:
SUPPORTED_RAIL_UNKNOWN = 0
PIX = 1
Payment rails for Brazil Open Banking.
IBAN = 2
International Bank Account Numbers.
message
autofill_specifics.proto:485Contains information about a Payments Customer.
Used in:
optional string id = 1
The billable customer ID associated with the account.
message
persisted_entity_data.proto:24Sync proto to store entity data similar to what the legacy Directory used to store, used to persist data locally and never sent through the wire. Because it's conceptually similar to SyncEntity (actual protocol) and it's unclear how big this'll grow, we've kept compatibility with SyncEntity by using the same field numbers.
optional string name = 8
See corresponding fields in SyncEntity for details.
optional specifics = 21
message
device_info_specifics.proto:188Used in:
optional uint32 tunnel_server_domain = 1
The encoded tunnel server in the same format as in the BLE advert. See device::cablev2::tunnelserver::DecodeDomain. (Actually a uint16 but proto doesn't have that as a type.)
optional bytes contact_id = 2
An FCM token that can be presented to the tunnel server to contact this device.
optional bytes secret = 3
A shared secret key, used to enable communication across devices via unauthenticated channels. Knowledge of this secret acts as proof that the remote end is authorized to talk to the device publishing this secret.
optional fixed32 id = 4
An id that identifies |secret|. This, and |secret|, will be rotated and the ID allows this device to know which |secret| the counterparty is using.
optional bytes peer_public_key_x962 = 5
A P-256, X9.62-encoded public key for this device. Specific to the Chrome instance.
optional bytes google_credential_id = 6
The credential ID for use when signing into accounts.google.com. This credential ID isn't published as a WebauthnCredentialSpecifics, unlike other passkeys, because it's auto-generated.
message
plus_address_specifics.proto:19Used in:
optional int64 profile_id = 1
A stable, unique identifier, generated by the PlusAddress backend.
optional string facet = 2
The origin that the `plus_email` is generated for.
optional plus_email = 3
message
plus_address_specifics.proto:27Used in:
optional string email_address = 1
Used in:
optional string guid = 1
required
optional string url = 2
required
optional PowerBookmarkSpecifics.PowerType power_type = 3
required
optional int64 creation_time_usec = 4
required
optional int64 update_time_usec = 5
required
optional power_entity = 100
required
PowerType is persisted to disk and therefore shouldn't be reoderered or changed. Should keep the field numbers of PowerType in sync with the ones in entity above.
Used in:
POWER_TYPE_UNSPECIFIED = 0
All powers should have type so this should be unused.
POWER_TYPE_MOCK = 1
Used for testing.
POWER_TYPE_NOTE = 2
Used for notes.
Data structure dedicated to each power type. Should keep the field numbers of specifics in sync with the ones in PowerType below.
Used in:
oneof entity
note_entity = 2
Used for notes.
message
experiments_specifics.proto:47Flags for enabling the experimental no-precommit GU feature.
Used in:
optional bool enabled = 1
message
preference_specifics.proto:22Properties of preference sync objects.
Used in: , , ,
optional string name = 1
optional string value = 2
message
printer_specifics.proto:22User PPD configuration
Used in:
optional string user_supplied_ppd_url = 1
Url for user provided file. Overrides other fields.
optional string effective_manufacturer = 2
Retired fields
optional string effective_model = 3
optional string effective_make_and_model = 4
String identifying the type of printer, used to look up a ppd to drive the printer.
optional bool autoconf = 5
True if the printer should be automatically configured, false otherwise.
message
printer_specifics.proto:38Used in:
optional string id = 1
Printer record GUID
optional string display_name = 2
User visible name. Any string.
optional string description = 3
User visible description. Any string.
optional string manufacturer = 4
Printer manufacturer. Should be a known manufacturuer. Deprecated in favor of make_and_model.
optional string model = 5
Printer model. Should match a known model for the manufacturer. Deprecated in favor of make_and_model.
optional string uri = 6
Universal Resource Identifier for the printer on the network. usb:// will be the scheme for USB printers. Example ipp://address.example:port/queue/queue/queue.
optional string uuid = 7
Universally Unique Identifier provided by the printer. Used for unique identification of printers in a zeroconf environment.
optional bytes ppd = 8
PPDData was deprecated in favor of PPDReference format.
optional ppd_reference = 9
Structure representing the user's ppd configuration.
optional int64 updated_timestamp = 10
Timestamp when printer was last updated.
optional string make_and_model = 11
The make and model of the printer in one string. The typical arrangement for this is '<make> <model>'. This aligns with the typical formatting of the IPP attribute printer-make-and-model.
optional string print_server_uri = 12
Universal Resource Identifier for the print server on the network. This will only be populated if the printer is from a print server. Example ipp://address.example:port/
Represents trusted Authorization Server for printers.
Used in:
optional string uri = 1
Universal Resource Identifier for the authorization server on the network. The scheme must be https. Example: https://address.example:port/path/path. This field must be unique and is required.
Properties of a synced priority preference.
Used in:
optional preference = 1
message
reading_list_specifics.proto:24Sync Reading list entry. This proto contains the fields synced for a reading list entry. It must be kept synced with the reading_list.ReadingListLocal protobuf.
Used in:
optional string entry_id = 1
entry_id and url must be equal.
optional string title = 2
optional string url = 3
optional int64 creation_time_us = 4
optional int64 update_time_us = 5
optional int64 first_read_time_us = 7
optional int64 update_title_time_us = 8
optional int32 estimated_read_time_seconds = 9
optional ReadingListSpecifics.ReadingListEntryStatus status = 6
If the field is not present, it defaults to UNSEEN.
Used in:
UNREAD = 0
READ = 1
UNSEEN = 2
message
session_specifics.proto:194Subset of TabNavigation fields representing a navigation that was later replaced in history (e.g. history.replaceState()), which allows tracking information about the original navigation prior to the first replacement.
Used in:
optional string first_committed_url = 1
optional int64 first_timestamp_msec = 2
optional SyncEnums.PageTransition first_page_transition = 3
Sync protocol datatype extension for saved tab groups. Saved Tab Groups are tab groups which can be recalled between browser sessions, and if sync is turned on, cross device. A saved tab group contains tabs which are stored as a SavedTabGroupSpecifics separately (SavedTabGroupTab). This is due to limitations from the sync service on the size of an individual sync entity.
Used in:
optional int64 position = 1
The position of the SavedTabGroup in any visual display. This also represents the index in the SavedTabGroupModel of the group.
optional string title = 2
The displayed title of the group, shown on the tab group and the saved tab group button.
optional SavedTabGroup.SavedTabGroupColor color = 3
The color of the group, mapped to tab_groups::TabGroupColorId.
These colors map to tab_groups::TabGroupColorId. They DO NOT match the enum integer values due to "kGrey" being in the "Unspecified" field.
Used in:
SAVED_TAB_GROUP_COLOR_UNSPECIFIED = 0
SAVED_TAB_GROUP_COLOR_GREY = 1
SAVED_TAB_GROUP_COLOR_BLUE = 2
SAVED_TAB_GROUP_COLOR_RED = 3
SAVED_TAB_GROUP_COLOR_YELLOW = 4
SAVED_TAB_GROUP_COLOR_GREEN = 5
SAVED_TAB_GROUP_COLOR_PINK = 6
SAVED_TAB_GROUP_COLOR_PURPLE = 7
SAVED_TAB_GROUP_COLOR_CYAN = 8
SAVED_TAB_GROUP_COLOR_ORANGE = 9
Used in:
optional string guid = 1
An id that refers to the sync saved tab group object.
optional int64 creation_time_windows_epoch_micros = 2
Timestamps for CRUD operations.
optional int64 update_time_windows_epoch_micros = 3
oneof entity
group = 4
tab = 5
Sync protocol datatype extension for saved tab group tabs. SavedTabGroupTab are the sync representation of a tab in a saved tab group. they are stored as separate entities due to size limitations of sync entities.
Used in:
optional string group_guid = 1
An id that links the saved tab group tab to it's saved tab group.
optional int64 position = 2
The position in the Tab Strip the tab is located relative to the start of the tab group. This is also the index in the saved_tabs_ vector in the SavedTabGroup in the SavedTabGroupModel, which is updated by the TabStripModel.
optional string url = 3
Tab Data used for constructing the tab.
optional string title = 4
The displayed title of the tab, shown on the saved tab group button's context menu.
message
search_engine_specifics.proto:24Properties of custom search engine sync objects.
Used in:
optional string short_name = 1
The description of the search engine.
optional string keyword = 2
The search engine keyword for omnibox access.
optional string favicon_url = 3
A URL to the favicon to show in the search engines options page.
optional string url = 4
The actual parameterized search engine query URL.
optional bool safe_for_autoreplace = 5
A flag signifying whether it is safe to automatically modify this search engine entry or not.
optional string originating_url = 6
The URL to the OSD file this search engine entry came from.
optional int64 date_created = 7
The date this search engine entry was created. A UTC timestamp with units in microseconds.
optional string input_encodings = 8
A list of supported input encodings.
optional bool deprecated_show_in_default_list = 9
Obsolete field. This used to represent whether or not this entry is shown in the list of default search engines.
optional string suggestions_url = 10
The parameterized URL that provides suggestions as the user types.
optional int32 prepopulate_id = 11
The ID associated with the prepopulate data this search engine comes from. Set to zero if it was not prepopulated.
optional bool autogenerate_keyword = 12
DEPRECATED: Whether to autogenerate a keyword for the search engine or not. Do not write to this field in the future. We preserve this for now so we can read the field in order to migrate existing data that sets this bit.
optional string instant_url = 15
ID 13 reserved - previously used by |logo_id|, now deprecated.
optional int64 last_modified = 17
ID 16 reserved - previously used by |id|, now deprecated. The last time this entry was modified by a user. A UTC timestamp with units in microseconds.
optional string sync_guid = 18
The primary identifier of this search engine entry for Sync.
repeated string alternate_urls = 19
A list of URL patterns that can be used, in addition to |url|, to extract search terms from a URL.
optional string search_terms_replacement_key = 20
optional string image_url = 21
The parameterized URL that provides image results according to the image content or image URL provided by user.
optional string search_url_post_params = 22
The following post_params are comma-separated lists used to specify the post parameters for the corresponding search URL.
optional string suggestions_url_post_params = 23
optional string instant_url_post_params = 24
optional string image_url_post_params = 25
optional string new_tab_url = 26
The parameterized URL for a search provider specified new tab page.
optional SearchEngineSpecifics.ActiveStatus is_active = 27
Whether a search engine is 'active' and can be triggered via the omnibox by typing in the relevant keyword.
optional int32 starter_pack_id = 28
The ID associated with the starter pack engine. This is set to 0 if not a starter pack engine.
Used in:
ACTIVE_STATUS_UNSPECIFIED = 0
The default state when a SE is auto-added. Unspecified SE are inactive.
ACTIVE_STATUS_TRUE = 1
The SE is active and can be triggered via the omnibox.
ACTIVE_STATUS_FALSE = 2
The SE has been manually set to inactive by the user.
Used in:
oneof event
The specific security event to record.
gaia_password_reuse_event = 1
optional int64 event_time_usec = 2
Time of event, as measured by client in microseconds since Windows epoch.
message
segmentation_specifics.proto:27Sync data proto for storing segmentation data. Keyed by the combination of cache_guid (a Sync client id) and segmentation key. The segmentation platform is a platform that uses intelligence and machine learning to guide developers for building purpose-built user experience for specific segments of users. See go/chrome-segmentation for more details.
Used in:
optional string segmentation_key = 1
The key used to identify the type of segmentation associated with a feature, e.g. 'user_engagement'.
optional segment_selection_result = 2
optional device_metadata = 3
repeated model_execution_data = 4
One or more model execution data associated with each segment for the segmentation key.
message
segmentation_specifics.proto:44Metadata about the client device as used by the segmentation platform.
Used in:
optional string cache_guid = 1
The cache_guid created to identify a sync client on this device. Reuses the same Sync guid.
optional DeviceMetadata.PlatformType platform_type = 2
The OS platform of the device.
Used in:
PLATFORM_TYPE_UNSPECIFIED = 0
PLATFORM_WINDOWS = 1
PLATFORM_MAC = 2
PLATFORM_LINUX = 3
PLATFORM_CHROMEOS_ASH = 4
PLATFORM_ANDROID = 5
PLATFORM_IOS = 6
PLATFORM_CHROMEOS_LACROS = 7
message
segmentation_specifics.proto:66Model execution data including segment scores and related metadata, e.g., model version.
Used in:
optional string model_id = 1
A string ID that identifies a model.
repeated model_outputs = 2
A model may output one or multiple scores, one score for each segment label.
optional int64 execution_time_windows_epoch_seconds = 3
Timestamp when the ML model was executed. Represents time from windows epoch in seconds.
optional int64 score_expiry_time_windows_epoch_seconds = 4
Expiry timestamp for the model scores. Represents time from windows epoch in seconds.
optional int32 model_version = 5
The version of the ML model that was run.
message
segmentation_specifics.proto:68Output of model.
Used in:
optional string label = 1
When outputting multiple scores from a single model, this is the segment label for each output.
optional float score = 2
Raw segment scores provided by the ML model or the heuristic model. The score is derived based on a combination of UMA histograms, user actions or UKM and URLs visited. The score can be treated as a probability of the user liking a feature, like feed, or NTP.
optional int32 rank = 3
A rank defined by the segmentation scheme.
message
segmentation_specifics.proto:29The selected segment by the segmentation scheme.
Used in:
optional string selected_segment = 1
The string ID that refers to the segment the user was assigned to, e.g., 'highly_engaged_user'.
optional int64 expiry_time_windows_epoch_seconds = 2
Expiry time of selection result. Represents time from windows epoch in seconds. Expired results are ignored by clients.
optional int64 last_updated_time_windows_epoch_seconds = 3
Time when the segmentation data is updated. Used to weigh results by recency. Represents time from windows epoch in seconds.
Send Tab To Self list entry. This proto contains the fields synced to send a url across devices.
Used in:
optional string guid = 5
A random unique identifier for each shared tab. Required.
optional string title = 1
The name of the tab being shared.
optional string url = 2
The URL of the tab being shared. Required.
optional int64 shared_time_usec = 3
The time the tab was shared as measured by the client in microseconds since the windows epoch.
optional string device_name = 4
A non-unique but human readable name to describe this client, used in UI.
optional string target_device_sync_cache_guid = 7
The stable Device_id of the device that this tab was shared with. Required.
optional bool opened = 8
A boolean to designate if the shared tab been opened on the target device.
optional bool notification_dismissed = 9
Whether the notification for this proto been dismissed.
message
session_specifics.proto:35Properties of session sync objects.
Used in:
repeated window = 2
Each session is composed of windows.
optional string client_name = 3
A non-unique but human-readable name to describe this client.
optional SyncEnums.DeviceFormFactor device_form_factor = 5
The form factor of device.
optional SyncEnums.DeviceType device_type = 4
The type of device. Mandatory until M115. Replaced by device_form_factor afterwards, but still populated for backward compatibility.
message
session_specifics.proto:23Used in:
optional string session_tag = 1
Unique id for the client. M89 and higher use sync's cache GUID (client ID) to populate this tag for *new* sessions.
optional header = 2
optional tab = 3
optional int32 tab_node_id = 4
The local tab id used by sync. Unique across all nodes for that client.
message
session_specifics.proto:60Used in:
optional int32 tab_id = 1
Unique (to the owner) id for this tab.
optional int32 window_id = 2
The unique id for the window this tab belongs to.
optional int32 tab_visual_index = 3
Visual index of the tab within its window. There may be gaps in these values.
optional int32 current_navigation_index = 4
Identifies the index of the current navigation in navigations. For example, if this is 2 it means the current navigation is navigations[2].
optional bool pinned = 5
True if the tab is pinned.
optional string extension_app_id = 6
If non-empty, this tab is an app tab and this is the id of the extension.
repeated navigation = 7
Tabs are navigated, and the navigation data is here.
optional SyncEnums.BrowserType browser_type = 13
optional int64 last_active_time_unix_epoch_millis = 14
Timestamp for when this tab was last activated. Corresponds to WebContents::GetLastActiveTime().
optional bytes favicon = 8
The favicon for the current url the tab is displaying. Either empty or a valid PNG encoded favicon.
optional SessionTab.FaviconType favicon_type = 9
optional string favicon_source = 11
The url of the actual favicon (as opposed to the page using the favicon).
repeated uint64 variation_id = 12
Ids of the currently assigned variations which should be sent to sync.
The type of favicon. For now only normal web favicons are supported.
Used in:
TYPE_WEB_FAVICON = 1
message
session_specifics.proto:49Used in:
optional int32 window_id = 1
Unique (to the owner) id for this window.
optional int32 selected_tab_index = 2
Index of the selected tab in tabs; -1 if no tab is selected.
optional SyncEnums.BrowserType browser_type = 3
Type of the window.
repeated int32 tab = 4
The tabs that compose a window (correspond to tab id's).
Used in:
optional string url = 1
The URL of the page.
optional string title = 2
The title of the page.
optional string favicon_url = 3
The URL to the favicon of the page.
optional string shared_tab_group_guid = 4
The GUID of the SharedTabGroup this is a member of.
optional unique_position = 5
The UniquePosition within a SharedTabGroup.
Used in:
optional string title = 1
The displayed title of the group, shown on the tab group.
optional SharedTabGroup.Color color = 2
The color of the tab group, mapped to tab_groups::TabGroupColorId.
These colors map to tab_groups::TabGroupColorId. They DO NOT match the enum integer values due to "kGrey" being in the "Unspecified" field.
Used in:
UNSPECIFIED = 0
GREY = 1
BLUE = 2
RED = 3
YELLOW = 4
GREEN = 5
PINK = 6
PURPLE = 7
CYAN = 8
ORANGE = 9
Used in:
optional string guid = 1
Unique identifier for this entity.
optional string last_modification_author = 2
TODO(b/319521964): consider to rename and add a comment to clarify the content.
oneof entity
tab_group = 3
tab = 4
Used for the server to return fine grained commit errors back to the client.
Used in:
optional SharingMessageCommitError.ErrorCode error_code = 1
This enum is used in histograms. Entries should not be renumbered and numeric values should never be reused. Also remember to update in tools/metrics/histograms/enums.xml SyncSharingMessageCommitErrorCode enum.
Used in:
NONE = 0
INVALID_ARGUMENT = 1
NOT_FOUND = 2
INTERNAL = 3
UNAVAILABLE = 4
RESOURCE_EXHAUSTED = 5
UNAUTHENTICATED = 6
PERMISSION_DENIED = 7
SYNC_TURNED_OFF = 8
Client-specific error codes.
SYNC_NETWORK_ERROR = 9
DEPRECATED_SYNC_SERVER_OR_AUTH_ERROR = 10
Deprecated UMA bucket, prior to splitting between SYNC_SERVER_ERROR and SYNC_AUTH_ERROR.
SYNC_TIMEOUT = 11
Message wasn't committed before timeout.
SYNC_SERVER_ERROR = 12
Error code for server error or unparsable server response.
SYNC_AUTH_ERROR = 13
Auth error when communicating with the server.
Used in:
optional string message_id = 1
Unique identifier of message.
optional channel_configuration = 2
optional bytes payload = 3
Payload encrypted using the target user keys according to WebPush encryption scheme. The payload has to be a valid chrome/browser/sharing/proto/sharing_message.proto serialized using SerializeToString.
Used in:
oneof channel_configuration
fcm = 1
FCM channel configuration. Message will be delivered as a FCM message.
bytes server = 2
Opaque server channel configuration. Message will be delivered through server channel.
Used in:
optional string token = 1
FCM registration token of target device.
optional int32 ttl = 2
Time to live for a FCM message (in seconds) - if specified, the message will expire based on the TTL.
optional int32 priority = 3
Priority level of a FCM message. 5 = normal, 10 = high.
message
device_info_specifics.proto:120Device specific information for Sharing feature. Used to send end-to-end encrypted message through FCM to other devices.
Used in:
optional string vapid_fcm_token = 1
FCM registration token of device subscribed using VAPID key. TODO(crbug.com/1012226): Deprecate when VAPID migration is over.
optional bytes vapid_p256dh = 2
Public key for message encryption [RFC8291] using VAPID key. TODO(crbug.com/1012226): Deprecate when VAPID migration is over.
optional bytes vapid_auth_secret = 3
Auth secret for message encryption [RFC8291] using VAPID key. TODO(crbug.com/1012226): Deprecate when VAPID migration is over.
repeated SharingSpecificFields.EnabledFeatures enabled_features = 4
A list of enabled Sharing features.
optional string sender_id_fcm_token_deprecated = 5
Deprecated. Use sender_id_fcm_token_v2 for new clients.
optional bytes sender_id_p256dh_deprecated = 6
Deprecated. Use sender_id_p256dh_v2 for new clients.
optional bytes sender_id_auth_secret_deprecated = 7
Deprecated. Use sender_id_auth_secret_v2 for new clients.
optional string sender_id_fcm_token_v2 = 8
FCM registration token of device subscribed using Sharing sender ID.
optional bytes sender_id_p256dh_v2 = 9
Public key for message encryption [RFC8291] using Sharing sender ID.
optional bytes sender_id_auth_secret_v2 = 10
Auth secret for message encryption [RFC8291] using Sharing sender ID.
Enum defining available Sharing features.
Used in:
UNKNOWN = 0
CLICK_TO_CALL_VAPID = 1
Supports Click to Call only via VAPID.
SHARED_CLIPBOARD_VAPID = 2
Supports Shared Clipboard only via VAPID.
SMS_FETCHER = 3
REMOTE_COPY = 4
DISCOVERY = 6
CLICK_TO_CALL_V2 = 7
Suppots Click to Call via both VAPID and sender ID.
SHARED_CLIPBOARD_V2 = 8
Suppots Shared Clipboard via both VAPID and sender ID.
OPTIMIZATION_GUIDE_PUSH_NOTIFICATION = 9
Supports optimization guide push notification.
message
client_debug_info.proto:35The additional info here is from the StatusController. They get sent when the event SYNC_CYCLE_COMPLETED is sent.
Used in:
optional int32 num_encryption_conflicts = 4
These new conflict counters replace the ones above. TODO(crbug.com/1315573): Deprecated in M103.
optional int32 num_hierarchy_conflicts = 5
optional int32 num_simple_conflicts = 6
No longer sent since M24.
optional int32 num_server_conflicts = 7
optional int32 num_updates_downloaded = 8
Counts to track the effective usefulness of our GetUpdate requests.
optional int32 num_reflected_updates_downloaded = 9
TODO(crbug.com/1315573): Deprecated in M103.
optional caller_info = 10
|caller_info| was mostly replaced by |get_updates_origin|; now it only contains the |notifications_enabled| flag.
optional SyncEnums.GetUpdatesOrigin get_updates_origin = 12
message
sync.proto:499A message indicating that the sync engine has been disabled on a client.
Used in:
optional string cache_guid = 1
The GUID that identifies the sync client.
optional string store_birthday = 2
The store birthday that the client was using before disabling sync.
message
sync_entity.proto:19Used in: , ,
optional string id_string = 1
This item's identifier. In a commit of a new item, this will be a client-generated ID. If the commit succeeds, the server will generate a globally unique ID and return it to the committing client in the CommitResponse.EntryResponse. In the context of a GetUpdatesResponse, |id_string| is always the server generated ID. The original client-generated ID is preserved in the |originator_client_id| field. Present in both GetUpdatesResponse and CommitMessage. Prior to M123, this field was empty for commit-only types.
optional string parent_id_string = 2
An id referencing this item's parent in the hierarchy. In a CommitMessage, it is accepted for this to be a client-generated temporary ID if there was a new created item with that ID appearing earlier in the message. In all other situations, it is a server ID. Present in both GetUpdatesResponse and CommitMessage. Starting with M99, this field is optional and used for legacy bookmarks only: 1. When processing GetUpdatesResponse, it is unused for modern data created or reuploaded by M94 or above, which populates the parent's GUID in BookmarkSpecifics (which is sufficient). 2. When issuing CommitMessage, the field is populated for compatibility with clients before M99.
optional int64 version = 4
The version of this item -- a monotonically increasing value that is maintained by for each item. If zero in a CommitMessage, the server will interpret this entity as a newly-created item and generate a new server ID and an initial version number. If nonzero in a CommitMessage, this item is treated as an update to an existing item, and the server will use |id_string| to locate the item. Then, if the item's current version on the server does not match |version|, the commit will fail for that item. The server will not update it, and will return a result code of CONFLICT. In a GetUpdatesResponse, |version| is always positive and indentifies the revision of the item data being sent to the client. Present in both GetUpdatesResponse and CommitMessage. WARNING: This field used to be required before M60. Any client before this will fail to deserialize if this field is missing.
optional int64 mtime = 5
Last modification time, in milliseconds since Unix epoch. Present in both GetUpdatesResponse and CommitMessage.
optional int64 ctime = 6
Creation time, in milliseconds since Unix epoch. Present in both GetUpdatesResponse and CommitMessage.
optional string name = 7
The name of this item. Historical note: Since November 2010, this value is no different from non_unique_name. Before then, server implementations would maintain a unique-within-parent value separate from its base, "non-unique" value. Clients had not depended on the uniqueness of the property since November 2009; it was removed from Chromium by http://codereview.chromium.org/371029 . Present in both GetUpdatesResponse and CommitMessage. WARNING: This field used to be required before M60. Any client before this will fail to deserialize if this field is missing.
optional string non_unique_name = 8
The name of this item. Same as |name|. |non_unique_name| should take precedence over the |name| value if both are supplied. For efficiency, clients and servers should avoid setting this redundant value. Present in both GetUpdatesResponse and CommitMessage.
optional string server_defined_unique_tag = 10
If present, this tag identifies this item as being a uniquely instanced item. The server ensures that there is never more than one entity in a user's store with the same tag value. This value is used to identify and find e.g. the "Bookmark Bar" folder without relying on a particular ID or name. This variant of the tag is created by the server, so clients can't create an item with a tag using this field. Use client_tag_hash if you want to create one from the client. An item can't have both a client_tag_hash and a server_defined_unique_tag. Present only in GetUpdatesResponse.
optional int64 position_in_parent = 15
Ancient fields, predecessors for |unique_position|, deprecated with M26 and still supported to deal with old incoming data. See field |unique_position| for details as well as the data-upgrading implementation in GetUniquePositionFromSyncEntity().
optional string insert_after_item_id = 16
optional bool deleted = 18
If true, indicates that this item has been (or should be) deleted. Present in both GetUpdatesResponse and CommitMessage.
optional string originator_cache_guid = 19
A unique ID that identifies the the sync client who initially committed this entity. This value corresponds to |cache_guid| in CommitMessage. This field, along with |originator_client_item_id|, can be used to reunite the original with its official committed version in the case where a client does not receive or process the commit response for some reason. Present only in GetUpdatesResponse. This field is also used in determining the unique identifier used in bookmarks' unique_position field.
optional string originator_client_item_id = 20
Item ID as generated by the client that initially created this entity. Used exclusively for bookmarks (other datatypes use client_tag_hash). There are three generation of bookmarks that have populated this field differently, depending on which version of the browser created the bookmark: 1. For bookmarks created before M44 (2015), the field got populated with an ID that is locally unique, but not globally unique (usually a negative number). 2. For bookmarks created between M45 and M51, both inclusive, the field got populated with a globally unique GUID in uppercase form. 3. For bookmarks created with M52 or above, the field gets populated with a globally unique GUID in lowercase form. Present only in GetUpdatesResponse.
optional specifics = 21
Extensible container for datatype-specific data. This became available in version 23 of the protocol.
optional bool folder = 22
Indicate whether this is a folder or not. Available in version 23+.
optional string client_tag_hash = 23
A client defined unique hash for this entity. Analogous to server_defined_unique_tag, but allows the client to determine an immutable attribute of the entity in hashed form that makes it unique per user (i.e. at most one entity may exist per client tag hash). This value must be of the form base64(SHA1(client_tag)) where the client_tag is a value derived from the contents of an entity in a type-specific way. Since the hashed contents of the client_tag are exposed to the server via this field, take care when defining it that there is enough entropy to mask any secrets that the server shouldn't learn. The difference between server_defined_unique_tag and client_tag_hash is the creator of the entity. Server defined tags are entities created by the server at account creation, while client defined tags are entities created by the client at any time. During GetUpdates, a sync entity update will come back with ONE of: a) Originator item and cache id - for bookmarks created using old versions of the browser (latest M93, before https://crrev.com/c/2945119). b) Server tag - If server committed the item as unique c) Client tag - If client committed the item as unique May be present in CommitMessages for the initial creation of an entity. If present in Commit updates for the entity, it will be ignored. May be returned in GetUpdatesMessage and sent up in CommitMessage.
optional unique_position = 25
Introduced in M26, represents ordering among entities, in practice used for bookmarks only. Clients should not assume it is always populated in GetUpdatesMessage due to the following caveats: 1. Tombstones and permanent folders do not populate it (ordering is irrelevant). 2. It may remain unset by future versions of the client, as long as the field with the same name is populated inside BookmarkSpecifics. M94 and above populate both for backward compatibility reasons, but when support for M93 is retired, modern clients at the time may stop populating this field. 3. Very old data (last committed by M25 or below, before the field was introduced) does not include this field, and in that case the legacy fields |position_in_parent| or |insert_after_item_id| must be honored instead. May be returned in GetUpdatesMessage and sent up in CommitMessage.
optional collaboration = 27
message
sync_entity.proto:230Metadata used for shared data types. Must not be present for regular data types. Introduced in M124.
Used in:
optional string collaboration_id = 1
Collaboration ID which the current entity belongs to.
message
sync_enums.proto:23(message has no fields)
Used in:
UPGRADE_CLIENT = 0
Upgrade the client to latest version.
UNKNOWN_ACTION = 5
DEPRECATED_CLEAR_USER_DATA_AND_RESYNC = 1; DEPRECATED_ENABLE_SYNC_ON_ACCOUNT = 2; DEPRECATED_STOP_AND_RESTART_SYNC = 3; DEPRECATED_DISABLE_SYNC_ON_CLIENT = 4;
This is the default.
Types of browsers; used for history-related data types.
Used in: , ,
BROWSER_TYPE_UNKNOWN = 0
TYPE_TABBED = 1
A normal tabbed window.
TYPE_POPUP = 2
A popup window.
TYPE_CUSTOM_TAB = 3
A custom tab within an app.
Types of device form factors.
Used in: , ,
DEVICE_FORM_FACTOR_UNSPECIFIED = 0
DEVICE_FORM_FACTOR_DESKTOP = 1
DEVICE_FORM_FACTOR_PHONE = 2
DEVICE_FORM_FACTOR_TABLET = 3
New enums to describe the device type were introduced; OsType and FormFactor. Deprecated 12/2022. TODO(1395353): Remove deprecated values from DeviceType enum.
Used in: ,
TYPE_UNSET = 0
TYPE_WIN = 1
TYPE_MAC = 2
TYPE_LINUX = 3
TYPE_CROS = 4
TYPE_OTHER = 5
TYPE_PHONE = 6
TYPE_TABLET = 7
Used in: ,
SUCCESS = 0
NOT_MY_BIRTHDAY = 2
DEPRECATED_ACCESS_DENIED = 1; Returned when the server and client disagree on the store birthday. This should be interpreted as all local sync metadata requiring cleanup, obviously including the locally-cached store birthday.
THROTTLED = 3
Returned when the store has exceeded the allowed bandwidth utilization.
TRANSIENT_ERROR = 8
DEPRECATED_AUTH_EXPIRED = 4; DEPRECATED_USER_NOT_ACTIVATED = 5; DEPRECATED_AUTH_INVALID = 6; DEPRECATED_CLEAR_PENDING = 7; A transient error occurred (e.g. a backend timeout). The client should try again later.
MIGRATION_DONE = 9
A server-side migration has taken place for one or more data types. The client should clear the cache for these data types only and then re-sync with a server.
DISABLED_BY_ADMIN = 10
An administrator disabled sync for this domain.
PARTIAL_FAILURE = 12
Deprecated in M50. DEPRECATED_USER_ROLLBACK = 11; Returned when the client wants to update several data types, but some of them failed (e.g. throttled).
CLIENT_DATA_OBSOLETE = 13
Returned when the server detects that this client's sync metadata is obsolete. The client should reset local sync metadata and restart syncing.
ENCRYPTION_OBSOLETE = 14
Returned when the server detects that the encryption state (Nigori, keystore keys) has been reset/overridden, which means the local Nigori-related state is obsolete and should be cleared. Introduced in M84.
UNKNOWN = 100
Unknown value. This should never be explicitly used; it is the default value when an out-of-date client parses a value it doesn't recognize.
This is the successor to GetUpdatesSource. It merges the "normal mode" values (LOCAL, NOTIFICATION and DATATYPE_REFRESH), which were never really mutually exclusive to being with, into the GU_TRIGGER value. It also drops support for some old values that are not supported by newer clients. Mind the gaps: Some values are intentionally unused because we want to keep the values in sync with GetUpdatesSource as much as possible. Please don't add any values < 12 unless there's a good reason for it. Introduced in M28.
Used in: ,
UNKNOWN_ORIGIN = 0
The source was not set by the caller.
PERIODIC = 4
The source of the update was periodic polling.
NEWLY_SUPPORTED_DATATYPE = 7
The client is in configuration mode
MIGRATION = 8
because it's syncing all datatypes, and support for a new datatype was recently released via a software auto-update.
The client is in configuration mode because a
NEW_CLIENT = 9
MIGRATION_DONE error previously returned by the server necessitated resynchronization.
The client is in configuration mode because the
RECONFIGURATION = 10
user enabled sync for the first time. Not to be confused with FIRST_UPDATE.
The client is in configuration mode because the
GU_TRIGGER = 12
user opted to sync a different set of datatypes.
The client is in 'normal' mode. It may have several
RETRY = 13
reasons for requesting an update. See the per-type GetUpdateTriggers message for more details.
A retry GU to pick up updates missed by last GU due to
PROGRAMMATIC = 14
replication delay, missing hints, etc.
A GU to programmatically enable/disable a
Types of device OS.
Used in:
OS_TYPE_UNSPECIFIED = 0
OS_TYPE_WINDOWS = 1
OS_TYPE_MAC = 2
OS_TYPE_LINUX = 3
OS_TYPE_CHROME_OS_ASH = 4
OS_TYPE_ANDROID = 5
OS_TYPE_IOS = 6
OS_TYPE_CHROME_OS_LACROS = 7
OS_TYPE_FUCHSIA = 8
Types of transitions between pages.
Used in: , ,
LINK = 0
TYPED = 1
AUTO_BOOKMARK = 2
AUTO_SUBFRAME = 3
MANUAL_SUBFRAME = 4
GENERATED = 5
AUTO_TOPLEVEL = 6
FORM_SUBMIT = 7
RELOAD = 8
KEYWORD = 9
KEYWORD_GENERATED = 10
The below two were mistakenly added but never properly used. They are actually transition qualifiers, and are set independently of other qualifiers and of the main transitions. See session_specifics.proto for the list of synced transition qualifiers. DEPRECATED_CHAIN_START = 12; DEPRECATED_CHAIN_END = 13;
Types of redirects that triggered a transition.
Used in: ,
CLIENT_REDIRECT = 1
SERVER_REDIRECT = 2
The "password state" is the presence/absence of a password field on a website; used for history-related data types.
Used in: ,
PASSWORD_STATE_UNKNOWN = 0
NO_PASSWORD_FIELD = 1
HAS_PASSWORD_FIELD = 2
These events are sent by the DebugInfo class for singleton events.
Used in:
CONNECTION_STATUS_CHANGE = 1
Connection status change. Note this gets generated even during a successful connection.
UPDATED_TOKEN = 2
Client received an updated token.
PASSPHRASE_REQUIRED = 3
Cryptographer needs passphrase.
PASSPHRASE_ACCEPTED = 4
Passphrase was accepted by cryptographer.
INITIALIZATION_COMPLETE = 5
Sync Initialization is complete.
STOP_SYNCING_PERMANENTLY = 6
Server sent stop syncing permanently. This event should never be seen by the server in the absence of bugs.
ACTIONABLE_ERROR = 8
Client has finished encrypting all data. DEPRECATED_ENCRYPTION_COMPLETE = 7; Client received an actionable error.
ENCRYPTED_TYPES_CHANGED = 9
Set of encrypted types has changed.
PASSPHRASE_TYPE_CHANGED = 10
The encryption passphrase state changed.
DEPRECATED_KEYSTORE_TOKEN_UPDATED = 11
A new keystore encryption token was persisted. Deprecated 11/2021.
CONFIGURE_COMPLETE = 12
The datatype manager has finished an at least partially successful configuration and is once again syncing with the server.
DEPRECATED_BOOTSTRAP_TOKEN_UPDATED = 13
A new cryptographer bootstrap token was generated.
TRUSTED_VAULT_KEY_REQUIRED = 14
Cryptographer needs trusted vault decryption keys.
TRUSTED_VAULT_KEY_ACCEPTED = 15
Cryptographer no longer needs trusted vault decryption keys.
The payload coming from the server for all invalidated data types.
repeated data_type_invalidations = 1
This field contains information about each data type which needs to be updated. Note that it may contain data types which current client is not interested in.
optional bytes hint = 2
Opaque field, which has to be provided as part of resulting GetUpdates back to the server.
optional int64 version = 3
Version of invalidation, used to order incoming invalidations.
Used in:
optional int32 data_type_id = 1
The legitimate values of this field correspond to the protobuf field numbers of all EntitySpecifics fields supported by the server (see components/sync/protocol/sync.proto).
message
session_specifics.proto:96Used in:
optional string virtual_url = 2
The virtual URL, when nonempty, will override the actual URL of the page when we display it to the user.
optional string referrer = 3
The referring URL, which can be empty.
optional string title = 4
The title of the page.
optional SyncEnums.PageTransition page_transition = 6
The core transition type.
optional SyncEnums.PageTransitionRedirectType redirect_type = 7
If this transition was triggered by a redirect, the redirect type.
optional int32 unique_id = 8
The unique navigation id (within this client).
optional int64 timestamp_msec = 9
Timestamp for when this navigation last occurred (in client time). If the user goes back/forward in history the timestamp may refresh.
optional bool navigation_forward_back = 10
User used the Forward or Back button to navigate among browsing history.
optional bool navigation_from_address_bar = 11
User used the address bar to trigger this navigation.
optional bool navigation_home_page = 12
User is navigating to the home page.
optional int64 global_id = 15
The id for this navigation, which is globally unique with high probability.
optional string favicon_url = 17
The favicon url associated with this page.
optional int32 http_status_code = 20
The status code from the last navigation.
optional int32 correct_referrer_policy = 25
Correct referrer policy. Valid enums are defined in third_party/WebKit/public/platform/WebReferrerPolicy.h.
optional SyncEnums.PasswordState password_state = 26
Whether the Password Manager saw a password field on the page.
optional bool navigation_chain_start = 13
The start/end of a redirect chain. Deprecated in M108 because they were always set to false in practice, and don't make sense in the first place - this message corresponds to a complete chain.
optional bool navigation_chain_end = 14
optional string search_terms = 16
Search terms extracted from the URL. Deprecated in M64.
optional TabNavigation.BlockedState blocked_state = 18
Whether access to the URL was allowed or blocked. Deprecated in M121 because it was unused.
optional int32 obsolete_referrer_policy = 21
Referrer policy. Old, broken value. Deprecated in M61.
optional bool is_restored = 22
True if created from restored navigation entry that hasn't been loaded. Deprecated in M121 because it was unused.
repeated navigation_redirect = 23
The chain of redirections for this navigation, from the original URL through the last URL that redirected. Deprecated in M121 because it was unused.
optional string last_navigation_redirect_url = 24
The last URL traversed when different from the virtual_url. Deprecated in M121 because it was unused.
optional int64 task_id = 27
The id for the task associated with this navigation, which is globally unique with high probability. Deprecated in M121 because it was unused.
repeated int64 ancestor_task_id = 28
Task ids of all ancestor navigations, which can be from other tabs, from root to parent. Deprecated in M121 because it was unused.
optional replaced_navigation = 29
When a history entry is replaced (e.g. history.replaceState()), this contained some information about the entry prior to being replaced. Deprecated in M121 because it was unused.
optional string page_language = 30
The page language as determined by its textual content. An ISO 639 language code (two letters, except for Chinese where a localization is necessary). Deprecated in M121 because it was unused.
Used in:
STATE_ALLOWED = 1
STATE_BLOCKED = 2
message
theme_specifics.proto:22Properties of theme sync objects.
Used in:
optional bool use_custom_theme = 1
If set, we're using a extension and all custom_* fields should be present. If not set, and all custom_* fields should be omitted.
optional bool use_system_theme_by_default = 2
This field is only relevant on platforms that have a distinction between the system theme and the default theme, but other platforms must be careful to pass through the value of this flag. If true, we use the system theme by default (i.e., when we don't use a custom theme) for platforms that make a distinction between the default theme and the system theme. Has no effect if use_custom_theme is true.
optional string custom_theme_name = 3
TODO(gayane): Migrate custom_* fields to a separate message. Extension specific fields. Ignored if |autogenerated_theme| is set.
optional string custom_theme_id = 4
optional string custom_theme_update_url = 5
optional autogenerated_theme = 6
If set, autogenerated theme is used.
message
theme_specifics.proto:42Used in:
optional uint32 color = 1
SkColor used to autogenerate theme.
Both fields below must be filled in. Otherwise, this delete directive must be ignored.
Used in:
optional int64 start_time_usec = 1
The time on or after which entries must be deleted.
optional int64 end_time_usec = 2
The time on or before which entries must be deleted.
optional string app_id = 3
Optional field to filter the entries with the matching app ID. This field is set only by Android which has app-specific history feature that allows users to generate/delete history entries from Custom Tabs on app, not from BrApp.
message
client_debug_info.proto:25Per-type hint information.
optional int32 data_type_id = 1
The data type this hint applied to.
optional bool has_valid_hint = 2
Whether or not a valid hint is provided.
message
typed_url_specifics.proto:23Properties of typed_url sync objects - fields correspond to similarly named fields in history::URLRow.
Used in:
optional string url = 1
Actual URL that was typed.
optional string title = 2
Title of the page corresponding to this URL.
optional bool hidden = 4
True if the URL should NOT be used for auto-complete.
repeated int64 visits = 7
Timestamps for all visits to this URL.
repeated int32 visit_transitions = 8
The PageTransition::Type for each of the visits in the |visit| array. Both arrays must be the same length.
message
unique_position.proto:30A UniquePosition is a string of bytes. Unique positions are unique per-item, since they are guaranteed to end with a fixed-length suffix that is unique per-item. The position string may not end with a '\0' byte. Prior to the suffix is a series of arbitrary bytes of arbitrary length. Items under the same parent are positioned relative to each other by a lexicographic comparison of their UniquePosition values.
History: Unique positions were first introduced in M28. This change was rolled out in such a way that it would try to maintain backwards compatibilty with clients that understood only the old int64-based positions. At first, clients supported only the 'value' field. This version never made it to stable. We later added support for the 'compressed_value' field, and clients would populate either one or the other. In M30, we added the custom_compressed_v1 representation. This representation was better than the previous implementations in almost every way. However, we could not use it right away, since older clients would not understand it. We decided to write both the old-style ('value' or 'custom_compressed') representation and the 'custom_compressed_v1' repersentations to every protobuf during the transition period. Protobufs written during this transition period would be readable by clients who understand at least one of the two formats. In M33, we dropped support for writing the backwards-compatibility fields. Protobufs written by this version or later are not be intelligible by clients with version M29 or older. Those clients will end up making use of the old int64 position fallback mechanism.
Used in: , , ,
optional bytes value = 1
The uncompressed string of bytes representing the position. Deprecated. See history note above.
optional bytes compressed_value = 2
The client may choose to write a compressed position to this field instead of populating the 'value' above. If it chooses to use compression, the 'value' field above must be empty. The position value will be compressed with gzip and stored in the compressed_value field. The position's uncompressed length must be specified and written to the uncompressed_length field. Deprecated. See history note above.
optional uint64 uncompressed_length = 3
optional bytes custom_compressed_v1 = 4
This encoding uses compression scheme designed especially for unique positions. It has the property that X < Y precisely when Compressed(X) < Compressed(Y), which is very useful when the most common operation is to compare these positions against each other. Their values may remain compressed in memory. The compression scheme is implemented and documented in sync/core_impl/base/unique_position.cc. As of M30, this is the preferred encoding. Newer clients may continue to populate the 'value' and 'compressed_value' fields to ensure backwards compatibility, but they will always try to read from this field first.
message
test.proto:18required bool foo = 1
message
test.proto:22required bool foo = 1
required bool bar = 2
Both fields below must be filled in. Otherwise, this delete directive must be ignored.
Used in:
optional string url = 1
The URL that should be removed from history.
optional int64 end_time_usec = 2
The time on or before which entries must be deleted. In microseconds since the Unix epoch.
optional string app_id = 3
Optional field to filter the entries with the matching app ID. This field is set only by Android which has app-specific history feature that allows users to generate/delete history entries from Custom Tabs on app, not from BrApp.
message
user_consent_specifics.proto:24Next id: 17
=========================================================================== Fields common to all Chrome User Consents. ===========================================================================
Used in:
optional string locale = 4
The UI language Chrome is using, represented as the IETF language tag defined in BCP 47. The region subtag is not included when it adds no distinguishing information to the language tag (e.g. both "en-US" and "fr" are correct here).
optional int64 client_consent_time_usec = 12
The local time on the client when the user consent was recorded. The time as measured by client is given in microseconds since Windows epoch. This is needed since user consent recording may happen when a client is offline.
oneof consent
sync_consent = 7
arc_backup_and_restore_consent = 8
arc_location_service_consent = 9
arc_play_terms_of_service_consent = 10
unified_consent = 13
assistant_activity_control_consent = 14
account_passwords_consent = 15
optional string account_id = 6
The account ID of the user who gave the consent. This field is used by UserEventService to distinguish consents from different users, as UserConsent does not get deleted when a user signs out. However, it should be cleared before being sent over the wire, as the UserEvent is sent over an authenticated channel, so this information would be redundant. For semantics and usage of the |account_id| in the signin codebase, see IdentityManager::GetPrimaryAccountId() or CoreAccountId.
optional UserConsentSpecifics.Feature feature = 1
repeated int32 description_grd_ids = 2
Ids of the strings of the consent text presented to the user.
optional int32 confirmation_grd_id = 3
Id of the string of the UI element the user clicked when consenting.
optional UserConsentTypes.ConsentStatus status = 5
Was the consent for |feature| given or not given (denied/revoked)?
Which feature does the consent apply to?
Used in:
FEATURE_UNSPECIFIED = 0
CHROME_SYNC = 1
PLAY_STORE = 2
BACKUP_AND_RESTORE = 3
GOOGLE_LOCATION_SERVICE = 4
CHROME_UNIFIED_CONSENT = 5
ASSISTANT_ACTIVITY_CONTROL = 6
TODO(markusheintz): ASSISTANT_ACTIVITY_CONTROL was only added for compatibility with the Feature enum in UserEventSpecifics.UserConsent. Delete this value once the value is deleted from the other proto.
message
user_consent_types.proto:21(message has no fields)
message
user_consent_types.proto:161The User Consent for downloading and using passwords stored in the user's Google Account. Determined during the opt-in flow for the feature.
Used in:
repeated int32 description_grd_ids = 1
Ids of the strings of the consent text presented to the user.
optional int32 confirmation_grd_id = 2
Id of the string of the UI element the user clicked in order to confirm the consent dialog.
optional ConsentStatus status = 3
The status of the consent. This specifies whether the consent was given or not given/revoked.
message
user_consent_types.proto:44The user consent for the ARC Backup And Restore feature. The consent status is determined by the corresponding setting on the ARC setup dialog.
Used in:
repeated int32 description_grd_ids = 1
Ids of the strings of the setting text presented to the user.
optional int32 confirmation_grd_id = 2
Id of the string of the UI element the user clicked when consenting.
optional ConsentStatus status = 3
message
user_consent_types.proto:56The user consent for the Google Location Service. The consent status is determined by the corresponding setting on the ARC setup dialog.
Used in:
repeated int32 description_grd_ids = 1
Ids of the strings of the setting text presented to the user.
optional int32 confirmation_grd_id = 2
Id of the string of the UI element the user clicked when consenting.
optional ConsentStatus status = 3
message
user_consent_types.proto:68The user consent for the Play terms of service is determined by the user action on the ARC setup dialog that presents the Play Terms of Service.
Used in:
optional int32 play_terms_of_service_text_length = 1
The length of the UTF-8 encoded string of the Play Terms of Service text. The length is given in number of bytes.
optional bytes play_terms_of_service_hash = 2
The SHA1 hash of UTF-8 encoded string of the Play Terms of Service displayed to the user.
repeated int32 description_grd_ids = 5
GRD Ids of the strings on the consent UI that was shown to the user.
optional int32 confirmation_grd_id = 3
Id of the string of the UI element the user clicked when consenting.
optional ConsentStatus status = 4
The status of the Play Terms of Service consent. This specifies whether the consent was given or not given/revoked.
optional ArcPlayTermsOfServiceConsent.ConsentFlow consent_flow = 6
The user flow during which the consent was recorded. This is necessary in order to create the correct UI context and Event for the backend.
Enum describing different user flow during which the ARC Play Terms of service consent can be recorded.
Used in:
SETUP = 1
The ARC setup flow on a CROS device.
SETTING_CHANGE = 2
The user flow for changing the ARC setting on a CROS device.
message
user_consent_types.proto:133The User Consent for Assistant activity control is determined by the user action on the Assistant opt-in flow.
Used in:
optional bytes ui_audit_key = 1
An opaque token to for ui auditing, which strengthens the audit trail.
optional ConsentStatus status = 2
The status of the Assistant activity control consent. This specifies whether the consent was given or not given.
optional AssistantActivityControlConsent.SettingType setting_type = 3
The activity control setting which the consent was given or not given to. Clients before M93 did not set this field. Such consents should be treated as applying to ALL.
Enum denoting different Assistant activity control setting type.
Used in:
SETTING_TYPE_UNSPECIFIED = 0
Legacy clients (< M93) did not set a SettingType; for those, UNSPECIFIED should be interpreted as ALL. Newer clients should always set it explicitly.
ALL = 1
All Settings.
WEB_AND_APP_ACTIVITY = 2
DEVICE_APPS = 3
The status of a particular User Consent. The status describes the state of the consent as it is: given, not_given.
Used in: , , , , , , ,
CONSENT_STATUS_UNSPECIFIED = 0
The status is unspecified e.g. because the user was not asked to consent yet or an error happened or the decision was delayed.
NOT_GIVEN = 1
The consent is not given. This means the user either revoked the consent or did not grant it in the first place.
GIVEN = 2
The consent is given. This means the user did grant the consent.
message
user_consent_types.proto:102The User Consent for Chrome Sync is determined by the user action on the corresponding Sync Consent dialog.
Used in:
repeated int32 description_grd_ids = 1
Ids of the strings of the sync consent text presented to the user.
optional int32 confirmation_grd_id = 2
Id of the string of the UI element the user clicked in order to confirm and close the sync consent dialog.
optional ConsentStatus status = 3
The status of the sync consent. This specifies whether the consent was given or not given/revoked.
message
user_consent_types.proto:117The unified User Consent for Chrome is determined by the user action on the corresponding Chrome Consent dialog.
Used in:
repeated int32 description_grd_ids = 1
Ids of the strings of the unified Chrome consent text presented to the user.
optional int32 confirmation_grd_id = 2
Id of the string of the UI element the user clicked in order to confirm and close the unified Chrome consent dialog.
optional ConsentStatus status = 3
The status of the unified Chrome consent. This specifies whether the consent was given or not given/revoked.
Contains user profile information.
Used in:
optional string email = 1
Primary email address of the user.
optional string display_name = 2
The user's full name.
optional string profile_image_url = 3
Portrait photo of the user.
message
user_event_specifics.proto:23Used in:
optional int64 event_time_usec = 1
Time of event, as measured by client in microseconds since Windows epoch.
optional int64 navigation_id = 2
The |global_id| field of the associated navigation, if there is one.
optional fixed64 session_id = 3
On startup we generate a new random id to identify which FieldTrialEvents other events belonged to.
oneof event
test_event = 8
language_detection_event = 10
translation_event = 11
gaia_password_reuse_event = 104
Happens when a user types their Google account password on another site.
gaia_password_captured_event = 15
floc_id_computed_event = 16
message
user_event_specifics.proto:109Used in:
optional uint64 floc_id = 2
If not set, it means that the floc is disabled.
UNSPECIFIED = 0
NEW = 1
Event added because the floc id is computed for the 1st floc session.
REFRESHED = 2
Event added because the floc id is re-computed due to a long period of time has passed since the last computation.
HISTORY_DELETE = 3
Event added because the floc id is re-computed due to history deletion.
message
user_event_specifics.proto:98Logged when the user logs into Google, and at least once per 28d.
Used in:
optional GaiaPasswordCaptured.EventTrigger event_trigger = 1
Used in:
UNSPECIFIED = 0
USER_LOGGED_IN = 1
Event added because user logged in.
EXPIRED_28D_TIMER = 2
Event added because 28d timer fired.
message
user_event_specifics.proto:40Language detection output.
Used in:
repeated detected_languages = 1
Top n languages. Typically we just log the top language, but for page that we're not confident about, we may log up to 3 top languages in descending order.
optional string adopted_language_code = 2
Adopted language code is the code of final determined language. It will be stored only if it's different from the first detected language.
message
user_event_specifics.proto:43Used in:
optional string language_code = 1
ISO 639 language code will be used.
optional bool is_reliable = 2
Whether the detected language is reliable, note this is determined by the CLD3.
message
user_event_specifics.proto:37Used for testing and debugging EventLog system.
Used in:
(message has no fields)
message
user_event_specifics.proto:61User translated a page or interacted with translate suggestion.
Used in:
optional string from_language_code = 1
Source language of the translation.
optional string to_language_code = 2
Target language of the translation.
optional Translation.Interaction interaction = 3
Used in:
UNKNOWN = 0
ACCEPT = 1
DECLINE = 2
IGNORED = 3
This happens when user scroll or click outside the UI without translation.
DISMISSED = 4
This happens when user choose to close the translation window without translation.
MANUAL = 5
User manually entered either language. In this case, from_language_code and to_language_code will be user chosen values.
TRANSLATION_REVERTED = 6
User choose to revert the translation, in this case, from_language_code and to_language_code will be previous chosen values.
AUTO_TRANSLATION_BY_PREF = 7
Automatically triggered translation. User sets always translate in user settings.
AUTO_TRANSLATION_BY_LINK = 8
User navigated through a click from a translated page.
INITIALIZATION_ERROR = 9
Failed to initialize the translate script, this can happen for iOS due to CSPs.
Used in: ,
optional string user_id = 1
Obfuscated Gaia ID.
optional user_display_info = 2
optional cross_user_sharing_public_key = 3
Latest user's public key registered on the server.
message
autofill_specifics.proto:491Contains information about the cloud token data of server credit cards.
Used in:
optional string masked_card_id = 1
Server-generated ID string for the card this cloud token data is related to. This should match the id in WalletMaskedCreditCard for to fetch the corresponding actual card data. Note this is not unique across all cloud token data, which means one card can have multiple sets of cloud token data with the same masked_card_id.
optional string suffix = 2
Last 4-5 digits of the Cloud Primary Account Number (CPAN).
optional int32 exp_month = 3
CPAN Month number 1-12.
optional int32 exp_year = 4
CPAN Four-digit year (e.g. 2017).
optional string art_fife_url = 5
URL of the card art to be displayed for CPAN.
optional string instrument_token = 6
Opaque identifier for the cloud token.
message
autofill_specifics.proto:339Used in:
optional string id = 1
Server-generated unique ID string. This is opaque to the client. This is the legacy version of |instrument_id|.
optional WalletMaskedCreditCard.WalletCardStatus status = 2
What the server thinks of this card.
optional string name_on_card = 3
optional WalletMaskedCreditCard.WalletCardType type = 4
optional string last_four = 5
Last 4 digits of the credit card number.
optional int32 exp_month = 6
Month number 1-12.
optional int32 exp_year = 7
Four-digit year (e.g. 2017).
optional string billing_address_id = 8
The WalletPostalAddress.id of the billing address.
optional string bank_name = 10
Issuing Bank name which is internationalized (e.g. "Chase", "工商银行")
optional cloud_token_data = 11
TODO(crbug.com/1020740): Deprecated, remove this once dependent change is done. Use WalletCreditCardCloudTokenData instead. This field will be set if a cloud token is available for the instrument.
optional string nickname = 12
The card's nickname, if it exists.
optional card_issuer = 13
Issuer of the card.
optional int64 instrument_id = 15
Server-generated unique ID. This is opaque to the client. |id| is the legacy version of this.
optional WalletMaskedCreditCard.VirtualCardEnrollmentState virtual_card_enrollment_state = 16
The state of virtual card enrollment.
optional string card_art_url = 17
The URL for the client to fetch the card art image.
optional string product_description = 18
The product description for the card. Used to be shown in the UI.
optional WalletMaskedCreditCard.VirtualCardEnrollmentType virtual_card_enrollment_type = 19
The type of virtual card enrollment. kTypeUnspecified indicates that the card is unenrolled.
repeated card_benefit = 20
The benefits (e.g. points or discounts) associated with purchases made with the card.
optional string product_terms_url = 21
Separate link from the card issuer which provides additional context or terms and conditions regarding the credit card product and its benefits.
Used in:
UNSPECIFIED = 0
UNENROLLED = 1
ENROLLED = 2
UNENROLLED_AND_NOT_ELIGIBLE = 3
UNENROLLED_AND_ELIGIBLE = 4
Used in:
TYPE_UNSPECIFIED = 0
ISSUER = 1
NETWORK = 2
Used in:
VALID = 0
EXPIRED = 1
Used in:
UNKNOWN = 0
AMEX = 1
DISCOVER = 2
JCB = 3
MAESTRO = 4
MASTER_CARD = 5
SOLO = 6
SWITCH = 7
VISA = 8
UNIONPAY = 9
ELO = 10
message
autofill_specifics.proto:550Contains information of server IBAN (International Bank Account Number).
Used in: ,
optional string instrument_id = 1
Opaque identifier for the account stored in Payments Platform.
optional string prefix = 2
Prefix of the full IBAN value, if available.
optional string suffix = 3
Suffix of the full IBAN value, if available.
optional int32 length = 4
Length of the full IBAN value, if available.
optional string nickname = 5
Nickname for the IBAN, if available.
message
autofill_specifics.proto:630Wallet card usage information that can be synced.
Used in:
optional WalletMetadataSpecifics.Type type = 1
The type of the Wallet metadata.
optional string id = 2
Base64 encoding of the unique ID string of the corresponding AutofillMetadata. For Wallet cards, this value is WalletMaskedCreditCard::id. For Wallet IBANs, this value is WalletMaskedIban::instrument_id.
optional int64 use_count = 3
The number of times that this Wallet card or address was used.
optional int64 use_date = 4
The last use date of this Wallet card or address. Measured in microseconds since the Windows epoch (1601).
optional string card_billing_address_id = 5
The id of the profile/address that represents the billing address of this Wallet card.
optional bool address_has_converted = 6
Unused by the client since M121. TODO(crbug.com/1457187): Some server-side code still relies on this field. To keep the protos in sync, it is kept until that code is cleaned up.
Used in:
UNKNOWN = 0
CARD = 1
ADDRESS = 2
Unused by the client since M121. TODO(crbug.com/1457187): Some server-side code still relies on this. To keep the protos in sync, it is kept until that code is cleaned up.
IBAN = 3
message
autofill_specifics.proto:445Unused by the client since M121. TODO(crbug.com/1457187): Some server-side code still relies on this message. To keep the protos in sync, it is kept until that code is cleaned up. Different than an AutofillProfile because this represents some known address on the server that is pulled down rather than synced between Chromes.
Used in:
optional string id = 1
optional string recipient_name = 12
optional string company_name = 2
repeated string street_address = 3
This is the street address, of which there may be multiple lines. This corresponds to "address_home_line[1|2] in the AutofillProfileSpecifics message above. In some locales there may be more than two lines.
optional string address_1 = 4
Also known as "administrative area". This is normally the state or province in most countries.
optional string address_2 = 5
Also known as "locality". In the US this is the city.
optional string address_3 = 6
A sub-classification beneath the city, e.g. an inner-city district or suburb. Also known as "dependent_locality"
optional string address_4 = 7
Used in certain countries. Also known as "sub_dependent_locality".
optional string postal_code = 8
optional string sorting_code = 9
Similar to the zipcode column, but used for businesses or organizations that might not be geographically contiguous. The canonical example is CEDEX in France.
optional string country_code = 10
optional string language_code = 11
optional string phone_number = 13
Phone number. The format is unspecified and will be explicitly ignored.
message
experiments_specifics.proto:68Flags for enabling wallet data syncing.
Used in:
optional bool enabled = 1
message
web_apk_specifics.proto:21Sync & local data: Information about web app icon.
Used in:
optional int32 size_in_px = 1
The size of the square app icon, in raw pixels.
optional string url = 2
The URL of the app icon.
optional WebApkIconInfo.Purpose purpose = 3
The purpose or context in which the icon should be used.
Used in:
UNSPECIFIED = 0
ANY = 1
Suitable for any purpose.
MASKABLE = 2
Designed for masking.
MONOCHROME = 3
Suitable for monochrome purposes.
message
web_apk_specifics.proto:41WebApk data.
Used in:
optional string manifest_id = 1
optional string start_url = 2
optional string name = 3
optional uint32 theme_color = 4
optional string scope = 5
repeated icon_infos = 6
optional int64 last_used_time_windows_epoch_micros = 7
Time when this WebApk was last used or installed. Number of microseconds since 1601, aka Windows epoch.
message
web_app_specifics.proto:21Sync & local data: Information about web app icon.
Used in:
optional int32 size_in_px = 1
The size of the square app icon, in raw pixels.
optional string url = 2
The URL of the app icon.
optional WebAppIconInfo.Purpose purpose = 3
The purpose or context in which the icon should be used.
Used in:
UNSPECIFIED = 0
ANY = 1
Suitable for any purpose.
MASKABLE = 2
Designed for masking.
MONOCHROME = 3
Suitable for monochrome purposes.
message
web_app_specifics.proto:42WebApp data. This is a synced part of chrome/browser/web_applications/proto/web_app.proto data.
Used in:
optional string start_url = 1
optional string name = 2
optional WebAppSpecifics.UserDisplayMode user_display_mode_default = 3
User-selected display setting, which may be used if no platform-specific setting is available (eg. on Windows, Mac, and Linux). If absent, user_display_mode_cros may be used as fallback (if populated). On pre-M122 devices this field is used by all platforms (ie. ChromeOS, Windows, Mac, Linux) and always replaces any locally-stored value, with absent/unspecified falling back to standalone.
optional uint32 theme_color = 4
optional string scope = 5
repeated icon_infos = 6
optional string user_page_ordinal = 7
Used to store the page number that the app is displayed on in chrome://apps.
optional string user_launch_ordinal = 8
Used to store the in-page ranking for ordering apps in its given |user_page_ordinal| page.
optional string relative_manifest_id = 9
Used to store id specified in the manifest. This is a path that is relative to the start_url, similar to how the id field is parsed in https://www.w3.org/TR/appmanifest/#id-member, except this field does not include a scheme or origin. This is only the path after the origin, excluding the first "/". Note: If this field is not set, then the manifest_id is generated using the start_url in GenerateManifestIdFromStartUrlOnly. This is different than if this is set to "", which means the manifest_id will be set to the origin of the start_url.
optional WebAppSpecifics.UserDisplayMode user_display_mode_cros = 10
User-selected display setting for ChromeOS. If absent, user_display_mode_default may be used as fallback (if populated). Introduced in M122.
This enum should be a subset of the DisplayMode enum in chrome/browser/web_applications/proto/web_app.proto and third_party/blink/public/mojom/manifest/display_mode.mojom
Used in:
UNSPECIFIED = 0
BROWSER = 1
STANDALONE = 3
MINIMAL_UI is never serialized.
TABBED = 6
FULLSCREEN is never serialized. WINDOW_CONTROLS_OVERLAY is never serialized.
BORDERLESS is never serialized. PICTURE_IN_PICTURE is never serialized.
WebauthnCredentialSpecifics is an entity that backs a WebAuthn PublicKeyCredential. Since it contains the authenticator’s view of this object, it has a private key rather than a public key. (https://www.w3.org/TR/webauthn-2/#iface-pkcredential). Names of fields are taken from WebAuthn where possible. E.g. user.displayName in WebAuthn becomes user_display_name here. All fields are immutable after creation except for user_name and user_display_name, which may be updated by a user.
Used in:
optional bytes sync_id = 1
Sync's ID for this entity (sometimes called the client unique tag), 16 random bytes. This value is used within Sync to identify this entity. The credential ID is not used because the (hashed) sync_id is exposed to the Sync server, and we don’t want Google to be able to map a credential ID to an account. Password entities construct this value from the concatenation of many fields and depend on the fact that the server only sees a hash of it. But the only high-entropy secret here is the private key, which will have different encryption in the future, and private keys are not the sort of data to copy into other fields. Therefore this independent value is provided to form the client's ID.
optional bytes credential_id = 2
The credential ID, 16 random bytes. This is a value surfaced in the WebAuthn API (https://www.w3.org/TR/webauthn-2/#credential-id).
optional string rp_id = 3
An RP ID is a WebAuthn concept: https://www.w3.org/TR/webauthn-2/#rp-id. It’s usually a domain name, although in non-Web contexts it can be a URL with a non-Web scheme.
optional bytes user_id = 4
The user ID, which is also called a “user handle” in WebAuthn (https://www.w3.org/TR/webauthn-2/#user-handle), is an RP-specific identifier that is up to 64-bytes long. An authenticator conceptually only stores a single credential for a given (rp_id, user_id) pair, but there may be several credentials in Sync. They are prioritised using newly_shadowed_credential_ids and creation_time. See below. (We wish to be able to retain several entities for a single (rp_id, user_id) pair because there’s an edge case where we may wish to revert to an older entry and thus need to keep the older entry around in Sync. The revert could happen on a different device too.)
repeated bytes newly_shadowed_credential_ids = 5
The id of credentials with the same (rp_id, user_id) that were shadowed by the creation of this entity. A credential is shadowed if one or more other credentials (from the same account, and with the same (rp_id, user_id)) include its credential_id in their list of shadowed IDs. Shadowed credentials are ignored when finding a credential to sign with. If there is more than one candidate remaining after filtering shadowed credentials then the most recently created (based on creation_time) is used. The reason for all this is that sites can replace a credential by creating another one with the same (rp_id, user_id) pair. However, we don't immediately know whether the WebAuthn response reached the website's server. Consider a user with a poor internet connection. Javascript in the site's origin triggers a credential creation that “overwrites” an existing credential, but the Javascript is unable to send the new public key to the website's server. The user is now locked out: the old credential has been over-written but the website's server doesn't know about the new one. Thus we wish to keep “overwritten” credentials around for a while to allow for some sort of recovery. In the simple case, a new credential shadows the single, previous old credential. We could depend on creation_time, but client clocks aren't always accurate, thus this field. In complicated cases two devices might race to replace a credential, in which case (after mutual syncing) two candidate credentials exist for the same (rp_id, user_id) pair because neither shadows the other. In this case we pick the newest based on |creation_time| but it's quite possible that some recovery will be needed because the website's server thinks the other one is correct. A generation counter isn't used because a single device might replace a series of credentials as it tries to update the website's server. But that doesn't mean that it should dominate a different device that replaced it only once, but later.
optional int64 creation_time = 6
The local time on the device when this credential was created. Given in milliseconds since the UNIX epoch. This is used to break ties between credentials. See newly_shadowed_credential_ids.
optional string user_name = 7
The human-readable account identifier. Usually an email address. This is mutable. https://www.w3.org/TR/webauthn-2/#dom-publickeycredentialentity-name
optional string user_display_name = 8
The human-readable name. Usually a legal name. This is mutable. https://www.w3.org/TR/webauthn-2/#dom-publickeycredentialuserentity-displayname.
optional bool third_party_payments_support = 11
Credentials may optionally be enabled for Secure Payment Confirmation[1] on third-party sites. This is opt-in at creation time. [1] https://www.w3.org/TR/secure-payment-confirmation/
optional int64 last_used_time_windows_epoch_micros = 13
Time when this passkey was last successfully asserted. Number of microseconds since 1601, aka Windows epoch. This mirrors the `date_last_used` field in PasswordSpecificsData.
optional int32 key_version = 14
The "version" (sometimes called the epoch) of the key that `encrypted_data` is encrypted with. This allows trial decryption to be avoided when present.
oneof encrypted_data
bytes private_key = 9
The bytes of the private key, encrypted with a feature-specific security domain.
bytes encrypted = 12
A serialized, `Encrypted` message, encrypted with a feature-specific security domain.
optional bytes private_key = 1
The bytes of the private key, in PKCS#8 format.
optional bytes hmac_secret = 2
The secret for implementing the hmac-secret extension https://fidoalliance.org/specs/fido-v2.1-ps-20210615/fido-client-to-authenticator-protocol-v2.1-ps-errata-20220621.html#sctn-hmac-secret-extension
optional bytes cred_blob = 3
The contents of the credential's credBlob. https://fidoalliance.org/specs/fido-v2.1-ps-20210615/fido-client-to-authenticator-protocol-v2.1-ps-errata-20220621.html#sctn-credBlob-extension
optional bytes large_blob = 4
The contents of the credential's largeBlob value(*). Unlike with security keys, largeBlob data is not stored in a single lump for all credentials, but as per-credential data. This data is presented to the authenticator over CTAP and thus has already had the required DEFLATE compression applied by the remote platform. The uncompressed size of this data is in the next field. (*) "large" with respect to embedded devices. Maximum length is 2KiB for Google Password Manager. https://fidoalliance.org/specs/fido-v2.1-ps-20210615/fido-client-to-authenticator-protocol-v2.1-ps-errata-20220621.html#authenticatorLargeBlobs
optional uint64 large_blob_uncompressed_size = 5
The claimed uncompressed size of the DEFLATE-compressed data in `large_blob`. This corresponds to the `origSize` field from the spec: https://fidoalliance.org/specs/fido-v2.1-ps-20210615/fido-client-to-authenticator-protocol-v2.1-ps-errata-20220621.html#large-blob
Used in:
optional bytes hex_ssid = 1
SSID encoded to hex, letters should be upper case and 0x prefix should be omitted. For example, ssid "network" would be provided as "6E6574776F726B".
optional WifiConfigurationSpecifics.SecurityType security_type = 2
optional bytes passphrase = 3
The passphrase can be ASCII, UTF-8, or a string of hex digits.
optional WifiConfigurationSpecifics.AutomaticallyConnectOption automatically_connect = 4
optional WifiConfigurationSpecifics.IsPreferredOption is_preferred = 5
optional WifiConfigurationSpecifics.MeteredOption metered = 6
optional proxy_configuration = 7
optional WifiConfigurationSpecifics.DnsOption dns_option = 10
repeated string custom_dns = 8
List of DNS servers to be used when set to DNS_OPTION_CUSTOM. Up to 4.
optional int64 last_connected_timestamp = 9
The last time this configuration was connected to before being synced. It will only be updated when the configuration is changed. This is represented with the UNIX timestamp, ms since epoch.
Used in:
AUTOMATICALLY_CONNECT_UNSPECIFIED = 0
AUTOMATICALLY_CONNECT_DISABLED = 1
AUTOMATICALLY_CONNECT_ENABLED = 2
Used in:
DNS_OPTION_UNSPECIFIED = 0
DNS_OPTION_DEFAULT_DHCP = 1
DNS_OPTION_CUSTOM = 2
Used in:
IS_PREFERRED_UNSPECIFIED = 0
IS_PREFERRED_DISABLED = 1
IS_PREFERRED_ENABLED = 2
Used in:
METERED_OPTION_UNSPECIFIED = 0
METERED_OPTION_NO = 1
METERED_OPTION_YES = 2
METERED_OPTION_AUTO = 3
Allows the device to use heuristics to determine if network is metered.
Used in:
optional ProxyConfiguration.ProxyOption proxy_option = 1
optional string autoconfiguration_url = 2
Only set if PROXY_OPTION_AUTOMATIC.
optional manual_proxy_configuration = 3
Only set if PROXY_OPTION_MANUAL.
Used in:
optional string http_proxy_url = 1
optional int32 http_proxy_port = 2
optional string secure_http_proxy_url = 3
optional int32 secure_http_proxy_port = 4
optional string socks_host_url = 5
optional int32 socks_host_port = 6
repeated string excluded_domains = 7
Used in:
PROXY_OPTION_UNSPECIFIED = 0
PROXY_OPTION_DISABLED = 1
PROXY_OPTION_AUTOMATIC = 2
Use a Proxy Auto-config(PAC) Url, set in proxy_url
PROXY_OPTION_AUTODISCOVERY = 3
Uses Web Proxy Auto-Discovery Protocol (WPAD) to discover the proxy settings using DHCP/DNS.
PROXY_OPTION_MANUAL = 4
User sets details in manual_proxy_configuration.
Used in:
SECURITY_TYPE_UNSPECIFIED = 0
SECURITY_TYPE_NONE = 1
SECURITY_TYPE_WEP = 2
SECURITY_TYPE_PSK = 3
WPA-PSK or RSN-PSK
A workspace desk entry. This proto contains the fields synced to represent a saved desk in user's workspace.
Used in:
optional string uuid = 1
A random unique identifier for each desk. Required.
optional string name = 2
The name of the desk being saved.
optional int64 created_time_windows_epoch_micros = 3
The time this snapshot of desk was created.
optional int64 updated_time_windows_epoch_micros = 5
The time this snapshot of desk was updated.
optional desk = 4
optional WorkspaceDeskSpecifics.DeskType desk_type = 6
The type of a desk.
optional string client_cache_guid = 7
The cache guid of the syncing client. Used to identify a unique device that's syncing data.
optional SyncEnums.DeviceFormFactor device_form_factor = 8
The form factor of the device.
A Launchable app in template.
Used in:
optional window_bound = 1
The on-display location of this window.
optional WindowState window_state = 2
optional int32 z_index = 3
The z-index of this app relative to other apps in this template. App with larger z-index appears in front of app with smaller z-index.
optional app = 4
optional int32 window_id = 5
window_id used to instantiate proto as a restore_data object. The restore_data object in question can be found at: //components/app_restore/restore_data.h
optional int64 display_id = 6
Display ID this app is on.
optional WindowState pre_minimized_window_state = 7
State of a window before it was minimized. Empty/unset for non-minimized windows.
optional LaunchContainer container = 8
Container this app was launched from. Empty/unset for Arc apps.
optional WindowOpenDisposition disposition = 9
Window open disposition, defines how a window opens. Empty/unset for Arc apps.
optional string app_name = 10
Name of the app which is used by the browser to determine whether to launch an app as an app or a tab. Does not contain a human readable name but contains the app ID and a prefix.
optional string title = 11
Human readable title of the app.
optional int32 snap_percentage = 12
This is used to determine the size of a snapped window is in clamshell mode. Empty/unset for non-snapped windows. This should be a value between 0 and 100.
optional string override_url = 13
The override URL can be specified by apps to override the default URL at launch.
Used in:
oneof app
browser_app_window = 1
chrome_app = 2
progress_web_app = 3
arc_app = 4
An Arc App window.
Used in:
optional string app_id = 1
The Arc App's ID.
optional minimum_size = 2
Arc window information. This maps to ArcExtraInfo in a WindowInfo struct.
optional maximum_size = 3
optional bounds_in_root = 5
maps to gfx::Size. Width of the window, including the frame, in pixels.
Used in:
optional int32 width = 1
optional int32 height = 2
A Chrome or Lacros Browser app window.
Used in:
repeated tabs = 1
The tabs in this browser window.
optional int32 active_tab_index = 2
The index of the currently active tab.
optional bool show_as_app = 3
Indicates whether to show as a dedicated app window.
repeated tab_groups = 4
Tab groups associated with this window.
optional int32 first_non_pinned_tab_index = 5
The index of the first non-pinned tab.
Used in:
optional string url = 1
The last committed URL of the main frame of the tab.
optional string title = 2
The title of the tab.
Structure representing a tab group associated with this window.
Used in:
optional int32 first_index = 1
Zero-based index within the browser app tabs of the first tab in the group.
optional int32 last_index = 2
Zero-based Index wotjom the browser app tabs of the last tab in the group.
optional string title = 3
User readable title of the tab group.
optional TabGroupColor color = 4
Color associated with this tab group.
optional bool is_collapsed = 5
Indicates whether the tab group is collapsed.
A Chrome App window.
Used in:
optional string app_id = 1
The Chrome App's App ID.
Represent a snapshot of the information on a desk.
Used in:
repeated apps = 1
The apps in this template.
Enumerates the type of desk, namely to differentiate desks between desks saved for desk templates and desks saved for save and recall.
Used in:
UNKNOWN_TYPE = 0
TEMPLATE = 1
SAVE_AND_RECALL = 2
FLOATING_WORKSPACE = 3
Enumeration for the container an app was launched from as used by (components/services/app_services/public/mojom/types.mojom:490).
Used in:
LAUNCH_CONTAINER_UNSPECIFIED = 0
LAUNCH_CONTAINER_WINDOW = 1
LAUNCH_CONTAINER_PANEL_DEPRECATED = 2
LAUNCH_CONTAINER_TAB = 3
LAUNCH_CONTAINER_NONE = 4
A PWA window.
Used in:
optional string app_id = 1
The PWA's App ID.
Enumerates the possible colors that a tab group can have. This mirrors the enumeration that can be found in components/tab_groups/tab_group_color.h
Used in:
UNKNOWN_COLOR = 0
GREY = 1
BLUE = 2
RED = 3
YELLOW = 4
GREEN = 5
PINK = 6
PURPLE = 7
CYAN = 8
ORANGE = 9
Used in: ,
optional int32 top = 1
The offset of the window from the top edge of the screen in pixels.
optional int32 left = 2
The offset of the window from the left edge of the screen in pixels.
optional int32 width = 3
The width of the window, including the frame, in pixels.
optional int32 height = 4
The height of the window, including the frame, in pixels.
Enumeration for how a window opens. Maps to base::WindowOpenDisposition. (found in ui/base/window_open_disposition.h:10). Does not include MAX_VALUE as MAX_VALUE is equivalent to NEW_PICTURE_IN_PICTURE. All comments are copied verbatim from aforementioned header.
Used in:
UNKNOWN = 0
CURRENT_TAB = 1
SINGLETON_TAB = 2
Indicates that only one tab with the URL shoul exist in the same window.
NEW_FOREGROUND_TAB = 3
NEW_BACKGROUND_TAB = 4
NEW_POPUP = 5
NEW_WINDOW = 6
SAVE_TO_DISK = 7
OFF_THE_RECORD = 8
IGNORE_ACTION = 9
SWITCH_TO_TAB = 10
Activates an existing tab containing the URL, rather than navigating. This is similar to SINGLETON_TAB, but searches across all windows from the current profile and anymity (instead of tjust the current one); closes the current tab on switching if the current ta was the NTP with no session history; and behaves like CURRENT_TAB instead of NEW_FOREGROUND_TAB when no existing tab is found.
NEW_PICTURE_IN_PICTURE = 11
creates a new document picture-in-picture window showing a child WebView.
The state of a generic window.
Used in:
UNKNOWN_WINDOW_STATE = 0
NORMAL = 1
Normal window state (not minimized, maximized, or fullscreen).
MINIMIZED = 2
Minimized window state.
MAXIMIZED = 3
Maximized window state.
FULLSCREEN = 4
Fullscreen window state.
PRIMARY_SNAPPED = 5
Snapped to primary half of the screen. Primary half is on the left in landscape screen orientation and top in portrait screen orientation.
SECONDARY_SNAPPED = 6
Snapped to secondary half of the screen. Secondary half is on the right in landscape screen orientation and bottom in portrait screen orientation.
FLOATED = 7
Floated window state.