รับรหัสไคลเอ็นต์ OAuth 2.0

ภาพรวม

หากต้องการใช้ Google Fit สำหรับ Android คุณต้องมีรหัสไคลเอ็นต์ OAuth 2.0 สำหรับ แอปพลิเคชัน Android

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

รหัสไคลเอ็นต์ OAuth ของ Android จะลิงก์กับคู่ใบรับรอง/แพ็กเกจที่เฉพาะเจาะจง คุณ โดยใช้เพียงรหัสเดียวต่อใบรับรองแต่ละรายการ ไม่ว่าคุณจะมีผู้ใช้สำหรับ แอปนั้น

การรับรหัสสําหรับแอปต้องทําตามขั้นตอนหลายขั้นตอน ขั้นตอนเหล่านี้มีเส้นขอบ ที่ด้านล่าง

  1. ค้นหาข้อมูลใบรับรองของแอป
  2. สร้างหรือแก้ไขโปรเจ็กต์ในคอนโซล Google API
  3. ขอรหัสไคลเอ็นต์ OAuth 2.0

ค้นหาข้อมูลใบรับรองของแอป

คีย์ API จะอิงตามใบรับรองดิจิทัลแบบสั้นของแอป ซึ่งเรียกว่าลายนิ้วมือ SHA-1 วิธีแสดง SHA-1 สำหรับใบรับรองของคุณ ก่อนอื่นให้ตรวจสอบว่าคุณใช้ ใบรับรอง คุณอาจมีใบรับรอง 2 ใบ ดังนี้

  • ใบรับรองแก้ไขข้อบกพร่อง: เครื่องมือ Android SDK จะสร้างใบรับรองนี้โดยอัตโนมัติเมื่อคุณสร้างบิลด์แก้ไขข้อบกพร่อง ใช้ใบรับรองนี้กับแอปที่คุณทดสอบเท่านั้น อย่าพยายามเผยแพร่แอปที่รับรองด้วยใบรับรองการแก้ไขข้อบกพร่อง คำอธิบายเกี่ยวกับใบรับรองการแก้ไขข้อบกพร่องมีรายละเอียดเพิ่มเติมใน การลงนาม ในโหมดแก้ไขข้อบกพร่องในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Android
  • ใบรับรองรุ่น: เครื่องมือ Android SDK จะสร้าง ใบรับรองนี้เมื่อคุณสร้างบิลด์ที่เผยแพร่ นอกจากนี้ คุณยังสามารถสร้าง โดยใช้โปรแกรม keytool ใช้ใบรับรองนี้เมื่อ คุณก็พร้อมที่จะเปิดตัวแอปสู่สายตาคนทั้งโลก

ทำตามขั้นตอนด้านล่างเพื่อแสดงลายนิ้วมือ SHA-1 ของใบรับรองโดยใช้โปรแกรม keytool ที่มีพารามิเตอร์ -v ดูข้อมูลเพิ่มเติมเกี่ยวกับ Keytool ได้ที่เอกสารประกอบของ Oracle

ใบรับรองสำหรับการแก้ไขข้อบกพร่อง

การแสดงลายนิ้วมือสำหรับใบรับรองการแก้ไขข้อบกพร่อง

  1. ค้นหาไฟล์คีย์สโตร์สำหรับการแก้ไขข้อบกพร่อง ชื่อไฟล์คือ debug.keystore และสร้างขึ้นเมื่อคุณสร้างโปรเจ็กต์เป็นครั้งแรก โดยค่าเริ่มต้น ระบบจะจัดเก็บไฟล์ไว้ในไดเรกทอรีเดียวกับไฟล์อุปกรณ์เสมือน (AVD) ของ Android

    • macOS และ Linux: ~/.android/
    • Windows Vista และ Windows 7: C:\Users\your_user_name\.android\

  2. แสดงรายการลายนิ้วมือ SHA-1

    • สำหรับ Linux หรือ macOS ให้เปิดหน้าต่างเทอร์มินัลและป้อนข้อมูลต่อไปนี้

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • สำหรับ Windows Vista และ Windows 7 ให้เรียกใช้:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

คุณควรเห็นเอาต์พุตในลักษณะนี้

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
ใบรับรองการเผยแพร่

แสดงลายนิ้วมือสำหรับใบรับรองรุ่น

  1. ค้นหาไฟล์คีย์สโตร์ใบรับรองรุ่น ไม่มีตำแหน่งหรือชื่อเริ่มต้นสำหรับคีย์สโตร์รุ่น หากคุณไม่ได้ระบุคีย์เมื่อสร้างแอปเพื่อเผยแพร่ บิลด์จะ.apkไม่ได้ลงนาม และคุณจะต้องลงนามก่อนจึงจะเผยแพร่ได้ สำหรับใบรับรองรุ่นที่เผยแพร่ คุณจะต้องมีอีเมลแทนของใบรับรอง รวมถึงรหัสผ่านสำหรับคีย์สโตร์และใบรับรองด้วย คุณสามารถแสดงรายการอีเมลแทนสำหรับคีย์ทั้งหมดในคีย์สโตร์ได้โดยป้อนข้อมูลต่อไปนี้

    keytool -list -keystore your_keystore_name

    แทนที่ your_keystore_name ด้วยตัวเลือกแบบเต็ม เส้นทางและชื่อของคีย์สโตร์ ซึ่งรวมถึง .keystore ส่วนขยาย ระบบจะขอให้คุณป้อนรหัสผ่านของคีย์สโตร์ จากนั้น keytool จะแสดงอีเมลแทนทั้งหมดในคีย์สโตร์

  2. ป้อนข้อมูลต่อไปนี้ที่เทอร์มินัลหรือ Command Prompt

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    แทนที่ your_keystore_name ด้วยเส้นทางและชื่อที่สมบูรณ์ของคีย์สโตร์ รวมถึงส่วนขยาย .keystore แทนที่ your_alias_name ด้วยชื่อแทนที่คุณกำหนดให้กับใบรับรองเมื่อสร้าง

คุณควรจะเห็นเอาต์พุตในลักษณะนี้

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

บรรทัดที่ขึ้นต้นด้วย SHA1 มีลายนิ้วมือ SHA-1 ของใบรับรอง โดยลายนิ้วมือคือลําดับตัวเลขฐานสิบหก 2 หลัก 20 รายการที่คั่นด้วยเครื่องหมายโคลอน

ขอรหัสไคลเอ็นต์ OAuth 2.0 ในคอนโซล Google API

ทําตามขั้นตอนต่อไปนี้เพื่อสร้างหรือแก้ไขโปรเจ็กต์สําหรับแอปในคอนโซล Google API, เปิดใช้ Fitness API และขอรหัสไคลเอ็นต์ OAuth 2.0

หากต้องการรับคำแนะนำตลอดกระบวนการและเปิดใช้งาน Fitness API โดยอัตโนมัติ ให้คลิก

รับรหัสไคลเอ็นต์

หรือทำตามขั้นตอนเหล่านี้เพื่อเปิดใช้ Fitness API ใน คอนโซล Google API และรับรหัสไคลเอ็นต์ OAuth 2.0

  1. ไปที่คอนโซล Google API
  2. เลือกโปรเจ็กต์หรือสร้างโปรเจ็กต์ใหม่ ใช้โปรเจ็กต์เดียวกันสำหรับ Android และเวอร์ชัน REST ของแอป
  3. คลิกต่อไปเพื่อเปิดใช้ Fitness API
  4. คลิกไปที่ข้อมูลเข้าสู่ระบบ
  5. คลิกข้อมูลเข้าสู่ระบบใหม่ แล้วเลือกรหัสไคลเอ็นต์ OAuth
  6. ในส่วนประเภทแอปพลิเคชัน ให้เลือก Android

  7. ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ป้อนลายนิ้วมือ SHA-1 และแพ็กเกจของแอป ชื่อ เช่น

    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

    com.example.android.fit-example

  8. คลิกสร้าง รหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 ใหม่ของ Android จะปรากฏในรายการรหัสของโปรเจ็กต์ รหัสไคลเอ็นต์ OAuth 2.0 คือสตริงอักขระที่มีลักษณะดังนี้

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com