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

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

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

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

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

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

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

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

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

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

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

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

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

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

ऐप्लिकेशन ऐक्शन बनाने का ज़्यादातर हिस्सा, आपके Android ऐप्लिकेशन की shortcuts.xml रिसॉर्स फ़ाइल में क्षमता का एलान करना है. यहां आपको चुना गया बीआईआई और उससे जुड़ी जानकारी देनी होती है. बीआईआई किसी टास्क के लिए उपयोगकर्ता की क्वेरी को मॉडल करता है और ग्राहक को पूरा करने के मकसद से, 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 बीआईआई पैरामीटर को 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 बीआईआई लागू करना होगा. इसके बाद, जब उपयोगकर्ता "Ok Google, Example App पर Example Thing खोजें" जैसी क्वेरी करते हैं, तब Assistant, आपके ऐप्लिकेशन के खोज फ़ंक्शन को, ऐप्लिकेशन में खोज करने की सुविधा पर भेज सकती है.

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

यहां shortcuts.xml में actions.intent.GET_THING BII जोड़ने का उदाहरण दिया गया है:

  <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" BII पैरामीटर से मैप होती है. इसके बाद, क्वेरी की मदद से खोज करें और नतीजों को यूज़र इंटरफ़ेस में दिखाएं.

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

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

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

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

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

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

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

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

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

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

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

ऐप्लिकेशन ऐक्शन की समीक्षा और डिप्लॉयमेंट का अनुरोध करना

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

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

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

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

   

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

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 Store की कम्यूनिकेशन कैटगरी में है, तो START_EXERCISE बीआईआई लागू न करें. इसका सुझाव, हेल्थ और फ़िटनेस कैटगरी के ऐप्लिकेशन के लिए दिया जाता है.

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

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