Provedor de conteúdo Android para o Gmail

O aplicativo do Gmail para Android inclui um provedor de conteúdo que desenvolvedores de terceiros podem usar para recuperar informações de rótulos, como nome e não lida e se manter atualizada à medida que essas informações mudam. Por exemplo, um app pode exibir o número de mensagens não lidas da caixa de entrada de uma conta específica.

Antes de usar esse provedor de conteúdo, chame o método GmailContract.canReadLabels(Context) para determinar se a versão do usuário do aplicativo Gmail é compatível com estas consultas.

Encontrar uma conta do Gmail válida para consulta

Primeiro, o app precisa encontrar o endereço de e-mail de uma conta do Gmail válida para consultar informações do rótulo. Com o GET_ACCOUNTS a permissão, a AccountManager pode retornar estas 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 uma ContentProvider URI para consulta. Nós fornecemos uma classe simples chamada GmailContract.java para construir o URI e definir as colunas retornadas.

Um aplicativo pode consultar esse URI diretamente ou, melhor ainda, usar uma CursorLoader — para receber um cursor com informações de todos os rótulos de uma conta:

Cursor labelsCursor = getContentResolver().query(GmailContract.Labels.getLabelsUri(selectedAccount), null, null, null, null);

Com os dados neste cursor, você pode manter o valor do URI no campo GmailContract.Labels.URI para consultar e observar alterações em um um único rótulo.

O valor NAME para rótulos predefinidos pode variar de acordo com a localidade. Portanto, não use GmailContract.Labels.NAME. Em vez disso, você pode programar identificar marcadores predefinidos como Caixa de Entrada, Enviados ou Rascunhos usando o valor String em na coluna 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
        }
    }
}

Se precisar de mais ajuda, leia Fundamentos do provedor de conteúdo

Analisar um exemplo

Para acessar um exemplo desse provedor de conteúdo em ação, fazer o download de um app de exemplo.