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 để ứ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 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 việc di chuyển không cần thiết. 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 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 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 bạn 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 Google Cloud trong tổ chức đã hợp nhất, bật các 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 Google Cloud mới.
3. Thêm ứng dụng Chat đã tạo lại vào các phòng Chat hoặc cuộc trò chuyện, rồi tắt ứng dụng Chat ban đầu.

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

Việc tạo một dự án Google 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 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ể làm việc này mà không gặp lỗi.

Tạo dự á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 Trình đơn > IAM và Quản trị viên > Tạo dự án.

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

3. Trong trường Location (Vị trí), hãy nhấp vào Browse (Duyệt qua) để xem 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 Google Workspace của mình?
   Đ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ùng được cho các dự án liên kết với một tổ chức.
4. Nhấp vào Tạo. Bảng điều khiển của 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.

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

Trong một trong các môi trường phát triển sau đây, 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 đã được 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à initialize gcloud CLI.
  Để tạo một dự án trên Google Cloud, hãy dùng lệnh "gcloud project create" (tạo dự án gcloud):

  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 trong Chat đều phải bật API Google Chat. Tuỳ thuộc vào cách ứng dụng Chat được tạo, có thể bạn 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. Cách tốt nhất là để đảm bảo ứng dụng đã di chuyển hoạt động được, hãy bật chính các API đó trong dự án Google Cloud mới được bật trong dự án Google Cloud cũ.

Để 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 các API khác, 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 Google Cloud (CLI).

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

   gcloud services enable API_SERVICE_ID

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

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 Google Cloud của mình. Nếu trước đây bạn đã dùng OAuth 2.0 để uỷ quyền, hãy sử dụng cùng phạm vi uỷ quyền của 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 đồ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 của bạn, sau đó nhấp vào Create (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 để dùng bên ngoài tổ chức Google Workspace của mình, hãy nhấp vào Add or Remove Scopes (Thêm hoặc xoá phạm vi). Khi chọn phạm vi, bạn nên áp dụng các phương pháp hay nhất sau đây:

   • 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 có thể sử dụng, hãy xem nội dung Phạm vi OAuth 2.0 dành cho API 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 nêu trong phần "Các phạm vi nhạy cảm của bạn" hoặc "Cá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.
   • Một số phạm vi yêu cầu Google xem xét thêm. Đối với các ứng dụng chỉ được tổ chức của bạn trên Google Workspace sử dụng trong nội bộ, phạm vi sẽ không được liệt kê trên màn hình xin phép và việc sử dụng các phạm vi bị hạn chế hoặc nhạy cảm không cần được Google xem xét thêm. Để biết thêm thông tin, hãy xem bài viết Danh mục phạm vi.
5. 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 Save and Continue (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, sau đó nhấp vào Lưu và tiếp tục.
7. Xem lại tóm tắt đă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 quá trình đăng ký ứng dụng có vẻ ổn, hãy nhấp vào Back to Dashboard (Quay lại Trang tổng quan).

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

Tuỳ thuộc vào việc ứng dụng Chat được tạo bằng Apps Script, AppSheet hay một loại kết nối khác (như Python hoặc Java), việc triển khai lại ứng dụng Chat có thể khác một chút. Trong cả hai trường hợp, bạn không cần tạo lại toàn bộ mã nhưng 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 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 trò chuyện trong Chat 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 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 ứng dụng Chat trong dự án Google 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 Google Cloud mới của bạn.

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

   Chuyển đến API Chat

2. Nhấp vào thẻ Configuration (Cấu hình) rồi nhập những 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.
   • URL hình đại diện: URL loại HTTPS trỏ đến một hình ảnh đồ hoạ vuông (ví dụ: PNG hoặc JPEG), có kích thước tối thiểu 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 dự định của ứng dụng Chat xuất hiện bên dưới tên ứng dụng trong 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 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 và sử dụng bảng sau để hoàn tất việc định cấu hình:

   Trường	Nội dung mô tả
   Chức năng	Một tập hợp các trường xác định cách ứng dụng Chat có thể tương tác với người dùng: Nhận tin nhắn 1:1: Người dùng có thể tìm và nhắn tin cho ứng dụng Chat ngay trong Google Chat. Tham gia không gian và cuộc trò chuyện nhóm: Người dùng có thể thêm ứng dụng Chat vào không gian và cuộc trò chuyện nhóm.
   Chế độ cài đặt kết nối	Điểm cuối của ứng dụng Chat là một trong những điểm cuối sau đây: URL ứng dụng: Điểm cuối HTTPS lưu trữ hoạt động triển khai ứng dụng Chat. Dự án Apps Script: Mã triển khai cho dự án Apps Script triển khai ứng dụng Chat. Tên chủ đề trên Cloud Pub/Sub: Một chủ đề về Pub/Sub mà ứng dụng Chat đăng ký làm điểm cuối. Dialogflow: Đăng ký ứng dụng Chat bằng công cụ tích hợp Dialogflow. Để biết thêm thông tin, hãy xem bài viết Tạo một ứng dụng Dialogflow Google Chat hiểu ngôn ngữ tự nhiên.
   Lệnh dấu gạch chéo	Các lệnh có thể hiển thị cho người dùng trong Google Chat. Cho phép người dùng xem các hành động chính của ứng dụng nhắn tin của bạn trong Google Chat và chọn một hành động cụ thể mà họ muốn tương tác. Để biết thêm thông tin, hãy xem phần Phản hồi lệnh dấu gạch chéo trong ứng dụng Chat.
   Bản xem trước đường liên kết	Các mẫu URL mà ứng dụng Chat nhận dạng và cung cấp nội dung bổ sung khi người dùng gửi đường liên kết. Để biết thêm thông tin, hãy xem bài viết Xem trước đường liên kết.
   Chế độ hiển thị	Tối đa 5 cá nhân hoặc một hoặc nhiều nhóm trên Google Groups có thể xem và cài đặt ứng dụng Chat của bạn. Hãy sử dụng trường này để kiểm tra ứng dụng Chat hoặc để chia sẻ ứng dụng Chat với nhóm của bạn. Để biết thêm thông tin, hãy xem Chế độ hiển thị và xuất bản của ứng dụng Chat.

4. Để ghi lỗi vào Cloud Logging bất cứ khi nào ứng dụng Chat báo lỗi, hãy chọn hộp đánh dấu Log errors to Logging (Ghi nhật ký lỗi vào nhật ký). Để biết thêm thông tin, hãy xem phần Nhật ký lỗi truy vấn đối với các ứng dụng trong Chat.

5. Nhấp vào Lưu. Khi bạn lưu cấu hình của ứng dụng Chat, ứng dụng Chat sẽ được cung cấp cho người dùng được chỉ định trong tổ chức Google Workspace của bạn.

Triển khai lại ứng dụng Chat trong 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 Cloud liên kết với dự án Apps Script thành số dự án của 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 đám mây

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

   Chuyển đến phần Cài đặt quản trị viên và quản lý danh tính và quyền truy cập (IAM)

2. Trong trường 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.

   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 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 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ý 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 "API Google Chat" rồi nhấp vào API Google Chat, sau đó nhấp vào Quản lý.

   Chuyển đến API Chat

2. Nhấp vào thẻ Configuration (Cấu hình) rồi nhập những 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.
   • URL hình đại diện: URL loại HTTPS trỏ đến một hình ảnh đồ hoạ vuông (ví dụ: PNG hoặc JPEG), có kích thước tối thiểu 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 dự định của ứng dụng Chat xuất hiện bên dưới tên ứng dụng trong 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 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:

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 đã sao chép trước đó.

6. Để hoàn tất phần còn lại của cấu hình, hãy xem bảng trong phần Đị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 Chat của AppSheet

Để triển khai lại ứng dụng Chat được tạo bằng AppSheet trong dự án Google Cloud mới của bạn, hãy sao chép ứng dụng đó sang dự án Google 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à dùng tài khoản dịch vụ để thực hiện lệnh gọi đến các 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 bài viết 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 cung cấp cho người dùng trong tổ chức mới, quản trị viên của bạ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 phầ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

Ứng dụng Chat hiện đã được di chuyển sang tổ chức mới, đã đến lúc công bố ứng dụng đó. Hãy thêm ứng dụng này vào các phòng Chat hoặc tin nhắn trực tiếp, sau đó xoá ứng dụng Chat cũ khỏi các phòng trò chuyện đó để mọi người chỉ nhắn tin về ứng dụng Chat đã di chuyển.

Phương pháp hay nhất: Để hỗ trợ việc sử dụng ứng dụng Chat đã được di chuyển, hãy thông báo về việc di chuyển cho người dùng và khuyến khích họ cài đặt ứng dụng Chat đã di chuyển trong các phòng trò chuyện và phò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 không gian hoặc người, rồi chọn Ứng dụng và các 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 từ danh sách rồi nhấp vào Add (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 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 không gian hoặc người, rồi chọn Ứng dụng và các công cụ tích hợp.

4. Bên cạnh ứng dụng Chat cũ và 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 cũ.

Tắt ứng dụng Chat cũ

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

Chủ đề có liên quan

• Xuất bản ứng dụng