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

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

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

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

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

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

การสร้างโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใหม่และการเปิดใช้ 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: หากต้องการใช้สภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในเครื่อง ติดตั้ง และ เริ่มต้น gcloud CLI
    หากต้องการสร้างโปรเจ็กต์ที่อยู่ในระบบคลาวด์ ให้ใช้คำสั่ง 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 ให้ไปที่เมนู > API และบริการ > ไลบรารี > Google Workspace

    ไปที่ไลบรารี API

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

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

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

  2. หากกำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google ไว้แล้ว คุณสามารถกำหนดค่าการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ใน การสร้างแบรนด์, กลุ่มเป้าหมาย และ การเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่า Google Auth platform 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 ได้ที่ หัวข้อเริ่มต้นใช้งานแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google

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

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

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

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

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

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

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

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

ทำให้แอป Chat ที่สร้างขึ้นด้วย Apps Script ใช้งานได้อีกครั้ง

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

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

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

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

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

ตั้งค่าหมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ในโปรเจ็กต์ 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 API ให้ค้นหา "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 ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใหม่

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

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

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

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

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

แชร์แอป Chat

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

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