AppRequest

AppRequest एक अनुरोध है, जिसे Google Assistant किसी कार्रवाई से इंटरैक्ट करने के लिए ऑर्डर पूरा करने के लिए भेजती है. एपीआई वर्शन की जानकारी एचटीटीपी हेडर में दी गई है. एपीआई के वर्शन 1 के हेडर में यह जानकारी होती है: Google-Assistant-API-Version: v1. एपीआई के वर्शन 2 के हेडर में यह शामिल है: Google-actions-API-Version: 2. Google पर कार्रवाइयों में इसका इस्तेमाल कैसे किया जाता है, इसके उदाहरणों के लिए https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json देखें .

JSON के काेड में दिखाना 
{
  "user": {
    object (User)
  },
  "device": {
    object (Device)
  },
  "surface": {
    object (Surface)
  },
  "conversation": {
    object (Conversation)
  },
  "inputs": [
    {
      object (Input)
    }
  ],
  "isInSandbox": boolean,
  "availableSurfaces": [
    {
      object (Surface)
    }
  ]
}
फ़ील्ड
user

object (User)

बातचीत शुरू करने वाला उपयोगकर्ता.
device

object (Device)

कार्रवाई से इंटरैक्ट करने के लिए उपयोगकर्ता जिस डिवाइस का इस्तेमाल कर रहा है उसके बारे में जानकारी.
surface

object (Surface)

उपयोगकर्ता किस प्लैटफ़ॉर्म के साथ इंटरैक्ट कर रहा है, इस बारे में जानकारी, उदाहरण के लिए क्या वह ऑडियो आउटपुट दे सकता है या उसमें स्क्रीन है.
conversation

object (Conversation)

इसमें, बातचीत का आईडी और बातचीत टोकन जैसा सेशन डेटा होल्ड किया जाता है.
inputs[]

object (Input)

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

boolean

इससे पता चलता है कि अनुरोध को सैंडबॉक्स मोड में हैंडल किया जाना चाहिए या नहीं.
availableSurfaces[]

object (Surface)

क्रॉस सरफ़ेस हैंडऑफ़ के लिए प्लैटफ़ॉर्म उपलब्ध हैं.

उपयोगकर्ता

JSON के काेड में दिखाना 
{
  "idToken": string,
  "profile": {
    object (UserProfile)
  },
  "accessToken": string,
  "permissions": [
    enum (Permission)
  ],
  "locale": string,
  "lastSeen": string,
  "userStorage": string,
  "packageEntitlements": [
    {
      object (PackageEntitlement)
    }
  ],
  "userVerificationStatus": enum (UserVerificationStatus)
}
फ़ील्ड
idToken

string

उपयोगकर्ता की पहचान दिखाने वाला टोकन. यह कोड में बदली गई प्रोफ़ाइल वाला Json वेब टोकन है. इसकी परिभाषा https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo पर दी गई है.
profile

object (UserProfile)

असली उपयोगकर्ता के बारे में जानकारी. कुछ फ़ील्ड सिर्फ़ तब उपलब्ध होते हैं, जब उपयोगकर्ता ने कार्रवाई को यह जानकारी देने की अनुमति दी हो.
accessToken

string

एक OAuth2 टोकन, जो आपके सिस्टम में उपयोगकर्ता की पहचान करता है. यह सिर्फ़ तब उपलब्ध होता है, जब उपयोगकर्ता अपना खाता लिंक करता है.
permissions[]

enum (Permission)

इस कार्रवाई के लिए उपयोगकर्ता ने जो अनुमतियां दी हैं वे शामिल हैं.
locale

string

अनुरोध करने वाले उपयोगकर्ता की मुख्य स्थान-भाषा. यह IETF BCP-47 भाषा कोड http://www.rfc-editor.org/rfc/bcp/bcp47.txt का अनुसरण करता है. हालांकि, स्क्रिप्ट सबटैग शामिल नहीं है.
lastSeen

string (Timestamp format)

इस उपयोगकर्ता के साथ हुए आखिरी इंटरैक्शन का टाइमस्टैंप. अगर उपयोगकर्ता ने पहले एजेंट से इंटरैक्ट नहीं किया है, तो यह फ़ील्ड शामिल नहीं किया जाएगा.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड तक सटीक होता है. उदाहरण: "2014-10-02T15:01:23.045123456Z".
userStorage

string

ऐप्लिकेशन से मिलने वाला एक ओपेक टोकन, जो किसी खास उपयोगकर्ता की बातचीत के दौरान मौजूद रहता है. स्ट्रिंग में ज़्यादा से ज़्यादा 10 हज़ार वर्ण हो सकते हैं.
packageEntitlements[]

object (PackageEntitlement)

अगर कार्रवाई पैकेज में कोई पैकेज शामिल है, तो उस पैकेज के नाम के लिए, उपयोगकर्ता के एनटाइटलमेंट की सूची.
userVerificationStatus

enum (UserVerificationStatus)

उपयोगकर्ता की पुष्टि की स्थिति को दिखाता है.

UserProfile

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

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

string

उपयोगकर्ता का पूरा नाम, जैसा कि उसके Google खाते में बताया गया है. NAME की अनुमति ज़रूरी है.
givenName

string

उपयोगकर्ता का नाम, जैसा कि उसके Google खाते में बताया गया है. NAME की अनुमति ज़रूरी है.
familyName

string

उपयोगकर्ता का उपनाम, जैसा कि उसके Google खाते में बताया गया है. ध्यान दें कि यह फ़ील्ड खाली हो सकता है. NAME की अनुमति ज़रूरी है.

PackageEntitlement

पैकेज के नाम से जुड़े एनटाइटलमेंट की सूची

JSON के काेड में दिखाना 
{
  "packageName": string,
  "entitlements": [
    {
      object (Entitlement)
    }
  ]
}
फ़ील्ड
packageName

string

कार्रवाई पैकेज में मौजूद पैकेज के नाम से मेल खाना चाहिए
entitlements[]

object (Entitlement)

किसी दिए गए ऐप्लिकेशन के लिए, एनटाइटलमेंट की सूची

पात्रता

इससे उपयोगकर्ता के डिजिटल एनटाइटलमेंट के बारे में पता चलता है. संभावित एनटाइटलमेंट के टाइप: पैसे चुकाकर डाउनलोड किए जाने वाले ऐप्लिकेशन,इन-ऐप्लिकेशन खरीदारी, इन-ऐप्लिकेशन सदस्यताएं.

JSON के काेड में दिखाना 
{
  "sku": string,
  "skuType": enum (SkuType),
  "inAppDetails": {
    object (SignedData)
  }
}
फ़ील्ड
sku

string

प्रॉडक्ट SKU. पैसे चुकाकर डाउनलोड किए जाने वाले ऐप्लिकेशन के पैकेज का नाम, इन-ऐप्लिकेशन खरीदारी और इन-ऐप्लिकेशन सदस्यता के लिए Finsky docid का सफ़िक्स. Play InApp Billing API में getSku() का मिलान करें.
skuType

enum (SkuType)
inAppDetails

object (SignedData)

यह सुविधा सिर्फ़ इन-ऐप्लिकेशन खरीदारी और इन-ऐप्लिकेशन सदस्यों के लिए उपलब्ध है.

SignedData

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

object (Struct format)

getPurchases() तरीके से INAPP_PURCHASE_DATA का मिलान करना. सभी इनऐप खरीदारी का डेटा JSON फ़ॉर्मैट में होता है. इसकी जानकारी https://developer.android.com/google/play/billing/billing_reference.html की छठी टेबल में देखें.
inAppDataSignature

string

Play InApp Billing API में getPurchases() तरीके से IN_APP_DATA_SIGNATURE से मेल खाता है.

डिवाइस

कार्रवाई से इंटरैक्ट करने के लिए उपयोगकर्ता जिस डिवाइस का इस्तेमाल कर रहा है उसके बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "location": {
    object (Location)
  }
}
फ़ील्ड
location

object (Location)

यह डिवाइस की असल जगह दिखाता है, जैसे कि अक्षांश, देशांतर, और फ़ॉर्मैट किया गया पता. इसके लिए, DEVICE_COARSE_LOCATION या DEVICE_PRECISE_LOCATION अनुमति की ज़रूरत होती है.

प्लैटफ़ॉर्म

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

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

object (Capability)

अनुरोध किए जाने पर, प्लैटफ़ॉर्म पर जो सुविधाएं इस्तेमाल की जा सकती हैं उनकी सूची, जैसे कि actions.capability.AUDIO_OUTPUT अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

अनुमति

फ़ंक्शन की वह इकाई दिखाता है जो सरफ़ेस काम कर सकता है.

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

string

सुविधा का नाम, जैसे कि actions.capability.AUDIO_OUTPUT अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

बातचीत

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

string

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

enum (ConversationType)

टाइप, लाइफ़साइकल में बातचीत की स्थिति को दिखाता है.
conversationToken

string

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

इनपुट

JSON के काेड में दिखाना 
{
  "rawInputs": [
    {
      object (RawInput)
    }
  ],
  "intent": string,
  "arguments": [
    {
      object (Argument)
    }
  ]
}
फ़ील्ड
rawInputs[]

object (RawInput)

बातचीत के हर पड़ाव से रॉ इनपुट ट्रांसक्रिप्शन. कार्रवाई को कुछ तरह के इनपुट देने के लिए, Google पर की जाने वाली कार्रवाइयों के लिए बातचीत को एक से ज़्यादा बार मोड़ना पड़ सकता है.
intent

string

इससे उपयोगकर्ता का इंटेंट दिखता है. बातचीत की पहली बारी के लिए, इंटेंट, कार्रवाई के लिए ट्रिगर करने वाले इंटेंट को दिखाएगा. बाद में होने वाली बातचीत के लिए, इंटेंट, Google इंटेंट पर एक सामान्य कार्रवाई होगी ('कार्रवाइयां' से शुरू होती है.) उदाहरण के लिए, अगर इनपुट actions.intent.OPTION है, तो अगर Google Assistant उस इंटेंट को पूरा कर सकी, तो यहां बताया गया इंटेंट actions.intent.OPTION होगा. अगर उपयोगकर्ता ने अन्य जानकारी दी है, तो उसे actions.intent.TEXT माना जाएगा. https://developers.google.com/assistant/df-asdk/reference/intents देखें.
arguments[]

object (Argument)

कार्रवाई के लिए अनुरोध किए गए इनपुट के लिए, दी गई आर्ग्युमेंट वैल्यू की सूची.

RawInput

JSON के काेड में दिखाना 
{
  "inputType": enum (InputType),

  // Union field input can be only one of the following:
  "query": string,
  "url": string
  // End of list of possible types for union field input.
}
फ़ील्ड
inputType

enum (InputType)

इससे पता चलता है कि उपयोगकर्ता ने यह इनपुट कैसे दिया: टाइप किया गया जवाब, बोलकर दिया जाने वाला जवाब, जानकारी नहीं दी गई वगैरह.
यूनियन फ़ील्ड input. इनपुट की असल वैल्यू input, इनमें से सिर्फ़ एक हो सकती है:
query

string

असली उपयोगकर्ता का टाइप या बोला गया इनपुट.
url

string

ट्रिगर करने वाला यूआरएल.