ContactsContract.StatusUpdates


public static class ContactsContract.StatusUpdates
extends Object implements ContactsContract.PresenceColumns, ContactsContract.StatusColumns

java.lang.Object
   ↳ android.provider.ContactsContract.StatusUpdates


A status update is linked to a ContactsContract.Data row and captures the user's latest status update via the corresponding source, e.g. "Having lunch" via "Google Talk".

There are two ways a status update can be inserted: by explicitly linking it to a Data row using ContactsContract.PresenceColumns.DATA_ID or indirectly linking it to a data row using a combination of ContactsContract.PresenceColumns.PROTOCOL (or ContactsContract.PresenceColumns.CUSTOM_PROTOCOL) and ContactsContract.PresenceColumns.IM_HANDLE. There is no difference between insert and update, you can use either.

Inserting or updating a status update for the user's profile requires either using the ContactsContract.PresenceColumns.DATA_ID to identify the data row to attach the update to, or StatusUpdates.PROFILE_CONTENT_URI to ensure that the change is scoped to the profile.

You cannot use ContentResolver.update to change a status, but ContentResolver.insert will replace the latests status if it already exists.

Use ContentResolver.bulkInsert(Uri,ContentValues[]) to insert/update statuses for multiple contacts at once.

Columns

StatusUpdates
long ContactsContract.PresenceColumns.DATA_ID read/write Reference to the Data._ID entry that owns this presence. If this field is