- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- UserInput
- InputType
- DeviceProperties
- प्लैटफ़ॉर्म
- जगह
- LatLng
- आउटपुट
- कैनवस
- सूचना
- आसान
- कॉन्टेंट
- कार्ड
- इमेज
- ImageFill
- लिंक
- OpenUrl
- UrlHint
- टेबल
- TableColumn
- HorizontalAlignment
- TableRow
- TableCell
- मीडिया
- MediaType
- OptionalMediaControls
- MediaObject
- MediaImage
- डेटा इकट्ठा करना
- CollectionItem
- सूची
- ListItem
- सुझाव
- गड़बड़ी की जानकारी
- ExecutionEvent
- ExecutionState
- स्लॉट
- SlotFillingStatus
- स्लॉट
- SlotMode
- SlotStatus
- स्टेटस
- UserConversationInput
- IntentMatch
- ConditionsEvaluated
- स्थिति
- OnSceneEnter
- WebhookRequest
- WebhookResponse
- WebhookInitiatedTransition
- SlotMatch
- SlotRequested
- SlotValidated
- FormFilled
- WaitingForUserInput
- EndConversation
बातचीत का एक राउंड चलाता है.
एचटीटीपी अनुरोध
POST https://actions.googleapis.com/v2/{project=projects/*}:sendInteraction
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
project |
ज़रूरी है. जिस प्रोजेक्ट की जांच की जा रही है वह प्रोजेक्ट आईडी से पता चलता है. फ़ॉर्मैट: प्रोजेक्ट/{project} |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना | |
---|---|
{ "input": { object ( |
फ़ील्ड | |
---|---|
input |
ज़रूरी है. उपयोगकर्ता से मिला इनपुट. |
deviceProperties |
ज़रूरी है. कार्रवाई के साथ इंटरैक्ट करने के लिए इस्तेमाल किए जाने वाले डिवाइस की प्रॉपर्टी. |
conversationToken |
ओपेक टोकन, जिसे पिछले इंटरैक्शन पर Sendइंटरैक्शनResponse से हासिल किए जाने के तौर पर पास किया जाना ज़रूरी है. टेस्टिंग सेशन के पहले इंटरैक्शन के तौर पर या पिछली बातचीत को छोड़कर, नई बातचीत शुरू करने के लिए, इस सेटिंग को सेट नहीं किया जा सकता है. |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
बातचीत के एक राउंड का जवाब देना.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "output": { object ( |
फ़ील्ड | |
---|---|
output |
उपयोगकर्ता को दिया गया आउटपुट. |
diagnostics |
गड़बड़ी की जानकारी, जिससे यह पता चलता है कि अनुरोध पर किस तरह कार्रवाई की गई है. |
conversationToken |
उसी बातचीत को जारी रखने के लिए, अगले RPC कॉल में Sendइंटरैक्शनRequest पर ओपेक टोकन सेट किया जाएगा. |
UserInput
बातचीत वाले राउंड में उपयोगकर्ता का इनपुट.
जेएसओएन के काेड में दिखाना | |
---|---|
{
"query": string,
"type": enum ( |
फ़ील्ड | |
---|---|
query |
उपयोगकर्ता के भेजे गए इनपुट का कॉन्टेंट. |
type |
इनपुट का टाइप. |
InputType
इनपुट सोर्स, टाइप की गई क्वेरी या वॉइस क्वेरी के बारे में बताता है.
Enums | |
---|---|
INPUT_TYPE_UNSPECIFIED |
इनपुट सोर्स की जानकारी नहीं है. |
TOUCH |
GUI इंटरैक्शन से मिली क्वेरी. |
VOICE |
बोलकर खोजने की सुविधा. |
KEYBOARD |
टाइप की गई क्वेरी. |
URL |
यह कार्रवाई किसी यूआरएल लिंक से ट्रिगर हुई थी. |
DeviceProperties
बातचीत वाले राउंड के लिए काम के डिवाइस की प्रॉपर्टी.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "surface": enum ( |
फ़ील्ड | |
---|---|
surface |
कार्रवाई के साथ इंटरैक्ट करने के लिए इस्तेमाल किया जाने वाला प्लैटफ़ॉर्म. |
location |
डिवाइस की जगह की जानकारी, जैसे कि अक्षांश, देशांतर, और फ़ॉर्मैट किया गया पता. |
locale |
डिवाइस पर सेट के मुताबिक स्थान-भाषा का इस्तेमाल करें. फ़ॉर्मैट, BCP 47 के हिसाब से होना चाहिए: https://tools.ietf.org/html/bcp47 उदाहरण: en, en-US, es-419 (ज़्यादा उदाहरण https://tools.ietf.org/html/bcp47#appendix-A) पर देखें. |
timeZone |
डिवाइस पर सेट किया गया टाइम ज़ोन. फ़ॉर्मैट को आईएएनए टाइम ज़ोन डेटाबेस के मुताबिक होना चाहिए, जैसे कि "America/New_York": https://www.iana.org/time-zones |
प्लैटफ़ॉर्म
कार्रवाई के साथ इंटरैक्ट करने के लिए इस्तेमाल किए गए संभावित प्लैटफ़ॉर्म. आने वाले समय में इसमें और वैल्यू शामिल की जा सकती हैं.
Enums | |
---|---|
SURFACE_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है. |
SPEAKER |
स्पीकर (जैसे, Google Home). |
PHONE |
फ़ोन. |
ALLO |
Allo चैट. |
SMART_DISPLAY |
स्मार्ट डिसप्ले डिवाइस. |
KAI_OS |
KaiOS. |
जगह
किसी जगह को दिखाने वाला कंटेनर.
जेएसओएन के काेड में दिखाना | |
---|---|
{
"coordinates": {
object ( |
फ़ील्ड | |
---|---|
coordinates |
भौगोलिक निर्देशांक. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] की अनुमति ज़रूरी है. |
formattedAddress |
डिसप्ले पता, जैसे कि "1600 Amphitheatre Pkwy, Mountain View, CA 94043". [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] की अनुमति ज़रूरी है. |
zipCode |
पिन कोड. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] या [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] की अनुमति ज़रूरी है. |
city |
शहर. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] या [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] की अनुमति ज़रूरी है. |
LatLng
ऐसा ऑब्जेक्ट जो अक्षांश/देशांतर के जोड़े को दिखाता है. डिग्री अक्षांश और डिग्री देशांतर दिखाने के लिए इसे 'डबल्स' के जोड़े के तौर पर दिखाया जाता है. जब तक कि इसके अलावा कोई और निर्देश न दिया गया हो, तब तक यह ऑब्जेक्ट WGS84 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य रेंज के अंदर होनी चाहिए.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "latitude": number, "longitude": number } |
फ़ील्ड | |
---|---|
latitude |
डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए. |
longitude |
डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए. |
आउटपुट
बातचीत वाले राउंड में, उपयोगकर्ता को दिखने वाला आउटपुट.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "text": string, "speech": [ string ], "canvas": { object ( |
फ़ील्ड | |
---|---|
text |
उपयोगकर्ता को सामान्य स्ट्रिंग के तौर पर बोला गया जवाब भेजा गया. |
speech[] |
कार्रवाई के ज़रिए तैयार की गई बोली का कॉन्टेंट. इसमें एसएसएमएल जैसे मार्कअप एलिमेंट शामिल हो सकते हैं. |
canvas |
इंटरैक्टिव कैनवस कॉन्टेंट. |
actionsBuilderPrompt |
बातचीत वाले राउंड के आखिर में, प्रॉम्प्ट की स्थिति. प्रॉम्प्ट के बारे में ज़्यादा जानकारी: https://developers.google.com/assistant/conversational/prompts |
कैनवस
उपयोगकर्ता को भेजे जाने वाले इंटरैक्टिव कैनवस रिस्पॉन्स को दिखाता है. इसका इस्तेमाल, इंटरैक्टिव कैनवस रिस्पॉन्स दिखाने के साथ-साथ, उपयोगकर्ता से बात करने के लिए दिए गए प्रॉम्प्ट में "firstसिंपल" फ़ील्ड के साथ किया जा सकता है. रिस्पॉन्स का साइज़ ज़्यादा से ज़्यादा 50 हज़ार बाइट हो सकता है.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "url": string, "data": [ value ], "suppressMic": boolean, "enableFullScreen": boolean } |
फ़ील्ड | |
---|---|
url |
लोड किए जाने वाले इंटरैक्टिव कैनवस वेब ऐप्लिकेशन का यूआरएल. अगर यह नीति सेट नहीं है, तो मौजूदा चालू कैनवस के यूआरएल का फिर से इस्तेमाल किया जाएगा. |
data[] |
ज़रूरी नहीं. JSON डेटा को इवेंट के तौर पर, ध्यान खींचने वाले वेब पेज पर भेजा जाएगा. अगर शामिल प्रॉम्प्ट में "ओवरराइड करें" फ़ील्ड "गलत" है, तो इस कैनवस प्रॉम्प्ट में तय की गई डेटा वैल्यू, पिछले कैनवस प्रॉम्प्ट में तय की गई डेटा वैल्यू के बाद जोड़ दी जाएंगी. |
suppressMic |
ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू: false. |
enableFullScreen |
अगर |
शीघ्र
किसी उपयोगकर्ता को जवाब देना.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "append": boolean, "override": boolean, "firstSimple": { object ( |
फ़ील्ड | |
---|---|
append |
ज़रूरी नहीं. इस मोड में, पहले तय किए गए मैसेज के साथ इस मैसेज को कैसे मर्ज किया जाना चाहिए. "गलत" पहले से तय किए गए सभी मैसेज (फ़र्स्ट और लास्ट सिंपल, कॉन्टेंट, सुझाव लिंक, और कैनवस) मिटा देगा. साथ ही, इस प्रॉम्प्ट में तय किए गए मैसेज जोड़ देगा. "true" चुनने पर, इस प्रॉम्प्ट में बताए गए मैसेज, पिछले जवाबों में बताए गए मैसेज में जुड़ जाएंगे. इस फ़ील्ड को "सही" पर सेट करने से, सिंपल प्रॉम्प्ट, सुझाव प्रॉम्प्ट, और कैनवस प्रॉम्प्ट (कॉन्टेंट प्रॉम्प्ट का हिस्सा) में, कुछ फ़ील्ड में जोड़ने की सुविधा भी चालू हो जाएगी. अगर प्रॉम्प्ट में बताया गया हो, तो कॉन्टेंट और लिंक वाले मैसेज को हमेशा के लिए बदल दिया जाएगा. डिफ़ॉल्ट वैल्यू "गलत" होती है. |
override |
ज़रूरी नहीं. इस मोड में, पहले तय किए गए मैसेज के साथ इस मैसेज को कैसे मर्ज किया जाना चाहिए. "true", पहले से तय किए गए सभी मैसेज (फ़र्स्ट और लास्ट सिंपल, कॉन्टेंट, सुझाव लिंक, और कैनवस) मिटा देता है. साथ ही, इस प्रॉम्प्ट में तय किए गए मैसेज जोड़ता है. "false" इस प्रॉम्प्ट में बताए गए मैसेज को, पिछले जवाबों में बताए गए मैसेज में जोड़ता है. इस फ़ील्ड को "गलत" पर सेट करने से, सिंपल प्रॉम्प्ट, सुझाव प्रॉम्प्ट, और कैनवस प्रॉम्प्ट (कॉन्टेंट प्रॉम्प्ट का हिस्सा) के अंदर कुछ फ़ील्ड जोड़ने की सुविधा चालू हो जाती है. अगर प्रॉम्प्ट में बताया गया हो, तो कॉन्टेंट और लिंक मैसेज को हमेशा ओवरराइट किया जाता है. डिफ़ॉल्ट वैल्यू "गलत" होती है. |
firstSimple |
ज़रूरी नहीं. बोलकर दिया गया पहला जवाब और सिर्फ़ टेक्स्ट जवाब. |
content |
ज़रूरी नहीं. उपयोगकर्ता को दिखाने के लिए कार्ड, सूची या मीडिया जैसा कॉन्टेंट. |
lastSimple |
ज़रूरी नहीं. बोलकर दिए जाने वाले आखिरी जवाब और सिर्फ़ टेक्स्ट के लिए जवाब. |
suggestions[] |
ज़रूरी नहीं. उपयोगकर्ता को दिखाए जाने के सुझाव, जो हमेशा जवाब के आखिर में दिखेंगे. अगर शामिल प्रॉम्प्ट में "ओवरराइड करें" फ़ील्ड "गलत" है, तो इस फ़ील्ड में तय किए गए टाइटल को पहले से तय किए गए सुझाव के सभी प्रॉम्प्ट में बताए गए टाइटल में जोड़ दिया जाएगा. साथ ही, डुप्लीकेट वैल्यू हटा दी जाएंगी. |
link |
ज़रूरी नहीं. सुझाव वाला एक अन्य चिप, जो आपकी वेबसाइट या ऐप्लिकेशन से लिंक किया जा सकता है. चिप को "खोलें |
canvas |
ज़रूरी नहीं. उपयोगकर्ता को भेजे जाने वाले इंटरैक्टिव कैनवस रिस्पॉन्स को दिखाता है. |
Simple
उपयोगकर्ता को भेजने के लिए आसान प्रॉम्प्ट दिखाता है.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "speech": string, "text": string } |
फ़ील्ड | |
---|---|
speech |
ज़रूरी नहीं. उपयोगकर्ता की बोली गई बातों को दिखाता है. यह एसएसएमएल या लिखाई को बोली में बदलने की सुविधा हो सकती है. अगर शामिल प्रॉम्प्ट में "ओवरराइड करें" फ़ील्ड "सही" है, तो इस फ़ील्ड में तय किया गया भाषण, पिछले सिंपल प्रॉम्प्ट के स्पीच को बदल देता है. |
text |
चैट बबल में दिखाने के लिए वैकल्पिक टेक्स्ट. अगर यह विकल्प नहीं दिया गया है, तो ऊपर दिए गए स्पीच फ़ील्ड की डिसप्ले रेंडरिंग का इस्तेमाल किया जाएगा. ज़्यादा से ज़्यादा 640 वर्ण डाले जा सकते हैं. अगर कंटेनिंग प्रॉम्प्ट में "ओवरराइड करें" फ़ील्ड "सही" है, तो इस फ़ील्ड में तय किया गया टेक्स्ट, पिछले सिंपल प्रॉम्प्ट के टेक्स्ट से बदल जाता है. |
कॉन्टेंट
दिखाया जाने वाला कॉन्टेंट.
जेएसओएन के काेड में दिखाना | |
---|---|
{ // Union field |
फ़ील्ड | ||
---|---|---|
यूनियन फ़ील्ड content . सामग्री. content इनमें से सिर्फ़ एक हो सकता है: |
||
card |
बुनियादी कार्ड. |
|
image |
इमेज. |
|
table |
टेबल कार्ड. |
|
media |
रिस्पॉन्स से यह पता चलता है कि मीडिया का कोई सेट, चलाया जाना है. |
|
canvas |
इंटरैक्टिव कैनवस अनुभव के लिए इस्तेमाल किया जाने वाला रिस्पॉन्स. |
|
collection |
चुनने के लिए विकल्पों का कलेक्शन दिखाने वाला कार्ड. |
|
list |
एक कार्ड, जिसमें चुनने के लिए विकल्पों की सूची है. |
कार्ड
कुछ जानकारी दिखाने के लिए एक बेसिक कार्ड, जैसे कि कोई इमेज और/या टेक्स्ट.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "title": string, "subtitle": string, "text": string, "image": { object ( |
फ़ील्ड | |
---|---|
title |
कार्ड का पूरा टाइटल. ज़रूरी नहीं. |
subtitle |
ज़रूरी नहीं. |
text |
कार्ड का मुख्य हिस्सा. फ़ॉर्मैटिंग के लिए, मार्कडाउन सिंटैक्स के सीमित सेट का इस्तेमाल किया जा सकता है. इमेज मौजूद नहीं होने तक ज़रूरी है. |
image |
कार्ड के लिए हीरो इमेज. ऊंचाई 192dp पर तय की जाती है. ज़रूरी नहीं. |
imageFill |
इमेज के बैकग्राउंड को किस तरह भरा जाएगा. ज़रूरी नहीं. |
button |
बटन. ज़रूरी नहीं. |
इमेज
कार्ड में दिखाई गई इमेज.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
फ़ील्ड | |
---|---|
url |
इमेज का सोर्स यूआरएल. इमेज JPG, PNG, और GIF (ऐनिमेटेड और नॉन-ऐनिमेटेड) की जा सकती हैं. उदाहरण के लिए, |
alt |
सुलभता के लिए इस्तेमाल की जाने वाली इमेज के बारे में टेक्स्ट की जानकारी, जैसे कि स्क्रीन रीडर. ज़रूरी है. |
height |
पिक्सल में इमेज की ऊंचाई. ज़रूरी नहीं. |
width |
पिक्सल में इमेज की चौड़ाई. ज़रूरी नहीं. |
ImageFill
इमेज को दिखाने के संभावित विकल्प, जिनसे इमेज के प्रज़ेंटेशन पर असर पड़ता है. इसका इस्तेमाल तब करना चाहिए, जब इमेज का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात), इमेज कंटेनर के आसपेक्ट रेशियो से मेल नहीं खाता.
Enums | |
---|---|
UNSPECIFIED |
इमेज भरने की जानकारी नहीं है. |
GRAY |
इमेज और इमेज कंटेनर के बीच की खाली जगहों को स्लेटी रंग के बार से भरें. |
WHITE |
इमेज और इमेज कंटेनर के बीच की खाली जगहों को सफ़ेद बार से भरें. |
CROPPED |
इमेज का साइज़ इस तरह से बढ़ाया जाता है कि इमेज की चौड़ाई और ऊंचाई, कंटेनर के डाइमेंशन से ज़्यादा हो या उसकी चौड़ाई से ज़्यादा हो. अगर इमेज की स्केल की गई ऊंचाई कंटेनर की ऊंचाई से ज़्यादा है, तो यह इमेज के ऊपरी और निचले हिस्से को काट सकता है. इसके अलावा, अगर इमेज की स्केल की गई चौड़ाई कंटेनर की चौड़ाई से ज़्यादा है, तो इमेज के बाएं और दाएं हिस्से को काटें. यह 4:3 आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) वाला वीडियो चलाते समय वाइडस्क्रीन टीवी पर "ज़ूम मोड" के जैसा है. |
लिंक
कॉन्टेंट लिंक करें.
जेएसओएन के काेड में दिखाना | |
---|---|
{
"name": string,
"open": {
object ( |
फ़ील्ड | |
---|---|
name |
लिंक का नाम |
open |
जब कोई उपयोगकर्ता लिंक खोलता है, तो क्या होता है |
OpenUrl
जब उपयोगकर्ता कोई लिंक खोलता है, तब यह कार्रवाई की जाती है.
जेएसओएन के काेड में दिखाना | |
---|---|
{
"url": string,
"hint": enum ( |
फ़ील्ड | |
---|---|
url |
यूआरएल फ़ील्ड इनमें से कोई भी हो सकता है: - ऐप्लिकेशन से लिंक किए गए ऐप्लिकेशन या वेबपेज को खोलने के लिए http/https यूआरएल |
hint |
यूआरएल टाइप के लिए संकेत दिखाता है. |
UrlHint
यूआरएल से जुड़े अलग-अलग तरह के संकेत.
Enums | |
---|---|
LINK_UNSPECIFIED |
सेट नहीं है |
AMP |
वह यूआरएल जो सीधे एएमपी कॉन्टेंट पर ले जाता है या ऐसे कैननिकल यूआरएल पर ले जाता है जो के ज़रिए एएमपी कॉन्टेंट के बारे में बताता है. |
टेबल
टेक्स्ट की टेबल दिखाने के लिए टेबल कार्ड.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
फ़ील्ड | |
---|---|
title |
टेबल का पूरा टाइटल. सबटाइटल सेट करना ज़रूरी नहीं है. हालांकि, अगर सबटाइटल सेट किए गए हैं, तो इसको सेट करना भी ज़रूरी है. |
subtitle |
टेबल के लिए सबटाइटल. ज़रूरी नहीं. |
image |
टेबल से जुड़ी इमेज. ज़रूरी नहीं. |
columns[] |
कॉलम के हेडर और अलाइनमेंट. |
rows[] |
टेबल की लाइन का डेटा. इस बात की गारंटी है कि पहली तीन लाइनें ही दिखेंगी, लेकिन हो सकता है कि कुछ लाइनों को कुछ प्लैटफ़ॉर्म पर काटा जाए. कृपया सिम्युलेटर की मदद से जांच करके देखें कि दिए गए प्लैटफ़ॉर्म के लिए कौनसी लाइनें दिखाई जाएंगी. WEB_BROWSER की सुविधा के साथ काम करने वाले प्लैटफ़ॉर्म पर, उपयोगकर्ता को ज़्यादा डेटा वाले वेब पेज पर भेजा जा सकता है. |
button |
बटन. |
TableColumn
टेबल में मौजूद कॉलम के बारे में बताता है.
जेएसओएन के काेड में दिखाना | |
---|---|
{
"header": string,
"align": enum ( |
फ़ील्ड | |
---|---|
header |
कॉलम के लिए हेडर टेक्स्ट. |
align |
कॉलम का हॉरिज़ॉन्टल अलाइनमेंट. अगर इसकी जानकारी नहीं दी गई है, तो कॉन्टेंट को लीड वाले किनारे पर अलाइन किया जाएगा. |
HorizontalAlignment
सेल के अंदर कॉन्टेंट का अलाइनमेंट.
Enums | |
---|---|
UNSPECIFIED |
हॉरिज़ॉन्टल अलाइनमेंट की जानकारी नहीं है. |
LEADING |
सेल का शुरुआती किनारा. यह डिफ़ॉल्ट रूप से होता है. |
CENTER |
कॉन्टेंट, कॉलम के बीच में अलाइन होता है. |
TRAILING |
कॉन्टेंट, कॉलम के आखिरी किनारे में अलाइन होता है. |
TableRow
टेबल की किसी पंक्ति के बारे में बताता है.
जेएसओएन के काेड में दिखाना | |
---|---|
{
"cells": [
{
object ( |
फ़ील्ड | |
---|---|
cells[] |
इस पंक्ति में मौजूद सेल. इस बात की गारंटी है कि पहली तीन सेल दिखाई जाएंगी, लेकिन कुछ खास जगहों से कट सकती हैं. कृपया सिम्युलेटर की मदद से जांच करके देखें कि दी गई सतह के लिए कौनसी सेल दिखाई जाएंगी. |
divider |
यह बताता है कि हर पंक्ति के बाद कोई डिवाइडर होना चाहिए या नहीं. |
TableCell
किसी पंक्ति में मौजूद सेल के बारे में बताता है.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "text": string } |
फ़ील्ड | |
---|---|
text |
सेल का टेक्स्ट कॉन्टेंट. |
मीडिया
एक मीडिया ऑब्जेक्ट को दिखाता है. इसमें मीडिया के बारे में जानकारी होती है, जैसे कि नाम, ब्यौरा, यूआरएल वगैरह.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "mediaType": enum ( |
फ़ील्ड | |
---|---|
mediaType |
मीडिया प्रकार. |
startOffset |
पहले मीडिया ऑब्जेक्ट का शुरुआती ऑफ़सेट. सेकंड में नौ भिन्नात्मक अंकों वाली अवधि, जिसे ' |
optionalMediaControls[] |
इस मीडिया रिस्पॉन्स सेशन में, वैकल्पिक मीडिया कंट्रोल टाइप इस्तेमाल किए जा सकते हैं. अगर इस नीति को सेट किया जाता है, तो किसी मीडिया इवेंट के होने पर 3p में अनुरोध किया जाएगा. अगर नीति को सेट नहीं किया जाता है, तो 3p को अब भी दो डिफ़ॉल्ट कंट्रोल टाइप, 'पूरा हुआ' और 'पूरी नहीं हो सके', दोनों को हैंडल करना होगा. |
mediaObjects[] |
मीडिया ऑब्जेक्ट की सूची |
MediaType
इस जवाब का मीडिया प्रकार.
Enums | |
---|---|
MEDIA_TYPE_UNSPECIFIED |
मीडिया का टाइप नहीं बताया गया है. |
AUDIO |
ऑडियो फ़ाइल. |
MEDIA_STATUS_ACK |
मीडिया की स्थिति की रिपोर्ट स्वीकार करने के लिए जवाब. |
OptionalMediaControls
वैकल्पिक मीडिया कंट्रोल टाइप, जिनका इस्तेमाल मीडिया से किया जा सकता है
Enums | |
---|---|
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED |
वैल्यू की जानकारी नहीं है |
PAUSED |
रोका गया इवेंट. तब ट्रिगर होता है, जब उपयोगकर्ता मीडिया को रोकता है. |
STOPPED |
रोका गया इवेंट. तब ट्रिगर होता है, जब उपयोगकर्ता मीडिया प्ले के दौरान 3p सेशन से बाहर निकल जाता है. |
MediaObject
एक मीडिया ऑब्जेक्ट को दिखाता है
जेएसओएन के काेड में दिखाना | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
फ़ील्ड | |
---|---|
name |
इस मीडिया ऑब्जेक्ट का नाम. |
description |
इस मीडिया ऑब्जेक्ट की जानकारी. |
url |
मीडिया कॉन्टेंट पर ले जाने वाला यूआरएल. |
image |
मीडिया कार्ड के साथ दिखाने के लिए इमेज. |
MediaImage
मीडिया कार्ड के साथ दिखाने के लिए इमेज.
जेएसओएन के काेड में दिखाना | |
---|---|
{ // Union field |
फ़ील्ड | ||
---|---|---|
यूनियन फ़ील्ड image . इमेज. image इनमें से सिर्फ़ एक हो सकता है: |
||
large |
बड़ी इमेज, जैसे कि एल्बम का कवर वगैरह. |
|
icon |
टाइटल की दाईं ओर छोटी इमेज का आइकॉन दिखाया जाता है. इसका साइज़ बदलकर 36x36 dp कर दिया गया है. |
डेटा इकट्ठा करना
चुनने के लिए विकल्पों का कलेक्शन दिखाने के लिए एक कार्ड.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "title": string, "subtitle": string, "items": [ { object ( |
फ़ील्ड | |
---|---|
title |
कलेक्शन का टाइटल. ज़रूरी नहीं. |
subtitle |
कलेक्शन का सबटाइटल. ज़रूरी नहीं. |
items[] |
कम से कम: 2 ज़्यादा से ज़्यादा: 10 |
imageFill |
कलेक्शन आइटम के लिए, इमेज के बैकग्राउंड में जानकारी भरने का तरीका. ज़रूरी नहीं. |
CollectionItem
संग्रह का एक आइटम
जेएसओएन के काेड में दिखाना | |
---|---|
{ "key": string } |
फ़ील्ड | |
---|---|
key |
ज़रूरी है. ऐसी NLU कुंजी जो इससे जुड़े टाइप में मौजूद एंट्री पासकोड के नाम से मेल खाती है. |
सूची
चुनने के लिए विकल्पों की सूची प्रज़ेंट करने के लिए कार्ड.
जेएसओएन के काेड में दिखाना | |
---|---|
{
"title": string,
"subtitle": string,
"items": [
{
object ( |
फ़ील्ड | |
---|---|
title |
सूची का शीर्षक. ज़रूरी नहीं. |
subtitle |
सूची का सबटाइटल. ज़रूरी नहीं. |
items[] |
कम से कम: 2 ज़्यादा से ज़्यादा: 30 |
ListItem
सूची का एक आइटम
जेएसओएन के काेड में दिखाना | |
---|---|
{ "key": string } |
फ़ील्ड | |
---|---|
key |
ज़रूरी है. ऐसी NLU कुंजी जो इससे जुड़े टाइप में मौजूद एंट्री पासकोड के नाम से मेल खाती है. |
सुझाव
उपयोगकर्ता को दिखाया जाने वाला इनपुट सुझाव.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "title": string } |
फ़ील्ड | |
---|---|
title |
ज़रूरी है. सुझाव देने वाले चिप में दिखाया गया टेक्स्ट. टैप करने पर, यह टेक्स्ट मैसेज को उसी तरह से पोस्ट किया जाएगा जैसे उपयोगकर्ता ने टाइप किया हो. सुझाव देने वाले चिप के सेट में शामिल हर टाइटल अलग होना चाहिए. ज़्यादा से ज़्यादा 25 वर्ण |
गड़बड़ी की जानकारी
बातचीत वाले राउंड से जुड़ी डाइग्नोस्टिक्स की जानकारी.
जेएसओएन के काेड में दिखाना | |
---|---|
{
"actionsBuilderEvents": [
{
object ( |
फ़ील्ड | |
---|---|
actionsBuilderEvents[] |
ऐक्शन बिल्डर के इंटरैक्शन मॉडल के सभी चरणों में होने वाली बातचीत को प्रोसेस करने के बारे में जानकारी देने वाले इवेंट की सूची. यह जानकारी सिर्फ़ Actions Builder और Actions SDK टूल ऐप्लिकेशन के लिए भरी जाती है. |
ExecutionEvent
इसमें, Actions Builder में बातचीत के अनुरोध को प्रोसेस करने के दौरान होने वाले, प्रोग्राम को पूरा करने के इवेंट की जानकारी होती है. बातचीत के अनुरोध में शामिल अलग-अलग स्टेज की खास जानकारी के लिए, https://developers.google.com/assistant/conversational/actions पर जाएं.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "eventTime": string, "executionState": { object ( |
फ़ील्ड | ||
---|---|---|
eventTime |
उस समय का टाइमस्टैंप जब इवेंट हुआ. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: |
|
executionState |
इस इवेंट के दौरान एक्ज़ीक्यूशन की स्थिति. |
|
status |
विशेष निष्पादन चरण की मिलने वाली स्थिति. |
|
warningMessages[] |
इस इवेंट के चलने के दौरान जनरेट की गई चेतावनियों की सूची. बातचीत का अनुरोध करने के दौरान, डेवलपर को चेतावनियां मिलती हैं. आम तौर पर, ये बातें ज़रूरी नहीं होती हैं और अनुरोध को लागू होने से नहीं रोकती हैं. उदाहरण के लिए, जब वेबहुक किसी ऐसे कस्टम टाइप को बदलने की कोशिश करता है जो मौजूद नहीं है, तो चेतावनियां जनरेट हो सकती हैं. गड़बड़ियों को 'पुष्टि नहीं हो सकी' स्टेटस कोड के तौर पर रिपोर्ट किया जाता है. हालांकि, 'ठीक है' स्थिति में भी चेतावनियां दिख सकती हैं. |
|
यूनियन फ़ील्ड EventData . किसी बातचीत के राउंड को प्रोसेस करने में शामिल अलग-अलग इवेंट की खास जानकारी. यहां दिया गया फ़ील्ड बताता है कि यह इवेंट किस तरह का है. EventData इनमें से सिर्फ़ एक हो सकता है: |
||
userInput |
उपयोगकर्ता के इनपुट को मैनेज करने से जुड़ा इवेंट. |
|
intentMatch |
इंटेंट मैचिंग इवेंट. |
|
conditionsEvaluated |
स्थिति का आकलन करने वाला इवेंट. |
|
onSceneEnter |
OnSceneEnter प्रोग्राम लागू करने का इवेंट. |
|
webhookRequest |
वेबहुक अनुरोध डिस्पैच इवेंट. |
|
webhookResponse |
वेबहुक रिस्पॉन्स की रसीद का इवेंट. |
|
webhookInitiatedTransition |
वेबहुक से शुरू किया गया ट्रांज़िशन इवेंट. |
|
slotMatch |
स्लॉट मिलान का इवेंट. |
|
slotRequested |
इवेंट का अनुरोध करने वाला स्लॉट. |
|
slotValidated |
स्लॉट की पुष्टि करने वाला इवेंट. |
|
formFilled |
फ़ॉर्म भरने का इवेंट. |
|
waitingUserInput |
उपयोगकर्ता-इनपुट इवेंट के लिए इंतज़ार किया जा रहा है. |
|
endConversation |
बातचीत खत्म होने का इवेंट. |
ExecutionState
निष्पादन की मौजूदा स्थिति.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "currentSceneId": string, "sessionStorage": { object }, "slots": { object ( |
फ़ील्ड | |
---|---|
currentSceneId |
उस सीन का आईडी जो फ़िलहाल दिखाया जा रहा है. |
sessionStorage |
सेशन के स्टोरेज की स्थिति: https://developers.google.com/assistant/conversational/storage-session |
slots |
अगर लागू हो, तो स्लॉट भरने की प्रक्रिया की स्थिति: https://developers.google.com/assistant/conversational/scenes#slot_filling |
promptQueue[] |
प्रॉम्प्ट की सूची: https://developers.google.com/assistant/conversational/prompts |
userStorage |
उपयोगकर्ता के स्टोरेज की स्थिति: https://developers.google.com/assistant/conversational/storage-user |
householdStorage |
होम स्टोरेज की स्थिति: https://developers.google.com/assistant/conversational/storage-home |
कसीनो स्लॉट मशीन की नकल वाले गेम
किसी सीन के स्लॉट की मौजूदा स्थिति दिखाता है.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "status": enum ( |
फ़ील्ड | |
---|---|
status |
स्लॉट भरने की मौजूदा स्थिति. |
slots |
मौजूदा सीन से जुड़े स्लॉट. एक ऑब्जेक्ट जिसमें |
SlotFillingStatus
स्लॉट भरने की मौजूदा स्थिति को दिखाता है.
Enums | |
---|---|
UNSPECIFIED |
इस्तेमाल वाले फ़ील्ड में जानकारी न भरने पर, फ़ॉलबैक वैल्यू मिलती है. |
INITIALIZED |
स्लॉट शुरू कर दिए गए हैं लेकिन स्लॉट भरना शुरू नहीं किया गया है. |
COLLECTING |
स्लॉट की वैल्यू इकट्ठा की जा रही हैं. |
FINAL |
सभी स्लॉट की वैल्यू फ़ाइनल हैं और उन्हें बदला नहीं जा सकता. |
स्लॉट
यह स्लॉट दिखाता है.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "mode": enum ( |
फ़ील्ड | |
---|---|
mode |
स्लॉट का मोड (ज़रूरी या वैकल्पिक). डेवलपर सेट कर सकता है. |
status |
स्लॉट की स्थिति. |
value |
स्लॉट की वैल्यू. रिस्पॉन्स में इस वैल्यू को बदलने से, स्लॉट भरने में भी वैल्यू बदल जाएगी. |
updated |
इससे पता चलता है कि आखिरी मोड़ पर स्लॉट की वैल्यू इकट्ठा की गई थी या नहीं. यह फ़ील्ड रीड-ओनली मोड में है. |
prompt |
ज़रूरी नहीं. यह प्रॉम्प्ट उपयोगकर्ता को तब भेजा जाता है, जब ज़रूरी स्लॉट को भरने के लिए कहा जाता है. यह प्रॉम्प्ट, कंसोल में तय किए गए मौजूदा प्रॉम्प्ट की जगह ले लेता है. यह फ़ील्ड वेबहुक अनुरोध में शामिल नहीं है. |
SlotMode
स्लॉट के मोड को दिखाता है. इसका मतलब है कि ज़रूरत पड़ने पर इसका मोड उपलब्ध है या नहीं.
Enums | |
---|---|
MODE_UNSPECIFIED |
इस्तेमाल वाले फ़ील्ड में जानकारी न भरने पर, फ़ॉलबैक वैल्यू मिलती है. |
OPTIONAL |
इससे पता चलता है कि स्लॉट भरने के लिए, स्लॉट की ज़रूरत नहीं है. |
REQUIRED |
इससे पता चलता है कि स्लॉट भरने के लिए, उसे भरना ज़रूरी है. |
SlotStatus
स्लॉट की स्थिति के बारे में बताता है.
Enums | |
---|---|
SLOT_UNSPECIFIED |
इस्तेमाल वाले फ़ील्ड में जानकारी न भरने पर, फ़ॉलबैक वैल्यू मिलती है. |
EMPTY |
इससे पता चलता है कि स्लॉट में कोई वैल्यू नहीं है. जवाब के ज़रिए इस स्थिति को बदला नहीं जा सकता. |
INVALID |
इससे पता चलता है कि स्लॉट की वैल्यू अमान्य है. इस स्टेटस को रिस्पॉन्स से सेट किया जा सकता है. |
FILLED |
इससे पता चलता है कि स्लॉट में कोई वैल्यू मौजूद है. जवाब के ज़रिए इस स्थिति को बदला नहीं जा सकता. |
स्थिति
Status
टाइप, एक लॉजिकल गड़बड़ी मॉडल के बारे में बताता है. यह मॉडल अलग-अलग प्रोग्रामिंग एनवायरमेंट के लिए सही होता है. इनमें REST API और RPC एपीआई शामिल हैं. इसका इस्तेमाल gRPC करता है. हर Status
मैसेज में डेटा के तीन हिस्से होते हैं: गड़बड़ी कोड, गड़बड़ी का मैसेज, और गड़बड़ी की जानकारी.
एपीआई डिज़ाइन गाइड में गड़बड़ी के इस मॉडल और इसके साथ काम करने के तरीके के बारे में ज़्यादा जानकारी पाई जा सकती है.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
फ़ील्ड | |
---|---|
code |
स्टेटस कोड, जो |
message |
डेवलपर को दिखने वाला गड़बड़ी का मैसेज, जो अंग्रेज़ी में होना चाहिए. उपयोगकर्ताओं को दिखने वाली गड़बड़ी के मैसेज का स्थानीय भाषा में अनुवाद किया जाना चाहिए और |
details[] |
उन मैसेज की सूची जिनमें गड़बड़ी की जानकारी होती है. एपीआई के इस्तेमाल के लिए, मैसेज टाइप का एक सामान्य सेट है. एक ऑब्जेक्ट, जिसमें आर्बिट्रेरी टाइप के फ़ील्ड शामिल हैं. एक और फ़ील्ड |
UserConversationInput
उपयोगकर्ता के इनपुट से जुड़ी जानकारी.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "type": string, "originalQuery": string } |
फ़ील्ड | |
---|---|
type |
उपयोगकर्ता के इनपुट का टाइप. जैसे कि कीबोर्ड, आवाज़, टच वगैरह. |
originalQuery |
उपयोगकर्ता का मूल टेक्स्ट इनपुट. |
IntentMatch
ट्रिगर किए गए इंटेंट मैच के बारे में जानकारी (ग्लोबल या किसी सीन में): https://developers.google.com/assistant/conversational/intents
जेएसओएन के काेड में दिखाना | |
---|---|
{
"intentId": string,
"intentParameters": {
string: {
object ( |
फ़ील्ड | |
---|---|
intentId |
इस इंटरैक्शन को ट्रिगर करने वाला इंटेंट आईडी. |
intentParameters |
इस इंटरैक्शन को ट्रिगर करने वाले इंटेंट के पैरामीटर. एक ऑब्जेक्ट जिसमें |
handler |
इस इंटरैक्शन से अटैच किए गए हैंडलर का नाम. |
nextSceneId |
वह दृश्य, जहां यह इंटरैक्शन ले जाता है. |
ConditionsEvaluated
शर्तों के आकलन के नतीजे: https://developers.google.com/assistant/conversational/scenes#conditions
जेएसओएन के काेड में दिखाना | |
---|---|
{ "failedConditions": [ { object ( |
फ़ील्ड | |
---|---|
failedConditions[] |
उन शर्तों की सूची जिनका आकलन 'गलत' के तौर पर किया गया था. |
successCondition |
पहली शर्त जिसका आकलन 'सही' के तौर पर किया गया था, अगर कोई हो. |
शर्त
स्थिति की जांच की गई.
जेएसओएन के काेड में दिखाना | |
---|---|
{ "expression": string, "handler": string, "nextSceneId": string } |
फ़ील्ड | |
---|---|
expression |
इस शर्त में बताया गया एक्सप्रेशन. |
handler |
आकलन की गई शर्त में बताया गया हैंडलर का नाम. |
nextSceneId |
आकलन की गई स्थिति में डेस्टिनेशन सीन के बारे में बताया गया है. |
OnSceneEnter
onSceneEnter चरण लागू करने के बारे में जानकारी: https://developers.google.com/assistant/conversational/scenes#onEnter
जेएसओएन के काेड में दिखाना | |
---|---|
{ "handler": string } |
फ़ील्ड | |
---|---|
handler |
onSceneEnter इवेंट में हैंडलर का नाम बताया गया है. |
WebhookRequest
कार्रवाई वेबहुक पर भेजे गए अनुरोध के बारे में जानकारी: https://developers.google.com/assistant/conversational/webhooks#payloads
जेएसओएन के काेड में दिखाना | |
---|---|
{ "requestJson": string } |
फ़ील्ड | |
---|---|
requestJson |
वेबहुक अनुरोध का पेलोड. |
WebhookResponse
कार्रवाई वेबहुक से मिले जवाब के बारे में जानकारी: https://developers.google.com/assistant/conversational/webhooks#payloads
जेएसओएन के काेड में दिखाना | |
---|---|
{ "responseJson": string } |
फ़ील्ड | |
---|---|
responseJson |
वेबहुक के जवाब का पेलोड. |
WebhookInitiatedTransition
वेबहुक से दिखाए गए डेस्टिनेशन सीन से ट्रिगर हुआ इवेंट: https://developers.google.com/assistant/conversational/webhooks#transition_scenes
जेएसओएन के काेड में दिखाना | |
---|---|
{ "nextSceneId": string } |
फ़ील्ड | |
---|---|
nextSceneId |
उस सीन का आईडी जिस पर ट्रांज़िशन हो रहा है. |
SlotMatch
मैच होने वाले स्लॉट के बारे में जानकारी: https://developers.google.com/assistant/conversational/scenes#slot_filling
जेएसओएन के काेड में दिखाना | |
---|---|
{
"nluParameters": {
string: {
object ( |
फ़ील्ड | |
---|---|
nluParameters |
उपयोगकर्ता के इनपुट से एनएलयू के ज़रिए एक्सट्रैक्ट किए गए पैरामीटर. एक ऑब्जेक्ट जिसमें |
SlotRequested
फ़िलहाल, अनुरोध किए गए स्लॉट के बारे में जानकारी: https://developers.google.com/assistant/conversational/scenes#slot_filling
जेएसओएन के काेड में दिखाना | |
---|---|
{
"slot": string,
"prompt": {
object ( |
फ़ील्ड | |
---|---|
slot |
अनुरोध किए गए स्लॉट का नाम. |
prompt |
स्लॉट प्रॉम्प्ट. |
SlotValidated
स्लॉट के लिए वेबहुक की पुष्टि होने के बाद होने वाला इवेंट: https://developers.google.com/assistant/conversational/scenes#slot_filling
FormFilled
फ़ॉर्म पूरी तरह भरने के बाद होने वाला इवेंट: https://developers.google.com/assistant/conversational/scenes#slot_filling
WaitingForUserInput
जब सिस्टम को उपयोगकर्ता के इनपुट की ज़रूरत होती है, तब यह इवेंट होता है: https://developers.google.com/assistant/conversational/scenes#input
EndConversation
ऐसा इवेंट जिससे पता चलता है कि एजेंट से बातचीत खत्म हो गई है.