[Android] Gmail ラベル API （ContentProvider）

Android Developers 公式ブログに Gmail のラベル情報を取得する API の記事が公開されていました。

• The Gmail Public Labels API | Android Developers Blog

この API（※） を使用すると、Gmail データ内の「ラベル名」「総件数」「未読件数」などを取得できます。

したがって、これらの情報を取得・表示する ウィジェット や ステータス通知アプリ などを作ることができます。

※API といっても、仕組みは、Android 標準の ContentProvider

サンプルアプリ

以下の URL（直リンク） からサンプルアプリをダウンロードできます。

https://developers.google.com/gmail/android/android-gmail-api-sample.tar.gz

※圧縮ファイルには、ソースコードの他、ビルド済み apk も含まれています

サンプルアプリ実行結果

サンプルアプリを実行すると、使用している Gmail アカウントの各ラベルの「名前」「総件数」「未読件数」が表示されます。

ソースを読む限り、「背景色」など他にも取得できる情報が幾つかありました。

動作環境

• Android 2.2以降
• 以下のバージョンの Gmail アプリ
• Android 2.2/2.3 向けは、Gmail バージョン 2.3.6 以降
• Android 3.x/4.x 向けは、Gmail バージョン 4.0.5 以降

本APIを使用するアプリ側で必要なパーミッション

• android.permission.GET_ACCOUNTS
• com.google.android.gm.permission.READ_CONTENT_PROVIDER ・・・ Gmail アプリ固有パーミッション

おまけ

Gmail アプリの AndroidManifest.xml の一部。

<provider
    android:name=".provider.PublicContentProvider"
    android:readPermission="com.google.android.gm.permission.READ_CONTENT_PROVIDER"
    android:multiprocess="false"
    android:authorities="com.google.android.gm" >
    <grant-uri-permission  android:pathPattern=".*" />
</provider>

あわせて読みたい

• Gmailアプリがアップデート、Android 4.0（ICS）の機能がAndroid 3.2（Hoenycomb）端末でも利用可能に | juggly.cn
• Android 3.2/2.3/2.2ユーザー向けに「Gmail」アプリがアップデート | AndroidニュースやアプリのAppLab