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

এই নির্দেশিকায় সাধারণ 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	সারাংশ ক্লায়েন্ট গ্রাহক আইডি কোনও নম্বর নয়। সাধারণ কারণ ভুল ক্লায়েন্ট কাস্টমার আইডি ব্যবহার করা হচ্ছে। কীভাবে সামলাবেন প্রযোজ্য নয় প্রতিরোধমূলক পরামর্শ ১২৩-৪৫৬-৭৮৯০-এর পরিবর্তে ১২৩৪৫৬৭৮৯০ হতে হবে। আরও বিবরণের জন্য শুরু করা যাক বিকল্প দেখুন।
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 উল্লেখ করুন। ক্লায়েন্ট লাইব্রেরিতে এর জন্য বিল্ট-ইন সহায়তা আছে।