যে ভুলগুলি প্রায়ই হয়ে থাকে

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

সব ধরনের সমস্যার একটি বিস্তারিত তালিকা পেতে, Google Ads API সমস্যা রেফারেন্স দেখুন। আপনার আরও সাহায্যের প্রয়োজন হলে, Google Ads API ফোরামে প্রশ্ন করুন।

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

সারাংশ OAuth 2.0 অ্যাক্সেস টোকেনে প্রয়োজনীয় স্কোপ নেই। সাধারণ কারণ অনুরোধটি বাতিল করা হয়েছে কারণ প্রদত্ত অ্যাক্সেস টোকেনে Google Ads API OAuth 2.0 স্কোপ অন্তর্ভুক্ত নেই। কীভাবে সামলাবেন অ্যাক্সেস টোকেনে প্রয়োজনীয় স্কোপ আছে কিনা তা ভালো করে দেখে নিন। এই সমস্যার একটি সাধারণ কারণ হল, আপনি আগে থেকে থাকা এমন অ্যাক্সেস টোকেন আবার ব্যবহার করছেন যা অন্য OAuth স্কোপের সেট ব্যবহার করে তৈরি করা হয়েছে। প্রয়োজনীয় স্কোপ সহ নতুন অ্যাক্সেস টোকেন কীভাবে তৈরি করতে হয় তার উদাহরণ পেতে OAuth যাচাইকরণ প্যারামিটার দেখুন। প্রতিরোধমূলক পরামর্শ অ্যাক্সেস টোকেনে প্রয়োজনীয় স্কোপ আছে কিনা তা নিশ্চিত করুন। প্রয়োজনীয় স্কোপ সহ অ্যাক্সেস পেতে, প্রয়োজনীয় স্কোপ সহ আপনার ব্যবহারকারীকে আবার যাচাই করুন। আপনার অ্যাপ্লিকেশন একাধিক OAuth স্কোপ ব্যবহার করলে, আপনাকে গ্র্যানুলার OAuth অনুমতি প্রয়োগ করতে হতে পারে।

google.auth.exceptions.RefreshError

invalid_grant

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

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	সারাংশ ক্লায়েন্ট কাস্টমার আইডি কোনও সংখ্যা নয়। সাধারণ কারণ ভুল ক্লায়েন্ট কাস্টমার আইডি ব্যবহার করা হচ্ছে। কীভাবে সামলাবেন প্রযোজ্য নয় প্রতিরোধমূলক পরামর্শ 123-456-7890-এর পরিবর্তে 1234567890 লিখুন। বিবরণের জন্য শুরু করুন বিকল্প দেখুন।
CLIENT_CUSTOMER_ID_IS_REQUIRED	সারাংশ HTTP হেডারে ক্লায়েন্টের গ্রাহক আইডি উল্লেখ করা হয়নি। সাধারণ কারণ HTTP হেডারে ক্লায়েন্ট কাস্টমার আইডি উল্লেখ না করা। কীভাবে সামলাবেন প্রযোজ্য নয় প্রতিরোধমূলক পরামর্শ সব কলের জন্য ক্লায়েন্ট কাস্টমার আইডি প্রয়োজন, তাই HTTP হেডারে একটি উল্লেখ করেছেন কিনা তা নিশ্চিত করুন। আমাদের ক্লায়েন্ট লাইব্রেরি ব্যবহার করার কথা বিবেচনা করুন, কারণ এটি আপনার জন্য এই কাজটি করে।
CUSTOMER_NOT_FOUND	সারাংশ হেডারে উল্লেখ করা গ্রাহক আইডির সাথে কোনও অ্যাকাউন্ট পাওয়া যায়নি। সাধারণ কারণ ব্যাকএন্ডে অ্যাকাউন্ট তৈরি হওয়ার ঠিক আগে তৈরি করা কোনও অ্যাকাউন্ট অ্যাক্সেস করার চেষ্টা করা হচ্ছে। কীভাবে সামলাবেন প্রথমে পাঁচ মিনিট অপেক্ষা করুন, তারপর প্রতি ৩০ সেকেন্ড অন্তর আবার চেষ্টা করুন। প্রতিরোধমূলক পরামর্শ অ্যাকাউন্ট তৈরি করার পরে, সেটির বিরুদ্ধে অনুরোধ জানানোর আগে কয়েক মিনিট অপেক্ষা করুন।
GOOGLE_ACCOUNT_COOKIE_INVALID	সারাংশ অনুরোধের হেডার থাকা অ্যাক্সেস টোকেনটি হয় ভুল নয় মেয়াদ শেষ হয়ে গেছে। সাধারণ কারণ অ্যাক্সেস টোকেন বাতিল করা হয়েছে। কীভাবে ম্যানেজ করবেন নতুন টোকেনের জন্য অনুরোধ করুন। আপনি আমাদের কোনও ক্লায়েন্ট লাইব্রেরি ব্যবহার করলে, কীভাবে টোকেন রিফ্রেশ করতে হয় তা জানতে এর ডকুমেন্টেশন দেখুন। প্রতিরোধমূলক পরামর্শ অ্যাক্সেস টোকেনের মেয়াদ শেষ না হওয়া পর্যন্ত সেটি স্টোর করে রাখুন এবং আবার ব্যবহার করুন।
NOT_ADS_USER	সারাংশ অ্যাক্সেস টোকেন তৈরি করার জন্য ব্যবহৃত Google অ্যাকাউন্ট কোনও Google Ads অ্যাকাউন্টের সাথে যুক্ত নয়। সাধারণ কারণ প্রদান করা লগ-ইন তথ্য এমন একটি Google অ্যাকাউন্টের সাথে সম্পর্কিত যাতে Google Ads চালু নেই। কীভাবে সামলাবেন 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	সারাংশ Google Cloud প্রোজেক্টে শুধুমাত্র টেস্ট অ্যাক্সেস আছে এবং প্রোডাকশন অ্যাকাউন্ট অ্যাক্সেস করার জন্য এটি ব্যবহার করা যাবে না। সাধারণ কারণ টেস্ট অ্যাক্সেস লেভেল সহ Google Cloud প্রোজেক্ট ব্যবহার করে নন-টেস্ট (প্রোডাকশন) Google Ads অ্যাকাউন্টের জন্য অনুরোধ করা হয়েছে। (API ভার্সন v24 ও তার আগের ভার্সনে, এই কন্ডিশন AuthorizationError.ACTION_NOT_PERMITTED রিটার্ন করে।) কীভাবে ম্যানেজ করবেন আপনি পরীক্ষা করলে, নিশ্চিত করুন যে আপনার অনুরোধ একটি পরীক্ষা অ্যাকাউন্ট টার্গেট করছে। আপনি কোনও প্রোডাকশন Google Ads অ্যাকাউন্ট অ্যাক্সেস করতে চাইলে, Google Ads API ওভারভিউ পৃষ্ঠা থেকে আপনার Google Cloud প্রোজেক্টের অ্যাক্সেস লেভেল চেক করুন এবং এক্সপ্লোরার, প্রাথমিক বা স্ট্যান্ডার্ড অ্যাক্সেসে আপনার প্রোজেক্টের অ্যাক্সেস লেভেল আপগ্রেড করুন। প্রতিরোধমূলক পরামর্শ প্রযোজ্য নয়
CUSTOMER_NOT_ENABLED	সারাংশ গ্রাহকের অ্যাকাউন্ট অ্যাক্সেস করা যাচ্ছে না কারণ এটি চালু করা নেই। সাধারণ কারণ গ্রাহকের অ্যাকাউন্ট সাইন-আপ সম্পূর্ণ না করলে বা সেটি বন্ধ করে দেওয়া হলে এটি ঘটে। কীভাবে সামলাবেন Google Ads UI-তে সাইন-ইন করুন এবং নিশ্চিত করুন যে আপনি এই অ্যাকাউন্টের জন্য সাইন-আপ প্রসেস সম্পূর্ণ করেছেন। বন্ধ করে দেওয়া অ্যাকাউন্টের ক্ষেত্রে, বাতিল করা Google Ads অ্যাকাউন্ট আবার চালু করা দেখুন। প্রতিরোধমূলক পরামর্শ আপনি বাতিল করা হয়েছে স্ট্যাটাস চেক করে কোনও গ্রাহকের অ্যাকাউন্ট বন্ধ করা হয়েছে কিনা তা চেক করতে পারবেন।
USER_PERMISSION_DENIED	সারাংশ অনুমোদিত গ্রাহকের, অপারেটিং গ্রাহকের অ্যাক্সেস নেই। সাধারণ কারণ ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস আছে এমন ব্যবহারকারী হিসেবে যাচাই করা হচ্ছে, তবে অনুরোধে login-customer-id উল্লেখ করা হয়নি। কীভাবে ম্যানেজ করবেন প্রযোজ্য নয় প্রতিরোধমূলক পরামর্শ হাইফেন (-) ছাড়া login-customer-id-কে ম্যানেজার অ্যাকাউন্ট আইডি হিসেবে উল্লেখ করুন। ক্লায়েন্ট লাইব্রেরিতে এর জন্য বিল্ট-ইন সহায়তা আছে।