การเริ่มต้นอย่างรวดเร็วจะอธิบายถึงการตั้งค่าและเรียกใช้แอปที่เรียก Google Workspace API
การเริ่มต้น Google Workspace อย่างรวดเร็วจะใช้ไลบรารีของไคลเอ็นต์ API เพื่อจัดการรายละเอียดบางอย่างของขั้นตอนการตรวจสอบสิทธิ์และการให้สิทธิ์ เราขอแนะนําให้ใช้ไลบรารีของไคลเอ็นต์สําหรับแอปของคุณเอง การเริ่มต้นอย่างรวดเร็วนี้ใช้วิธีการตรวจสอบสิทธิ์ที่ง่ายขึ้นซึ่งเหมาะสําหรับสภาพแวดล้อมการทดสอบ ในสภาพแวดล้อมการใช้งานจริง เราขอแนะนําให้ดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์ก่อนเลือกข้อมูลรับรองการเข้าถึงที่เหมาะกับแอป
สร้างเว็บแอปพลิเคชัน JavaScript ที่ส่งคําขอไปยัง Gmail API
วัตถุประสงค์
- ตั้งค่าสภาพแวดล้อมของคุณ
- ตั้งค่าตัวอย่าง
- เรียกใช้ตัวอย่าง
สิ่งที่ต้องดำเนินการก่อน
- Node.js และ npm ติดตั้งอยู่
- โปรเจ็กต์ Google Cloud
- บัญชี Google ที่เปิดใช้ Gmail
ตั้งค่าสภาพแวดล้อมของคุณ
ตั้งค่าสภาพแวดล้อมให้เสร็จสมบูรณ์เพื่อให้การเริ่มต้นอย่างรวดเร็วนี้เสร็จสมบูรณ์
เปิดใช้ API
ก่อนใช้ Google APIs คุณต้องเปิดใช้งาน API ดังกล่าวในโปรเจ็กต์ Google Cloud คุณจะเปิดใช้ API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud เดียวได้เปิดใช้ Google 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
โปรดจดข้อมูลรับรองเหล่านี้ไว้เนื่องจากคุณจําเป็นต้องใช้ในภายหลังในการเริ่มต้นอย่างรวดเร็วนี้
สร้างคีย์ API
- ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > ข้อมูลเข้าสู่ระบบ
- คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
- คีย์ API ใหม่จะปรากฏขึ้น
- คลิกคัดลอก เพื่อคัดลอกคีย์ API เพื่อใช้ในโค้ดของแอป คีย์ API ยังอยู่ในส่วน "คีย์ API" ของข้อมูลรับรองของโปรเจ็กต์ด้วย
- คลิกจํากัดคีย์เพื่ออัปเดตการตั้งค่าขั้นสูงและจํากัดการใช้คีย์ API โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อการใช้การจํากัดคีย์ API
ตั้งค่าตัวอย่าง
- ในไดเรกทอรีชื่อ ให้สร้างไฟล์ชื่อ
index.html
ในไฟล์
index.html
ให้วางโค้ดตัวอย่างต่อไปนี้แทนที่รายการต่อไปนี้
YOUR_CLIENT_ID
: รหัสไคลเอ็นต์ที่คุณสร้างเมื่อตรวจสอบสิทธิ์ข้อมูลรับรองสําหรับเว็บแอปพลิเคชันYOUR_API_KEY
: คีย์ API ที่คุณสร้างเป็นข้อกําหนดเบื้องต้น
เรียกใช้ตัวอย่าง
ติดตั้งแพ็กเกจ http-server ในไดเรกทอรีการทํางานดังนี้
npm install http-server
ในไดเรกทอรีที่ทํางาน ให้เริ่มต้นเว็บเซิร์ฟเวอร์:
npx http-server -p 8000
ในเบราว์เซอร์ ให้ไปที่
http://localhost:8000
ครั้งแรกที่เรียกใช้ตัวอย่าง ระบบจะแจ้งให้คุณให้สิทธิ์เข้าถึง
- หากคุณยังไม่ได้ลงชื่อเข้าใช้บัญชี Google ของคุณ ระบบจะแจ้งให้คุณลงชื่อเข้าใช้ หากลงชื่อเข้าใช้หลายบัญชี ให้เลือกบัญชีที่จะใช้เพื่อให้สิทธิ์
- คลิกยอมรับ
- คัดลอกโค้ดจากเบราว์เซอร์ วางลงในพรอมท์บรรทัดคําสั่ง และกด
Enter
ข้อมูลการให้สิทธิ์จะจัดเก็บไว้ในระบบไฟล์ ดังนั้น เมื่อคุณเรียกใช้โค้ดตัวอย่างครั้งต่อไป จึงไม่ได้รับแจ้งให้ให้สิทธิ์
คุณได้สร้างแอปพลิเคชัน JavaScript แรกที่ส่งคําขอไปยัง Gmail API เรียบร้อยแล้ว
ขั้นตอนถัดไป
- แก้ปัญหาการตรวจสอบสิทธิ์และการให้สิทธิ์
- เอกสารอ้างอิง Gmail API
- ส่วน
google-api-javascript-client
ของ GitHub