बिल्ड ऐप ऐक्शन

ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयां करने की सुविधा का इस्तेमाल करके, उपयोगकर्ता Google Assistant या Assistant के सुझाए Android शॉर्टकट का इस्तेमाल करके. ये ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की मदद से, अपने Android ऐप्लिकेशन की पहुंच बढ़ाने के लिए, ये मुख्य चरण हैं:

  1. ट्रिगर करने और उसके मिलान के लिए, इन-ऐप्लिकेशन फ़ंक्शन की पहचान करें बिल्ट-इन इंटेंट (बीआईआई).
  2. बीआईआई की कार्रवाई पूरी करने की जानकारी दें.
  3. Assistant को ऐप की मदद से की जाने वाली कार्रवाई के लिए शॉर्टकट पुश करें.
  4. टेस्ट डिवाइस पर, ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की झलक देखें.
  5. अपने ऐप्लिकेशन की टेस्ट रिलीज़ बनाएं.
  6. ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की समीक्षा और डिप्लॉयमेंट का अनुरोध करें.

इसके अलावा, Assistant को उपलब्ध कराने के लिए डाइनैमिक शॉर्टकट तय किए जा सकते हैं, ताकि यह काम कर सके अपने उपयोगकर्ताओं को उनका सुझाव दें. ऐप्लिकेशन के सैंपल का इस्तेमाल करके ऐप्लिकेशन ऐक्शन बनाएं. इसके लिए ऐप्लिकेशन ऐक्शन कोडलैब के बाद.

ज़रूरी शर्तें

ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों को डेवलप करने से पहले, पक्का करें कि आप और आपका ऐप्लिकेशन, ये ज़रूरी शर्तें:

  • आपके पास ऐसा Google खाता होना चाहिए जिससे Google Play Console से हटा दिया जाएगा.
  • आपका ऐप्लिकेशन Google Play Store पर पब्लिश होना चाहिए, क्योंकि ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयां यह सिर्फ़ उन ऐप्लिकेशन के लिए उपलब्ध है जो इस टैब में पब्लिश किए गए हैं. साथ ही, पक्का करें कि आपका ऐप्लिकेशन इसका इस्तेमाल वर्क प्रोफ़ाइल में नहीं किया जाना चाहिए, क्योंकि इसमें ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयां करने की सुविधा मौजूद नहीं है 'कारोबार के लिए Google Play' से.
  • ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की जांच करने के लिए, आपको किसी फ़िज़िकल या वर्चुअल डिवाइस की ज़रूरत होगी.
  • आपके पास Android Studio का सबसे नया वर्शन होना चाहिए.
  • Android में साइन इन करने के लिए, आपको उसी Google खाते का इस्तेमाल करना होगा Studio, आपके टेस्ट डिवाइस पर Google ऐप्लिकेशन, और Google Play Console.
  • आपको अपने टेस्ट डिवाइस पर Assistant सेट अप करना होगा. साथ ही, टच & होम बटन को दबाकर रखें.

ऐप्लिकेशन की मुख्य सुविधाओं और उनके काम करने के तरीके के साथ पहले से मौजूद इंटेंट को मैच करें

अपने Android ऐप्लिकेशन की ऐसी सुविधाओं की पहचान करें जो लोगों को पसंद आ सकती हैं बोलकर किया गया अनुरोध देखने के लिए, सही बीआईआई ढूंढने के लिए, बिल्ट-इन इंटेंट रेफ़रंस का पालन नहीं करता है. बीआईआई उन टास्क के लिए उपयोगकर्ता की क्वेरी का मॉडल बनाते हैं जिन्हें वे करना चाहते हैं करते हैं, इसलिए ऐसे बीआईआई खोजें जो मुख्य फ़ंक्शन और उपयोगकर्ता से मेल खाते हों फ़्लो को कम करता है.

कुछ सामान्य बीआईआई ऐसे होते हैं जिनका इस्तेमाल, ज़्यादातर Android ऐप्लिकेशन कर सकते हैं. जैसे, actions.intent.GET_THING बीआईआई की मदद से, ऐप्लिकेशन में खोजने की सुविधा को Assistant पर उपलब्ध कराना या actions.intent.OPEN_APP_FEATURE बीआईआई को लागू करके, उपयोगकर्ताओं को अपनी आवाज़ से ऐप्लिकेशन की खास सुविधाएं लॉन्च करने की सुविधा देना.

ऐसे बीआईआई भी होते हैं जो वर्टिकल या कैटगरी के हिसाब से, इस्तेमाल के उदाहरण को चालू करते हैं. इसके लिए उदाहरण के लिए, कसरत से जुड़ा कोई ऐप्लिकेशन actions.intent.START_EXERCISE का इस्तेमाल कर सकता है बीआई.

बेहतरीन उपयोगकर्ता अनुभव पक्का करने और मंज़ूरी मिलने में होने वाली देरी से बचने के लिए, यह पक्का करें कि आपने जो भी बीआईआई लागू किया है वह आपके ऐप्लिकेशन की इन-ऐप्लिकेशन सुविधाओं के हिसाब से हो.

ऐप्लिकेशन की ख़ास सुविधाओं के लिए कार्रवाइयाँ करने के लिए, Assistant ऐप्लिकेशन से Android इंटेंट शुरू किया जाता है. उपयोगकर्ताओं को सीधे आपके ऐप्लिकेशन में मौजूद किसी कॉन्टेंट पर ले जाते हैं. आपके पास किसी गतिविधि को साफ़ तौर पर लॉन्च करने के लिए, targetClass और targetPackage फ़ील्ड. अगर आपके ऐप्लिकेशन में पहले से ही Android डीप लिंक यूआरएल लागू हैं, तो आपके पास टास्क पूरा करने के लिए डीप लिंक का इस्तेमाल करने के इंटेंट को कॉन्फ़िगर करने का विकल्प है. ज़्यादा जानकारी के लिए, अपनी गतिविधि की गहराई से जांच करें लिंक सेक्शन में देखा जा सकता है.

पहले से मौजूद इंटेंट के लिए ग्राहक को पूरा करने की जानकारी दें

ऐप्लिकेशन ऐक्शन बनाने के ज़्यादातर हिस्से में क्षमता का एलान किया गया है, shortcuts.xml अपने Android ऐप्लिकेशन की संसाधन फ़ाइल जहां आप आपके चुने हुए बीआईआई और इससे जुड़े कोड को पूरा करने की जानकारी दें. बीआईआई, किसी टास्क के लिए उपयोगकर्ता की क्वेरी और फ़ुलफ़िलमेंट इंटेंट के ज़रिए Assistant को उस टास्क को करने के बारे में जानकारी.

आपकी shortcuts.xml फ़ाइल में, बीआईआई <capability> के तौर पर दिखाए जाते हैं एलिमेंट शामिल किए जाते हैं और हर फ़ुलफ़िलमेंट को <intent> एलिमेंट के तौर पर दिखाया जाता है:

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

ज़्यादातर बीआईआई के लिए, उपयोगकर्ता की क्वेरी से इंटेंट पैरामीटर को एक्सट्रैक्ट किया जाता है जो schema.org इकाइयों के मुताबिक है. इसके बाद, आपका ऐप्लिकेशन उन बीआईआई का इस्तेमाल करता है पैरामीटर का इस्तेमाल करें, ताकि उपयोगकर्ताओं को चुनी गई क्षमता पर ले जाया जा सके. उदाहरण के लिए, ऊपर दिया गया कोड, exercise.name BII पैरामीटर को exercise_name Android intent पैरामीटर से मैप करता है.

अगर डीप लिंक का इस्तेमाल करके कार्रवाइयां की जा रही हैं, तो urlTemplate फ़ील्ड का इस्तेमाल किया जाता है ताकि यह तय किया जा सके कि Assistant किस डीप लिंक यूआरएल को जनरेट करती है:

<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 फ़ाइल में ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयां जोड़ने के बारे में अहम जानकारी के लिए, shortcuts.xml बनाएं देखें. वह पेज भी बताता है कि आपके ऐप्लिकेशन के मुताबिक पैरामीटर वैल्यू कैसे तय की जाए.

GET_THING बिल्ट-इन इंटेंट को लागू करें

अगर आपके ऐप्लिकेशन में खोजने की सुविधा मौजूद है, तो आपको उस फ़ंक्शन के लिए actions.intent.GET_THING बीआईआई. इसके बाद, Assistant आगे भेज सकती है आपके ऐप्लिकेशन के खोज फ़ंक्शन में शामिल उपयोगकर्ता, जब वे क्वेरी करते हैं, इन-ऐप्लिकेशन नतीजों के लिए जैसे, "Ok Google, Example ऐप्लिकेशन पर Example Thing खोजो."

अपनी shortcuts.xml फ़ाइल में, इनके लिए <capability> लागू करें: actions.intent.GET_THING बीआईआई, जैसा आप कोई भी दूसरा बीआईआई लागू करें. ऑर्डर पूरा करने के लिए, एक से ज़्यादा ऑर्डर का इस्तेमाल किया जा सकता है GET_THING जब तक आप कम से कम एक ऑर्डर पूरा कर देते हैं, जो उपयोगकर्ता को पास कर दिया जाता है क्वेरी का जवाब दें.

यहां actions.intent.GET_THING बीआईआई को जोड़ने का उदाहरण दिया गया है 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 में, intent और उसे अपने ऐप्लिकेशन के खोज फ़ंक्शन में पास करें. पिछले कोड में, खोज क्वेरी, query कुंजी के रूप में पास की जाती है, "thing.name" को मैप करती है बीआईआई पैरामीटर. इसके बाद, क्वेरी डालकर खोजें और नतीजे इस भाषा में दिखाएं यूज़र इंटरफ़ेस पर काम करती है.

ज़रूरी नहीं: Assistant को ऐप्लिकेशन ऐक्शन के लिए शॉर्टकट भेजना

कार्रवाई की क्षमता तय करने के बाद, उपयोगकर्ता आपकी कुछ ऐसा कहें, "Ok Google, Example App से पिज़्ज़ा ऑर्डर करो." Assistant आपकी कार्रवाइयों के लिए, ज़रूरत के हिसाब से Android के शॉर्टकट का सुझाव दे सकती है इससे उन्हें आपकी कार्रवाइयाँ देखने और उन्हें फिर से चलाने का मौका मिलता है. असिस्टेंट डाइनैमिक और स्टैटिक, दोनों तरह के शॉर्टकट का सुझाव दे सकता है.

डाइनैमिक शॉर्टकट को Assistant पर पुश करने के लिए, Google शॉर्टकट इंटिग्रेशन का इस्तेमाल करें लाइब्रेरी. Jetpack की इस लाइब्रेरी की मदद से, Assistant आपके शॉर्टकट को इस्तेमाल कर सकती है और उन्हें सही समय पर उपयोगकर्ताओं को सुझा सकती है.

ज़्यादा जानकारी के लिए, Assistant पर डाइनैमिक शॉर्टकट भेजना लेख पढ़ें.

ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की झलक देखना

डेवलपमेंट और टेस्टिंग के दौरान, Android Studio के लिए Google Assistant प्लग इन का इस्तेमाल करके, यह जांच करें कि ऐप्लिकेशन ऐक्शन आपके ऐप्लिकेशन के लिए काम करते हैं या नहीं. यह प्लग इन, आपके Google खाते के लिए Assistant में ऐप्लिकेशन ऐक्शन की झलक बनाता है. टेस्ट टूल का इस्तेमाल करके, किसी फ़िज़िकल टेस्ट डिवाइस या एम्युलेटर पर, अपने फ़ुलफ़िलमेंट की जांच की जा सकती है. इसके लिए, बीआईआई को ऐसे इनपुट पैरामीटर दें जो आपको उपयोगकर्ताओं से मिलने की उम्मीद है.

अपनी ऐप्लिकेशन कार्रवाइयों की झलक देखते समय, आप डिवाइस. यह सुविधा सिर्फ़ ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों के बारे में बीआईआई रेफ़रंस. आवाज़ का इस्तेमाल करें ट्रिगर करने का काम सिर्फ़ प्रदर्शन के लिए करना है, न कि नियमित परीक्षण के लिए.

Google Play के लिए डेवलपर टूल का इस्तेमाल करके, ड्राफ़्ट मोड में अपने ऐप्लिकेशन की जांच करना ऐप्लिकेशन को समीक्षा के लिए सबमिट करने से पहले कंसोल. ड्राफ़्ट को डिप्लॉय करने के लिए, Google Play Console का इस्तेमाल करने के बारे में ज़्यादा जानकारी पाने के लिए अपने ऐप्लिकेशन के लिए, किसी ऐप्लिकेशन को बनाने और लॉन्च करने के लिए रिलीज़ के लिए है.

टेस्ट रिलीज़ बनाना

जब आप अन्य टेस्टर के साथ अपने ऐप्लिकेशन ऐक्शन की जांच करने के लिए तैयार हों, तो अपने ऐप्लिकेशन का इंटरनल या क्लोज़्ड टेस्ट रिलीज़ बनाएं. डिफ़ॉल्ट रूप से, इंटरनल और क्लोज़्ड रिलीज़ के टेस्टर, उन ऐप्लिकेशन ऐक्शन को ऐक्सेस कर सकते हैं जिनकी समीक्षा हो चुकी है और जिन्हें मंज़ूरी मिल चुकी है.

ऐप्लिकेशन की सभी कार्रवाइयों को जांच का ऐक्सेस देने के लिए, जिनमें ऐसी कार्रवाइयां भी शामिल हैं जिन्हें मंज़ूरी नहीं मिली है. अपने टेस्टर को इसमें शामिल होने का निर्देश दें ऐप्लिकेशन ऐक्शन डेवलपमेंट प्रोग्राम Google Group. इस ग्रुप के सदस्य ग्रुप के पास सभी 'ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों' का ऐक्सेस होता है. इंटरनल टेस्ट रिलीज़ बनाने की ज़रूरत नहीं है. इसके लिए, आपको ऐप्लिकेशन ऐक्शन टेस्ट टूल का इस्तेमाल करें. ग्रुप में शामिल होने के बाद, इसे तीन घंटे तक लग सकता है इसके लिए, आपको ज़रूरी शर्तें पूरी करनी होंगी.

ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की समीक्षा और डिप्लॉयमेंट की मांग करें

आपके पब्लिश किए गए ऐप्लिकेशन या ओपन टेस्ट के उपयोगकर्ताओं के लिए, ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयां उपलब्ध नहीं हैं तब तक रिलीज़ करें, जब तक उनकी समीक्षा नहीं हो जाती और उन्हें मंज़ूरी नहीं मिल जाती. ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की समीक्षा में आपके Android ऐप्लिकेशन की समीक्षा और Google Play में डिप्लॉयमेंट की स्थिति पर असर डाल सकती है. भले ही आपके ऐप्लिकेशन सबमिशन को मंज़ूरी मिल गई है और उसे Play Store पर पब्लिश कर दिया गया है, आपका ऐसा हो सकता है कि Google, shortcuts.xml की समीक्षा कर रहा हो. जब तक इस समीक्षा को भी मंज़ूरी नहीं मिल जाती, तब तक ऐप्लिकेशन ऐक्शन आपके असली उपयोगकर्ताओं के लिए काम नहीं करते.

जब आप अपने ऐप्लिकेशन को डिप्लॉय करते हैं, तो ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयां करने की सुविधा चालू रहती है. हालांकि, फिर से डिप्लॉय किए गए वर्शन की समीक्षा Google करेगा. अगर नया वर्शन ठीक से काम नहीं कर रहा है या उसमें नीति का उल्लंघन होता है, तो Google आपके ऐप्लिकेशन के लिए ऐप्लिकेशन ऐक्शन की सुविधा बंद कर सकता है.

ऐप्लिकेशन ऐक्शन को समीक्षा के लिए सबमिट करने के लिए, यह तरीका अपनाएं:

  1. Google Play Console में, ऐप्लिकेशन ऐक्शन की सेवा की शर्तें स्वीकार करें (बेहतर सेटिंग > ऐप्लिकेशन ऐक्शन):

    Google Play Console में, ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों से जुड़ी सेवा की शर्तें.

  2. shortcuts.xml वाला अपना ऐप्लिकेशन अपलोड करें पब्लिश करने के लिए सामान्य तौर पर Google Play Console.

  3. Play Console में ऐप्लिकेशन अपलोड करने के बाद, Google आपसे आपके Play Console खाते में दिया गया एक ऐसा ईमेल पता दें जिसमें स्थिति के बारे में ज़्यादा जानकारी दी गई हो आपके ऐप्लिकेशन का कार्रवाइयों की समीक्षा. Assistant डेवलपर सहायता टीम से भी संपर्क किया जा सकता है ऐप्लिकेशन की कार्रवाइयों की समीक्षा की स्थिति के बारे में सवाल शामिल करें. संपर्क में फ़ॉर्म में, अपना ऐप्लिकेशन पैकेज आईडी दें और ऐप्लिकेशन कार्रवाई की समीक्षा चुनें हम आपकी किस तरह मदद कर सकते हैं? चुनने के लिए बॉक्स.

ऐप्लिकेशन ऐक्शन का इस्तेमाल करके Activity को लॉन्च करने के लिए, Activity को डीप लिंक यूआरएल के साथ सेट अप करना होगा. साथ ही, Android ऐप्लिकेशन मेनिफ़ेस्ट में उससे जुड़ा इंटेंट फ़िल्टर होना चाहिए.

यह जांचने के लिए कि आपकी गतिविधियों को ऐक्सेस किया जा सकता है और उन्हें ट्रिगर किया जा सकता है डीप लिंक का इस्तेमाल करने वाले ऐप्लिकेशन की खास सुविधाओं के लिए, यह adb निर्देश चलाएं:

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

उदाहरण के लिए:

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

अगर adb निर्देश देने से आपकी गतिविधि सही तरीके से लॉन्च नहीं होती है, तो इनकी जांच करें:

  • आपकी ऐप्लिकेशन मेनिफ़ेस्ट फ़ाइल में, गतिविधि में android:exported=true मौजूद है, ताकि यह काम कर सके लॉन्च करने के लिए, Google Assistant के इंटेंट का इस्तेमाल करें.
  • अगर ऐप्लिकेशन लिंक के यूआरएल का इस्तेमाल किया जा रहा है, तो इसमें दिए गए सभी चरण अपनाएं Android ऐप्लिकेशन के लिंक मैनेज करना.

ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों से जुड़ी नीतियां

ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों को कुछ नीतियों का पालन करना होगा. इससे, यह पक्का करने में मदद मिलेगी कि इससे उन्हें उम्मीद के मुताबिक अनुभव मिलता है. अपने ऐप्लिकेशन सबमिट करने से पहले इन नीतियों को पढ़ें. इससे, उपयोगकर्ताओं को बेहतर अनुभव मिलेगा. साथ ही, Play Store पर ऐप्लिकेशन की समीक्षा में लगने वाले समय में कमी आएगी या ऐप्लिकेशन अस्वीकार होने से बचा जा सकेगा.

  • उपयोगकर्ताओं को उनके हिसाब से बनाए गए कॉन्टेंट पर ले जाना

    ऐप्लिकेशन की ख़ास सुविधाओं के लिए कार्रवाई बिल्ट-इन इंटेंट (बीआईआई) और/या पैरामीटर को उपयोगकर्ताओं को सिर्फ़ उपयोगकर्ता की ज़रूरत को ध्यान में रखकर की जाने वाली कार्रवाई की जा सके. इसमें इन-ऐप्लिकेशन कॉन्टेंट, या स्लाइस या विजेट में दिखाई गई जानकारी तब तक अनुभव उपयोगकर्ता का होना चाहिए.

    उदाहरण के लिए, START_EXERCISE बीआईआई को लागू करने से, उपयोगकर्ताओं को मदद मिलती है किसी ख़ास तरह की कसरत शुरू करने के लिए. उदाहरण के लिए, दौड़ना या तैरना. सिर्फ़ इस नीति का अपवाद यह है कि जब आपका OPEN_APP_FEATURE बीआईआई लोगों को रीडायरेक्ट करता है आपके ऐप्लिकेशन की होम स्क्रीन पर.

  • ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों के बीआईआई लागू करना

    लागू किए गए बीआईआई, ऐप्लिकेशन के कॉन्टेंट से सीधे तौर पर जुड़े होने चाहिए और सुविधा पर काम करता है.

    उदाहरण के लिए, अगर आपका ऐप्लिकेशन 'कम्यूनिकेशन Play स्टोर' कैटगरी में है, START_EXERCISE बीआईआई को लागू न करें, इसका सुझाव, सेहत और फ़िटनेस कैटगरी के ऐप्लिकेशन के लिए दिया जाता है.

  • काम के कस्टम इंटेंट लागू करना

    कस्टम इंटेंट के लिए तय की गई क्वेरी, ऐप्लिकेशन के कॉन्टेंट से जुड़ी होती हैं और सुविधा पर काम करता है. इस तरह के संभावित उल्लंघन का एक उदाहरण नीति का मकसद custom.action.intent.GET_RECIPE इंटेंट क्वेरी पैटर्न "मुझे बरीटो की रेसिपी दिखाओ" एक ऐप के लिए Play Store में परिवहन की कैटगरी.