สร้างข้อมูลรับรองการเข้าถึง

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

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

เลือกข้อมูลเข้าสู่ระบบเพื่อการเข้าถึงที่เหมาะกับคุณ

ข้อมูลเข้าสู่ระบบที่จำเป็นต้องใช้จะขึ้นอยู่กับประเภทข้อมูล แพลตฟอร์ม และวิธีการเข้าถึงของแอป โดยมีข้อมูลเข้าสู่ระบบ 3 ประเภทดังนี้

กรณีการใช้งาน	วิธีการตรวจสอบสิทธิ์	เกี่ยวกับวิธีการตรวจสอบสิทธิ์นี้
เข้าถึงข้อมูลที่พร้อมใช้งานแบบสาธารณะโดยไม่ระบุตัวตนในแอป	คีย์ API	ตรวจสอบว่า API ที่ต้องการใช้รองรับคีย์ API ก่อนที่จะใช้วิธีการตรวจสอบสิทธิ์นี้
เข้าถึงข้อมูลผู้ใช้ เช่น อีเมลหรืออายุ	รหัสไคลเอ็นต์ OAuth	กำหนดให้แอปของคุณต้องขอและรับความยินยอมจากผู้ใช้
เข้าถึงข้อมูลที่เป็นของแอปพลิเคชันของคุณเองหรือเข้าถึงทรัพยากร ในนามของผู้ใช้ Google Workspace หรือ Cloud Identity ผ่าน การมอบสิทธิ์ทั่วทั้งโดเมน	บัญชีบริการ	เมื่อแอปตรวจสอบสิทธิ์ในฐานะบัญชีบริการ แอปจะมีสิทธิ์เข้าถึงทรัพยากรทั้งหมด ที่บัญชีบริการมีสิทธิ์เข้าถึง

ข้อมูลเข้าสู่ระบบคีย์ API

คีย์ API คือสตริงยาวที่มีตัวอักษรพิมพ์ใหญ่และพิมพ์เล็ก ตัวเลข ขีดล่าง และขีดกลาง เช่น AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe วิธีการตรวจสอบสิทธิ์นี้ใช้เพื่อเข้าถึงข้อมูลที่พร้อมใช้งานแบบสาธารณะโดยไม่ระบุตัวตน เช่น ไฟล์ Google Workspace ที่แชร์โดยใช้การตั้งค่าการแชร์ "ทุกคนที่มีลิงก์นี้บนอินเทอร์เน็ต" ดูรายละเอียดเพิ่มเติมได้ที่ การใช้คีย์ API

วิธีสร้างคีย์ API

1. ในคอนโซล Google Cloud ให้ไปที่เมนู menu > API และบริการ > ข้อมูลเข้าสู่ระบบ

   ไปที่ข้อมูลเข้าสู่ระบบ

2. คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
3. คีย์ API ใหม่จะปรากฏขึ้น
   • คลิกคัดลอก content_copy เพื่อคัดลอกคีย์ API ไปใช้ในโค้ดของแอป นอกจากนี้ คุณยังดูคีย์ API ได้ในส่วน "คีย์ API" ของ ข้อมูลเข้าสู่ระบบของโปรเจ็กต์
   • เราขอแนะนำให้จำกัดตำแหน่งและ API ที่สามารถใช้คีย์ API เพื่อป้องกันการใช้งานที่ไม่ได้รับอนุญาต ดูรายละเอียดเพิ่มเติมได้ที่ เพิ่มข้อจำกัด API

ข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth

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

เลือกประเภทแอปพลิเคชัน เพื่อดูวิธีการสร้างรหัสไคลเอ็นต์ OAuth โดยเฉพาะ

เว็บแอปพลิเคชัน

1. ในคอนโซล Google API ให้ไปที่เมนู menu > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์

   ไปที่ไคลเอ็นต์

2. คลิกสร้างไคลเอ็นต์
3. คลิกประเภทแอปพลิเคชัน > เว็บแอปพลิเคชัน
4. พิมพ์ชื่อข้อมูลเข้าสู่ระบบในช่องชื่อ ชื่อนี้จะแสดงในคอนโซล Google API เท่านั้น
5. เพิ่ม URI ที่ได้รับอนุญาตซึ่งเกี่ยวข้องกับแอปของคุณ โดยทำดังนี้
   • แอปฝั่งไคลเอ็นต์ (JavaScript)–ในส่วนต้นทาง JavaScript ที่ได้รับอนุญาต ให้คลิกเพิ่ม URI จากนั้นป้อน URI ที่จะใช้สำหรับคำขอของเบราว์เซอร์ ซึ่งจะระบุโดเมนที่แอปพลิเคชันของคุณสามารถส่งคำขอ API ไปยังเซิร์ฟเวอร์ OAuth 2.0 ได้
   • แอปฝั่งเซิร์ฟเวอร์ (Java, Python และอื่นๆ)–ในส่วนURI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิกเพิ่ม URI จากนั้นป้อน URI ปลายทางที่เซิร์ฟเวอร์ OAuth 2.0 สามารถส่งการตอบกลับไปได้
6. คลิกสร้าง

   ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วนรหัสไคลเอ็นต์ OAuth 2.0

   จดรหัสไคลเอ็นต์ไว้ ระบบจะไม่ใช้รหัสลับไคลเอ็นต์สำหรับเว็บแอปพลิเคชัน

Android

1. ในคอนโซล Google API ให้ไปที่เมนู menu > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์

   ไปที่ไคลเอ็นต์

2. คลิกสร้างไคลเอ็นต์
3. คลิกประเภทแอปพลิเคชัน > Android
4. พิมพ์ชื่อข้อมูลเข้าสู่ระบบในช่อง "ชื่อ" ชื่อนี้จะแสดงในคอนโซล Google API เท่านั้น
5. ในช่อง "ชื่อแพ็กเกจ" ให้ป้อนชื่อแพ็กเกจจากไฟล์ AndroidManifest.xml
6. ในช่อง "ลายนิ้วมือใบรับรอง SHA-1" ให้ป้อนลายนิ้วมือของใบรับรอง SHA-1 ที่สร้างขึ้น
7. คลิกสร้าง

   ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วน "รหัสไคลเอ็นต์ OAuth 2.0"

iOS

1. ในคอนโซล Google API ให้ไปที่เมนู menu > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์

   ไปที่ไคลเอ็นต์

2. คลิกสร้างไคลเอ็นต์
3. คลิกประเภทแอปพลิเคชัน > iOS
4. พิมพ์ชื่อข้อมูลเข้าสู่ระบบในช่อง "ชื่อ" ชื่อนี้จะแสดงในคอนโซล Google API เท่านั้น
5. ในช่อง "รหัสชุดซอฟต์แวร์" ให้ป้อนรหัสชุดซอฟต์แวร์ดังที่แสดงในไฟล์ Info.plist ของแอป
6. ไม่บังคับ: หากแอปปรากฏใน Apple App Store ให้ป้อนรหัส App Store
7. ไม่บังคับ: ในช่อง "รหัสทีม" ให้ป้อนสตริงแบบ 10 อักขระที่ไม่ซ้ำกันซึ่งสร้างโดย Apple และกำหนดให้กับทีมของคุณ
8. คลิกสร้าง

   ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วน "รหัสไคลเอ็นต์ OAuth 2.0"

ส่วนขยาย Chrome

1. ในคอนโซล Google API ให้ไปที่เมนู menu > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์

   ไปที่ไคลเอ็นต์

2. คลิกสร้างไคลเอ็นต์
3. คลิกประเภทแอปพลิเคชัน > ส่วนขยาย Chrome
4. พิมพ์ชื่อข้อมูลเข้าสู่ระบบในช่อง "ชื่อ" ชื่อนี้จะแสดงในคอนโซล Google API เท่านั้น
5. ในช่อง "รหัสสินค้า" ให้ป้อนสตริงรหัสแบบ 32 อักขระที่ไม่ซ้ำกันของแอป คุณดูค่ารหัสนี้ได้ใน URL ของแอปใน Chrome เว็บสโตร์และในแดชบอร์ดสำหรับนักพัฒนาซอฟต์แวร์ Chrome เว็บสโตร์
6. คลิกสร้าง

   ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วน "รหัสไคลเอ็นต์ OAuth 2.0"

แอปบนเดสก์ท็อป

1. ในคอนโซล Google API ให้ไปที่เมนู menu > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์

   ไปที่ไคลเอ็นต์

2. คลิกสร้างไคลเอ็นต์
3. คลิกประเภทแอปพลิเคชัน > แอปบนเดสก์ท็อป
4. พิมพ์ชื่อข้อมูลเข้าสู่ระบบในช่องชื่อ ชื่อนี้จะแสดงในคอนโซล Google API เท่านั้น
5. คลิกสร้าง

   ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วน "รหัสไคลเอ็นต์ OAuth 2.0"

TV และอุปกรณ์อินพุตที่จำกัด

1. ในคอนโซล Google API ให้ไปที่เมนู menu > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์

   ไปที่ไคลเอ็นต์

2. คลิกสร้างไคลเอ็นต์
3. คลิกประเภทแอปพลิเคชัน > TV และอุปกรณ์อินพุตที่จำกัด
4. พิมพ์ชื่อข้อมูลเข้าสู่ระบบในช่อง "ชื่อ" ชื่อนี้จะแสดงในคอนโซล Google API เท่านั้น
5. คลิกสร้าง

   ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วน "รหัสไคลเอ็นต์ OAuth 2.0"

Universal Windows Platform (UWP)

1. ในคอนโซล Google API ให้ไปที่เมนู menu > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์

   ไปที่ไคลเอ็นต์

2. คลิกสร้างไคลเอ็นต์
3. คลิกประเภทแอปพลิเคชัน > Universal Windows Platform (UWP)
4. พิมพ์ชื่อข้อมูลเข้าสู่ระบบในช่อง "ชื่อ" ชื่อนี้จะแสดงในคอนโซล Google API เท่านั้น
5. ในช่อง "รหัส Store" ให้ป้อนค่ารหัส Microsoft Store แบบ 12 อักขระที่ไม่ซ้ำกันของแอป คุณดูรหัสนี้ได้ใน URL ของแอปใน Microsoft Store และใน Partner Center
6. คลิกสร้าง

   ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วน "รหัสไคลเอ็นต์ OAuth 2.0"

ข้อมูลเข้าสู่ระบบบัญชีบริการ

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

สร้างบัญชีบริการ

คอนโซล Google API

1. ในคอนโซล Google API ให้ไปที่เมนูเมนู menu > IAM และผู้ดูแลระบบ > บัญชีบริการ

   ไปที่บัญชีบริการ

2. คลิกสร้างบัญชีบริการ
3. กรอกรายละเอียดบัญชีบริการ แล้วคลิกสร้างและดำเนินการต่อ
4. ไม่บังคับ: มอบหมายบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud ดูรายละเอียดเพิ่มเติมได้ที่การให้ เปลี่ยน และเพิกถอนสิทธิ์เข้าถึงทรัพยากร
5. คลิกต่อไป
6. ไม่บังคับ: ป้อนผู้ใช้หรือกลุ่มที่สามารถจัดการและดำเนินการด้วยบัญชีบริการนี้ ดูรายละเอียดเพิ่มเติมได้ที่การจัดการการแอบอ้างเป็นบัญชีบริการ
7. คลิกเสร็จสิ้น จดอีเมลของบัญชีบริการไว้

gcloud CLI

1. สร้างบัญชีบริการโดยทำดังนี้

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. ไม่บังคับ: มอบหมายบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud ดูรายละเอียดเพิ่มเติมได้ที่การให้ เปลี่ยน และเพิกถอนสิทธิ์เข้าถึงทรัพยากร

มอบหมายบทบาทให้กับบัญชีบริการ

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

1. ในคอนโซลผู้ดูแลระบบของ Google ให้ไปที่เมนู menu> บัญชี > บทบาทของผู้ดูแลระบบ

   ไปที่บทบาทของผู้ดูแลระบบ

2. ชี้ไปที่บทบาทที่ต้องการมอบหมาย แล้วคลิกมอบหมายเป็นผู้ดูแลระบบ

3. คลิกมอบหมายบัญชีบริการ

4. ป้อนอีเมลของบัญชีบริการ

5. คลิก เพิ่ม > มอบหมายบทบาท.

สร้างข้อมูลเข้าสู่ระบบสำหรับบัญชีบริการ

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

วิธีรับข้อมูลเข้าสู่ระบบสำหรับบัญชีบริการ

1. ในคอนโซล Google Cloud ให้ไปที่เมนู menu > IAM และผู้ดูแลระบบ > บัญชีบริการ

   ไปที่บัญชีบริการ

2. เลือกบัญชีบริการ
3. คลิกคีย์ > เพิ่มคีย์ > สร้างคีย์ใหม่
4. เลือก JSON แล้วคลิก สร้าง

   ระบบจะสร้างคู่คีย์สาธารณะ/ส่วนตัวใหม่และดาวน์โหลดลงในเครื่องของคุณเป็นไฟล์ใหม่ บันทึกไฟล์ JSON ที่ดาวน์โหลดเป็น credentials.json ในไดเรกทอรีงาน ไฟล์นี้จะเป็นสำเนาเพียงรายการเดียวของคีย์นี้ ดูข้อมูลเกี่ยวกับวิธีจัดเก็บ คีย์อย่างปลอดภัยได้ที่ การจัดการคีย์ของบัญชีบริการ

5. คลิกปิด

ไม่บังคับ: ตั้งค่าการมอบสิทธิ์ทั่วทั้งโดเมนสำหรับบัญชีบริการ

หากต้องการเรียกใช้ API ในนามของผู้ใช้ในองค์กร Google Workspace บัญชีบริการของคุณต้องได้รับการมอบสิทธิ์ทั่วทั้งโดเมนในคอนโซลผู้ดูแลระบบของ Google Workspace โดยบัญชีผู้ดูแลระบบขั้นสูง ดูข้อมูลเพิ่มเติมได้ที่ การมอบสิทธิ์ทั่วทั้งโดเมนให้กับบัญชีบริการ

วิธีตั้งค่าการมอบสิทธิ์ทั่วทั้งโดเมนสำหรับบัญชีบริการ

1. ในคอนโซล Google Cloud ให้ไปที่เมนู menu > IAM และผู้ดูแลระบบ > บัญชีบริการ

   ไปที่บัญชีบริการ

2. เลือกบัญชีบริการ
3. คลิกแสดงการตั้งค่าขั้นสูง
4. ในส่วน "การมอบสิทธิ์ทั่วทั้งโดเมน" ให้ค้นหา "รหัสไคลเอ็นต์" ของบัญชีบริการ คลิกคัดลอก content_copy เพื่อคัดลอกค่ารหัสไคลเอ็นต์ไปยังคลิปบอร์ด

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

   หากคุณไม่มีสิทธิ์เข้าถึงระดับผู้ดูแลระบบขั้นสูงในบัญชี Google Workspace ที่เกี่ยวข้อง โปรดติดต่อผู้ดูแลระบบขั้นสูงของบัญชีดังกล่าว แล้วส่งรหัสไคลเอ็นต์ และรายการขอบเขต OAuth ของบัญชีบริการให้ผู้ดูแลระบบขั้นสูงดำเนินการตามขั้นตอนต่อไปนี้ในคอนโซลผู้ดูแลระบบ

1. ในคอนโซลผู้ดูแลระบบของ Google ให้ไปที่เมนู menu > ความปลอดภัย > การเข้าถึงและการควบคุมข้อมูล > การควบคุม API

   ไปที่การควบคุม API

2. คลิกจัดการการมอบสิทธิ์ทั่วทั้งโดเมน
3. คลิกเพิ่มใหม่
4. วางรหัสไคลเอ็นต์ที่คัดลอกไว้ก่อนหน้านี้ในช่อง "รหัสไคลเอ็นต์"
5. ในช่อง "ขอบเขต OAuth" ให้ป้อนรายการขอบเขตที่แอปพลิเคชันต้องใช้โดยคั่นด้วยคอมมา ซึ่งเป็นชุดขอบเขตเดียวกันกับที่คุณกำหนดไว้เมื่อกำหนดค่าหน้าจอขอความยินยอม OAuth
6. คลิกให้สิทธิ์

ขั้นตอนถัดไป

คุณพร้อมที่จะพัฒนาบน Google Workspace แล้ว โปรดดูรายการผลิตภัณฑ์สำหรับนักพัฒนาแอป Google Workspace และ วิธีขอความช่วยเหลือ