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 đầy đủ chức năng cho ứng dụng Chat và khiến việc di chuyển trở nê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 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 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ừ dự án trên đám mây 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, đồng thời tắt ứng dụng Chat ban đầu.

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

Việc tạo một dự án trên đám mây 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ể thực hiện 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 Cloud, hãy chuyển đến trình đơn Trình đơn > IAM và Quản trị > Tạo một dự án.

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

  2. Trong trường Tên dự án, hãy nhập một 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 tồn tại 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 đó, nhấp vào Chọn.
  4. Nhấp vào Tạo. Bảng điều khiển 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 đâ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 đã thiết lập gcloud CLI sẵn, 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 gcloud CLI.
    Để tạo một dự án trên đám mây, 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ã 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 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 xây dựng ứ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. Theo phương pháp hay nhất, để đả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 trên đám mây mới như các API đã bật trong dự án trên đám mây cũ.

Để 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 trình đơn Trình đơn > API và dịch vụ > Thư viện > Google Workspace.

    Chuyển đến Thư viện API

  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 trên đám mây mới, 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. Để định cấu hình các thông tin chi tiết này, hãy xem Định cấu hình API Chat

Bạn có thể cần đị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 để cấp quyền, hãy sử dụng các phạm vi cấp quyền truy cập tương tự.

  1. Trong Google API Console, hãy chuyển đến trình đơn Trình đơn > Nền tảng Google Auth > Thương hiệu.

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

  2. Nếu đã định cấu hình Nền tảng Google Auth, bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình xin phép bằng OAuth trong phầ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 cho biết Nền tảng Google Auth chưa được định cấu hình, hãy nhấp vào Bắt đầu:
    1. Trong phần Thông tin ứng dụng, ở mục Tên ứng dụng, hãy nhập Tên ứng dụng.
    2. Trong 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 có câu hỏi về việc họ đồng ý.
    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 mà 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 các dịch vụ API của Google và 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 các 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 mức 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ó, hãy xem bài viết Phạm vi OAuth 2.0 cho các API của Google.
    • Xem lại 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 các 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 không nhạy cảm thay thế để tránh các lần xem xét bổ sung không cần thiết.
    • Một số phạm vi yêu cầu Google xem xét bổ sung. Đối với các ứ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 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 yêu cầu 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.
  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 quyền xin phép bằng OAuth, hãy xem bài viết Bắt đầu với nền tảng Google Auth.

Triển khai lại ứng dụng Chat vào dự án trên đám mây mới

Tuỳ thuộc vào việc ứng dụng Chat của bạn được xây dựng 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 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 của ứng dụng Chat

Tuỳ thuộc vào kiến 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 đám mây 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 xây dựng bằng các hàm Cloud Run, 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 trên đám mây 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, hãy định cấu hình ứng dụng Chat trong dự án trên đám mây mới.

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

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

Để triển khai lại ứng dụng Chat được xây dựng 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 trên đám mây mới. Sau đó, hãy sao chép mã triển khai Apps Script và dán mã đó vào trang định cấu hình ứng dụng Chat trong Google API Console.

Sao chép số dự án trên đám mây

  1. Trong Google API Console, hãy chuyển đến trình đơn Trình đơn > IAM và Quản trị > Cài đặt.

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

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

Đặt số dự án trên đám mây của 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 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 Số dự án GCP, hãy dán số dự án trên đám mây của Google.

  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ý bản triển khai.
  2. Trong phần 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 API Console, hãy tìm kiếm "Google Chat API" rồi nhấp vào Google Chat API, sau đó nhấp vào Quản lý.

    Chuyển đến API Chat

  2. Nhấp vào thẻ Định 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: URL HTTPS trỏ đến một hình ảnh đồ hoạ hình vuông (ví dụ: PNG hoặc JPEG), ít nhất 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.

  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ã 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 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 trên đám mây mới

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

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

Để triển khai lại ứng dụng Chat được xây dựng bằng AppSheet trong dự án trên đám mây mới, hãy sao chép ứng dụng đó vào dự án trên đám mây 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 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 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ó thể được người dùng trong tổ chức mới sử dụng, 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 phần Định cấu hình quyền truy cập cho các tổ chức Google Workspace trong tài liệu về Google Workspace Marketplace.

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

Giờ đây, ứng dụng Chat đã được di chuyển sang tổ chức mới, đã đến lúc công bố ứng dụng nà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 Chat hoặc tin nhắn trực tiếp đó để mọi người chỉ nhắn tin cho ứng dụng Chat đã di chuyển.

Thêm ứng dụng Chat mới vào các 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 phòng.

  3. Nhấp vào trình đơn thả xuống bên cạnh tên của phòng hoặc người, sau đó chọn Ứng dụng và 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, sau đó nhấp vào Thêm.

  6. Lặp lại các bước này cho mọi phòng 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 tin nhắn trực tiếp hoặc phòng.

  3. Nhấp vào trình đơn thả xuống bên cạnh tên của phòng hoặc người, sau đó chọn Ứng dụng và dịch vụ 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 , sau đó nhấp vào Xoá khỏi phòng.

  5. Lặp lại các bước này cho mọi phòng 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 sử dụng ứng dụng Chat cũ và khuyến khích họ sử 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 đó khỏi Google Workspace Marketplace.