Dostawca treści dla Gmaila na Androida

Aplikacja Gmail na Androida zawiera dostawca treści których deweloperzy zewnętrzni mogą użyć do pobierania informacji o etykietach, takich jak nazwa nieprzeczytanych wiadomości i bądź na bieżąco w miarę ich zmian. Na przykład aplikacja lub widżet może wyświetlać liczbę nieprzeczytanych elementów w skrzynce odbiorczej na konkretnym koncie.

Przed użyciem tego dostawcy treści wywołaj metodę GmailContract.canReadLabels(Context) , by określić, czy wersja aplikacji Gmail użytkownika obsługuje te zapytań.

Znajdź ważne konto Gmail, na które chcesz wysłać zapytanie

Aplikacja musi najpierw znaleźć adres e-mail ważnego konta Gmail, o którego chce wysłać zapytanie informacje o etykiecie. Za pomocą GET_ACCOUNTS uprawnienia, AccountManager może zwrócić te informacje:

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

Wyślij zapytanie do dostawcy treści

Po wybraniu adresu e-mail można uzyskać ContentProvider Identyfikator URI, którego ma dotyczyć zapytanie. Przygotowaliśmy proste zajęcia o nazwie GmailContract.java do utworzenia identyfikatora URI i zdefiniowania zwróconych kolumn.

Aplikacja może bezpośrednio wysyłać zapytania do tego identyfikatora URI, a jeszcze lepiej użyć funkcji CursorLoader — aby uzyskać Kursor z informacjami o wszystkich etykietach na koncie:

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

Po najechaniu kursorem na dane możesz zapisać wartość identyfikatora URI w GmailContract.Labels.URI, aby wykonać zapytanie i obserwować zmiany w kolumnie jedną etykietę.

Wartość NAME w przypadku wstępnie zdefiniowanych etykiet może się różnić w zależności od regionu, dlatego użyj metody GmailContract.Labels.NAME. Zamiast tego możesz automatycznie zidentyfikować wstępnie zdefiniowane etykiety, takie jak Odebrane, Wysłane czy Wersje robocze, używając wartości ciągu znaków w kolumna 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
        }
    }
}

Więcej informacji znajdziesz na stronie Podstawowe informacje o dostawcach treści

Zobacz przykład

Aby zobaczyć przykład działania tego dostawcy treści, pobierz przykładową aplikację.