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

এই পৃষ্ঠাটি Display & Video 360 API ব্যবহার করার সময় বিভিন্ন ধরনের ত্রুটি এবং সতর্কতা নিয়ে আলোচনা করে যা আপনি সম্মুখীন হতে পারেন।

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	আপনি আপনার হারের সীমা বা দৈনিক অনুরোধের কোটা অতিক্রম করেছেন৷ Google API কনসোল ব্যবহার করে আপনার API ব্যবহার পরীক্ষা করুন এবং বিদ্যমান কোটা সীমার মধ্যে কাজ করার জন্য আপনার কর্মপ্রবাহ পরিবর্তন করুন। আরও তথ্যের জন্য, অনুগ্রহ করে কোটা অপ্টিমাইজেশানে আমাদের পৃষ্ঠাটি দেখুন। যদি আপনার প্রদত্ত দৈনিক কোটার মধ্যে আপনার অপারেশনগুলি সম্পন্ন করা না যায়, আপনি অতিরিক্ত কোটার জন্য অনুরোধ করতে পারেন।
500	INTERNAL	API একটি অভ্যন্তরীণ ত্রুটির সম্মুখীন হয়েছে৷ কয়েক সেকেন্ড অপেক্ষা করুন এবং তারপর অনুরোধটি পুনরায় চেষ্টা করুন। ত্রুটি অব্যাহত থাকলে, সহায়তার সাথে যোগাযোগ করুন ।
504	DEADLINE_EXCEEDED	এপিআই অনুরোধটি সম্পূর্ণ করতে অনেক সময় নিয়েছে। কয়েক সেকেন্ড অপেক্ষা করুন এবং তারপর অনুরোধটি পুনরায় চেষ্টা করুন। ত্রুটি অব্যাহত থাকলে, সহায়তার সাথে যোগাযোগ করুন ।

SDF ত্রুটি

Display & Video 360 API স্ট্রাকচার্ড ডেটা ফাইল (SDFs) তৈরি এবং ডাউনলোড করার জন্য একটি অ্যাসিঙ্ক্রোনাস পদ্ধতি ব্যবহার করে। এই কারণে, SDF জেনারেশনের সময় নিক্ষিপ্ত ত্রুটিগুলি সমাপ্ত SDF ডাউনলোড টাস্কে ফেরত দেওয়া হয়৷ একটি SDF ডাউনলোড টাস্ক error করে শেষ করা হয়েছে বলে চিহ্নিত করা হয়েছে, কিন্তু response ক্ষেত্রে মিডিয়া রিসোর্সের নামের পরিবর্তে একটি জনবহুল ত্রুটি ক্ষেত্র রয়েছে, যেমনটি এই ছেঁটে দেওয়া উদাহরণে দেখা গেছে:

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

SDF তৈরি করার চেষ্টা করার সময় আপনি যদি একটি অ্যাকশনযোগ্য ত্রুটির বার্তা পান, তাহলে আপনাকে সেই অনুযায়ী অনুসরণ করা উচিত। যদি ত্রুটি বার্তাটি স্পষ্টভাবে কার্যকর না হয় তবে আমরা নিম্নলিখিত পদক্ষেপগুলির সুপারিশ করি:

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

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

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

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

প্যাসিভ হলেও, এই সতর্কতাগুলি সৃষ্টিকারী সমস্যাগুলি একটি লাইন আইটেমের পরিবেশনকে সম্পূর্ণরূপে প্রতিরোধ করার বিন্দুতে প্রভাবিত করতে পারে।

প্রতিরোধ

অনেক সমস্যা যা অ-ব্লকিং সতর্কতা সৃষ্টি করে তা নিম্নলিখিতগুলি সহ লাইন আইটেম সেটিংসের সঠিক কনফিগারেশনের মাধ্যমে এড়ানো যেতে পারে:

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

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

মনিটরিং

একটি লাইন আইটেম ফ্লাইটে থাকাকালীন যে সমস্যাগুলি অ-ব্লকিং সতর্কতার কারণ হতে পারে। আপনার লাইন আইটেমগুলি সঠিকভাবে পরিবেশন করছে তা নিশ্চিত করার জন্য, নতুন-উত্পন্ন সতর্কতার জন্য আপনার সক্রিয় লাইন আইটেমগুলি নিরীক্ষণ করুন৷ advertisers.lineItems.list ফাংশন ব্যবহার করে লাইন আইটেমগুলি বাল্কে পুনরুদ্ধার করা যেতে পারে। যদি একটি লাইন আইটেম একটি অপ্রত্যাশিত সতর্কতা তৈরি করে, তাহলে পরিবেশনের প্রভাব কমাতে আপনার অবিলম্বে সমস্যাটির সমাধান করা উচিত।

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