Method: projects.sendInteraction

बातचीत का एक राउंड चलाया जाता है.

एचटीटीपी अनुरोध

POST https://actions.googleapis.com/v2/{project=projects/*}:sendInteraction

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
project

string

ज़रूरी है. जांच किया जा रहा प्रोजेक्ट, जिसे प्रोजेक्ट आईडी से दिखाया जाता है. फ़ॉर्मैट: project/{project}

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "input": {
    object (UserInput)
  },
  "deviceProperties": {
    object (DeviceProperties)
  },
  "conversationToken": string
}
फ़ील्ड
input

object (UserInput)

ज़रूरी है. उपयोगकर्ता की ओर से दिया गया इनपुट.
deviceProperties

object (DeviceProperties)

ज़रूरी है. कार्रवाई के साथ इंटरैक्ट करने के लिए इस्तेमाल किए जाने वाले डिवाइस की प्रॉपर्टी.
conversationToken

string

ओपेक टोकन, जिसे पिछले इंटरैक्शन पर Sendइंटरैक्शनResponse से मिला हुआ होना चाहिए. नई बातचीत शुरू करने के लिए, टेस्टिंग सेशन के पहले इंटरैक्शन के तौर पर या पिछली बातचीत को छोड़कर नई बातचीत शुरू करने के लिए, इसे सेट नहीं किया जा सकता.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

बातचीत का जवाब देने के लिए.

JSON के काेड में दिखाना 
{
  "output": {
    object (Output)
  },
  "diagnostics": {
    object (Diagnostics)
  },
  "conversationToken": string
}
फ़ील्ड
output

object (Output)

उपयोगकर्ता को दिया गया आउटपुट.
diagnostics

object (Diagnostics)

गड़बड़ी की जानकारी से जुड़ी जानकारी, जो बताती है कि अनुरोध को कैसे मैनेज किया गया.
conversationToken

string

वही बातचीत जारी रखने के लिए, अगली RPC कॉल में SendInteractRequest पर ओपेक टोकन सेट करना होगा.

UserInput

बातचीत के राउंड में उपयोगकर्ता का दिया गया इनपुट.

JSON के काेड में दिखाना 
{
  "query": string,
  "type": enum (InputType)
}
फ़ील्ड
query

string

उपयोगकर्ता की ओर से भेजे गए इनपुट का कॉन्टेंट.
type

enum (InputType)

इनपुट का टाइप.

InputType

यह इनपुट सोर्स, टाइप की गई क्वेरी या वॉइस क्वेरी के बारे में बताता है.

Enums
INPUT_TYPE_UNSPECIFIED इनपुट सोर्स की जानकारी नहीं दी गई है.
TOUCH जीयूआई इंटरैक्शन से क्वेरी.
VOICE बोलकर खोजने की सुविधा.
KEYBOARD टाइप की गई क्वेरी.
URL यह कार्रवाई यूआरएल लिंक से ट्रिगर हुई थी.

डिवाइसप्रॉपर्टी

बातचीत के राउंड के हिसाब से काम के डिवाइस की प्रॉपर्टी.

JSON के काेड में दिखाना 
{
  "surface": enum (Surface),
  "location": {
    object (Location)
  },
  "locale": string,
  "timeZone": string
}
फ़ील्ड
surface

enum (Surface)

कार्रवाई के साथ इंटरैक्ट करने के लिए इस्तेमाल किया जाने वाला प्लैटफ़ॉर्म.
location

object (Location)

डिवाइस की जगह की जानकारी, जैसे कि अक्षांश, देशांतर, और फ़ॉर्मैट किया गया पता.
locale

string

डिवाइस पर सेट की गई स्थान-भाषा. फ़ॉर्मैट BCP 47 के हिसाब से होना चाहिए: https://tools.ietf.org/html/bcp47 उदाहरण: en, en-US, es-419 (ज़्यादा उदाहरण देखने के लिए यहां जाएं: https://tools.ietf.org/html/bcp47#appendix-A).
timeZone

string

डिवाइस पर सेट किया गया समय क्षेत्र. फ़ॉर्मैट को आईएएनए टाइम ज़ोन डेटाबेस के हिसाब से होना चाहिए, जैसे कि "अमेरिका/New_York": https://www.iana.org/time-zones

प्लैटफ़ॉर्म

कार्रवाई के साथ इंटरैक्ट करने के लिए इस्तेमाल किए गए संभावित प्लैटफ़ॉर्म. आने वाले समय में, और भी वैल्यू शामिल की जा सकती हैं.

Enums
SURFACE_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
SPEAKER स्पीकर (जैसे कि Google Home).
PHONE फ़ोन.
ALLO Allo चैट.
SMART_DISPLAY स्मार्ट डिसप्ले डिवाइस.
KAI_OS KaiOS.

जगह

जगह दिखाने वाला कंटेनर.

JSON के काेड में दिखाना 
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string
}
फ़ील्ड
coordinates

object (LatLng)

भौगोलिक निर्देशांक. [DEVICE_PRECISE_LOCATION] की ज़रूरत है [google.action.v2.Permission.DEVICE_PRECISE_LOCATION] अनुमति.
formattedAddress

string

डिसप्ले पता, जैसे, "1600 Amphitheatre Pkwy, Mountain View, CA 94043". [DEVICE_PRECISE_LOCATION] की ज़रूरत है [google.action.v2.Permission.DEVICE_PRECISE_LOCATION] अनुमति.
zipCode

string

पिन कोड. [DEVICE_PRECISE_LOCATION] की ज़रूरत है [google.action.v2.Permission.DEVICE_PRECISE_LOCATION] या [DEVICE_COARSE_LOCATION] [google.action.v2.Permission.DEVICE_COARSE_LOCATION] अनुमति.
city

string

शहर. [DEVICE_PRECISE_LOCATION] की ज़रूरत है [google.action.v2.Permission.DEVICE_PRECISE_LOCATION] या [DEVICE_COARSE_LOCATION] [google.action.v2.Permission.DEVICE_COARSE_LOCATION] अनुमति.

LatLng

ऐसा ऑब्जेक्ट जो अक्षांश/देशांतर की जोड़ी को दिखाता है. डिग्री अक्षांश और डिग्री देशांतर को दिखाने के लिए, इसे डबल के जोड़े के तौर पर दिखाया जाता है. जब तक अलग से न बताया गया हो, यह ऑब्जेक्ट WGS84 मानक के मुताबिक होना चाहिए. वैल्यू, नॉर्मलाइज़ की जा सकने वाली रेंज के अंदर होनी चाहिए.

JSON के काेड में दिखाना 
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.
longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

आउटपुट

बातचीत के राउंड के लिए, उपयोगकर्ता को दिखने वाला आउटपुट.

JSON के काेड में दिखाना 
{
  "text": string,
  "speech": [
    string
  ],
  "canvas": {
    object (Canvas)
  },
  "actionsBuilderPrompt": {
    object (Prompt)
  }
}
फ़ील्ड
text

string

बोलकर दिया गया जवाब, उपयोगकर्ता को एक सामान्य स्ट्रिंग के तौर पर भेजा गया.
speech[]

string

स्पीच से जुड़ा कॉन्टेंट, कार्रवाई के ज़रिए तैयार किया गया है. इसमें SSML जैसे मार्कअप एलिमेंट शामिल हो सकते हैं.
canvas

object (Canvas)

कैनवस पर इंटरैक्टिव कॉन्टेंट.
actionsBuilderPrompt

object (Prompt)

बातचीत वाले राउंड के आखिर में प्रॉम्प्ट की स्थिति. प्रॉम्प्ट के बारे में ज़्यादा जानकारी: https://developers.google.com/assistant/conversational/prompts

कैनवस

यह उपयोगकर्ता को भेजे जाने वाले इंटरैक्टिव कैनवस जवाब को दिखाता है. इसका इस्तेमाल "first Simple" के साथ किया जा सकता है इंटरैक्टिव कैनवस जवाब को दिखाने के अलावा, उपयोगकर्ता से बात करने के लिए शामिल प्रॉम्प्ट में फ़ील्ड. जवाब ज़्यादा से ज़्यादा 50 हज़ार बाइट का हो सकता है.

JSON के काेड में दिखाना 
{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "enableFullScreen": boolean
}
फ़ील्ड
url

string

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

value (Value format)

ज़रूरी नहीं. इमर्सिव एक्सपीरियंस वेब पेज पर, इवेंट के तौर पर भेजा जाने वाला JSON डेटा. अगर "ओवरराइड करें" मौजूदा प्रॉम्प्ट में "गलत" फ़ील्ड है कैनवस प्रॉम्प्ट में तय की गई डेटा वैल्यू, कैनवस प्रॉम्प्ट में तय की गई डेटा वैल्यू के बाद जोड़ी जाएंगी.
suppressMic

boolean

ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू: गलत.
enableFullScreen

boolean

अगर true कैनवस ऐप्लिकेशन फ़ुल स्क्रीन मोड में है और सबसे ऊपर कोई हेडर नहीं है. लोड होने वाली स्क्रीन पर एक टोस्ट मैसेज भी दिखेगा. इस मैसेज में, कार्रवाई का डिसप्ले नेम, डेवलपर का नाम, और कार्रवाई को बंद करने के निर्देश शामिल होंगे. डिफ़ॉल्ट वैल्यू: false.

प्रॉम्प्ट

किसी उपयोगकर्ता को दिया जाने वाला जवाब दिखाएं.

JSON के काेड में दिखाना 
{
  "append": boolean,
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  }
}
फ़ील्ड
append
(deprecated)

boolean

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

boolean

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

object (Simple)

ज़रूरी नहीं. पहला वॉइस और सिर्फ़ टेक्स्ट वाला जवाब.
content

object (Content)

ज़रूरी नहीं. उपयोगकर्ता को दिखाने के लिए कार्ड, सूची या मीडिया जैसा कॉन्टेंट.
lastSimple

object (Simple)

ज़रूरी नहीं. आखिरी वॉइस और सिर्फ़ टेक्स्ट वाला जवाब.
suggestions[]

object (Suggestion)

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

object (Canvas)

ज़रूरी नहीं. यह उपयोगकर्ता को भेजे जाने वाले इंटरैक्टिव कैनवस जवाब को दिखाता है.

सिंपल

यह उपयोगकर्ता को भेजे जाने वाले एक आसान प्रॉम्प्ट को दिखाता है.

JSON के काेड में दिखाना 
{
  "speech": string,
  "text": string
}
फ़ील्ड
speech

string

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

string

चैट बबल में दिखाने के लिए वैकल्पिक टेक्स्ट. अगर नहीं दिया गया है, तो ऊपर दी गई स्पीच फ़ील्ड की डिसप्ले रेंडरिंग का इस्तेमाल किया जाएगा. ज़्यादा से ज़्यादा 640 वर्ण डाले जा सकते हैं. अगर "ओवरराइड करें" मौजूदा प्रॉम्प्ट में फ़ील्ड "सही" है, तो इस फ़ील्ड में तय किया गया टेक्स्ट पिछले सिंपल प्रॉम्प्ट के टेक्स्ट से बदल जाता है.

सामग्री

दिखाई जाने वाली सामग्री.

JSON के काेड में दिखाना 
{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "canvas": {
    object (Canvas)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  }
  // End of list of possible types for union field content.
}
फ़ील्ड
यूनियन फ़ील्ड content. सामग्री. content इनमें से सिर्फ़ एक हो सकता है:
card

object (Card)

बेसिक कार्ड.
image

object (Image)

इमेज.
table

object (Table)

टेबल कार्ड.
media

object (Media)

मीडिया के सेट का संकेत देने वाला रिस्पॉन्स, जिसे चलाया जाना है.
canvas
(deprecated)

object (Canvas)

इंटरैक्टिव कैनवस अनुभव के लिए इस्तेमाल किया जाने वाला जवाब.
collection

object (Collection)

इस कार्ड में, चुनने के लिए मौजूद विकल्पों का कलेक्शन मौजूद है.
list

object (List)

एक कार्ड, जिसमें चुनने के लिए विकल्पों की सूची दी गई है.

कार्ड

कुछ जानकारी दिखाने के लिए बेसिक कार्ड, जैसे कि इमेज और/या टेक्स्ट.

JSON के काेड में दिखाना 
{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}
फ़ील्ड
title

string

कार्ड का पूरा टाइटल. ज़रूरी नहीं.
subtitle

string

ज़रूरी नहीं.
text

string

कार्ड के मुख्य हिस्से वाला टेक्स्ट. फ़ॉर्मैटिंग के लिए, मार्कडाउन सिंटैक्स के सीमित सेट के साथ काम करता है. अगर इमेज मौजूद नहीं है, तो ज़रूरी है.
image

object (Image)

कार्ड के लिए हीरो इमेज. ऊंचाई 192dp तय की गई है. ज़रूरी नहीं.
imageFill

enum (ImageFill)

इमेज का बैकग्राउंड कैसे भरा जाएगा. ज़रूरी नहीं.
button

object (Link)

बटन. ज़रूरी नहीं.

इमेज

कार्ड में एक इमेज दिखती है.

JSON के काेड में दिखाना 
{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}
फ़ील्ड
url

string

इमेज का सोर्स यूआरएल. इमेज JPG, PNG, और GIF (ऐनिमेटेड और नॉन-ऐनिमेटेड) हो सकती हैं. उदाहरण के लिए,https://www.agentx.com/logo.png. ज़रूरी है.
alt

string

सुलभता के लिए इस्तेमाल की जाने वाली इमेज के बारे में जानकारी, जैसे कि स्क्रीन रीडर. ज़रूरी है.
height

integer

पिक्सल में इमेज की ऊंचाई. ज़रूरी नहीं.
width

integer

पिक्सल में इमेज की चौड़ाई. ज़रूरी नहीं.

ImageFill

इमेज के प्रज़ेंटेशन पर असर डालने के लिए, इमेज दिखाने के संभावित विकल्प. इसका इस्तेमाल तब किया जाना चाहिए, जब इमेज का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात), इमेज कंटेनर के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) से मेल नहीं खाता.

Enums
UNSPECIFIED अनिर्दिष्ट चित्र फ़िल.
GRAY इमेज और इमेज कंटेनर के बीच की खाली जगहों को स्लेटी रंग के बार से भरें.
WHITE इमेज और इमेज कंटेनर के बीच की खाली जगहों को सफ़ेद बार से भरें.
CROPPED इमेज का साइज़ इस तरह से तय किया जाता है कि इमेज की चौड़ाई और ऊंचाई, कंटेनर के डाइमेंशन से मेल खाए या उससे ज़्यादा हो. अगर स्केल की गई इमेज की ऊंचाई, कंटेनर की ऊंचाई से ज़्यादा है, तब इमेज के ऊपरी और निचले हिस्से में काटा जा सकता है. इसके अलावा, अगर स्केल की गई इमेज की चौड़ाई, कंटेनर की चौड़ाई से ज़्यादा है, तब इमेज के बाएं और दाएं हिस्से को काटा जा सकता है. यह "ज़ूम मोड" के समान है 4:3 अनुपात वाले वीडियो को चलाने पर.

OpenUrl

उपयोगकर्ता के लिंक खोलने पर की जाने वाली कार्रवाई.

JSON के काेड में दिखाना 
{
  "url": string,
  "hint": enum (UrlHint)
}
फ़ील्ड
url

string

यूआरएल फ़ील्ड, जो इनमें से कोई भी हो सकती है: - ऐप्लिकेशन से लिंक किए गए ऐप्लिकेशन या वेबपेज को खोलने के लिए http/https यूआरएल
hint

enum (UrlHint)

यूआरएल टाइप के लिए संकेत दिखाता है.

UrlHint

अलग-अलग तरह के यूआरएल संकेत.

Enums
AMP ऐसा यूआरएल जो सीधे एएमपी कॉन्टेंट पर ले जाता है या किसी कैननिकल यूआरएल पर ले जाता है, जो के ज़रिए एएमपी कॉन्टेंट के बारे में बताता है.

तालिका

टेक्स्ट की टेबल दिखाने के लिए टेबल कार्ड.

JSON के काेड में दिखाना 
{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}
फ़ील्ड
title

string

टेबल का पूरा टाइटल. ज़रूरी नहीं है, लेकिन सबटाइटल सेट होने पर इसे सेट करना ज़रूरी है.
subtitle

string

टेबल का सबटाइटल. ज़रूरी नहीं.
image

object (Image)

टेबल से जुड़ी इमेज. ज़रूरी नहीं.
columns[]

object (TableColumn)

कॉलम के हेडर और अलाइनमेंट.
rows[]

object (TableRow)

टेबल का लाइन डेटा. पहली तीन लाइनें दिखाए जाने की गारंटी है, लेकिन बाकी लाइनें कुछ प्लैटफ़ॉर्म पर काटी जा सकती हैं. कृपया सिम्युलेटर की मदद से जांच करके देखें कि किसी प्लैटफ़ॉर्म के लिए कौनसी लाइनें दिखेंगी. WEB_BROWSER क्षमता का समर्थन करने वाली सतहों पर, आप उपयोगकर्ता को ज़्यादा डेटा वाले वेब पेज पर भेज सकते हैं.
button

object (Link)

बटन.

TableColumn

टेबल में एक कॉलम के बारे में बताता है.

JSON के काेड में दिखाना 
{
  "header": string,
  "align": enum (HorizontalAlignment)
}
फ़ील्ड
header

string

कॉलम का हेडर टेक्स्ट.
align

enum (HorizontalAlignment)

कॉलम के साथ कॉन्टेंट का हॉरिज़ॉन्टल अलाइनमेंट. अगर यह जानकारी नहीं दी गई है, तो कॉन्टेंट को सबसे आगे के किनारे से अलाइन कर दिया जाएगा.

HorizontalAlignment

सेल में कॉन्टेंट का अलाइनमेंट.

Enums
UNSPECIFIED हॉरिज़ॉन्टल अलाइनमेंट की जानकारी नहीं है.
LEADING सेल का शुरुआती किनारा. यह डिफ़ॉल्ट रूप से होता है.
CENTER कॉन्टेंट को कॉलम के बीच में अलाइन किया गया है.
TRAILING कॉन्टेंट को कॉलम के पिछले किनारे से अलाइन किया गया है.

TableRow

टेबल में किसी लाइन के बारे में बताता है.

JSON के काेड में दिखाना 
{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}
फ़ील्ड
cells[]

object (TableCell)

इस पंक्ति में मौजूद सेल. पहली तीन सेल दिखाए जाने की गारंटी है, लेकिन बाकी सेल कुछ खास सतहों पर काटी जा सकती हैं. कृपया सिम्युलेटर की मदद से जांच करके देखें कि किसी प्लैटफ़ॉर्म के लिए कौनसे सेल दिखाए जाएंगे.
divider

boolean

यह बताता है कि हर पंक्ति के बाद डिवाइडर होना चाहिए या नहीं.

TableCell

किसी पंक्ति के सेल के बारे में बताता है.

JSON के काेड में दिखाना 
{
  "text": string
}
फ़ील्ड
text

string

सेल में मौजूद टेक्स्ट कॉन्टेंट.

मीडिया

यह एक मीडिया ऑब्जेक्ट को दिखाता है. इसमें मीडिया के बारे में जानकारी होती है, जैसे कि नाम, ब्यौरा, यूआरएल वगैरह.

JSON के काेड में दिखाना 
{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}
फ़ील्ड
mediaType

enum (MediaType)

मीडिया प्रकार.
startOffset

string (Duration format)

पहले मीडिया ऑब्जेक्ट का शुरुआती ऑफ़सेट.

सेकंड में कुल नौ दशमलव अंकों वाली अवधि, जिसे 's' से खत्म किया जाता है. उदाहरण: "3.5s".
optionalMediaControls[]

enum (OptionalMediaControls)

इस मीडिया रिस्पॉन्स सेशन में इस्तेमाल किए जा सकने वाले मीडिया कंट्रोल के वे वैकल्पिक टाइप जो इस सेशन में काम कर सकते हैं. अगर यह नीति सेट है, तो किसी मीडिया इवेंट के होने पर 3p पर अनुरोध किया जाएगा. अगर नीति को सेट नहीं किया जाता है, तो भी 3p को अब भी दो डिफ़ॉल्ट कंट्रोल टाइप, 'पूरा हुआ' और 'नहीं किया जा सका' को हैंडल करना होगा.
mediaObjects[]

object (MediaObject)

मीडिया ऑब्जेक्ट की सूची

MediaType

इस जवाब का मीडिया टाइप.

Enums
MEDIA_TYPE_UNSPECIFIED मीडिया टाइप की जानकारी नहीं है.
AUDIO ऑडियो फ़ाइल.
MEDIA_STATUS_ACK मीडिया की स्टेटस रिपोर्ट को स्वीकार करने का जवाब.

OptionalMediaControls

वैकल्पिक मीडिया कंट्रोल टाइप, जिनमें मीडिया रिस्पॉन्स काम कर सकता है

Enums
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED वैल्यू की जानकारी नहीं है
PAUSED रोका गया इवेंट. यह तब ट्रिगर होता है, जब कोई उपयोगकर्ता मीडिया को रोकता है.
STOPPED इवेंट रोका गया. तब ट्रिगर होता है, जब मीडिया चलाने के दौरान उपयोगकर्ता 3p सेशन से बाहर निकल जाता है.

MediaObject

यह एक मीडिया ऑब्जेक्ट को दिखाता है

JSON के काेड में दिखाना 
{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}
फ़ील्ड
name

string

इस मीडिया ऑब्जेक्ट का नाम.
description

string

इस मीडिया ऑब्जेक्ट का ब्यौरा.
url

string

मीडिया कॉन्टेंट की तरफ़ इशारा करने वाला यूआरएल.
image

object (MediaImage)

मीडिया कार्ड के साथ दिखाने के लिए इमेज.

MediaImage

मीडिया कार्ड के साथ दिखाने के लिए इमेज.

JSON के काेड में दिखाना 
{

  // Union field image can be only one of the following:
  "large": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}
फ़ील्ड
यूनियन फ़ील्ड image. इमेज. image इनमें से सिर्फ़ एक हो सकता है:
large

object (Image)

कोई बड़ी इमेज, जैसे कि एल्बम का कवर वगैरह.
icon

object (Image)

टाइटल की दाईं ओर, इमेज वाला एक छोटा आइकॉन दिख रहा है. इसका साइज़ बदलकर 36x36 dp किया गया.

संग्रह

चुनने के लिए विकल्पों का कलेक्शन दिखाने वाला कार्ड.

JSON के काेड में दिखाना 
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}
फ़ील्ड
title

string

कलेक्शन का टाइटल. ज़रूरी नहीं.
subtitle

string

कलेक्शन का सबटाइटल. ज़रूरी नहीं.
items[]

object (CollectionItem)

कम से कम: 2 ज़्यादा से ज़्यादा: 10
imageFill

enum (ImageFill)

कलेक्शन आइटम के इमेज के बैकग्राउंड कैसे भरे जाएंगे. ज़रूरी नहीं.

CollectionItem

संग्रह का एक आइटम

JSON के काेड में दिखाना 
{
  "key": string
}
फ़ील्ड
key

string

ज़रूरी है. एनएलयू कुंजी, जो संबंधित टाइप में एंट्री कुंजी के नाम से मेल खाती है.

सूची

चुनने के लिए विकल्पों की सूची दिखाने वाला कार्ड.

JSON के काेड में दिखाना 
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}
फ़ील्ड
title

string

सूची का टाइटल. ज़रूरी नहीं.
subtitle

string

सूची का सबटाइटल. ज़रूरी नहीं.
items[]

object (ListItem)

कम से कम: 2 ज़्यादा से ज़्यादा: 30

ListItem

सूची का एक आइटम

JSON के काेड में दिखाना 
{
  "key": string
}
फ़ील्ड
key

string

ज़रूरी है. NLU कुंजी, जो संबंधित टाइप में एंट्री कुंजी के नाम से मेल खाती है.

सुझाव

उपयोगकर्ता को दिखाया जाने वाला इनपुट सुझाव.

JSON के काेड में दिखाना 
{
  "title": string
}
फ़ील्ड
title

string

ज़रूरी है. सुझाव वाले चिप में दिखाया गया टेक्स्ट. टैप करने पर, टेक्स्ट को ठीक वैसे ही बातचीत में पोस्ट कर दिया जाएगा जैसे उपयोगकर्ता ने उसे टाइप किया हो. सुझाव वाले चिप के सेट के बीच, हर टाइटल यूनीक होना चाहिए. ज़्यादा से ज़्यादा 25 वर्ण

डाइग्नोस्टिक्स

बातचीत के राउंड से जुड़ी गड़बड़ी की जानकारी.

JSON के काेड में दिखाना 
{
  "actionsBuilderEvents": [
    {
      object (ExecutionEvent)
    }
  ]
}
फ़ील्ड
actionsBuilderEvents[]

object (ExecutionEvent)

Actions Builder इंटरैक्शन मॉडल के सभी चरणों में बातचीत के राउंड को प्रोसेस करने के बारे में जानकारी वाले इवेंट की सूची. Actions Builder के लिए भरा गया और सिर्फ़ SDK टूल वाले ऐप्लिकेशन.

ExecutionEvent

इसमें, Actions Builder के साथ बातचीत का अनुरोध प्रोसेस करने के दौरान हुए एक्ज़ीक्यूशन इवेंट के बारे में जानकारी होती है. बातचीत के अनुरोध में शामिल अलग-अलग चरणों की खास जानकारी के लिए, https://developers.google.com/assistant/conversational/actions पर जाएं.

JSON के काेड में दिखाना 
{
  "eventTime": string,
  "executionState": {
    object (ExecutionState)
  },
  "status": {
    object (Status)
  },
  "warningMessages": [
    string
  ],

  // Union field EventData can be only one of the following:
  "userInput": {
    object (UserConversationInput)
  },
  "intentMatch": {
    object (IntentMatch)
  },
  "conditionsEvaluated": {
    object (ConditionsEvaluated)
  },
  "onSceneEnter": {
    object (OnSceneEnter)
  },
  "webhookRequest": {
    object (WebhookRequest)
  },
  "webhookResponse": {
    object (WebhookResponse)
  },
  "webhookInitiatedTransition": {
    object (WebhookInitiatedTransition)
  },
  "slotMatch": {
    object (SlotMatch)
  },
  "slotRequested": {
    object (SlotRequested)
  },
  "slotValidated": {
    object (SlotValidated)
  },
  "formFilled": {
    object (FormFilled)
  },
  "waitingUserInput": {
    object (WaitingForUserInput)
  },
  "endConversation": {
    object (EndConversation)
  }
  // End of list of possible types for union field EventData.
}
फ़ील्ड
eventTime

string (Timestamp format)

इवेंट के समय का टाइमस्टैंप.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
executionState

object (ExecutionState)

इस इवेंट के दौरान चलाने की स्थिति.
status

object (Status)

किसी खास एक्ज़ीक्यूशन चरण की नतीजे वाली स्थिति.
warningMessages[]

string

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

object (UserConversationInput)

उपयोगकर्ता के इनपुट को मैनेज करने वाला इवेंट.
intentMatch

object (IntentMatch)

इंटेंट मैच करने वाला इवेंट.
conditionsEvaluated

object (ConditionsEvaluated)

स्थिति के आकलन का इवेंट.
onSceneEnter

object (OnSceneEnter)

OnSceneEnter प्रोग्राम चलाने का इवेंट.
webhookRequest

object (WebhookRequest)

वेबहुक अनुरोध डिस्पैच इवेंट.
webhookResponse

object (WebhookResponse)

वेबहुक रिस्पॉन्स रसीद इवेंट.
webhookInitiatedTransition

object (WebhookInitiatedTransition)

वेबहुक से शुरू किया गया ट्रांज़िशन इवेंट.
slotMatch

object (SlotMatch)

स्लॉट मैचिंग इवेंट.
slotRequested

object (SlotRequested)

स्लॉट का अनुरोध करने वाला इवेंट.
slotValidated

object (SlotValidated)

स्लॉट की पुष्टि करने वाला इवेंट.
formFilled

object (FormFilled)

फ़ॉर्म भरने का इवेंट.
waitingUserInput

object (WaitingForUserInput)

उपयोगकर्ता के इनपुट के लिए इंतज़ार किया जा रहा इवेंट.
endConversation

object (EndConversation)

बातचीत खत्म होने का इवेंट.

ExecutionState

निष्पादन की मौजूदा स्थिति.

JSON के काेड में दिखाना 
{
  "currentSceneId": string,
  "sessionStorage": {
    object
  },
  "slots": {
    object (Slots)
  },
  "promptQueue": [
    {
      object (Prompt)
    }
  ],
  "userStorage": {
    object
  },
  "householdStorage": {
    object
  }
}
फ़ील्ड
currentSceneId

string

फ़िलहाल, सीन का आईडी.
sessionStorage

object (Struct format)

सेशन स्टोरेज की स्थिति: https://developers.google.com/assistant/conversational/storage-session
slots

object (Slots)

स्लॉट को भरने की स्थिति, अगर लागू हो: https://developers.google.com/assistant/conversational/scenes#slot_filling
promptQueue[]

object (Prompt)

प्रॉम्प्ट की सूची: https://developers.google.com/assistant/conversational/prompts
userStorage

object (Struct format)

उपयोगकर्ता के स्टोरेज की स्थिति: https://developers.google.com/assistant/conversational/storage-user
householdStorage

object (Struct format)

होम में स्टोरेज की स्थिति: https://developers.google.com/assistant/conversational/storage-home

कसीनो स्लॉट मशीन की नकल वाले गेम

सीन के स्लॉट की मौजूदा स्थिति दिखाता है.

JSON के काेड में दिखाना 
{
  "status": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  }
}
फ़ील्ड
status

enum (SlotFillingStatus)

स्लॉट भरने की मौजूदा स्थिति.
slots

map (key: string, value: object (Slot))

मौजूदा सीन से जुड़े स्लॉट.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

SlotFillingStatus

इससे स्लॉट भरने की मौजूदा स्थिति के बारे में पता चलता है.

Enums
UNSPECIFIED इस्तेमाल के फ़ील्ड में अपने-आप जानकारी नहीं भरने पर फ़ॉलबैक वैल्यू.
INITIALIZED स्लॉट भर दिए गए हैं, लेकिन स्लॉट भरने की प्रक्रिया शुरू नहीं हुई है.
COLLECTING स्लॉट की वैल्यू इकट्ठा की जा रही हैं.
FINAL सभी स्लॉट की वैल्यू फ़ाइनल हैं और उन्हें बदला नहीं जा सकता.

स्लॉट

स्लॉट को दिखाता है.

JSON के काेड में दिखाना 
{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}
फ़ील्ड
mode

enum (SlotMode)

स्लॉट का मोड (ज़रूरी या ज़रूरी नहीं). डेवलपर इसे सेट कर सकता है.
status

enum (SlotStatus)

स्लॉट की स्थिति.
value

value (Value format)

स्लॉट की वैल्यू. रिस्पॉन्स में इस वैल्यू को बदलने पर, स्लॉट फ़िलिंग में मौजूद वैल्यू में बदलाव होगा.
updated

boolean

यह बताता है कि स्लॉट वैल्यू को आखिरी बार इकट्ठा किया गया था या नहीं. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.
prompt

object (Prompt)

ज़रूरी नहीं. यह प्रॉम्प्ट किसी ज़रूरी स्लॉट को भरने के दौरान उपयोगकर्ता को भेजा जाता है. यह प्रॉम्प्ट, कंसोल में तय किए गए मौजूदा प्रॉम्प्ट को बदल देता है. वेबहुक अनुरोध में यह फ़ील्ड शामिल नहीं है.

SlotMode

स्लॉट के मोड को दिखाता है. इसका मतलब है कि स्लॉट की ज़रूरत है या नहीं.

Enums
MODE_UNSPECIFIED इस्तेमाल के फ़ील्ड में अपने-आप जानकारी नहीं भरने पर फ़ॉलबैक वैल्यू.
OPTIONAL इससे पता चलता है कि स्लॉट भरने की प्रोसेस को पूरा करने के लिए, स्लॉट की ज़रूरत नहीं है.
REQUIRED यह बताता है कि स्लॉट भरने के लिए स्लॉट की ज़रूरत है.

SlotStatus

स्लॉट की स्थिति को दिखाता है.

Enums
SLOT_UNSPECIFIED इस्तेमाल के फ़ील्ड में अपने-आप जानकारी नहीं भरने पर फ़ॉलबैक वैल्यू.
EMPTY यह बताता है कि स्लॉट में कोई वैल्यू नहीं है. इस स्टेटस को रिस्पॉन्स की मदद से बदला नहीं जा सकता.
INVALID इससे पता चलता है कि स्लॉट की वैल्यू अमान्य है. इस स्टेटस को रिस्पॉन्स की मदद से सेट किया जा सकता है.
FILLED यह बताता है कि स्लॉट की कोई वैल्यू है. इस स्टेटस को रिस्पॉन्स की मदद से बदला नहीं जा सकता.

स्थिति

Status टाइप, लॉजिकल एरर मॉडल के बारे में बताता है, जो अलग-अलग प्रोग्रामिंग एनवायरमेंट के लिए सही होता है. इनमें REST API और RPC एपीआई शामिल हैं. इसका इस्तेमाल gRPC करता है. हर Status मैसेज में डेटा के तीन हिस्से होते हैं: गड़बड़ी का कोड, गड़बड़ी का मैसेज, और गड़बड़ी की जानकारी.

आपको एपीआई डिज़ाइन गाइड में, गड़बड़ी वाले इस मॉडल और इसके साथ काम करने के तरीके के बारे में ज़्यादा जानकारी मिल सकती है.

JSON के काेड में दिखाना 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
फ़ील्ड
code

integer

स्टेटस कोड, जो google.rpc.Code की enum वैल्यू होनी चाहिए.
message

string

डेवलपर को भेजा जाने वाला गड़बड़ी का मैसेज, जो अंग्रेज़ी में होना चाहिए. उपयोगकर्ता को दिखने वाली गड़बड़ी के किसी भी मैसेज को स्थानीय भाषा में लिखा जाना चाहिए और google.rpc.Status.details फ़ील्ड में भेजा जाना चाहिए या क्लाइंट की ओर से स्थानीय भाषा में भेजा जाना चाहिए.
details[]

object

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

ऐसा ऑब्जेक्ट जिसमें आर्बिट्रेरी टाइप के फ़ील्ड शामिल होते हैं. अतिरिक्त फ़ील्ड "@type" में, टाइप की पहचान करने वाला यूआरआई होता है. उदाहरण: { "id": 1234, "@type": "types.example.com/standard/id" }.

UserConversationInput

उपयोगकर्ता के इनपुट से जुड़ी जानकारी.

JSON के काेड में दिखाना 
{
  "type": string,
  "originalQuery": string
}
फ़ील्ड
type

string

उपयोगकर्ता के इनपुट का टाइप. उदाहरण के लिए, कीबोर्ड, आवाज़, टच वगैरह की सुविधा.
originalQuery

string

उपयोगकर्ता से मिला ओरिजनल टेक्स्ट.

IntentMatch

ट्रिगर किए गए इंटेंट मैच के बारे में जानकारी (ग्लोबल या किसी सीन के अंदर): https://developers.google.com/assistant/conversational/intents

JSON के काेड में दिखाना 
{
  "intentId": string,
  "intentParameters": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "handler": string,
  "nextSceneId": string
}
फ़ील्ड
intentId

string

इस इंटरैक्शन को ट्रिगर करने वाला इंटेंट आईडी.
intentParameters

map (key: string, value: object (IntentParameterValue))

इस इंटरैक्शन को ट्रिगर करने वाले इंटेंट के पैरामीटर.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
handler

string

इस इंटरैक्शन से अटैच किए गए हैंडलर का नाम.
nextSceneId

string

यह इंटरैक्शन किस सीन पर ले जाता है.

ConditionsEvaluated

शर्तों के इवैलुएशन के नतीजे: https://developers.google.com/assistant/conversational/scenes#conditions

JSON के काेड में दिखाना 
{
  "failedConditions": [
    {
      object (Condition)
    }
  ],
  "successCondition": {
    object (Condition)
  }
}
फ़ील्ड
failedConditions[]

object (Condition)

उन शर्तों की सूची जिनका आकलन 'गलत' के तौर पर किया गया.
successCondition

object (Condition)

वह पहली शर्त जिसका आकलन 'सही' के तौर पर किया जाता है.

शर्त

कंडिशन का आकलन किया गया.

JSON के काेड में दिखाना 
{
  "expression": string,
  "handler": string,
  "nextSceneId": string
}
फ़ील्ड
expression

string

इस कंडिशन में एक्सप्रेशन तय किया गया है.
handler

string

मूल्यांकन की गई शर्त में हैंडलर का नाम.
nextSceneId

string

आकलन की गई शर्त में डेस्टिनेशन सीन है.

OnSceneEnter

onSceneEnter स्टेज लागू करने के बारे में जानकारी: https://developers.google.com/assistant/conversational/scenes#onEnter

JSON के काेड में दिखाना 
{
  "handler": string
}
फ़ील्ड
handler

string

onSceneEnter इवेंट में दिए गए हैंडलर का नाम.

WebhookRequest

ऐक्शन वेबहुक पर भेजे गए अनुरोध के बारे में जानकारी: https://developers.google.com/assistant/conversational/webhooks#payloads

JSON के काेड में दिखाना 
{
  "requestJson": string
}
फ़ील्ड
requestJson

string

वेबहुक अनुरोध का पेलोड.

WebhookResponse

ऐक्शन वेबहुक से मिले जवाब के बारे में जानकारी: https://developers.google.com/assistant/conversational/webhooks#payloads

JSON के काेड में दिखाना 
{
  "responseJson": string
}
फ़ील्ड
responseJson

string

वेबहुक रिस्पॉन्स का पेलोड.

WebhookInitiatedTransition

वेबहुक से, डेस्टिनेशन सीन के ज़रिए ट्रिगर किया गया इवेंट: https://developers.google.com/assistant/conversational/webhooks#transition_scenes

JSON के काेड में दिखाना 
{
  "nextSceneId": string
}
फ़ील्ड
nextSceneId

string

उस सीन का आईडी जिस पर ट्रांज़िशन ले जा रहा है.

SlotMatch

मैच होने वाले स्लॉट के बारे में जानकारी: https://developers.google.com/assistant/conversational/scenes#slot_filling

JSON के काेड में दिखाना 
{
  "nluParameters": {
    string: {
      object (IntentParameterValue)
    },
    ...
  }
}
फ़ील्ड
nluParameters

map (key: string, value: object (IntentParameterValue))

ऐसे पैरामीटर जिन्हें उपयोगकर्ता के इनपुट से NLU ने निकाला है.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

SlotRequested

फ़िलहाल, अनुरोध किए गए स्लॉट के बारे में जानकारी यहां दी गई है: https://developers.google.com/assistant/conversational/scenes#slot_filling

JSON के काेड में दिखाना 
{
  "slot": string,
  "prompt": {
    object (Prompt)
  }
}
फ़ील्ड
slot

string

अनुरोध किए गए स्लॉट का नाम.
prompt

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

एजेंट के साथ बातचीत खत्म होने की जानकारी देने वाला इवेंट.