Di chuyển ứng dụng Google Chat

Nếu hợp nhất các tổ chức Google Workspace, bạn có thể cần di chuyển ứng dụng Chat để ứng dụng này tiếp tục hoạt động.

Trước khi di chuyển ứng dụng Chat, hãy hỏi ý kiến quản trị viên của tổ chức để xem các chế độ cài đặt quản trị có ảnh hưởng đến ứng dụng này hay không. Việc thay đổi chế độ cài đặt quản trị có thể khôi phục toàn bộ chức năng cho ứng dụng Chat và khiến bạn không cần di chuyển. Ví dụ: quản trị viên Google Workspace có thể phải thêm ứng dụng Chat vào danh sách cho phép hoặc có thể phải cho phép người dùng cài đặt ứng dụng Chat. Để biết thêm thông tin, hãy xem bài viết Xác định xem có cần di chuyển ứng dụng Google Chat sau khi hợp nhất các tổ chức Google Workspace hay không.

Sau khi bạn xác định rằng mình cần di chuyển ứng dụng Chat, hãy hoàn tất quy trình gồm 3 bước sau:

  1. Thiết lập môi trường cho ứng dụng Chat bằng cách tạo một dự án Google Cloud trong tổ chức đã hợp nhất, bật API và có thể định cấu hình màn hình xin phép OAuth 2.0.
  2. Triển khai lại ứng dụng Chat từ dự án Cloud mới.
  3. Thêm ứng dụng Chat đã tạo lại vào các không gian hoặc cuộc trò chuyện trong Chat và tắt ứng dụng Chat ban đầu.

Tạo dự án trên Cloud trong tổ chức đã hợp nhất và bật API

Việc tạo một dự án Cloud mới và bật API cho ứng dụng Chat trong tổ chức Google Workspace đã hợp nhất sẽ đảm bảo rằng người dùng và nhóm mà bạn cho phép truy cập vào ứng dụng Chat có thể truy cập mà không gặp lỗi.

Tạo dự án trên Cloud

Bảng điều khiển Google CloudGiao diện dòng lệnh gcloud
  1. Trong Google Cloud Console, hãy chuyển đến Trình đơn > Quản trị viên và IAM > Tạo dự án.

    Chuyển đến phần Tạo dự án

  2. Trong trường Project Name (Tên dự án), hãy nhập tên mô tả cho dự án của bạn.

    Không bắt buộc: Để chỉnh sửa Mã dự án, hãy nhấp vào Chỉnh sửa. Bạn không thể thay đổi mã dự án sau khi tạo dự án, vì vậy, hãy chọn một mã đáp ứng nhu cầu của bạn trong suốt thời gian hoạt động của dự án.

  3. Trong trường Vị trí, hãy nhấp vào Duyệt xem để hiển thị các vị trí tiềm năng cho dự án của bạn. Sau đó, hãy nhấp vào Chọn.
  4. Nhấp vào Tạo. Google Cloud Console sẽ chuyển đến trang Trang tổng quan và dự án của bạn sẽ được tạo trong vòng vài phút.

Trong một trong các môi trường phát triển sau, hãy truy cập vào Google Cloud CLI (gcloud):

  • Cloud Shell: Để sử dụng một thiết bị đầu cuối trực tuyến đã thiết lập gcloud CLI, hãy kích hoạt Cloud Shell.
    Kích hoạt Cloud Shell
  • Shell cục bộ: Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi chạy CLI gcloud.
    Để tạo dự án trên Cloud, hãy sử dụng lệnh gcloud projects create: 
    gcloud projects create PROJECT_ID
     Thay thế PROJECT_ID bằng cách đặt mã nhận dạng cho dự án bạn muốn tạo.

Bật API

Tất cả ứng dụng Chat đều phải bật API Google Chat. Tuỳ thuộc vào cách xây dựng ứng dụng Chat, bạn có thể cần bật các API khác. Ví dụ: nếu bạn tạo ứng dụng Chat bằng Google Cloud Functions, hãy bật API Cloud Build, API Cloud Functions, API Pub/Sub, API Cloud Logging, API Artifact Registry và API Cloud Run. Tốt nhất là để đảm bảo ứng dụng đã di chuyển hoạt động, hãy bật các API tương tự trong dự án Cloud mới như đã bật trong dự án Cloud cũ.

Để bật API, hãy làm như sau:

Bảng điều khiển Google CloudGoogle Cloud CLI
  1. Trong Google Cloud Console, hãy chuyển đến Trình đơn > Các sản phẩm khác > Google Workspace > Thư viện sản phẩm.

    Chuyển đến Thư viện sản phẩm

  2. Nhấp vào API bạn muốn bật.
  3. Nhấp vào Bật.
  4. Để bật thêm API, hãy lặp lại các bước này.
  1. Cài đặt hoặc mở Giao diện dòng lệnh (CLI) của Google Cloud.

  2. Chạy lệnh services enable, chỉ định dịch vụ API cần bật.

    gcloud services enable API_SERVICE_ID

Định cấu hình API Chat

Trong dự án Cloud mới, bạn phải sử dụng Chat API để chỉ định tên, nội dung mô tả và biểu tượng của ứng dụng Chat. Để định cấu hình các thông tin chi tiết này, hãy xem phần Định cấu hình API Chat

Có thể bạn cần phải định cấu hình màn hình đồng ý OAuth cho dự án trên Google Cloud. Nếu trước đây bạn đã sử dụng OAuth 2.0 để uỷ quyền, hãy sử dụng cùng một phạm vi uỷ quyền truy cập.

  1. Trong Google Cloud Console, hãy chuyển đến Trình đơn > > Tạo thương hiệu.

    Chuyển đến phần Thương hiệu

  2. Nếu đã định cấu hình , bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình đồng ý OAuth trong phần Gắn thương hiệu, Đối tượng và Quyền truy cập dữ liệu. Nếu bạn thấy thông báo chưa được định cấu hình, hãy nhấp vào Bắt đầu:
    1. Trong mục Thông tin ứng dụng, trong phần Tên ứng dụng, hãy nhập Tên ứng dụng.
    2. Trong phần Email hỗ trợ người dùng, hãy chọn địa chỉ email hỗ trợ mà người dùng có thể liên hệ với bạn nếu họ có câu hỏi về sự đồng ý của họ.
    3. Nhấp vào Tiếp theo.
    4. Trong phần Đối tượng, hãy chọn loại người dùng cho ứng dụng của bạn.
    5. Nhấp vào Tiếp theo.
    6. Trong phần Thông tin liên hệ, hãy nhập Địa chỉ email để bạn có thể nhận thông báo về mọi thay đổi đối với dự án của mình.
    7. Nhấp vào Tiếp theo.
    8. Trong phần Hoàn tất, hãy xem lại Chính sách dữ liệu người dùng của Dịch vụ API của Google. Nếu bạn đồng ý, hãy chọn Tôi đồng ý với Chính sách dữ liệu người dùng của Dịch vụ API của Google.
    9. Nhấp vào Tiếp tục.
    10. Nhấp vào Tạo.
    11. Nếu bạn đã chọn Bên ngoài cho loại người dùng, hãy thêm người dùng thử nghiệm:
      1. Nhấp vào Đối tượng.
      2. Trong phần Người dùng thử nghiệm, hãy nhấp vào Thêm người dùng.
      3. Nhập địa chỉ email của bạn và mọi người dùng thử nghiệm được uỷ quyền khác, sau đó nhấp vào Lưu.

  3. Nếu bạn đang tạo một ứng dụng để sử dụng bên ngoài tổ chức Google Workspace, hãy nhấp vào Quyền truy cập dữ liệu > Thêm hoặc xoá phạm vi. Bạn nên áp dụng các phương pháp hay nhất sau đây khi chọn phạm vi:

    • Chọn các phạm vi cung cấp cấp truy cập tối thiểu mà ứng dụng của bạn yêu cầu. Để biết danh sách các phạm vi hiện có, hãy xem phần Phạm vi OAuth 2.0 cho các API của Google.
    • Xem xét các phạm vi được liệt kê trong mỗi phần trong số 3 phần: phạm vi không nhạy cảm, phạm vi nhạy cảm và phạm vi bị hạn chế. Đối với mọi phạm vi được liệt kê trong mục "Phạm vi nhạy cảm của bạn" hoặc "Phạm vi bị hạn chế của bạn", hãy cố gắng xác định các phạm vi không nhạy cảm thay thế để tránh phải xem xét thêm không cần thiết.
    • Một số phạm vi cần Google xem xét thêm. Đối với các ứng dụng chỉ do tổ chức Google Workspace của bạn sử dụng nội bộ, các phạm vi sẽ không được liệt kê trên màn hình yêu cầu đồng ý và việc sử dụng các phạm vi bị hạn chế hoặc nhạy cảm sẽ không yêu cầu Google xem xét thêm. Để biết thêm thông tin, hãy xem phần Danh mục phạm vi.
  4. Sau khi chọn các phạm vi mà ứng dụng của bạn yêu cầu, hãy nhấp vào Lưu.

Để biết thêm thông tin về cách định cấu hình sự đồng ý OAuth, hãy xem phần Bắt đầu sử dụng .

Triển khai lại ứng dụng Chat cho dự án Cloud mới

Tuỳ thuộc vào việc ứng dụng Chat của bạn được tạo bằng Apps Script, AppSheet hay một loại kết nối khác, chẳng hạn như Python hoặc Java, việc triển khai lại ứng dụng Chat sẽ có một chút khác biệt. Trong cả hai trường hợp, bạn không cần tạo lại toàn bộ mã, nhưng bạn cần thực hiện một số thay đổi.

Di chuyển logic ứng dụng Chat

Tuỳ thuộc vào cấu trúc của ứng dụng Chat, bạn có thể cần di chuyển các dịch vụ khác sang dự án trên Google Cloud mới:

  • Đối với các ứng dụng HTTP, bạn cũng cần di chuyển phần còn lại của logic ứng dụng được tạo bằng Cloud Functions, Cloud Run hoặc App Engine.
  • Đối với các ứng dụng Chat trò chuyện sử dụng ngôn ngữ tự nhiên, bạn cũng cần di chuyển các tác nhân Dialogflow.
  • Đối với các ứng dụng Chat được xây dựng sau tường lửa, bạn cũng cần di chuyển các chủ đề Pub/Sub.

Định cấu hình các tính năng tương tác trong dự án mới trên đám mây

Để triển khai lại ứng dụng Chat được tạo bằng một ngôn ngữ như Python hoặc Java, hãy định cấu hình ứng dụng Chat trong dự án Cloud mới.

Để định cấu hình các tính năng tương tác, hãy xem phần Nhận và phản hồi các lượt tương tác của người dùng.

Triển khai lại ứng dụng Chat bằng Apps Script

Để triển khai lại ứng dụng Chat được tạo bằng Apps Script, hãy thay đổi số dự án trên Google Cloud mà dự án Apps Script liên kết với thành số dự án thuộc về dự án Google Cloud mới của bạn. Sau đó, hãy sao chép mã triển khai Apps Script rồi dán vào trang cấu hình ứng dụng Chat trong Google Cloud Console.

Sao chép số dự án trên Cloud

  1. Trong Google Cloud Console, hãy chuyển đến Trình đơn > IAM & Admin (Quản trị viên và quản lý quyền truy cập) > Settings (Cài đặt).

    Chuyển đến phần IAM và Cài đặt quản trị

  2. Trong trường Mã dự án, hãy sao chép giá trị.

Đặt số dự án trên Google Cloud trong dự án Apps Script

  1. Chuyển đến Apps Script.

    Chuyển đến Apps Script

  2. Trong dự án Chat Apps Script, hãy nhấp vào Project Settings (Cài đặt dự án) .

  3. Trong phần Dự án trên Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.

  4. Trong mục Số dự án GCP, hãy dán số dự án trên Google Cloud.

  5. Nhấp vào Đặt dự án.

Sao chép mã nhận dạng bản triển khai của dự án Apps Script

  1. Ở trên cùng bên phải của Apps Script, hãy nhấp vào Triển khai > Quản lý lượt triển khai.
  2. Trong mục Mã triển khai, hãy nhấp vào Sao chép.
  3. Nhấp vào Xong.

Định cấu hình lại và triển khai lại ứng dụng Chat

  1. Trong Google Cloud Console, hãy tìm "Google Chat API" rồi nhấp vào Google Chat API, sau đó nhấp vào Quản lý.

    Chuyển đến Chat API

  2. Nhấp vào thẻ Cấu hình rồi nhập các thông tin bắt buộc sau:

    • Tên ứng dụng: Tên mà mọi người sử dụng khi tương tác với ứng dụng Chat của bạn.
    • URL hình đại diện: URL loại HTTPS trỏ đến một hình ảnh đồ hoạ hình vuông (ví dụ: PNG hoặc JPEG), có kích thước tối thiểu là 128x128, xuất hiện dưới dạng hình đại diện cho ứng dụng Chat.
    • Mô tả: Nội dung mô tả mục đích sử dụng của ứng dụng Chat sẽ xuất hiện bên dưới tên ứng dụng Chat.

  3. Để bật các tính năng tương tác, hãy nhấp vào nút bật/tắt Bật tính năng tương tác để cho phép người dùng tương tác với ứng dụng Chat:

  4. Trong phần Cài đặt kết nối, hãy chọn Dự án Apps Script.

  5. Trong trường Mã triển khai, hãy dán mã triển khai mà bạn đã sao chép trước đó.

  6. Để hoàn tất phần cấu hình còn lại, hãy xem bảng trong phần Định cấu hình ứng dụng Chat trong dự án Cloud mới

  7. Nhấp vào Lưu.

Triển khai lại ứng dụng Chat của AppSheet

Để triển khai lại ứng dụng Chat được tạo bằng AppSheet trong dự án Cloud mới, hãy sao chép ứng dụng đó vào dự án Cloud mới.

Cập nhật tài khoản dịch vụ

Nếu ứng dụng Chat xác thực dưới dạng ứng dụng và sử dụng tài khoản dịch vụ để thực hiện lệnh gọi đến API của Google, hãy cập nhật thông tin chi tiết về tài khoản dịch vụ của ứng dụng Chat. Để biết thêm thông tin, hãy xem phần Xác thực dưới dạng ứng dụng Chat.

Chia sẻ ứng dụng Chat

Trước khi người dùng trong tổ chức mới có thể sử dụng ứng dụng Chat, quản trị viên có thể phải cấp quyền truy cập vào ứng dụng Chat theo cách thủ công. Để biết thêm thông tin, hãy tham khảo bài viết Cách quản trị viên Google Workspace cài đặt ứng dụng Chat.

Chuyển sang ứng dụng Chat mới

Giờ đây, khi ứng dụng Chat đã được di chuyển sang tổ chức mới, đã đến lúc công bố ứng dụng đó. Thêm bot vào các không gian Chat hoặc tin nhắn trực tiếp, sau đó xoá ứng dụng Chat cũ khỏi các không gian hoặc tin nhắn đó để mọi người chỉ nhắn tin qua ứng dụng Chat đã di chuyển.

Thêm ứng dụng Chat mới vào phòng Chat

  1. Chuyển đến Chat.

    Chuyển đến Chat

  2. Nhấp vào một tin nhắn trực tiếp hoặc không gian.

  3. Nhấp vào trình đơn thả xuống bên cạnh tên của không gian hoặc người, rồi chọn Ứng dụng và công cụ tích hợp.

  4. Nhấp vào Thêm ứng dụng.

  5. Nhập tên ứng dụng, chọn ứng dụng trong danh sách rồi nhấp vào Thêm.

  6. Lặp lại các bước này cho mọi không gian hoặc tin nhắn trực tiếp mà bạn muốn thêm ứng dụng Chat.

Xoá ứng dụng Chat phiên bản cũ khỏi phòng Chat

  1. Chuyển đến Chat.

    Chuyển đến Chat

  2. Nhấp vào một tin nhắn trực tiếp hoặc không gian.

  3. Nhấp vào trình đơn thả xuống bên cạnh tên của không gian hoặc người, rồi chọn Ứng dụng và công cụ tích hợp.

  4. Bên cạnh ứng dụng Chat cũ chưa di chuyển, hãy nhấp vào biểu tượng Tuỳ chọn khác , rồi nhấp vào Xoá khỏi không gian.

  5. Lặp lại các bước này cho mọi không gian hoặc tin nhắn trực tiếp mà bạn muốn xoá ứng dụng Chat phiên bản cũ.

Tắt ứng dụng Chat phiên bản cũ

Để ngăn người dùng sử dụng ứng dụng Chat phiên bản cũ và khuyến khích họ sử dụng ứng dụng Chat phiên bản mới, hãy tắt ứng dụng Chat phiên bản cũ và huỷ xuất bản ứng dụng đó khỏi Google Workspace Marketplace.