Use o Google Connected Console para integrar as AppFunctions no dispositivo do seu app Android com o Gemini no Android. Ao criar um app conectado com o tipo de conexão MCP do Android e vinculá-lo ao seu app do Google Play, você permite que o Gemini no Android acione ações e conclua tarefas diretamente no seu app em nome dos usuários.
Este guia mostra o fluxo de trabalho de autoatendimento completo no Google Connected Console, incluindo a criação de apps conectados, a vinculação de apps do Google Play, a configuração de cards de apps públicos, o upload e o envio de pacotes de apps, o teste de pré-lançamento no dispositivo e a publicação em produção.
Pré-requisitos
Antes de começar, verifique se você tem:
- Acesso à prévia para desenvolvedores da Connected Apps Platform: você precisa de acesso à prévia para desenvolvedores para criar apps conectados e testá-los com o Gemini. Para solicitar acesso, inscreva-se no pré-lançamento.
- Acesso a uma conta de desenvolvedor registrada no
Google Connected Console:
- Aceitação dos Termos de Serviço: na primeira vez que sua organização acessar os Apps Conectados no Google Connected Console, um proprietário ou administrador da conta precisará analisar e aceitar os Termos de Serviço dos Apps Conectados antes que os membros da equipe possam criar Apps Conectados.
- Permissões do usuário: se você recebeu um convite para uma conta de desenvolvedor do Connected Console, mas não consegue criar apps conectados, peça ao proprietário da conta ou administrador para conceder a permissão Ver apps conectados ou Criar e gerenciar apps conectados na página Usuários e permissões. Você também precisa de permissões de gerenciamento de versões para o app do Google Play relevante para fazer upload de pacotes de apps e gerenciar versões.
- Um app do Google Play na sua conta do Google Connected Console:
- O app do Google Play precisa estar na mesma conta de desenvolvedor para que você possa vinculá-lo ao app conectado. Cada app do Google Play só pode ser vinculado a um único app conectado ao MCP do Android.
- Verifique se o app do Google Play tem uma página de detalhes padrão configurada com um ícone e idiomas compatíveis. Os idiomas da página "Detalhes do app" do Google Play e a segmentação por país determinam onde o app conectado MCP para Android está disponível.
- Um Android App Bundle (
.aab) com AppFunctions implementadas:- Configure o pacote de apps para segmentar dispositivos móveis Android, que é a plataforma compatível com a integração do app do Gemini no dispositivo.
- Categoria do app conectado e metadados públicos: prepare os recursos
e detalhes que compõem a presença pública do seu app conectado:
- Categoria do app conectado: o domínio ou a categoria de setor do seu app conectado. Cada categoria define os requisitos de capacidade de referência e não pode ser alterada após a criação.
- Nome do app: o nome de exibição do seu app conectado que aparece para os usuários
nos produtos do Google e é usado quando os usuários mencionam seu app com
@no Gemini. - Ícone do app conectado: um ícone de 512 px x 512 px no formato JPEG ou PNG, com tamanho máximo de 1 MB (1.024 KB).
- Descrição do app: um resumo conciso que descreve o que o app conectado pode fazer pelos usuários.
- Recursos do app: pelo menos três recursos personalizados que mostram aos usuários o que o app pode fazer ao decidir se conectar, além de qualquer recurso padrão definido pela categoria do app.
- Exemplos de comandos: pelo menos três exemplos de comandos que ensinam os usuários a invocar seu app no Gemini e os ajudam a entender o que podem pedir.
- URL da política: um URL de acesso público para sua Política de Privacidade.
- URL dos Termos de Serviço: um URL de acesso público para seus Termos de Serviço.
- URL do site (opcional): um URL acessível publicamente que aponta para seu site para atribuição.
Registrar, testar e publicar AppFunctions com o Gemini
Depois de atender aos pré-requisitos, siga as etapas abaixo para registrar seu app conectado do MCP para Android, vincular seu app do Google Play, preencher os detalhes do app, fazer upload e enviar suas AppFunctions, testar no dispositivo e publicar na produção.
Etapa 1: criar um app conectado ao MCP do Android e vinculá-lo ao seu app do Google Play
Para criar um app conectado e vinculá-lo ao seu app do Google Play, siga estas etapas:
- Faça login no Google Connected Console.
- Na página Início, selecione Criar app.
- Na caixa de diálogo Escolher o que criar:
- Se for solicitado que você aceite os Termos de Serviço de apps conectados, selecione Ver termos, leia e aceite o contrato e selecione Criar. Somente um administrador da conta pode aceitar o contrato.
- Caso contrário, selecione Criar no card App conectado.
- Na caixa de diálogo Dê um nome ao seu app conectado, digite um nome para o
app. Esse é o nome que vai aparecer nos
produtos do Google e que os usuários vão usar para mencionar o app com
@. Selecione Próxima. Na caixa de diálogo Selecione uma categoria de app conectado, escolha o domínio, a categoria ou o setor do seu app no menu Selecione uma categoria.
Na caixa de diálogo Escolher tipo de conexão, selecione MCP do Android.
Para um tutorial detalhado sobre como configurar um app conectado ao servidor MCP, consulte o guia de integração do Google Connected Console. Por enquanto, só é possível escolher um tipo de conexão por app conectado, e isso não pode ser modificado depois.
Selecione Criar app conectado.
Na caixa de diálogo Selecionar app, encontre o app do Google Play que contém (ou vai conter) suas AppFunctions e selecione-o. É possível filtrar a lista usando a pesquisa.
- Não é possível selecionar apps do Google Play que já estão vinculados a outro app conectado.
- Selecione o app do Google Play que você quer vincular. Depois de selecionar um app do Google Play, não é possível mudar.
Isso abre a página de visão geral do gerenciamento do app conectado, em que é possível continuar configurando os detalhes do app, acompanhar as versões dele e gerenciar testadores.
Etapa 2: informar os detalhes do app conectado
Antes de fazer upload de pacotes de apps que contêm AppFunctions, configure como seu app conectado aparece para os usuários no Gemini.
Siga estas etapas para fornecer os detalhes do app conectado:
- Na página de gerenciamento do app conectado, no card MCP do Android, em Adicionar detalhes do app conectado, selecione Adicionar detalhes do app (ou Gerenciar se estiver atualizando os detalhes atuais).
- Na parte de cima da página Detalhes do app, verifique o campo Nome do app conectado. Você pode atualizar o nome, se necessário. Ele é mostrado aos usuários nos
produtos do Google e usado quando eles mencionam seu app com
@. - Na seção Detalhes públicos, em Ícone, faça upload do ícone do app (JPG ou PNG, até 1 MB e 512 px x 512 px).
Preencha os seguintes campos:
- Descrição: insira um resumo conciso de uma única frase (menos de 30 palavras) descrevendo os principais recursos do seu app conectado e o que ele pode fazer. Esse texto é mostrado aos usuários e não é usado como instruções do modelo.
- Recursos: insira pelo menos três tarefas de alto valor que seu app conectado pode realizar. Selecione Adicionar recurso para adicionar mais entradas. Não inclua números no início das suas capacidades. Inclua apenas um recurso por entrada. Se a categoria do app conectado incluir recursos predefinidos, eles vão aparecer na parte de cima da lista e não poderão ser modificados.
- Exemplos de comandos: insira pelo menos três exemplos de comandos que ajudem
os usuários a entender o que podem pedir ou perguntar. Selecione Adicionar comando de exemplo para
adicionar entradas.
- Comece pelo menos dois comandos com
@<YourAppName>(por exemplo,@Order Tracker where is my last order?). - Mencione o app
<YourAppName>de forma natural em pelo menos um comando sem começar com o nome dele (por exemplo,Track my recent order on Order Tracker). - Não inclua prefixos numerados (
1.,2.,3.) nem coloque os comandos entre aspas ("...").
- Comece pelo menos dois comandos com
Localização em vários idiomas: para fornecer traduções para Descrição, Recursos e Exemplos de comandos, envolva o texto de cada localidade em tags de idioma no campo de entrada. Exemplo:
<en-US> Play music, manage playlists, and discover artists </en-US> <es-ES> Reproduce música, gestiona listas y descubre artistas </es-ES>O Connected Console valida automaticamente suas tags e mostra as localidades detectadas em cada campo (por exemplo,
Found translations for 2 languages: en-US, es-ES).URL dos Termos de Serviço: insira um link
https://ouhttp://válido para seus Termos de Serviço.URL da política: insira um link
https://ouhttp://válido para sua Política de Privacidade.URL do site (opcional): insira um link para seu site para fins de atribuição.
Etapa 3: fazer upload de um pacote de app com suas AppFunctions e enviar o app conectado
Depois de salvar os detalhes do app conectado, faça upload de um Android App Bundle com suas AppFunctions para o app vinculado do Google Play e envie a versão do app conectado para teste.
Para fazer upload de um pacote de app que contenha suas AppFunctions, siga estas etapas:
- Na página de gerenciamento do app conectado, no card MCP para Android em Fazer upload de um pacote de app que contenha suas AppFunctions, selecione Enviar aplicativo para acessar a visão geral de Testar e lançar do app vinculado do Google Play.
- Como alternativa, abra o app do Google Play vinculado diretamente no Google Connected Console. No menu de navegação à esquerda do app do Google Play, acesse Teste > Teste interno (ou outra faixa de teste) e selecione Criar nova versão (ou Editar versão se você já tiver uma versão de rascunho).
- Em Pacotes de apps, selecione Fazer upload para enviar o pacote
.aabcom AppFunctions ou selecione Adicionar da biblioteca se você tiver feito upload do pacote depois de concluir a Etapa 2. - Quando o upload terminar, acesse a seção Funcionalidades foram detectadas no seu pacote de app na página da versão. Confirme se o nome do app conectado, o código da versão do pacote, a contagem de ferramentas detectadas, a contagem de idiomas e a segmentação por país do app do Google Play aparecem como esperado e verifique se as verificações automatizadas não relatam problemas. Se houver erros de validação, siga as instruções em Resolver problemas relacionados às AppFunctions antes de continuar.
- Na parte de baixo da página da versão, selecione Enviar app conectado e continuar.
Ao selecionar Enviar app conectado e continuar, sua versão do AppFunctions é enviada ao Gemini para testes de pré-lançamento, e sua versão do Google Play é encaminhada para a página de pré-lançamento. Se você quiser iterar em AppFunctions usando builds locais sem incrementar o código de versão do pacote de apps, deixe a versão do Google Play em estado de rascunho e não selecione Salvar e publicar. A publicação de uma versão do Google Play bloqueia o código da versão do pacote para que ele não possa mais ser excluído e reenviado. Qualquer mudança posterior exige um código de versão incrementado do pacote de app. Se os testadores instalarem o app diretamente da faixa de teste interno do Google Play, em vez de fazer o sideload, conclua o lançamento do teste interno e incremente o código da versão em uploads futuros.
Etapa 4: verificar a versão do app conectado
Depois de enviar o app conectado pela página de lançamento do Google Play, verifique se a versão dele está pronta para pré-lançamento:
- Na página de gerenciamento do app conectado, no card MCP do Android, ao lado de Versões, selecione Ver.
- Na página Versões, confirme se a versão enviada aparece na seção
Disponível para testadores (exibindo
Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>).- Selecione Visualizar em qualquer linha de versão para inspecionar as AppFunctions detectadas e o snapshot somente leitura de Detalhes do app capturado para essa versão.
- As versões criadas de um pacote de app enviado em que você ainda não selecionou Enviar app conectado e continuar aparecem em Envio pendente.
Etapa 5: testar o app conectado
Para disponibilizar seu app conectado aos testadores, adicione-os na página
Gerenciar testadores. Somente os usuários adicionados à lista de testadores podem ver e
interagir com o app conectado não publicado. Só é possível adicionar testadores com uma
conta do @gmail.com.
A faixa de teste do seu app do Google Play tem uma lista própria de testadores, que controla quem pode instalar a versão de teste do Google Play. Use os mesmos testadores para o app conectado e para a faixa de teste que contém sua versão.
- Na página de visão geral do app conectado, no card Testar o app, selecione Adicionar testadores (ou Gerenciar testadores, se você já tiver adicionado alguns).
- Na página Gerenciar testadores, selecione as listas de e-mails atuais ou Criar lista de e-mails para adicionar as Contas do Google autorizadas a testar sua integração. Se você também quiser testar o app, adicione seu próprio endereço de e-mail.
Selecione Salvar.
No app do Google Play vinculado, acesse a faixa de teste que contém sua versão (por exemplo, Teste > Teste interno), selecione a guia Testadores e escolha as mesmas listas de e-mails.
Os testadores no app do Gemini podem invocar seu app conectado digitando
@seguido do nome do app e selecionando-o no menu. Você também pode ver e conectar seu app no Gemini acessando Configurações e ajuda > Apps conectados na barra de navegação à esquerda.
Antes de testar no dispositivo, confirme se cada testador atende aos seguintes requisitos:
- Fazer login no app do Gemini em um smartphone ou tablet Android usando uma Conta do Google na lista de testadores do app conectado.
- Executar o build exato do app Android com o código de versão do pacote correspondente à versão enviada na Etapa 3.
Recomendamos testar sua integração:
- Teste todos os exemplos de comandos.
- Teste as invocações explícitas de
@<AppName>e as consultas em linguagem natural. - Verifique a manipulação dos parâmetros, as solicitações de confirmação e a execução de ponta a ponta nas AppFunctions de leitura e de mudança de estado. Depois de executar um comando de mudança de estado, abra o app para confirmar se a mudança aparece na interface.
Quando estiver tudo pronto, envie o app conectado ao Google para análise.
Etapa 6: publicar o app conectado para os usuários
Ao contrário das integrações do MCP hospedadas em servidor, um app conectado do MCP para Android não exige uma ação de revisão ou publicação separada na página de gerenciamento de apps conectados. Em vez disso, a versão do app conectado é revisada pelo Google e publicada automaticamente quando você lança a versão do app do Google Play que contém o pacote de app das AppFunctions para produção.
Quando você concluir os testes e estiver tudo pronto para o lançamento aos usuários:
- No Google Connected Console, abra o app do Google Play vinculado e acesse Versão > Produção no menu de navegação à esquerda (ou promova a versão testada de uma faixa de teste para Produção).
- Selecione Criar nova versão (ou edite uma versão de produção de rascunho) e adicione o pacote de app com as AppFunctions verificadas usando Adicionar da biblioteca ou Fazer upload.
- Acesse a seção Foram detectadas AppFunctions no seu pacote de app para confirmar a versão do app conectado, o número de ferramentas, o número de idiomas da página "Detalhes do app" e a segmentação por país do app do Google Play. Além disso, verifique se as verificações automatizadas não mostram problemas de bloqueio.
- Selecione Enviar app conectado e continuar, preencha os detalhes da versão e envie a versão de produção do app do Google Play para revisão e lançamento.
Depois que a versão de produção do app do Google Play for aprovada e lançada:
- Seu app conectado ao MCP do Android fica disponível no Gemini no Android para usuários nos países e idiomas de segmentação do seu app do Google Play.
- Na página de gerenciamento do app conectado (Apps conectados > Gerenciar), o card Status do app conectado é atualizado para Publicado, mostrando o código da versão do pacote de app ativo e a data de publicação. A versão aparece em Publicado na página Versões.
- Para enviar ferramentas atualizadas do AppFunctions mais tarde, crie um novo pacote de app com um código de versão incrementado, teste-o usando uma faixa de teste e publique uma nova versão de produção do Google Play. Se você também quiser atualizar os metadados públicos do app conectado (como recursos ou comandos de exemplo), salve essas edições em Apps conectados > Gerenciar > Detalhes do app antes de fazer upload do novo pacote de app.
Atualize o pacote de app para ajustar as AppFunctions
Se você quiser iterar em AppFunctions durante testes internos sem incrementar o código de versão do app Android, remova e exclua um pacote de app de rascunho não publicado antes de fazer o upload novamente:
- Atualize a implementação de AppFunctions no seu projeto do Android e gere
um novo pacote de app
.aab. - Remova o pacote de app anterior de qualquer versão de rascunho em que ele tenha sido adicionado:
- Abra o app do Google Play vinculado no Google Connected Console e selecione Teste interno (ou a faixa que contém a versão de rascunho) no menu de navegação à esquerda.
- Na versão de rascunho, selecione Editar versão.
- Localize o pacote de apps, selecione o menu de três pontos (⋮) e escolha Remover pacote de apps.
- Selecione Salvar como rascunho.
- Exclua o pacote de app não utilizado da sua biblioteca:
- No menu de navegação à esquerda do app do Google Play, selecione Versões e pacotes mais recentes. Se o pacote não estiver listado, selecione Ver todos os pacotes de apps.
- Abra os detalhes do pacote de apps e, se o botão Excluir pacote de apps estiver disponível, selecione Excluir pacote de apps. Isso libera o código da versão para que você possa fazer upload do pacote de app atualizado sem incrementar o código da versão.
- Se a opção Excluir pacote de app não estiver disponível (por exemplo, porque a versão
já foi publicada em uma faixa), incremente o
versionCodena configuração do build do app, gere um novo pacote de app e faça upload e envie a nova versão conforme descrito na Etapa 3.
Resolver problemas relacionados ao AppFunctions
Use as orientações a seguir para resolver erros de verificação automatizada e problemas comuns de configuração.
Resolver erros de verificação automática em uma versão
Os problemas identificados pelas verificações automáticas das AppFunctions aparecem na página de preparação da versão (como Criar versão de teste interno) e na seção Com falha (com um selo Corrigir problemas para publicar) na página Versões do app conectado.
Se as verificações automatizadas relatarem problemas com o pacote de app, siga estas etapas:
- Corrija os problemas das AppFunctions no código do app Android e crie um pacote de app atualizado.
- Se a versão anterior ainda for um rascunho e você quiser reutilizar o mesmo
código de versão:
- No menu de navegação à esquerda do app do Google Play, selecione Teste interno (ou a faixa relevante) e selecione Editar versão na versão de rascunho.
- Selecione o menu de três pontos (⋮) ao lado do pacote de app e selecione Remover pacote de app.
- Selecione Salvar como rascunho.
- No menu de navegação à esquerda, selecione Versões e pacotes mais recentes (selecione Ver todos os pacotes de apps, se necessário), selecione o pacote e selecione Excluir pacote de app.
- Volte para a versão de rascunho, faça upload do pacote de apps corrigido e selecione Enviar app conectado e continuar.
- Se não for possível excluir o pacote anterior, incremente o
versionCodedo pacote de app, faça upload do novo pacote para a versão e selecione Enviar app conectado e continuar.
Problemas comuns de configuração e integração
A tabela a seguir descreve problemas comuns que podem ocorrer durante a configuração do app conectado, o upload do pacote ou o teste, além das causas e soluções:
| Problema | Mensagem ou sintoma do console | Causa | Resolução |
|---|---|---|---|
| Pacote de app enviado antes de criar ou vincular um app conectado | A página de lançamento mostra Criar ou vincular app conectado. | O .aab enviado contém AppFunctions, mas o app do Google Play ainda não está vinculado a um app conectado do MCP para Android. |
Siga as Etapas 1 a 3 para criar um app conectado, selecione Android MCP, vincule seu app do Google Play e salve os Detalhes do app. Em seguida, exclua e reenvie o pacote de app ou faça upload de um novo com um versionCode incrementado. |
| Pacote de app enviado antes de salvar os detalhes do app conectado | A página de lançamento mostra É necessário informar os detalhes do app conectado e um botão Informe detalhes do app conectado. | O app do Google Play está vinculado a um app conectado do MCP para Android, mas os campos obrigatórios na página Detalhes do app não foram salvos antes do upload do pacote. | Selecione Fornecer detalhes do app conectado (ou acesse Apps conectados > Gerenciar > Adicionar detalhes do app), preencha e salve todos os campos obrigatórios e, em seguida, exclua e reenvie o pacote ou faça upload de um novo com um versionCode incrementado. |
| Não é possível selecionar o app do Google Play ao fazer a vinculação | O app de destino do Google Play mostra um selo Já vinculado ou não aparece na caixa de diálogo Selecionar app. | Cada app do Google Play só pode ser vinculado a um app conectado do Android MCP, ou o app do Google Play ainda não foi criado nesta conta de desenvolvedor. | Verifique as entradas em Apps conectados para ver se outro app conectado já está vinculado ao seu app do Google Play ou crie o app do Google Play no Google Connected Console antes de fazer a vinculação. |
| Não é possível criar um app conectado | A opção de criar um app conectado não existe ou, ao criar um app conectado, um aviso de permissões ou dos Termos de Serviço é exibido. | Sua conta de usuário não tem permissões para usar os Apps Conectados, ou um proprietário ou administrador da conta ainda não aceitou os Termos de Serviço dos Apps Conectados. | Peça para um proprietário ou administrador da conta aceitar os Termos de Serviço dos Apps Conectados e conceder à sua conta as permissões Ver apps conectados ou Criar e gerenciar apps conectados na página Usuários e permissões. |
| A versão do app conectado está travada em "Envio pendente" | Em Apps conectados > Gerenciar > Versões, a versão do pacote aparece em Envio pendente em vez de Disponível para testadores. | O Google Connected Console detectou AppFunctions no pacote enviado, mas a versão do app conectado não foi enviada pela página de lançamento. | Abra a versão do app do Google Play que contém esse pacote e selecione Enviar app conectado e continuar para que os testadores possam visualizá-lo. |
| Exemplo de erro de validação de comandos na página de detalhes do app | Não é possível salvar o formulário Card de app público, e um erro é exibido em Exemplos de comandos. | Os comandos não atendem às regras de formatação ou menção, ou o nome do app foi editado após a criação dos comandos. | Envie de três a quatro comandos no total: comece pelo menos dois com @<YourAppName>, mencione <YourAppName> de forma natural sem @ em pelo menos um e remova prefixos numerados (1., 2.) ou aspas ("..."). |
| O app conectado não aparece para os testadores no Gemini para Android | Os testadores não conseguem encontrar o app conectado em Apps conectados ou usando uma menção @ no app Gemini para Android. |
A propagação ainda está em andamento, a conta do testador não está qualificada ou a versão do app instalado não corresponde. | Aguarde cerca de 20 minutos após o envio (e até 10 minutos após salvar os testadores). Confirme se a conta pessoal do @gmail.com do testador está na lista de testadores do app conectado, não apenas na faixa de teste do app do Google Play. Confirme também se o testador usa um smartphone ou tablet com Android e se instalou a versão exata do pacote enviado. |