ย้ายข้อมูลแอป 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 ใช้งานได้อีกครั้งจากโปรเจ็กต์ใหม่ที่อยู่ในระบบคลาวด์
  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
  • Local Shell: หากต้องการใช้สภาพแวดล้อมการพัฒนาภายใน ให้ติดตั้งและinitialize gcloud CLI
    หากต้องการสร้างโปรเจ็กต์ Cloud ให้ใช้คำสั่ง `gcloud project 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. ติดตั้งหรือเปิด Command Line Line Interface (CLI) ของ Google Cloud

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

    gcloud services enable API_SERVICE_ID

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

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > หน้าจอขอความยินยอม OAuth

    ไปที่หน้าจอขอความยินยอม OAuth

  2. เลือกประเภทผู้ใช้ของแอป แล้วคลิกสร้าง
  3. กรอกแบบฟอร์มการลงทะเบียนแอปให้เสร็จสมบูรณ์ แล้วคลิกบันทึกและดำเนินการต่อ

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

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

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

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

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

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

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

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

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

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

    ไปที่ Chat API

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

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

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

    ฟิลด์ คำอธิบาย
    ฟังก์ชันการทำงาน ชุดช่องที่กำหนดวิธีที่แอปใน Chat จะโต้ตอบกับผู้ใช้ได้มีดังนี้
    • รับข้อความแบบ 1:1: ผู้ใช้จะค้นหาและส่งข้อความถึงแอป Chat ได้โดยตรงใน Google Chat
    • เข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม: ผู้ใช้จะเพิ่มแอป Chat ในพื้นที่ทำงานและการสนทนากลุ่มได้
    การตั้งค่าการเชื่อมต่อ ปลายทางสําหรับแอป Chat ได้แก่ข้อใดข้อหนึ่งต่อไปนี้
    • URL ของแอป: ปลายทาง HTTPS ที่โฮสต์การใช้งานแอป Chat
    • โปรเจ็กต์ Apps Script: รหัสการทำให้ใช้งานได้สำหรับโปรเจ็กต์ Apps Script ที่ใช้งานแอป Chat
    • ชื่อหัวข้อ Cloud Pub/Sub: หัวข้อ Pub/Sub ที่แอป Chat สมัครใช้บริการเป็นปลายทาง
    • Dialogflow: ลงทะเบียนแอป Chat ด้วยการผสานรวม Dialogflow โปรดดูข้อมูลเพิ่มเติมที่หัวข้อสร้างแอป Google Chat ใน Dialogflow ที่เข้าใจภาษาธรรมชาติ
    คำสั่งเครื่องหมายทับ คำสั่งที่ผู้ใช้จะเห็นภายใน Google Chat ได้ อนุญาตให้ผู้ใช้ดูการดําเนินการหลักสําหรับแอป Chat ภายใน Google Chat และเลือกการดําเนินการที่ต้องการโต้ตอบได้ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อตอบกลับคําสั่งเครื่องหมายทับในรูปแบบแอป Chat
    ตัวอย่างลิงก์ รูปแบบ URL ที่แอป Chat จดจำและแสดงเนื้อหาเพิ่มเติมเมื่อผู้ใช้ส่งลิงก์ ดูข้อมูลเพิ่มเติมได้ที่แสดงตัวอย่างลิงก์
    ระดับการแชร์ ผู้ใช้สูงสุด 5 คนหรืออย่างน้อย 1 กลุ่มใน Google Groups ที่ดูและติดตั้งแอป Chat ได้ ใช้ช่องนี้เพื่อทดสอบแอป Chat หรือแชร์แอป Chat กับทีม โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการตั้งค่าระดับการเข้าถึงและการเผยแพร่สำหรับแอป Chat

  4. หากต้องการบันทึกข้อผิดพลาดไปยัง Cloud Logging ทุกครั้งที่แอป Chat แสดงข้อผิดพลาด ให้เลือกช่องทำเครื่องหมายบันทึกข้อผิดพลาดไปยัง Logging ดูข้อมูลเพิ่มเติมได้ที่บันทึกข้อผิดพลาดเกี่ยวกับการค้นหาสำหรับแอป Chat

  5. คลิกบันทึก เมื่อคุณบันทึกการกำหนดค่าแอป Chat ผู้ใช้ที่ระบุในองค์กร Google Workspace จะใช้แอป 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. วางหมายเลขโปรเจ็กต์ Google Cloud ในหมายเลขโปรเจ็กต์ GCP

  5. คลิกตั้งค่าโครงการ

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

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

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

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

    ไปที่ Chat API

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

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

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

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

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

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

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

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

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

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

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