সাধারণ ত্রুটি

এই নির্দেশিকায় সাধারণ API ত্রুটিগুলির একটি তালিকা দেওয়া হয়েছে এবং সেগুলি প্রতিরোধ ও সমাধানের কৌশল তুলে ধরা হয়েছে।

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

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT
সারসংক্ষেপ OAuth 2.0 অ্যাক্সেস টোকেনটিতে প্রয়োজনীয় স্কোপগুলো নেই।
সাধারণ কারণগুলি অনুরোধটি প্রত্যাখ্যান করা হয়েছে কারণ প্রদত্ত অ্যাক্সেস টোকেনটিতে গুগল অ্যাডস এপিআই ওঅথ ২.০ স্কোপ অন্তর্ভুক্ত নেই।
কীভাবে সামলাতে হবে নিশ্চিত করুন যে অ্যাক্সেস টোকেনটিতে প্রয়োজনীয় স্কোপগুলো রয়েছে। এই ত্রুটির একটি সাধারণ কারণ হলো, আপনি এমন একটি বিদ্যমান অ্যাক্সেস টোকেন পুনরায় ব্যবহার করছেন যা ভিন্ন OAuth স্কোপ ব্যবহার করে তৈরি করা হয়েছিল। প্রয়োজনীয় স্কোপসহ একটি নতুন অ্যাক্সেস টোকেন কীভাবে তৈরি করতে হয় তার উদাহরণের জন্য OAuth অথরাইজেশন প্যারামিটারগুলো দেখুন।
প্রতিরোধের পরামর্শ নিশ্চিত করুন যে অ্যাক্সেস টোকেনটিতে প্রয়োজনীয় স্কোপগুলো রয়েছে। প্রয়োজনীয় স্কোপসহ অ্যাক্সেস পেতে আপনার ব্যবহারকারীকে প্রয়োজনীয় স্কোপ দিয়ে পুনরায় প্রমাণীকরণ করুন। যদি আপনার অ্যাপ্লিকেশন একাধিক OAuth স্কোপ ব্যবহার করে, তাহলে আপনাকে গ্র্যানুলার OAuth পারমিশন প্রয়োগ করতে হতে পারে।

google.auth.exceptions.RefreshError

invalid_grant
সারসংক্ষেপ টোকেনটির মেয়াদ শেষ হয়ে গেছে বা এটি বাতিল করা হয়েছে।
সাধারণ কারণগুলি একটি গুগল ক্লাউড প্ল্যাটফর্ম প্রজেক্ট, যেখানে বহিরাগত ব্যবহারকারীর জন্য একটি OAuth সম্মতি স্ক্রিন কনফিগার করা আছে এবং পাবলিশিং স্ট্যাটাস ' Testing রয়েছে, তাকে একটি রিফ্রেশ টোকেন ইস্যু করা হয় যা ৭ দিন পর মেয়াদোত্তীর্ণ হবে।
কীভাবে সামলাতে হবে আপনার গুগল প্রজেক্টের পাবলিশিং স্ট্যাটাস ' Testing ' হওয়ায় প্রতি ৭ দিন পর রিফ্রেশ টোকেনের মেয়াদ শেষ হয়ে যায় এবং একটি invalid_grant ' এরর আসে। গুগল এপিআই কনসোলে যান এবং OAuth কনসেন্ট স্ক্রিনে নেভিগেট করুন। এরপর, ৭ দিনের মধ্যে রিফ্রেশ টোকেনের মেয়াদ শেষ হওয়া এড়াতে পাবলিশিং স্ট্যাটাস পরিবর্তন করে ' In production করুন।
প্রতিরোধের পরামর্শ যাচাইবিহীন অ্যাপগুলো দেখুন।

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
সারসংক্ষেপ ক্লায়েন্ট গ্রাহক আইডি কোনো সংখ্যা নয়।
সাধারণ কারণগুলি অনুপযুক্ত ক্লায়েন্ট কাস্টমার আইডি ব্যবহার করা।
কীভাবে সামলাতে হবে প্রযোজ্য নয়
প্রতিরোধের পরামর্শ 123-456-7890 নম্বরটি 1234567890 হবে। বিস্তারিত জানতে 'Get started' দেখুন।
CLIENT_CUSTOMER_ID_IS_REQUIRED
সারসংক্ষেপ HTTP হেডারে ক্লায়েন্ট কাস্টমার আইডি উল্লেখ করা হয়নি।
সাধারণ কারণগুলি HTTP হেডারে ক্লায়েন্ট কাস্টমার আইডি উল্লেখ না করা।
কীভাবে সামলাতে হবে প্রযোজ্য নয়
প্রতিরোধের পরামর্শ সমস্ত কলের জন্য ক্লায়েন্ট কাস্টমার আইডি প্রয়োজন, তাই নিশ্চিত করুন যে আপনি HTTP হেডারে এটি উল্লেখ করেছেন। আমাদের ক্লায়েন্ট লাইব্রেরিগুলো ব্যবহার করার কথা বিবেচনা করতে পারেন, কারণ সেগুলো আপনার জন্য এই কাজটি করে দেয়।
CUSTOMER_NOT_FOUND
সারসংক্ষেপ হেডারে প্রদত্ত গ্রাহক আইডির জন্য কোনো অ্যাকাউন্ট খুঁজে পাওয়া যায়নি।
সাধারণ কারণগুলি ব্যাকএন্ডে অ্যাকাউন্টটি প্রতিষ্ঠিত হওয়ার আগেই সদ্য তৈরি করা একটি অ্যাকাউন্ট অ্যাক্সেস করার চেষ্টা করা হচ্ছে।
কীভাবে সামলাতে হবে প্রথমে পাঁচ মিনিট অপেক্ষা করুন, তারপর প্রতি ৩০ সেকেন্ড পর পর পুনরায় চেষ্টা করুন।
প্রতিরোধের পরামর্শ অ্যাকাউন্ট তৈরি হওয়ার পর সেটির বিরুদ্ধে অনুরোধ পাঠানোর আগে কয়েক মিনিট অপেক্ষা করুন।
সারসংক্ষেপ অনুরোধ হেডারে থাকা অ্যাক্সেস টোকেনটি হয় অবৈধ অথবা এর মেয়াদ শেষ হয়ে গেছে।
সাধারণ কারণগুলি অ্যাক্সেস টোকেনটি বাতিল করা হয়েছে।
কীভাবে সামলাতে হবে একটি নতুন টোকেনের জন্য অনুরোধ করুন । আপনি যদি আমাদের কোনো ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে টোকেনটি কীভাবে রিফ্রেশ করতে হয় তা জানতে এর ডকুমেন্টেশন দেখুন।
প্রতিরোধের পরামর্শ অ্যাক্সেস টোকেনগুলোর মেয়াদ শেষ না হওয়া পর্যন্ত সেগুলো সংরক্ষণ করুন এবং পুনরায় ব্যবহার করুন।
NOT_ADS_USER
সারসংক্ষেপ অ্যাক্সেস টোকেন তৈরি করতে ব্যবহৃত গুগল অ্যাকাউন্টটি কোনো গুগল অ্যাডস অ্যাকাউন্টের সাথে যুক্ত নয়।
সাধারণ কারণগুলি প্রদত্ত লগইন তথ্যটি এমন একটি গুগল অ্যাকাউন্টের, যেটিতে গুগল অ্যাডস চালু নেই।
কীভাবে সামলাতে হবে OAuth ফ্লো-এর জন্য একটি বৈধ Google Ads অ্যাকাউন্ট (সাধারণত আপনার ম্যানেজার অ্যাকাউন্ট) দিয়ে সাইন ইন করা নিশ্চিত করুন। এছাড়াও, আপনি আপনার ম্যানেজার অ্যাকাউন্টে সাইন ইন করে, সংশ্লিষ্ট গ্রাহক বা ম্যানেজার অ্যাকাউন্টটি নির্বাচন করে, Tools and Settings > Access and security তে গিয়ে এবং তারপর Google অ্যাকাউন্টের ইমেল ঠিকানাটি যোগ করে একটি বিদ্যমান Google Ads অ্যাকাউন্ট অ্যাক্সেস করার জন্য Google অ্যাকাউন্টটিকে আমন্ত্রণ জানাতে পারেন।
প্রতিরোধের পরামর্শ প্রযোজ্য নয়
OAUTH_TOKEN_INVALID
সারসংক্ষেপ হেডারে থাকা OAuth অ্যাক্সেস টোকেনটি বৈধ নয়।
সাধারণ কারণগুলি HTTP হেডারের সাথে পাঠানো আপনার অ্যাক্সেস টোকেনটি সঠিক ছিল না।
কীভাবে সামলাতে হবে প্রযোজ্য নয়
প্রতিরোধের পরামর্শ নিশ্চিত করুন যে আপনি আপনার অ্যাকাউন্টের সাথে যুক্ত সঠিক অ্যাক্সেস টোকেনটি দিয়েছেন। এটিকে কখনও কখনও রিফ্রেশ টোকেন এবং অথরাইজেশন কোডের সাথে গুলিয়ে ফেলা হয়। আপনি যদি এমন একটি ক্রেডেনশিয়াল পেতে চান যা একটি ম্যানেজার অ্যাকাউন্টের অধীনে থাকা সমস্ত ক্লায়েন্ট অ্যাকাউন্ট অ্যাক্সেস করতে পারে, তাহলে নিশ্চিত করুন যে আপনি ম্যানেজার অ্যাকাউন্টের জন্য রিফ্রেশ টোকেনটি পেয়েছেন। ব্যবহারকারী প্রমাণীকরণ নির্দেশিকাটি দেখুন।

AuthorizationError

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
সারসংক্ষেপ গুগল ক্লাউড প্রজেক্টটিতে শুধুমাত্র টেস্ট অ্যাক্সেস রয়েছে এবং এটি প্রোডাকশন অ্যাকাউন্ট অ্যাক্সেস করার জন্য ব্যবহার করা যাবে না।
সাধারণ কারণগুলি টেস্ট অ্যাক্সেস লেভেলের একটি গুগল ক্লাউড প্রজেক্ট ব্যবহার করে একটি নন-টেস্ট (প্রোডাকশন) গুগল অ্যাডস অ্যাকাউন্টে অনুরোধ পাঠানো হয়েছিল। (এপিআই ভার্সন v24 এবং তার আগের ভার্সনগুলোতে, এই পরিস্থিতিতে AuthorizationError.ACTION_NOT_PERMITTED রিটার্ন করা হয়।)
কীভাবে সামলাতে হবে আপনি যদি পরীক্ষা করে থাকেন, তাহলে নিশ্চিত করুন যে আপনার অনুরোধটি একটি টেস্ট অ্যাকাউন্টকে লক্ষ্য করে করা হয়েছে। আপনি যদি কোনো প্রোডাকশন গুগল অ্যাডস অ্যাকাউন্ট অ্যাক্সেস করতে চান, তাহলে গুগল অ্যাডস এপিআই ওভারভিউ পৃষ্ঠায় আপনার গুগল ক্লাউড প্রজেক্টের অ্যাক্সেস লেভেল পরীক্ষা করুন এবং আপনার প্রজেক্টের অ্যাক্সেস লেভেলকে এক্সপ্লোরার, বেসিক বা স্ট্যান্ডার্ড অ্যাক্সেসে আপগ্রেড করুন ।
প্রতিরোধের পরামর্শ প্রযোজ্য নয়
CUSTOMER_NOT_ENABLED
সারসংক্ষেপ গ্রাহক অ্যাকাউন্টটি সক্রিয় অবস্থায় না থাকায় এটি অ্যাক্সেস করা যাচ্ছে না।
সাধারণ কারণগুলি এটি ঘটে যখন গ্রাহকের অ্যাকাউন্টের নিবন্ধন প্রক্রিয়া সম্পূর্ণ হয়নি অথবা অ্যাকাউন্টটি নিষ্ক্রিয় করা হয়েছে।
কীভাবে সামলাতে হবে Google Ads UI-তে সাইন ইন করুন এবং নিশ্চিত করুন যে আপনি এই অ্যাকাউন্টের জন্য সাইনআপ প্রক্রিয়াটি সম্পূর্ণ করেছেন। নিষ্ক্রিয় করা অ্যাকাউন্টগুলির জন্য, বাতিল করা Google Ads অ্যাকাউন্ট পুনরায় সক্রিয় করুন দেখুন।
প্রতিরোধের পরামর্শ কোনো গ্রাহক অ্যাকাউন্ট নিষ্ক্রিয় করা হয়েছে কিনা, তা আপনি CANCELLED স্ট্যাটাসটি দেখে আগে থেকেই যাচাই করতে পারেন।
USER_PERMISSION_DENIED
সারসংক্ষেপ অনুমোদিত গ্রাহকের পরিচালন গ্রাহকের কাছে প্রবেশাধিকার নেই।
সাধারণ কারণগুলি ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস থাকা একজন ব্যবহারকারী হিসেবে প্রমাণীকরণ করা হচ্ছে, কিন্তু অনুরোধে login-customer-id উল্লেখ করা হয়নি।
কীভাবে সামলাতে হবে প্রযোজ্য নয়
প্রতিরোধের পরামর্শ login-customer-id হিসেবে ম্যানেজার অ্যাকাউন্ট আইডিটি হাইফেন ( - ) ছাড়া উল্লেখ করুন। ক্লায়েন্ট লাইব্রেরিগুলোতে এর জন্য অন্তর্নির্মিত সমর্থন রয়েছে।