Gmail 用 Android コンテンツ プロバイダ

Android 版 Gmail アプリには コンテンツ プロバイダ サードパーティ デベロッパーが名前や URL などのラベル情報を取得するのに使用できる 未読件数が表示され、情報が変更されるたびに更新されます。たとえば、 またはウィジェットを使用して、特定のアカウントの受信トレイの未読件数を表示できます。

このコンテンツ プロバイダを使用する前に、 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 */);

コンテンツ プロバイダにクエリを実行する

メールアドレスを選択すると、 ContentProvider クエリ対象の URI。単純なクラスである GmailContract.java を使用して URI を作成し、返される列を定義します。

アプリはこの URI を直接クエリできます。または、 CursorLoader — アカウントのすべてのラベルの情報を含むカーソルを取得するには、次のようにします。

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

このカーソルのデータを使用して、 GmailContract.Labels.URI 列を使用してクエリを実行し、 作成します。

事前定義ラベルの NAME 値は言語 / 地域によって異なる可能性があるため、 GmailContract.Labels.NAME を使用します。代わりに、Terraform を使用して [受信トレイ]、[送信済み]、[下書き] などの定義済みのラベルを、 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
        }
    }
}

詳しくは、 コンテンツ プロバイダの基本

例を確認する

このコンテンツ プロバイダの実際の例は、 サンプルアプリをダウンロードしてください。