รับรหัสไคลเอ็นต์ 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 และจะสร้างขึ้นเมื่อคุณสร้าง โปรเจ็กต์เป็นครั้งแรก โดยค่าเริ่มต้น ระบบจะจัดเก็บไว้ในไดเรกทอรีเดียวกับไฟล์ Android Virtual Device (AVD) ดังนี้

    • 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. ค้นหาไฟล์คีย์สโตร์ของใบรับรองการเผยแพร่ Keystore สำหรับรุ่นที่เผยแพร่ไม่มีตำแหน่งหรือชื่อเริ่มต้น หากไม่ได้ระบุเมื่อสร้างแอปสำหรับเผยแพร่ บิลด์จะ.apkไม่ได้ลงนาม และคุณจะต้องลงนามก่อนจึงจะเผยแพร่ได้ สำหรับใบรับรองการเผยแพร่ คุณต้องมี นามแฝงของใบรับรอง รวมถึงรหัสผ่านสำหรับคีย์สโตร์และใบรับรองด้วย คุณแสดงรายการ ชื่อแทนของคีย์ทั้งหมดในคีย์สโตร์ได้โดยป้อนคำสั่งต่อไปนี้

    keytool -list -keystore your_keystore_name

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

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

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    แทนที่ your_keystore_name ด้วยเส้นทางและชื่อของ Keystore ที่มีคุณสมบัติครบถ้วน รวมถึงส่วนขยาย .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