Bu sayfa, Cloud Translation API ile çevrilmiştir.

Uygulama İşlemleri Oluşturma

Uygulama İşlemleri, kullanıcıların Google Asistan'a sorarak veya Asistan tarafından önerilen Android kısayollarını kullanarak Android uygulamanızda işlevleri başlatmasına olanak tanır. Bu Android uygulamanızı Uygulama İşlemleri ile genişletmenin birincil adımlarıdır:

Tetiklenecek uygulama içi işlevi ve eşleşen yerleşik amacı (BII) tanımlayın.
BII için sipariş karşılama ayrıntılarını girin.
Uygulama işleminizin kısayollarını Asistan'a gönderin.
Uygulama İşlemlerinizi bir test cihazında önizleyin.
Uygulamanızın test sürümünü oluşturun.
Uygulama İşlemleri incelemesi ve dağıtımı isteyin.

İsteğe bağlı olarak, Asistan'a sunulacak dinamik kısayollar tanımlayabilirsiniz. Böylece Asistan, bu kısayolları kullanıcılarınıza önerebilir. Örnek bir uygulama kullanarak Uygulama İşlemi oluşturun: Uygulama İşlemleri codelab'ini inceleyin.

Gereksinimler

Uygulama İşlemleri geliştirmeye başlamadan önce hem sizin hem de uygulamanızın aşağıdaki şartları yerine getirmeniz gerekir:

Google Play Console'a erişimi olan bir Google Hesabınız olmalıdır.
Uygulama İşlemleri şu nedenle Google Play Store'da yayınlanmalıdır: yalnızca burada yayınlanan uygulamalarla kullanılabilir. Ayrıca, uygulamanızın Uygulama İşlemleri desteklenmediğinden, bir iş profilinde kullanılması amaçlanmamıştır Managed Google Play tarafından:
Uygulama İşlemlerinizi test etmek için fiziksel veya sanal bir cihaza ihtiyacınız vardır.
Android Studio'nun en son sürümüne ihtiyacınız var.
Android'de oturum açmak için aynı Google Hesabı'nı kullanmanız gerekir. Studio, test cihazınızdaki Google uygulaması ve Google Play Console.
Asistan'ı test cihazınızda ayarlamanız ve Ana Sayfa düğmesine dokunup basılı tutarak test etmeniz gerekir.

Yerleşik amaçları uygulama işlevselliğiyle eşleştirin

Android uygulamanızda kullanıcıların isteyebilecekleri işlevleri tanımlama bir sonraki aşamaya geçmeli ve uygun BBI'leri bulmak için yerleşik amaç referansı örneklere göz atın. BI'ler, kullanıcıların gerçekleştirmek istedikleri görevler için kullanıcı sorgularını modeller. Bu nedenle, uygulamanızdaki temel işlevler ve kullanıcı akışlarıyla eşleşen BI'leri arayın.

Hemen hemen her Android uygulamasının kullanabileceği yaygın BBI'ler vardır. Örneğin, actions.intent.GET_THING ile uygulama içi aramanızı Asistan'a gönderin BII veya kullanıcıların belirli uygulama özelliklerini sesleriyle başlatmalarına izin verme actions.intent.OPEN_APP_FEATURE BII'yi uygulama.

Sektör veya kategoriye özel kullanım alanlarına olanak tanıyan BBI'ler de vardır. Örneğin, Örneğin, bir egzersiz uygulaması actions.intent.START_EXERCISE BBI.

Mükemmel bir kullanıcı deneyimi sağlamak ve olası onay gecikmelerini önlemek için uyguladığınız her BII'nin uygulama içi işlevinizle alakalı olduğundan emin olun.

Uygulama İşlemleri, Asistan uygulamasından Android intent'lerini başlatarak çalışır. kullanıcıları doğrudan uygulamanızdaki belirli bir içeriğe yönlendirmek için kullanır. Amaçları şu şekilde tanımlayabilirsiniz: bir etkinliği açık bir şekilde başlatmak içintargetClass ve targetPackage alanları için geçerlidir. Uygulamanızda zaten Android derin bağlantısı kullanılıyorsa derin bağlantı kullanma niyetini yapılandırabilirsiniz. istek karşılamayı da kapsar. Daha fazla bilgi için Etkinliğinizi ayrıntılı olarak test etme bağlantılar bölümüne bakın.

Yerleşik amaçlar için karşılama ayrıntıları sağlayın

Uygulama işlemi oluşturmanın büyük kısmı, Android uygulamanızın shortcuts.xml kaynak dosyasında bir yetenek beyan etmektir. Bu beyanda, seçtiğiniz BII'yi ve ilgili karşılama işlemini belirtirsiniz. BII, bir görev için kullanıcı sorgusuna bağlı olarak, yerine getirme amacı da Asistan'a görevin nasıl gerçekleştirileceğine dair bilgi sağlar.

shortcuts.xml dosyanızda, BII'ler <capability> öğeleri olarak, her bir yerine getirme ise <intent> öğesi olarak temsil edilir:

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="exercise.name"
                android:key="exercise_name">
            </parameter>
        </intent>
    </capability>

Çoğu BBI'de, intent parametrelerini kullanıcı sorgusundan çıkarırsınız. schema.org varlıklarına göre yapılır. Uygulamanız bu BII'yi kullanır parametreleri kullanabilirsiniz. Örneğin, önce kod, exercise.name BII parametresini exercise_name Android ile eşleştirir intent parametresinden oluşur.

Derin bağlantıları kullanarak işlemleri yerine getiriyorsanız Asistan'ın oluşturduğu derin bağlantı URL'sini tanımlamak için urlTemplate alanını kullanırsınız:

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myexerciseapp://start{?exercise_name}" />
            <parameter android:name="exercise.name"
                android:key="exercise_name"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

İpucu: Uygulamanız tek bir BII için yerine getirilecek birden fazla intent sağladığında Asistan, bunları capability öğesinde göründükleri sırayla çözmeye çalışır.

shortcuts.xml dosyasına uygulama işlemleri ekleme hakkında önemli ayrıntılar için shortcuts.xml oluşturma başlıklı makaleyi inceleyin. Söz konusu sayfa ayrıca uygulamanızın beklediği parametre değerlerinin nasıl belirtileceğini açıklar.

GET_THING yerleşik amacını uygulayın

Uygulamanızda arama işlevi varsa actions.intent.GET_THING BII'sini kullanabilirsiniz. Asistan daha sonra yönlendirme yapabilir Kullanıcılar, uygulama içi sonuçlar için uygulamanızın arama işlevine sorgu gönderir Örneğin, "Ok Google, Örnek Uygulama'da Örnek Şey ara" gibi bir ifade kullanabilirsiniz.

shortcuts.xml dosyanızda şunun için bir <capability> uygulayın: actions.intent.GET_THING BII'yi başka herhangi bir BII'yi uygulayabilirsiniz. Kullanıcı sorgusunu uygulamanızın arama işlevine ileten en az bir karşılama sağladığınız sürece GET_THING için birden fazla karşılama kullanabilirsiniz.

Aşağıda, actions.intent.GET_THING BII'sinin eklendiği 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>

Activity aramanızda, intent ve uygulamanızın arama işlevine iletin. Önceki kodda, query tuşu olarak iletilen arama sorgusu, "thing.name" ile eşlenir. BII parametresidir. Ardından, sorguyla bir arama yapın ve sonuçları şurada görüntüleyin: kullanıcı arayüzü.

İsteğe bağlı: Uygulama İşleminizin kısayollarını Asistan'a aktarma

İşleminiz için bir özellik tanımlamanızın ardından, kullanıcılar "Ok Google, Örnek Uygulama'da pizza sipariş et" gibi bir şey söyleyerek işlemi tamamlayın. Asistan, uygun olduğu yerlerde kullanıcılara işlemleriniz için Android kısayolları önerebilir Böylece, hareketlerinizi keşfedip tekrar oynatabilirler. Asistan hem dinamik hem de statik kısayollar önerebilir.

Dinamik kısayolları Asistan'a aktarmak için Google Kısayollar Entegrasyonu'nu kullanın kitaplığını tanıtır. Bu Jetpack kitaplığı, Asistan'ın kısayollarınızı almasını ve uygun zamanda kullanıcılara önermesini sağlar.

Daha fazla bilgi için Dinamik kısayolları Asistan'a aktarma başlıklı makaleyi inceleyin.

Uygulama İşlemlerinizi önizleme

Geliştirme ve test sırasında Google Asistan eklentisinin yardımıyla Android Studio'da bunu test edebilirsiniz Uygulama İşlemleri, uygulamanız için çalışır. Eklenti, uygulama işlemlerinizin önizlemesini oluşturur inceleyebilirsiniz. Test aracını kullanarak BII'leri girişle sağlayarak fiziksel test cihazında veya emülatörde karşılama belirli parametreler olabilir.

Uygulama İşlemlerinizi önizlerken cihazda sesli olarak sorgu tetikleyebilirsiniz. Bu işlev yalnızca Uygulama İşlemleri için BII referansı. Sesle tetiklemeyi yalnızca gösterim için kullanın, normal test için kullanmayın.

Google Play için geliştirici araçlarını kullanarak uygulamanızı taslak modunda test etme Play Console'a göz atın. Google Play Console'u kullanarak taslak dağıtma hakkında daha fazla bilgi hakkında daha fazla bilgi edinmek için Bir sürüm ekleyebilirsiniz.

Test sürümü oluşturma

Uygulama İşlemlerinizi ek test kullanıcıları ile test etmeye hazır olduğunuzda Uygulamanızın dahili veya kapalı test sürümünü oluşturun. Varsayılan olarak, dahili ve Kapalı sürüm test kullanıcıları, önceden eklenmiş olan Uygulama İşlemleri'ne incelenip onaylanmış olur.

Onaylanmamış işlemler de dahil olmak üzere tüm Uygulama İşlemlerine test erişimi vermek için: test kullanıcılarınıza Uygulama İşlemleri Geliştirme Programı Google Grubu. Bu grubun üyeleri, uygulama işlemleri test aracını kullanarak önizleme oluşturmak zorunda kalmadan kapalı ve dahili test sürümlerindeki tüm uygulama işlemlerine erişebilir. Gruba katıldıktan sonra bu süreç üç saati bulabilir. ekleyebilirsiniz.

Uygulama İşlemleri'nin incelenmesini ve dağıtılmasını isteme

Uygulama İşlemleri, yayınlanan uygulamalarınızın veya açık testinizin kullanıcıları tarafından kullanılamaz ve onaylanana kadar yayınlar. Uygulama İşlemleri incelemesi Google Play'de Android uygulamanızın inceleme ve dağıtım durumunu etkiler. Hatta uygulama gönderiminiz onaylanıp Play Store'da yayınlandığında, shortcuts.xml, Google tarafından inceleniyor olabilir. Uygulama İşlemleri, bu inceleme de onaylanana kadar geçen süreyi ifade eder.

Uygulamanızı dağıttığınızda Uygulama İşlemleri etkin kalır. Ancak, Yeniden dağıtılan sürümler Google tarafından incelenir. Yeni sürüm düzgün şekilde çalışmıyorsa veya politika ihlali içeriyorsa Google, uygulamanız için Uygulama İşlemleri'ni devre dışı bırakın.

Uygulama işlemlerinizi incelemeye göndermek için aşağıdakileri yapın:

Google Play Console'da Uygulama İşlemleri hizmet şartlarını kabul edin (Gelişmiş ayarlar > Uygulama İşlemleri):
shortcuts.xml içeren uygulamanızı şuraya yükleyin: Google Play Console'u kullanabilirsiniz.
Uygulamanızı Play Console'a yükledikten sonra Google, e-posta gönderebilirsiniz. en son İşlemlerin incelenmesi. Asistan Geliştirici Destek Ekibi ile de iletişime geçebilirsiniz Uygulama İşlemleri inceleme durumunuzla ilgili sorularınız varsa. İlgili kişi formundan uygulama paketi kimliğinizi girin ve Uygulama İşlemi incelemesi öğesini seçin Size nasıl yardımcı olabiliriz? seçim kutusunu işaretleyin.

İsteğe bağlı: Etkinliğinizin derin bağlantılarını test etme

Uygulama İşlemi kullanarak bir Activity başlatmak üzere derin bağlantı kullanmak için Activity derin bağlantı URL'leriyle oluşturulmalı ve Android uygulama manifest'inde yer alıyor.

Etkinliklerinizin erişilebilir olduğunu ve Derin bağlantıları kullanan Uygulama İşlemleri için aşağıdaki adb komutunu çalıştırın:

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

Örnek:

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

Etkinliğiniz adb komutuyla doğru şekilde başlatılmazsa aşağıdakileri kontrol edin:

Uygulama manifest dosyanızda, etkinlik android:exported=true olduğundan şunları yapabilir: Google Asistan'ın amaçları kullanılarak başlatılabilir.
Uygulama Bağlantıları URL'leri kullanıyorsanız Android Uygulama Bağlantıları'nı işleme başlıklı makaledeki tüm adımları uygulayın.

Uygulama İşlemleri politikaları

Uygulama İşlemleri, belirli politikalara uyması gerekir. istenen deneyimi sağlamalarını tetikleyecekler. Şu tarihten önce bu politikaları inceleyin: en iyi kullanıcı deneyimini sunmak ve Google Play'den kaçınmak için uygulamalarınızı Mağaza incelemesinde yaşanan gecikmeler veya retler

Kullanıcıları, kullanıcı tarafından oluşturulan içeriğe yönlendirme

Uygulama İşlemi yerleşik amaçları (BII'ler) ve/veya parametreleri, kullanıcıları yalnızca ilgili ve kullanıcının niyetindeki eylemdir. Buna uygulama içi içerik, dilimlerde veya widget'larda gösterilen bilgilerin, kullanıcı tarafından amaçlanıyordu.

Örneğin, START_EXERCISE BII uygulamaları, Koşu veya yüzme gibi belirli bir türde egzersizi başlatma. Tek OPEN_APP_FEATURE BII'nizin kullanıcıları yönlendirdiği durumlar bu politikanın istisnasıdır. dokunun.
Alakalı Uygulama İşlemleri BBI'lerini uygulayın

Uygulanan BBI'ler, uygulamanın içeriğiyle doğrudan alakalı olmalıdır. işlevi görür.

Örneğin, uygulamanız İletişim Play Store kategorisindeyse START_EXERCISE BII'yi kullanmayın. Heath ve Fitness kategorisindeki uygulamalar için önerilenler.
Alakalı özel amaçları uygulama

Özel amaçlar için tanımlanmış sorgular uygulamanın içeriğiyle alakalıdır ve işlevi görür. Bunun olası bir ihlaline örnek ilke, custom.action.intent.GET_RECIPE "Burrito tariflerini göster" sorgu kalıbı bir uygulama için Ulaşım Play Store kategorisi.