Uygulama İşlemleri Oluşturma

Uygulama İşlemleri, kullanıcıların şunları sorarak Android uygulamanızda işlevi başlatmalarına olanak tanır: Google Asistan'ın önerdiği Android kısayollarını kullanarak. Bu Android uygulamanızı Uygulama İşlemleri ile genişletmenin birincil adımlarıdır:

1. Tetiklenecek uygulama içi işlevi ve eşleştirmesini tanımlama yerleşik amaç (BII) özelliklerini kullanabilirsiniz.
2. BII için sipariş karşılama ayrıntılarını girin.
3. Uygulama İşleminizin kısayollarını Asistan'a aktarın.
4. Uygulama İşlemlerinizi bir test cihazında önizleyin.
5. Uygulamanızın test sürümünü oluşturun.
6. Uygulama İşlemleri incelemesi ve dağıtımı isteyin.

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

Dikkat: Mevzuat kısıtlamaları nedeniyle, Designed Aileler için (DFF) programında Uygulama İşlemleri yapılmasına izin verilmez. Bildirimde bulunursanız Aileler için programına dahil olan bir uygulamayla ilgili incelenmek üzere uygulama işlemi kabul edilemez.

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.
• 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.
• Test cihazınızda Asistan'ı kurmalı ve aşağıdaki adımları uygulayarak test etmelisiniz: dokun ve Ana sayfa düğmesini basılı tutun.

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. BII'ler, istedikleri görevler için kullanıcı sorguları modeli Bu nedenle, temel işlev ve kullanıcı deneyimiyle eşleşen BII'leri arayın. takip edebilirsiniz.

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.

Önemli: Uygulama İşlemleri dağıtım şartları kapsamında, şu özelliklere sahip uygulamalar: actions.intent.GET_THING öğesini uygulamalıdır. Kullanıcıların uygulamanızda içerik arayabilmesi için BII "Ok Google, şurada koşu ayakkabısı ara: Örnek Uygulama"

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

Not: Uygulama işlevselliğiniz için bir BII'nin bulunmadığı durumlarda Uygulama İşlemleri ile uygulamanızı genişletmek için özel amaç.

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

Bir Uygulama İşlemi oluşturmanın büyük bir kısmı, Android uygulamanızın shortcuts.xml kaynak dosyası seçtiğiniz BII'yi ve buna karşılık gelen karşılamayı belirtin. 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, BBI'lar <capability> olarak gösterilir. öğelerinde bulunur ve her karşılama bir <intent> öğesi olarak temsil edilir:

<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>

Not: Jetpack kitaplığının androidx.core:core:1.6.0 (veya üzeri) Android cihazınızda yüklü olması gerekir API'de Uygulama İşlemleri özelliklerini tanımlarken derleme hatalarını önlemek için shortcuts.xml Ayrıntılar için Android Jetpack'i kullanmaya başlama başlıklı makaleye bakın.

Ç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, menuItem.name BII parametresini query Android intent ile eşleştirir parametresinden sonra bir değer girin.

İşlemleri derin bağlantılar kullanarak gerçekleştiriyorsanız urlTemplate alanını kullanırsınız. Asistan'ın oluşturduğu derin bağlantı URL'sini tanımlamak için:

<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>

.

İpucu: Uygulamanız tek bir hedef için yerine getirmek üzere birden fazla amaç sunduğunda BII, Asistan bunları içerikte göründükleri sırayla çözmeye çalışır. capability öğesi.

shortcuts.xml dosyasına Uygulama İşlemleri eklemeyle ilgili önemli ayrıntılar için shortcuts.xml oluşturma bölümüne bakın. 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. Şunlar için birden fazla sipariş karşılama kullanabilirsiniz: Kullanıcı tarafından yapılan sipariş karşılama işlemlerinden en az birini sağladığınız sürece GET_THING uygulamanızın arama işlevine sorgu gönderir.

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ı açar. Bu Jetpack kitaplığı, Asistan'ın kısayollarınızı almasını ve uygun zamanda önermenize yardımcı olur.

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

Uygulama İşlemlerinizi önizleyin

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.

Not: Uygulama İşlemleriniz için başka test kullanıcıları da ekleyebilirsiniz. entegrasyonu (aynı Play Console hesabını paylaşmasalar bile) Alıcı: daha fazla bilgi için Başka test kullanıcıları ekleyin.

Uygulama İşlemlerinizi önizlerken aşağıdaki olanak tanır. Bu işlev yalnızca Uygulama İşlemleri için BII referansı. Sesi kullan yalnızca gösterim için değil, düzenli test için tetiklenmelidir.

Not: Uygulama İşlemleri test aracı yalnızca diğer yerel ayarlar için örnek sorgular karşılık gelen yerleşik amaç referansı.

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 grubu, kapalı ve açık konumlardaki tüm Uygulama İşlemlerine erişebilir dahili test sürümlerini kullanarak önizleme oluşturmaya gerek kalmadan uygulama işlemleri test aracı'ndan yararlanabilirsiniz. Gruba katıldıktan sonra bu süreç üç saati bulabilir. ekleyebilirsiniz.

Not: Açık test kanalı sürümlerindeki Uygulama İşlemleri, kullanıcılar tarafından kullanılamaz bu işlemler incelenip onaylanana kadar sürer. Daha fazla bilgi için bölümüne bakın.

Uygulama İşlemleri incelemesi ve dağıtımı isteyin

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 ihlalleri içeriyorsa Google, uygulamanız için Uygulama İşlemleri'ni devre dışı bırakın.

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

1. Google Play Console'da Uygulama İşlemleri hizmet şartlarını kabul edin (Gelişmiş ayarlar > Uygulama İşlemleri):

   

2. shortcuts.xml içeren uygulamanızı şuraya yükleyin: Google Play Console'u kullanabilirsiniz.

3. 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.

ziyaret edin.

Not: Uygulamanız giriş kimlik bilgileriyle kısıtlanmışsa Uygulama gönderimiyle girişi test edin. Test kimlik bilgileri sağlamak için uygulamanızı şurada seçin: Play Console'da Politika > Uygulama İçeriği ve Uygulama erişimi için listelenen talimatlar.

İ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.

Not: Derin bağlantı, Uygulama Bağlantıları URL'lerini temel alabilir. amaca dayalı URL'ler veya myapp://do.thing/param=value gibi özel şemalar

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'lerini kullanıyorsanız Android App Links'i kullanma.

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, ORDER_MENU_ITEM BII uygulamaları, Belirtilen menü seçeneği veya mutfak türü için bir sipariş başlatır. Tek OPEN_APP_FEATURE BII'nizin kullanıcıları yönlendirdiği durumlar bu politikanın istisnasıdır. dokunun.

• Kullanıcıları alakalı web içeriğine yönlendirme

  Kullanıcılar bir web sayfası içeriğine yönlendiriliyorsa, web sitesi markaya ait olan ve kullanıcının amaçladığı eylemdir.

  Örneğin, bir dönüşüm başlatan veya ait olmayan, GET_RESERVATION BII'nizi google.com/travel hesabına Uygulamanızın exampledomain.com markası politika ihlalidir. Bir başka örnek de GET_CALL_HISTORY BII'nizi tetikleyen kullanıcıların exampledomain.com/payment kullanıyor ve satın alma işlemi yapmalarını gerektiriyor.

• 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 ORDER_MENU_ITEM BII'yi kullanmayın. Yiyecek ve İçecek 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 politikası custom.action.intent.GET_RECIPE "Burrito tariflerini göster" sorgu kalıbı bir uygulama için Ulaşım Play Store kategorisi.

---