Tạo và quản lý Ứng dụng được kết nối bằng AppFunctions và MCP Android trong Google Connected Console

Sử dụng Google Connected Console để tích hợp AppFunctions trên thiết bị của ứng dụng Android với Gemini trên Android. Bằng cách tạo một ứng dụng được kết nối với loại kết nối MCP Android và liên kết ứng dụng đó với ứng dụng của bạn trên Play, bạn cho phép Gemini trên Android kích hoạt các hành động và hoàn thành nhiệm vụ ngay trong ứng dụng của bạn thay mặt cho người dùng.

Hướng dẫn này sẽ đưa bạn qua quy trình tự phục vụ toàn diện trong Google Connected Console, bao gồm cả việc tạo ứng dụng được kết nối, liên kết ứng dụng Play, cấu hình thẻ ứng dụng công khai, tải lên và gửi gói ứng dụng, thử nghiệm xem trước trên thiết bị và phát hành công khai.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo rằng bạn có:

  • Quyền truy cập vào tài khoản nhà phát triển đã đăng ký trong Google Connected Console:
    • Chấp nhận Điều khoản dịch vụ: Lần đầu tiên tổ chức của bạn truy cập vào Ứng dụng được kết nối trong Google Connected Console, chủ sở hữu tài khoản hoặc quản trị viên phải xem xét và chấp nhận Điều khoản dịch vụ của Ứng dụng được kết nối thì các thành viên trong nhóm mới có thể tạo Ứng dụng được kết nối.
    • Quyền của người dùng: Nếu bạn được mời tham gia một tài khoản nhà phát triển hiện có trên Connected Console nhưng không thể tạo Ứng dụng được kết nối, hãy yêu cầu chủ sở hữu hoặc quản trị viên tài khoản cấp cho bạn quyền Xem Ứng dụng được kết nối hoặc Tạo và quản lý Ứng dụng được kết nối trên trang Người dùng và quyền. Bạn cũng cần có quyền quản lý bản phát hành cho ứng dụng Play có liên quan để tải gói ứng dụng lên và quản lý bản phát hành.
  • Một ứng dụng hiện có trên Play trong tài khoản Google Connected Console của bạn:
    • Ứng dụng của bạn trên Play phải tồn tại trong cùng một tài khoản nhà phát triển để bạn có thể liên kết ứng dụng đó với ứng dụng đã kết nối. Mỗi ứng dụng trên Play chỉ có thể được liên kết với một ứng dụng Android đã kết nối trên MCP.
    • Đảm bảo ứng dụng của bạn trên Play có trang thông tin mặc định trên Cửa hàng Play được định cấu hình bằng biểu tượng ứng dụng và ngôn ngữ được hỗ trợ. Ngôn ngữ trên trang thông tin của ứng dụng trên Cửa hàng Play và tiêu chí nhắm mục tiêu theo quốc gia sẽ xác định nơi ứng dụng Android được kết nối với MCP của bạn có thể hoạt động.
  • Một Android App Bundle (.aab) có triển khai AppFunctions:
    • Định cấu hình gói ứng dụng để nhắm đến thiết bị di động Android, đây là nền tảng được hỗ trợ để tích hợp ứng dụng Gemini trên thiết bị.
  • Danh mục ứng dụng có thể kết nối và siêu dữ liệu công khai: Chuẩn bị các thành phần và thông tin chi tiết tạo nên sự hiện diện công khai của ứng dụng có thể kết nối:
    • Danh mục ứng dụng có thể kết nối: Danh mục miền hoặc ngành cho ứng dụng có thể kết nối của bạn. Mỗi danh mục xác định các yêu cầu về chức năng cơ bản và không thể thay đổi sau khi tạo.
    • Tên ứng dụng: Tên hiển thị của ứng dụng được kết nối mà người dùng nhìn thấy trên các sản phẩm của Google và được dùng khi người dùng đề cập đến ứng dụng của bạn bằng @ trong Gemini.
    • Biểu tượng ứng dụng được kết nối: Biểu tượng ứng dụng có kích thước 512 px x 512 px ở định dạng JPEG hoặc PNG, với kích thước tệp tối đa là 1 MB (1.024 KB).
    • Nội dung mô tả ứng dụng: Nội dung tóm tắt súc tích mô tả những việc mà ứng dụng có thể kết nối của bạn có thể làm cho người dùng.
    • Tính năng của ứng dụng: Ít nhất 3 tính năng tuỳ chỉnh cho người dùng biết ứng dụng của bạn có thể làm gì khi họ quyết định có kết nối hay không, ngoài mọi tính năng mặc định được xác định theo danh mục của ứng dụng.
    • Câu lệnh mẫu: Ít nhất 3 câu lệnh mẫu hướng dẫn người dùng cách gọi ứng dụng của bạn trong Gemini và giúp họ hiểu những gì họ có thể yêu cầu.
    • URL chính sách: URL truy cập công khai cho Chính sách quyền riêng tư của bạn.
    • URL của Điều khoản dịch vụ: URL có thể truy cập công khai cho Điều khoản dịch vụ của bạn.
    • URL của trang web (không bắt buộc): URL có thể truy cập công khai trỏ đến trang web của bạn để ghi nhận tác giả.

Đăng ký, thử nghiệm và phát hành AppFunctions bằng Gemini

Sau khi đáp ứng các điều kiện tiên quyết, hãy hoàn tất các bước sau để đăng ký ứng dụng Android có thể kết nối tích hợp MCP, liên kết ứng dụng của bạn trên Play, điền thông tin chi tiết về ứng dụng, tải lên và gửi AppFunctions, thử nghiệm trên thiết bị và phát hành chính thức.

Bước 1: Tạo một ứng dụng Android được kết nối với MCP và liên kết ứng dụng đó với ứng dụng của bạn trên Play

Để tạo một ứng dụng đã kết nối và liên kết ứng dụng đó với ứng dụng của bạn trên Play, hãy làm theo các bước sau:

  1. Đăng nhập vào Google Connected Console.
  2. Trên trang Trang chủ, hãy chọn Tạo ứng dụng.
  3. Trong hộp thoại Chọn nội dung cần tạo:
    • Nếu bạn được nhắc chấp nhận Điều khoản dịch vụ của các ứng dụng có thể kết nối, hãy chọn Xem điều khoản, xem xét và chấp nhận thoả thuận, sau đó chọn Tạo. Chỉ quản trị viên tài khoản mới có thể chấp nhận thoả thuận.
    • Nếu không, hãy chọn Tạo trong thẻ Ứng dụng đã kết nối.
  4. Trong hộp thoại Đặt tên cho ứng dụng được kết nối, hãy nhập tên cho ứng dụng được kết nối. Đây là tên hiển thị ứng dụng được kết nối của bạn trên các sản phẩm của Google và là cách người dùng đề cập đến ứng dụng được kết nối của bạn bằng @. Chọn Tiếp theo.

  5. Trong hộp thoại Chọn danh mục ứng dụng được kết nối, hãy chọn miền, danh mục hoặc ngành của ứng dụng trong trình đơn Chọn danh mục.

  6. Trong hộp thoại Choose connection type (Chọn loại kết nối), hãy chọn Android MCP.

    Để biết hướng dẫn chi tiết về cách thiết lập ứng dụng được kết nối với máy chủ MCP, hãy xem hướng dẫn tích hợp Google Play Console. Hiện tại, bạn chỉ có thể chọn một loại kết nối cho mỗi ứng dụng được kết nối và bạn không thể thay đổi loại kết nối đó sau này.

  7. Chọn Tạo ứng dụng đã kết nối.

  8. Trong hộp thoại Select app (Chọn ứng dụng), hãy tìm ứng dụng Play chứa (hoặc sẽ chứa) AppFunctions của bạn rồi chọn ứng dụng đó. Bạn có thể lọc danh sách bằng cách sử dụng tính năng tìm kiếm.

    • Bạn không thể chọn những ứng dụng trên Play đã được liên kết với một ứng dụng khác có thể kết nối.
    • Hãy nhớ chọn đúng ứng dụng trên Play mà bạn muốn liên kết. Sau khi chọn một ứng dụng trên Play, bạn sẽ không thể thay đổi ứng dụng đó.

Thao tác này sẽ mở trang tổng quan quản lý cho ứng dụng đã kết nối, nơi bạn có thể tiếp tục định cấu hình chi tiết ứng dụng đã kết nối, theo dõi các phiên bản ứng dụng đã kết nối và quản lý người thử nghiệm.

Bước 2: Cung cấp chi tiết ứng dụng được kết nối

Trước khi tải bất kỳ gói ứng dụng nào có chứa AppFunctions lên, hãy định cấu hình cách ứng dụng được kết nối của bạn xuất hiện cho người dùng trong Gemini.

Hãy làm theo các bước sau để cung cấp chi tiết ứng dụng được kết nối:

  1. Trên trang quản lý của ứng dụng đã kết nối, trong thẻ Android MCP, trong phần Thêm chi tiết ứng dụng đã kết nối, hãy chọn Thêm chi tiết ứng dụng (hoặc Quản lý nếu cập nhật chi tiết hiện có).
  2. Ở đầu trang chi tiết ứng dụng, hãy xác minh trường Tên ứng dụng được kết nối. Bạn có thể cập nhật tên nếu cần. Người dùng sẽ thấy tên này trên các sản phẩm của Google và có thể dùng tên này để đề cập đến ứng dụng của bạn bằng ký tự @.
  3. Trong mục Thông tin công khai, trong phần Biểu tượng, hãy tải biểu tượng ứng dụng lên (JPG hoặc PNG, tối đa 1 MB và 512 px x 512 px).

  4. Hoàn tất các trường sau:

    • Nội dung mô tả: Nhập một câu tóm tắt ngắn gọn (dưới 30 từ) mô tả các tính năng chính của ứng dụng được kết nối và những việc ứng dụng đó có thể làm. Văn bản này hiển thị cho người dùng và không được dùng làm chỉ dẫn cho mô hình.
    • Tính năng: Nhập ít nhất 3 nhiệm vụ có giá trị cao mà ứng dụng được kết nối của bạn có thể thực hiện. Chọn Add capability (Thêm chức năng) để thêm các mục khác. Đừng thêm số vào đầu các chức năng. Chỉ cung cấp một chức năng cho mỗi mục. Nếu danh mục ứng dụng được kết nối của bạn có các chức năng được xác định trước, thì các chức năng đó sẽ xuất hiện ở đầu danh sách và không thể sửa đổi.
    • Câu lệnh mẫu: Nhập ít nhất 3 câu lệnh mẫu để giúp người dùng hiểu được những việc họ có thể yêu cầu. Chọn Thêm câu lệnh mẫu để thêm các mục.
      • Bắt đầu ít nhất hai câu lệnh bằng @<YourAppName> (ví dụ: @Order Tracker where is my last order?).
      • Đề cập đến <YourAppName> một cách tự nhiên trong ít nhất một câu lệnh mà không bắt đầu bằng tên ứng dụng của bạn (ví dụ: Track my recent order on Order Tracker).
      • Đừng thêm tiền tố được đánh số (1., 2., 3.) hoặc đặt câu lệnh trong dấu ngoặc kép ("...").

    • Bản địa hoá đa ngôn ngữ: Để cung cấp bản dịch cho Nội dung mô tả, Khả năng và Câu lệnh mẫu, hãy gói văn bản của từng ngôn ngữ trong thẻ ngôn ngữ trong trường nhập dữ liệu. Ví dụ:

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      Connected Console tự động xác thực thẻ của bạn và hiển thị ngôn ngữ được phát hiện trong mỗi trường (ví dụ: Found translations for 2 languages: en-US, es-ES).

    • URL của Điều khoản dịch vụ: Nhập đường liên kết https:// hoặc http:// hợp lệ đến Điều khoản dịch vụ của bạn.

    • URL của chính sách: Nhập đường liên kết https:// hoặc http:// hợp lệ đến Chính sách quyền riêng tư của bạn.

    • URL của trang web (không bắt buộc): Nhập đường liên kết đến trang web của bạn để ghi nhận tác giả.

Bước 3: Tải gói ứng dụng chứa AppFunctions lên và gửi ứng dụng đã kết nối

Sau khi lưu thông tin chi tiết về ứng dụng đã kết nối, hãy tải Android App Bundle chứa AppFunctions lên ứng dụng Play được liên kết và gửi phiên bản ứng dụng đã kết nối để thử nghiệm.

Để tải một gói ứng dụng chứa AppFunctions lên, hãy làm theo các bước sau:

  1. Trên trang quản lý của ứng dụng đã kết nối, trong thẻ Android MCP trong phần Tải gói ứng dụng chứa AppFunctions lên, hãy chọn Tải gói ứng dụng lên để chuyển đến phần tổng quan về Thử nghiệm và phát hành của ứng dụng Play được liên kết.
  2. Ngoài ra, bạn có thể mở trực tiếp ứng dụng Play đã liên kết trong Google Connected Console. Trong trình đơn điều hướng bên trái của ứng dụng Play, hãy chuyển đến phần Thử nghiệm > Thử nghiệm nội bộ (hoặc một kênh thử nghiệm khác) rồi chọn Tạo bản phát hành mới (hoặc Chỉnh sửa bản phát hành nếu bạn đã có bản phát hành nháp).
  3. Trong phần Gói ứng dụng, hãy chọn Tải lên để tải gói .aab có AppFunctions lên hoặc chọn Thêm từ thư viện nếu bạn đã tải gói lên sau khi hoàn tất Bước 2.
  4. Sau khi tải lên xong, hãy chuyển đến phần Đã phát hiện chức năng của ứng dụng trong gói ứng dụng của bạn trên trang phát hành. Xác nhận rằng tên ứng dụng đã kết nối, mã phiên bản gói, số lượng công cụ được phát hiện, số lượng ngôn ngữ và tiêu chí nhắm mục tiêu theo quốc gia của ứng dụng trên Play xuất hiện như mong đợi, đồng thời xác minh rằng quy trình kiểm tra tự động không báo cáo vấn đề nào. (Nếu có lỗi xác thực, hãy làm theo hướng dẫn trong phần Khắc phục sự cố liên quan đến AppFunctions trước khi tiếp tục.)
  5. Ở cuối trang phát hành, hãy chọn Gửi ứng dụng đã kết nối và tiếp tục.

Khi bạn chọn Gửi ứng dụng đã kết nối và tiếp tục, phiên bản AppFunctions của bạn sẽ được gửi đến Gemini để thử nghiệm xem trước và chuyển bản phát hành trên Play sang trang xem trước bản phát hành. Nếu bạn muốn lặp lại AppFunctions bằng các bản dựng cục bộ mà không tăng mã phiên bản của gói ứng dụng, hãy để bản phát hành trên Play ở trạng thái Bản nháp và không chọn Lưu và xuất bản. Việc phát hành một bản phát hành trên Play sẽ khoá mã phiên bản gói đó để không thể xoá và tải lên lại. Mọi thay đổi sau đó đều yêu cầu mã phiên bản gói ứng dụng tăng dần. (Nếu người thử nghiệm cài đặt ứng dụng trực tiếp từ kênh thử nghiệm nội bộ của Google Play thay vì cài đặt không qua cửa hàng ứng dụng, hãy hoàn tất quá trình phát hành thử nghiệm nội bộ và tăng mã phiên bản trong các lần tải lên sau này.)

Bước 4: Xác minh phiên bản ứng dụng đã kết nối

Sau khi gửi ứng dụng có thể kết nối từ trang Bản phát hành trên Play, hãy xác minh rằng phiên bản ứng dụng có thể kết nối đã sẵn sàng để xem trước:

  1. Trên trang quản lý của ứng dụng đã kết nối, trong thẻ Android MCP, bên cạnh mục Phiên bản, hãy chọn Xem.
  2. Trên trang Phiên bản, hãy xác nhận rằng phiên bản bạn đã gửi xuất hiện trong phần Dành cho người kiểm thử (hiển thị Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>).
    • Chọn Xem trên bất kỳ hàng phiên bản nào để kiểm tra AppFunctions được phát hiện và ảnh chụp nhanh chi tiết ứng dụng chỉ có thể đọc được ghi lại cho phiên bản đó.
    • Những phiên bản được tạo từ một gói ứng dụng đã tải lên mà bạn chưa chọn Gửi ứng dụng có thể kết nối và tiếp tục sẽ xuất hiện trong mục Đang chờ gửi.

Bước 5: Thử nghiệm ứng dụng có thể kết nối

Để cung cấp ứng dụng đã kết nối cho người thử nghiệm, bạn phải thêm họ trên trang Quản lý người thử nghiệm. Chỉ những người dùng mà bạn thêm vào danh sách người thử nghiệm mới có thể xem và tương tác với ứng dụng đã kết nối chưa xuất bản của bạn. Bạn chỉ có thể thêm người thử nghiệm có tài khoản @gmail.com.

  1. Trên trang tổng quan của ứng dụng được kết nối, trong thẻ Thử nghiệm ứng dụng, hãy chọn Thêm người thử nghiệm (hoặc Quản lý người thử nghiệm nếu bạn đã thêm một số người thử nghiệm).
  2. Trên trang Quản lý người kiểm thử, hãy chọn danh sách email hiện có hoặc chọn Tạo danh sách email để thêm Tài khoản Google được uỷ quyền kiểm thử quá trình tích hợp của bạn. Nhớ thêm địa chỉ email của riêng bạn nếu bạn muốn tự thử nghiệm ứng dụng.

  3. Chọn Lưu.

  4. Người thử nghiệm trong ứng dụng Gemini có thể gọi ứng dụng đã kết nối của bạn bằng cách nhập @, theo sau là tên của ứng dụng đã kết nối và chọn ứng dụng đó trong trình đơn. Bạn cũng có thể xem và kết nối ứng dụng của mình trong Gemini bằng cách chuyển đến phần Cài đặt và trợ giúp > Ứng dụng đã kết nối trong thanh điều hướng bên trái.

Trước khi thử nghiệm trên thiết bị, hãy xác nhận rằng mỗi người kiểm thử đều đáp ứng các yêu cầu sau:

  • Đăng nhập vào điện thoại di động hoặc máy tính bảng Android bằng Tài khoản Google có trong danh sách email được định cấu hình ở Bước 5.
  • Chạy chính xác bản dựng ứng dụng Android có mã phiên bản gói khớp với phiên bản đã gửi ở Bước 4.

Bạn nên kiểm tra kỹ lưỡng quá trình tích hợp:

  • Thử tất cả Câu lệnh mẫu.
  • Kiểm tra cả lệnh gọi @<AppName> rõ ràng và truy vấn bằng ngôn ngữ tự nhiên.
  • Xác minh việc xử lý tham số công cụ, lời nhắc xác nhận và quá trình thực thi từ đầu đến cuối trên AppFunctions.

Khi đã hài lòng với kết quả kiểm thử, bạn có thể gửi ứng dụng đã kết nối cho Google xem xét.

Bước 6: Xuất bản ứng dụng có thể kết nối cho người dùng

Không giống như các hoạt động tích hợp MCP do máy chủ lưu trữ, ứng dụng được kết nối Android MCP không yêu cầu hành động xem xét hoặc xuất bản riêng biệt trên trang Quản lý ứng dụng đã kết nối. Thay vào đó, phiên bản ứng dụng được kết nối của bạn sẽ được Google xem xét và tự động xuất bản khi bạn phát hành phiên bản ứng dụng Play chứa gói ứng dụng AppFunctions lên kênh phát hành công khai.

Khi bạn đã hoàn tất quá trình thử nghiệm và sẵn sàng ra mắt cho người dùng:

  1. Trong Google Connected Console, hãy mở ứng dụng Play được liên kết rồi chuyển đến phần Phát hành > Phát hành công khai trong trình đơn điều hướng bên trái (hoặc chuyển bản phát hành đã thử nghiệm từ kênh thử nghiệm sang kênh Phát hành công khai).
  2. Chọn Tạo bản phát hành mới (hoặc chỉnh sửa bản phát hành công khai nháp hiện có) rồi thêm gói ứng dụng chứa AppFunctions đã xác minh bằng cách sử dụng tuỳ chọn Thêm từ thư viện hoặc Tải lên.
  3. Chuyển đến phần Đã phát hiện AppFunctions trong gói ứng dụng của bạn để xác nhận phiên bản ứng dụng đã kết nối, số lượng công cụ, số lượng ngôn ngữ của trang thông tin trên Cửa hàng Play và tiêu chí nhắm mục tiêu theo quốc gia của ứng dụng trên Play, đồng thời đảm bảo quy trình kiểm tra tự động không cho thấy vấn đề nào gây cản trở.
  4. Chọn Gửi ứng dụng được kết nối và tiếp tục, hoàn tất thông tin chi tiết về bản phát hành, rồi gửi bản phát hành công khai của ứng dụng trên Play để xem xét và ra mắt.

Sau khi bản phát hành công khai của ứng dụng trên Play được phê duyệt và ra mắt:

  • Ứng dụng Android được kết nối qua MCP sẽ có trong Gemini trên Android cho người dùng ở các quốc gia và ngôn ngữ mà ứng dụng của bạn trên Play nhắm đến.
  • Trên trang quản lý của ứng dụng đã kết nối (Ứng dụng đã kết nối > Quản lý), thẻ Trạng thái ứng dụng đã kết nối sẽ cập nhật thành Đã xuất bản, cho thấy mã phiên bản gói ứng dụng đang hoạt động và ngày xuất bản, đồng thời phiên bản này sẽ xuất hiện trong mục Đã xuất bản trên trang Phiên bản.
  • Để cung cấp các công cụ AppFunctions đã cập nhật sau này, hãy tạo một gói ứng dụng mới có mã phiên bản tăng dần, kiểm thử gói đó bằng kênh kiểm thử và phát hành bản phát hành mới trên Play Công khai. Nếu bạn cũng muốn cập nhật siêu dữ liệu công khai của ứng dụng được kết nối (chẳng hạn như chức năng hoặc câu lệnh mẫu), hãy lưu các nội dung chỉnh sửa đó trong phần Ứng dụng được kết nối > Quản lý > Chi tiết ứng dụng trước khi tải gói ứng dụng mới lên.

Cập nhật gói ứng dụng để điều chỉnh AppFunctions

Nếu muốn lặp lại AppFunctions trong quá trình kiểm thử nội bộ mà không cần tăng mã phiên bản của ứng dụng Android, bạn có thể xoá và loại bỏ một gói ứng dụng nháp chưa phát hành trước khi tải lên lại:

  1. Cập nhật cách triển khai AppFunctions trong dự án Android và tạo một gói ứng dụng .aab mới.
  2. Xoá gói ứng dụng trước đó khỏi mọi bản phát hành nháp mà bạn đã thêm gói ứng dụng đó:
    1. Mở ứng dụng Play được liên kết trong Google Connected Console rồi chọn Thử nghiệm nội bộ (hoặc kênh chứa bản phát hành nháp) trong trình đơn điều hướng bên trái.
    2. Trên bản phát hành nháp, hãy chọn Chỉnh sửa bản phát hành.
    3. Tìm gói ứng dụng, chọn trình đơn có biểu tượng ba dấu chấm (⋮) rồi chọn Xoá gói ứng dụng.
    4. Chọn Lưu dưới dạng bản nháp.
  3. Xoá gói ứng dụng không dùng đến khỏi thư viện:
    1. Trong trình đơn điều hướng bên trái của ứng dụng Play, hãy chọn Bản phát hành và gói mới nhất (nếu bạn không thấy gói đó trong danh sách, hãy chọn Xem tất cả gói ứng dụng).
    2. Mở thông tin chi tiết về gói ứng dụng và nếu có nút Xoá gói ứng dụng, hãy chọn Xoá gói ứng dụng. Thao tác này sẽ giải phóng mã phiên bản để bạn có thể tải gói ứng dụng đã cập nhật lên mà không cần tăng mã phiên bản.
  4. Nếu bạn không thể Xoá gói ứng dụng (ví dụ: vì bản phát hành đã được phát hành lên một kênh), hãy tăng versionCode trong cấu hình bản dựng ứng dụng, tạo một gói ứng dụng mới, rồi tải lên và gửi phiên bản mới như mô tả trong Bước 4.

Khắc phục sự cố liên quan đến AppFunctions

Hãy làm theo hướng dẫn sau để giải quyết các lỗi kiểm tra tự động và các vấn đề thường gặp khi thiết lập.

Giải quyết lỗi kiểm tra tự động trong một bản phát hành

Mọi vấn đề được xác định bằng quy trình kiểm tra AppFunctions tự động đều xuất hiện trên trang chuẩn bị phát hành (chẳng hạn như Tạo bản phát hành thử nghiệm nội bộ) và trong mục Không thành công (có huy hiệu Khắc phục vấn đề để phát hành) trên trang Phiên bản của ứng dụng đã kết nối.

Nếu quy trình kiểm tra tự động báo cáo vấn đề với gói ứng dụng của bạn, hãy thực hiện các bước sau:

  1. Khắc phục các vấn đề cơ bản về AppFunctions trong mã ứng dụng Android và tạo một gói ứng dụng mới.
  2. Nếu bản phát hành trước của bạn vẫn là bản nháp và bạn muốn sử dụng lại cùng một mã phiên bản:
    1. Trong trình đơn điều hướng bên trái của ứng dụng Play, hãy chọn Thử nghiệm nội bộ (hoặc kênh phát hành có liên quan) rồi chọn Chỉnh sửa bản phát hành trên bản phát hành nháp.
    2. Chọn trình đơn có biểu tượng ba dấu chấm (⋮) bên cạnh gói ứng dụng rồi chọn Xoá gói ứng dụng.
    3. Chọn Lưu dưới dạng bản nháp.
    4. Trong trình đơn điều hướng bên trái, hãy chọn Gói và bản phát hành mới nhất (chọn Xem tất cả gói ứng dụng nếu cần), chọn gói rồi chọn Xoá gói ứng dụng.
    5. Quay lại bản phát hành nháp, tải gói ứng dụng đã sửa lên rồi chọn Gửi ứng dụng đã kết nối và tiếp tục.
  3. Nếu không xoá được gói trước đó, hãy tăng versionCode của gói ứng dụng, tải gói mới lên bản phát hành rồi chọn Gửi ứng dụng đã kết nối và tiếp tục.

Các vấn đề thường gặp về việc thiết lập và tích hợp

Bảng sau đây mô tả các vấn đề thường gặp mà bạn có thể gặp phải trong quá trình thiết lập ứng dụng đã kết nối, tải gói lên hoặc thử nghiệm, cùng với nguyên nhân và cách giải quyết:

Vấn đề Thông báo hoặc dấu hiệu trên bảng điều khiển Nguyên nhân Độ phân giải
Gói ứng dụng được tải lên trước khi tạo hoặc liên kết một ứng dụng được kết nối Trang Bản phát hành có nút Tạo hoặc liên kết ứng dụng được kết nối. .aab đã tải lên có chứa AppFunctions, nhưng ứng dụng trên Play chưa được liên kết với một ứng dụng Android MCP đã kết nối. Hoàn tất Bước 1 đến Bước 3 để tạo một ứng dụng có thể kết nối, chọn Android MCP, liên kết ứng dụng của bạn trên Play và lưu chi tiết ứng dụng. Sau đó, hãy xoá rồi tải lên lại gói ứng dụng hoặc tải một gói mới lên có versionCode tăng dần.
Gói ứng dụng đã tải lên trước khi lưu chi tiết ứng dụng được kết nối Trang Bản phát hành cho thấy chi tiết ứng dụng được kết nối bắt buộc và nút Cung cấp chi tiết ứng dụng được kết nối. Ứng dụng trên Play được liên kết với một ứng dụng Android có thể kết nối tích hợp MCP, nhưng các trường bắt buộc trên trang Chi tiết ứng dụng chưa được lưu trước khi tải gói lên. Chọn Cung cấp thông tin chi tiết về ứng dụng được kết nối (hoặc chuyển đến phần Ứng dụng được kết nối > Quản lý > Thêm thông tin chi tiết về ứng dụng), hoàn tất và lưu tất cả các trường bắt buộc, sau đó xoá và tải gói lên lại hoặc tải một gói mới lên có versionCode tăng dần.
Không chọn được ứng dụng trên Play khi liên kết Ứng dụng Play mục tiêu cho thấy huy hiệu Đã liên kết hoặc không xuất hiện trong hộp thoại Chọn ứng dụng. Mỗi ứng dụng trên Play chỉ có thể được liên kết với một ứng dụng Android MCP đã kết nối, hoặc ứng dụng trên Play chưa được tạo trong tài khoản nhà phát triển này. Kiểm tra các mục hiện có trong phần Ứng dụng đã kết nối để xem liệu một ứng dụng đã kết nối khác có liên kết với ứng dụng của bạn trên Play hay không, hoặc tạo ứng dụng trên Play trong Google Connected Console trước khi liên kết.
Không tạo được ứng dụng đã kết nối Không có lựa chọn tạo ứng dụng có thể kết nối hoặc việc tạo ứng dụng có thể kết nối sẽ hiển thị cảnh báo về quyền hoặc Điều khoản dịch vụ. Tài khoản người dùng của bạn không có quyền đối với các ứng dụng có thể kết nối hoặc chủ sở hữu hay quản trị viên tài khoản chưa chấp nhận Điều khoản dịch vụ của các ứng dụng có thể kết nối. Hãy yêu cầu chủ sở hữu tài khoản hoặc quản trị viên chấp nhận Điều khoản dịch vụ của các ứng dụng có thể kết nối và cấp cho tài khoản của bạn quyền Xem các ứng dụng có thể kết nối hoặc Tạo và quản lý các ứng dụng có thể kết nối trên trang Người dùng và quyền.
Phiên bản ứng dụng được kết nối bị kẹt ở trạng thái "Đang chờ gửi" Trên trang Ứng dụng đã kết nối > Quản lý > Phiên bản, phiên bản gói của bạn sẽ xuất hiện trong phần Đang chờ gửi thay vì Người thử nghiệm có thể dùng. Google Connected Console đã phát hiện thấy AppFunctions trong gói bạn tải lên, nhưng phiên bản ứng dụng được kết nối chưa được gửi từ trang phát hành. Mở bản phát hành ứng dụng trên Play có chứa gói đó rồi chọn Gửi ứng dụng được kết nối và tiếp tục để người thử nghiệm có thể xem trước.
Ví dụ về lỗi xác thực câu lệnh trên trang thông tin chi tiết ứng dụng Không lưu được biểu mẫu Thẻ ứng dụng công khai và có lỗi trong phần Câu lệnh mẫu. Câu lệnh không đáp ứng quy tắc định dạng hoặc quy tắc đề cập, hoặc Tên ứng dụng đã được chỉnh sửa sau khi viết câu lệnh. Cung cấp tổng cộng từ 3 đến 4 câu lệnh: bắt đầu ít nhất 2 câu lệnh bằng @<YourAppName>, đề cập đến <YourAppName> một cách tự nhiên mà không có @ trong ít nhất một câu lệnh và xoá tiền tố được đánh số (1., 2.) hoặc dấu ngoặc kép xung quanh ("...").
Người thử nghiệm không nhìn thấy ứng dụng được kết nối trong Gemini trên Android Người thử nghiệm không thể tìm thấy ứng dụng đã kết nối trong phần Ứng dụng đã kết nối hoặc bằng cách dùng lệnh đề cập @ trong ứng dụng Gemini dành cho Android. Quá trình truyền tải vẫn đang diễn ra, tài khoản người thử nghiệm không đủ điều kiện hoặc phiên bản ứng dụng cần cài đặt không khớp. Chờ khoảng 20 phút sau khi gửi (và tối đa 10 phút sau khi lưu người thử nghiệm). Xác nhận rằng người kiểm thử sử dụng một tài khoản @gmail.com cá nhân trong danh sách email đã lưu, sử dụng điện thoại hoặc máy tính bảng Android và đã cài đặt đúng phiên bản gói ứng dụng được gửi.