बातचीत वाली कार्रवाइयों को 13 जून, 2023 को बंद कर दिया जाएगा. ज़्यादा जानकारी के लिए, बातचीत की कार्रवाइयों का बंद होना देखें.

Assistant के लिंक

ऐसा यूआरएल जनरेट किया जा सकता है जो सीधे आपकी कार्रवाई के किसी खास मकसद से जुड़ा हो. वेब या मोबाइल ब्राउज़र में, Assistant लिंक पर क्लिक करने वाले उपयोगकर्ताओं को उनके डिवाइस पर Assistant पर भेजा जाता है. यहाँ वे सीधे आपकी कार्रवाई से इंटरैक्ट करते हैं.

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

यहाँ कुछ ऐसे हालात दिए हैं जिनमें Assistant के लिंक मददगार हो सकते हैं:

  • उपयोगकर्ताओं को 'कैसे करें' निर्देशों वाले वेबसाइट से बोलकर निर्देश देने के लिए लिंक.
  • सहायता पेज पर मौजूद ग्राहक सहायता अनुभव के साथ उपयोगकर्ताओं को जोड़ना.
  • उपयोगकर्ताओं को अपडेट करने की इच्छा से जोड़कर, वे आपके आने वाले अपडेट के लिए ऑप्ट-इन कर सकते हैं.

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

किसी कार्रवाई के लिए यूआरएल जनरेट करने के लिए, यह तरीका अपनाएं:

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

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

Assistant की मदद से, लिंक की जांच किसी भी इंटेंट (मुख्य या कस्टम) के साथ की जा सकती है. ऐसा, सिम्युलेटर के ज़रिए या डिवाइस के ज़रिए किया जा सकता है.

किसी डिवाइस पर अपने Assistant लिंक की जांच करने के लिए, यह तरीका अपनाएं:

  1. Actions कंसोल में Assistant का लिंक जनरेट करें.
  2. Assistant के लिंक को यूआरएल के तौर पर खुद को ईमेल, चैट मैसेज या दूसरे फ़ॉर्मैट में भेजें.
  3. Assistant की सुविधा वाले डिवाइस पर, Assistant में उसी खाते से साइन इन करें जिसका इस्तेमाल आपने अपना Actions प्रोजेक्ट बनाने के लिए किया था.
  4. इसके बाद, उसी डिवाइस पर Assistant के उस लिंक पर क्लिक करें जो आपने खुद भेजा था.

Assistant के सही तरीके से लिंक करने की सुविधा की पुष्टि करने के बाद, आपको अपनी कार्रवाई फिर से डिप्लॉय करनी होगी, ताकि यह लिंक आपके उपयोगकर्ताओं को उपलब्ध हो सके.

Assistant के लिंक में, वैकल्पिक तौर पर यूआरएल का इंटेंट और पैरामीटर शामिल हो सकते हैं. कैंपेन पैरामीटर जोड़ने के लिए कैंपेन पैरामीटर सेक्शन का इस्तेमाल करें.

जब Assistant लिंक में कोई दूसरा पैरामीटर नहीं होता, तो Google Assistant इन कार्रवाइयों के साथ आपकी कार्रवाई के MAIN इंटेंट (actions.intent.MAIN) को लिंक करती है:

  • अगर आपने Assistant के लिंक में साफ़ तौर पर MAIN इंटेंट चालू नहीं किया है, तो Assistant, बिना किसी पैरामीटर के मुख्य इंटेंट से मेल खाती है. यह "app_name के लिए बात करें" की तरह काम करता है.
  • अगर आपने साफ़ तौर पर MAIN इंटेंट चालू किया है, तो Assistant आपकी कार्रवाइयों के लिए पैरामीटर पास करती है.

यहां MAIN लिंक का इस्तेमाल करके, Assistant के लिंक यूआरएल का उदाहरण दिया गया है. इसमें कोई दूसरा पैरामीटर नहीं जोड़ा गया है:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

Assistant लिंक के यूआरएल का सामान्य सिंटैक्स इस तरह होता है:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

सेट किए जा सकने वाले यूआरएल पैरामीटर की जानकारी नीचे दी गई टेबल में दी गई है:

यूआरएल पैरामीटर ब्यौरा
$action_id कार्रवाई के लिए संख्या वाला आइडेंटिफ़ायर.
$intent पहले से मौजूद या उपयोगकर्ता के मकसद का पूरा नाम.
$param कार्रवाई पैकेज में बताए गए इंटेंट पैरामीटर का पूरा नाम.
$value $param के लिए तय किया गया टाइप और यूआरएल का कोड में बदला गया मान.
$utm_param एक या उससे ज़्यादा UTM पैरामीटर टाइप की सूची. सही वैल्यू ये हैं: utm_source, utm_medium, utm_campaign, utm_term, और utm_content.
$utm_value UTM पैरामीटर की स्ट्रिंग वैल्यू.

अगर Assistant लिंक में कोई बिल्ट-इन इंटेंट है (इंटेंट actions.intent. से शुरू होती है), तो Google Assistant यूआरएल में पहले से मौजूद इंटेंट पैरामीटर को निकालने की कोशिश करती है. साथ ही, उन्हें आपकी कार्रवाई में पास कर देती है. ऐसे सभी पैरामीटर हटा दिए जाते हैं जिन्हें Assistant, बिल्ट-इन इंटेंट पैरामीटर के तौर पर नहीं समझती हो.

बातचीत वाली कार्रवाइयों के लिए, Assistant इन कार्रवाइयों को आपके ऑर्डर पूरा करने के लिए, AppRequest मैसेज के हिस्से के तौर पर भेजती है.

इस उदाहरण में बताया गया है कि आप Assistant के लिंक यूआरएल का इस्तेमाल कैसे करें, जिसमें एक इंटेंट पैरामीटर के साथ बिल्ट-इन इंटेंट शामिल होता है:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME&param.name=%22ExampleGame%22

उपयोगकर्ता के इंटेंट के लिए, Google Assistant सिर्फ़ उन पैरामीटर को निकालता है जो इंटेंट के हिस्से के तौर पर आपकी कार्रवाई के ज़रिए तय किए गए हैं. साथ ही, यह किसी भी दूसरे पैरामीटर को खारिज कर देता है.

इस उदाहरण में बताया गया है कि आप Assistant के लिंक यूआरएल का इस्तेमाल कैसे करें, जिसमें उपयोगकर्ता का इंटेंट शामिल होता है:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

ऊपर दिए गए उदाहरण के लिए, AppRequest में JSON, इस तरह से एक JSON ऑब्जेक्ट जोड़ता है:

argument {
  name: 'topic',
  raw_text: 'sports',
  text_value: 'sports',
}

UTM पैरामीटर ऐसी स्ट्रिंग होती हैं जिन्हें Google Assistant आपके ऐक्शन पर भेजती है. ऐसा तब होता है, जब उपयोगकर्ता Assistant के किसी लिंक पर क्लिक करते हैं. आंकड़ों के लिए, बाद में इन स्ट्रिंग में मौजूद जानकारी का इस्तेमाल किया जा सकता है.

Assistant, आपकी कार्रवाई के लिए जो UTM पैरामीटर भेजती है, उनमें ये शामिल हैं:

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

इस उदाहरण में बताया गया है कि आप Assistant लिंक का यूआरएल कैसे बता सकते हैं, जिसमें UTM पैरामीटर शामिल हों:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

ऊपर दिए गए उदाहरण के लिए, Assistant AppRequest मैसेज में ये तर्क जोड़ती है:

argument {
  name: 'utm_source',
  raw_text: 'Google',
  text_value: 'Google',
}
argument {
  name: 'utm_medium',
  raw_text: 'email',
  text_value: 'email',
}
argument {
  name: 'utm_campaign',
  raw_text: 'holiday sale',
  text_value: 'holiday sale',
}

रिच असिस्टेंट लिंक की मदद से, आपको अपनी वेबसाइट पर कार्रवाई को आसानी से खोजने में मदद मिलती है. इसके लिए, Assistant.js का इस्तेमाल किया जा सकता है. उपयोगकर्ता, आपकी कार्रवाई को आज़मा सकते हैं. साथ ही, खाता लिंक करने की सुविधा का इस्तेमाल करके, अपने Google खाते को सेवा से लिंक कर सकते हैं.

जब कोई उपयोगकर्ता आपकी वेबसाइट पर आता है, तब उसे "Google Assistant के साथ आज़माएं" बटन दिखता है. यह बटन, रिच असिस्टेंट लिंक के फ़्लो को ट्रिगर करता है.

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

खाता जोड़ने की सुविधा के साथ इस्तेमाल किए जाने पर, रिच असिस्टेंट लिंक आपके अनुमति देने वाले यूआरएल का इस्तेमाल करता है. यह यूआरएल आपके प्रोजेक्ट में, Actions कंसोल में सेट होता है. ज़्यादा जानकारी के लिए, खाता लिंक करने से जुड़ा दस्तावेज़ देखें.

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

रिच असिस्टेंट लिंक का इस्तेमाल करने के लिए, आपको इन चीज़ों की ज़रूरत होगी:

स्थानीय विकास

अपनी वेबसाइट पर रिच Assistant लिंक शामिल करने के लिए, नीचे दिया गया तरीका अपनाएं:

  1. अपने कार्रवाइयों वाले प्रोजेक्ट आईडी से <PROJECT_ID> को बदलकर, अपने पेज पर यह JavaScript लाइब्रेरी शामिल करें:

    <script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
</script>

  2. अपने पेज पर कहीं भी, नीचे दिया गया एचटीएमएल टैग जोड़ें. यह इनलाइन "Google Assistant को आज़माएं" बटन को लोड करता है:

    <google-assistant-link-group>
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

अपने-आप ट्रिगर होने की सुविधा

अगर आपको लगता है कि जब उपयोगकर्ता पहली बार आपके पेज पर आएं, तो रिच रिज़ल्ट लिंक का फ़्लो अपने-आप शुरू हो जाए. इसके लिए, <google-assistant-proactive-link> टैग का इस्तेमाल करें. अगर आपने इस टैग को लागू किया, तो उपयोगकर्ताओं के पहली बार पेज पर जाने के बिना ही उन्हें लिंक मिल जाएगा. इसके लिए, उन्हें इनलाइन बटन नहीं चुनना होगा.

  1. Assistant के लिंक किए गए अपने ग्रुप के टैग में id जोड़ें:

    <google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

  2. अपने वेबपेज पर <google-assistant-proactive-action-link> टैग डालें और उसके groupId एट्रिब्यूट को id पर सेट करें:

    <google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

<google-assistant-proactive-link
groupId="my-group">
</google-assistant-proactive-link>

डिप्लॉयमेंट

रिच Assistant लिंक सिर्फ़ उन डोमेन के लिए काम करते हैं जिनका मालिकाना हक आपके पास है और जिनकी Google से पुष्टि हो चुकी है. स्थानीय तौर पर डेवलप करते समय, इस ज़रूरी शर्त को बायपास किया जाता है. इसके लिए, आपके पास Actions प्रोजेक्ट का ऐक्सेस होता है, आपके Google खाते में लॉग इन किया जाता है, और आपके स्क्रिप्ट टैग में dev=true क्वेरी पैरामीटर सेट किया जाता है.

  <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
  </script>

अपने ऐक्शन को रिच Assistant लिंक के साथ डिप्लॉय करने के लिए:

  1. कार्रवाइयों वाले कंसोल में, अपना सार्वजनिक डोमेन रजिस्टर करें > ब्रैंड की पुष्टि > कनेक्ट साइट पर जाएं.

  2. स्क्रिप्ट से dev=true क्वेरी पैरामीटर हटाएं:

    <script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}">
</script>

पाबंदियां और सबसे सही तरीके

नीचे दी गई पाबंदियां और सबसे सही तरीके लागू होते हैं, ताकि Assistant के लिंक का यूआरएल, डायरेक्ट्री या Google की दूसरी सेवाओं से बाहर दिखाया और दिया जा सके:

  • Assistant के सभी लिंक से जुड़ी सहायता मिलती रहेगी. अगर आपने कोई ऐसा Assistant लिंक दिया है जो बाद में काम करना बंद कर देता है, तो आपके Actions प्रोजेक्ट को बुरे बर्ताव के तौर पर फ़्लैग किया जा सकता है और उसे हटाया जा सकता है.

  • किसी लिंक को प्रकाशित करने का मतलब है कि आप गैर-भरोसेमंद स्रोतों से ट्रिगर करने की सुविधा देते हैं. लिंक की गई किसी भी कार्रवाई के लिए, आपको उपयोगकर्ता से साफ़ तौर पर पुष्टि करानी होगी. उदाहरण के लिए, ऐसी कार्रवाई जो स्मार्ट होम डिवाइस को बंद करती है, उपयोगकर्ता से यह कहना चाहिए कि, "क्या आपको वाकई $applianceName बंद करना है?"

    इस संदर्भ में, असल कार्रवाई ऐसी कोई भी कार्रवाई है जिससे उपयोगकर्ता की सेवाओं, डेटा, डिवाइस, नेटवर्क, कंप्यूटर या एपीआई पर असर पड़ता है. उदाहरण के लिए, ईमेल भेजना, लेन-देन करना, स्मार्ट घरेलू उपकरण की स्थिति बदलना, सदस्यता बनाना या किसी कॉन्टेंट को अपडेट करना.