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. Android uygulamanızı Uygulama İşlemleri ile genişletmenin başlıca adımları şunlardır:

1. Tetiklenecek uygulama içi işlevi ve bunun eşleşen yerleşik amacını (BII) tanımlayın.
2. BII için sipariş karşılama ayrıntılarını girin.
3. Uygulama işleminizin kısayollarını Asistan'a gönderin.
4. Uygulama iş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 sunulacak dinamik kısayollar tanımlayabilirsiniz. Böylece Asistan, bu kısayolları kullanıcılarınıza önerebilir. Uygulama İşlemleri codelab'ini uygulayarak örnek bir uygulama kullanarak Uygulama İşlemi oluşturun.

Şartlar

Uygulama işlemi geliştirmeye başlamadan önce, uygulamanızın ve sizin aşağıdaki koşulları karşıladığından emin olun:

• Google Play Console'a erişimi olan bir Google Hesabınız olmalıdır.
• Uygulama İşlemleri yalnızca Google Play Store'da yayınlanan uygulamalarda kullanılabildiğinden uygulamanız Google Play Store'da yayınlanmış olmalıdır. Ayrıca, Uygulama İşlemleri Managed Google Play tarafından desteklenmediğinden, uygulamanızın bir iş profilinde kullanılmak üzere tasarlanmadığından emin olun.
• 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 Studio, test cihazınızdaki Google uygulaması ve Google Play Console'da oturum açmak için aynı Google Hesabı'nı kullanmanız gerekir.
• 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 sözlü bir istekle atlamak isteyebileceği işlevleri tanımlayın ve kullanım alanlarınıza uygun BBI'leri bulmak için yerleşik amaç referansını inceleyin. BII'ler, gerçekleştirmek istedikleri görevler için kullanıcı sorgularını modeller. Bu nedenle, uygulamanızdaki temel işlevlere ve kullanıcı akışlarına uyan BBI'leri arayın.

Hemen hemen her Android uygulamasının kullanabileceği ortak BII'ler vardır. Örneğin, actions.intent.GET_THING BII ile uygulama içi aramanızı Asistan'a genişletebilir veya actions.intent.OPEN_APP_FEATURE BII'yi uygulayarak kullanıcıların belirli uygulama özelliklerini sesleriyle başlatmasına izin verebilirsiniz.

Dikey veya kategoriye özel kullanım alanlarını etkinleştiren BI'ler de vardır. Örneğin, bir egzersiz uygulaması actions.intent.START_EXERCISE BII'yi kullanabilir.

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, kullanıcıları doğrudan uygulamanızdaki belirli bir içeriğe yönlendirmek için Asistan uygulamasından Android intent'lerini başlatarak çalışır. targetClass ve targetPackage alanlarını belirterek bir etkinliği açıkça başlatmak için intent'leri tanımlayabilirsiniz. Uygulamanız halihazırda Android derin bağlantısı URL'lerini uyguluyorsa intent'i, yerine getirme için derin bağlantı kullanacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için Etkinlik derin bağlantılarınızı test etme bölümüne bakın.

Yerleşik intent'ler için yerine getirme ayrıntılarını sağlama

Uygulama İşlemi oluşturmanın büyük bir kısmı, Android uygulamanızın shortcuts.xml kaynak dosyasında bir özellik beyan etmektir. Burada, seçtiğiniz BII'yi ve buna karşılık gelen karşılamayı belirtirsiniz. BII, bir görevle ilgili kullanıcı sorgusunu modellerken, karşılama amacı, Asistan'a görevin nasıl gerçekleştirileceği hakkında 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 BI için schema.org varlıklarına göre kullanıcı sorgusundan intent parametrelerini ayıklayabilirsiniz. Ardından uygulamanız, kullanıcıları seçili özelliğe yönlendirmek için bu BII parametrelerini kullanır. Örneğin, önceki kod, exercise.name BII parametresini exercise_name Android intent parametresiyle eşler.

İşlemleri derin bağlantılar kullanarak gerçekleştiriyorsanız urlTemplate alanını kullanarak Asistan'ın oluşturduğu derin bağlantı URL'sini tanımlayabilirsiniz:

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

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. Bu sayfada, uygulamanızın beklediği parametre değerlerinin nasıl belirtileceği de açıklanmaktadır.

GET_THING yerleşik amacını uygulama

Uygulamanızda arama işlevi varsa bu işlev için actions.intent.GET_THING BII'yi uygulamanız gerekir. Asistan, "Ok Google, Örnek Uygulama'da Örnek Nesneyi ara" gibi sorgular yaptıklarında kullanıcıları uygulama içi sonuçlar için uygulamanızın arama işlevine yönlendirebilir.

shortcuts.xml dosyanızda, başka herhangi bir BII'yi uygularken actions.intent.GET_THING BII için bir <capability> uygulayın. 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.

actions.intent.GET_THING BII'nin shortcuts.xml'e eklenmesiyle ilgili bir örnek aşağıda verilmiştir:

  <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 içindeki ek verilerden arama sorgusunu çıkarıp uygulamanızın arama işlevine iletin. Önceki kodda query anahtarı olarak iletilen arama sorgusu, "thing.name"BII parametresiyle eşlenir. Ardından, sorguyla bir arama gerçekleştirin ve sonuçları kullanıcı arayüzünde görüntüleyin.

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

İşleminiz için bir özellik tanımladıktan sonra kullanıcılar "Ok Google, Örnek Uygulama'da pizza sipariş et" gibi bir ifade söyleyerek işleminizi başlatabilir. Asistan, kullanıcılara uygun zamanlarda Android kısayolları önererek işlemlerinizi keşfetmelerine ve tekrar oynatmalarına olanak tanıyabilir. Asistan hem dinamik hem de statik kısayollar önerebilir.

Asistan'a dinamik kısayollar göndermek için Google Kısayol Entegrasyonu kitaplığını kullanın. Bu Jetpack kitaplığı, Asistan'ın kısayollarınızı alıp kullanıcılara uygun zamanda önerebilmesini sağlar.

Daha fazla bilgi için Asistan'a dinamik kısayollar gönderme başlıklı makaleyi inceleyin.

Uygulama İşlemlerinizi önizleme

Geliştirme ve test sırasında, uygulama hareketlerinin uygulamanızda çalıştığını test etmek için Android Studio'nun Google Asistan eklentisini kullanın. Bu eklenti, Google Hesabınız için Asistan'da uygulama hareketlerinizin önizlemesini oluşturur. Test aracını kullanarak, kullanıcılardan almayı beklediğiniz giriş parametrelerini BI'lere sağlayarak yerine getirme işlemlerinizi fiziksel bir test cihazında veya emülatörde test edebilirsiniz.

Uygulama İşlemlerinizi önizlerken cihazda sesli olarak sorgu tetikleyebilirsiniz. Bu işlev yalnızca Uygulama İşlemleri için BII referansında listelenen sorgular için kullanılabilir. Ses tetiklemeyi düzenli test için değil, yalnızca gösterim amacıyla kullanın.

Uygulamanızı incelemeye göndermeden önce Google Play Console'un geliştirici araçlarını kullanarak taslak modunda test edin. Uygulamanızın taslağını dağıtmak için Google Play Console'u kullanma hakkında daha fazla bilgi edinmek istiyorsanız Sürüm hazırlama ve kullanıma sunma başlıklı makaleyi inceleyin.

Test sürümü oluşturma

Uygulama İşlemlerinizi başka test kullanıcılarıyla 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ınız, incelenmiş ve onaylanmış olan Uygulama İşlemlerine erişebilir.

Onaylanmamış işlemler de dahil olmak üzere tüm Uygulama İşlemleri'ne test erişimi vermek için test kullanıcılarınızdan Uygulama İşlemleri Geliştirme Programı Google Grubu'na katılmalarını isteyin. 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 İşlemlerine erişebilir. Gruba katıldıktan sonra erişimin etkinleşmesi üç saati bulabilir.

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

Uygulama İşlemleri, incelenip onaylanana kadar yayınlanmış uygulamalarınızın veya açık test sürümlerinizin kullanıcıları tarafından kullanılamaz. Uygulama İşlemleri incelemesi, Google Play'deki Android uygulama incelemenizi ve dağıtım durumunuzu etkilemez. Uygulama gönderiminiz onaylanıp Play Store'da yayınlanmış olsa bile shortcuts.xml Google tarafından inceleniyor olabilir. Bu inceleme de onaylanana kadar uygulama işlemleri son kullanıcılarınız için çalışmaz.

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

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ı, yayınlama işlemi için normal şekilde Google Play Console'a yükleyin.

3. Uygulamanızı Play Console'a yükledikten sonra Google, Uygulama İşlemleri incelemenizin durumuyla ilgili daha fazla bilgi vermek için Play Console hesabınızdaki e-posta üzerinden sizinle iletişime geçer. Uygulama İşlemleri inceleme durumunuzla ilgili sorularınız için Asistan Geliştirici Destek Ekibi ile de iletişime geçebilirsiniz. İletişim formunda uygulama paketi kimliğinizi girin ve Size nasıl yardımcı olabiliriz? seçim kutusunda Uygulama işlemi inceleme'yi seçin.

İsteğe bağlı: Etkinlik derin bağlantılarınızı test etme

Uygulama işlemi kullanarak Activity'ü başlatmak için derin bağlantı kullanmak istiyorsanız Activity, derin bağlantı URL'leriyle ayarlanmalı ve Android uygulama manifest'inde ilgili bir intent filtresi bulunmalıdır.

Etkinliklerinize erişilebildiğini ve derin bağlantılar kullanarak uygulama işlemleri kullanılarak tetiklenip tetiklenemediğini test etmek 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ılmıyorsa aşağıdakileri kontrol edin:

• Uygulama manifest dosyanızdaki etkinliğin android:exported=true değeri olduğundan Google Asistan'dan gelen intent'ler kullanılarak başlatılabilir.
• Uygulama Bağlantıları URL'lerini 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 işlemleri, tetikleyen kullanıcıların istenen deneyimi almasını sağlamak için belirli politikalara uymalıdır. En iyi kullanıcı deneyimini sunmak ve Play Store inceleme gecikmelerini ya da retlerini önlemek için uygulamalarınızı göndermeden önce bu politikaları inceleyin.

• Kullanıcıların ilgisini çekmek istediğiniz içeriklere yönlendirme

  Uygulama işlemi yerleşik intent'leri (BII'ler) ve/veya parametreleri, kullanıcıları yalnızca alakalı ve kullanıcı tarafından amaçlanan işleme yönlendirmelidir. Buna uygulama içi içerik, web sitesi içeriği veya kullanıcı tarafından istenen bir deneyim olduğu sürece dilimler ya da widget'larda gösterilen bilgiler dahildir.

  Örneğin, START_EXERCISE BII'nin uygulamaları kullanıcıların belirli bir türde (ör. koşu veya yüzme) egzersiz başlatmasına yardımcı olur. Bu politikanın tek istisnası, OPEN_APP_FEATURE BII'nizin kullanıcıları uygulamanızın ana ekranına yönlendirmesidir.

• Uygun uygulama işlemi BI'lerini uygulama

  Uygulanan BII'ler, uygulamanın içeriği ve işlevselliğiyle doğrudan alakalı olmalıdır.

  Örneğin, uygulamanız İletişim Play Store kategorisindeyse Sağlık ve Fitness kategorisindeki uygulamalar için önerilen START_EXERCISE BII'yi uygulamayın.

• Alakalı özel amaçları uygulama

  Özel amaçlar için tanımlanan sorgular, uygulamanın içeriği ve işlevselliğiyle ilgilidir. Bu politikanın olası bir ihlaline örnek olarak, Ulaşım Play Store kategorisindeki bir uygulama için ilişkili "Burrito tariflerini göster" sorgu kalıbıyla custom.action.intent.GET_RECIPE niyetinin oluşturulması verilebilir.