ActionPackage

ऐक्शन पैकेज में किसी ऐप्लिकेशन के ड्राफ़्ट के साथ-साथ डिप्लॉय किए गए हर वर्शन का कॉन्टेंट होता है. इसमें, डायरेक्ट्री की लिस्टिंग की जानकारी, बातचीत का कॉन्फ़िगरेशन, और खाता लिंक करना शामिल है.

जेएसओएन के काेड में दिखाना
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
फ़ील्ड
manifest

object (Manifest)

ऐप्लिकेशन की जानकारी. यहां डायरेक्ट्री लिस्टिंग को सेव किया जाता है. साथ ही, ऐप्लिकेशन की जानकारी देने वाले अन्य ऐप्लिकेशन, जैसे कि DisplayName को भी यहां सेव किया जाता है.

accountLinking

object (AccountLinking)

इस ऐप्लिकेशन पर खाता लिंक करने के बारे में जानकारी.

actions[]

object (Action)

उन कार्रवाइयों की सूची जिन्हें ऐप्लिकेशन मैनेज कर सकता है.

types[]

object (Type)

डेवलपर के तय किए गए टाइप की सूची.

conversations

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

उन बातचीत को मैप करें जिन्हें actions पर शेयर किया जा सकता है. उदाहरण के लिए, Fulfillment में conversationName देखें.

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

locale

string

इस कार्रवाई के पैकेज के लिए स्थान-भाषा. इसे BCP-47 भाषा स्ट्रिंग, जैसे कि "en", "en-US", "fr", "fr-CA", "sr-Latn", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-HK" वगैरह से दिखाई जाती है. यह तब ज़रूरी होता है, जब कोई ऐप्लिकेशन एक से ज़्यादा भाषाओं में काम करता है. हर साथ काम करने वाली स्थान-भाषा का अपना Actionpackage होता है. अगर वैल्यू नहीं दी जाती है, तो एजेंट की डिफ़ॉल्ट स्थान-भाषा को शामिल किया जाएगा.

मेनिफ़ेस्ट

ऐप्लिकेशन के लिए मेटाडेटा का सेट. इस मैसेज के कॉन्टेंट का इस्तेमाल कई कॉन्टेक्स्ट में किया जाता है:

  1. कार्रवाइयों की सूची देख सकते हैं.
  2. साफ़ तौर पर बातचीत शुरू करने के लिए किसी ऐप्लिकेशन की खास पहचान (displayName).
  3. ActionPackage के अन्य हिस्सों के लिए कॉन्टेंट (shortDescription का इस्तेमाल AccountLinking में दिखाने के लिए किया जाता है, displayName का इस्तेमाल actions में उपयोगकर्ताओं को ऐप्लिकेशन का नाम दिखाने के लिए किया जाता है).

इस मैसेज को सिर्फ़ पढ़ा जा सकता है. इस मैसेज में फ़ील्ड की जानकारी, ऐक्शन कंसोल के ज़रिए दी जाती है, न कि सीधे ऐक्शन पैकेज में.

जेएसओएन के काेड में दिखाना
{
  "displayName": string,
  "invocationName": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "shortDescription": string,
  "longDescription": string,
  "category": string,
  "smallSquareLogoUrl": string,
  "largeLandscapeLogoUrl": string,
  "companyName": string,
  "contactEmail": string,
  "termsOfServiceUrl": string,
  "privacyUrl": string,
  "sampleInvocation": [
    string
  ],
  "introduction": string,
  "testingInstructions": string,
  "voiceName": string,
  "externalVoiceName": string,
  "voiceLocale": string,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  }
}
फ़ील्ड
displayName

string

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

invocationName

string

यह इस ऐप्लिकेशन का खास नाम है, ताकि इसे सीधे आवाज़ (बोले गए) में इस्तेमाल किया जा सके. नीतियों के मुताबिक, बातचीत शुरू करने वाले नाम का फ़ोन नंबर, displayName फ़ील्ड से काफ़ी मिलता-जुलता होना चाहिए.

enabledRegions[]

string (int64 format)

उन इलाकों के लिए AdWords मानदंड आईडी जहां उपयोगकर्ता की मौजूदगी की जगह के आधार पर ऐप्लिकेशन को अनुमति है. https://developers.google.com/adwords/api/docs/appendix/geotargeting देखें

disabledRegions[]

string (int64 format)

उन इलाकों के लिए AdWords मानदंड आईडी जहां उपयोगकर्ता की मौजूदगी की जगह के आधार पर ऐप्लिकेशन को ब्लॉक किया गया है. https://developers.google.com/adwords/api/docs/appendix/geotargeting देखें

shortDescription

string

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

longDescription

string

ऐप्लिकेशन का डिफ़ॉल्ट लंबा ब्यौरा (अगर कोई अनुवाद उपलब्ध न हो). इसमें ज़्यादा से ज़्यादा 4,000 वर्ण हो सकते हैं.

category

string

ऐप्लिकेशन की कैटगरी. वैल्यू, ऐप्लिकेशन के लिए मंज़ूर की गई कैटगरी में से एक होनी चाहिए. अनुमति वाली कैटगरी की सूची देखने के लिए, Google Console पर कार्रवाइयां देखें.

smallSquareLogoUrl

string

स्मॉल स्क्वेयर इमेज. डाइमेंशन का साइज़ 192 पिक्सल x 192 पिक्सल होना चाहिए.

largeLandscapeLogoUrl

string

बड़ी लैंडस्केप इमेज. इसका डाइमेंशन 2208 पिक्सल x 1242 पिक्सल होना चाहिए.

companyName

string

उस कंपनी का नाम जिससे ऐप्लिकेशन जुड़ा है.

contactEmail

string

वह ईमेल पता जिस पर उपयोगकर्ता ऐप्लिकेशन के बारे में संपर्क कर सकते हैं.

termsOfServiceUrl

string

ऐप्लिकेशन की सेवा की शर्तों (सेवा की शर्तें) का यूआरएल.

privacyUrl

string

ऐप्लिकेशन की निजता नीति का यूआरएल.

sampleInvocation[]

string

सभी ऐप्लिकेशन की डायरेक्ट्री में, ऐप्लिकेशन के ब्यौरे के हिस्से के तौर पर, बातचीत शुरू करने वाले नाम का सैंपल दिखाया गया है. सिर्फ़ पांच वैल्यू दी जा सकती हैं.

introduction

string

इस बारे में खास जानकारी कि कोई ऐप्लिकेशन क्या कर सकता है. इसका इस्तेमाल, लोगों को ऐप्लिकेशन के बारे में बताने के लिए किया जाता है. यह एक ऐसा वाक्यांश होना चाहिए जिसमें कोई वाक्य पूरा हो. जैसे, "इस ऐप्लिकेशन का इस्तेमाल इन कामों के लिए किया जा सकता है..."

testingInstructions

string

ऐप्लिकेशन के समीक्षक के लिए, फ़्री फ़ॉर्म टेस्टिंग के निर्देश.

voiceName

string

इस्तेमाल की जाने वाली आवाज़ का नाम. इस्तेमाल की जा सकने वाली वैल्यू के उदाहरण: male_1, male_2, female_1, female_2.

externalVoiceName

string

इस एजेंट के लिए आवाज़ का बाहरी नाम. स्थान-भाषा की जानकारी शामिल नहीं होती.

voiceLocale

string

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

surfaceRequirements

object (SurfaceRequirements)

Google Assistant के क्लाइंट प्लैटफ़ॉर्म की कुछ ज़रूरी शर्तें, जिन्हें पूरा करने के बाद ही ऐप्लिकेशन ट्रिगर हो सकता है.

SurfaceRequirements

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

जेएसओएन के काेड में दिखाना
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
फ़ील्ड
minimumCapabilities[]

object (Capability)

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

अनुमति

यह किसी सुविधा की उपलब्धता से जुड़ी शर्त को दिखाता है

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

string

क्षमता का नाम, जैसे कि actions.capability.AUDIO_OUTPUT

Type

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

जेएसओएन के काेड में दिखाना
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
फ़ील्ड
name

string

type के फ़ॉर्मैट में, कस्टम टाइप का नाम.

entities[]
(deprecated)

object (Entity)

इस तरह की इकाइयों की सूची. हर एक में एक कुंजी और समानार्थी शब्दों की सूची होती है.

isUserDefined

boolean

क्या इकाइयां उपयोगकर्ता के हिसाब से तय की गई हैं (हर उपयोगकर्ता के लिए अलग-अलग).

इकाई

इस प्रकार के लिए हर एक इकाई अलग-अलग होती है. कुंजी यूनीक होनी चाहिए और समानार्थी शब्दों की सूची का इस्तेमाल, ट्रिगर करने के लिए किया जाता है.

जेएसओएन के काेड में दिखाना
{
  "key": string,
  "synonyms": [
    string
  ]
}
फ़ील्ड
key

string

इस आइटम के लिए खास कुंजी.

synonyms[]

string

समानार्थी शब्दों की सूची, जिनका इस्तेमाल इस आइटम के बारे में बताने के लिए किया जा सकता है.