Приложение Gmail для Android включает в себя контент-провайдера , который сторонние разработчики могут использовать для получения информации о метках, такой как имя и количество непрочитанных сообщений, и быть в курсе изменений этой информации. Например, приложение или виджет может отображать количество непрочитанных сообщений в почтовом ящике конкретного аккаунта.
Перед использованием этого поставщика контента вызовите метод GmailContract.canReadLabels(Context) чтобы определить, поддерживает ли версия приложения Gmail пользователя эти запросы.
Найдите действующую учетную запись Gmail для запроса
Приложение должно сначала найти адрес электронной почты действительного аккаунта Gmail, чтобы запросить информацию о метке. С разрешением GET_ACCOUNTS AccountManager может вернуть следующую информацию:
// Get the account list, and pick the first one
final String ACCOUNT_TYPE_GOOGLE = "com.google";
final String[] FEATURES_MAIL = {
"service_mail"
};
AccountManager.get(this).getAccountsByTypeAndFeatures(ACCOUNT_TYPE_GOOGLE, FEATURES_MAIL,
new AccountManagerCallback() {
@Override
public void run(AccountManagerFuture future) {
Account[] accounts = null;
try {
accounts = future.getResult();
if (accounts != null && accounts.length > 0) {
String selectedAccount = accounts[0].name;
queryLabels(selectedAccount);
}
} catch (OperationCanceledException oce) {
// TODO: handle exception
} catch (IOException ioe) {
// TODO: handle exception
} catch (AuthenticatorException ae) {
// TODO: handle exception
}
}
}, null /* handler */);
Запросить поставщика контента
Выбрав адрес электронной почты, вы можете получить URI ContentProvider для выполнения запроса. Мы предоставили простой класс GmailContract.java для построения URI и определения возвращаемых столбцов.
Приложение может напрямую запросить этот URI — или, что еще лучше, использовать CursorLoader — чтобы получить Cursor с информацией для всех меток в учетной записи:
Cursor labelsCursor = getContentResolver().query(GmailContract.Labels.getLabelsUri(selectedAccount), null, null, null, null);
Используя данные в этом курсоре, вы можете сохранить значение URI в столбце GmailContract.Labels.URI для запроса и отслеживания изменений на одной метке.
Значение NAME для предопределенных меток может различаться в зависимости от локали, поэтому не используйте GmailContract.Labels.NAME . Вместо этого вы можете программно определить предопределенные метки, такие как «Входящие», «Отправленные» или «Черновики», используя строковое значение в столбце GmailContract.Labels.CANONICAL_NAME :
// loop through the cursor and find the Inbox
if (labelsCursor != null) {
final String inboxCanonicalName = GmailContract.Labels.LabelCanonicalName.CANONICAL_NAME_INBOX;
final int canonicalNameIndex = labelsCursor.getColumnIndexOrThrow(GmailContract.Labels.CANONICAL_NAME);
while (labelsCursor.moveToNext()) {
if (inboxCanonicalName.equals(labelsCursor.getString(canonicalNameIndex))) {
// this row corresponds to the Inbox
}
}
}
Для получения дополнительной информации прочтите раздел «Основы работы с поставщиками контента».
Рассмотрите пример
Чтобы увидеть пример работы этого поставщика контента, загрузите пример приложения .