ย้ายข้อมูลแอป 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 ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > สร้างโปรเจ็กต์

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

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

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

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

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 เดียวกันในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใหม่กับที่เปิดใช้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์เดิม เพื่อให้แอปที่ย้ายข้อมูลแล้วทํางานได้

หากต้องการเปิดใช้ 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

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

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

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

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

  2. หากกําหนดค่า แล้ว คุณจะกําหนดการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความว่า not configured yet ให้คลิกเริ่มต้นใช้งาน
    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 อีกครั้งในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใหม่

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

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

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

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

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

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

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

ปรับใช้แอป Chat ที่ใช้ Apps Script อีกครั้ง

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

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

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

    ไปที่การตั้งค่า 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 ให้คลิกทำให้ใช้งานได้ > จัดการการใช้งาน
  2. คลิกคัดลอกในส่วนรหัสการนําส่ง
  3. คลิกเสร็จสิ้น

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

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

    ไปที่ Chat API

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

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

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

  5. ในช่อง Deployment ID ให้วางรหัสการนําไปใช้ที่คัดลอกไว้ก่อนหน้านี้

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

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

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

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

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

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

แชร์แอป Chat

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

เปลี่ยนไปใช้แอป 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