কার্ড এবং ডায়ালগ সমস্যা সমাধান এবং ঠিক করুন

এই নির্দেশিকায় কার্ড -সম্পর্কিত সাধারণ ত্রুটিগুলো, যা আপনি সম্মুখীন হতে পারেন, এবং সেগুলো কীভাবে সমাধান করা যায়, তা বর্ণনা করা হয়েছে।

চ্যাট অ্যাপের জন্য মেসেজিং ও ইউজার ইন্টারফেস ডিজাইন এবং প্রিভিউ করতে কার্ড বিল্ডার ব্যবহার করুন:

কার্ডের ত্রুটিগুলো কীভাবে দেখা দেয়

কার্ডের ত্রুটি বিভিন্নভাবে প্রকাশ পায়:

• কার্ডের কোনো অংশ, যেমন উইজেট বা কম্পোনেন্ট, প্রদর্শিত হয় না অথবা অপ্রত্যাশিতভাবে রেন্ডার হয়।
• সম্পূর্ণ কার্ডটি দেখা যাচ্ছে না।
• একটি ডায়ালগ বক্স বন্ধ হয়ে যায়, খোলে না বা লোড হয় না।

আপনি যদি এই ধরনের আচরণ দেখতে পান, তার মানে আপনার অ্যাপের কার্ডে কোনো ত্রুটি আছে।

তথ্যসূত্র: একটি কার্যকর, ত্রুটিমুক্ত কার্ড বার্তা এবং ডায়ালগ

ত্রুটিপূর্ণ কার্ডের উদাহরণগুলো পরীক্ষা করার আগে, প্রথমে এই কার্যকর কার্ডের বার্তা এবং সংলাপটি বিবেচনা করুন। প্রতিটি উদাহরণ ত্রুটি এবং তার সমাধান ব্যাখ্যা করার জন্য, এই কার্ডের JSON-এ ত্রুটি যোগ করে পরিবর্তন করা হয়েছে।

একটি ত্রুটিমুক্ত কার্ড বার্তা

এখানে যোগাযোগের তথ্য সম্বলিত একটি কার্যকর ও ত্রুটিমুক্ত কার্ড বার্তা দেওয়া হলো, যেটিতে একটি হেডার, বিভিন্ন সেকশন এবং সজ্জিত টেক্সট ও বাটনের মতো উইজেট রয়েছে:

একটি ত্রুটিমুক্ত সংলাপ

এখানে একটি কার্যকর, ত্রুটিমুক্ত ডায়ালগ বক্স দেওয়া হলো, যা ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ করে একটি কন্টাক্ট তৈরি করে। এতে একটি ফুটার এবং টেক্সট ইনপুট, সুইচ ও বাটনের মতো সম্পাদনাযোগ্য উইজেট রয়েছে।

ত্রুটি: কার্ডের একটি অংশ দেখা যাচ্ছে না।

মাঝে মাঝে কার্ডগুলো লোড হয়, কিন্তু কার্ডের যে অংশটি আপনি দেখতে আশা করেছিলেন তা দেখা যায় না; এর সম্ভাব্য কারণগুলো হলো:

• একটি প্রয়োজনীয় JSON ফিল্ড অনুপস্থিত।
• JSON ফিল্ডে বানান ভুল অথবা বড় হাতের অক্ষর ভুলভাবে ব্যবহার করা হয়েছে।

কারণ: একটি প্রয়োজনীয় JSON ফিল্ড অনুপস্থিত

In this example error, a required JSON field, title , is missing. As a result, the card renders, but parts of the card that are expected to appear don't. It can be difficult to predict how cards render when required fields are omitted.

এই ত্রুটিটি সমাধান করতে, প্রয়োজনীয় JSON ফিল্ডটি যোগ করুন; এই উদাহরণে, title ।

কোনো JSON ফিল্ড আবশ্যক কিনা তা জানতে, Cards v2 রেফারেন্স ডকুমেন্টেশন দেখুন। এই উদাহরণে, CardHeader এর title ফিল্ডের বিবরণটি দেখুন।

এখানে দুটি উদাহরণ দেওয়া হলো:

উদাহরণ ১: subtitle উল্লেখ করে প্রয়োজনীয় title বাদ দিলে পুরো হেডারটি খালি দেখায়:

    . . .
    "header": {

            "subtitle": "Software Engineer"
          }
    . . .
    

    . . .
    "header": {
            "title": "Sasha",
            "subtitle": "Software Engineer"
          }
    . . .
    

উদাহরণ ২: subtitle , imageUrl , imageType , এবং imageAltText উল্লেখ করার পরেও প্রয়োজনীয় title বাদ দিলে ছবিটি প্রত্যাশিতভাবে রেন্ডার হয়, কিন্তু সাবটাইটেলটি হয় না:

    . . .
    "header": {

            "subtitle": "Software Engineer",
            "imageUrl":
            "https://developers.google.com/chat/images/quickstart-app-avatar.png",
            "imageType": "CIRCLE",
            "imageAltText": "Avatar for Sasha",
          }
    . . .
    

    . . .
    "header": {
            "title": "Sasha",
            "subtitle": "Software Engineer",
            "imageUrl":
            "https://developers.google.com/chat/images/quickstart-app-avatar.png",
            "imageType": "CIRCLE",
            "imageAltText": "Avatar for Sasha",
          }
    . . .
    

কারণ: ভুল বানান বা বড় হাতের অক্ষরে লেখা JSON

In this example error, the card JSON includes all the requisite fields, but one field, imageUrl is capitalized incorrectly as imageURL (capital R capital L ), which causes an error: the image it points to doesn't render.

এই ত্রুটি এবং এর মতো অন্যান্য ত্রুটি সমাধান করতে, সঠিক JSON ফরম্যাটিং ব্যবহার করুন। এক্ষেত্রে, imageUrl সঠিক আছে। সন্দেহ হলে, কার্ড রেফারেন্স ডকুমেন্টের সাথে কার্ড JSON মিলিয়ে দেখুন।

    . . .
    "header": {
      "title": "Sasha",
      "subtitle": "Software Engineer",
      "imageURL":
      "https://developers.google.com/chat/images/quickstart-app-avatar.png",
      "imageType": "CIRCLE",
      "imageAltText": "Avatar for Sasha",
    }
    . . .
    

    . . .
    "header": {
            "title": "Sasha",
            "subtitle": "Software Engineer",
            "imageUrl":
            "https://developers.google.com/chat/images/quickstart-app-avatar.png",
            "imageType": "CIRCLE",
            "imageAltText": "Avatar for Sasha",
          }
    . . .
    

ত্রুটি: সম্পূর্ণ কার্ডটি দেখা যাচ্ছে না।

কখনও কখনও কার্ডটিই দেখা যায় না; এর সম্ভাব্য কারণগুলো হলো:

• একটি ButtonList উইজেট ভুলভাবে নির্দিষ্ট করা হয়েছে।
• একটি CardFixedFooter উইজেটে একটি বাটন ভুলভাবে নির্দিষ্ট করা হয়েছে।

কারণ: buttonList বা cardFixedFooter ভুলভাবে নির্দিষ্ট করা হয়েছে

যদি কোনো কার্ড মেসেজ বা ডায়ালগে ভুলভাবে নির্দিষ্ট করা ButtonList উইজেট অথবা ভুলভাবে নির্দিষ্ট করা বাটনসহ CardFixedFooter উইজেট অন্তর্ভুক্ত থাকে, তাহলে পুরো কার্ডটি প্রদর্শিত হয় না এবং এর জায়গায় কিছুই দেখা যায় না। ভুল স্পেসিফিকেশনের মধ্যে থাকতে পারে ফিল্ডের অনুপস্থিতি, ভুল বানান বা বড় হাতের অক্ষরে লেখা ফিল্ড, অথবা ত্রুটিপূর্ণভাবে গঠিত JSON, যেমন কমা, কোটেশন চিহ্ন বা কার্লি ব্রেসের অনুপস্থিতি।

এই ত্রুটিটি সমাধান করতে, কার্ড রেফারেন্স ডকুমেন্টের সাথে কার্ড JSON মিলিয়ে দেখুন। বিশেষ করে, যেকোনো ButtonList উইজেটকে ButtonList উইজেট গাইডের সাথে তুলনা করুন।

উদাহরণস্বরূপ, একটি ButtonList উইজেটের নির্দেশিকায় , প্রথম বাটনে একটি অসম্পূর্ণ onClick অ্যাকশন পাস করলে পুরো কার্ডটি রেন্ডার হওয়া থেকে বিরত থাকে।

    . . .
    {
      "buttonList": {
        "buttons": [
          {
            "text": "Share",
            "onClick": {


              }
            }
          },
          {
            "text": "Edit",
            "onClick": {
              "action": {
                "function": "goToView",
                "parameters": [
                  {
                    "key": "viewType",
                    "value": "EDIT",
                  }
                ],
              }
            }
          },
        ],
      },
    }
    . . .
    

    . . .
    {
      "buttonList": {
        "buttons": [
          {
            "text": "Share",
            "onClick": {
              "openLink": {
                "url": "https://example.com/share",
              }
            }
          },
          {
            "text": "Edit",
            "onClick": {
              "action": {
                "function": "goToView",
                "parameters": [
                  {
                    "key": "viewType",
                    "value": "EDIT",
                  }
                ],
              }
            }
          },
        ],
      },
    }
    . . .
    

ত্রুটি: একটি ডায়ালগ বন্ধ হয়ে যায়, আটকে যায়, বা খোলে না।

যদি কোনো ডায়ালগ অপ্রত্যাশিতভাবে বন্ধ হয়ে যায়, লোড হতে ব্যর্থ হয়, বা খুলতে না পারে, তাহলে এর সম্ভাব্য কারণ হলো এর কার্ড ইন্টারফেসে কোনো সমস্যা।

এগুলোই সবচেয়ে সাধারণ কারণ:

• CardFixedFooter উইজেটটির কোনো primaryButton নেই।
• CardFixedFooter উইজেটের কোনো বাটনে onClick অ্যাকশন নেই, অথবা এর onClick অ্যাকশনটি ভুলভাবে নির্দিষ্ট করা হয়েছে।
• একটি TextInput উইজেটে name ফিল্ডটি নেই।

কারণ: CardFixedFooter কোনো primaryButton নেই

In dialogs with a CardFixedFooter widget , specifying a primaryButton with both text and color is required. Omitting the primaryButton or setting it incorrectly prevents the entire dialog from appearing.

এই ত্রুটিটি সমাধান করতে, নিশ্চিত করুন যে CardFixedFooter উইজেটটিতে একটি সঠিকভাবে নির্দিষ্ট করা primaryButton অন্তর্ভুক্ত রয়েছে।

    . . .
    "fixedFooter": {

        "onClick": {
          . . .
      },
      "secondaryButton": {
        . . .
        }
      }
    }
    . . .
    

    . . .
    "fixedFooter": {
      "primaryButton": {
        "text": "Submit",
        "color": {
          "red": 0,
          "blue": 1,
          "green": 0
        },
        "onClick": {
          . . .
      },
      "secondaryButton": {
        . . .
        }
      }
    }
    . . .
    

কারণ: FixedFooter এ onClick সেটিং ভুল

CardFixedFooter উইজেটযুক্ত ডায়ালগ বক্সে , যেকোনো বাটনের onClick সেটিং ভুলভাবে উল্লেখ করলে বা তা বাদ দিলে ডায়ালগ বক্সটি বন্ধ হয়ে যায়, লোড হতে ব্যর্থ হয় বা খোলে না।

এই ত্রুটিটি সমাধান করতে, নিশ্চিত করুন যে প্রতিটি বাটনে একটি সঠিকভাবে নির্দিষ্ট করা onClick সেটিং অন্তর্ভুক্ত রয়েছে।

    . . .
    "fixedFooter": {
      "primaryButton": {
        "text": "Submit",
        "color": {
          "red": 0,
          "blue": 1,
          "green": 0
        },
        "onClick": {
          "action": {
            "function": "setLanguageType",
            "parrammetters": [
              {
                "key": "languageType",
                "value": "C++"
              }
            ]
          }
        }
      },
      "secondaryButton": {
        "text": "Cancel",
        "onClick": {
          "action": {
            "function": "reset"
          }
        }
      }
    }
    . . .
    

    . . .
    "fixedFooter": {
      "primaryButton": {
        "text": "Submit",
        "color": {
          "red": 0,
          "blue": 1,
          "green": 0
        },
        "onClick": {
          "action": {
            "function": "setLanguageType",
            "parameters": [
              {
                "key": "languageType",
                "value": "C++"
              }
            ]
          }
        }
      },
      "secondaryButton": {
        "text": "Cancel",
        "onClick": {
          "action": {
            "function": "reset"
          }
        }
      }
    }
    . . .
    

কারণ: TextInput কোনো name নেই

যদি কোনো ডায়ালগে এমন একটি TextInput উইজেট থাকে যেখানে name ফিল্ডটি নেই, তাহলে ডায়ালগটি প্রত্যাশিতভাবে কাজ করে না। এটি বন্ধ হয়ে যেতে পারে, খুলতে গিয়ে লোড হতে ব্যর্থ হতে পারে, অথবা একেবারেই নাও খুলতে পারে।

এই ত্রুটিটি সমাধান করতে, নিশ্চিত করুন যে প্রতিটি TextInput উইজেটে একটি উপযুক্ত name ফিল্ড অন্তর্ভুক্ত আছে। কার্ডের প্রতিটি name ফিল্ড যেন অনন্য হয়, সেটাও নিশ্চিত করুন।

    . . .
    {
      "textInput": {
        "label": "Name",
        "type": "SINGLE_LINE",

      }
    }
    . . .
    

    . . .
    {
      "textInput": {
        "label": "Name",
        "type": "SINGLE_LINE",
        "name": "contactName"
      }
    }
    . . .
    

অ্যাসিঙ্ক্রোনাস অ্যাপ আর্কিটেকচারের কারণে ডায়ালগ খোলা, জমা দেওয়া বা বাতিল করার মতো কাজগুলো ব্যর্থ হয়।

If your Chat app returns the error message Could not load dialog. Invalid response returned by bot. while working with dialogs , it might be because your app uses an asynchronous architecture , like Cloud Pub/Sub or the Create Message API method.

Opening, submitting, or canceling a dialog requires a synchronous response from a Chat app with a DialogEventType . Accordingly, dialogs aren't supported by apps built with an asynchronous architecture .

একটি বিকল্প সমাধান হিসেবে, ডায়ালগের পরিবর্তে কার্ড মেসেজ ব্যবহার করার কথা বিবেচনা করতে পারেন।

অন্যান্য কার্ড এবং ডায়ালগ ত্রুটি

If the fixes described on this page don't resolve the card-related error your app experiences, query the app's error logs . Querying the logs can help find errors in card JSON or app code, and the logs include descriptive error messages to help you fix them.

সম্পর্কিত বিষয়

Google Chat অ্যাপের ত্রুটি সমাধানে সাহায্যের জন্য, Google Chat অ্যাপের সমস্যা সমাধান ও সমাধান এবং Chat অ্যাপ ডিবাগ করুন দেখুন।