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

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

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

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

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

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

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

মার্চেন্ট API-তে নতুন কী আছে?

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

শুরু করার আগে

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

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

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

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

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

মার্চেন্ট API এর মাধ্যমে প্রমাণীকরণ

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

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

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

মার্চেন্ট API শনাক্তকরণের জন্য ID-এর পরিবর্তে রিসোর্স নাম ব্যবহার করে। একটি পণ্যের জন্য একটি উদাহরণ রিসোর্স নাম হতে পারে 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"
  }
}

নির্দিষ্ট পরিষেবা সম্পর্কে আরও তথ্যের জন্য, মার্চেন্ট API রেফারেন্স ডকুমেন্টেশন দেখুন।

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

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

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

Merchant API gRPC এবং REST সমর্থন করে। Merchant API কল করার দুটি উপায় এখানে দেওয়া হল:

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

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

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

সাহায্য পান

সহায়তা পাওয়ার বিষয়ে তথ্যের জন্য, মার্চেন্ট API এর সাহায্য পান দেখুন।

মতামত দিন

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

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

এরপর কি?