บริการขั้นสูงใน Apps Script ช่วยให้นักพัฒนาซอฟต์แวร์ที่มีประสบการณ์สามารถเชื่อมต่อกับ Google API สาธารณะบางอันที่มีการตั้งค่าน้อยกว่าการใช้อินเทอร์เฟซ HTTP โดยบริการขั้นสูงจะซับซ้อนรอบด้านใน Google API เหล่านั้น โฆษณาเหล่านี้ ทำงานเหมือนกับ บริการในตัว เช่น นำเสนอ เติมข้อความอัตโนมัติ และ Apps Script จะจัดการกับ ขั้นตอนการให้สิทธิ์โดยอัตโนมัติ แต่คุณต้องเปิดใช้บริการขั้นสูงก่อน คุณสามารถใช้สคริปต์ในสคริปต์
หากต้องการดูว่า Google APIs ใดบ้างที่พร้อมใช้งานเป็นบริการขั้นสูง ให้มองหา ส่วนบริการขั้นสูงของ Google ในส่วน ข้อมูลอ้างอิง หากคุณต้องการใช้ Google API ที่ ไม่มีให้ใช้งานในรูปแบบบริการขั้นสูง เพียงเชื่อมต่อเหมือนบริการอื่นๆ API ภายนอก
บริการขั้นสูงหรือ HTTP
บริการขั้นสูงของ Google แต่ละรายการจะเชื่อมโยงกับ Google API สาธารณะ
ใน Apps Script คุณสามารถเข้าถึง API เหล่านี้ผ่านบริการขั้นสูงหรือเพียงแค่
สร้างคำขอ API โดยตรงโดยใช้
UrlFetch
หากคุณใช้วิธีการบริการขั้นสูง Apps Script จะจัดการ ขั้นตอนการให้สิทธิ์และข้อเสนอ การสนับสนุนการเติมข้อความอัตโนมัติ อย่างไรก็ตาม คุณต้อง เปิดใช้บริการขั้นสูงก่อนที่จะใช้ ได้ นอกจากนี้ บริการขั้นสูงบางอย่างจะมีเฉพาะ ฟังก์ชันที่พร้อมใช้งานใน API
หากใช้เมธอด UrlFetch
เพื่อเข้าถึง API โดยตรง คุณจะทำสิ่งต่อไปนี้ได้
โดยพื้นฐานแล้ว Google API นั้นเป็น
API ภายนอก เมื่อใช้วิธีนี้
ของ API ได้ในด้านต่างๆ แต่คุณจะต้องจัดการ API
การให้สิทธิ์ด้วยตนเอง คุณต้องสร้างส่วนหัวและแยกวิเคราะห์ที่จำเป็นด้วย
การตอบกลับจาก API
โดยทั่วไปแล้ว เป็นการง่ายที่สุดที่จะใช้บริการขั้นสูงเมื่อเป็นไปได้ และมีเพียง
ใช้เมธอด UrlFetch
เมื่อบริการขั้นสูงไม่มี
ฟังก์ชันที่คุณต้องการ
ข้อกำหนด
ก่อนจะใช้บริการขั้นสูง คุณต้องมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้ ข้อกำหนด
- คุณต้องเปิดใช้บริการขั้นสูง ในโปรเจ็กต์สคริปต์ของคุณ
คุณต้องตรวจสอบว่า API ที่สอดคล้องกับบริการขั้นสูงเปิดใช้อยู่ ในโปรเจ็กต์ Cloud Platform (GCP) ที่สคริปต์ใช้
หากโปรเจ็กต์สคริปต์ใช้โปรเจ็กต์ GCP เริ่มต้น ที่สร้างขึ้นในวันที่ 8 เมษายน 2019 เป็นต้นไป ระบบจะเปิดใช้ API ดังกล่าวโดยอัตโนมัติ หลังจากที่คุณเปิดใช้บริการขั้นสูงและบันทึกโปรเจ็กต์สคริปต์ หากคุณ สำหรับการดำเนินการข้างต้น คุณอาจ ขอยอมรับ Google Cloud และข้อกำหนดในการให้บริการของ Google APIs ได้ด้วย
หากโครงการสคริปต์ของคุณใช้ โปรเจ็กต์ GCP มาตรฐาน หรือโปรเจ็กต์ GCP เริ่มต้นแบบเก่า คุณต้องเปิดใช้ API ที่เกี่ยวข้องของบริการขั้นสูง ในโปรเจ็กต์ GCP ด้วยตนเอง คุณต้องมีสิทธิ์แก้ไขโปรเจ็กต์ GCP เพื่อทำการเปลี่ยนแปลงนี้
ดูโปรเจ็กต์ Cloud Platform เพื่อดูข้อมูลเพิ่มเติม
เปิดใช้บริการขั้นสูง
หากต้องการใช้บริการขั้นสูงของ Google ให้ทำตามวิธีการต่อไปนี้
- เปิดโครงการ Apps Script
- คลิกตัดต่อวิดีโอ ทางด้านซ้าย
- คลิกเพิ่มบริการทางด้านซ้ายข้างบริการ
- เลือกบริการขั้นสูงของ Google แล้วคลิกเพิ่ม
หลังจากที่คุณเปิดใช้บริการขั้นสูงแล้ว บริการดังกล่าวจะพร้อมใช้งานในการเติมข้อความอัตโนมัติ
วิธีระบุลายเซ็นวิธีการ
โดยทั่วไปบริการขั้นสูงจะใช้ออบเจ็กต์ ชื่อเมธอด และพารามิเตอร์เดียวกัน เป็น API สาธารณะที่เกี่ยวข้อง แต่จะมีการแปลลายเซ็นเมธอดสำหรับ ใช้ใน Apps Script ของเครื่องมือแก้ไขสคริปต์ ฟังก์ชันเติมข้อความอัตโนมัติ มักจะมีข้อมูลเพียงพอสำหรับการเริ่มต้นใช้งาน แต่กฎด้านล่างจะอธิบาย วิธีที่ Apps Script สร้างลายเซ็นเมธอดจาก Google API สาธารณะ
คำขอไปยัง Google APIs สามารถรับข้อมูลได้ หลายประเภท รวมถึงพารามิเตอร์เส้นทาง พารามิเตอร์การค้นหา เนื้อหาคำขอ และ/หรือสื่อ อัปโหลดไฟล์แนบ บริการขั้นสูงบางประเภทสามารถยอมรับคำขอ HTTP ที่เฉพาะเจาะจงได้ (ตัวอย่างเช่น บริการขั้นสูงของปฏิทิน)
ลายเซ็นเมธอดที่สอดคล้องกันใน Google Apps Script จะมีสิ่งต่อไปนี้ อาร์กิวเมนต์:
- เนื้อหาของคำขอ (มักจะเป็นทรัพยากร) เป็นออบเจ็กต์ JavaScript
- เส้นทางหรือพารามิเตอร์ที่จำเป็นเป็นอาร์กิวเมนต์แต่ละรายการ
- ไฟล์แนบที่อัปโหลดสื่อในรูปแบบ
Blob
อาร์กิวเมนต์ - พารามิเตอร์ที่ไม่บังคับ เป็นชื่อพารามิเตอร์การแมปออบเจ็กต์ JavaScript
- ส่วนหัวคำขอ HTTP เป็นชื่อส่วนหัวการแมปออบเจ็กต์ JavaScript กับส่วนหัว
หากเมธอดไม่มีรายการใดๆ ในหมวดหมู่ที่กำหนด ส่วนของ ละเว้นลายเซ็น
มีข้อยกเว้นพิเศษบางประการที่ควรทราบ ดังนี้
- สำหรับเมธอดที่ยอมรับการอัปโหลดสื่อ ระบบจะตั้งค่าพารามิเตอร์
uploadType
โดยอัตโนมัติ - เมธอดชื่อ
delete
ใน Google API จะมีชื่อว่าremove
ใน Apps Script เนื่องจากdelete
เป็นคำที่สงวนไว้ใน JavaScript - หากมีการกำหนดค่าบริการขั้นสูงให้ยอมรับส่วนหัวของคำขอ HTTP และคุณ ตั้งค่าอ็อบเจกต์ JavaScript ของส่วนหัวคำขอ คุณจะต้องตั้งค่าตัวเลือก พารามิเตอร์ JavaScript ของออบเจ็กต์ (ไปยังออบเจ็กต์ว่าง หากคุณไม่ได้ใช้ พารามิเตอร์ที่ไม่บังคับ)
การสนับสนุนสำหรับบริการขั้นสูง
บริการขั้นสูงเป็นเพียง Wrapper ขนาดเล็กที่ช่วยให้สามารถใช้ API ภายใน Apps Script ดังนั้น ปัญหาที่พบระหว่างการใช้งานคือ ปกติแล้วจะเป็นปัญหาเกี่ยวกับ API ที่สำคัญ ไม่ใช่กับ Apps Script
หากคุณประสบปัญหาขณะใช้บริการขั้นสูง รายงานโดยใช้คำแนะนำการสนับสนุนสำหรับ API ที่สำคัญ ลิงก์ไปยัง คำแนะนำในการสนับสนุนจะอยู่ในคู่มือบริการขั้นสูงแต่ละฉบับใน ส่วนข้อมูลอ้างอิงของ Apps Script