এই বিভাগে মার্চেন্ট এপিআই-এর ডেভেলপার রেজিস্ট্রেশন সংক্রান্ত সাধারণ প্রশ্নগুলির আলোচনা করা হয়েছে।
সাধারণ নিবন্ধন
নিবন্ধন প্রক্রিয়া সম্পর্কে সাধারণ প্রশ্নাবলী:
মার্চেন্ট এপিআই ব্যবহার করার জন্য ডেভেলপার নিবন্ধন কি বাধ্যতামূলক?
হ্যাঁ। আপনাকে অবশ্যই আপনার ডেভেলপার যোগাযোগের তথ্য নিবন্ধন করতে হবে, যাতে গুগল আপনাকে এপিআই-সম্পর্কিত গুরুত্বপূর্ণ আপডেট, যেমন পরিষেবা ঘোষণা এবং নতুন ফিচারের তথ্য পাঠাতে পারে।
আপনি যদি শুধু মার্চেন্ট এপিআই অন্বেষণ ও পরীক্ষা করতে চান, তাহলে গুগল ওঅথ প্লেগ্রাউন্ড এবং এপিআই এক্সপ্লোরারের মতো টুল ব্যবহার করতে পারেন, যেগুলোর জন্য নিবন্ধনের প্রয়োজন হয় না।
আমাকে কত ঘন ঘন নিবন্ধন করতে হবে?
প্রতিটি গুগল ক্লাউড প্রজেক্টের জন্য রেজিস্ট্রেশন একটি এককালীন সেটআপ। আপনি একাধিক মার্চেন্ট অ্যাকাউন্ট নিয়ে কাজ করুন বা না করুন, আপনাকে রেজিস্ট্রেশন প্রক্রিয়াটি শুধুমাত্র একবারই করতে হবে এবং এটি লিঙ্ক করা গুগল ক্লাউড প্রজেক্টের অন্তর্ভুক্ত সমস্ত ব্যবহারকারী ও সার্ভিস অ্যাকাউন্টের জন্য প্রযোজ্য হবে।
একটি গুগল ক্লাউড প্রজেক্ট সফলভাবে রেজিস্টার করা হয়ে গেলে, ` 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) রেজিস্ট্রেশনের জন্য ভেরিফিকেশনই হলো প্রধান শর্ত।
অ্যাকাউন্ট এবং প্রকল্প ব্যবস্থাপনা
অ্যাকাউন্ট ও প্রজেক্ট ম্যানেজমেন্ট সম্পর্কিত সাধারণ প্রশ্নাবলী:
আমি একাধিক মার্চেন্ট সেন্টার অ্যাকাউন্ট নিয়ে কাজ করি। মার্চেন্ট এপিআই-এর সাথে ব্যবহার করতে চাই এমন প্রতিটি মার্চেন্ট সেন্টার অ্যাকাউন্ট কি আমাকে রেজিস্টার করতে হবে?
না। আপনি যদি একজন থার্ড-পার্টি ডেভেলপার বা এমন কোনো এজেন্সি হন যা একাধিক মার্চেন্টের অ্যাকাউন্ট পরিচালনা করে, তাহলে আপনি আপনার গুগল ক্লাউড প্রজেক্টটি আপনার নিজের প্রধান মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে রেজিস্টার করবেন, আপনার প্রতিটি মার্চেন্টের অ্যাকাউন্টের সাথে নয়। এইভাবে, আপনি আপনার মার্চেন্টদের জন্য করা সমস্ত এপিআই (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 রোলটি পান, যা গুরুত্বপূর্ণ নোটিফিকেশন পাওয়ার জন্য প্রয়োজন। তবে, মার্চেন্ট সেন্টারের মধ্যে তার অনুমতি খুবই সীমিত। এই ব্যবহারকারীকে অন্যান্য এপিআই কল করতে বা মার্চেন্ট সেন্টার UI-তে সেটিংস পরিচালনা করার অনুমতি দিতে, আপনাকে তাকে STANDARD বা ADMIN -এর মতো অতিরিক্ত রোল প্রদান করতে হবে। মার্চেন্ট সেন্টারের রোলগুলো সম্পর্কে আরও তথ্যের জন্য, অ্যাক্সেস টাইপস (Access types) দেখুন।
" API developer " রোলটির কী কী অনুমতি রয়েছে?
মার্চেন্ট সেন্টারে API developer রোলের অধিকার খুবই সীমিত। আপনি যদি মার্চেন্ট এপিআই-তে কল অনুমোদনের জন্য ডেভেলপারের কন্টাক্ট ইমেল ব্যবহার করার পরিকল্পনা করেন, তবে আমরা ব্যবহারকারীকে এপিআই কল করার সুযোগ দিতে ADMIN বা STANDARD পারমিশন যোগ করার পরামর্শ দিই।
এপিআই কলকারী প্রতিটি ডেভেলপার ব্যবহারকারী বা পরিষেবা অ্যাকাউন্ট কি নিবন্ধন করতে হবে?
না। ডেভেলপার রেজিস্ট্রেশনটি এপিআই কল করার জন্য ব্যবহৃত গুগল ক্লাউড প্রজেক্টের সাথে সংযুক্ত থাকে, কোনো স্বতন্ত্র ব্যবহারকারী বা সার্ভিস অ্যাকাউন্টের সাথে নয়। আপনার প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে একটি গুগল ক্লাউড প্রজেক্ট সফলভাবে রেজিস্টার হয়ে গেলে, আপনি মার্চেন্ট এপিআই কল অনুমোদন করার জন্য OAuth ক্রেডেনশিয়াল বা সার্ভিস অ্যাকাউন্ট ব্যবহার করে লিঙ্ক করা গুগল ক্লাউড প্রজেক্টের মাধ্যমে পরিচালিত যেকোনো আইডেন্টিটি ব্যবহার করতে পারবেন, যদি সেগুলো আপনার মার্চেন্ট সেন্টারে বিদ্যমান থাকে এবং সেগুলোতে ADMIN রোল অ্যাসাইন করা থাকে।
প্রাথমিক নিবন্ধনের পর আমি কীভাবে ডেভেলপার যোগাযোগের ইমেল পরিবর্তন করব?
যোগাযোগ পরিচালনা বা পরিবর্তন করতে, স্ট্যান্ডার্ড accounts.users পরিষেবা অথবা মার্চেন্ট সেন্টার UI-এর "অ্যাক্সেস এবং পরিষেবা" পৃষ্ঠা ব্যবহার করে API developer ভূমিকা সহ ব্যবহারকারীদের যুক্ত বা অপসারণ করুন।
মার্চেন্ট সেন্টার অ্যাকাউন্ট থেকে সর্বশেষ " API developer " ব্যবহারকারীকে সরিয়ে দেওয়া হলে কী হবে?
তাৎক্ষণিক পরিষেবা বিঘ্ন এড়ানোর জন্য ৩০ দিনের একটি অতিরিক্ত সময়সীমা চালু করা হয়। এই সময়ে:
- অ্যাডমিনরা ইমেলের মাধ্যমে তিনটি বাধ্যতামূলক পরিষেবা সংক্রান্ত ঘোষণা পাবেন (সাধারণত ব্লক করার প্রায় ৩০, ১৭ এবং ৪ দিন আগে)।
- এপিআই কলগুলো স্বাভাবিকভাবে কাজ করতে থাকবে।
- গ্রেস পিরিয়ড শেষ হওয়ার আগে যদি কোনো নতুন
API developerযুক্ত না করা হয়, তাহলে সংশ্লিষ্ট গুগল ক্লাউড প্রজেক্টগুলো থেকে এপিআই কলগুলোAUTH_GCP_NOT_REGISTEREDএরর দেখিয়ে ব্লক করে দেওয়া হবে।
৩০ দিনের গ্রেস পিরিয়ড শেষ হয়ে গেলে, সংশ্লিষ্ট গুগল ক্লাউড প্রজেক্টগুলো থেকে এপিআই কল ব্লক হয়ে যায় এবং একটি বৈধ ডেভেলপার কন্টাক্ট পুনরুদ্ধার না করা পর্যন্ত সেগুলোতে AUTH_GCP_NOT_REGISTERED এরর দেখা যায়।
যে মার্চেন্ট সেন্টার আইডিতে ডেভেলপার রেজিস্ট্রেশন করা হয়েছে, সেটি মুছে ফেলা হলে কী হবে?
আপনার ইন্টিগ্রেশন সক্রিয় থাকা অবস্থায় ডেভেলপার রেজিস্ট্রেশনের জন্য ব্যবহৃত মার্চেন্ট সেন্টার অ্যাকাউন্টটি ডিলিট করবেন না। এই অ্যাকাউন্টটি ডিলিট করলে আপনার ইন্টিগ্রেশনটি তাৎক্ষণিকভাবে অকার্যকর হয়ে যাবে এবং আপনি সংশ্লিষ্ট গুগল ক্লাউড প্রজেক্ট থেকে আর এপিআই কল করতে পারবেন না।
যদি আপনাকে সেই মার্চেন্ট সেন্টার অ্যাকাউন্টটি ডিলিট করতেই হয়, তবে প্রথমে লিঙ্কটি নিরাপদে সরানোর জন্য unregisterGcp মেথডটি কল করুন এবং তারপরেই মার্চেন্ট সেন্টার আইডিটি ডিলিট করার জন্য অগ্রসর হন। যদি আপনি মার্চেন্ট এপিআই ব্যবহার করা চালিয়ে যেতে চান, তবে বর্তমানটি আনরেজিস্টার করার ঠিক পরেই আপনাকে অন্য একটি মার্চেন্ট সেন্টার আইডি দিয়ে রেজিস্টার করতে হবে। শুধুমাত্র তারপরেই মার্চেন্ট সেন্টার আইডিটি ডিলিট করার জন্য অগ্রসর হন।
আমি মার্চেন্ট সেন্টারে " API developer " রোলটি দেখতে পাচ্ছি না কেন?
প্রদত্ত মার্চেন্ট সেন্টার অ্যাকাউন্টের জন্য ডেভেলপার রেজিস্ট্রেশন সম্পন্ন করার পরেই মার্চেন্ট সেন্টার UI-তে API developer রোলটি দেখা যায়। রেজিস্ট্রেশনবিহীন মার্চেন্ট সেন্টার অ্যাকাউন্টগুলোতে API developer রোলটি দেখা যায় না।
বিশেষ ব্যবহারের ক্ষেত্র
বিশেষ ব্যবহারের ক্ষেত্র সম্পর্কে সাধারণ প্রশ্নাবলী:
আমি একটি এজেন্সি বা থার্ড-পার্টি ডেভেলপার হিসেবে একাধিক মার্চেন্ট অ্যাকাউন্ট পরিচালনা করি। এটি সেট আপ করার সেরা উপায় কী?
তৃতীয় পক্ষের ডেভেলপার এবং এজেন্সিগুলোর নিজস্ব একটি প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্ট থাকা উচিত এবং তাদের সমস্ত গুগল ক্লাউড প্রজেক্ট সেই একটিমাত্র কেন্দ্রীভূত অ্যাকাউন্টে রেজিস্টার করা উচিত। প্রতিটি স্বতন্ত্র মার্চেন্টের অ্যাকাউন্টে আপনার গুগল ক্লাউড প্রজেক্ট রেজিস্টার করবেন না।
গুগল অ্যাপ স্ক্রিপ্টসের জন্য নিবন্ধন কীভাবে কাজ করে?
অ্যাপ স্ক্রিপ্টগুলো সাধারণত একটি ডিফল্ট গুগল ক্লাউড প্রজেক্টে চলে। আপনাকে অবশ্যই আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে এই ডিফল্ট গুগল ক্লাউড আইডিটি রেজিস্টার করতে হবে। গুগল ক্লাউড আইডিটি এপিআই (API) দ্বারা স্বয়ংক্রিয়ভাবে সংগ্রহ করা হয়, তাই আপনাকে এটি প্যারামিটার হিসেবে প্রদান করতে হবে না।
আমি কি যাচাই করতে পারি যে কোনো মার্চেন্ট সেন্টার আইডি একটি নির্দিষ্ট গুগল ক্লাউড প্রজেক্ট আইডিতে নিবন্ধিত আছে কি না?
হ্যাঁ। আপনি getAccountForGcpRegistration মেথডটি ব্যবহার করে দেখতে পারেন কোন মার্চেন্ট সেন্টার আইডি একটি নির্দিষ্ট গুগল ক্লাউড প্রজেক্টে রেজিস্টার করা আছে। আপনার মার্চেন্ট সেন্টার অ্যাকাউন্ট থেকে গুগল ক্লাউড প্রজেক্টের লিঙ্কটি সরাতে, unregisterGcp মেথডটি ব্যবহার করুন।
Shopify ব্যবহারকারীদের জন্য Google ও YouTube অ্যাপে Content API থেকে Merchant API-তে মাইগ্রেশন
তৃতীয় পক্ষের প্ল্যাটফর্ম এবং অ্যাপের জন্য কন্টেন্ট এপিআই থেকে মার্চেন্ট এপিআই-তে মাইগ্রেশন সম্পর্কিত সাধারণ প্রশ্নাবলী:
কন্টেন্ট এপিআই থেকে মার্চেন্ট এপিআই-তে মাইগ্রেট করার জন্য আমাকে কি কিছু করতে হবে?
কোনো পদক্ষেপের প্রয়োজন নেই। আপনি যদি আপনার মার্চেন্ট সেন্টার ফিডগুলি পরিচালনা করার জন্য Shopify-তে Google এবং YouTube অ্যাপ ব্যবহার করেন, তাহলে কন্টেন্ট এপিআই থেকে মার্চেন্ট এপিআই-তে মাইগ্রেশনের কাজটি Google-ই করবে।
মাইগ্রেশনের ফলে কি আমার প্রোডাক্ট আইডিগুলো পরিবর্তিত হবে?
না, এই মাইগ্রেশন আপনার মার্চেন্ট সেন্টার ফিডে থাকা প্রোডাক্ট আইডিগুলো পরিবর্তন করে না।
রূপান্তরটি সম্পন্ন করতে আমাকে কি Shopify-তে Google ও YouTube অ্যাপ পুনরায় ইনস্টল করতে হবে?
এই পরিবর্তনটি সম্পন্ন করার জন্য আপনার পক্ষ থেকে কোনো পদক্ষেপ নেওয়ার প্রয়োজন নেই। আপনাকে গুগল ও ইউটিউব অ্যাপ পুনরায় ইনস্টল করতে হবে না।
আমি এখনও মার্চেন্ট সেন্টারে কন্টেন্ট এপিআই ডেটা সোর্সগুলো কেন খুঁজে পাই?
মার্চেন্ট এপিআই-তে রূপান্তরের সময়ও মার্চেন্ট সেন্টারে কন্টেন্ট এপিআই ডেটা সোর্সগুলো দেখা যেতে পারে। এমনটা হওয়া স্বাভাবিক এবং এর জন্য আপনার পক্ষ থেকে কোনো পদক্ষেপের প্রয়োজন নেই।
,এই বিভাগে মার্চেন্ট এপিআই-এর ডেভেলপার রেজিস্ট্রেশন সংক্রান্ত সাধারণ প্রশ্নগুলির আলোচনা করা হয়েছে।
সাধারণ নিবন্ধন
নিবন্ধন প্রক্রিয়া সম্পর্কে সাধারণ প্রশ্নাবলী:
মার্চেন্ট এপিআই ব্যবহার করার জন্য ডেভেলপার নিবন্ধন কি বাধ্যতামূলক?
হ্যাঁ। আপনাকে অবশ্যই আপনার ডেভেলপার যোগাযোগের তথ্য নিবন্ধন করতে হবে, যাতে গুগল আপনাকে এপিআই-সম্পর্কিত গুরুত্বপূর্ণ আপডেট, যেমন পরিষেবা ঘোষণা এবং নতুন ফিচারের তথ্য পাঠাতে পারে।
আপনি যদি শুধু মার্চেন্ট এপিআই অন্বেষণ ও পরীক্ষা করতে চান, তাহলে গুগল ওঅথ প্লেগ্রাউন্ড এবং এপিআই এক্সপ্লোরারের মতো টুল ব্যবহার করতে পারেন, যেগুলোর জন্য নিবন্ধনের প্রয়োজন হয় না।
আমাকে কত ঘন ঘন নিবন্ধন করতে হবে?
প্রতিটি গুগল ক্লাউড প্রজেক্টের জন্য রেজিস্ট্রেশন একটি এককালীন সেটআপ। আপনি একাধিক মার্চেন্ট অ্যাকাউন্ট নিয়ে কাজ করুন বা না করুন, আপনাকে রেজিস্ট্রেশন প্রক্রিয়াটি শুধুমাত্র একবারই করতে হবে এবং এটি লিঙ্ক করা গুগল ক্লাউড প্রজেক্টের অন্তর্ভুক্ত সমস্ত ব্যবহারকারী ও সার্ভিস অ্যাকাউন্টের জন্য প্রযোজ্য হবে।
একটি গুগল ক্লাউড প্রজেক্ট সফলভাবে রেজিস্টার করা হয়ে গেলে, ` 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) রেজিস্ট্রেশনের জন্য ভেরিফিকেশনই হলো প্রধান শর্ত।
অ্যাকাউন্ট এবং প্রকল্প ব্যবস্থাপনা
অ্যাকাউন্ট ও প্রজেক্ট ম্যানেজমেন্ট সম্পর্কিত সাধারণ প্রশ্নাবলী:
আমি একাধিক মার্চেন্ট সেন্টার অ্যাকাউন্ট নিয়ে কাজ করি। মার্চেন্ট এপিআই-এর সাথে ব্যবহার করতে চাই এমন প্রতিটি মার্চেন্ট সেন্টার অ্যাকাউন্ট কি আমাকে রেজিস্টার করতে হবে?
না। আপনি যদি একজন থার্ড-পার্টি ডেভেলপার বা এমন কোনো এজেন্সি হন যা একাধিক মার্চেন্টের অ্যাকাউন্ট পরিচালনা করে, তাহলে আপনি আপনার গুগল ক্লাউড প্রজেক্টটি আপনার নিজের প্রধান মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে রেজিস্টার করবেন, আপনার প্রতিটি মার্চেন্টের অ্যাকাউন্টের সাথে নয়। এইভাবে, আপনি আপনার মার্চেন্টদের জন্য করা সমস্ত এপিআই (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 রোলটি পান, যা গুরুত্বপূর্ণ নোটিফিকেশন পাওয়ার জন্য প্রয়োজন। তবে, মার্চেন্ট সেন্টারের মধ্যে তার অনুমতি খুবই সীমিত। এই ব্যবহারকারীকে অন্যান্য এপিআই কল করতে বা মার্চেন্ট সেন্টার UI-তে সেটিংস পরিচালনা করার অনুমতি দিতে, আপনাকে তাকে STANDARD বা ADMIN -এর মতো অতিরিক্ত রোল প্রদান করতে হবে। মার্চেন্ট সেন্টারের রোলগুলো সম্পর্কে আরও তথ্যের জন্য, অ্যাক্সেস টাইপস (Access types) দেখুন।
" API developer " রোলটির কী কী অনুমতি রয়েছে?
মার্চেন্ট সেন্টারে API developer রোলের অধিকার খুবই সীমিত। আপনি যদি মার্চেন্ট এপিআই-তে কল অনুমোদনের জন্য ডেভেলপারের কন্টাক্ট ইমেল ব্যবহার করার পরিকল্পনা করেন, তবে আমরা ব্যবহারকারীকে এপিআই কল করার সুযোগ দিতে ADMIN বা STANDARD পারমিশন যোগ করার পরামর্শ দিই।
এপিআই কলকারী প্রতিটি ডেভেলপার ব্যবহারকারী বা পরিষেবা অ্যাকাউন্ট কি নিবন্ধন করতে হবে?
না। ডেভেলপার রেজিস্ট্রেশনটি এপিআই কল করার জন্য ব্যবহৃত গুগল ক্লাউড প্রজেক্টের সাথে সংযুক্ত থাকে, কোনো স্বতন্ত্র ব্যবহারকারী বা সার্ভিস অ্যাকাউন্টের সাথে নয়। আপনার প্রাথমিক মার্চেন্ট সেন্টার অ্যাকাউন্টের সাথে একটি গুগল ক্লাউড প্রজেক্ট সফলভাবে রেজিস্টার হয়ে গেলে, আপনি মার্চেন্ট এপিআই কল অনুমোদন করার জন্য OAuth ক্রেডেনশিয়াল বা সার্ভিস অ্যাকাউন্ট ব্যবহার করে লিঙ্ক করা গুগল ক্লাউড প্রজেক্টের মাধ্যমে পরিচালিত যেকোনো আইডেন্টিটি ব্যবহার করতে পারবেন, যদি সেগুলো আপনার মার্চেন্ট সেন্টারে বিদ্যমান থাকে এবং সেগুলোতে ADMIN রোল অ্যাসাইন করা থাকে।
প্রাথমিক নিবন্ধনের পর আমি কীভাবে ডেভেলপার যোগাযোগের ইমেল পরিবর্তন করব?
যোগাযোগ পরিচালনা বা পরিবর্তন করতে, স্ট্যান্ডার্ড accounts.users পরিষেবা অথবা মার্চেন্ট সেন্টার UI-এর "অ্যাক্সেস এবং পরিষেবা" পৃষ্ঠা ব্যবহার করে API developer ভূমিকা সহ ব্যবহারকারীদের যুক্ত বা অপসারণ করুন।
মার্চেন্ট সেন্টার অ্যাকাউন্ট থেকে সর্বশেষ " API developer " ব্যবহারকারীকে সরিয়ে দেওয়া হলে কী হবে?
তাৎক্ষণিক পরিষেবা বিঘ্ন এড়ানোর জন্য ৩০ দিনের একটি অতিরিক্ত সময়সীমা চালু করা হয়। এই সময়ে:
- অ্যাডমিনরা ইমেলের মাধ্যমে তিনটি বাধ্যতামূলক পরিষেবা সংক্রান্ত ঘোষণা পাবেন (সাধারণত ব্লক করার প্রায় ৩০, ১৭ এবং ৪ দিন আগে)।
- এপিআই কলগুলো স্বাভাবিকভাবে কাজ করতে থাকবে।
- গ্রেস পিরিয়ড শেষ হওয়ার আগে যদি কোনো নতুন
API developerযুক্ত না করা হয়, তাহলে সংশ্লিষ্ট গুগল ক্লাউড প্রজেক্টগুলো থেকে এপিআই কলগুলোAUTH_GCP_NOT_REGISTEREDএরর দেখিয়ে ব্লক করে দেওয়া হবে।
৩০ দিনের গ্রেস পিরিয়ড শেষ হয়ে গেলে, সংশ্লিষ্ট গুগল ক্লাউড প্রজেক্টগুলো থেকে এপিআই কল ব্লক হয়ে যায় এবং একটি বৈধ ডেভেলপার কন্টাক্ট পুনরুদ্ধার না করা পর্যন্ত সেগুলোতে AUTH_GCP_NOT_REGISTERED এরর দেখা যায়।
যে মার্চেন্ট সেন্টার আইডিতে ডেভেলপার রেজিস্ট্রেশন করা হয়েছে, সেটি মুছে ফেলা হলে কী হবে?
Don't delete the Merchant Center account used for developer registration while your integration is active. Deleting this account immediately breaks your integration, and you will no longer be able to perform API calls from the associated Google Cloud project.
If you must delete that Merchant Center account, you should first call the unregisterGcp method to safely remove the link, and only then proceed with deleting the Merchant Center ID. If you want to keep using Merchant API, you need to register with another Merchant Center ID right after you unregister the current one. Only then proceed with deleting the Merchant Center ID.
Why can't I see the " API developer " role in Merchant Center?
The API developer role is only visible in the Merchant Center UI after the developer registration is performed for the given Merchant Center account. Merchant Center accounts without registrations don't see the API developer role.
Special Use Cases
Common questions about special use cases:
I am an agency or a third-party developer managing multiple merchant accounts. What is the best way to set this up?
Third party developers and agencies should maintain their own primary Merchant Center account and register all of their Google Cloud projects to that single, centralized account. Don't register your Google Cloud project with each individual merchant's account.
How does registration work for Google App Scripts?
App Scripts usually run on a default Google Cloud project. You must register this default Google Cloud ID with your Merchant Center account. The Google Cloud ID is obtained automatically by the API, so you don't need to provide it as a parameter.
Can I check if a Merchant Center ID is registered to a specific Google Cloud project ID?
Yes. You can check which Merchant Center ID is registered to a specific Google Cloud project by using the getAccountForGcpRegistration method. To remove a Google Cloud project link to your Merchant Center account, use the unregisterGcp method.
Content API to Merchant API migration for Google & YouTube app on Shopify users
Common questions about Content API to Merchant API migration for third-party platforms and apps:
Do I need to do anything to migrate from Content API to Merchant API?
No action needed. If you use the Google & YouTube app on Shopify to manage your Merchant Center feeds, the Content API to Merchant API migration will be handled by Google.
Will the migration change my product IDs?
No, the migration doesn't change the product IDs in your Merchant Center feeds.
Do I need to reinstall the Google & YouTube app on Shopify to complete the transition?
No action is required from you to complete the transition. You don't need to reinstall the Google & YouTube app.
Why do I still find Content API data sources in Merchant Center?
Content API data sources may still appear in Merchant Center during the transition to Merchant API. These instances are expected and require no action from you.