package mobile.contactlist.v2

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc GetContactListStream (GetContactListStreamRequest, stream GetContactListStreamResponse)

  contactlist_service.proto:18

  Get the list of the caller's contact list There is no guarenteed ordering of contacts in the stream. Page streaming - streaming starting from the page_token if present.

  message GetContactListStreamRequest

  contactlist_service.proto:38

  • GetContactListStreamRequest.Kind response_kind = 1

    Should response contain persona ids only or short form of the personas

  • optional PageToken page_token = 2

    If page_token is not present, the streaming will start from the beginning. In case the streaming call fails, mobile client should use the page_token from the last successful server response to continue the list streaming.

  message GetContactListStreamResponse

  contactlist_service.proto:52

  • GetContactListStreamResponse.Result result = 1

  • repeated GetContactListStreamResponse.ContactInfo contacts = 2

  • optional PageToken page_token = 3

    If there are more contacts to return, a page token is returned In case the streaming call fails, mobile client should use the page_token from the last successful server response to continue the list streaming.

• rpc CheckContactStatus (CheckContactStatusRequest, CheckContactStatusResponse)

  contactlist_service.proto:21

  Check if the personas are in the caller's contact list

  message CheckContactStatusRequest

  contactlist_service.proto:75

  • repeated common.v2.PersonaId contacts_to_check = 1

  message CheckContactStatusResponse

  contactlist_service.proto:82

  • CheckContactStatusResponse.Result result = 1

  • repeated CheckContactStatusResponse.ContactStatus succeeded_ids = 2

    Server successfully check the contact list and answered is-a-contact for these persona ids

  • repeated common.v2.PersonaId failed_ids = 3

    For some reason, server encountered problem checking the contact list for these persona ids

• rpc AddContact (AddContactRequest, AddContactResponse)

  contactlist_service.proto:24

  Adding a persona to caller's contact list

  message AddContactRequest

  contactlist_service.proto:101

  • optional common.v2.PersonaId new_contact = 1

    Persona to add to the contact list

  • optional common.contactlist.v1.UserFriendContext friend_context = 2

    Friending context details

  message AddContactResponse

  contactlist_service.proto:110

  • AddContactResponse.Result result = 1

  • optional common.v2.PersonaId added_contact = 2

    Only if Result is OK Most times, the added_contact is the same persona as the requesting pesona. But if there is a product rule applies, added_contact might be a different persona. (ie, Reachout from public group will have an aliasjid persona in request and friending reveals the genesis persona)

• rpc RemoveContact (RemoveContactRequest, RemoveContactResponse)

  contactlist_service.proto:27

  Remove a persona from caller's contact list

  message RemoveContactRequest

  contactlist_service.proto:136

  • optional common.v2.PersonaId contact_to_remove = 1

    Persona to remove from contact list of the caller

  message RemoveContactResponse

  contactlist_service.proto:143

  • RemoveContactResponse.Result result = 1

Used in: AddContactResponse

• OK = 0

  Contact added

• NOT_FOUND = 1

  NOT_FOUND may indicate any of the following: - Caller or New contact does not exist - Caller's Friending rate limit has been exceeded - Caller is blocked by new contact.

• NOT_PERMITTED = 2

  If contact's direct messaging is turned off

Used in: CheckContactStatusResponse

• optional common.v2.PersonaId contacts_to_check = 1

• bool is_a_contact = 2

Used in: CheckContactStatusResponse

• OK = 0

  OK means all the incoming persona_ids are accounted for in either succeeded_ids or failed_ids

Used in: GetContactListStreamRequest

• PERSONA_ID = 0

• PERSONA_SHORT = 1

Used in: GetContactListStreamResponse

• oneof persona_kind

  • common.v2.PersonaId persona_id = 1

  • common.persona.v2.PersonaShort persona_short = 2

Used in: GetContactListStreamResponse

• OK = 0

Used in: GetContactListStreamRequest, GetContactListStreamResponse

• bytes token = 1

Used in: RemoveContactResponse

• OK = 0

  Contact removed