ส่วนข้อมูลเข้าสู่ระบบของเครื่องมือสำรวจ API ช่วยให้คุณทดสอบด้วยข้อมูลเข้าสู่ระบบและขอบเขตต่างๆ ได้ ฟีเจอร์นี้มีประโยชน์ในการตรวจสอบว่าคุณใช้ข้อมูลเข้าสู่ระบบและขอบเขตที่จำเป็นขั้นต่ำเพื่อเรียกใช้ปลายทาง API
ทดสอบด้วยข้อมูลเข้าสู่ระบบที่แตกต่างกัน
ระบบจะเลือกทั้งประเภทข้อมูลเข้าสู่ระบบ OAuth 2 และคีย์ API โดยค่าเริ่มต้น หากต้องการทดสอบด้วยข้อมูลเข้าสู่ระบบเพียงชุดเดียว ให้เลือกประเภทข้อมูลเข้าสู่ระบบที่จะใช้ (และยกเลิกการเลือกประเภทข้อมูลเข้าสู่ระบบอื่นๆ) กฎทั่วไปสำหรับการเลือกข้อมูลเข้าสู่ระบบเพื่อใช้ทดสอบมีดังนี้
หากใช้วิธีการเข้าถึงข้อมูลสาธารณะ เช่น ข้อมูล Google Maps คุณจะใช้คีย์ API เป็นข้อมูลเข้าสู่ระบบได้ ตรวจสอบคีย์ API และยกเลิกการเลือก Google OAuth 2.0
หากใช้วิธีการเข้าถึงข้อมูลส่วนตัว เช่น ข้อมูลใน Google ไดรฟ์ของผู้ใช้ คุณต้องใช้ข้อมูลเข้าสู่ระบบ OAuth 2 ยกเลิกการเลือกคีย์ API แล้วเลือก Google OAuth 2.0
หากได้รับผลลัพธ์เป็น 200 แสดงว่าข้อมูลเข้าสู่ระบบเพียงพอ สำหรับการเข้าถึงข้อมูล หากได้รับผลลัพธ์เป็น 401 คุณต้อง ใช้ข้อมูลเข้าสู่ระบบ OAuth 2 เพื่อเข้าถึงข้อมูล
ทดสอบด้วยขอบเขตที่แตกต่างกัน
ขอบเขตคือสตริง เช่น
https://www.googleapis.com/auth/drive.metadata.readonly ซึ่งกำหนดระดับ
การเข้าถึงทรัพยากรที่แอปของคุณต้องการ เช่น ระดับการเข้าถึงข้อมูล
ที่เป็นของผู้ใช้ ในอุดมคติแล้ว คุณต้องการให้แอปใช้ขอบเขตที่มี
ระดับการเข้าถึงข้อมูลของผู้ใช้ที่แคบที่สุด วิธีการต่างๆ อาจต้องใช้ขอบเขตที่แตกต่างกัน
ตัวอย่างเช่น เมธอดใน API อาจต้องมี
ขอบเขตแบบอ่านอย่างน้อย ขณะที่เมธอดอื่นๆ อาจต้องมีขอบเขตแบบอ่าน-เขียน
โดยค่าเริ่มต้น ระบบจะเปิดใช้ขอบเขต OAuth 2.0 ทั้งหมดของ Google สำหรับ API ในโปรแกรมสำรวจ APIs วิธีทดสอบด้วยขอบเขตที่เฉพาะเจาะจง
- ในส่วนข้อมูลเข้าสู่ระบบ Google OAuth 2.0 ให้คลิกแสดงขอบเขต
- ตรวจสอบขอบเขตที่จะใช้เมื่อเรียกใช้เมธอด
- คลิกดำเนินการเพื่อเรียกใช้ API โดยใช้ขอบเขตที่เลือกเท่านั้น API Explorer จะแสดงหน้าจอการให้สิทธิ์เพื่อขอให้คุณให้สิทธิ์เข้าถึงเพื่อใช้ ขอบเขต
- คลิกอนุญาต ผลลัพธ์จะปรากฏใต้ปุ่ม "ดำเนินการ"
หาก API Explorer แสดงผลลัพธ์เป็น 200 ในส่วน "application/json" แสดงว่า ขอบเขตเพียงพอที่จะเรียกใช้เมธอด หากโปรแกรมสำรวจ API แสดง ผลลัพธ์เป็น 403 แสดงว่าคุณเลือกขอบเขตที่ไม่เพียงพอในการเรียกใช้เมธอด ลอง ขอบเขตที่กว้างขึ้น
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเลือกขอบเขตได้ที่ส่วนการตรวจสอบสิทธิ์และการให้สิทธิ์ในเอกสารประกอบสำหรับ Google API ที่เฉพาะเจาะจง
เพิกถอนการเข้าถึงที่ได้รับอนุญาตเพื่อทดสอบด้วยขอบเขตใหม่
หลังจากใช้หน้าจอการให้สิทธิ์ของ Google เพื่ออนุมัติการให้สิทธิ์แล้ว API Explorer จะยังคงได้รับสิทธิ์ในการส่งคำขอที่ผ่านการตรวจสอบสิทธิ์ตราบใด ที่ข้อมูลเข้าสู่ระบบยังไม่หมดอายุ การยกเลิกการเลือกขอบเขตจะไม่รีเซ็ต ข้อมูลเข้าสู่ระบบและขอบเขตที่อนุมัติก่อนหน้านี้ หากต้องการทดสอบด้วยการกำหนดค่าขอบเขตใหม่ คุณต้องเพิกถอนข้อมูลเข้าสู่ระบบที่ได้รับอนุมัติก่อนหน้านี้
วิธีเพิกถอนข้อมูลเข้าสู่ระบบที่ใช้โดยโปรแกรมสำรวจ API
- ไปที่แอปที่มีสิทธิ์เข้าถึงบัญชีของคุณ
- ในส่วนแอปของบุคคลที่สามที่มีสิทธิ์เข้าถึงบัญชี ให้คลิก Google APIs Explorer
- คลิกนำสิทธิ์เข้าถึงออก
- (ไม่บังคับ) โหลดหน้าเอกสารประกอบซ้ำเพื่อรีเซ็ตโปรแกรมสำรวจ API