Action

फ़ॉर्म सबमिट होने पर, उसके काम करने के तरीके के बारे में बताने वाली कार्रवाई. उदाहरण के लिए, फ़ॉर्म को मैनेज करने के लिए, Apps Script की स्क्रिप्ट को कॉल किया जा सकता है. अगर कार्रवाई ट्रिगर होती है, तो फ़ॉर्म की वैल्यू सर्वर पर भेज दी जाती हैं.

यह Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है.

JSON के काेड में दिखाना 
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction),
  "requiredWidgets": [
    string
  ],
  "allWidgetsAreRequired": boolean
}
फ़ील्ड
function

string

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

इस्तेमाल का उदाहरण देखने के लिए, फ़ॉर्म का डेटा पढ़ें पर जाएं.
parameters[]

object (ActionParameter)

कार्रवाई के पैरामीटर की सूची.
loadIndicator

enum (LoadIndicator)

इससे, लोड होने की जानकारी देने वाले उस इंडिकेटर के बारे में पता चलता है जो कार्रवाई को कॉल करते समय दिखता है.
persistValues

boolean

इससे पता चलता है कि कार्रवाई के बाद, फ़ॉर्म की वैल्यू बनी रहती हैं या नहीं. डिफ़ॉल्ट वैल्यूfalse है

अगर true है, तो कार्रवाई ट्रिगर होने के बाद भी फ़ॉर्म की वैल्यू बनी रहती हैं. अगर आपको उपयोगकर्ता को कार्रवाई के दौरान बदलाव करने की अनुमति देनी है, तो LoadIndicator को NONE पर सेट करें. Chat ऐप्लिकेशन में कार्ड मैसेज के लिए, आपको कार्रवाई के ResponseType को UPDATE_MESSAGE पर सेट करना होगा. साथ ही, कार्रवाई वाले कार्ड से उसी cardId का इस्तेमाल करना होगा.

अगर false है, तो कार्रवाई ट्रिगर होने पर फ़ॉर्म की वैल्यू मिटा दी जाती हैं. कार्रवाई प्रोसेस होने के दौरान, उपयोगकर्ता को बदलाव करने से रोकने के लिए, LoadIndicator को SPINNER पर सेट करें.
interaction

enum (Interaction)

ज़रूरी नहीं. डायलॉग खोलते समय ज़रूरी है.

उपयोगकर्ता के साथ इंटरैक्शन के जवाब में क्या करना है. जैसे, उपयोगकर्ता का कार्ड मैसेज में मौजूद किसी बटन पर क्लिक करना.

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

interaction तय करके, ऐप्लिकेशन खास इंटरैक्टिव तरीकों से जवाब दे सकता है. उदाहरण के लिए, interaction को OPEN_DIALOG पर सेट करके, ऐप्लिकेशन डायलॉग खोल सकता है. अगर यह पैरामीटर सेट किया जाता है, तो लोड होने की जानकारी देने वाला इंडिकेटर नहीं दिखता. अगर किसी ऐड-ऑन के लिए यह वैल्यू तय की जाती है, तो पूरा कार्ड हटा दिया जाता है और क्लाइंट में कुछ भी नहीं दिखता.

यह Google Chat ऐप्लिकेशन के लिए उपलब्ध है और Google Workspace ऐड-ऑन के लिए उपलब्ध नहीं है.
requiredWidgets[]

string

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

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

यह Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है.
allWidgetsAreRequired

boolean

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

यह Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है.

ActionParameter

ऐक्शन मेथड को शुरू करने पर, स्ट्रिंग पैरामीटर की सूची. उदाहरण के लिए, स्नूज़ करने के तीन बटन: अभी स्नूज़ करें, एक दिन के लिए स्नूज़ करें या अगले हफ़्ते तक स्नूज़ करें. action method = snooze() का इस्तेमाल किया जा सकता है. इसके लिए, स्ट्रिंग पैरामीटर की सूची में स्नूज़ टाइप और स्नूज़ टाइम पास करें.

ज़्यादा जानने के लिए, CommonEventObject देखें.

यह Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है.

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

string

ऐक्शन स्क्रिप्ट के पैरामीटर का नाम.
value

string

पैरामीटर की वैल्यू.

LoadIndicator

इससे, लोड होने की जानकारी देने वाले उस इंडिकेटर के बारे में पता चलता है जो कार्रवाई को कॉल करते समय दिखता है.

यह Google Chat ऐप्लिकेशन और Google Workspace ऐड-ऑन के लिए उपलब्ध है.

Enums
SPINNER कॉन्टेंट लोड होने के दौरान, स्पिनर दिखाता है.
NONE कोई जानकारी नहीं दिखती.

बातचीत

ज़रूरी नहीं. डायलॉग खोलते समय ज़रूरी है.

उपयोगकर्ता के साथ इंटरैक्शन के जवाब में क्या करना है. जैसे, उपयोगकर्ता का कार्ड मैसेज में मौजूद किसी बटन पर क्लिक करना.

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

interaction तय करके, ऐप्लिकेशन खास इंटरैक्टिव तरीकों से जवाब दे सकता है. उदाहरण के लिए, interaction को OPEN_DIALOG पर सेट करके, ऐप्लिकेशन डायलॉग खोल सकता है.

अगर यह पैरामीटर सेट किया जाता है, तो लोड होने की जानकारी देने वाला इंडिकेटर नहीं दिखता. अगर किसी ऐड-ऑन के लिए यह वैल्यू तय की जाती है, तो पूरा कार्ड हटा दिया जाता है और क्लाइंट में कुछ भी नहीं दिखता.

यह Google Chat ऐप्लिकेशन के लिए उपलब्ध है और Google Workspace ऐड-ऑन के लिए उपलब्ध नहीं है.

Enums
INTERACTION_UNSPECIFIED डिफ़ॉल्ट मान. action सामान्य तरीके से काम करता है.
OPEN_DIALOG

यह एक डायलॉग खोलता है. यह विंडो वाला कार्ड-आधारित इंटरफ़ेस होता है. Chat ऐप्लिकेशन इसका इस्तेमाल, उपयोगकर्ताओं से इंटरैक्ट करने के लिए करते हैं.

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

यह Google Chat ऐप्लिकेशन के लिए उपलब्ध है और Google Workspace ऐड-ऑन के लिए उपलब्ध नहीं है.