Cards v2

কার্ড

Google Chat মেসেজে বা Google Workspace অ্যাড-অনে দেখানো কার্ড ইন্টারফেস।

কার্ডগুলি একটি সংজ্ঞায়িত লেআউট, বোতামগুলির মতো ইন্টারেক্টিভ UI উপাদান এবং ছবির মতো সমৃদ্ধ মিডিয়া সমর্থন করে৷ বিস্তারিত তথ্য উপস্থাপন করতে, ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ করতে এবং পরবর্তী পদক্ষেপ নিতে ব্যবহারকারীদের গাইড করতে কার্ড ব্যবহার করুন।

কার্ড নির্মাতার সাথে কার্ড ডিজাইন এবং পূর্বরূপ দেখুন।

কার্ড বিল্ডার খুলুন

কিভাবে কার্ড তৈরি করতে হয় তা জানতে, নিম্নলিখিত ডকুমেন্টেশন দেখুন:

দ্রষ্টব্য: আপনি প্রতি কার্ডে 100টি পর্যন্ত উইজেট যোগ করতে পারেন। এই সীমার বাইরে যেকোন উইজেট উপেক্ষা করা হয়। এই সীমাটি Google Chat অ্যাপে কার্ড মেসেজ এবং ডায়ালগ এবং Google Workspace অ্যাড-অন-এর কার্ডের ক্ষেত্রেই প্রযোজ্য।

উদাহরণ: একটি Google চ্যাট অ্যাপের জন্য কার্ড বার্তা

উদাহরণ যোগাযোগ কার্ড

Google Chat-এ নমুনা কার্ড বার্তা তৈরি করতে, নিম্নলিখিত JSON ব্যবহার করুন:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "[email protected]"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
JSON প্রতিনিধিত্ব
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "sectionDividerStyle": enum (DividerStyle),
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string,
  "fixedFooter": {
    object (CardFixedFooter)
  },
  "displayStyle": enum (DisplayStyle),
  "peekCardHeader": {
    object (CardHeader)
  }
}
ক্ষেত্র
header

object ( CardHeader )

কার্ডের হেডার। একটি হেডারে সাধারণত একটি অগ্রণী চিত্র এবং একটি শিরোনাম থাকে। হেডার সবসময় একটি কার্ডের শীর্ষে প্রদর্শিত হয়।

sections[]

object ( Section )

উইজেটগুলির একটি সংগ্রহ রয়েছে। প্রতিটি বিভাগের নিজস্ব, ঐচ্ছিক শিরোনাম আছে। বিভাগগুলি দৃশ্যত একটি লাইন বিভাজক দ্বারা পৃথক করা হয়। Google Chat অ্যাপের উদাহরণের জন্য, কার্ডের একটি বিভাগ সংজ্ঞায়িত করুন দেখুন।

sectionDividerStyle

enum ( DividerStyle )

হেডার, বিভাগ এবং ফুটারের মধ্যে বিভাজক শৈলী।

cardActions[]

object ( CardAction )

কার্ডের ক্রিয়াকলাপ। কার্ডের টুলবার মেনুতে অ্যাকশন যোগ করা হয়।

Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ এবং Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

উদাহরণস্বরূপ, নিম্নলিখিত JSON Settings এবং Send Feedback বিকল্পগুলির সাথে একটি কার্ড অ্যাকশন মেনু তৈরি করে:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

কার্ডের নাম। কার্ড নেভিগেশন একটি কার্ড শনাক্তকারী হিসাবে ব্যবহৃত.

Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ এবং Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

displayStyle

enum ( DisplayStyle )

Google Workspace অ্যাড-অনে, peekCardHeader ডিসপ্লে প্রপার্টি সেট করে।

Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ এবং Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

peekCardHeader

object ( CardHeader )

প্রাসঙ্গিক বিষয়বস্তু প্রদর্শন করার সময়, পিক কার্ড শিরোনাম একটি স্থানধারক হিসাবে কাজ করে যাতে ব্যবহারকারী হোমপেজ কার্ড এবং প্রাসঙ্গিক কার্ডগুলির মধ্যে এগিয়ে যেতে পারে৷

Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ এবং Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

কার্ড হেডার

একটি কার্ড হেডার প্রতিনিধিত্ব করে। Google চ্যাট অ্যাপের উদাহরণের জন্য, একটি শিরোনাম যোগ করুন দেখুন।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

JSON প্রতিনিধিত্ব
{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}
ক্ষেত্র
title

string

প্রয়োজন। কার্ড হেডারের শিরোনাম। শিরোনামটির একটি নির্দিষ্ট উচ্চতা রয়েছে: যদি একটি শিরোনাম এবং উপশিরোনাম উভয়ই নির্দিষ্ট করা হয়, প্রতিটি একটি লাইন নেয়। শুধুমাত্র শিরোনাম নির্দিষ্ট করা হলে, এটি উভয় লাইন আপ করে।

subtitle

string

কার্ড হেডারের সাবটাইটেল। নির্দিষ্ট করা হলে, title নীচে তার নিজস্ব লাইনে উপস্থিত হয়।

imageType

enum ( ImageType )

ছবি ক্রপ করতে ব্যবহৃত আকৃতি।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

imageUrl

string

কার্ড হেডারে ছবির HTTPS URL।

imageAltText

string

এই চিত্রের বিকল্প পাঠ্য যা অ্যাক্সেসযোগ্যতার জন্য ব্যবহৃত হয়।

ইমেজ টাইপ

ছবি ক্রপ করতে ব্যবহৃত আকৃতি।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

এনামস
SQUARE ডিফল্ট মান। ছবিতে একটি বর্গাকার মুখোশ প্রয়োগ করুন। উদাহরণস্বরূপ, একটি 4x3 চিত্র 3x3 হয়ে যায়।
CIRCLE ছবিতে একটি বৃত্তাকার মুখোশ প্রয়োগ করুন। উদাহরণস্বরূপ, একটি 4x3 চিত্র 3 ব্যাস সহ একটি বৃত্তে পরিণত হয়।

ধারা

একটি বিভাগে উইজেটগুলির একটি সংগ্রহ রয়েছে যা উল্লম্বভাবে উল্লম্বভাবে রেন্ডার করা হয় যেগুলি নির্দিষ্ট করা হয়েছে৷

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

JSON প্রতিনিধিত্ব
{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer,
  "collapseControl": {
    object (CollapseControl)
  }
}
ক্ষেত্র
header

string

একটি বিভাগের শীর্ষে প্রদর্শিত পাঠ্য। সহজ এইচটিএমএল ফরম্যাটেড টেক্সট সমর্থন করে। টেক্সট ফর্ম্যাট করার বিষয়ে আরও তথ্যের জন্য, Google Chat অ্যাপে টেক্সট ফর্ম্যাটিং এবং Google Workspace অ্যাড-অনগুলিতে টেক্সট ফর্ম্যাটিং দেখুন।

widgets[]

object ( Widget )

বিভাগে সব উইজেট. কমপক্ষে একটি উইজেট থাকতে হবে।

collapsible

boolean

এই বিভাগটি সংকোচনযোগ্য কিনা তা নির্দেশ করে৷

সংকোচনযোগ্য বিভাগগুলি কিছু বা সমস্ত উইজেট লুকিয়ে রাখে, তবে ব্যবহারকারীরা আরও দেখান ক্লিক করে লুকানো উইজেটগুলি প্রকাশ করতে বিভাগটি প্রসারিত করতে পারে। ব্যবহারকারীরা কম দেখান ক্লিক করে আবার উইজেটগুলি লুকিয়ে রাখতে পারেন৷

কোন উইজেটগুলি লুকানো আছে তা নির্ধারণ করতে, uncollapsibleWidgetsCount নির্দিষ্ট করুন।

uncollapsibleWidgetsCount

integer

অসংলগ্ন উইজেটের সংখ্যা যা একটি বিভাগ ভেঙে গেলেও দৃশ্যমান থাকে।

উদাহরণস্বরূপ, যখন একটি বিভাগে পাঁচটি উইজেট থাকে এবং uncollapsibleWidgetsCount 2 তে সেট করা হয়, প্রথম দুটি উইজেট সর্বদা দেখানো হয় এবং শেষ তিনটি ডিফল্টরূপে ভেঙে ফেলা হয়। uncollapsibleWidgetsCount শুধুমাত্র তখনই বিবেচনা করা হয় যখন collapsible true হয়।

collapseControl

object ( CollapseControl )

ঐচ্ছিক। বিভাগের প্রসারিত এবং সঙ্কুচিত বোতামটি সংজ্ঞায়িত করুন। বিভাগটি সংকোচনযোগ্য হলেই এই বোতামটি দেখানো হবে। এই ক্ষেত্র সেট না থাকলে, ডিফল্ট বোতাম ব্যবহার করা হয়।

উইজেট

প্রতিটি কার্ড উইজেট দিয়ে তৈরি।

একটি উইজেট হল একটি যৌগিক বস্তু যা পাঠ্য, চিত্র, বোতাম এবং অন্যান্য অবজেক্ট প্রকারের একটিকে উপস্থাপন করতে পারে।

JSON প্রতিনিধিত্ব
{
  "horizontalAlignment": enum (HorizontalAlignment),

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "divider": {
    object (Divider)
  },
  "grid": {
    object (Grid)
  },
  "columns": {
    object (Columns)
  },
  "carousel": {
    object (Carousel)
  },
  "chipList": {
    object (ChipList)
  }
  // End of list of possible types for union field data.
}
ক্ষেত্র
horizontalAlignment

enum ( HorizontalAlignment )

উইজেটগুলি একটি কলামের বাম, ডান বা কেন্দ্রে সারিবদ্ধ কিনা তা নির্দিষ্ট করে৷

ইউনিয়ন ফিল্ড data । একটি উইজেটে শুধুমাত্র নিম্নলিখিত আইটেমগুলির একটি থাকতে পারে৷ আপনি আরও আইটেম প্রদর্শন করতে একাধিক উইজেট ক্ষেত্র ব্যবহার করতে পারেন। data নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
textParagraph

object ( TextParagraph )

একটি পাঠ্য অনুচ্ছেদ প্রদর্শন করে। সহজ এইচটিএমএল ফরম্যাটেড টেক্সট সমর্থন করে। টেক্সট ফর্ম্যাট করার বিষয়ে আরও তথ্যের জন্য, Google Chat অ্যাপে টেক্সট ফর্ম্যাটিং এবং Google Workspace অ্যাড-অনগুলিতে টেক্সট ফর্ম্যাটিং দেখুন।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি বোল্ড লেখা তৈরি করে:

"textParagraph": {
  "text": "  <b>bold text</b>"
}
image

object ( Image )

একটি চিত্র প্রদর্শন করে।

উদাহরণস্বরূপ, নিম্নলিখিত JSON বিকল্প পাঠ্য সহ একটি চিত্র তৈরি করে:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}
decoratedText

object ( DecoratedText )

একটি সজ্জিত পাঠ্য আইটেম প্রদর্শন করে।

উদাহরণস্বরূপ, নিম্নলিখিত JSON ইমেল ঠিকানা দেখানো একটি সজ্জিত পাঠ্য উইজেট তৈরি করে:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "[email protected]",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
buttonList

object ( ButtonList )

বোতামগুলির একটি তালিকা।

উদাহরণস্বরূপ, নিম্নলিখিত JSON দুটি বোতাম তৈরি করে। প্রথমটি একটি নীল পাঠ্য বোতাম এবং দ্বিতীয়টি একটি চিত্র বোতাম যা একটি লিঙ্ক খোলে:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

object ( TextInput )

ব্যবহারকারীরা টাইপ করতে পারে এমন একটি পাঠ্য বাক্স প্রদর্শন করে৷

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি ইমেল ঠিকানার জন্য একটি পাঠ্য ইনপুট তৈরি করে:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

আরেকটি উদাহরণ হিসাবে, নিম্নলিখিত JSON স্ট্যাটিক পরামর্শ সহ একটি প্রোগ্রামিং ভাষার জন্য একটি পাঠ্য ইনপুট তৈরি করে:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selectionInput

object ( SelectionInput )

একটি নির্বাচন নিয়ন্ত্রণ প্রদর্শন করে যা ব্যবহারকারীদের আইটেম নির্বাচন করতে দেয়। নির্বাচন নিয়ন্ত্রণগুলি চেকবক্স, রেডিও বোতাম, সুইচ বা ড্রপডাউন মেনু হতে পারে।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি ড্রপডাউন মেনু তৈরি করে যা ব্যবহারকারীদের একটি আকার চয়ন করতে দেয়:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
dateTimePicker

object ( DateTimePicker )

একটি উইজেট প্রদর্শন করে যা ব্যবহারকারীদের একটি তারিখ, সময় বা তারিখ এবং সময় ইনপুট করতে দেয়।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি অ্যাপয়েন্টমেন্টের সময় নির্ধারণের জন্য একটি তারিখ সময় পিকার তৈরি করে:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": 796435200000
}
divider

object ( Divider )

উইজেটগুলির মধ্যে একটি অনুভূমিক রেখা বিভাজক প্রদর্শন করে।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি বিভাজক তৈরি করে:

"divider": {
}
grid

object ( Grid )

আইটেম সংগ্রহের সাথে একটি গ্রিড প্রদর্শন করে।

একটি গ্রিড যেকোনো সংখ্যক কলাম এবং আইটেম সমর্থন করে। সারির সংখ্যা কলামের সংখ্যা দ্বারা ভাগ করা সংখ্যা আইটেমের উপরের সীমানা দ্বারা নির্ধারিত হয়। 10টি আইটেম এবং 2টি কলাম সহ একটি গ্রিডে 5টি সারি রয়েছে৷ 11টি আইটেম এবং 2টি কলাম সহ একটি গ্রিডে 6টি সারি রয়েছে।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি একক আইটেম সহ একটি 2 কলাম গ্রিড তৈরি করে:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
columns

object ( Columns )

2টি কলাম পর্যন্ত প্রদর্শন করে।

2টির বেশি কলাম অন্তর্ভুক্ত করতে বা সারি ব্যবহার করতে, Grid উইজেট ব্যবহার করুন।

উদাহরণস্বরূপ, নিম্নলিখিত JSON 2টি কলাম তৈরি করে যার প্রতিটিতে পাঠ্য অনুচ্ছেদ রয়েছে:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}
carousel

object ( Carousel )

একটি ক্যারোজেলে নেস্টেড উইজেটগুলির একটি সংগ্রহ রয়েছে৷ উদাহরণস্বরূপ, এটি একটি ক্যারোজেলের একটি JSON উপস্থাপনা যাতে দুটি পাঠ্য অনুচ্ছেদ রয়েছে৷

{
  "widgets": [
    {
      "textParagraph": {
        "text": "First text paragraph in the carousel."
      }
    },
    {
      "textParagraph": {
        "text": "Second text paragraph in the carousel."
      }
    }
  ]
}
chipList

object ( ChipList )

চিপস একটি তালিকা.

উদাহরণস্বরূপ, নিম্নলিখিত JSON দুটি চিপ তৈরি করে। প্রথমটি একটি পাঠ্য চিপ এবং দ্বিতীয়টি একটি আইকন চিপ যা একটি লিঙ্ক খোলে:

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

পাঠ্য অনুচ্ছেদ

পাঠ্যের একটি অনুচ্ছেদ যা বিন্যাস সমর্থন করে। Google Chat অ্যাপের উদাহরণের জন্য, ফরম্যাট করা পাঠ্যের একটি অনুচ্ছেদ যুক্ত করুন দেখুন। টেক্সট ফর্ম্যাট করার বিষয়ে আরও তথ্যের জন্য, Google Chat অ্যাপে টেক্সট ফর্ম্যাটিং এবং Google Workspace অ্যাড-অনগুলিতে টেক্সট ফর্ম্যাটিং দেখুন।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

JSON প্রতিনিধিত্ব
{
  "text": string,
  "maxLines": integer,
  "textSyntax": enum (TextSyntax)
}
ক্ষেত্র
text

string

উইজেটে দেখানো টেক্সট।

maxLines

integer

উইজেটে প্রদর্শিত পাঠ্যের সর্বোচ্চ সংখ্যক লাইন। যদি পাঠ্যটি নির্দিষ্ট সর্বোচ্চ সংখ্যক লাইন অতিক্রম করে, অতিরিক্ত বিষয়বস্তু একটি শো মোর বোতামের পিছনে লুকিয়ে রাখা হয়। পাঠ্যটি নির্দিষ্ট সর্বোচ্চ সংখ্যক লাইনের চেয়ে সমান বা ছোট হলে, একটি আরও দেখান বোতাম প্রদর্শিত হবে না।

ডিফল্ট মান হল 0, এই ক্ষেত্রে সমস্ত প্রসঙ্গ প্রদর্শিত হয়। নেতিবাচক মান উপেক্ষা করা হয়.

textSyntax

enum ( TextSyntax )

পাঠ্যের সিনট্যাক্স। সেট করা না থাকলে, পাঠ্যটি HTML হিসাবে রেন্ডার করা হয়।

Google Chat অ্যাপের জন্য উপলভ্য এবং Google Workspace অ্যাড-অনগুলির জন্য অনুপলব্ধ।

টেক্সটসিনট্যাক্স

টেক্সট ফর্ম্যাট করার জন্য ব্যবহার করার জন্য সিনট্যাক্স।

Google Chat অ্যাপের জন্য উপলভ্য এবং Google Workspace অ্যাড-অনগুলির জন্য অনুপলব্ধ।

এনামস
TEXT_SYNTAX_UNSPECIFIED অনির্দিষ্ট থাকলে পাঠ্যটি HTML হিসাবে রেন্ডার করা হয়।
HTML পাঠ্যটি HTML হিসাবে রেন্ডার করা হয়। এটি ডিফল্ট মান।
MARKDOWN পাঠ্যটি মার্কডাউন হিসাবে রেন্ডার করা হয়েছে।

ছবি

একটি URL দ্বারা নির্দিষ্ট করা একটি চিত্র এবং একটি onClick অ্যাকশন থাকতে পারে৷ একটি উদাহরণের জন্য, একটি ছবি যোগ করুন দেখুন।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

JSON প্রতিনিধিত্ব
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "altText": string
}
ক্ষেত্র
imageUrl

string

HTTPS URL যেটি ছবিটি হোস্ট করে।

যেমন:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
onClick

object ( OnClick )

যখন একজন ব্যবহারকারী ছবিটিতে ক্লিক করেন, তখন ক্লিকটি এই ক্রিয়াকে ট্রিগার করে।

altText

string

এই চিত্রের বিকল্প পাঠ্য যা অ্যাক্সেসযোগ্যতার জন্য ব্যবহৃত হয়।

অনক্লিক

ব্যবহারকারীরা একটি কার্ডে একটি ইন্টারেক্টিভ উপাদান, যেমন একটি বোতামে ক্লিক করলে কীভাবে প্রতিক্রিয়া জানাবেন তা প্রতিনিধিত্ব করে৷

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

JSON প্রতিনিধিত্ব
{

  // Union field data can be only one of the following:
  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  },
  "overflowMenu": {
    object (OverflowMenu)
  }
  // End of list of possible types for union field data.
}
ক্ষেত্র

ইউনিয়ন ফিল্ড data

data নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

action

object ( Action )

নির্দিষ্ট করা থাকলে, এই onClick দ্বারা একটি ক্রিয়া ট্রিগার হয়।

card

object ( Card )

নির্দিষ্ট করা থাকলে ক্লিক করার পর একটি নতুন কার্ড কার্ড স্ট্যাকে পুশ করা হয়।

Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ এবং Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

overflowMenu

object ( OverflowMenu )

নির্দিষ্ট করা থাকলে, এই onClick একটি ওভারফ্লো মেনু খোলে।

অ্যাকশন

ফর্ম জমা দেওয়ার সময় আচরণের বর্ণনা দেয় এমন একটি ক্রিয়া। উদাহরণস্বরূপ, আপনি ফর্মটি পরিচালনা করতে একটি Apps স্ক্রিপ্ট স্ক্রিপ্ট আহ্বান করতে পারেন৷ যদি ক্রিয়াটি ট্রিগার করা হয়, ফর্মের মানগুলি সার্ভারে পাঠানো হয়।

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 । চ্যাট অ্যাপ্লিকেশানগুলিতে কার্ড বার্তাগুলির জন্য, আপনাকে অবশ্যই অ্যাকশনের ResponseType UPDATE_MESSAGE এ সেট করতে হবে এবং যে কার্ডটিতে অ্যাকশন রয়েছে সেই কার্ড থেকে একই cardId ব্যবহার করতে হবে৷

false হলে, ক্রিয়াটি ট্রিগার হলে ফর্মের মানগুলি সাফ করা হয়। ক্রিয়াটি প্রক্রিয়াকরণের সময় ব্যবহারকারীকে পরিবর্তন করা থেকে বিরত রাখতে, LoadIndicator SPINNER এ সেট করুন।

interaction

enum ( Interaction )

ঐচ্ছিক। একটি ডায়ালগ খোলার সময় প্রয়োজন।

একজন ব্যবহারকারীর সাথে ইন্টারঅ্যাকশনের প্রতিক্রিয়ায় কী করবেন, যেমন একজন ব্যবহারকারী কার্ড বার্তায় একটি বোতামে ক্লিক করছেন।

অনির্দিষ্ট থাকলে, অ্যাপটি একটি action সম্পাদন করে সাড়া দেয় - যেমন একটি লিঙ্ক খোলা বা একটি ফাংশন চালানো - স্বাভাবিক হিসাবে।

একটি interaction নির্দিষ্ট করে, অ্যাপটি বিশেষ ইন্টারেক্টিভ উপায়ে প্রতিক্রিয়া জানাতে পারে। উদাহরণস্বরূপ, OPEN_DIALOGinteraction সেট করে, অ্যাপটি একটি ডায়ালগ খুলতে পারে। নির্দিষ্ট করা হলে, একটি লোডিং সূচক দেখানো হয় না। একটি অ্যাড-অনের জন্য নির্দিষ্ট করা হলে, পুরো কার্ডটি ছিনতাই করা হয় এবং ক্লায়েন্টে কিছুই দেখানো হয় না।

Google Chat অ্যাপের জন্য উপলভ্য এবং Google Workspace অ্যাড-অনগুলির জন্য অনুপলব্ধ।

requiredWidgets[]

string

ঐচ্ছিক। একটি বৈধ জমা দেওয়ার জন্য এই অ্যাকশনের প্রয়োজন এমন উইজেটের নাম দিয়ে এই তালিকাটি পূরণ করুন।

এই অ্যাকশনটি চালু করার সময় এখানে তালিকাভুক্ত উইজেটগুলির একটি মান না থাকলে, ফর্ম জমা দেওয়া বাতিল করা হয়।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

allWidgetsAreRequired

boolean

ঐচ্ছিক। যদি এটি সত্য হয়, তাহলে সমস্ত উইজেট এই কর্মের জন্য প্রয়োজনীয় বলে বিবেচিত হয়।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

অ্যাকশন প্যারামিটার

যখন অ্যাকশন পদ্ধতি চালু করা হয় তখন সরবরাহ করার জন্য স্ট্রিং প্যারামিটারের তালিকা। উদাহরণস্বরূপ, তিনটি স্নুজ বোতাম বিবেচনা করুন: এখনই স্নুজ করুন, একদিন স্নুজ করুন বা পরের সপ্তাহে স্নুজ করুন৷ আপনি action method = snooze() , স্ট্রিং প্যারামিটারের তালিকায় স্নুজ টাইপ এবং স্নুজ সময় পাস করে।

আরও জানতে, CommonEventObject দেখুন।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

JSON প্রতিনিধিত্ব
{
  "key": string,
  "value": string
}
ক্ষেত্র
key

string

অ্যাকশন স্ক্রিপ্টের জন্য প্যারামিটারের নাম।

value

string

প্যারামিটারের মান।

লোড ইন্ডিকেটর

অ্যাকশনে কল করার সময় অ্যাকশনটি যে লোডিং সূচকটি প্রদর্শন করে তা নির্দিষ্ট করে।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ।

এনামস
SPINNER কন্টেন্ট লোড হচ্ছে তা নির্দেশ করতে একটি স্পিনার দেখায়।
NONE কিছুই প্রদর্শিত হয় না.

মিথস্ক্রিয়া

ঐচ্ছিক। একটি ডায়ালগ খোলার সময় প্রয়োজন।

একজন ব্যবহারকারীর সাথে ইন্টারঅ্যাকশনের প্রতিক্রিয়ায় কী করবেন, যেমন একজন ব্যবহারকারী কার্ড বার্তায় একটি বোতামে ক্লিক করছেন।

অনির্দিষ্ট থাকলে, অ্যাপটি একটি action সম্পাদন করে সাড়া দেয় - যেমন একটি লিঙ্ক খোলা বা একটি ফাংশন চালানো - স্বাভাবিক হিসাবে।

একটি interaction নির্দিষ্ট করে, অ্যাপটি বিশেষ ইন্টারেক্টিভ উপায়ে প্রতিক্রিয়া জানাতে পারে। উদাহরণস্বরূপ, OPEN_DIALOGinteraction সেট করে, অ্যাপটি একটি ডায়ালগ খুলতে পারে।

নির্দিষ্ট করা হলে, একটি লোডিং সূচক দেখানো হয় না। একটি অ্যাড-অনের জন্য নির্দিষ্ট করা হলে, পুরো কার্ডটি ছিনতাই করা হয় এবং ক্লায়েন্টে কিছুই দেখানো হয় না।

Google Chat অ্যাপের জন্য উপলভ্য এবং Google Workspace অ্যাড-অনগুলির জন্য অনুপলব্ধ।

এনামস
INTERACTION_UNSPECIFIED ডিফল্ট মান। action স্বাভাবিক হিসাবে সঞ্চালিত হয়।
OPEN_DIALOG

একটি ডায়ালগ খোলে, একটি উইন্ডোযুক্ত, কার্ড-ভিত্তিক ইন্টারফেস যা চ্যাট অ্যাপ ব্যবহারকারীদের সাথে ইন্টারঅ্যাক্ট করতে ব্যবহার করে।

কার্ড বার্তাগুলিতে বোতাম-ক্লিকগুলির প্রতিক্রিয়া হিসাবে শুধুমাত্র চ্যাট অ্যাপগুলি দ্বারা সমর্থিত৷ একটি অ্যাড-অনের জন্য নির্দিষ্ট করা হলে, পুরো কার্ডটি ছিনতাই করা হয় এবং ক্লায়েন্টে কিছুই দেখানো হয় না।

Google Chat অ্যাপের জন্য উপলভ্য এবং Google Workspace অ্যাড-অনগুলির জন্য অনুপলব্ধ।