คีย์การลงชื่อสมัครใช้และ API

หากต้องการใช้ Google Awareness API คุณต้องเพิ่มคีย์ API ของ Google ลงในแอป โดยคีย์ API ที่คุณต้องใช้คือคีย์ API ของ Android

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

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

คุณต้องทำตามขั้นตอนหลายขั้นตอนเพื่อรับคีย์สำหรับแอป ซึ่งมีรายละเอียดอธิบายไว้ในคำแนะนำนี้ และสรุปได้ดังนี้

1. รับข้อมูลเกี่ยวกับใบรับรองของแอป
2. ลงทะเบียนโปรเจ็กต์ใน Google Developers Console และเพิ่ม User Context API เป็นบริการสำหรับโปรเจ็กต์
3. ขอคีย์
4. เพิ่มคีย์ลงในแอป โดยเพิ่มองค์ประกอบลงในไฟล์ Manifest ของแอป

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

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับ keytool ได้ใน เอกสารประกอบของ Oracle

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

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 ตัวที่คั่นด้วยโคลอน

รับคีย์ API จาก Google Developers Console

หากต้องการเริ่มต้นใช้งาน Google Awareness API ให้คลิกปุ่มรับคีย์ ปุ่มนี้จะลิงก์ไปยัง Google Developers Console ซึ่งจะแนะนำคุณตลอดกระบวนการและเปิดใช้งาน Awareness API โดยอัตโนมัติ

รับคีย์

หรือทำตามขั้นตอนต่อไปนี้เพื่อรับคีย์ API

1. ไปที่ Google Developers Console
2. เลือกโปรเจ็กต์หรือสร้างโปรเจ็กต์ใหม่
3. คลิกดำเนินการต่อ เพื่อเปิดใช้ Awareness API

4. ในหน้า "ข้อมูลเข้าสู่ระบบ" ให้สร้างคีย์ Android และตั้งค่าข้อมูลเข้าสู่ระบบ API

5. ในกล่องโต้ตอบ "สร้างคีย์" คุณต้องจำกัดการใช้งานไว้ที่แอป Android โดยป้อนลายนิ้วมือ 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.awareness-example
   

6. คลิกสร้าง คีย์ API ของ Android ใหม่จะปรากฏในรายการคีย์ API สำหรับโปรเจ็กต์ คีย์ API คือสตริงของอักขระ เช่น สตริงต่อไปนี้

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

เมื่อมีคีย์ API แล้ว คุณสามารถเพิ่มคีย์ลงในไฟล์ Manifest ของแอปได้ตามที่ อธิบายไว้ในคู่มือเริ่มต้นใช้งาน

เปิดใช้งาน API เพิ่มเติม

Awareness API ช่วยให้คุณเข้าถึงข้อมูลตามบริบทได้หลายประเภท เช่น บีคอน หากต้องการใช้ข้อมูลประเภทเหล่านี้ คุณต้องเปิดใช้ API ที่เกี่ยวข้องใน Google Developers Console