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 kiểm tra với 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 một 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 phải di chuyển. Ví dụ: quản trị viên Google Workspace có thể phải thêm ứng dụng Chat của bạn vào danh sách cho phép hoặc 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 ứng dụng Google Chat có cần di chuyển sau khi hợp nhất các tổ chức Google Workspace hay không.

Sau khi xác định rằng bạn 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 trê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 đồng ý 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 được tạo lại vào không gian hoặc cuộc trò chuyện trên Chat, rồi tắt ứng dụng Chat ban đầu.

Tạo một 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 đảm bảo rằng nhữ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 một dự án trên Cloud

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

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

   Chuyển đến phần 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. 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ã dự án đáp ứng nhu cầu của bạn trong suốt thời gian tồn tại của dự án.

3. Trong trường Location (Vị trí), hãy nhấp vào Browse (Duyệt xem) để hiện các vị trí tiềm năng cho dự án của bạn. Sau đó, hãy nhấp vào Chọn.
   Thận trọng: Bạn không tìm thấy tổ chức của mình trên Google Workspace?
   Điều này có nghĩa là bạn chưa đăng nhập vào tài khoản Google Workspace. Một số tính năng được mô tả trong tài liệu dành cho nhà phát triển Google Workspace chỉ dành cho những dự án được liên kết với một tổ chức.
4. Nhấp vào Tạo. Bảng điều khiển Google Cloud sẽ chuyển đến trang Tổng quan và dự án của bạn sẽ được tạo trong vòng vài phút.

gcloud CLI

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
• Local Shell: Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi động CLI gcloud.
  Để tạo một dự án trên Cloud, 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ả ứng dụng Chat đều phải bật Google Chat API. Tuỳ thuộc vào cách tạo ứ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 Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API và Cloud Run API. Tốt nhất là bạn nên bật cùng một API trong dự án mới trên Cloud như trong dự án cũ trên Cloud để đảm bảo ứng dụng đã di chuyển hoạt động.

Để bật mộ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 phầ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 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, bạn phải 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 những thông tin này, hãy xem phần Định cấu hình Chat API

Định cấu hình màn hình xin phép bằng OAuth

Bạn có thể cần định cấu hình màn hình đồ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 sử dụng cùng các phạm vi uỷ quyền truy cập.

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > > 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 Thương hiệu, Đối tượng và Quyền truy cập vào 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 phần Thông tin về ứng dụng, trong mục 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 một địa chỉ email hỗ trợ mà người dùng có thể liên hệ với bạn nếu họ có thắc mắc về sự đồng ý của mình.
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 kỹ 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 kiểm thử:
    1. Nhấp vào Đối tượng.
    2. Trong phần Người dùng kiểm thử, 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 kiểm thử đượ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 của mình, hãy nhấp vào Quyền truy cập vào 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 những 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ạ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 từng 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 phần "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 thay thế không nhạy cảm để tránh các quy trình đánh giá bổ sung không cần thiết.
   • Một số phạm vi cần Google xem xét thêm. Đối với những ứng dụng chỉ được tổ chức Google Workspace của bạn sử dụng nội bộ, các phạm vi sẽ không xuất hiện trên màn hình đồng ý và việc sử dụng các phạm vi bị hạn chế hoặc nhạy cảm 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 ý của OAuth, hãy xem phần Bắt đầu sử dụng .

Triển khai lại ứng dụng Chat vào 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 phải 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 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 mới trên Cloud:

• Đố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 đàm thoại sử dụng ngôn ngữ tự nhiên, bạn cũng cần di chuyển các đặc vụ Dialogflow.
• Đối với các ứng dụng Chat được tạo 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 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 mới trên Cloud.

Để đị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 hoạt động 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 Đám mây mà dự án Apps Script được liên kết thành số dự án thuộc dự án mới trên Đám mây. Sau đó, hãy sao chép mã nhận dạng triển khai Apps Script rồi dán mã đó 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 Bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > IAM và Quản trị > Cài đặt.

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

2. Sao chép giá trị trong trường Số dự án.

Đặ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 Apps Script của ứng dụng Chat, hãy nhấp vào biểu tượng Cài đặt dự án .

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

4. Trong Số dự án trên Google Cloud Platform, 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 lượt 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ý việc triển khai.
2. Trong mục Mã nhận dạng lượt 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 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: Một URL 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 của bạn.
   • Nội dung mô tả: Nội dung mô tả về mục đích dự kiến của ứng dụng Chat xuất hiện bên dưới tên ứng dụng Chat của bạn.

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 các 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 của bạn:

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

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

6. Để hoàn tất các bước còn lại trong quá trình định cấu hình, 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 trên 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 của bạn xác thực dưới dạng một ứng dụng và sử dụng tài khoản dịch vụ để thực hiện các lệnh gọi đến API của Google, hãy cập nhật thông tin 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 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 cho phép 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 Định cấu hình quyền truy cập cho các tổ chức Google Workspace trong tài liệu của Google Workspace Marketplace.

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ố việc này. Thêm ứng dụng này vào không gian Chat hoặc tin nhắn trực tiếp, rồi 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 cho ứng dụng Chat đã di chuyển.

Phương pháp hay nhất: Để hỗ trợ việc áp dụng ứng dụng Chat đã di chuyển, hãy thông báo cho người dùng về việc di chuyển và khuyến khích họ cài đặt ứng dụng Chat đã di chuyển trong các không gian và cuộc trò chuyện trên Chat.

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

1. Chuyển đến Chat.

   Chuyển sang 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 dùng, rồi chọn Ứng dụng và các dịch vụ tích hợp.

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

5. Nhập tên của ứ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 vào.

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

1. Chuyển đến Chat.

   Chuyển sang 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 dùng, rồi chọn Ứng dụng và các dịch 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 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 này trên Google Workspace Marketplace.