Di chuyển ứng dụng Google Chat

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

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

Sau khi xác định rằng bạn cần di chuyển Ứng dụng Chat sẽ hoàn tất quy trình 3 bước sau đây:

  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 bằng OAuth 2.0.
  2. Triển khai lại ứng dụng Chat từ phiên bản mới Dự án trên đám mây.
  3. Thêm ứng dụng Chat đã được tạo lại vào Chat không gian hoặc cuộc trò chuyện và tắt các không gian gốc Ứng dụng Chat.

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

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 Bạn cần đả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ể làm việc này mà không gặp lỗi.

Tạo một dự án trên đám mây

bảng điều khiển Google Cloud

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và Quản trị > Tạo dự án.

    Chuyển đến trang Create a Project (Tạo dự án)

  2. Trong trường 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. 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 dự án.

  3. Trong trường Vị trí, hãy nhấp vào Duyệt qua để hiển thị các vị trí tiềm năng cho dự án. Sau đó nhấp vào Chọn.
  4. Nhấp vào Tạo. Bảng điều khiển Google Cloud 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.

Giao diện dòng lệnh (CLI) của gcloud

Truy cập vào Google Cloud ở một trong các môi trường phát triển sau đây CLI (`gcloud`):

  • Cloud Shell: Để sử dụng thiết bị đầu cuối trực tuyến với gcloud CLI đã thiết lập, hãy kích hoạt Cloud Shell.
    Kích hoạt Cloud Shell
  • Local Shell: Để sử dụng môi trường phát triển cục bộ, cài đặt và khởi động giao diện dòng lệnh (CLI) của gcloud.
    Để tạo một dự án trên đám mây, hãy 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 mà bạn muốn tạo.

Bật API

Tất cả các ứng dụng trong Chat đều phải có API Google Chat bật. 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, bật Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API và Cloud Run API. Phương pháp hay nhất là để đảm bảo rằng hoạt động của ứng dụng đã được di chuyển, hãy bật chính các API đó trong dự án Cloud mới đều được bật trong dự án cũ trên Google Cloud.

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

bảng điều khiển Google Cloud

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > 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 mà 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.

Google Cloud CLI

  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 của mình, bạn phải sử dụng API Chat để chỉ định tên, nội dung mô tả và biểu tượng của ứng dụng Chat. Người nhận định cấu hình các chi tiết này, xem Định cấu hình API Chat

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

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > API và Dịch vụ > Màn hình xin phép bằng OAuth.

    Chuyển đến màn hình xin phép bằng OAuth

  2. Chọn loại người dùng cho ứng dụng, sau đó nhấp vào Tạo.
  3. Hoàn tất biểu mẫu đăng ký ứng dụng, sau đó nhấp vào Lưu và tiếp tục.

  4. Nếu bạn đang tạo một ứng dụng để sử dụng bên ngoài Google Workspace tổ chức, hãy nhấp vào Add or Remove Scopes (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 cấp quyền truy cập tối thiểu mà ứng dụng của bạn yêu cầu. Để xem danh sách các phạm vi hiện có, xem Phạm vi của OAuth 2.0 cho API Google.
    • Xem lại các phạm vi được liệt kê ở mỗi phần trong số 3 phần sau: không nhạy cảm phạm vi, phạm vi nhạy cảm và phạm vi bị hạn chế. Đối với bất kỳ phạm vi nào được liệt kê trong "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 việc xem xét bổ sung một cách không cần thiết.
    • Một số phạm vi cần được Google xem xét thêm. Chỉ đối với những ứng dụng được dùng trong nội bộ tổ chức của bạn trên Google Workspace, nên các phạm vi không được liệt kê trên màn hình xin phép và sử dụng phạm vi nhạy cảm hoặc bị hạn chế không bắt buộc xem xét thêm của Google. Để biết thêm thông tin, hãy xem Danh mục phạm vi.
  5. Sau khi chọn phạm vi cần thiết bên cạnh ứng dụng, hãy nhấp vào Lưu và tiếp tục.
  6. 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. Trong phần Người dùng thử nghiệm, hãy nhấp vào Thêm người dùng.
    2. Nhập địa chỉ email của bạn và bất kỳ người dùng thử nghiệm nào khác được uỷ quyền, rồi nhấp vào Lưu và tiếp tục.
  7. Xem lại thông tin tóm tắt về gói đăng ký ứng dụng của bạn. Để chỉnh sửa, hãy nhấp vào Chỉnh sửa. Nếu ứng dụng có vẻ ổn, hãy nhấp vào Quay lại trang tổng quan.

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 hoặc 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ẽ khác nhau một chút. Trong cả hai trường hợp, bạn không cần tạo lại tất cả mã, nhưng bạn có thể cần thực hiện một số thay đổi.

Di chuyển logic của ứ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 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 nhân viên hỗ trợ Dialogflow.
  • Đối với các ứng dụng trong 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 Cloud mới

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

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

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

Để triển khai lại ứng dụng Chat được tích hợp sẵn Apps Script, hãy thay đổi số dự án Cloud mà Dự án Apps Script được liên kết với số dự án mà thuộc dự án 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 bảng điều khiển Google Cloud.

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

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và Quản trị > Cài đặt.

    Chuyển đến IAM và Chế độ cài đặt dành cho quản trị viên

  2. Trong trường Project number (Số 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.

    Truy cập Apps Script

  2. Trong dự án Apps Script của ứng dụng Chat: nhấp vào biểu tượng Cài đặt dự án .

  3. Trong mục Dự á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ã 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ý các phiên bản 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 bảng điều khiển Google Cloud, hãy tìm "Google Chat API" và nhấp vào API Google Chat, rồi nhấp vào Quản lý.

    Truy cập API Chat

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

    • 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 của bạn Ứng dụng Chat.
    • URL hình đại diện: URL loại HTTPS trỏ đến hình ảnh đồ hoạ hình vuông (ví dụ: PNG hoặc JPEG), 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.
    • Nội dung mô tả: Nội dung mô tả về Mục đích của ứng dụng Chat hiện ra bên dưới tên của ứng dụng Chat.

  3. Để bật tính năng tương tác, hãy nhấp vào nút Bật tính năng tương tác nút bật/tắt 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 Deployment ID (Mã triển khai), hãy dán mã triển khai mà bạn trước đây đã sao chép.

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

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

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

Để triển khai lại ứng dụng Chat được tích hợp sẵn AppSheet trong dự án Cloud mới của mình, sao chép ứng dụng sang dự án Cloud mới.

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

Nếu ứng dụng Chat của bạn xác thực là một ứng dụng và sử dụng tài khoản dịch vụ để gọi đến các 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, xem Xác thực dưới dạng ứng dụng Chat.

Chia sẻ ứng dụng Chat

Trước khi ứng dụng Chat của bạn được cung cấp cho người dùng trong tổ chức mới, quản trị viên có thể phải cấp quyền truy cập vào Ứng dụng Chat. Để biết thêm thông tin, tham chiếu đến Cách quản trị viên Google Workspace cài đặt các ứng dụng trong Chat.

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

Giờ đây, ứng dụng Chat đã được di chuyển sang tổ chức, đã đến lúc công khai điều đó. Thêm vào phòng Chat hoặc tin nhắn trực tiếp, rồi xoá ứng dụng Chat cũ để mọi người chỉ nhắn tin cho Ứng dụng Chat.

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 không gian hoặc tin nhắn trực tiếp.

  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, sau đó chọn Ứng dụng và 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 cũ khỏi các phòng Chat

  1. Chuyển đến Chat.

    Chuyển đến Chat

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

  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, sau đó chọn Ứng dụng và tích hợp.

  4. Bên cạnh ứng dụng Chat cũ, chưa được di chuyển, hãy nhấp vào Tuỳ chọn khác , sau đó 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 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 mới, 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.