कार्ड प्रिंट करने की सेवा

कार्ड पर आधारित ऐड-ऑन, साइडबार में या मोबाइल पर मेन्यू के ज़रिए एक और गतिविधि विंडो तक पहुंचने वाले पैनल के तौर पर दिखता है. ऐड-ऑन में एक टॉप टूलबार होता है, जो ऐड-ऑन की पहचान करता है और ज़रूरी है कि एक कार्ड होता है, जो वाकई ऐड-ऑन और #यूज़र इंटरफ़ेस (यूआई) का होती है. Apps Script, Card ऑब्जेक्ट का इस्तेमाल करके, प्रोजेक्ट कोड में कार्ड दिखाता है.

कार्ड एनाटॉमी

ऐड-ऑन कार्ड का उदाहरण

कार्ड, यूज़र इंटरफ़ेस (यूआई) एलिमेंट का एक ग्रुप होता है जिसे आप डिज़ाइन करते हैं. कार्ड में ये सेक्शन होते हैं:

  • कार्ड हेडर. यह कार्ड की पहचान करता है. इसमें शीर्षक टेक्स्ट होता है. साथ ही, इसमें सबटाइटल और आइकॉन भी हो सकता है.
  • एक या उससे ज़्यादा कार्ड सेक्शन. ये कार्ड और इसके यूज़र इंटरफ़ेस (यूआई) के हिस्से हैं. सेक्शन में वैकल्पिक रूप से टेक्स्ट सेक्शन का हेडर हो सकता है. हॉरिज़ॉन्टल नियम के मुताबिक, कार्ड के सेक्शन एक-दूसरे से अलग होते हैं. अगर कार्ड का सेक्शन खास तौर पर बड़ा है, तो उसे अपने-आप छोटा किया जा सकने वाला सेक्शन बनाया जाता है. उपयोगकर्ता इसे ज़रूरत के हिसाब से बड़ा या छोटा कर सकते हैं. एक कार्ड में 100 से ज़्यादा कार्ड सेक्शन नहीं हो सकते और बेहतर परफ़ॉर्मेंस के लिए, सिर्फ़ कुछ सेक्शन होने चाहिए.

  • हर कार्ड सेक्शन में एक या एक से ज़्यादा यूज़र इंटरफ़ेस (यूआई) विजेट होते हैं. विजेट से उपयोगकर्ता को जानकारी या इंटरैक्टिव कंट्रोल मिलता है. कार्ड और कार्ड सेक्शन स्ट्रक्चरल विजेट हैं, इसलिए आप उन्हें कार्ड सेक्शन में नहीं जोड़ सकते. एक कार्ड सेक्शन में 100 से ज़्यादा विजेट नहीं हो सकते. साथ ही, उसे सबसे अच्छी परफ़ॉर्मेंस के लिए जितना हो सके उतना आसान होना चाहिए.

आपको खास उपयोगकर्ता गतिविधियों या डेटा सेट के लिए कार्ड डिज़ाइन करने चाहिए. उदाहरण के लिए, Google Workspace का कोई ऐड-ऑन जो Google Sheets से लिया गया डेटा दिखाता है, उसमें हर शीट से अलग डेटा हो सकता है.

एक से ज़्यादा कार्ड इस्तेमाल करना

ऐड-ऑन कार्ड का उदाहरण

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

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

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