ত্রুটি এবং সতর্কতা

ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ এপিআই বিভিন্ন ধরনের ত্রুটি এবং সতর্কবার্তা দেখাতে পারে। একটি নির্ভরযোগ্য এপিআই সলিউশনকে অবশ্যই এই ত্রুটিগুলো সামাল দিতে হবে।

এপিআই ত্রুটি

এপিআই-তে করা অনুরোধগুলো উদ্দিষ্ট কাজটি করতে ব্যর্থ হলে একটি ত্রুটি ফেরত দেয়। ত্রুটিপূর্ণ প্রতিক্রিয়াগুলো শনাক্ত করে সেগুলোর সমাধান করা উচিত।

একটি API ত্রুটি প্রতিক্রিয়ায় একটি HTTP প্রতিক্রিয়া কোড, একটি ত্রুটি বার্তা এবং একটি Google RPC কোড স্ট্যাটাস থাকে। এর বিন্যাসটি নিম্নরূপ:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

নিম্নলিখিতটি হলো কিছু সাধারণ API ত্রুটি এবং প্রস্তাবিত পদক্ষেপের তালিকা:

ত্রুটি কোড
400 INVALID_ARGUMENT
আপনার অনুরোধে একটি সমস্যা আছে। ত্রুটি বার্তার বার্তা ক্ষেত্রটি পর্যালোচনা করুন এবং সেই অনুযায়ী আপনার অনুরোধটি হালনাগাদ করুন।
401 UNAUTHENTICATED
আপনার অনুরোধটি সঠিকভাবে প্রমাণীকৃত করা যায়নি। অনুগ্রহ করে যাচাই করুন যে আপনি আপনার অনুরোধে বৈধ OAuth ক্রেডেনশিয়াল অন্তর্ভুক্ত করছেন। আরও তথ্যের জন্য, আমাদের কুইকস্টার্ট গাইডটি দেখুন।
403 PERMISSION_DENIED
অনুরোধটি সম্পন্ন করার জন্য আপনার প্রয়োজনীয় অনুমতি নেই। যাচাই করুন যে আপনার ব্যবহারকারী অ্যাকাউন্টের সংশ্লিষ্ট অংশীদার বা বিজ্ঞাপনদাতার জন্য যথাযথ অনুমতি রয়েছে।
404 NOT_FOUND
আপনি যে রিসোর্সটি পুনরুদ্ধার করার চেষ্টা করছেন তা খুঁজে পাওয়া যাচ্ছে না। আপনি যে আইডিটি ব্যবহার করছেন তা সঠিক কিনা এবং এটি পুনরুদ্ধার করা রিসোর্স টাইপের সাথে সামঞ্জস্যপূর্ণ কিনা তা যাচাই করুন।
409 ABORTED
আপনি যে রিসোর্সটি পরিবর্তন করার চেষ্টা করছেন, সেটি অন্য কোথাও পরিবর্তন করা হচ্ছে। কয়েক সেকেন্ড অপেক্ষা করুন এবং তারপর অনুরোধটি পুনরায় চেষ্টা করুন।
429 RESOURCE_EXHAUSTED
আপনি আপনার রেট লিমিট বা দৈনিক অনুরোধ কোটা অতিক্রম করেছেন। আপনার এপিআই (API) ব্যবহার পরীক্ষা করতে গুগল ক্লাউড কনসোল ব্যবহার করুন। বিদ্যমান কোটার সীমার মধ্যে কাজ করার জন্য আপনার ওয়ার্কফ্লো আপডেট করুন। আরও তথ্যের জন্য, ইউসেজ অপটিমাইজেশন (Usage Optimization ) বিষয়ে আমাদের নির্দেশিকা দেখুন।
500 INTERNAL
এপিআই-তে একটি অভ্যন্তরীণ ত্রুটি ঘটেছে। কয়েক সেকেন্ড অপেক্ষা করুন এবং তারপর অনুরোধটি পুনরায় চেষ্টা করুন। ত্রুটি অব্যাহত থাকলে, সাপোর্টে যোগাযোগ করুন ।
504 DEADLINE_EXCEEDED
এপিআই অনুরোধটি সম্পন্ন করতে অনেক বেশি সময় নিয়েছে। কয়েক সেকেন্ড অপেক্ষা করুন এবং তারপর অনুরোধটি পুনরায় চেষ্টা করুন। যদি ত্রুটিটি অব্যাহত থাকে, তাহলে সাপোর্টে যোগাযোগ করুন ।

SDF ত্রুটি

ডিসপ্লে ও ভিডিও ৩৬০ এপিআই স্ট্রাকচার্ড ডেটা ফাইল (এসডিএফ) তৈরি করতে দীর্ঘ সময় ধরে চলা টাস্ক ব্যবহার করে। এসডিএফ তৈরিতে কোনো ত্রুটি হলে, তা সমাপ্ত operation ফেরত পাঠানো হয়। error ফিল্ডে বিস্তারিত তথ্য থাকবে। এই সংক্ষিপ্ত উদাহরণটি দেখুন:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

যদি ত্রুটির বার্তাটি স্পষ্ট না হয়, তবে আমরা নিম্নলিখিত বিষয়গুলো অনুসরণ করার পরামর্শ দিই:

  • যাচাই করুন যে আপনার ব্যবহারকারীর মূল অংশীদার বা বিজ্ঞাপনদাতার জন্য অন্তত একটি স্ট্যান্ডার্ড ব্যবহারকারী ভূমিকা (Standard user role) আছে।
  • ফিল্টারে প্রদত্ত আইডিগুলো সঠিক কিনা তা নিশ্চিত করুন। আইডিগুলো অবশ্যই উদ্দিষ্ট রিসোর্স টাইপের সাথে সঙ্গতিপূর্ণ হতে হবে এবং রুট আইডির চাইল্ড রিসোর্স হতে হবে।
  • নিশ্চিত করুন যে আপনার ব্যবহারকারীর একই সাথে বিশটির কম SDF ডাউনলোড টাস্ক রয়েছে।

এরপরও ত্রুটি দেখতে পেলে, সাপোর্টে যোগাযোগ করুন ।

নন-ব্লকিং সতর্কতা

নন-ব্লকিং সতর্কতাগুলো এমন একটি সমস্যা নির্দেশ করে যা কোনো লাইন আইটেমের বিজ্ঞাপন পরিবেশনকে প্রভাবিত করতে পারে। UI-তেও অনুরূপ সতর্কতা দেখা যায়। এই সতর্কতাগুলো নিষ্ক্রিয় এবং লাইন আইটেমেই তালিকাভুক্ত থাকে।

একটি সতর্কবার্তার মূল কারণ কোনো একটি লাইন আইটেম পরিবেশনকে প্রভাবিত করতে পারে। কিছু ক্ষেত্রে এটি বিজ্ঞাপন পরিবেশন সম্পূর্ণরূপে বন্ধ করে দিতে পারে।

প্রতিরোধ

কিছু নন-ব্লকিং সতর্কতা কোনো লাইন আইটেমের ভুল কনফিগারেশনের কারণে ঘটে থাকে:

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

একটি নতুন লাইন আইটেমে কোনো কনফিগারেশন ব্যবহার করার আগে নিশ্চিত হয়ে নিন যে বিদ্যমান কোনো লাইন আইটেম কোনো সতর্কবার্তা তৈরি করছে না।

পর্যবেক্ষণ

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

সেটিংস বা টার্গেটিং পরিবর্তন না হলেও সতর্কবার্তা যোগ করা যেতে পারে। এর উদাহরণগুলো হলো:

  • সন্নিবেশ ক্রমটি স্থগিত বা মেয়াদোত্তীর্ণ হয়েছে।
  • ব্যবহারকারী তালিকা বা টার্গেটিং বিকল্পটি অপ্রচলিত।