ผู้ให้บริการเนื้อหา Android สำหรับ Gmail

แอป 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 */);

ค้นหาผู้ให้บริการเนื้อหา

เมื่อคุณเลือกที่อยู่อีเมล คุณสามารถหา ContentProvider URI ที่จะใช้ในการค้นหา เราได้จัดให้มีชั้นเรียนง่ายๆ ชื่อ 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
        }
    }
}

สำหรับความช่วยเหลือเพิ่มเติม อ่าน ข้อมูลเบื้องต้นเกี่ยวกับผู้ให้บริการเนื้อหา

ดูตัวอย่าง

หากต้องการดูตัวอย่างการทำงานของผู้ให้บริการเนื้อหารายนี้ ดาวน์โหลดแอปตัวอย่าง