Esta página foi traduzida pela API Cloud Translation.

Criar Ações no app

As Ações no app permitem que os usuários iniciem funcionalidades no seu app Android pedindo Google Assistente ou usando os atalhos do Android sugeridos pelo Assistente. Esses são as principais etapas para ampliar seu app Android com as Ações no app:

Identifique o recurso do app a ser acionado e a intent integrada (BII) correspondente.
Forneça detalhes de fulfillment para a BII.
Envie atalhos da Ação do app ao Google Assistente.
Teste uma prévia das Ações no app em um dispositivo.
Crie uma versão de teste do app.
Solicite a análise e implantação das Ações no app.

Também é possível definir atalhos dinâmicos que serão fornecidos ao Google Assistente para que ele possa sugeri-las aos seus usuários. Para criar uma Ação no app de exemplo, seguindo o codelab de Ações no app.

Requisitos

Antes de começar a desenvolver Ações no app, você e seu aplicativo precisam atender aos requisitos a seguir:

Você precisa ter uma Conta do Google com acesso ao Google Play Console:
Seu aplicativo precisa ser publicado na Google Play Store, porque as Ações no app são disponível apenas para apps publicados lá. Além disso, confira se o app está Esse recurso não deve ser usado em um perfil de trabalho porque as Ações no app não são compatíveis. pelo Google Play gerenciado.
Você precisa de um dispositivo físico ou virtual para testar as Ações no app.
Você precisa da versão mais recente do Android Studio.
Você precisa usar a mesma Conta do Google para fazer login no Android Studio, o Google app no dispositivo de teste e o Google Play Console.
Você precisa configurar o Google Assistente no seu dispositivo de teste e testá-lo executando uma tocar e Mantenha o botão home pressionado.

Combinar intents integradas com a funcionalidade do app

Identificar a funcionalidade do seu app Android que os usuários podem querer fazer uma solicitação falada e analisar o referência de intents integradas para encontrar BIIs apropriadas para seus casos de uso. As BIIs modelam consultas de usuários para as tarefas que eles querem Portanto, procure BIIs que correspondam às principais funcionalidades e e fluxo em seu app.

Existem BIIs comuns que quase todos os apps Android podem usar, como ampliar sua pesquisa no app para o Google Assistente com actions.intent.GET_THING BII ou permitir que os usuários iniciem recursos específicos do app com a voz implementar a BII actions.intent.OPEN_APP_FEATURE.

Também há BIIs que permitem casos de uso para indústrias ou específicos para cada categoria. Para Por exemplo, um app de pedidos de comida pode usar a classe actions.intent.ORDER_MENU_ITEM BII

Para garantir uma ótima experiência do usuário e evitar possíveis atrasos na aprovação, faça Verifique se cada BII implementada é relevante para a funcionalidade do seu app.

As Ações no app funcionam iniciando intents do Android pelo app Google Assistente para realizar os usuários diretamente para conteúdos específicos no app. Você pode definir intents para iniciar uma atividade explicitamente, especificando targetClass e targetPackage. Se o app já implementa URLs de link direto do Android, você pode configurar a intent para usar um link direto para o fulfillment. Para mais detalhes, consulte a seção Testar sua atividade em detalhes links.

Fornecer detalhes de fulfillment para intents integradas

A maior parte da criação de Ação no app é declarar um recurso no shortcuts.xml do seu app Android em que você especifique a BII selecionada e o fulfillment correspondente. Uma BII modela a consulta do usuário para uma tarefa e uma intent de fulfillment fornece ao Google Assistente informações sobre como executar a tarefa.

No arquivo shortcuts.xml, as BIIs são representadas como <capability> Elementos, e cada fulfillment é representado como um elemento <intent>:

<shortcuts>
    <capability android:name="actions.intent.ORDER_MENU_ITEM">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="menuItem.name"
                android:key="query">
            </parameter>
        </intent>
    </capability>

Para a maioria das BIIs, extraia parâmetros de intent da consulta do usuário com base em entidades do schema.org (link em inglês). Depois, o app vai usar essas BII. para direcionar os usuários ao recurso selecionado. Por exemplo, o anteriores o código mapeia o parâmetro de BII menuItem.name para o intent do Android query .

Se você estiver executando ações usando links diretos, use o campo urlTemplate para definir o URL do link direto gerado pelo Google Assistente:

<shortcuts>
    <capability android:name="actions.intent.ORDER_MENU_ITEM">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myfoodapp://browse{?query}" />
            <parameter android:name="menuItem.name"
                android:key="query"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

Dica:quando seu app fornece várias intents para atender a uma única BII, o Google Assistente tenta resolver os erros na ordem em que aparecem na capability.

Para conferir detalhes importantes sobre como adicionar Ações no app ao arquivo shortcuts.xml, consulte Criar shortcuts.xml. Essa página também descreve como especificar os valores de parâmetro esperados pelo aplicativo.

Implementar a intent integrada GET_THING

Se o app tiver uma função de pesquisa, será necessário implementar a BII actions.intent.GET_THING para essa função. O Google Assistente pode encaminhar os usuários à função de pesquisa do seu app para encontrar resultados no app quando fizerem consultas. como "Ok Google, pesquise por exemplo de coisa no app de exemplo".

No arquivo shortcuts.xml, implemente um <capability> para a BII actions.intent.GET_THING como você implemente qualquer outra BII. É possível usar vários fulfillments GET_THING desde que você forneça pelo menos um fulfillment que transmita o usuário consulta para a função de pesquisa do seu app.

Confira um exemplo de como adicionar a BII actions.intent.GET_THING em shortcuts.xml:

  <capability android:name="actions.intent.GET_THING">
    <intent
      android:targetPackage="com.example.myapp"
      android:targetClass="com.example.myapp.MySearchActivity">
      <parameter android:name="thing.name" android:key="query" />
    </intent>
  </capability>

Na sua pesquisa Activity, extraia a consulta de pesquisa dos dados extras da intent e a transmita para a função de pesquisa do app. No código anterior, o consulta de pesquisa, transmitida como a chave query, é mapeada para o "thing.name" Parâmetro de BII. Em seguida, faça uma pesquisa com a consulta e mostre os resultados na interface do usuário.

Opcional: enviar atalhos da Ação no app ao Google Assistente

Depois de definir uma capacidade para sua ação, os usuários podem iniciar o Diga algo como "Ok Google, peça uma pizza no app de exemplo". O Google Assistente pode sugerir atalhos do Android para suas ações aos usuários em situações relevantes. vezes, permitindo que descubram e repitam suas ações. O Google Assistente pode sugerir atalhos dinâmicos e estáticos.

Para enviar atalhos dinâmicos ao Google Assistente, use a integração do Google Shortcuts biblioteca. Essa biblioteca do Jetpack permite que o Google Assistente use seus atalhos e sugeri-las aos usuários no momento apropriado.

Confira mais detalhes em Enviar atalhos dinâmicos ao Google Assistente.

Ver uma prévia das Ações no app

Durante o desenvolvimento e os testes, use o Plug-in do Google Assistente para o Android Studio testar se As Ações no app funcionam com seu app. O plug-in cria uma prévia das Ações no app no Assistente para sua Conta do Google. Com a ferramenta de teste, é possível testar os fulfillments em um dispositivo de teste físico ou um emulador, fornecendo BIIs com os parâmetros de entrada que você espera receber dos usuários.

Ao visualizar as Ações no app, você pode acionar consultas por voz no dispositivo. Essa função está disponível apenas para consultas listadas na referência de BIIs das Ações no app. Usar voz acionando apenas para demonstração, não para testes regulares.

Testar o app no modo rascunho usando as ferramentas para desenvolvedores do Google Play Console antes de enviar o app para revisão. Para mais informações sobre como usar o Google Play Console para implantar um rascunho do app, consulte Preparar e lançar um lançamento.

Criar uma versão de teste

Quando estiver tudo pronto para testar as Ações no app com outros testadores, criar uma versão de teste interna ou fechada do seu app. Por padrão, seus recursos internos e os testadores da versão fechada podem acessar Ações no app que já foram analisados e aprovados.

Para conceder acesso de teste a todas as Ações no app, incluindo ações não aprovadas, instrua os testadores a participar do Grupo do Google do Programa de desenvolvimento de Ações no app. Participantes desta têm acesso a todas as Ações no app em grupos fechados e versões de teste interno sem precisar criar visualizações usando a ferramenta de teste de ações no app. A ativação pode levar até três horas após a entrada no grupo para que o acesso seja disponibilizado.

Solicitar a análise e implantação das Ações no app

As Ações no app não estão disponíveis para os usuários dos seus apps publicados ou de testes abertos lançamentos até que sejam revisados e aprovados. A análise de Ações no app não afetam a revisão e o status da implantação do app Android no Google Play. Mesmo que o envio do app for aprovado e publicado na Play Store, o shortcuts.xml pode estar em revisão pelo Google. As Ações no app não funcionam para sua usuários finais até que essa análise também seja aprovada.

Quando você implanta o app, as Ações no app continuam ativadas. No entanto, as versões reimplantadas estão sujeitas a análise pelo Google. Se a nova versão não funcionar corretamente ou incluir violações da política, o Google se reserva o direito de desativar as Ações no app.

Para enviar suas Ações no app para análise, faça o seguinte:

Aceitar os Termos de Serviço das Ações no app no Google Play Console (Configurações avançadas > Ações no app):
Faça o upload do seu app, contendo shortcuts.xml, para o Google Play Console normalmente para publicação.
Depois de fazer upload do app para o Play Console, o Google entra em contato com você pelo e-mail na sua conta do Play Console com mais informações sobre o status do seu app Revisão das ações. Você também pode entrar em contato com o suporte ao desenvolvedor do Google Assistente com perguntas sobre o status da revisão das Ações no app. No contato formulário, forneça o ID do pacote do app e escolha Revisão das Ações no app no Como podemos ajudar você?.

Opcional: testar os links diretos da sua atividade

Para usar um link direto para iniciar uma Activity usando uma Ação no app, o Activity precisa ser configurado com URLs de link direto e ter um filtro de intent correspondente em o manifesto do app Android.

Para testar se as atividades são acessíveis e podem ser acionadas usando Ações no app que usam links diretos, execute o seguinte comando adb:

$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"

Exemplo:

$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"

Se a atividade não for iniciada corretamente com o comando adb, confira o seguinte:

No arquivo de manifesto do app, a atividade tem android:exported=true. Por isso, ela pode ser iniciado usando intents do Google Assistente.
Se você usa URLs de links do app, siga todas as etapas em Como processar Links do app Android.

Políticas de Ações no app

As Ações no app precisam obedecer a políticas específicas para garantir que os usuários que acioná-los a receber a experiência pretendida. Revise essas políticas antes enviar seus apps para oferecer a melhor experiência do usuário e evitar o uso do Google Play Atrasos ou rejeições da loja

Direcionar usuários para o conteúdo pretendido

As intents integradas (BIIs) e/ou parâmetros de Ações no app só podem direcionar os usuários para a ação relevante e pretendida pelo usuário. Isso pode incluir conteúdo no app, conteúdo do site ou informações mostradas em frações ou widgets, desde que o experiência era pretendida pelo usuário.

Por exemplo, as implementações da BII ORDER_MENU_ITEM ajudam os usuários inicia um pedido para o item de menu ou tipo de culinária especificado. O único exceção a essa política é quando a BII do OPEN_APP_FEATURE direciona os usuários na tela inicial do seu app.
Direcionar usuários para conteúdo relevante da Web

Se os usuários forem redirecionados para o conteúdo de uma página da Web, o site deverá ser relevante para a ação pretendida pelo usuário e pertence à marca.

Por exemplo, redirecionar os usuários que acionam Sua BII do GET_RESERVATION para google.com/travel, que não pertence a a marca do seu app exampledomain.com, é uma violação. Outro exemplo de uma violação está redirecionando os usuários que acionam sua BII do GET_CALL_HISTORY para exampledomain.com/payment e exigir que ela faça uma compra.
Implementar BIIs relevantes de Ações no app

As BIIs implementadas precisam estar diretamente relacionadas ao conteúdo do app. funcionalidade de armazenamento.

Por exemplo, se o app estiver na categoria "Comunicações" da Play Store, não implemente a BII ORDER_MENU_ITEM, que é recomendado para apps na categoria "Comidas e bebidas".
Implementar intents personalizadas relevantes

Consultas definidas para intents personalizadas estão relacionadas ao conteúdo do app e funcionalidade de armazenamento. Um exemplo de possível violação desta é criar a intent custom.action.intent.GET_RECIPE com a padrão de consulta associado "Mostrar receitas de burrito" para um app na Categoria Transporte na Play Store.