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

แอป Gmail สำหรับ Android มีผู้ให้บริการ เนื้อหา ที่นักพัฒนาแอปของบุคคลที่สามสามารถใช้เพื่อดึงข้อมูลป้ายกำกับ เช่น ชื่อและจำนวนข้อความที่ยังไม่ได้อ่าน รวมถึงรับข้อมูลล่าสุดเมื่อมีการเปลี่ยนแปลง ตัวอย่างเช่น แอปหรือวิดเจ็ตอาจแสดงจำนวนข้อความที่ยังไม่ได้อ่านในกล่องจดหมายของบัญชีที่เฉพาะเจาะจง

ก่อนใช้ผู้ให้บริการเนื้อหานี้ ให้เรียกใช้ GmailContract.canReadLabels(Context) เพื่อดูว่าแอป Gmail เวอร์ชันของผู้ใช้ รองรับการค้นหาเหล่านี้หรือไม่

ค้นหาบัญชี Gmail ที่ถูกต้องเพื่อใช้ในการค้นหา

แอปต้องค้นหาอีเมลของบัญชี Gmail ที่ถูกต้องก่อนเพื่อใช้ในการค้นหาข้อมูลป้ายกำกับ AccountManager สามารถแสดงข้อมูลนี้ได้โดยใช้สิทธิ์ GET_ACCOUNTS 

// 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 ไว้เพื่อสร้าง URI และกำหนดคอลัมน์ที่จะแสดงผล แอปสามารถค้นหา URI นี้ได้โดยตรง

เมื่อมีข้อมูลใน Cursor แล้ว คุณสามารถเก็บค่า URI ไว้ใน GmailContract.Labels.URI คอลัมน์เพื่อค้นหาและดูการเปลี่ยนแปลงในป้ายกำกับเดียว

ค่า NAME สำหรับป้ายกำกับที่กำหนดไว้ล่วงหน้าอาจแตกต่างกันไปตามภาษา ดังนั้นอย่าใช้ GmailContract.Labels.NAME แต่คุณสามารถระบุป้ายกำกับที่กำหนดไว้ล่วงหน้า เช่น กล่องจดหมาย ข้อความที่ส่ง หรือฉบับร่างได้โดยใช้ค่าสตริงใน GmailContract.Labels.CANONICAL_NAME คอลัมน์ดังนี้

// Query for all labels and find the Inbox.
try (Cursor labelsCursor = getContentResolver().query(
        GmailContract.Labels.getLabelsUri(selectedAccount), null, null, null, null)) {
    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.
            }
        }
    }
}

ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลเบื้องต้นเกี่ยวกับผู้ให้บริการเนื้อหา

ดูตัวอย่าง

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