সরাসরি API কল

Merchant API-এর সাথে ইন্টার‍্যাক্ট করার এই পদ্ধতিতে, API এন্ডপয়েন্টে সরাসরি র-অনুরোধ করা হয়, সাধারণত HTTP(S)-এর মাধ্যমে। আপনি ম্যানুয়ালি বিভিন্ন দিক ম্যানেজ করেন, যেমন অনুরোধের বডি তৈরি করা, হেডার সেট করা (যাচাইকরণ সহ) এবং রেসপন্স পার্স করা।

ধাপ ১. ডেভেলপার হিসেবে রেজিস্টার করুন

Merchant API ব্যবহার করতে, আপনাকে অবশ্যই ডেভেলপারের যোগাযোগের তথ্য রেজিস্টার করতে হবে।

রেজিস্ট্রেশন করলে নিম্নলিখিত সুবিধা পাওয়া যায়:

  • ব্যবহারকারীকে API developer ভূমিকা অ্যাসাইন করার মাধ্যমে আপনার Merchant Center অ্যাকাউন্টের জন্য টেকনিক্যাল যোগাযোগ তৈরি করে। এর ফলে Google, API এবং ডেভেলপার যে ফিচার ব্যবহার করছেন সেই সম্পর্কে গুরুত্বপূর্ণ আপডেট পাঠাতে পারে, যেমন পরিষেবা সংক্রান্ত ঘোষণা এবং নতুন ফিচার সম্পর্কে তথ্য, যা ডেভেলপার নন এমন ব্যক্তিদের কাছে কম আগ্রহের হতে পারে।
  • একাধিকবার রেজিস্টার না করেই একাধিক মার্চেন্ট অ্যাকাউন্টের সাথে কাজ করার সুবিধা দেয়। আপনি রেজিস্টার করার সময়, Merchant API-তে যাচাই করার জন্য ব্যবহৃত Google Cloud প্রোজেক্ট আইডি আপনার Merchant Center অ্যাকাউন্টের সাথে যুক্ত করা হয়, যার মধ্যে টেকনিক্যাল কন্ট্যাক্ট (API developer) থাকে। এইভাবে, আপনি ম্যানেজ করেন এমন সব মার্চেন্ট অ্যাকাউন্টের জন্য গুরুত্বপূর্ণ আপডেট পেতে পারেন, যতক্ষণ না রেজিস্টার করা Google Cloud প্রোজেক্টের মাধ্যমে যাচাইকরণ সম্পূর্ণ হচ্ছে।

রেজিস্টার করার সময়, রেজিস্ট্রেশন লিঙ্কে দেওয়া পূর্বশর্ত ও বিধিনিষেধের বিবরণ ভাল করে দেখে নিন।

developerRegistration.registerGcp পদ্ধতি ব্যবহার করে রেজিস্টার করতে, আপনি এই উদাহরণ দিয়ে শুরু করতে পারেন, অনুরোধের বডিতে {DEVELOPER_EMAIL}-এর জায়গায় উপযুক্ত ইমেল আইডি লিখুন।

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

কল সফল হলে একটি DeveloperRegistration রিসোর্স রিটার্ন করে, যা আপনার প্রোজেক্ট ও অ্যাকাউন্টের মধ্যে লিঙ্ক কনফার্ম করে।

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

ধাপ ২. ডেভেলপারের পরিচিতি ও অনুমতি ম্যানেজ করুন

আপনি রেজিস্টার করলে:

  • ইমেল আইডিটি Merchant Center অ্যাকাউন্টের কোনও ব্যবহারকারীর হলে, সেই ব্যবহারকারীকে API_DEVELOPER ভূমিকা দেওয়া হয়।
  • ইমেল আইডিটি কোনও বর্তমান ব্যবহারকারীর না হলে, সেই আইডিতে একটি আমন্ত্রণ পাঠানো হয়। API_DEVELOPER ভূমিকায় নতুন ব্যবহারকারী হিসেবে যোগ করার জন্য প্রাপককে আমন্ত্রণ গ্রহণ করতে হবে।

প্রাথমিক রেজিস্ট্রেশনের পরে, আমরা আপনাকে একাধিক ডেভেলপার যোগ করতে এবং তাদের অতিরিক্ত অ্যাক্সেসের অধিকার দিতে সাজেস্ট করি।

ধাপ ২ক। অতিরিক্ত অনুমতি দিন

গুরুত্বপূর্ণ বিজ্ঞপ্তি পেতে API_DEVELOPER ভূমিকা প্রয়োজন, তবে Merchant Center-এ এর ন্যূনতম অনুমতি আছে। এই ব্যবহারকারীকে অন্যান্য API কল করার বা Merchant Center UI-তে সেটিংস ম্যানেজ করার অনুমতি দিতে, আপনাকে তাকে অতিরিক্ত ভূমিকা দিতে হবে, যেমন STANDARD বা ADMIN। আরও তথ্যের জন্য, অ্যাক্সেসের ধরন দেখুন।

আপনি accounts.users.patch পদ্ধতির মাধ্যমে ব্যবহারকারীর অ্যাক্সেস অধিকার আপডেট করতে পারবেন।

নিম্নলিখিত উদাহরণে দেখানো হয়েছে যে কীভাবে কোনও ব্যবহারকারীকে আপডেট করে তাকে ADMIN এবং API_DEVELOPER উভয় ভূমিকাই প্রদান করা যায়। এটি তাদের অ্যাকাউন্টটি সম্পূর্ণরূপে ম্যানেজ করতে দেয় এবং তারা API-সম্পর্কিত যোগাযোগও পাবে।

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

ধাপ ২খ. ব্যাক-আপ ডেভেলপার যোগ করুন

আপনার প্রাথমিক ডেভেলপার পরিচিতি আপনার সংস্থা ছেড়ে চলে গেলে আপনার API অ্যাক্সেস যাতে ব্যাহত না হয়, তার জন্য আপনাকে অন্তত একজন ব্যাক-আপ ডেভেলপার যোগ করতে হবে।

আপনি accounts.users.create পদ্ধতি ব্যবহার করে কোনও ব্যবহারকারীকে যোগ করতে পারেন অথবা accounts.users.patch ব্যবহার করে কোনও ব্যবহারকারীকে আপডেট করতে পারেন। আমরা এই ব্যবহারকারীকে ADMIN এবং API_DEVELOPER, দুটি ভূমিকাই দেওয়ার সাজেশন দিই।

ধাপ ৩. প্রাইমারি প্রোডাক্ট ডেটা সোর্স তৈরি করুন

প্রোডাক্ট যোগ করতে, আপনার একটি প্রাথমিক প্রোডাক্ট ডেটা সোর্স প্রয়োজন। আপনার অ্যাকাউন্টে প্রোডাক্ট যোগ করার জন্য ডেটা সোর্স কীভাবে তৈরি করবেন তা নিম্নলিখিত অনুরোধ থেকে জানতে পারবেন:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources

{
  "primaryProductDataSource": {
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

আপনার তৈরি করা Merchant Center অ্যাকাউন্টের আইডি দিয়ে {ACCOUNT_ID} প্রতিস্থাপন করুন।

এই অনুরোধটি সফলভাবে চালানোর পরে, আপনি নিম্নলিখিত উত্তর দেখতে পাবেন:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

name ফিল্ডের ভ্যালু কপি করুন। প্রোডাক্ট যোগ করার জন্য এটি প্রয়োজন হবে।

আপনি Merchant Center UI-তে এই ডেটা সোর্স দেখতে পারবেন। আরও তথ্যের জন্য, কীভাবে ডেটা সোর্স ট্যাব খুঁজে পাবেন দেখুন।

ধাপ ৪। প্রোডাক্ট যোগ করুন

ডেটা সোর্স তৈরি করার পরে, এতে প্রোডাক্ট যোগ করার চেষ্টা করুন। সঠিক ACCOUNT_ID প্রদান করে নিম্নলিখিত কমান্ড রান করুন। {DATASOURCE_NAME}-এর জায়গায় আগে কপি করা ভ্যালু লিখুন।

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

এই অনুরোধটি সফলভাবে চালানোর পরে, আপনি নিম্নলিখিত উত্তর দেখতে পাবেন:

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/en~US~tshirt-123",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "brand": "New brand",
    "gender": "MALE"
  }
}

নতুন তৈরি করা প্রোডাক্টের প্রোডাক্ট আইডি হল en~US~tshirt-123। আপনি accounts.products.get পদ্ধতি ব্যবহার করে এই প্রোডাক্ট সম্পর্কে বিবরণ পেতে পারেন। এছাড়াও, এই প্রোডাক্ট দেখতে আপনি Merchant Center UI ব্যবহার করতে পারবেন। আপনার প্রোডাক্ট ডেটা দেখার ব্যাপারে আরও তথ্যের জন্য, Merchant Center-এ প্রোডাক্টের ওভারভিউ দেখুন।