Default package

Get desktop application:
View/edit binary Protocol Buffers messages

Describes which Hangouts client is active.

Used in: StateUpdateHeader

• ACTIVE_CLIENT_STATE_NO_ACTIVE = 0

  No client is active.

• ACTIVE_CLIENT_STATE_IS_ACTIVE = 1

  This is the active client.

• ACTIVE_CLIENT_STATE_OTHER_ACTIVE = 2

  Other client is active.

• optional RequestHeader request_header = 1

• repeated InviteeID invitee_id = 3

• optional EventRequestHeader event_request_header = 5

• optional ResponseHeader response_header = 1

• optional Event created_event = 5

An attachment for a chat message.

Used in: MessageContent

• optional EmbedItem embed_item = 1

List of StateUpdate messages to allow pushing multiple notifications from the server to the client simultaneously.

• repeated StateUpdate state_update = 1

Used in: StateUpdate

• repeated BlockStateChange block_state_change = 1

Used in: BlockStateChange

• BLOCK_STATE_UNKNOWN = 0

• BLOCK_STATE_BLOCK = 1

• BLOCK_STATE_UNBLOCK = 2

Used in: BlockNotification

• optional ParticipantId participant_id = 1

• optional BlockState new_block_state = 2

Used in: PhoneData

• CALLER_ID_SETTINGS_MASK_UNKNOWN = 0

• CALLER_ID_SETTINGS_MASK_PROVIDED = 1

A chat message in a conversation.

Used in: Event

• repeated EventAnnotation annotation = 2

  Optional annotation to attach to message.

• optional MessageContent message_content = 3

  The message's content.

Used in: SendChatMessageRequest, StatusMessageSetting

• repeated Segment segment = 1

Build type of the client.

Used in: ClientVersion

• BUILD_TYPE_UNKNOWN = 0

• BUILD_TYPE_PRODUCTION_WEB = 1

  Web app (not used anymore?).

• BUILD_TYPE_PRODUCTION_APP = 3

  Native app.

Identifies the client.

Used in: ClientVersion

• CLIENT_ID_UNKNOWN = 0

• CLIENT_ID_ANDROID = 1

  Hangouts app for Android.

• CLIENT_ID_IOS = 2

  Hangouts app for iOS.

• CLIENT_ID_CHROME = 3

  Hangouts Chrome extension.

• CLIENT_ID_WEB_GPLUS = 5

  Hangouts web interface in Google Plus.

• CLIENT_ID_WEB_GMAIL = 6

  Hangouts web interface in Gmail.

• CLIENT_ID_ULTRAVIOLET = 13

  Hangouts Chrome app ("ultraviolet").

• CLIENT_ID_WEB_HANGOUTS = 44

  Hangouts web app (https://hangouts.google.com).

Used in: ClientPresenceState, RequestHeader

• optional string resource = 1

  (client_id in hangups).

• optional string header_id = 2

  unknown (header_id in hangups).

Used in: SelfPresenceNotification

• optional ClientIdentifier identifier = 1

• optional ClientPresenceStateType state = 2

Used in: ClientPresenceState, PresenceStateSetting

• CLIENT_PRESENCE_STATE_UNKNOWN = 0

• CLIENT_PRESENCE_STATE_NONE = 1

• CLIENT_PRESENCE_STATE_DESKTOP_IDLE = 30

• CLIENT_PRESENCE_STATE_DESKTOP_ACTIVE = 40

The client and device version.

Used in: RequestHeader

• optional ClientId client_id = 1

  Identifies the client.

• optional ClientBuildType build_type = 2

  The client build type.

• optional string major_version = 3

  Client version.

• optional uint64 version_timestamp = 4

  Client version timestamp.

• optional string device_os_version = 5

  OS version string (for native apps).

• optional string device_hardware = 6

  Device hardware name (for native apps).

Used in: GetSelfInfoResponse, SetNotificationSettingNotification

• optional ConfigurationBitType configuration_bit_type = 1

• optional bool value = 2

A type of binary configuration option.

Used in: ConfigurationBit

• CONFIGURATION_BIT_TYPE_UNKNOWN = 0

• CONFIGURATION_BIT_TYPE_UNKNOWN_1 = 1

• CONFIGURATION_BIT_TYPE_UNKNOWN_2 = 2

• CONFIGURATION_BIT_TYPE_UNKNOWN_3 = 3

• CONFIGURATION_BIT_TYPE_UNKNOWN_4 = 4

• CONFIGURATION_BIT_TYPE_UNKNOWN_5 = 5

• CONFIGURATION_BIT_TYPE_UNKNOWN_6 = 6

• CONFIGURATION_BIT_TYPE_UNKNOWN_7 = 7

• CONFIGURATION_BIT_TYPE_UNKNOWN_8 = 8

• CONFIGURATION_BIT_TYPE_UNKNOWN_9 = 9

• CONFIGURATION_BIT_TYPE_UNKNOWN_10 = 10

• CONFIGURATION_BIT_TYPE_UNKNOWN_11 = 11

• CONFIGURATION_BIT_TYPE_UNKNOWN_12 = 12

• CONFIGURATION_BIT_TYPE_UNKNOWN_13 = 13

• CONFIGURATION_BIT_TYPE_UNKNOWN_14 = 14

• CONFIGURATION_BIT_TYPE_UNKNOWN_15 = 15

• CONFIGURATION_BIT_TYPE_UNKNOWN_16 = 16

• CONFIGURATION_BIT_TYPE_UNKNOWN_17 = 17

• CONFIGURATION_BIT_TYPE_UNKNOWN_18 = 18

• CONFIGURATION_BIT_TYPE_UNKNOWN_19 = 19

• CONFIGURATION_BIT_TYPE_UNKNOWN_20 = 20

• CONFIGURATION_BIT_TYPE_UNKNOWN_21 = 21

• CONFIGURATION_BIT_TYPE_UNKNOWN_22 = 22

• CONFIGURATION_BIT_TYPE_UNKNOWN_23 = 23

• CONFIGURATION_BIT_TYPE_UNKNOWN_24 = 24

• CONFIGURATION_BIT_TYPE_UNKNOWN_25 = 25

• CONFIGURATION_BIT_TYPE_UNKNOWN_26 = 26

• CONFIGURATION_BIT_TYPE_UNKNOWN_27 = 27

• CONFIGURATION_BIT_TYPE_UNKNOWN_28 = 28

• CONFIGURATION_BIT_TYPE_UNKNOWN_29 = 29

• CONFIGURATION_BIT_TYPE_UNKNOWN_30 = 30

• CONFIGURATION_BIT_TYPE_UNKNOWN_31 = 31

• CONFIGURATION_BIT_TYPE_UNKNOWN_32 = 32

• CONFIGURATION_BIT_TYPE_UNKNOWN_33 = 33

• CONFIGURATION_BIT_TYPE_DESKTOP_AUTO_EMOJI_CONVERSION_ENABLED = 34

• CONFIGURATION_BIT_TYPE_UNKNOWN_35 = 35

• CONFIGURATION_BIT_TYPE_UNKNOWN_36 = 36

• CONFIGURATION_BIT_TYPE_DESKTOP_COMPACT_MODE_ENABLED = 38

A conversation between two or more users.

Used in: ConversationNotification, ConversationState, CreateConversationResponse, SetGroupLinkSharingEnabledResponse, StateUpdate

• optional ConversationId conversation_id = 1

• optional ConversationType type = 2

• optional string name = 3

• optional UserConversationState self_conversation_state = 4

• repeated UserReadState read_state = 8

  Read state (watermark position) for every conversation participant.

• optional bool has_active_hangout = 9

  True if the conversation has an active Hangout.

• optional OffTheRecordStatus otr_status = 10

  The conversation's "off the record" status.

• optional OffTheRecordToggle otr_toggle = 11

  Whether the OTR toggle is available to the user for this conversation.

• optional bool conversation_history_supported = 12

• repeated ParticipantId current_participant = 13

• repeated ConversationParticipantData participant_data = 14

• repeated NetworkType network_type = 18

• optional ForceHistory force_history_state = 19

• optional GroupLinkSharingStatus group_link_sharing_status = 22

Identifies a conversation.

Used in: Conversation, ConversationSpec, ConversationState, ConversationViewModification, DeleteActionNotification, DeleteConversationRequest, EasterEggNotification, EasterEggRequest, Event, EventRequestHeader, GetGroupConversationUrlRequest, ReplyToInviteNotification, SetConversationNotificationLevelNotification, SetConversationNotificationLevelRequest, SetFocusNotification, SetFocusRequest, SetTypingNotification, SetTypingRequest, UpdateWatermarkRequest, WatermarkNotification

• optional string id = 1

  Unique identifier for a conversation.

Used in: StateUpdate

• optional Conversation conversation = 1

Used in: Conversation

• optional ParticipantId id = 1

• optional string fallback_name = 2

• optional InvitationStatus invitation_status = 3

• optional ParticipantType participant_type = 5

• optional InvitationStatus new_invitation_status = 6

Used in: Event

• optional string new_name = 1

• optional string old_name = 2

Used in: GetConversationRequest

• optional ConversationId conversation_id = 1

State of a conversation and recent events.

Used in: GetConversationResponse, SyncAllNewEventsResponse, SyncRecentConversationsResponse

• optional ConversationId conversation_id = 1

• optional Conversation conversation = 2

• repeated Event event = 3

• optional EventContinuationToken event_continuation_token = 5

Used in: UserConversationState

• CONVERSATION_STATUS_UNKNOWN = 0

• CONVERSATION_STATUS_INVITED = 1

  User is invited to conversation.

• CONVERSATION_STATUS_ACTIVE = 2

  User is participating in conversation.

• CONVERSATION_STATUS_LEFT = 3

  User has left conversation.

Used in: Conversation, CreateConversationRequest

• CONVERSATION_TYPE_UNKNOWN = 0

• CONVERSATION_TYPE_ONE_TO_ONE = 1

  Conversation is one-to-one (only 2 participants).

• CONVERSATION_TYPE_GROUP = 2

  Conversation is group (any number of participants).

Used in: ConversationViewModification, UserConversationState

• CONVERSATION_VIEW_UNKNOWN = 0

• CONVERSATION_VIEW_INBOX = 1

  Conversation is in inbox.

• CONVERSATION_VIEW_ARCHIVED = 2

  Conversation has been archived.

Used in: StateUpdate

• optional ConversationId conversation_id = 1

• optional ConversationView old_view = 2

• optional ConversationView new_view = 3

Describes a user's country.

Used in: GetSelfInfoResponse

• optional string region_code = 1

  Abbreviated region code (eg. "CA").

• optional uint64 country_code = 2

  Country's calling code (eg. "1").

• optional RequestHeader request_header = 1

• optional ConversationType type = 2

• optional uint64 client_generated_id = 3

• optional string name = 4

• repeated InviteeID invitee_id = 5

• optional ResponseHeader response_header = 1

• optional Conversation conversation = 2

• optional bool new_conversation_created = 7

Used in: DeleteActionNotification, DeleteConversationResponse

• optional uint64 delete_action_timestamp = 1

• optional uint64 delete_upper_bound_timestamp = 2

• optional DeleteType delete_type = 3

Used in: StateUpdate

• optional ConversationId conversation_id = 1

• optional DeleteAction delete_action = 2

• optional RequestHeader request_header = 1

• optional ConversationId conversation_id = 2

• optional uint64 delete_upper_bound_timestamp = 3

• optional ResponseHeader response_header = 1

• optional DeleteAction delete_action = 2

Used in: DeleteAction

• DELETE_TYPE_UNKNOWN = 0

• DELETE_TYPE_UPPER_BOUND = 1

Used in: DeliveryMediumOption, Event, EventRequestHeader

• optional DeliveryMediumType medium_type = 1

• optional PhoneNumber phone_number = 2

  Phone number to use for sending Google Voice messages.

Used in: UserConversationState

• optional DeliveryMedium delivery_medium = 1

• optional bool current_default = 2

Used in: DeliveryMedium

• DELIVERY_MEDIUM_UNKNOWN = 0

• DELIVERY_MEDIUM_BABEL = 1

• DELIVERY_MEDIUM_GOOGLE_VOICE = 2

• DELIVERY_MEDIUM_LOCAL_SMS = 3

Used in: GetSelfInfoResponse, SelfPresenceNotification, SetPresenceRequest

• optional bool desktop_off = 1

  State of "desktop off" setting.

Used in: GetSelfInfoResponse, SelfPresenceNotification

• optional bool desktop_off = 1

  Whether Hangouts desktop is signed off or on.

• optional uint64 version = 2

Sound settings in the desktop Hangouts client.

Used in: GetSelfInfoResponse, SetNotificationSettingNotification

• optional SoundState desktop_sound_state = 1

  Whether to play sound for incoming messages.

• optional SoundState desktop_ring_sound_state = 2

  Whether to ring for incoming calls.

Indicates whether Hangouts is active (running in the foreground) on different types of devices.

Used in: Presence

• optional bool mobile = 1

  True if a mobile phone is active.

• optional bool desktop = 2

  True if a desktop or laptop is active.

• optional bool tablet = 3

  True if a tablet is active.

Enable or disable do-not-disturb mode. Not to be confused with DoNotDisturbSetting, which is used to indicate the state of do-not-disturb mode.

Used in: SetPresenceRequest

• optional bool do_not_disturb = 1

  Whether to enable or disable do-not-disturb mode.

• optional uint64 timeout_secs = 2

  Do not disturb expiration in seconds.

The state of do-not-disturb mode. Not to be confused with DndSetting, which is used to change the state of do-not-disturb mode.

Used in: GetSelfInfoResponse, NotificationSettings, SelfPresenceNotification

• optional bool do_not_disturb = 1

  Whether do-not-disturb mode is enabled.

• optional uint64 expiration_timestamp = 2

  Timestamp when do-not-disturb mode expires.

• optional uint64 version = 3

  Timestamp when this setting was applied. Not present when this message comes from a notification.

Used in: EasterEggNotification, EasterEggRequest

• optional string message = 1

Used in: StateUpdate

• optional ParticipantId sender_id = 1

• optional ConversationId conversation_id = 2

• optional EasterEgg easter_egg = 3

• optional RequestHeader request_header = 1

• optional ConversationId conversation_id = 2

• optional EasterEgg easter_egg = 3

• optional ResponseHeader response_header = 1

• optional uint64 timestamp = 2

An item of some type embedded in a chat message.

Used in: Attachment, Place

• repeated ItemType type = 1

  List of embedded item types in this message.

• optional string id = 2

  For photos this is not given, for maps, it's the URL of the map.

• optional PlusPhoto plus_photo = 27639957

  Embedded Google Plus photo.

• optional Place place = 35825640

  Embedded Google Map of a place.

• optional EmbedItem.PostalAddress postal_address = 36003298

  Embedded postal address.

• optional EmbedItem.GeoCoordinates geo_coordinates = 36736749

  Embedded geographical coordinates.

• optional EmbedItem.Image image = 40265033

  Embedded image.

Used in: EmbedItem

• optional double latitude = 36

• optional double longitude = 37

Used in: EmbedItem

• optional string url = 1

Used in: EmbedItem

• optional string street_address = 35

A user that can participate in conversations.

Used in: EntityResult, GetEntityByIdResponse, GetSelfInfoResponse, GetSuggestedEntitiesResponse, SearchEntitiesResponse, SuggestedContact

• optional ParticipantId id = 9

  The user's ID.

• optional Presence presence = 8

  Optional user presence status.

• optional EntityProperties properties = 10

  Optional user properties.

• optional ParticipantType entity_type = 13

• optional Entity.PastHangoutState had_past_hangout_state = 16

Used in: Entity

• PAST_HANGOUT_STATE_UNKNOWN = 0

• PAST_HANGOUT_STATE_HAD_PAST_HANGOUT = 1

• PAST_HANGOUT_STATE_NO_PAST_HANGOUT = 2

Specifies an entity to lookup by one of its properties.

Used in: EntityResult, GetEntityByIdRequest

• optional string gaia_id = 1

• optional string email = 3

• optional string phone = 4

  Phone number as string (eg. "+15551234567").

• optional bool create_offnetwork_gaia = 6

  Whether create a gaia_id for off-network contacts (eg. Google Voice contacts).

Used in: Entity

• optional ProfileType type = 1

• optional string display_name = 2

• optional string first_name = 3

• optional string photo_url = 4

  Photo URL with protocol scheme omitted (eg. "//lh.googleusercontent.com/...").

• repeated string email = 5

• repeated string phone = 6

• optional bool in_users_domain = 10

• optional Gender gender = 11

• optional PhotoUrlStatus photo_url_status = 12

• optional string canonical_email = 15

Used in: GetEntityByIdResponse

• optional EntityLookupSpec lookup_spec = 1

• repeated Entity entity = 2

Event that becomes part of a conversation's history.

Used in: AddUserResponse, ConversationState, EventNotification, ModifyOTRStatusResponse, RemoveUserResponse, RenameConversationResponse, SendChatMessageResponse, SetGroupLinkSharingEnabledResponse

• optional ConversationId conversation_id = 1

  ID of the conversation this event belongs to.

• optional ParticipantId sender_id = 2

  ID of the user that sent this event.

• optional uint64 timestamp = 3

  Timestamp when the event occurred.

• optional UserEventState self_event_state = 4

• optional SourceType source_type = 6

• optional ChatMessage chat_message = 7

• optional MembershipChange membership_change = 9

• optional ConversationRename conversation_rename = 10

• optional HangoutEvent hangout_event = 11

• optional string event_id = 12

  Unique ID for the event.

• optional uint64 expiration_timestamp = 13

• optional OTRModification otr_modification = 14

• optional bool advances_sort_timestamp = 15

• optional OffTheRecordStatus otr_status = 16

• optional bool persisted = 17

• optional DeliveryMedium medium_type = 20

• optional EventType event_type = 23

  The event's type.

• optional uint64 event_version = 24

  Event version timestamp.

• optional HashModifier hash_modifier = 26

• optional GroupLinkSharingModification group_link_sharing_modification = 31

Annotation that can be applied to a chat message event. The only known use for this is "\me" actions supported by the Chrome client (type 4).

Used in: ChatMessage, SendChatMessageRequest

• optional int32 type = 1

  Annotation type.

• optional string value = 2

  Optional annotation string value.

Token that allows retrieving more events from a position in a conversation. Specifying event_timestamp is sufficient.

Used in: ConversationState, GetConversationRequest

• optional string event_id = 1

• optional bytes storage_continuation_token = 2

• optional uint64 event_timestamp = 3

Used in: StateUpdate

• optional Event event = 1

Used in: AddUserRequest, ModifyOTRStatusRequest, RemoveUserRequest, RenameConversationRequest, SendChatMessageRequest, SetGroupLinkSharingEnabledRequest

• optional ConversationId conversation_id = 1

• optional uint64 client_generated_id = 2

• optional OffTheRecordStatus expected_otr = 3

• optional DeliveryMedium delivery_medium = 4

• optional EventType event_type = 5

Used in: Event, EventRequestHeader

• EVENT_TYPE_UNKNOWN = 0

• EVENT_TYPE_REGULAR_CHAT_MESSAGE = 1

• EVENT_TYPE_SMS = 2

• EVENT_TYPE_VOICEMAIL = 3

• EVENT_TYPE_ADD_USER = 4

• EVENT_TYPE_REMOVE_USER = 5

• EVENT_TYPE_CONVERSATION_RENAME = 6

• EVENT_TYPE_HANGOUT = 7

• EVENT_TYPE_PHONE_CALL = 8

• EVENT_TYPE_OTR_MODIFICATION = 9

• EVENT_TYPE_PLAN_MUTATION = 10

• EVENT_TYPE_MMS = 11

• EVENT_TYPE_DEPRECATED_12 = 12

• EVENT_TYPE_OBSERVED_EVENT = 13

• EVENT_TYPE_GROUP_LINK_SHARING_MODIFICATION = 14

Used in: SendChatMessageRequest

• optional Photo photo = 1

Used in: QueryPresenceRequest

• FIELD_MASK_REACHABLE = 1

• FIELD_MASK_AVAILABLE = 2

• FIELD_MASK_MOOD = 3

• FIELD_MASK_IN_CALL = 6

• FIELD_MASK_DEVICE = 7

• FIELD_MASK_LAST_SEEN = 10

Used in: SetFocusNotification

• FOCUS_DEVICE_UNSPECIFIED = 0

• FOCUS_DEVICE_DESKTOP = 20

• FOCUS_DEVICE_MOBILE = 300

Used in: SetFocusNotification, SetFocusRequest

• FOCUS_TYPE_UNKNOWN = 0

• FOCUS_TYPE_FOCUSED = 1

• FOCUS_TYPE_UNFOCUSED = 2

Used in: Conversation

• FORCE_HISTORY_UNKNOWN = 0

• FORCE_HISTORY_NO = 1

• FORCE_HISTORY_ON = 2

• FORCE_HISTORY_OFF = 3

Used in: Segment

• optional bool bold = 1

• optional bool italic = 2

• optional bool strikethrough = 3

• optional bool underline = 4

Used in: EntityProperties

• GENDER_UNKNOWN = 0

• GENDER_MALE = 1

• GENDER_FEMALE = 2

• optional RequestHeader request_header = 1

• optional ConversationSpec conversation_spec = 2

• optional bool include_conversation_metadata = 3

  Whether the ConversationState in the response should include metadata other than the conversation ID (default true).

• optional bool include_event = 4

  Whether to include list of events in the response (default true).

• optional uint64 max_events_per_conversation = 6

• optional EventContinuationToken event_continuation_token = 7

• optional ResponseHeader response_header = 1

• optional ConversationState conversation_state = 2

• optional RequestHeader request_header = 1

• repeated EntityLookupSpec batch_lookup_spec = 3

• optional ResponseHeader response_header = 1

• repeated Entity entity = 2

  Resulting entities of PARTICIPANT_TYPE_GAIA only.

• repeated EntityResult entity_result = 3

  All resulting entities.

• optional RequestHeader request_header = 1

• optional ConversationId conversation_id = 2

  Conversation to retrieve URL for.

• optional ResponseHeader response_header = 1

• optional string group_conversation_url = 2

  URL for others to join conversation.

• optional RequestHeader request_header = 1

• optional ResponseHeader response_header = 1

• optional Entity self_entity = 2

• optional bool is_known_minor = 3

• optional DoNotDisturbSetting dnd_state = 5

• optional DesktopOffSetting desktop_off_setting = 6

• optional PhoneData phone_data = 7

• repeated ConfigurationBit configuration_bit = 8

• optional DesktopOffState desktop_off_state = 9

• optional bool google_plus_user = 10

• optional DesktopSoundSetting desktop_sound_setting = 11

• optional RichPresenceState rich_presence_state = 12

• optional Country default_country = 19

• optional RequestHeader request_header = 1

• optional uint64 max_count = 4

  Max number of non-grouped entities to return.

• optional SuggestedContactGroupHash favorites = 8

  Optional hash for "favorites" contact group.

• optional SuggestedContactGroupHash contacts_you_hangout_with = 9

  Optional hash for "contacts you hangout with" contact group.

• optional SuggestedContactGroupHash other_contacts_on_hangouts = 10

  Optional hash for "other contacts on hangouts" contact group.

• optional SuggestedContactGroupHash other_contacts = 11

  Optional hash for "other contacts" contact group.

• optional SuggestedContactGroupHash dismissed_contacts = 12

  Optional hash for "dismissed contacts" contact group.

• optional SuggestedContactGroupHash pinned_favorites = 13

  Optional hash for "pinned favorites" contact group.

• optional ResponseHeader response_header = 1

• repeated Entity entity = 2

• optional SuggestedContactGroup favorites = 4

• optional SuggestedContactGroup contacts_you_hangout_with = 5

• optional SuggestedContactGroup other_contacts_on_hangouts = 6

• optional SuggestedContactGroup other_contacts = 7

• optional SuggestedContactGroup dismissed_contacts = 8

• optional SuggestedContactGroup pinned_favorites = 9

Used in: Event

• optional GroupLinkSharingStatus new_status = 1

Used in: Conversation, GroupLinkSharingModification, SetGroupLinkSharingEnabledRequest

• GROUP_LINK_SHARING_STATUS_UNKNOWN = 0

• GROUP_LINK_SHARING_STATUS_ON = 1

• GROUP_LINK_SHARING_STATUS_OFF = 2

Used in: Event

• optional HangoutEventType event_type = 1

• repeated ParticipantId participant_id = 2

Used in: HangoutEvent

• HANGOUT_EVENT_TYPE_UNKNOWN = 0

• HANGOUT_EVENT_TYPE_START = 1

• HANGOUT_EVENT_TYPE_END = 2

• HANGOUT_EVENT_TYPE_JOIN = 3

• HANGOUT_EVENT_TYPE_LEAVE = 4

• HANGOUT_EVENT_TYPE_COMING_SOON = 5

• HANGOUT_EVENT_TYPE_ONGOING = 6

Used in: Event

• optional string update_id = 1

• optional uint64 hash_diff = 2

• optional uint64 version = 4

Used in: PhoneNumber

• optional string national_number = 1

• optional string international_number = 2

• optional uint64 country_code = 3

• optional string region_code = 4

• optional bool is_valid = 5

• optional PhoneValidationResult validation_result = 6

Used in: UserConversationState

• INVITE_AFFINITY_UNKNOWN = 0

• INVITE_AFFINITY_HIGH = 1

• INVITE_AFFINITY_LOW = 2

Used in: ConversationParticipantData, SuggestedContact

• INVITATION_STATUS_UNKNOWN = 0

• INVITATION_STATUS_PENDING = 1

• INVITATION_STATUS_ACCEPTED = 2

Used in: AddUserRequest, CreateConversationRequest

• optional string gaia_id = 1

• optional string fallback_name = 4

A type of embedded item.

Used in: EmbedItem

• ITEM_TYPE_THING = 0

• ITEM_TYPE_PLUS_PHOTO = 249

  Google Plus photo.

• ITEM_TYPE_PLACE = 335

• ITEM_TYPE_PLACE_V2 = 340

  Google Map place.

Used in: Presence

• optional uint64 last_seen_timestamp_usec = 1

• optional uint64 usec_since_last_seen = 2

Used in: Segment

• optional string link_target = 1

Used in: SendChatMessageRequest

• optional Place place = 1

Used in: Event

• optional MembershipChangeType type = 1

• repeated ParticipantId participant_ids = 3

Used in: MembershipChange

• MEMBERSHIP_CHANGE_TYPE_JOIN = 1

• MEMBERSHIP_CHANGE_TYPE_LEAVE = 2

Chat message content.

Used in: ChatMessage, SendChatMessageRequest, StatusMessageState

• repeated Segment segment = 1

• repeated Attachment attachment = 2

• optional RequestHeader request_header = 1

• optional OffTheRecordStatus otr_status = 3

• optional EventRequestHeader event_request_header = 5

• optional ResponseHeader response_header = 1

• optional Event created_event = 4

TODO: Merge with RichPresenceState?

Used in: SelfPresenceNotification

• optional StatusMessageState status_message = 4

Used in: Conversation

• NETWORK_TYPE_UNKNOWN = 0

• NETWORK_TYPE_BABEL = 1

• NETWORK_TYPE_GOOGLE_VOICE = 2

Used in: SetConversationNotificationLevelNotification, SetConversationNotificationLevelRequest, UserConversationState, UserEventState

• NOTIFICATION_LEVEL_UNKNOWN = 0

• NOTIFICATION_LEVEL_QUIET = 10

  Notifications are disabled.

• NOTIFICATION_LEVEL_RING = 30

  Notifications are enabled.

Used in: StateUpdateHeader

• optional DoNotDisturbSetting dnd_settings = 1

Used in: Event

• optional OffTheRecordStatus old_otr_status = 1

• optional OffTheRecordStatus new_otr_status = 2

• optional OffTheRecordToggle old_otr_toggle = 3

• optional OffTheRecordToggle new_otr_toggle = 4

Used in: Conversation, Event, EventRequestHeader, ModifyOTRStatusRequest, OTRModification

• OFF_THE_RECORD_STATUS_UNKNOWN = 0

• OFF_THE_RECORD_STATUS_OFF_THE_RECORD = 1

  Conversation is off-the-record (history disabled).

• OFF_THE_RECORD_STATUS_ON_THE_RECORD = 2

  Conversation is on-the-record (history enabled).

Whether the OTR toggle is available to the user.

Used in: Conversation, OTRModification

• OFF_THE_RECORD_TOGGLE_UNKNOWN = 0

• OFF_THE_RECORD_TOGGLE_ENABLED = 1

• OFF_THE_RECORD_TOGGLE_DISABLED = 2

Used in: SendOffnetworkInvitationRequest

• optional OffnetworkAddressType type = 1

• optional string email = 3

Used in: OffnetworkAddress

• OFFNETWORK_ADDRESS_TYPE_UNKNOWN = 0

• OFFNETWORK_ADDRESS_TYPE_EMAIL = 1

Identifies a user.

Used in: BlockStateChange, Conversation, ConversationParticipantData, EasterEggNotification, Entity, Event, HangoutEvent, MembershipChange, PresenceResult, QueryPresenceRequest, RemoveUserRequest, SendChatMessageRequest, SetFocusNotification, SetTypingNotification, UserConversationState, UserEventState, UserReadState, WatermarkNotification

• optional string gaia_id = 1

  Unique identifier for a user's Google account.

• optional string chat_id = 2

  Seems to always be the same as gaia_id.

Used in: ConversationParticipantData, Entity

• PARTICIPANT_TYPE_UNKNOWN = 0

• PARTICIPANT_TYPE_GAIA = 2

• PARTICIPANT_TYPE_GOOGLE_VOICE = 3

Used in: PhoneData

• optional PhoneNumber phone_number = 1

• optional bool google_voice = 2

• optional PhoneVerificationStatus verification_status = 3

• optional bool discoverable = 4

• optional PhoneDiscoverabilityStatus discoverability_status = 5

• optional bool primary = 6

Used in: GetSelfInfoResponse

• repeated Phone phone = 1

• optional CallerIdSettingsMask caller_id_settings_mask = 3

Used in: Phone

• PHONE_DISCOVERABILITY_STATUS_UNKNOWN = 0

• PHONE_DISCOVERABILITY_STATUS_OPTED_IN_BUT_NOT_DISCOVERABLE = 2

Used in: DeliveryMedium, Phone

• optional string e164 = 1

  Phone number as string (eg. "+15551234567").

• optional I18nData i18n_data = 2

Used in: I18nData

• PHONE_VALIDATION_RESULT_IS_POSSIBLE = 0

Used in: Phone

• PHONE_VERIFICATION_STATUS_UNKNOWN = 0

• PHONE_VERIFICATION_STATUS_VERIFIED = 1

Used in: ExistingMedia

• optional string photo_id = 1

  Picasa photo ID.

• optional bool delete_albumless_source_photo = 2

• optional string user_id = 3

  Optional Picasa user ID needed for photos from other accounts (eg. stickers).

• optional bool is_custom_user_id = 4

  Must be true if user_id is specified.

Status of EntityProperties.photo_url.

Used in: EntityProperties

• PHOTO_URL_STATUS_UNKNOWN = 0

• PHOTO_URL_STATUS_PLACEHOLDER = 1

  URL is a placeholder.

• PHOTO_URL_STATUS_USER_PHOTO = 2

  URL is a photo set by the user.

Place that can be embedded in a chat message via Google Maps.

Used in: EmbedItem, Location

• optional string url = 1

  Google Maps URL pointing to the place coordinates.

• optional string name = 3

  Name of the place.

• optional EmbedItem address = 24

  Address of the place.

• optional EmbedItem geo = 25

  Geographic location of the place.

• optional EmbedItem representative_image = 185

  Representative image of the place (map with pin).

Google Plus photo that can be embedded in a chat message.

Used in: EmbedItem

• optional PlusPhoto.Thumbnail thumbnail = 1

  Thumbnail.

• optional string owner_obfuscated_id = 2

  Owner obfuscated ID.

• optional string album_id = 3

  Album ID.

• optional string photo_id = 4

  Photo ID.

• optional string url = 6

  URL of full-sized image.

• optional string original_content_url = 10

  URL of image thumbnail.

• optional PlusPhoto.MediaType media_type = 13

  The media type.

• repeated string stream_id = 14

  List of stream ID parameters.

Media type.

Used in: PlusPhoto

• MEDIA_TYPE_UNKNOWN = 0

• MEDIA_TYPE_PHOTO = 1

• MEDIA_TYPE_ANIMATED_PHOTO = 4

Metadata for displaying an image thumbnail.

Used in: PlusPhoto

• optional string url = 1

  URL to navigate to when thumbnail is selected (a Google Plus album page).

• optional string image_url = 4

  URL of thumbnail image.

• optional uint64 width_px = 10

  Image width in pixels.

• optional uint64 height_px = 11

  Image height in pixels.

Used in: Entity, PresenceResult

• optional bool reachable = 1

• optional bool available = 2

• optional DeviceStatus device_status = 6

• optional StatusMessageState status_message = 9

• optional LastSeen last_seen = 10

Used in: StateUpdate

• repeated PresenceResult presence = 1

Used in: PresenceNotification, QueryPresenceResponse

• optional ParticipantId user_id = 1

• optional Presence presence = 2

Used in: SetPresenceRequest

• optional uint64 timeout_secs = 1

• optional ClientPresenceStateType type = 2

Used in: EntityProperties

• PROFILE_TYPE_NONE = 0

• PROFILE_TYPE_ES_USER = 1

• optional RequestHeader request_header = 1

• repeated ParticipantId participant_id = 2

• repeated FieldMask field_mask = 3

• optional ResponseHeader response_header = 1

• repeated PresenceResult presence_result = 2

• optional RequestHeader request_header = 1

• optional ParticipantId participant_id = 3

  Optional participant to remove from conversation, yourself if not given.

• optional EventRequestHeader event_request_header = 5

• optional ResponseHeader response_header = 1

• optional Event created_event = 4

• optional RequestHeader request_header = 1

• optional string new_name = 3

• optional EventRequestHeader event_request_header = 5

• optional ResponseHeader response_header = 1

• optional Event created_event = 4

Used in: StateUpdate

• optional ConversationId conversation_id = 1

• optional ReplyToInviteType type = 2

Used in: ReplyToInviteNotification

• REPLY_TO_INVITE_TYPE_UNKNOWN = 0

• REPLY_TO_INVITE_TYPE_ACCEPT = 1

• REPLY_TO_INVITE_TYPE_DECLINE = 2

Header for requests from the client to the server.

Used in: AddUserRequest, CreateConversationRequest, DeleteConversationRequest, EasterEggRequest, GetConversationRequest, GetEntityByIdRequest, GetGroupConversationUrlRequest, GetSelfInfoRequest, GetSuggestedEntitiesRequest, ModifyOTRStatusRequest, QueryPresenceRequest, RemoveUserRequest, RenameConversationRequest, SearchEntitiesRequest, SendChatMessageRequest, SendOffnetworkInvitationRequest, SetActiveClientRequest, SetConversationLevelRequest, SetConversationNotificationLevelRequest, SetFocusRequest, SetGroupLinkSharingEnabledRequest, SetPresenceRequest, SetTypingRequest, SyncAllNewEventsRequest, SyncRecentConversationsRequest, UpdateWatermarkRequest

• optional ClientVersion client_version = 1

• optional ClientIdentifier client_identifier = 2

• optional string language_code = 4

Header for responses from the server to the client.

Used in: AddUserResponse, CreateConversationResponse, DeleteConversationResponse, EasterEggResponse, GetConversationResponse, GetEntityByIdResponse, GetGroupConversationUrlResponse, GetSelfInfoResponse, GetSuggestedEntitiesResponse, ModifyOTRStatusResponse, QueryPresenceResponse, RemoveUserResponse, RenameConversationResponse, SearchEntitiesResponse, SendChatMessageResponse, SendOffnetworkInvitationResponse, SetActiveClientResponse, SetConversationLevelResponse, SetConversationNotificationLevelResponse, SetFocusResponse, SetGroupLinkSharingEnabledResponse, SetPresenceResponse, SetTypingResponse, SyncAllNewEventsResponse, SyncRecentConversationsResponse, UpdateWatermarkResponse

• optional ResponseStatus status = 1

• optional string error_description = 2

• optional string debug_url = 3

• optional string request_trace_id = 4

• optional uint64 current_server_time = 5

Status of the response from the server to the client.

Used in: ResponseHeader

• RESPONSE_STATUS_UNKNOWN = 0

• RESPONSE_STATUS_OK = 1

• RESPONSE_STATUS_UNEXPECTED_ERROR = 3

• RESPONSE_STATUS_INVALID_REQUEST = 4

Used in: RichPresenceEnabledStateNotification, RichPresenceState

• optional RichPresenceType type = 1

• optional bool enabled = 2

Used in: StateUpdate

• repeated RichPresenceEnabledState rich_presence_enabled_state = 1

Used in: GetSelfInfoResponse

• repeated RichPresenceEnabledState get_rich_presence_enabled_state = 3

Used in: RichPresenceEnabledState

• RICH_PRESENCE_TYPE_UNKNOWN = 0

• RICH_PRESENCE_TYPE_IN_CALL_STATE = 1

• RICH_PRESENCE_TYPE_UNKNOWN_3 = 3

• RICH_PRESENCE_TYPE_UNKNOWN_4 = 4

• RICH_PRESENCE_TYPE_UNKNOWN_5 = 5

• RICH_PRESENCE_TYPE_DEVICE = 2

• RICH_PRESENCE_TYPE_LAST_SEEN = 6

• optional RequestHeader request_header = 1

• optional string query = 3

• optional uint64 max_count = 4

• optional ResponseHeader response_header = 1

• repeated Entity entity = 2

A segment of a message. Message are broken into segments that may be of different types and have different formatting.

Used in: ChatMessageSpec, MessageContent

• required SegmentType type = 1

  Note: This field is required because Hangouts for Chrome misbehaves if it isn't serialized.

• optional string text = 2

  The segment text. For line breaks, may either be empty or contain new line character.

• optional Formatting formatting = 3

  Formatting for this segment.

• optional LinkData link_data = 4

  Link data for this segment, if it is a link.

Used in: Segment

• SEGMENT_TYPE_TEXT = 0

  Segment is text.

• SEGMENT_TYPE_LINE_BREAK = 1

  Segment is a line break.

• SEGMENT_TYPE_LINK = 2

  Segment is hyperlinked text.

Notifies the status of other clients and status message.

Used in: StateUpdate

• optional ClientPresenceState client_presence_state = 1

• optional DoNotDisturbSetting do_not_disturb_setting = 3

• optional DesktopOffSetting desktop_off_setting = 4

• optional DesktopOffState desktop_off_state = 5

• optional MoodState mood_state = 6

• optional RequestHeader request_header = 1

• repeated EventAnnotation annotation = 5

• optional MessageContent message_content = 6

• optional ExistingMedia existing_media = 7

• optional EventRequestHeader event_request_header = 8

• optional ParticipantId user_id = 9

• optional Location location = 10

• repeated ChatMessageSpec chat_message_spec = 12

• optional ResponseHeader response_header = 1

• optional Event created_event = 6

• optional RequestHeader request_header = 1

• optional OffnetworkAddress invitee_address = 2

• optional ResponseHeader response_header = 1

• optional RequestHeader request_header = 1

• optional bool is_active = 2

  Whether to set the client as active or inactive.

• optional string full_jid = 3

  'email/resource'.

• optional uint64 timeout_secs = 4

  Timeout in seconds for client to remain active.

• optional ResponseHeader response_header = 1

• optional RequestHeader request_header = 1

• optional ResponseHeader response_header = 1

Used in: StateUpdate

• optional ConversationId conversation_id = 1

• optional NotificationLevel level = 2

• optional uint64 timestamp = 4

• optional RequestHeader request_header = 1

• optional ConversationId conversation_id = 2

• optional NotificationLevel level = 3

• optional ResponseHeader response_header = 1

• optional uint64 timestamp = 2

Used in: StateUpdate

• optional ConversationId conversation_id = 1

• optional ParticipantId sender_id = 2

• optional uint64 timestamp = 3

• optional FocusType type = 4

• optional FocusDevice device = 5

• optional RequestHeader request_header = 1

• optional ConversationId conversation_id = 2

• optional FocusType type = 3

• optional uint32 timeout_secs = 4

• optional ResponseHeader response_header = 1

• optional uint64 timestamp = 2

• optional RequestHeader request_header = 1

• optional EventRequestHeader event_request_header = 2

• optional GroupLinkSharingStatus group_link_sharing_status = 4

  New group link sharing status.

• optional ResponseHeader response_header = 1

• optional Event created_event = 2

  Created event of type EVENT_TYPE_GROUP_LINK_SHARING_MODIFICATION.

• optional Conversation updated_conversation = 3

  Updated conversation.

Used in: StateUpdate

• repeated ConfigurationBit configuration_bit = 1

• optional DesktopSoundSetting desktop_sound_setting = 2

Allows setting one or more of the included presence-related settings.

• optional RequestHeader request_header = 1

• optional PresenceStateSetting presence_state_setting = 2

• optional DndSetting dnd_setting = 3

• optional DesktopOffSetting desktop_off_setting = 5

• optional StatusMessageSetting status_message_setting = 8

• optional ResponseHeader response_header = 1

Used in: StateUpdate

• optional ConversationId conversation_id = 1

• optional ParticipantId sender_id = 2

• optional uint64 timestamp = 3

• optional TypingType type = 4

• optional RequestHeader request_header = 1

• optional ConversationId conversation_id = 2

• optional TypingType type = 3

• optional ResponseHeader response_header = 1

• optional uint64 timestamp = 2

Used in: DesktopSoundSetting

• SOUND_STATE_UNKNOWN = 0

• SOUND_STATE_ON = 1

• SOUND_STATE_OFF = 2

Used in: Event

• SOURCE_TYPE_UNKNOWN = 0

Pushed from the server to the client to notify it of state changes. Includes exactly one type of notification, and optionally updates the attributes of a conversation.

Used in: BatchUpdate

• optional StateUpdateHeader state_update_header = 1

• optional Conversation conversation = 13

  If set, includes conversation attributes that have been updated by the notification.

• oneof state_update

  • ConversationNotification conversation_notification = 2

  • EventNotification event_notification = 3

  • SetFocusNotification focus_notification = 4

  • SetTypingNotification typing_notification = 5

  • SetConversationNotificationLevelNotification notification_level_notification = 6

  • ReplyToInviteNotification reply_to_invite_notification = 7

  • WatermarkNotification watermark_notification = 8

  • ConversationViewModification view_modification = 11

  • EasterEggNotification easter_egg_notification = 12

  • SelfPresenceNotification self_presence_notification = 14

  • DeleteActionNotification delete_notification = 15

  • PresenceNotification presence_notification = 16

  • BlockNotification block_notification = 17

  • SetNotificationSettingNotification notification_setting_notification = 19

  • RichPresenceEnabledStateNotification rich_presence_enabled_state_notification = 20

Header for StateUpdate messages.

Used in: StateUpdate

• optional ActiveClientState active_client_state = 1

• optional string request_trace_id = 3

• optional NotificationSettings notification_settings = 4

• optional uint64 current_server_time = 5

Used in: SetPresenceRequest

• repeated ChatMessageSpec status_message = 1

Used in: MoodState, Presence

• repeated MessageContent status_message = 1

Used in: SuggestedContactGroup

• optional Entity entity = 1

  The contact's entity.

• optional InvitationStatus invitation_status = 2

  The contact's invitation status.

Used in: GetSuggestedEntitiesResponse

• optional bool hash_matched = 1

  True if the request's hash matched and no contacts will be included.

• optional bytes hash = 2

  A 4-byte hash which can be used in subsequent requests.

• repeated SuggestedContact contact = 3

  List of contacts in this group.

Used in: GetSuggestedEntitiesRequest

• optional uint64 max_results = 1

  Number of results to return from this group.

• optional bytes hash = 2

  An optional 4-byte hash. If this matches the server's hash, no results will be sent.

• optional RequestHeader request_header = 1

• optional uint64 last_sync_timestamp = 2

  Timestamp after which to return all new events.

• optional uint64 max_response_size_bytes = 8

• optional ResponseHeader response_header = 1

• optional uint64 sync_timestamp = 2

• repeated ConversationState conversation_state = 3

Used in: SyncRecentConversationsRequest

• SYNC_FILTER_UNKNOWN = 0

• SYNC_FILTER_INBOX = 1

• SYNC_FILTER_ARCHIVED = 2

• optional RequestHeader request_header = 1

• optional uint64 last_event_timestamp = 2

  Timestamp used for pagination, returns most recent conversations if not given.

• optional uint64 max_conversations = 3

• optional uint64 max_events_per_conversation = 4

• repeated SyncFilter sync_filter = 5

• optional ResponseHeader response_header = 1

• optional uint64 sync_timestamp = 2

• repeated ConversationState conversation_state = 3

• optional uint64 continuation_end_timestamp = 4

• optional int32 test_int = 1

  integers

• repeated int32 test_repeated_int = 2

• optional string test_string = 3

  strings

• repeated string test_repeated_string = 4

• optional TestMessage.TestEnum test_enum = 5

• repeated TestMessage.TestEnum test_repeated_enum = 6

• optional TestMessage.EmbeddedMessage test_embedded_message = 7

• repeated TestMessage.EmbeddedMessage test_repeated_embedded_message = 8

• optional bytes test_bytes = 9

  bytes

• repeated bytes test_repeated_bytes = 10

messages

Used in: TestMessage

• optional int32 test_embedded_int = 1

enums

Used in: TestMessage

• TEST_0 = 0

• TEST_1 = 1

• TEST_2 = 2

• TEST_3 = 3

• required int32 test_required_int = 1

Used in: SetTypingNotification, SetTypingRequest

• TYPING_TYPE_UNKNOWN = 0

• TYPING_TYPE_STARTED = 1

  Started typing.

• TYPING_TYPE_PAUSED = 2

  Stopped typing with inputted text.

• TYPING_TYPE_STOPPED = 3

  Stopped typing with no inputted text.

• optional RequestHeader request_header = 1

• optional ConversationId conversation_id = 2

• optional uint64 last_read_timestamp = 3

• optional ResponseHeader response_header = 1

Used in: Conversation

• optional string client_generated_id = 2

• optional UserReadState self_read_state = 7

• optional ConversationStatus status = 8

• optional NotificationLevel notification_level = 9

• repeated ConversationView view = 10

• optional ParticipantId inviter_id = 11

• optional uint64 invite_timestamp = 12

• optional uint64 sort_timestamp = 13

• optional uint64 active_timestamp = 14

• optional InvitationAffinity invite_affinity = 15

• repeated DeliveryMediumOption delivery_medium_option = 17

Used in: Event

• optional ParticipantId user_id = 1

• optional string client_generated_id = 2

• optional NotificationLevel notification_level = 3

Used in: Conversation, UserConversationState

• optional ParticipantId participant_id = 1

• optional uint64 latest_read_timestamp = 2

  Timestamp of the user's last read message in the conversation.

Used in: StateUpdate

• optional ParticipantId sender_id = 1

• optional ConversationId conversation_id = 2

• optional uint64 latest_read_timestamp = 3