O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Criar e gerenciar apps conectados usando AppFunctions e MCP do Android no Google Connected Console

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 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 da conta ou administrador 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 do MCP para 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 no Google Play e a segmentação por país determinam onde o app conectado ao MCP para Android está disponível.
Um Android App Bundle (.aab) com AppFunctions implementadas:
- Configure o pacote de apps para dispositivos móveis Android, que é a plataforma compatível com a integração do app 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 app conectado que aparece para os usuários nos produtos do Google e é usado quando eles 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 seu 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 perguntar.
- 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 ao MCP do 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 vincular ao 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 Selecionar uma categoria de app conectado, escolha o domínio, a categoria ou o setor do seu app no menu Selecionar uma categoria.

Observação: a categoria do app conectado define os requisitos básicos de capacidade e não pode ser mudada depois. Para usar uma categoria diferente depois, você precisa criar um novo app conectado.
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 Play Console. Por enquanto, só é possível escolher um tipo de conexão por app conectado, e não é possível mudar isso 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, onde você pode continuar configurando os detalhes do app, acompanhar as versões dele e gerenciar os testadores.

Etapa 2: informar os detalhes do app conectado

Antes de fazer upload de pacotes de apps que contenham 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 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 é exibido 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 uma capacidade 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. 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 <YourAppName> de forma natural em pelo menos um comando sem começar com o nome do app (por exemplo, Track my recent order on Order Tracker).
  - Não inclua prefixos numerados (1., 2., 3.) nem coloque os comandos entre aspas ("...").
- 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:// ou http:// válido para seus Termos de Serviço.
- URL da política: insira um link https:// ou http:// 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 no 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 do Android em Fazer upload de um pacote de app que contém suas AppFunctions, selecione Fazer upload do pacote de app 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 .aab com as AppFunctions ou selecione Adicionar da biblioteca se você tiver feito o 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 ao AppFunctions antes de continuar.
Na parte de baixo da página da versão, selecione Enviar app conectado e continuar.

Selecione Enviar app conectado e continuar para enviar sua versão do AppFunctions ao Gemini para testes de pré-lançamento e avançar sua versão do Google Play para a página de pré-lançamento. Se você quiser iterar em AppFunctions usando builds locais sem incrementar o código da 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 do app 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 que você adicionar à lista de testadores poderão ver e interagir com o app conectado não publicado. Só é possível adicionar testadores com uma conta do @gmail.com.

Na página de visão geral do app conectado, no card Testar seu 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. Inclua seu próprio endereço de e-mail se quiser testar o app.
Selecione Salvar.

Observação: depois que você adicionar testadores, pode levar até 10 minutos para que o app conectado fique visível para essas contas.
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 acessar e conectar seu app no Gemini em 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 em um smartphone ou tablet Android usando uma Conta do Google incluída na lista de e-mails configurada na Etapa 5.
Executar o build exato do app Android com o código de versão do pacote correspondente à versão enviada na Etapa 4.

Recomendamos testar sua integração de forma completa:

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 da ferramenta, as solicitações de confirmação e a execução de ponta a ponta nas suas AppFunctions.

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 ao MCP do Android não requer uma ação separada de revisão ou publicação 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 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 sua 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 Funcionalidades foram detectadas no seu pacote de app para confirmar a versão do app conectado, a contagem de ferramentas, a contagem 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 exemplos de comandos), salve essas edições em Apps conectados > Gerenciar > Detalhes do app antes de fazer upload do novo pacote de app.

Atualize seu pacote de apps para ajustar as AppFunctions

Se você quiser iterar nas AppFunctions durante os 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 projeto do Android e gere um novo pacote de app .aab.
Remova o pacote de app anterior de todas as versões de rascunho em que ele foi adicionado:
1. Abra o app do Google Play vinculado no Google Connected Console e selecione Teste interno (ou a faixa que contém sua versão de rascunho) no menu de navegação à esquerda.
2. Na versão de rascunho, selecione Editar versão.
3. Localize o pacote de app, selecione o menu de três pontos (⋮) e escolha Remover pacote de app.
4. Selecione Salvar como rascunho.
Exclua o pacote de app não utilizado da sua biblioteca:
1. 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.
2. 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 versionCode na 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 4.

Resolver problemas relacionados às 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 automatizadas do 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:
1. 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.
2. Selecione o menu de três pontos (⋮) ao lado do pacote de app e selecione Remover pacote de app.
3. Selecione Salvar como rascunho.
4. 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.
5. Volte para a versão de rascunho, faça upload do pacote de app corrigido e selecione Enviar app conectado e continuar.
Se não for possível excluir o pacote anterior, incremente o versionCode do pacote de apps, 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 um app conectado.	O `.aab` enviado contém AppFunctions, mas o app do Google Play ainda não está vinculado a um app conectado ao MCP do Android.	Conclua 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 faça upload do pacote de app novamente ou envie um novo pacote com um `versionCode` incrementado.
Pacote de app enviado antes de salvar os detalhes do app conectado	A página de lançamento mostra Detalhes do app conectado necessários e um botão Fornecer detalhes do app conectado.	O app do Google Play está vinculado a um app Android conectado ao MCP, 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 faça upload do pacote novamente ou faça upload de um novo pacote com um `versionCode` incrementado.
Não é possível selecionar o app do Google Play ao vincular	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 MCP para Android, ou o app do Google Play ainda não foi criado nesta conta de desenvolvedor.	Confira as entradas em Apps conectados para ver se outro app já está vinculado ao seu app do Google Play ou crie o app do Google Play no 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 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 da conta ou administrador aceitar os Termos de Serviço dos Apps Conectados e conceder à sua conta a permissão 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	O formulário do card de app público não pode ser salvo e mostra um erro em Exemplos de comandos.	Os comandos não atendem às regras de formatação ou menção, ou o nome do app foi editado depois que os comandos foram escritos.	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 do 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 depois de salvar os testadores). Confirme se o testador usa uma conta pessoal do `@gmail.com` na lista de e-mails salvos, um smartphone ou tablet Android e instalou a versão exata do pacote enviado.