เริ่มต้นใช้งาน Google Apps Script

สร้าง Google Apps Script ที่ส่งคำขอไปยัง Google Chat API

การเริ่มต้นอย่างรวดเร็วจะอธิบายวิธีตั้งค่าและเรียกใช้แอปที่เรียกใช้ Google Workspace API คู่มือเริ่มต้นฉบับย่อนี้ใช้วิธีการตรวจสอบสิทธิ์แบบ ง่ายที่เหมาะกับสภาพแวดล้อมการทดสอบ สําหรับสภาพแวดล้อมการใช้งานจริง เราขอแนะนําให้ศึกษาเกี่ยวกับ การตรวจสอบสิทธิ์และการให้สิทธิ์ ก่อน เลือกข้อมูลเข้าถึง ที่เหมาะสมกับแอปของคุณ

ใน Apps Script สตาร์ทเตอร์ด่วนของ Google Workspace จะใช้บริการขั้นสูงของ Google เพื่อเรียกใช้ Google Workspace API และจัดการรายละเอียดบางอย่างของขั้นตอนการตรวจสอบสิทธิ์ และการให้สิทธิ์

วัตถุประสงค์

• กำหนดค่าสภาพแวดล้อม
• สร้างและกำหนดค่าสคริปต์
• เรียกใช้สคริปต์

ข้อกำหนดเบื้องต้น

• โปรเจ็กต์ Google Cloud

• บัญชี Google Workspace สำหรับธุรกิจหรือองค์กรที่มีสิทธิ์เข้าถึง Google Chat

กำหนดค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์

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

เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ในคอนโซล Google Cloud

หากยังไม่ได้เปิด ให้เปิดโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่คุณต้องการใช้ สำหรับตัวอย่างนี้

1. ไปที่หน้าเลือกโปรเจ็กต์ในคอนโซล Google Cloud

   เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์

2. เลือกโปรเจ็กต์ Google Cloud ที่ต้องการใช้ หรือคลิกสร้างโปรเจ็กต์ แล้วทำตามวิธีการบนหน้าจอ หากสร้างโปรเจ็กต์ Google Cloud คุณอาจต้องเปิดการเรียกเก็บเงินสำหรับโปรเจ็กต์

เปิดใช้ Chat API

• เปิดใช้ Google Chat API ในคอนโซล Google Cloud

  เปิดใช้ API

กำหนดค่าหน้าจอขอความยินยอม OAuth

1. ใน Google API Console ให้ไปที่เมนู menu > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > การสร้างแบรนด์

   ไปที่การสร้างแบรนด์

2. หากกำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google แล้ว คุณจะกำหนดค่าการตั้งค่าหน้าจอขอคำยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่ายังไม่ได้กำหนดค่าแพลตฟอร์ม Google Auth ให้คลิกเริ่มต้นใช้งาน
1. ในส่วนข้อมูลแอป ให้ป้อนชื่อแอปในชื่อแอป
2. ในอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลสนับสนุนที่ผู้ใช้สามารถติดต่อคุณได้หากมีข้อสงสัยเกี่ยวกับการยินยอม
3. คลิกถัดไป
4. ในส่วนกลุ่มเป้าหมาย ให้เลือกภายใน
5. คลิกถัดไป
6. ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณต้องการรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์
7. คลิกถัดไป
8. ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้ของบริการ Google API และหากยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
9. คลิกต่อไป
10. คลิกสร้าง
3. ในตอนนี้ คุณข้ามการเพิ่มขอบเขตได้ ในอนาคต เมื่อสร้างแอปเพื่อใช้ภายนอกองค์กร Google Workspace คุณจะต้องเปลี่ยนประเภทผู้ใช้เป็นภายนอก จากนั้น เพิ่มขอบเขตการให้สิทธิ์ที่แอปของคุณต้องการ ดูข้อมูลเพิ่มเติมได้ที่คู่มือกำหนดค่าความยินยอม OAuth ฉบับเต็ม

กำหนดค่าแอป Google Chat

หากต้องการเรียกใช้ Google Chat API คุณต้องกำหนดค่า แอป Google Chat สำหรับคำขอเขียนทั้งหมด Google Chat จะระบุแอป Google Chat ใน UI โดยใช้ ข้อมูลต่อไปนี้

1. ในคอนโซล Google API ให้ไปที่หน้าการกำหนดค่าของ Chat API โดยทำดังนี้

   ไปที่หน้าการกำหนดค่า Chat API

2. ในส่วนข้อมูลแอปพลิเคชัน ให้ป้อนข้อมูลต่อไปนี้

   1. ในช่องชื่อแอป ให้ป้อน Chat API quickstart app
   2. ในช่อง URL อวตาร ให้ป้อน https://developers.google.com/chat/images/quickstart-app-avatar.png
   3. ในช่องคำอธิบาย ให้ป้อน Quickstart for calling the Chat API

3. ในส่วนฟีเจอร์แบบอินเทอร์แอกทีฟ ให้คลิกปุ่มเปิด/ปิดเปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ เพื่อปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับ แอป Chat

4. คลิกบันทึก

สร้างสคริปต์

1. สร้างสคริปต์ใหม่ในเครื่องมือแก้ไขสคริปต์ Apps Script โดยไปที่ script.google.com/create
2. แทนที่เนื้อหาของเครื่องมือแก้ไขสคริปต์ด้วยโค้ดต่อไปนี้

/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken,
    });
    // Handle response pages
    if (responsePage.spaces) {
      for (const space of responsePage.spaces) {
        console.log(space);
      }
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

3. คลิกบันทึก
4. คลิกโปรเจ็กต์ที่ไม่มีชื่อ พิมพ์ Quickstart แล้วคลิกเปลี่ยนชื่อ

กำหนดค่าสคริปต์

คัดลอกหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์

1. ใน คอนโซล Google API ให้ไปที่เมนู menu > IAM และผู้ดูแลระบบ > การตั้งค่า

   ไปที่การตั้งค่า IAM และผู้ดูแลระบบ

2. คัดลอกค่าในช่องหมายเลขโปรเจ็กต์

ลิงก์โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

1. เปิดโปรเจ็กต์ Apps Script
2. คลิกการตั้งค่าโปรเจ็กต์ settings
3. ในส่วนโปรเจ็กต์ Google Cloud Platform (GCP) ให้คลิกเปลี่ยนโปรเจ็กต์
4. ในหมายเลขโปรเจ็กต์ GCP ให้วางหมายเลขโปรเจ็กต์ Google Cloud
5. คลิกตั้งค่าโปรเจ็กต์

เปิดใช้ Google Chat API

เปิดโปรเจ็กต์ Apps Script

1. คลิกการตั้งค่าโปรเจ็กต์ settings
2. ในส่วนการตั้งค่าทั่วไป ให้เปิดใช้แสดงไฟล์ Manifest "appsscript.json" ในเครื่องมือแก้ไข
3. คลิกเอดิเตอร์ code เลือกไฟล์ appscript.json แล้วแทนที่เนื้อหาด้วยโค้ดต่อไปนี้

{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": ["https://www.googleapis.com/auth/chat.spaces.readonly"],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [
      {
        "userSymbol": "Chat",
        "version": "v1",
        "serviceId": "chat"
      }
    ]
  }
}

เรียกใช้ตัวอย่าง

ในเครื่องมือแก้ไขสคริปต์ของ Apps Script ให้คลิกเรียกใช้

เมื่อเรียกใช้ตัวอย่างเป็นครั้งแรก ระบบจะแจ้งให้คุณให้สิทธิ์เข้าถึง

1. คลิกตรวจสอบสิทธิ์
2. เลือกบัญชี
3. คลิกอนุญาต

บันทึกการดำเนินการของสคริปต์จะปรากฏที่ด้านล่างของหน้าต่าง

ขั้นตอนถัดไป

• เอกสารประกอบของบริการขั้นสูงของ Google Apps Script
• ลองใช้ Google Workspace API ในโปรแกรมสำรวจ API