แอป Gmail บน Android มีผู้ให้บริการเนื้อหาที่นักพัฒนาซอฟต์แวร์บุคคลที่สามสามารถใช้เพื่อเรียกข้อมูลป้ายกํากับ เช่น ชื่อและจํานวนที่ยังไม่อ่าน รวมถึงรับรู้ข้อมูลอยู่เสมอเมื่อข้อมูลมีการเปลี่ยนแปลง เช่น แอปหรือวิดเจ็ตอาจแสดงจํานวนกล่องจดหมายในกล่องจดหมายที่ยังไม่อ่าน
ก่อนใช้ผู้ให้บริการเนื้อหานี้ ให้เรียกใช้เมธอด 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 */);
ค้นหาผู้ให้บริการเนื้อหา
เมื่อเลือกอีเมลแล้ว คุณจะใช้ URI ContentProvider
สําหรับการค้นหาได้ เรามีชั้นเรียนแบบเรียบง่ายชื่อ
GmailContract.java
เพื่อสร้าง URI และกําหนดคอลัมน์ที่แสดงผล
แอปจะค้นหา URI นี้ได้โดยตรง หรือที่ดีไปกว่านั้นคือใช้ CursorLoader
เพื่อรับเคอร์เซอร์ที่มีข้อมูลสําหรับป้ายกํากับทั้งหมดในบัญชี
Cursor labelsCursor = getContentResolver().query(GmailContract.Labels.getLabelsUri(selectedAccount), null, null, null, null);
ด้วยข้อมูลในเคอร์เซอร์นี้ คุณสามารถรักษาค่า URI ไว้ในคอลัมน์ 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
}
}
}
หากต้องการความช่วยเหลือเพิ่มเติม โปรดอ่าน ข้อมูลเบื้องต้นเกี่ยวกับผู้ให้บริการเนื้อหา
ดูตัวอย่าง
หากต้องการดูตัวอย่างผู้ให้บริการเนื้อหารายนี้ขณะที่ใช้งาน โปรดดาวน์โหลดแอปตัวอย่าง