บริการขั้นสูงของ Google

บริการขั้นสูงใน 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 เมื่อบริการขั้นสูงไม่มี ฟังก์ชันที่คุณต้องการ

ข้อกำหนด

ก่อนจะใช้บริการขั้นสูง คุณต้องมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้ ข้อกำหนด

  1. คุณต้องเปิดใช้บริการขั้นสูง ในโปรเจ็กต์สคริปต์ของคุณ

  2. คุณต้องตรวจสอบว่า API ที่สอดคล้องกับบริการขั้นสูงเปิดใช้อยู่ ในโปรเจ็กต์ Cloud Platform (GCP) ที่สคริปต์ใช้

    หากโปรเจ็กต์สคริปต์ใช้โปรเจ็กต์ GCP เริ่มต้น ที่สร้างขึ้นในวันที่ 8 เมษายน 2019 เป็นต้นไป ระบบจะเปิดใช้ API ดังกล่าวโดยอัตโนมัติ หลังจากที่คุณเปิดใช้บริการขั้นสูงและบันทึกโปรเจ็กต์สคริปต์ หากคุณ สำหรับการดำเนินการข้างต้น คุณอาจ ขอยอมรับ Google Cloud และข้อกำหนดในการให้บริการของ Google APIs ได้ด้วย

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

ดูโปรเจ็กต์ Cloud Platform เพื่อดูข้อมูลเพิ่มเติม

เปิดใช้บริการขั้นสูง

หากต้องการใช้บริการขั้นสูงของ Google ให้ทำตามวิธีการต่อไปนี้

  1. เปิดโครงการ Apps Script
  2. คลิกตัดต่อวิดีโอ ทางด้านซ้าย
  3. คลิกเพิ่มบริการทางด้านซ้ายข้างบริการ
  4. เลือกบริการขั้นสูงของ Google แล้วคลิกเพิ่ม

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

วิธีระบุลายเซ็นวิธีการ

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

คำขอไปยัง Google APIs สามารถรับข้อมูลได้ หลายประเภท รวมถึงพารามิเตอร์เส้นทาง พารามิเตอร์การค้นหา เนื้อหาคำขอ และ/หรือสื่อ อัปโหลดไฟล์แนบ บริการขั้นสูงบางประเภทสามารถยอมรับคำขอ HTTP ที่เฉพาะเจาะจงได้ (ตัวอย่างเช่น บริการขั้นสูงของปฏิทิน)

ลายเซ็นเมธอดที่สอดคล้องกันใน Google Apps Script จะมีสิ่งต่อไปนี้ อาร์กิวเมนต์:

  1. เนื้อหาของคำขอ (มักจะเป็นทรัพยากร) เป็นออบเจ็กต์ JavaScript
  2. เส้นทางหรือพารามิเตอร์ที่จำเป็นเป็นอาร์กิวเมนต์แต่ละรายการ
  3. ไฟล์แนบที่อัปโหลดสื่อในรูปแบบ Blob อาร์กิวเมนต์
  4. พารามิเตอร์ที่ไม่บังคับ เป็นชื่อพารามิเตอร์การแมปออบเจ็กต์ JavaScript
  5. ส่วนหัวคำขอ HTTP เป็นชื่อส่วนหัวการแมปออบเจ็กต์ JavaScript กับส่วนหัว

หากเมธอดไม่มีรายการใดๆ ในหมวดหมู่ที่กำหนด ส่วนของ ละเว้นลายเซ็น

มีข้อยกเว้นพิเศษบางประการที่ควรทราบ ดังนี้

  • สำหรับเมธอดที่ยอมรับการอัปโหลดสื่อ ระบบจะตั้งค่าพารามิเตอร์ uploadType โดยอัตโนมัติ
  • เมธอดชื่อ delete ใน Google API จะมีชื่อว่า remove ใน Apps Script เนื่องจาก delete เป็นคำที่สงวนไว้ใน JavaScript
  • หากมีการกำหนดค่าบริการขั้นสูงให้ยอมรับส่วนหัวของคำขอ HTTP และคุณ ตั้งค่าอ็อบเจกต์ JavaScript ของส่วนหัวคำขอ คุณจะต้องตั้งค่าตัวเลือก พารามิเตอร์ JavaScript ของออบเจ็กต์ (ไปยังออบเจ็กต์ว่าง หากคุณไม่ได้ใช้ พารามิเตอร์ที่ไม่บังคับ)

การสนับสนุนสำหรับบริการขั้นสูง

บริการขั้นสูงเป็นเพียง Wrapper ขนาดเล็กที่ช่วยให้สามารถใช้ API ภายใน Apps Script ดังนั้น ปัญหาที่พบระหว่างการใช้งานคือ ปกติแล้วจะเป็นปัญหาเกี่ยวกับ API ที่สำคัญ ไม่ใช่กับ Apps Script

หากคุณประสบปัญหาขณะใช้บริการขั้นสูง รายงานโดยใช้คำแนะนำการสนับสนุนสำหรับ API ที่สำคัญ ลิงก์ไปยัง คำแนะนำในการสนับสนุนจะอยู่ในคู่มือบริการขั้นสูงแต่ละฉบับใน ส่วนข้อมูลอ้างอิงของ Apps Script