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);
이 커서의 데이터를 사용하여 GmailContract.Labels.URI 열에 URI 값을 유지하면 단일 라벨을 쿼리하고 변경사항을 확인할 수 있습니다.
사전 정의된 라벨의 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
}
}
}
자세한 내용은 콘텐츠 제공자 기본 사항을 참고하세요.
예시 검토
이 콘텐츠 제공자가 작동하는 예를 보려면 샘플 앱을 다운로드하세요.