Provedor de conteúdo Android para o Gmail

O app Gmail para Android inclui um provedor de conteúdo que desenvolvedores terceirizados podem usar para extrair informações de marcadores, como nome e contagem de não lidas, e ficar atualizados à medida que essas informações mudam. Por exemplo, um app ou widget pode mostrar a contagem de não lidas da caixa de entrada de uma conta específica.

Antes de usar esse provedor de conteúdo, chame o GmailContract.canReadLabels(Context) método para determinar se a versão do app Gmail do usuário oferece suporte a essas consultas.

Encontrar uma conta do Gmail válida para consultar

Um app precisa primeiro encontrar o endereço de e-mail de uma conta do Gmail válida para consultar informações de marcadores. Com a GET_ACCOUNTS permissão, o AccountManager pode retornar essas informações:

// 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 */);

Consultar o provedor de conteúdo

Com um endereço de e-mail selecionado, você pode receber um ContentProvider URI para consultar. Fornecemos uma classe chamada GmailContract para construir o URI e definir as colunas retornadas. Um app pode consultar esse URI diretamente.

Com os dados no Cursor, é possível manter o valor do URI na GmailContract.Labels.URI coluna para consultar e monitorar mudanças em um único marcador.

O valor NAME para marcadores predefinidos pode variar de acordo com a localidade. Portanto, não use GmailContract.Labels.NAME. Em vez disso, você pode identificar programaticamente marcadores predefinidos, como "Caixa de entrada", "Enviados" ou "Rascunhos", usando o valor da string na GmailContract.Labels.CANONICAL_NAME coluna:

// Query for all labels and find the Inbox.
try (Cursor labelsCursor = getContentResolver().query(
        GmailContract.Labels.getLabelsUri(selectedAccount), null, null, null, null)) {
    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.
            }
        }
    }
}

Para mais informações, consulte Fundamentos do provedor de conteúdo.

Conferir um exemplo

Para conferir um exemplo desse provedor de conteúdo em ação, faça o download de um app de amostra.