এই বিভাগে মার্চেন্ট এপিআই-এর ডেভেলপার রেজিস্ট্রেশন সংক্রান্ত সাধারণ প্রশ্নগুলির আলোচনা করা হয়েছে।
সাধারণ নিবন্ধন
নিবন্ধন প্রক্রিয়া সম্পর্কে সাধারণ প্রশ্নাবলী:
মার্চেন্ট এপিআই ব্যবহার করার জন্য ডেভেলপার নিবন্ধন কি বাধ্যতামূলক?
হ্যাঁ। আপনাকে অবশ্যই আপনার ডেভেলপার যোগাযোগের তথ্য নিবন্ধন করতে হবে, যাতে গুগল আপনাকে এপিআই-সম্পর্কিত গুরুত্বপূর্ণ আপডেট, যেমন পরিষেবা ঘোষণা এবং নতুন ফিচারের তথ্য পাঠাতে পারে।
আপনি যদি শুধু মার্চেন্ট এপিআই অন্বেষণ ও পরীক্ষা করতে চান, তাহলে গুগল ওঅথ প্লেগ্রাউন্ড এবং এপিআই এক্সপ্লোরারের মতো টুল ব্যবহার করতে পারেন, যেগুলোর জন্য নিবন্ধনের প্রয়োজন হয় না।
আমাকে কত ঘন ঘন নিবন্ধন করতে হবে?
প্রতিটি গুগল ক্লাউড প্রজেক্টের জন্য রেজিস্ট্রেশন একটি এককালীন সেটআপ। আপনি একাধিক মার্চেন্ট অ্যাকাউন্ট নিয়ে কাজ করুন বা না করুন, আপনাকে রেজিস্ট্রেশন প্রক্রিয়াটি শুধুমাত্র একবারই করতে হবে এবং এটি লিঙ্ক করা গুগল ক্লাউড প্রজেক্টের অন্তর্ভুক্ত সমস্ত ব্যবহারকারী ও সার্ভিস অ্যাকাউন্টের জন্য প্রযোজ্য হবে।
একটি গুগল ক্লাউড প্রজেক্ট সফলভাবে রেজিস্টার করা হয়ে গেলে, ` unregisterGcp` মেথডটি কল করে স্পষ্টভাবে মুছে না ফেলা পর্যন্ত লিঙ্কটি সক্রিয় থাকে। আপনি `APIs Explorer` বা `OAuth Playground`-এর মতো শেয়ার করা, গুগলের মালিকানাধীন প্রজেক্টগুলো রেজিস্টার করতে পারবেন না।
ডেভেলপার যোগাযোগের জন্য আমি কোন ইমেল ঠিকানা প্রদান করব?
আমরা কোনো ব্যক্তির কর্পোরেট ইমেল ঠিকানা ব্যবহার করার পরামর্শ দিই। বিকল্পভাবে আপনি সাধারণ গ্রুপ অ্যালিয়াস ব্যবহার করতে পারেন। আপনি সার্ভিস অ্যাকাউন্টের ইমেল ব্যবহার করতে পারবেন না, কারণ এই যোগাযোগগুলো মানুষের জন্য উদ্দিষ্ট। গুগল এপিআই-সংক্রান্ত গুরুত্বপূর্ণ আপডেট পাঠায়, যেমন পরিষেবা ঘোষণা এবং নতুন ফিচারের তথ্য।
যদি ইমেল ঠিকানাটি মার্চেন্ট সেন্টার অ্যাকাউন্টের কোনো বিদ্যমান ব্যবহারকারীর হয়, তবে তাকে স্বয়ংক্রিয়ভাবে API_DEVELOPER রোলটি প্রদান করা হয়। অন্যথায়, সেই ঠিকানায় একটি আমন্ত্রণ পাঠানো হয়।
`registerGcp` মেথডে ডেভেলপার যোগাযোগের ইমেল ঠিকানা ফিল্ডটি ঐচ্ছিক। নিবন্ধন করার সময় আপনি যদি এই ফিল্ডে কোনো মান প্রদান না করেন, তাহলে আপনাকে অবশ্যই মার্চেন্ট সেন্টার UI-তে অথবা ` accounts.users.create` মেথডটি কল করে ` API_DEVELOPER রোলসহ একজন ব্যবহারকারী তৈরি করতে হবে।
ডেভেলপারের যোগাযোগের ইমেল কি গুগল অ্যাকাউন্ট হতে হবে?
হ্যাঁ। আপনার বিদ্যমান কোনো নন-গুগল ইমেল ব্যবহার করতে চাইলে, 'একটি গুগল অ্যাকাউন্ট তৈরি করুন' সাইনআপ প্রক্রিয়ায় ' আপনার বিদ্যমান ইমেল ব্যবহার করুন' বিকল্পটি বেছে নিয়ে সেটিকে একটি গুগল অ্যাকাউন্টের সাথে যুক্ত করতে পারেন। আপনি সার্ভিস অ্যাকাউন্টের ইমেল ব্যবহার করতে পারবেন না, কারণ সার্ভিস অ্যাকাউন্ট ইমেল গ্রহণ করতে পারে না।
রেজিস্ট্রেশন কলের জন্য আমি কীভাবে অথেন্টিকেশন এবং অথরাইজেশন সম্পন্ন করব?
আপনার ব্যবহারের ধরনের ওপর নির্ভর করে, রেজিস্ট্রেশন কলের প্রমাণীকরণ এবং অনুমোদনের জন্য দুটি স্বতন্ত্র প্রমাণীকরণ পদ্ধতি উপলব্ধ রয়েছে:
- OAuth 2.0 : একাধিক মার্চেন্ট অ্যাকাউন্ট পরিচালনাকারী তৃতীয় পক্ষের প্রদানকারী বা সংস্থাগুলির জন্য
- সার্ভিস অ্যাকাউন্ট : আপনার নিজের মার্চেন্ট সেন্টার অ্যাকাউন্টে প্রবেশের জন্য
পূর্ববর্তী ডায়াগ্রামটি রেজিস্ট্রেশন কলের জন্য দুটি অথেনটিকেশন এবং অথরাইজেশন ফ্লো দেখায়। আপনি নিম্নলিখিত বিকল্পগুলির মধ্যে থেকে বেছে নিতে পারেন:
- গুগল অ্যাকাউন্টের সাথে যুক্ত account@email.com- এর মতো ইমেল ঠিকানা দিয়ে OAuth ব্যবহার করা
- sa@project.iam.gserviceaccount.com- এর মতো একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে
আপনি যদি OAuth ব্যবহার করার সিদ্ধান্ত নেন:
- আপনার ইমেইলের জন্য গুগল ক্লাউড প্রজেক্টে OAuth ক্রেডেনশিয়াল তৈরি করুন
- নিশ্চিত করুন যে অনুমোদনকারী ইমেল ঠিকানাটি আপনার মার্চেন্ট সেন্টারে বিদ্যমান আছে এবং এটির
ADMINঅ্যাক্সেস টাইপ রয়েছে।
আপনি যদি একটি সার্ভিস অ্যাকাউন্ট নেওয়ার সিদ্ধান্ত নেন :
- নিশ্চিত করুন যে সার্ভিস অ্যাকাউন্টটি আপনার গুগল ক্লাউড প্রজেক্টে বিদ্যমান আছে।
- নিশ্চিত করুন যে সার্ভিস অ্যাকাউন্টের সাথে যুক্ত ইমেল ঠিকানাটি আপনার মার্চেন্ট সেন্টারে বিদ্যমান আছে এবং এটির
ADMINঅ্যাক্সেস টাইপ রয়েছে।
সরাসরি এপিআই কল অথবা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে, প্রমাণীকরণকারী আইডেন্টিটির নিরাপত্তা প্রেক্ষাপটের অধীনে রেজিস্ট্রেশন কলটি সম্পাদন করুন। ডেভেলপার যোগাযোগের জন্য একটি ইমেল ঠিকানা প্রদান করুন, উদাহরণস্বরূপ developer@email.com ।
রেজিস্ট্রেশন কলটি সফল হলে, আপনার মার্চেন্ট সেন্টারে প্রদত্ত ডেভেলপার ইমেল ঠিকানা এবং API_DEVELOPER রোল সহ একজন ব্যবহারকারী তৈরি হয়। এর জবাবে আপনি একটি DeveloperRegistration রিসোর্স পাবেন।
প্রমাণীকরণ ইমেল এবং ডেভেলপার যোগাযোগের ইমেলের মধ্যে পার্থক্য কী?
মার্চেন্ট এপিআই ইকোসিস্টেমের মধ্যে এই দুটি ইমেল ঠিকানা ভিন্ন ভিন্ন উদ্দেশ্য পূরণ করে:
- ইমেইল যাচাইকরণ : মার্চেন্ট এপিআই-তে অনুরোধ অনুমোদন করার জন্য আপনি সাধারণত আপনার গুগল অ্যাকাউন্ট বা কোনো পরিষেবা অ্যাকাউন্টের সাথে যুক্ত ইমেইলকে পরিচয়পত্র হিসেবে ব্যবহার করেন, এই শর্তে যে:
- এটি আপনার মার্চেন্ট সেন্টারে অবস্থিত এবং এর
ADMINভূমিকা রয়েছে। - যে গুগল ক্লাউড প্রজেক্টে মার্চেন্ট এপিআই সক্রিয় করা আছে, সেটি এপিআই কলগুলোকে অনুমোদনকারী ইমেলের সাথে যুক্ত OAuth ক্লায়েন্ট বা সার্ভিস অ্যাকাউন্টটি হোস্ট করে।
- এটি আপনার মার্চেন্ট সেন্টারে অবস্থিত এবং এর
- ডেভেলপার যোগাযোগের ইমেল : ডেভেলপার যোগাযোগের ইমেলটিও অবশ্যই একটি গুগল অ্যাকাউন্টের সাথে যুক্ত থাকতে হবে, তবে এটি গুগলের পক্ষ থেকে গুরুত্বপূর্ণ পরিষেবা ঘোষণা এবং এপিআই আপডেটের জন্য প্রাথমিক যোগাযোগের মাধ্যম হিসেবে কাজ করে। এটি একজন ব্যবহারকারী বা ব্যবহারকারীদের একটি গ্রুপের হতে পারে। ডিফল্টরূপে, এটি মার্চেন্ট সেন্টারে
API developerরোলটি পায়।
ডেভেলপারের যোগাযোগের ইমেইলে পাওয়া আমন্ত্রণটি কি আমাকে গ্রহণ করতেই হবে?
হ্যাঁ। আপনার দেওয়া ডেভেলপারের যোগাযোগের ইমেল প্রাপক আমন্ত্রণটি গ্রহণ করার জন্য ১৪ দিন সময় পাবেন। তিনি আমন্ত্রণটি গ্রহণ করার পরেই নিবন্ধন সম্পূর্ণ হবে। তবে, এই সময়ের মধ্যে আপনি এপিআই (API) কল করতে পারবেন।
নির্দিষ্ট সময়ের মধ্যে আমন্ত্রণটি গ্রহণ করা না হলে, আমন্ত্রণ লিঙ্কটির মেয়াদ শেষ হয়ে যায়। আপনি আর মার্চেন্ট এপিআই (Merchant API) কল করতে পারবেন না এবং আপনাকে নিবন্ধন প্রক্রিয়াটি পুনরায় শুরু করতে হবে।
অ্যাকাউন্ট এবং প্রকল্প ব্যবস্থাপনা
অ্যাকাউন্ট ও প্রজেক্ট ম্যানেজমেন্ট সম্পর্কিত সাধারণ প্রশ্নাবলী:
আমি একাধিক মার্চেন্ট সেন্টার অ্যাকাউন্ট নিয়ে কাজ করি। মার্চেন্ট এপিআই-এর সাথে ব্যবহার করতে চাই এমন প্রতিটি মার্চেন্ট সেন্টার অ্যাকাউন্ট কি আমাকে রেজিস্টার করতে হবে?
না। আপনি যদি একজন থার্ড-পার্টি ডেভেলপার বা এমন কোনো এজেন্সি হন যা একাধিক মার্চেন্টের অ্যাকাউন্ট পরিচালনা করে, তাহলে আপনি আপনার গুগল ক্লাউড প্রজেক্টটি আপনার নিজের প্রধান মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে রেজিস্টার করবেন, আপনার প্রতিটি মার্চেন্টের অ্যাকাউন্টের সাথে নয়। এইভাবে, আপনি আপনার মার্চেন্টদের জন্য করা সমস্ত এপিআই (API) কাজের ক্ষেত্রে ডেভেলপারের প্রতিনিধিত্ব করেন।
আমি একাধিক মার্চেন্ট সেন্টার অ্যাকাউন্ট ব্যবহার করি। আমি আমার প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্টটি কীভাবে নির্বাচন করব?
ব্যবহারের জন্য প্রাথমিক অ্যাকাউন্ট নির্বাচন করা আপনার ব্যবসার ধরনের উপর নির্ভর করে:
- বিদ্যমান অ্যাডভান্সড অ্যাকাউন্টসহ মার্কেটপ্লেস: যদি আপনার ব্যবসা একটি মার্কেটপ্লেস হিসেবে পরিচালিত হয় এবং পুরো প্ল্যাটফর্মের প্রতিনিধিত্বকারী একটি অ্যাডভান্সড অ্যাকাউন্ট আগে থেকেই থাকে, তাহলে এই বিদ্যমান অ্যাকাউন্ট আইডিটিকেই প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্ট হিসেবে ব্যবহার করুন।
- তুলনাভিত্তিক কেনাকাটা পরিষেবা (CSS): আপনি যদি একজন CSS হন, তাহলে আপনার অনন্য CSS অ্যাকাউন্ট আইডি অথবা CSS গ্রুপ অ্যাকাউন্ট আইডি ব্যবহার করুন।
- এজেন্সি, ডেভেলপার এবং অন্যান্য থার্ড-পার্টি (3P): আপনি যদি কোনো এজেন্সি বা থার্ড-পার্টি ডেভেলপারের মতো 3P ব্যবসা হন, যা একাধিক মার্চেন্ট অ্যাকাউন্ট পরিচালনা করে এবং আপনার ব্যবসার প্রতিনিধিত্বকারী কোনো একক মার্চেন্ট সেন্টার আইডি না থাকে, তাহলে আপনার একটি নতুন, প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্ট তৈরি করা উচিত এবং সেটিকে একটি অ্যাডভান্সড অ্যাকাউন্টে রূপান্তর করার জন্য অনুরোধ করা উচিত।
আপনার গুগল ক্লাউড প্রজেক্টটি একবার আপনার প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্টে রেজিস্টার করা হয়ে গেলে, আপনি সেই একই প্রজেক্ট ব্যবহার করে আপনার অ্যাক্সেস আছে এমন অন্য যেকোনো মার্চেন্ট সেন্টার অ্যাকাউন্ট পরিচালনা করতে পারবেন, এবং এর জন্য সেই অ্যাকাউন্টগুলোকে আলাদাভাবে রেজিস্টার করার কোনো প্রয়োজন হবে না।
আমি একাধিক গুগল ক্লাউড প্রজেক্ট ব্যবহার করি। আমাকে কি প্রত্যেকটি নিবন্ধন করতে হবে?
হ্যাঁ। যেহেতু রেজিস্ট্রেশন প্রক্রিয়াটি কলকারী গুগল ক্লাউড প্রজেক্টকে লিঙ্ক করে, তাই এপিআই কল করার জন্য ব্যবহৃত প্রতিটি গুগল ক্লাউড প্রজেক্ট থেকে আপনাকে অবশ্যই registerGcp কলটি সম্পাদন করতে হবে।
একটি একক গুগল ক্লাউড প্রজেক্ট একই সময়ে শুধুমাত্র একটি মার্চেন্ট সেন্টার অ্যাকাউন্টে রেজিস্টার করা যেতে পারে। তবে, একটি একক মার্চেন্ট সেন্টার অ্যাকাউন্টে একাধিক গুগল ক্লাউড প্রজেক্ট রেজিস্টার করা থাকতে পারে। একইভাবে, আপনি একাধিক গুগল ক্লাউড প্রজেক্ট বা একাধিক মার্চেন্ট সেন্টারে একাধিক রেজিস্ট্রেশন করার জন্য একই ডেভেলপার ইমেল অ্যাড্রেস ব্যবহার করতে পারেন।
একাধিক মার্চেন্ট সেন্টার অ্যাকাউন্ট দিয়ে একটি গুগল ক্লাউড প্রজেক্ট রেজিস্টার করলে কী হবে?
অন্য কোনো মার্চেন্ট সেন্টার অ্যাকাউন্টে ইতিমধ্যে নিবন্ধিত একটি গুগল ক্লাউড প্রজেক্ট পুনরায় নিবন্ধন করার চেষ্টা করলে ALREADY_REGISTERED ত্রুটি দেখা দেবে।
আমি কীভাবে ডেভেলপার রেজিস্ট্রেশন এপিআই কলটি প্রমাণীকরণ করব?
মার্চেন্ট এপিআই-এর জন্য ডেভেলপার রেজিস্ট্রেশন এপিআই কলটি প্রমাণীকরণ করতে, আপনি একটি গুগল ক্লাউড প্রজেক্টের মাধ্যমে পরিচালিত ক্রেডেনশিয়াল ব্যবহার করেন। যে আইডেন্টিটি এই প্রমাণীকরণটি সম্পাদন করে, তার জন্য আপনার কাছে দুটি প্রধান বিকল্প রয়েছে:
- OAuth 2.0 ব্যবহার করে Gmail-এর মতো Google অ্যাকাউন্ট : এই পদ্ধতিতে আপনার Google Cloud Project-এর মধ্যে তৈরি করা OAuth 2.0 ক্লায়েন্ট ক্রেডেনশিয়াল ব্যবহার করা হয়। ব্যবহারকারী যে নির্দিষ্ট Google অ্যাকাউন্টে সাইন ইন করেন, তার পক্ষ থেকে API কলটি অনুমোদিত হয়।
- সার্ভিস অ্যাকাউন্ট : এই পদ্ধতিতে একটি গুগল ক্লাউড সার্ভিস অ্যাকাউন্ট ব্যবহার করা হয়, যা অ্যাপ্লিকেশনগুলির জন্য উদ্দিষ্ট এক বিশেষ ধরনের গুগল অ্যাকাউন্ট। সার্ভিস অ্যাকাউন্টের ক্রেডেনশিয়ালগুলিও আপনার গুগল ক্লাউড প্রোজেক্টের মধ্যেই পরিচালিত হয়।
সফল ডেভেলপার নিবন্ধনের জন্য, মার্চেন্ট সেন্টারের মধ্যে প্রমাণীকরণকারী পরিচয়কে (গুগল অ্যাকাউন্ট বা সার্ভিস অ্যাকাউন্ট) অবশ্যই নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:
- মার্চেন্ট সেন্টারে ব্যবহারকারী হিসেবে বিদ্যমান থাকতে হবে : প্রমাণীকরণকারী গুগল অ্যাকাউন্ট বা সার্ভিস অ্যাকাউন্টের সাথে যুক্ত ইমেল ঠিকানাটি, আপনি যে মার্চেন্ট সেন্টার অ্যাকাউন্টটি নিবন্ধন করছেন, সেখানে একজন ব্যবহারকারী হিসেবে যুক্ত থাকতে হবে।
- অ্যাডমিন ভূমিকা আবশ্যক : এই ব্যবহারকারীকে অবশ্যই সেই নির্দিষ্ট মার্চেন্ট সেন্টার অ্যাকাউন্টে
ADMINভূমিকা বরাদ্দ করা থাকতে হবে।
এপিআই কল করার সময়:
- আপনি যদি ডাইরেক্ট এপিআই কল ব্যবহার করেন, তাহলে আপনাকে অবশ্যই একটি বৈধ অ্যাক্সেস টোকেন সংগ্রহ করে
Authorizationহেডারে প্রদান করতে হবে। এই টোকেনটি একটি গুগল অ্যাকাউন্টের জন্য OAuth 2.0 ফ্লো দ্বারা অথবা একটি সার্ভিস অ্যাকাউন্টের জন্য সার্ভার-টু-সার্ভার অথেন্টিকেশন ফ্লো দ্বারা তৈরি হয়। - গুগল কর্তৃক প্রদত্ত ক্লায়েন্ট লাইব্রেরিগুলো সাধারণত তাদের কনফিগারেশনের অংশ হিসেবেই আপনার জন্য অ্যাক্সেস টোকেন সংগ্রহ ও রিফ্রেশ করার জটিল বিষয়গুলো সামলে নেয়।
প্রমাণীকরণকারী ব্যবহারকারী এবং ডেভেলপার যোগাযোগকারী ব্যবহারকারী একই ব্যক্তি নাও হতে পারেন । আরও তথ্যের জন্য, “প্রমাণীকরণকারী ইমেল এবং ডেভেলপার যোগাযোগকারী ইমেলের মধ্যে পার্থক্য কী?” দেখুন।
আমাকে কত ঘন ঘন অ্যাক্সেস টোকেন রিফ্রেশ করতে হবে?
সার্ভিস অ্যাকাউন্ট এবং OAuth 2.0 উভয়ের অ্যাক্সেস টোকেন সাধারণত ১ ঘণ্টা পর মেয়াদোত্তীর্ণ হয়ে যায়। তবে, নতুন টোকেন পাওয়ার প্রক্রিয়াটি নির্ভর করে আপনি কোন প্রমাণীকরণ পদ্ধতি ব্যবহার করছেন তার উপর:
- সার্ভিস অ্যাকাউন্টগুলো প্রয়োজনমতো একটি নতুন অ্যাক্সেস টোকেন তৈরি করতে প্রাইভেট কী বা এনভায়রনমেন্ট ক্রেডেনশিয়াল ব্যবহার করে।
- OAuth 2.0 ফ্লো একটি নতুন ১-ঘণ্টার অ্যাক্সেস টোকেন পাওয়ার জন্য Google OAuth2 টোকেন এন্ডপয়েন্টকে কল করতে একটি refresh_token ব্যবহার করে।
আমরা অফিসিয়াল গুগল অথোরাইজেশন লাইব্রেরি ব্যবহার করার জন্য দৃঢ়ভাবে সুপারিশ করছি, যা এই রোটেশনটি স্বয়ংক্রিয়ভাবে পরিচালনা করে, ফলে আপনার অ্যাপ্লিকেশনে কখনও ডাউনটাইম হয় না।
ব্যবহারকারী এবং ভূমিকা
ব্যবহারকারী এবং ভূমিকা সম্পর্কে সাধারণ প্রশ্নাবলী:
ডেভেলপার ইমেল অ্যাকাউন্টটি কি মার্চেন্ট সেন্টারে আগে থেকেই বিদ্যমান থাকতে হবে?
না। যদি রেজিস্ট্রেশন ইমেল অ্যাকাউন্টটি মার্চেন্ট সেন্টারে আগে থেকে বিদ্যমান না থাকে, তাহলে মার্চেন্ট এপিআই নির্দিষ্ট ইমেলটি দিয়ে মার্চেন্ট সেন্টারে অ্যাকাউন্টটি পেন্ডিং স্ট্যাটাসে তৈরি করে। যদি ডেভেলপার ইমেল অ্যাড্রেসটি মার্চেন্ট সেন্টার অ্যাকাউন্টের কোনো বিদ্যমান ব্যবহারকারীর হয়, তাহলে তাকে স্বয়ংক্রিয়ভাবে API_DEVELOPER রোলটি প্রদান করা হয়।
ডেভেলপারের যোগাযোগের ইমেইলে কি মার্চেন্ট সেন্টারে অ্যাডমিন অধিকার থাকা প্রয়োজন?
না। ডেভেলপার কন্টাক্ট ইমেলের সাথে যুক্ত মার্চেন্ট সেন্টার ব্যবহারকারী ডিফল্টরূপে API_DEVELOPER রোলটি পান, যা গুরুত্বপূর্ণ নোটিফিকেশন পাওয়ার জন্য প্রয়োজন। তবে, মার্চেন্ট সেন্টারের মধ্যে এর অনুমতি খুবই সীমিত। এই ব্যবহারকারীকে অন্যান্য API কল করতে বা মার্চেন্ট সেন্টার UI-তে সেটিংস পরিচালনা করার অনুমতি দিতে, আপনাকে তাকে STANDARD বা ADMIN মতো অতিরিক্ত রোল প্রদান করতে হবে। মার্চেন্ট সেন্টারের রোল সম্পর্কে আরও তথ্যের জন্য, অ্যাক্সেস টাইপস দেখুন।
"API ডেভেলপার" রোলটির কী কী অনুমতি রয়েছে?
মার্চেন্ট সেন্টারে API Developer রোলটির অধিকার খুবই সীমিত। আপনি যদি মার্চেন্ট এপিআই-তে কল অনুমোদনের জন্য ডেভেলপারের কন্টাক্ট ইমেল ব্যবহার করার পরিকল্পনা করেন, তবে আমরা ব্যবহারকারীকে এপিআই কল করার সুযোগ দিতে ADMIN বা STANDARD পারমিশন যোগ করার পরামর্শ দিই।
এপিআই কলকারী প্রতিটি ডেভেলপার ব্যবহারকারী বা পরিষেবা অ্যাকাউন্ট কি নিবন্ধন করতে হবে?
না। ডেভেলপার রেজিস্ট্রেশনটি এপিআই কল করার জন্য ব্যবহৃত গুগল ক্লাউড প্রজেক্টের সাথে সংযুক্ত থাকে, কোনো স্বতন্ত্র ব্যবহারকারী বা সার্ভিস অ্যাকাউন্টের সাথে নয়। আপনার প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে একটি গুগল ক্লাউড প্রজেক্ট সফলভাবে রেজিস্টার হয়ে গেলে, আপনি মার্চেন্ট এপিআই কল অনুমোদন করার জন্য OAuth ক্রেডেনশিয়াল বা সার্ভিস অ্যাকাউন্ট ব্যবহার করে লিঙ্ক করা গুগল ক্লাউড প্রজেক্টের মাধ্যমে পরিচালিত যেকোনো আইডেন্টিটি ব্যবহার করতে পারবেন, যদি সেগুলো আপনার মার্চেন্ট সেন্টারে বিদ্যমান থাকে এবং সেগুলোতে ADMIN রোল অ্যাসাইন করা থাকে।
প্রাথমিক নিবন্ধনের পর আমি কীভাবে ডেভেলপার যোগাযোগের ইমেল পরিবর্তন করব?
যোগাযোগ পরিচালনা বা পরিবর্তন করতে, স্ট্যান্ডার্ড accounts.users পরিষেবা অথবা মার্চেন্ট সেন্টার UI-এর "অ্যাক্সেস এবং পরিষেবা" পৃষ্ঠা ব্যবহার করে API Developer ভূমিকা সহ ব্যবহারকারীদের যুক্ত বা অপসারণ করুন।
মার্চেন্ট সেন্টার অ্যাকাউন্ট থেকে সর্বশেষ 'এপিআই ডেভেলপার' ব্যবহারকারীকে সরিয়ে দেওয়া হলে কী হবে?
তাৎক্ষণিক পরিষেবা বিঘ্ন এড়ানোর জন্য ৩০ দিনের একটি অবকাশকাল চালু করা হয়। এই সময়ে:
- অ্যাডমিনরা ইমেলের মাধ্যমে তিনটি বাধ্যতামূলক পরিষেবা সংক্রান্ত ঘোষণা পাবেন (সাধারণত ব্লক করার প্রায় ৩০, ১৭ এবং ৪ দিন আগে)।
- এপিআই কলগুলো স্বাভাবিকভাবে কাজ করতে থাকবে।
- গ্রেস পিরিয়ড শেষ হওয়ার আগে যদি কোনো নতুন
API Developerযুক্ত না করা হয়, তাহলে সংশ্লিষ্ট গুগল ক্লাউড প্রজেক্টগুলো থেকে করা এপিআই কলগুলোAUTH_GCP_NOT_REGISTEREDএরর দেখিয়ে ব্লক করে দেওয়া হবে।
৩০ দিনের গ্রেস পিরিয়ড শেষ হয়ে গেলে, সংশ্লিষ্ট গুগল ক্লাউড প্রজেক্টগুলো থেকে এপিআই কল ব্লক হয়ে যায় এবং একটি বৈধ ডেভেলপার কন্টাক্ট পুনরুদ্ধার না করা পর্যন্ত সেগুলোতে AUTH_GCP_NOT_REGISTERED এরর দেখা যায়।
যে মার্চেন্ট সেন্টার আইডিতে ডেভেলপার রেজিস্ট্রেশন করা হয়েছে, সেটি মুছে ফেলা হলে কী হবে?
আপনার ইন্টিগ্রেশন সক্রিয় থাকা অবস্থায় ডেভেলপার রেজিস্ট্রেশনের জন্য ব্যবহৃত মার্চেন্ট সেন্টার অ্যাকাউন্টটি ডিলিট করবেন না। এই অ্যাকাউন্টটি ডিলিট করলে আপনার ইন্টিগ্রেশনটি তাৎক্ষণিকভাবে অকার্যকর হয়ে যাবে এবং আপনি সংশ্লিষ্ট গুগল ক্লাউড প্রজেক্ট থেকে আর এপিআই কল করতে পারবেন না।
যদি আপনাকে সেই মার্চেন্ট সেন্টার অ্যাকাউন্টটি ডিলিট করতেই হয়, তবে প্রথমে লিঙ্কটি নিরাপদে সরানোর জন্য unregisterGcp মেথডটি কল করুন এবং তারপরেই মার্চেন্ট সেন্টার আইডিটি ডিলিট করার জন্য অগ্রসর হন। যদি আপনি মার্চেন্ট এপিআই ব্যবহার করা চালিয়ে যেতে চান, তবে বর্তমানটি আনরেজিস্টার করার ঠিক পরেই আপনাকে অন্য একটি মার্চেন্ট সেন্টার আইডি দিয়ে রেজিস্টার করতে হবে। শুধুমাত্র তারপরেই মার্চেন্ট সেন্টার আইডিটি ডিলিট করার জন্য অগ্রসর হন।
বিশেষ ব্যবহারের ক্ষেত্র
বিশেষ ব্যবহারের ক্ষেত্র সম্পর্কে সাধারণ প্রশ্নাবলী:
আমি একটি এজেন্সি বা থার্ড-পার্টি ডেভেলপার হিসেবে একাধিক মার্চেন্ট অ্যাকাউন্ট পরিচালনা করি। এটি সেট আপ করার সেরা উপায় কী?
তৃতীয় পক্ষের ডেভেলপার এবং এজেন্সিগুলোর নিজস্ব একটি প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্ট থাকা উচিত এবং তাদের সমস্ত গুগল ক্লাউড প্রজেক্ট সেই একটিমাত্র কেন্দ্রীভূত অ্যাকাউন্টে রেজিস্টার করা উচিত। প্রতিটি স্বতন্ত্র মার্চেন্টের অ্যাকাউন্টে আপনার গুগল ক্লাউড প্রজেক্ট রেজিস্টার করবেন না।
গুগল অ্যাপ স্ক্রিপ্টসের জন্য নিবন্ধন কীভাবে কাজ করে?
অ্যাপ স্ক্রিপ্টগুলো সাধারণত একটি ডিফল্ট গুগল ক্লাউড প্রজেক্টে চলে। আপনাকে অবশ্যই আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে এই ডিফল্ট গুগল ক্লাউড আইডিটি রেজিস্টার করতে হবে। গুগল ক্লাউড আইডিটি এপিআই (API) দ্বারা স্বয়ংক্রিয়ভাবে সংগ্রহ করা হয়, তাই আপনাকে এটি প্যারামিটার হিসেবে প্রদান করতে হবে না।
আমি কি যাচাই করতে পারি যে কোনো মার্চেন্ট সেন্টার আইডি একটি নির্দিষ্ট গুগল ক্লাউড প্রজেক্ট আইডিতে নিবন্ধিত আছে কি না?
হ্যাঁ। আপনি getAccountForGcpRegistration মেথডটি ব্যবহার করে দেখতে পারেন কোন মার্চেন্ট সেন্টার আইডি একটি নির্দিষ্ট গুগল ক্লাউড প্রজেক্টে রেজিস্টার করা আছে। আপনার মার্চেন্ট সেন্টার অ্যাকাউন্ট থেকে গুগল ক্লাউড প্রজেক্টের লিঙ্কটি সরাতে, unregisterGcp মেথডটি ব্যবহার করুন।