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

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

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

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

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

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

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

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

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

শুরু করার আগে

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

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

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

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

  • Link your Merchant Center account to the Google Cloud project by registering as a developer . The users with the API developer role will receive API communications, including mandatory service announcements, developer surveys, and opportunities.

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

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

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

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

Merchant API uses resource names instead of IDs for identification. An example resource name for a product can be accounts/123456/products/en~US~sku123 , where 123456 is the unique identifier of the account and en~US~sku123 is the unique identifier of the product.

অনুরোধ 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 (প্রস্তাবিত) বিশ্রাম
  1. অনুরোধের মূল অংশটিকে একটি প্রোটোকল বাফার হিসেবে তৈরি করুন।
  2. HTTP/2 ব্যবহার করে সার্ভারে অনুরোধের মূল অংশটি পাঠান।
  3. প্রতিক্রিয়াটিকে একটি প্রোটোকল বাফারে ডিসিরিয়ালাইজ করুন।
  4. ফলাফলগুলো ব্যাখ্যা করুন।
  1. অনুরোধের মূল অংশটি একটি JSON অবজেক্ট হিসেবে তৈরি করুন।
  2. HTTP 1.1 ব্যবহার করে এটি সার্ভারে পাঠান।
  3. প্রতিক্রিয়াটিকে একটি JSON অবজেক্ট হিসাবে ডিসিরিয়ালাইজ করুন।
  4. ফলাফলগুলো ব্যাখ্যা করুন।

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

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

সাহায্য নিন

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

মতামত দিন

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

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

এরপর কী?