রিসেলার API সমস্যা সমাধান করুন

এই পৃষ্ঠায় রিসেলার এপিআই (Reseller API) সংক্রান্ত কিছু সাধারণ সমস্যা বর্ণনা করা হয়েছে, যেগুলোর সম্মুখীন আপনি হতে পারেন।

400:badRequest

সাবস্ক্রিপশন স্থগিত বা বাতিল করা হলে এই ত্রুটিটি ঘটে। আরও তথ্যের জন্য, ‘সাবস্ক্রিপশন সক্রিয় করুন ’ দেখুন।

400:invalid

এই ত্রুটিটি বিভিন্ন কারণে ঘটতে পারে।

আপনি যদি customers.insert মেথডটি ব্যবহার করেন, তাহলে নিম্নলিখিত কাস্টমার অবজেক্ট প্যারামিটারগুলোর মধ্যে একটি অবৈধ:

  • অবৈধ postalAddress.postalCode কোড।
  • গুগল ওয়ার্কস্পেস পুনঃবিক্রয়ের জন্য অযোগ্য postalAddress.countryCode
  • alternateEmail এবং customerDomain একই ডোমেইনে থাকতে পারে না।

এই সমস্যাটি সমাধান করতে, গ্রাহকের জন্য প্রয়োজনীয় প্যারামিটারগুলো উপস্থিত ও বৈধ আছে কিনা তা যাচাই করুন।

আপনি যদি subscriptions.changeSeats মেথডটি ব্যবহার করে থাকেন, তাহলে নিম্নলিখিত সমস্যাগুলোর মধ্যে কোনো একটির কারণে এই ত্রুটিটি ঘটে থাকতে পারে:

  • বার্ষিক প্ল্যানের জন্য সিট কমানো যায় না। সাবস্ক্রিপশনটি যাতে নবায়নের সময় অ্যাকাউন্টের সক্রিয় ব্যবহারকারীর সংখ্যার সমান সিট স্বয়ংক্রিয়ভাবে সেট করে, তার জন্য নবায়ন সেটিংস পরিবর্তন করার কথা বিবেচনা করুন।
  • আপনার অনুরোধ করা আসনের সংখ্যা অ্যাকাউন্টে থাকা বর্তমান ব্যবহারকারীর সংখ্যার চেয়ে কম। গ্রাহককে জানান যে, আসন সংখ্যা কমানোর আগে তাকে অবশ্যই একজন ব্যবহারকারীকে সরিয়ে ফেলতে হবে।
  • আপনি ভুল সিট প্যারামিটারটি বাড়িয়েছেন। FLEX প্ল্যানের জন্য maximumNumberOfSeats প্যারামিটারটি এবং ANNUAL প্ল্যানের জন্য numberOfSeats প্যারামিটারটি বাড়ান।
  • আপনি licensedNumberOfSeats প্যারামিটারটি পরিবর্তন করার চেষ্টা করেছেন, যা একটি পঠন-যোগ্য প্যারামিটার।
  • ট্রায়াল পিরিয়ড চলাকালীন, গ্রাহকদের জন্য সর্বোচ্চ ১০টি সিটের সীমা থাকে । ফ্রি ট্রায়াল সাবস্ক্রিপশন থেকে একটি পেইড সার্ভিস শুরু করলে, ট্রায়াল পিরিয়ড অবিলম্বে শেষ হবে, বিলিং শুরু হবে এবং ১০টি সিটের সর্বোচ্চ সীমাটি উঠে যাবে।

403:forbidden

এই ত্রুটিটি ঘটে যখন গ্রাহকটি আপনার মালিকানাধীন নয় অথবা আপনার গ্রাহক তাদের অ্যাডমিন কনসোলে রিসেলার অ্যাক্সেস নিষ্ক্রিয় করে রেখেছে।

403:usageLimits.dailyLimitExceeded

এই API-তে কল করার দৈনিক কোটা পূরণ হয়ে গেলে এই ত্রুটিটি ঘটে। এই সমস্যাটি সমাধান করতে, একটি ব্যাকঅফ ডিলে প্রয়োগ করুন। আরও তথ্যের জন্য, ব্যবহারের সীমা এবং কোটা দেখুন।

আপনি যদি অনেকগুলো সাবস্ক্রিপশন পুনরুদ্ধার করতে চান, তাহলে customerId বা subscriptionId প্যারামিটার উল্লেখ না করে subscriptions.list মেথডটি ব্যবহার করার কথা বিবেচনা করতে পারেন। প্রতি কলে আপনি সর্বোচ্চ ১০০টি সাবস্ক্রিপশন ফেরত দিতে পারবেন। একটি রিসেলার অ্যাকাউন্টের অধীনে থাকা সমস্ত সাবস্ক্রিপশন পুনরুদ্ধার করা চালিয়ে যেতে pageToken প্যারামিটারটি ব্যবহার করুন।

403:usageLimits.accessNotConfigured

গুগল ক্লাউড প্রজেক্টে এপিআই (API) সক্রিয় করা না থাকলে এই ত্রুটিটি দেখা দেয়। এই সমস্যাটি সমাধান করতে, গুগল ক্লাউড কনসোলে যান এবং এপিআই (API) সক্রিয় করুন। আরও তথ্যের জন্য, ‘গুগল ওয়ার্কস্পেস এপিআই (Google Workspace APIs) সক্রিয় করুন’ দেখুন।

404:notFound

customers.get মেথড ব্যবহার করার সময় এই এররটির অর্থ হলো, কোনো Google Workspace অ্যাকাউন্টের জন্য কাস্টমার বা ডোমেইনটির অস্তিত্ব নেই এবং ডোমেইনটি উপলব্ধ আছে।

412:conditionNotMet

এই ত্রুটিটি বিভিন্ন কারণে ঘটে থাকে।

subscriptions.changeRenewalSettings মেথডটি ব্যবহার করার সময় যদি আপনি এই এররটির সম্মুখীন হন, তাহলে নিশ্চিত করুন যে আপনি শুধুমাত্র নিম্নলিখিত কমিটমেন্ট পেমেন্ট প্ল্যানগুলিতেই এই মেথডটি কল করছেন:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

subscriptions.delete মেথডটি ব্যবহার করার সময় যদি আপনি এই ত্রুটিটির সম্মুখীন হন, তার মানে হলো Google Workspace অ্যাকাউন্টে কোনো অ্যাডমিনিস্ট্রেটর ব্যবহারকারী নেই। এই সমস্যাটি সমাধান করতে, একজন অস্থায়ী অ্যাডমিনিস্ট্রেটর ব্যবহারকারী যোগ করুন এবং আবার চেষ্টা করুন।

subscriptions.insert পদ্ধতিটি ব্যবহার করার সময় যদি আপনি এই ত্রুটিটির সম্মুখীন হন, তার মানে হলো আপনি নির্বাচিত SKU-টি অথবা উদীয়মান বাজারের গ্রাহকদের কাছে পুনরায় বিক্রি করতে পারবেন না। এই সমস্যাটি সমাধান করতে, প্রযোজ্য পরিষেবার শর্তাবলী গ্রহণ করুন।

429:usageLimits.quotaExceeded

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

আপনি যদি অনেকগুলো সাবস্ক্রিপশন পুনরুদ্ধার করতে চান, তাহলে customerId বা subscriptionId প্যারামিটার উল্লেখ না করে subscriptions.list মেথডটি ব্যবহার করার কথা বিবেচনা করতে পারেন। প্রতি কলে আপনি সর্বোচ্চ ১০০টি সাবস্ক্রিপশন ফেরত দিতে পারবেন। একটি রিসেলার অ্যাকাউন্টের অধীনে থাকা সমস্ত সাবস্ক্রিপশন পুনরুদ্ধার করা চালিয়ে যেতে pageToken প্যারামিটারটি ব্যবহার করুন।