বণিক API এর ওভারভিউ

আপনি মার্চেন্ট এপিআই ব্যবহার করতে পারেন

• গুগলে আপনার ব্যবসা ও পণ্যগুলো কীভাবে প্রদর্শিত হবে তা পরিচালনা করুন।
• ডেটা, অন্তর্দৃষ্টি এবং অনন্য সক্ষমতাগুলিতে প্রোগ্রাম্যাটিক অ্যাক্সেস পান।
• আপনার ব্যবসার প্রসার ঘটান এবং গুগলে আরও বেশি গ্রাহকের কাছে পৌঁছান।

মার্চেন্ট এপিআই বড় বা জটিল মার্চেন্ট সেন্টার অ্যাকাউন্টগুলো পরিচালনা করতে পারে। এর সাধারণ ব্যবহারগুলোর মধ্যে নিম্নলিখিতগুলো অন্তর্ভুক্ত:

• স্বয়ংক্রিয় অ্যাকাউন্ট ব্যবস্থাপনা
• স্বয়ংক্রিয় পণ্য ব্যবস্থাপনা
• স্বয়ংক্রিয় ইনভেন্টরি ব্যবস্থাপনা
• কর্মক্ষমতা এবং বাজার সম্পর্কিত তথ্যের স্বয়ংক্রিয় প্রতিবেদন ব্যবস্থাপনা

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

মার্চেন্ট এপিআই হলো শপিং-এর জন্য কন্টেন্ট এপিআই -এর একটি নতুন ডিজাইন । এটি একাধিক সাব-এপিআই নিয়ে গঠিত।

দ্রষ্টব্য: খুচরা বিক্রেতারা শপিং বিজ্ঞাপন এবং বিনামূল্যে তালিকাভুক্তির নীতিমালা মেনে চলতে দায়বদ্ধ। যদি গুগল শপিং এই নীতিমালা লঙ্ঘনকারী কোনো বিষয়বস্তু বা আচরণ খুঁজে পায়, তবে এই নীতিমালাগুলো প্রয়োগ করার এবং যথাযথভাবে ব্যবস্থা নেওয়ার অধিকার সংরক্ষণ করে।

মার্চেন্ট এপিআই-তে নতুন কী আছে

মার্চেন্ট এপিআই-তে আপগ্রেড করার কয়েকটি কারণ নিচে দেওয়া হলো:

• নিম্নলিখিত নতুন পদ্ধতিগুলোর প্রবর্তনের মাধ্যমে মজুদ তথ্যের উন্নততর ব্যবস্থাপনা:

  • accounts.products.localInventories.delete
  • accounts.products.localInventories.list
  • accounts.products.regionalInventories.delete
  • accounts.products.regionalInventories.list

• পরিপূরক ডেটা উৎস তৈরি ও পুনরুদ্ধার করার মাধ্যমে এবং প্রাথমিক ডেটা উৎসের সাথে পরিপূরক ডেটা উৎস সংযুক্ত করার মাধ্যমে এর ব্যবস্থাপনা সক্ষম করে।

• আপনার পণ্যের ডেটার পরিবর্তনের জন্য নোটিফিকেশন চালু করে, যার ফলে পণ্যের স্ট্যাটাস পরিবর্তিত হলে আপনাকে অবহিত করার মাধ্যমে নির্দিষ্ট সময় পর পর ডেটা আনার প্রয়োজন হয় না।

• অটোফিড সেটিংস পুনরুদ্ধার এবং আপডেট করার জন্য accounts.autofeedSettings রিসোর্স এবং মেথডগুলো চালু করা হয়েছে।

• পণ্যের রিভিউ এবং মার্চেন্ট রিভিউ আপলোড করার সুবিধা চালু করা হয়েছে।

• accounts.productInputs রিসোর্সকে সরল করার জন্য accounts.products রিসোর্সটি চালু করা হয়েছে।

• ফাইলের মতো অন্যান্য ডেটা আপলোড পদ্ধতির পাশাপাশি পণ্যের ডেটা আপডেট করার সুবিধা দেয়।

• খুচরা বিক্রেতার ওয়েবসাইটে আগত ট্র্যাফিকের তথ্যের মতো পণ্য-বহির্ভূত পারফরম্যান্স ডেটার জন্য নতুন NonProductPerformanceView টেবিল।

• বিচ্ছিন্ন এবং আরও ঘন ঘন বৈশিষ্ট্য উন্নতির সাথে মডুলার ডিজাইন

• আপডেট করা ডকুমেন্টেশন এবং কোড স্যাম্পল

• গুগলের এপিআই উন্নয়ন প্রস্তাবনাগুলোর সাথে আরও ভালো সামঞ্জস্য

• ডেভেলপার রেজিস্ট্রেশনের মাধ্যমে ডেভেলপারদের জন্য উন্নততর সহায়তা ও যোগাযোগ ব্যবস্থা।

শুরু করার আগে

মার্চেন্ট এপিআই অনুরোধ চালানোর জন্য আপনার নিম্নলিখিত জিনিসগুলো থাকা আবশ্যক:

• মার্চেন্ট সেন্টার অ্যাকাউন্ট : এই অ্যাকাউন্টেই আপনি ডেটা অনুসন্ধান, আপডেট এবং আপলোড করবেন। নিশ্চিত করুন যে এই অ্যাকাউন্টে পণ্য এবং ইনভেন্টরি পরিচালনা করার জন্য আপনার প্রয়োজনীয় অনুমতি রয়েছে।

• একটি গুগল ক্লাউড প্রজেক্ট: আপনার অ্যাকাউন্টের এপিআই (API) অ্যাক্সেস পেতে প্রজেক্টটি ব্যবহার করুন।

• আপনার মার্চেন্ট সেন্টার অ্যাকাউন্ট থেকে গুগল ক্লাউড প্রজেক্টে একটি লিঙ্ক। ডেভেলপার রেজিস্ট্রেশন মেথডটি কল করে লিঙ্কটি তৈরি করুন। আপনি এপিআই ইন্টিগ্রেশন, সার্ভে এবং অপরচুনিটি সংক্রান্ত যোগাযোগের জন্য এই অ্যাকাউন্ট এবং এই ইউজারদের ব্যবহার করবেন।

দ্রষ্টব্য: আপনি যদি একজন পার্টনার হন এবং আপনার কোনো মার্চেন্ট সেন্টার অ্যাকাউন্ট না থাকে, তাহলে আপনাকে একটি মার্চেন্ট অ্যাকাউন্ট তৈরি ও সেট আপ করতে হবে। এর মধ্যে অন্তত একজন এপিআই ডেভেলপার ইউজার যুক্ত করাও অন্তর্ভুক্ত, যিনি ইন্টিগ্রেশনের জন্য প্রধান দায়িত্বপ্রাপ্ত ব্যক্তি।

• ডেভেলপার হিসেবে নিবন্ধন করে আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টটি গুগল ক্লাউড প্রজেক্টের সাথে লিঙ্ক করুন। এপিআই ডেভেলপার ভূমিকা থাকা ব্যবহারকারীরা এপিআই সংক্রান্ত যোগাযোগ পাবেন, যার মধ্যে বাধ্যতামূলক পরিষেবা ঘোষণা, ডেভেলপার সমীক্ষা এবং সুযোগ অন্তর্ভুক্ত থাকবে।

দ্রষ্টব্য: আপনি যদি একজন পার্টনার হন এবং আপনার কোনো মার্চেন্ট সেন্টার অ্যাকাউন্ট না থাকে, তাহলে আপনাকে একটি মার্চেন্ট অ্যাকাউন্ট তৈরি ও সেট আপ করতে হবে। এর মধ্যে রেজিস্ট্রেশন প্রক্রিয়ার সময় অন্তত একজন এপিআই ডেভেলপার ইউজার যুক্ত করাও অন্তর্ভুক্ত, যিনি ইন্টিগ্রেশনের জন্য প্রধানত দায়িত্বপ্রাপ্ত থাকবেন।

মার্চেন্ট এপিআই দিয়ে প্রমাণীকরণ

প্রমাণীকরণের জন্য আপনি নিম্নলিখিত বিকল্পগুলি ব্যবহার করতে পারেন:

• আপনি আপনার অ্যাপের জন্য একটি OAuth 2.0 ক্লায়েন্ট আইডি এবং সিক্রেট তৈরি করতে পারেন। এরপর এই আইডি এবং সিক্রেট ব্যবহার করে মার্চেন্ট সেন্টার অ্যাকাউন্টে এপিআই (API) কল করার জন্য প্রয়োজনীয় OAuth 2.0 ক্রেডেনশিয়াল তৈরি করা যাবে।
• আপনি একটি সার্ভিস অ্যাকাউন্ট তৈরি করে এপিআই কল করার জন্য এর প্রাইভেট কী ডাউনলোড করতে পারেন।

অ্যাকাউন্ট এবং পণ্য শনাক্তকারী

মার্চেন্ট এপিআই শনাক্তকরণের জন্য আইডির পরিবর্তে রিসোর্স নেম ব্যবহার করে। একটি পণ্যের জন্য রিসোর্স নেমের উদাহরণ হতে পারে accounts/123456/products/en~US~sku123 , যেখানে 123456 হলো অ্যাকাউন্টের অনন্য শনাক্তকারী এবং en~US~sku123 হলো পণ্যের অনন্য শনাক্তকারী।

অনুরোধ URL ফরম্যাট

কোনো রিসোর্সের ওপর কাজ করতে, নিম্নলিখিত বিন্যাসে URL-গুলিতে অনুরোধ পাঠান:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

list এবং get-এর মতো স্ট্যান্ডার্ড মেথডগুলোর ক্ষেত্রে :{METHOD} অংশটি বাদ দেওয়া হয়।

উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধটি আঞ্চলিক ইনভেন্টরি মুছে দেয়:

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/online~en~US~sku123/regionalInventories/456

একটি রিসোর্স তৈরি করতে, প্যারেন্ট রিসোর্সের রিসোর্স নেম এবং এই URL-টি ব্যবহার করুন:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধটি দেখায় যে আপনি কীভাবে accounts/123456 এর জন্য একটি অঞ্চল তৈরি করতে পারেন:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

নির্দিষ্ট পরিষেবাগুলো সম্পর্কে আরও বিস্তারিত জানতে, মার্চেন্ট এপিআই রেফারেন্স ডকুমেন্টেশন দেখুন।

মার্চেন্ট এপিআই ব্যবহার শুরু করুন

মার্চেন্ট এপিআই কীভাবে কাজ করে তা দ্রুত দেখতে এবং একটি নমুনা পণ্য আপলোড করে দেখতে, “মার্চেন্ট এপিআই দিয়ে শুরু করুন” দেখুন।

gRPC বা REST ব্যবহার করুন

মার্চেন্ট এপিআই gRPC এবং REST সমর্থন করে। মার্চেন্ট এপিআই কল করার দুটি উপায় নিচে দেওয়া হলো:

gRPC (প্রস্তাবিত)	বিশ্রাম
অনুরোধের মূল অংশটিকে একটি প্রোটোকল বাফার হিসেবে তৈরি করুন। HTTP/2 ব্যবহার করে সার্ভারে অনুরোধের মূল অংশটি পাঠান। প্রতিক্রিয়াটিকে একটি প্রোটোকল বাফারে ডিসিরিয়ালাইজ করুন। ফলাফলগুলো ব্যাখ্যা করুন।	অনুরোধের মূল অংশটি একটি JSON অবজেক্ট হিসেবে তৈরি করুন। HTTP 1.1 ব্যবহার করে এটি সার্ভারে পাঠান। প্রতিক্রিয়াটিকে একটি JSON অবজেক্ট হিসাবে ডিসিরিয়ালাইজ করুন। ফলাফলগুলো ব্যাখ্যা করুন।

দ্রষ্টব্য: আপনি যদি কোনো ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে ডিফল্ট ট্রান্সপোর্ট মেকানিজম হলো gRPC। বেশিরভাগ ক্ষেত্রে gRPC ব্যবহার করার জন্য মার্চেন্ট এপিআই এন্ডপয়েন্টগুলো কল করা ছাড়া আপনার আর কিছু করার প্রয়োজন নেই।

ক্লায়েন্ট লাইব্রেরি এবং কোড নমুনা ব্যবহার করুন

প্রতিটি সাব-এপিআই-এর নিজস্ব ক্লায়েন্ট লাইব্রেরি রয়েছে যা আপনাকে কাজ শুরু করতে সাহায্য করবে। কোড স্যাম্পলগুলো আপনাকে জাভা, পিএইচপি এবং পাইথনে কোড লেখা শুরু করতে সাহায্য করবে। আরও তথ্যের জন্য, মার্চেন্ট এপিআই-এর স্যাম্পলগুলো দেখুন।

সাহায্য নিন

সহায়তা পাওয়ার তথ্যের জন্য, ‘মার্চেন্ট এপিআই (Merchant API) বিষয়ে সাহায্য নিন’ দেখুন।

মতামত দিন

মতামত জানাতে, নিম্নলিখিতগুলির মধ্যে যেকোনো একটি জমা দিন:

• এপিআই বৈশিষ্ট্য: ফিডব্যাক ফর্মের 'সমস্যা/প্রশ্ন কী?' অংশের অধীনে ' ফিডব্যাক পাঠান ' বিকল্পটি নির্বাচন করুন।
• ডকুমেন্টেশন: পেজের ভেতরে থাকা থাম্ব রেটিং এবং সেন্ড ফিডব্যাক বাটন ব্যবহার করুন।
• স্যাম্পল ও লাইব্রেরি: কোড স্যাম্পলগুলোর জন্য গিটহাব রিপোজিটরিতে একটি ইস্যু তৈরি করুন ।

এরপর কী?

• ব্যাকওয়ার্ড কম্প্যাটিবিলিটি এবং শপিং-এর জন্য কন্টেন্ট এপিআই-এর কম্প্যাটিবিলিটি সম্পর্কে তথ্যের জন্য।

• মার্চেন্ট এপিআই-এর প্রধান বৈশিষ্ট্যগুলো সম্পর্কে আরও জানতে বাম দিকের নেভিগেশন মেনুতে থাকা গাইডগুলো দেখুন।

• উপলব্ধ সম্পদ ও পরিষেবা সম্পর্কে তথ্যের জন্য, রেফারেন্স ডকুমেন্টেশন দেখুন।