Provider di contenuti Android per Gmail

L'app Gmail per Android include un content provider che gli sviluppatori di terze parti possono utilizzare per recuperare informazioni sulle etichette, come nome e conteggio dei messaggi non letti, e rimanere aggiornati man mano che queste informazioni cambiano. Ad esempio, un'app o un widget potrebbe mostrare il numero di messaggi non letti nella posta in arrivo di un account specifico.

Prima di utilizzare questo fornitore di contenuti, chiama il metodo GmailContract.canReadLabels(Context) per determinare se la versione dell'app Gmail dell'utente supporta queste query.

Trovare un account Gmail valido da interrogare

Un'app deve prima trovare l'indirizzo email di un account Gmail valido per eseguire query per informazioni sulle etichette. Con l'autorizzazione GET_ACCOUNTS, l'AccountManager può restituire queste informazioni:

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

Eseguire query sul fornitore di contenuti

Una volta selezionato un indirizzo email, puoi ottenere un URI ContentProvider da interrogare. Abbiamo fornito una classe semplice chiamata GmailContract.java per costruire l'URI e definire le colonne restituite.

Un'app può eseguire query su questo URI direttamente o, meglio ancora, utilizzare un CursorLoader per ottenere un cursore con informazioni per tutte le etichette di un account:

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

Con i dati in questo cursore, puoi quindi rendere persistente il valore URI nella colonna GmailContract.Labels.URI per eseguire query e monitorare le modifiche a una singola etichetta.

Il valore di NAME per le etichette predefinite può variare in base alle impostazioni internazionali, quindi non utilizzare GmailContract.Labels.NAME. In alternativa, puoi identificare in modo programmatico le etichette predefinite come Posta in arrivo, Posta inviata o Bozze utilizzando il valore String nella colonna 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
        }
    }
}

Per ulteriore assistenza, leggi Nozioni di base per i fornitori di contenuti

Esamina un esempio

Per vedere un esempio di questo fornitore di contenuti in azione, scarica un'app di esempio.