ย้ายข้อมูลแอป Google Chat

หากผสานรวมองค์กร Google Workspace คุณอาจต้องย้ายข้อมูลแอป Chat เพื่อให้แอปทำงานต่อไปได้

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

หลังจากพิจารณาแล้วว่าคุณต้องย้ายข้อมูลแอป Chat ให้ทำตามกระบวนการ 3 ขั้นตอนต่อไปนี้

  1. ตั้งค่าสภาพแวดล้อมสำหรับแอป Chat โดย สร้างโปรเจ็กต์ Google Cloud ในองค์กรที่ผสานรวม เปิดใช้ API และ อาจกำหนดค่าหน้าจอขอความยินยอม OAuth 2.0
  2. นำแอป Chat ไปใช้งานอีกครั้งจากโปรเจ็กต์ Cloud ใหม่
  3. เพิ่มแอป Chat ที่สร้างขึ้นใหม่ไปยังพื้นที่ทำงานหรือการสนทนาใน Chat แล้วปิดแอป Chat เดิม

สร้างโปรเจ็กต์ Cloud ในองค์กรที่ผสานรวมแล้วและเปิดใช้ API

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

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

คอนโซล Google Cloud

  1. ใน Google Cloud Console ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > สร้างโปรเจ็กต์

    ไปที่สร้างโปรเจ็กต์

  2. ในช่องชื่อโปรเจ็กต์ ให้ป้อนชื่อที่สื่อความหมายสำหรับโปรเจ็กต์

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

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

gcloud CLI

ในสภาพแวดล้อมการพัฒนาอย่างใดอย่างหนึ่งต่อไปนี้ ให้เข้าถึง Google Cloud CLI (gcloud)

  • Cloud Shell: หากต้องการใช้เทอร์มินัลออนไลน์ที่มีการตั้งค่า gcloud CLI ไว้แล้ว ให้เปิดใช้งาน Cloud Shell
    เปิดใช้งาน Cloud Shell
  • เชลล์ในเครื่อง: หากต้องการใช้สภาพแวดล้อมการพัฒนาในเครื่อง ให้ ติดตั้งและ เริ่มต้น gcloud CLI
    หากต้องการสร้างโปรเจ็กต์ Cloud ให้ใช้คำสั่ง gcloud projects create 
    gcloud projects create PROJECT_ID
     แทนที่ PROJECT_ID โดยตั้งรหัสสำหรับโปรเจ็กต์ที่ต้องการสร้าง

เปิดใช้ API

แอป Chat ทั้งหมดต้องเปิดใช้ Google Chat API คุณอาจต้องเปิดใช้ API อื่นๆ ทั้งนี้ขึ้นอยู่กับวิธีสร้างแอป Chat เช่น หากคุณสร้างแอป Chat โดยใช้ Google Cloud Functions ให้เปิดใช้ Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API และ Cloud Run API แนวทางปฏิบัติแนะนำคือให้เปิดใช้ API เดียวกันในโปรเจ็กต์ Cloud ใหม่ที่เปิดใช้ในโปรเจ็กต์ Cloud เก่าเพื่อให้แน่ใจว่าแอปที่ย้ายข้อมูลจะทำงานได้

หากต้องการเปิดใช้ API ให้ทำดังนี้

คอนโซล Google Cloud

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > ผลิตภัณฑ์เพิ่มเติม > Google Workspace > คลังผลิตภัณฑ์

    ไปที่คลังผลิตภัณฑ์

  2. คลิก API ที่ต้องการเปิด
  3. คลิกเปิดใช้
  4. หากต้องการเปิดใช้ API เพิ่มเติม ให้ทำตามขั้นตอนเหล่านี้ซ้ำ

Google Cloud CLI

  1. ติดตั้งหรือเปิดอินเทอร์เฟซบรรทัดคำสั่ง (CLI) ของ Google Cloud

  2. เรียกใช้คำสั่ง services enable โดยระบุบริการ API ที่จะเปิดใช้

    gcloud services enable API_SERVICE_ID

กำหนดค่า Chat API

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

คุณอาจต้องกำหนดค่าหน้าจอคำยินยอม OAuth สำหรับโปรเจ็กต์ Cloud หากก่อนหน้านี้คุณใช้ OAuth 2.0 สำหรับการให้สิทธิ์ ให้ใช้ขอบเขตการเข้าถึงสำหรับการให้สิทธิ์เดียวกัน

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > > การสร้างแบรนด์

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

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

  3. หากคุณสร้างแอปเพื่อใช้ภายนอกองค์กร Google Workspace ให้คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก เราขอแนะนำแนวทางปฏิบัติที่ดีที่สุดต่อไปนี้เมื่อ เลือกขอบเขต

    • เลือกขอบเขตที่ให้สิทธิ์เข้าถึงระดับต่ำสุดที่แอปของคุณต้องการ ดูรายการขอบเขตที่ใช้ได้ที่ขอบเขต OAuth 2.0 สำหรับ Google API
    • ตรวจสอบขอบเขตที่ระบุไว้ในแต่ละส่วนทั้ง 3 ส่วน ได้แก่ ขอบเขตที่ไม่มีความละเอียดอ่อน ขอบเขตที่มีความละเอียดอ่อน และขอบเขตที่จำกัด สำหรับขอบเขตที่ระบุไว้ในส่วน "ขอบเขตที่มีความละเอียดอ่อนของคุณ" หรือ "ขอบเขตที่ถูกจำกัดของคุณ" ให้ลองระบุขอบเขตอื่นที่ไม่มีความละเอียดอ่อนเพื่อหลีกเลี่ยงการตรวจสอบเพิ่มเติมที่ไม่จำเป็น
    • ขอบเขตบางอย่างต้องได้รับการตรวจสอบเพิ่มเติมจาก Google สำหรับแอปที่ใช้ภายในองค์กร Google Workspace เท่านั้น ขอบเขตจะไม่แสดงในหน้าจอขอความยินยอม และการใช้ขอบเขตที่จำกัดหรือมีความละเอียดอ่อนไม่จำเป็นต้องได้รับการตรวจสอบเพิ่มเติมจาก Google ดูข้อมูลเพิ่มเติมได้ที่ หมวดหมู่ขอบเขต
  4. หลังจากเลือกขอบเขตที่แอปของคุณต้องการแล้ว ให้คลิกบันทึก

ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าความยินยอม OAuth ได้ที่ เริ่มต้นใช้งาน

นำแอป Chat ไปใช้งานใหม่ในโปรเจ็กต์ Cloud ใหม่

การติดตั้งแอป Chat อีกครั้งจะแตกต่างกันเล็กน้อย ทั้งนี้ขึ้นอยู่กับว่าแอป Chat สร้างขึ้นด้วย Apps Script, AppSheet หรือการเชื่อมต่อประเภทอื่น เช่น Python หรือ Java ไม่ว่าในกรณีใด คุณไม่จำเป็นต้องสร้างโค้ดทั้งหมดใหม่ แต่คุณ ต้องทำการเปลี่ยนแปลงบางอย่าง

ย้ายข้อมูลตรรกะของแอป Chat

คุณอาจต้องย้ายข้อมูลบริการอื่นๆ ไปยังโปรเจ็กต์ Cloud ใหม่ ทั้งนี้ขึ้นอยู่กับสถาปัตยกรรมของแอป Chat

  • สำหรับแอป HTTP คุณจะต้องย้ายตรรกะของแอปที่เหลือซึ่งสร้างขึ้นโดยใช้ Cloud Functions, Cloud Run หรือ App Engine ด้วย
  • สำหรับแอป Chat แบบสนทนาที่ใช้ภาษาธรรมชาติ คุณ จะต้องย้ายข้อมูลเอเจนต์ Dialogflow ด้วย
  • สำหรับแอปใน Chat ที่สร้างขึ้นหลังไฟร์วอลล์ คุณจะต้องย้ายข้อมูลหัวข้อ Pub/Sub ด้วย

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

หากต้องการติดตั้งใช้งานแอป Chat ที่สร้างด้วยภาษา อย่าง Python หรือ Java อีกครั้ง ให้กำหนดค่าแอป Chat ในโปรเจ็กต์ Cloud ใหม่

หากต้องการกำหนดค่าฟีเจอร์แบบอินเทอร์แอกทีฟ โปรดดูรับและตอบสนองต่อการโต้ตอบของผู้ใช้

ติดตั้งใช้งานแอป Chat ของ Apps Script อีกครั้ง

หากต้องการนำแอป Chat ที่สร้างด้วย Apps Script ไปใช้งานอีกครั้ง ให้เปลี่ยนหมายเลขโปรเจ็กต์ Cloud ที่ เชื่อมโยงกับโปรเจ็กต์ Apps Script เป็นหมายเลขโปรเจ็กต์ที่ เป็นของโปรเจ็กต์ Cloud ใหม่ จากนั้นคัดลอกรหัสการติดตั้งใช้งาน Apps Script แล้ววางลงในหน้าการกำหนดค่าแอป Chat ใน Google Cloud Console

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

  1. ใน Google Cloud Console ให้ไปที่เมนู > IAM & Admin > การตั้งค่า

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

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

ตั้งค่าหมายเลขโปรเจ็กต์ Google Cloud ในโปรเจ็กต์ Apps Script

  1. ไปที่ Apps Script

    ไปที่ Apps Script

  2. ในโปรเจ็กต์ Apps Script ของแอป Chat ให้ คลิกการตั้งค่าโปรเจ็กต์

  3. ในส่วนโปรเจ็กต์ Google Cloud Platform (GCP) ให้คลิกเปลี่ยนโปรเจ็กต์

  4. ในหมายเลขโปรเจ็กต์ GCP ให้วางหมายเลขโปรเจ็กต์ Google Cloud

  5. คลิกตั้งค่าโปรเจ็กต์

คัดลอกรหัสการทำให้ใช้งานได้ของโปรเจ็กต์ Apps Script

  1. ที่ด้านขวาบนของ Apps Script ให้คลิก Deploy > Manage deployments
  2. คลิกคัดลอกในส่วนรหัสการติดตั้งใช้งาน
  3. คลิกเสร็จสิ้น

กำหนดค่าและทำให้แอป Chat ใช้งานได้อีกครั้ง

  1. ในคอนโซล Google Cloud ให้ค้นหา "Google Chat API" แล้วคลิก Google Chat API จากนั้นคลิกจัดการ

    ไปที่ Chat API

  2. คลิกแท็บการกำหนดค่า แล้วป้อนข้อมูลที่จำเป็นต่อไปนี้

    • ชื่อแอป: ชื่อที่ผู้ใช้ใช้เมื่อโต้ตอบกับแอป Chat ของคุณ
    • URL ของรูปโปรไฟล์: URL แบบ HTTPS ที่ชี้ไปยังรูปภาพกราฟิกสี่เหลี่ยม (เช่น PNG หรือ JPEG) ขนาดอย่างน้อย 128x128 ซึ่งจะปรากฏเป็น รูปโปรไฟล์สำหรับแอป Chat
    • คำอธิบาย: คำอธิบายเกี่ยวกับ วัตถุประสงค์ของแอป Chat ซึ่งจะปรากฏ ใต้ชื่อแอป Chat

  3. หากต้องการเปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ ให้คลิกปุ่มเปิด/ปิดเปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ ที่ช่วยให้ผู้ใช้โต้ตอบกับแอป Chat ของคุณได้

  4. ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือกโปรเจ็กต์ Apps Script

  5. ในช่องรหัสการติดตั้งใช้งาน ให้วางรหัสการติดตั้งใช้งานที่คุณคัดลอกไว้ก่อนหน้านี้

  6. หากต้องการกำหนดค่าส่วนที่เหลือให้เสร็จสมบูรณ์ โปรดดูตารางในส่วนกำหนดค่าแอป Chat ในโปรเจ็กต์ Cloud ใหม่

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

ติดตั้งใช้งานแอป AppSheet ใน Chat อีกครั้ง

หากต้องการนำแอป Chat ที่สร้างด้วย AppSheet ในโปรเจ็กต์ Cloud ใหม่ไปใช้งานอีกครั้ง ให้คัดลอกแอปไปยังโปรเจ็กต์ Cloud ใหม่

อัปเดตบัญชีบริการ

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

แชร์แอป Chat

ก่อนที่แอป Chat จะพร้อมใช้งานสำหรับผู้ใช้ในองค์กรใหม่ ผู้ดูแลระบบอาจต้องอนุญาตให้เข้าถึงแอป Chat ด้วยตนเอง โปรดดูข้อมูลเพิ่มเติมที่กำหนดค่าการเข้าถึงสำหรับองค์กร Google Workspace ในเอกสารประกอบของ Google Workspace Marketplace

เปลี่ยนไปใช้แอป Chat ใหม่

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

เพิ่มแอป Chat ใหม่ไปยังพื้นที่ใน Chat

  1. ไปที่ Chat

    ไปที่ Chat

  2. คลิกข้อความส่วนตัวหรือพื้นที่ทำงาน

  3. คลิกเมนูแบบเลื่อนลงข้างชื่อพื้นที่ทำงานหรือบุคคล แล้วเลือกแอปและการผสานรวม

  4. คลิกเพิ่มแอป

  5. ป้อนชื่อแอป เลือกแอปจากรายการ แล้วคลิกเพิ่ม

  6. ทำขั้นตอนเหล่านี้ซ้ำสำหรับทุกพื้นที่ทำงานหรือข้อความส่วนตัวที่ต้องการเพิ่มแอป Chat

นำแอป Chat เวอร์ชันเก่าออกจากพื้นที่ใน Chat

  1. ไปที่ Chat

    ไปที่ Chat

  2. คลิกข้อความส่วนตัวหรือพื้นที่ทำงาน

  3. คลิกเมนูแบบเลื่อนลงข้างชื่อพื้นที่ทำงานหรือบุคคล แล้วเลือกแอปและการผสานรวม

  4. คลิกตัวเลือกเพิ่มเติม ข้างแอป Chat เวอร์ชันเก่าที่ยังไม่ได้ย้ายข้อมูล แล้วคลิกนำออกจากพื้นที่ทำงาน

  5. ทำตามขั้นตอนเหล่านี้ซ้ำสำหรับทุกพื้นที่หรือข้อความส่วนตัวที่คุณต้องการนำแอป Chat เวอร์ชันเก่าออก

ปิดแอป Chat เวอร์ชันเก่า

หากไม่ต้องการให้ผู้ใช้ใช้แอป Chat เวอร์ชันเก่า และต้องการให้ผู้ใช้ใช้แอป Chat เวอร์ชันใหม่ ให้ปิดแอป Chat เวอร์ชันเก่าและยกเลิกการเผยแพร่แอปจาก Google Workspace Marketplace