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 यूआरआई पाएं. हमने यूआरआई बनाने और दिए गए कॉलम के बारे में बताने के लिए, GmailContract.java नाम की एक सामान्य क्लास दी है.
ऐप्लिकेशन, किसी खाते के सभी लेबल की जानकारी वाला कर्सर पाने के लिए, इस यूआरआई के बारे में सीधे तौर पर क्वेरी कर सकता है — या बेहतर होगा कि यह
CursorLoader
— का इस्तेमाल करके भी क्वेरी की जा सकती है:
Cursor labelsCursor = getContentResolver().query(GmailContract.Labels.getLabelsUri(selectedAccount), null, null, null, null);
इस कर्सर के डेटा की मदद से, GmailContract.Labels.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
}
}
}
ज़्यादा मदद पाने के लिए, कॉन्टेंट देने वाले के बारे में बुनियादी बातें पढ़ें
उदाहरण देखें
कॉन्टेंट देने वाले इस कॉन्टेंट का उदाहरण देखने के लिए, ऐप्लिकेशन का एक नमूना डाउनलोड करें.