आपकी कार्रवाइयों का लिंक (Dialogflow)

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

Assistant के काम के लिंक के कुछ उदाहरण यहां दिए गए हैं:

उपयोगकर्ताओं को किसी वेबसाइट पर, बोलकर दिए जाने वाले निर्देशों के साथ लिंक करना.
उपयोगकर्ताओं को "सहायता पाएं" पेज से, ग्राहक सहायता अनुभव से लिंक करना.
उपयोगकर्ताओं को किसी अपडेट इंटेंट से लिंक करना, ताकि वे आपके आने वाले अपडेट के लिए ऑप्ट-इन कर सकें.

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

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

उपयोगकर्ताओं को इस कार्रवाई पर ले जाने के लिए, दिए गए यूआरएल को कॉपी किया जा सकता है और उसका रेफ़रंस दिया जा सकता है.

Assistant लिंक पैरामीटर

Assistant लिंक के यूआरएल में, वैकल्पिक तौर पर एक इंटेंट और पैरामीटर शामिल हो सकते हैं. Google, यूआरएल में दिए गए इंटेंट टाइप के मुताबिक पैरामीटर को हैंडल करता है.

Assistant के लिंक के यूआरएल की खास बातें

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 में पहले से मौजूद इंटेंट वाले यूआरएल लिंक करें

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

बातचीत वाली कार्रवाइयों के लिए, Google इन पैरामीटर को AppRequest मैसेज के हिस्से के तौर पर, आपके फ़ुलफ़िलमेंट में भेजता है.

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

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE&param.astrologySign=%22cancer%22

Assistant की मदद से, कस्टम इंटेंट वाले यूआरएल लिंक करना

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

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

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

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

argument {
  name: ‘topic’,
  raw_text: ‘sports’,
  text_value: ‘sports’,
}

Assistant के बिना किसी इंटेंट वाले लिंक के यूआरएल

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

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

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

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

UTM पैरामीटर वाले Assistant लिंक वाले यूआरएल

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

Google आपकी सेट की गई कार्रवाई को 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

ऊपर दिए गए उदाहरण यूआरएल के लिए, Google 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 के लिंक की जाँच करें

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

Assistant के लिंक की जाँच करने के लिए:

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

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

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

अब Assistant के लिंक का यूआरएल, डायरेक्ट्री या Google की दूसरी सेवाओं के बाहर भी इस्तेमाल और रेफ़र किया जा सकता है. इसलिए, कृपया ध्यान रखें कि ये पाबंदियां और सबसे सही तरीके लागू होते हैं:

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

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