API ত্রুটিগুলি পরিচালনা করুন৷

যখন আপনি Google Ads API-তে একটি অনুরোধ পাঠান, তখন এটি বিভিন্ন কারণে ব্যর্থ হতে পারে। উদাহরণস্বরূপ, আপনি একটি অবৈধ যুক্তি প্রদান করতে পারেন, অথবা আপনার অ্যাকাউন্ট নতুন প্রচারাভিযান তৈরির সীমাতে পৌঁছে যেতে পারে। এই ধরনের ক্ষেত্রে, API একটি ত্রুটি ফেরত দেয় যাতে আপনাকে জানাতে পারে যে কী ভুল হয়েছে।

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে API ত্রুটিগুলি পড়তে হয় এবং পরিচালনা করতে হয় যাতে আপনি আরও শক্তিশালী অ্যাপ্লিকেশন তৈরি করতে পারেন।

ত্রুটি কাঠামো

আপনি যদি আমাদের ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে API ত্রুটিগুলি ব্যতিক্রম হিসেবে দেখা হবে। এই ব্যতিক্রমগুলিতে এমন বিশদ বিবরণ রয়েছে যা আপনাকে বুঝতে সাহায্য করবে যে ত্রুটিটি কেন ঘটেছে।

Google Ads API একটি স্ট্যান্ডার্ড ফর্ম্যাটে ত্রুটির তথ্য প্রদান করে। যদি কোনও ত্রুটি দেখা দেয়, তাহলে প্রতিক্রিয়ায় একটি GoogleAdsFailure অবজেক্ট থাকবে। এই অবজেক্টে পৃথক GoogleAdsError অবজেক্টের একটি তালিকা রয়েছে, প্রতিটিতে একটি নির্দিষ্ট ত্রুটির বিবরণ রয়েছে।

প্রতিটি GoogleAdsError অবজেক্টে নিম্নলিখিতগুলি থাকে:

• error_code : একটি নির্দিষ্ট ত্রুটি কোড যা আপনাকে ত্রুটির ধরণ বলে, যেমন AuthenticationError.NOT_ADS_USER ।
• message : ত্রুটিটি কেন ঘটেছে তার একটি মানুষের পাঠযোগ্য বর্ণনা।
• trigger : যে মানটি ত্রুটির কারণ হয়েছে, যেমন "১২৩৪"।
• location : অনুরোধের কোন অংশে ত্রুটি ঘটেছে তার বিশদ বিবরণ, যেমন একটি নির্দিষ্ট ক্ষেত্রের নাম।

ত্রুটির তালিকা ছাড়াও, GoogleAdsFailure একটি requestId থাকে, যা ত্রুটির ফলে তৈরি হওয়া API অনুরোধের জন্য একটি অনন্য শনাক্তকারী।

উদাহরণ ত্রুটি

JSON ফর্ম্যাটে একটি ত্রুটি কেমন দেখায় তার একটি উদাহরণ এখানে দেওয়া হল। এই ত্রুটিটি নির্দেশ করে যে অনুরোধে 0 নম্বর সূচকে ad_group এর name ক্ষেত্রটি অনুপস্থিত।

{
  "code": 3,
  "message": "Request contains an invalid argument.",
  "details": [
    {
      "@type": "type.googleapis.com/google.ads.googleads.v22.errors.GoogleAdsFailure",
      "errors": [
        {
          "errorCode": {
            "requestError": "REQUIRED_FIELD_MISSING"
          },
          "message": "Required field is missing",
          "location": {
            "fieldPathElements": [
              {
                "fieldName": "ad_group",
                "index": 0
              },
              {
                "fieldName": "name"
              }
            ]
          }
        }
      ],
      "requestId": "unique_request_id_12345"
    }
  ]
}

ত্রুটিগুলি কীভাবে পরিচালনা করবেন

যদি আপনি কোনও ত্রুটির সম্মুখীন হন, তাহলে এখানে পদক্ষেপগুলি নেওয়া হল:

1. errors তালিকা পরীক্ষা করুন : GoogleAdsFailure অবজেক্টের প্রতিটি GoogleAdsError দেখুন। error_code এবং message আপনাকে বলবে কী ভুল হয়েছে।
2. location পরীক্ষা করুন : location ক্ষেত্রটি আপনার অনুরোধে কোথায় সমস্যাটি ঘটেছে তা চিহ্নিত করতে সাহায্য করতে পারে।
3. ডকুমেন্টেশন দেখুন : নির্দিষ্ট ত্রুটি কোডের জন্য, ত্রুটি এবং এটি কীভাবে ঠিক করবেন সে সম্পর্কে আরও বিস্তারিত জানার জন্য সাধারণ ত্রুটি পৃষ্ঠা অথবা সম্পূর্ণ ত্রুটি কোড রেফারেন্সটি দেখুন।
4. আপনার অনুরোধটি সামঞ্জস্য করুন : ত্রুটি বার্তার উপর ভিত্তি করে, আপনার API অনুরোধটি সংশোধন করুন। উদাহরণস্বরূপ, যদি আপনি REQUIRED_FIELD_MISSING দেখতে পান, তাহলে নিশ্চিত করুন যে আপনি আপনার অনুরোধে সেই ক্ষেত্রটি দিয়েছেন।
5. request_id লগ করুন : যদি আপনি কোনও ত্রুটি কীভাবে সমাধান করবেন তা বুঝতে না পারেন এবং ফোরামের মাধ্যমে সহায়তার সাথে যোগাযোগ করতে চান, তাহলে request_id অন্তর্ভুক্ত করুন। এই আইডিটি Google ইঞ্জিনিয়ারদের আপনার সমস্যা তদন্ত করতে সাহায্য করে।

পরবর্তী পদক্ষেপ

• ঘন ঘন সমস্যা এবং তাদের সমাধানের তালিকার জন্য সাধারণ ত্রুটিগুলি পর্যালোচনা করুন।
• আরও উন্নত ত্রুটি পরিচালনার কৌশলগুলির জন্য, যার মধ্যে রয়েছে পুনঃপ্রয়াস লজিক এবং আংশিক ব্যর্থতা, API ত্রুটিগুলি বুঝুন দেখুন।