Android の Gmail アプリにはコンテンツ プロバイダが含まれています。サードパーティ デベロッパーはこれを使用して、名前や未読数などのラベル情報を取得し、情報が変更されたときに最新の状態に維持できます。たとえば、アプリやウィジェットで、特定のアカウントの受信トレイの未読件数を表示できます。
このコンテンツ プロバイダを使用する前に、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 を取得できます。URI を作成し、返される列を定義するために、GmailContract.java
というシンプルなクラスが用意されています。
アプリは、この URI を直接クエリするか、CursorLoader
を使用して、アカウントのすべてのラベルの情報を含むカーソルを取得できます。
Cursor labelsCursor = getContentResolver().query(GmailContract.Labels.getLabelsUri(selectedAccount), null, null, null, null);
このカーソルのデータを使用すると、URI 値を GmailContract.Labels.URI
列に保持して、1 つのラベルに対する変更をクエリして監視できます。
事前定義ラベルの NAME
値はロケールによって異なる可能性があるため、GmailContract.Labels.NAME
は使用しないでください。代わりに、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
}
}
}
詳しくは、コンテンツ プロバイダの基本をご覧ください。
例を見る
このコンテンツ プロバイダの動作例については、サンプルアプリをダウンロードしてください。