การเริ่มต้นอย่างรวดเร็วจะอธิบายวิธีการตั้งค่าและเรียกใช้แอปที่เรียกใช้ Google Workspace API
การเริ่มต้นใช้งาน Google Workspace อย่างรวดเร็วจะใช้ไลบรารีของไคลเอ็นต์ API เพื่อจัดการรายละเอียดของขั้นตอนการตรวจสอบสิทธิ์และการให้สิทธิ์ เราขอแนะนําให้ใช้ไลบรารีของไคลเอ็นต์สําหรับแอปของคุณเอง การเริ่มต้นอย่างรวดเร็วแต่ละครั้งกําหนดให้คุณต้องเปิดการตรวจสอบสิทธิ์และการให้สิทธิ์ก่อนจึงจะเรียกใช้แอปตัวอย่างได้ หากคุณไม่คุ้นเคยกับการตรวจสอบสิทธิ์และการให้สิทธิ์สําหรับ Google Workspace API โปรดอ่านภาพรวมการตรวจสอบสิทธิ์และการให้สิทธิ์
สร้างเว็บแอปพลิเคชันแบบ JavaScript ที่ส่งคําขอไปยัง Gmail API
วัตถุประสงค์
- ตั้งค่าสภาพแวดล้อม
- ตั้งค่าตัวอย่าง
- เรียกใช้ตัวอย่าง
สิ่งที่ต้องดำเนินการก่อน
- Python 2.4 ขึ้นไป เพื่อเรียกใช้เว็บเซิร์ฟเวอร์
- โปรเจ็กต์ Google Cloud
- บัญชี Google ที่เปิดใช้ Gmail
ตั้งค่าสภาพแวดล้อม
ตั้งค่าสภาพแวดล้อมให้เสร็จสมบูรณ์เพื่อให้คู่มือเริ่มใช้งานฉบับย่อนี้เสร็จสมบูรณ์
เปิดใช้ API
ก่อนที่จะใช้ Google API คุณต้องเปิด API เหล่านั้นในโปรเจ็กต์ Google Cloud คุณสามารถเปิด API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud โปรเจ็กต์เดียวได้เปิดใช้ Gmail API ในคอนโซล Google Cloud
ให้สิทธิ์เข้าสู่ระบบสําหรับเว็บแอปพลิเคชัน
หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ปลายทางและเข้าถึงข้อมูลผู้ใช้ในแอป คุณต้องสร้างรหัสไคลเอ็นต์ OAuth 2.0 อย่างน้อย 1 รายการ รหัสไคลเอ็นต์จะใช้เพื่อระบุแอปเดียวไปยังเซิร์ฟเวอร์ OAuth ของ Google หากแอปทํางานในหลายแพลตฟอร์ม คุณต้องสร้างรหัสไคลเอ็นต์แยกต่างหากสําหรับแต่ละแพลตฟอร์ม- ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > ข้อมูลเข้าสู่ระบบ
- คลิกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth
- คลิกประเภทแอปพลิเคชัน > เว็บแอปพลิเคชัน
- ในช่องชื่อ ให้พิมพ์ข้อมูลเข้าสู่ระบบ ชื่อนี้จะปรากฏในคอนโซล Google Cloud เท่านั้น
- เพิ่ม URI ที่ได้รับอนุญาตซึ่งเกี่ยวข้องกับแอปของคุณ
- แอปฝั่งไคลเอ็นต์ (JavaScript) - ในส่วนต้นทาง JavaScript ที่ได้รับอนุญาต ให้คลิกเพิ่ม URI จากนั้นป้อน URI ที่จะใช้สําหรับคําขอเบราว์เซอร์ เมตริกนี้ระบุโดเมนที่แอปพลิเคชันสามารถส่งคําขอ API ไปยังเซิร์ฟเวอร์ OAuth 2.0 ได้
- แอปฝั่งเซิร์ฟเวอร์ (Java, Python และอื่นๆ) - ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิกเพิ่ม URI จากนั้นป้อน URI ปลายทางที่เซิร์ฟเวอร์ OAuth 2.0 ส่งการตอบกลับได้
- คลิกสร้าง หน้าจอไคลเอ็นต์ OAuth ที่สร้างขึ้นจะปรากฏขึ้นเพื่อแสดงรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ใหม่
จดรหัสไคลเอ็นต์ รหัสลับไคลเอ็นต์จะใช้กับเว็บแอปพลิเคชันไม่ได้
- คลิกตกลง ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในรหัสไคลเอ็นต์ OAuth 2.0
- ไม่บังคับ: หากจะสร้างข้อมูลเข้าสู่ระบบที่เป็นข้อกําหนดเบื้องต้นสําหรับการเริ่มต้น JavaScript อย่างรวดเร็ว คุณต้องสร้างคีย์ API ด้วย
โปรดจดข้อมูลเข้าสู่ระบบเหล่านี้ไว้เนื่องจากคุณจําเป็นต้องใช้ในภายหลังได้อย่างรวดเร็ว
ตั้งค่าตัวอย่าง
- สร้างไฟล์ชื่อ
index.html
ในไดเรกทอรีการทํางาน ในไฟล์
index.html
ให้วางโค้ดตัวอย่างต่อไปนี้โดยแทนที่สิ่งต่อไปนี้
YOUR_CLIENT_ID
: รหัสไคลเอ็นต์ที่คุณสร้างเมื่อข้อมูลเข้าสู่ระบบที่ได้รับอนุญาตสําหรับเว็บแอปพลิเคชันYOUR_API_KEY
: คีย์ API ที่คุณสร้างเป็นข้อกําหนดเบื้องต้น
เรียกใช้ตัวอย่าง
เริ่มเว็บเซิร์ฟเวอร์ในไดเรกทอรีการทํางาน ดังนี้
Python 2.x
python -m SimpleHTTPServer 8000
Python 3.x
python3 -m http.server 8000
ไปที่
http://localhost:8000
ในเบราว์เซอร์ครั้งแรกที่คุณเรียกใช้ตัวอย่าง ระบบจะแจ้งให้คุณอนุญาตการเข้าถึง:
- หากยังไม่ได้ลงชื่อเข้าใช้บัญชี Google ระบบจะแจ้งให้ลงชื่อเข้าใช้ หากคุณลงชื่อเข้าใช้หลายบัญชี ให้เลือก 1 บัญชีที่จะใช้สําหรับการให้สิทธิ์
- คลิกยอมรับ
- คัดลอกโค้ดจากเบราว์เซอร์ วางลงในข้อความแจ้งบรรทัดคําสั่ง แล้วกด
Enter
ข้อมูลการให้สิทธิ์จะจัดเก็บอยู่ในระบบไฟล์ ดังนั้นในครั้งถัดไปที่คุณเรียกใช้ตัวอย่างโค้ด ระบบจะไม่แจ้งให้คุณให้สิทธิ์
คุณได้สร้างแอปพลิเคชัน JavaScript แรกที่ส่งคําขอไปยัง Gmail API เรียบร้อยแล้ว
ขั้นตอนถัดไป
- แก้ปัญหาการตรวจสอบสิทธิ์และการให้สิทธิ์
- เอกสารอ้างอิง Gmail API
- ส่วน
google-api-javascript-client
ของ GitHub