সরাসরি API কল

মার্চেন্ট এপিআই-এর সাথে ইন্টারঅ্যাক্ট করার এই পদ্ধতিতে, সাধারণত HTTP(S) এর মাধ্যমে সরাসরি এপিআই এন্ডপয়েন্টগুলিতে র' রিকোয়েস্ট পাঠানো হয়। রিকোয়েস্ট বডি তৈরি করা, হেডার (অথেনটিকেশন সহ) সেট করা এবং রেসপন্স পার্স করার মতো বিষয়গুলি আপনাকে ম্যানুয়ালি সামলাতে হয়।

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

মার্চেন্ট এপিআই ব্যবহার করতে হলে আপনাকে আপনার ডেভেলপার যোগাযোগের তথ্য নিবন্ধন করতে হবে।

নিবন্ধনের মাধ্যমে নিম্নলিখিত বিষয়গুলো সম্পন্ন হয়:

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

নিবন্ধন করার সময়, নিবন্ধন অংশে বিস্তারিত পূর্বশর্ত এবং সীমাবদ্ধতাগুলো মেনে চলুন।

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"
  ]
}

ধাপ ২. ডেভেলপারদের যোগাযোগ এবং অনুমতি পরিচালনা করুন

যখন আপনি নিবন্ধন করবেন:

• যদি ইমেল ঠিকানাটি মার্চেন্ট সেন্টার অ্যাকাউন্টের কোনো ব্যবহারকারীর হয়, তাহলে সেই ব্যবহারকারীকে API_DEVELOPER রোলটি প্রদান করা হয়।
• If the email address doesn't belong to an existing user, an invitation is sent to that address. The recipient must accept the invitation to be added as a new user with the API_DEVELOPER role.

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

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

গুরুত্বপূর্ণ নোটিফিকেশন পাওয়ার জন্য API_DEVELOPER রোলটি প্রয়োজন, কিন্তু মার্চেন্ট সেন্টারের মধ্যে এর অনুমতি খুবই সীমিত। এই ব্যবহারকারীকে অন্যান্য API কল করতে বা মার্চেন্ট সেন্টার 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) অ্যাক্সেস ব্যাহত না হয়, সেজন্য আপনার অন্তত একজন ব্যাকআপ ডেভেলপার যুক্ত করা উচিত।

সতর্কতা: যদি 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"
}

{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 ফিল্ডের মানটি কপি করুন। একটি পণ্য যোগ করার জন্য আপনার এটি প্রয়োজন হবে।

আপনি মার্চেন্ট সেন্টার 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 মেথডটি ব্যবহার করতে পারেন। এছাড়া, আপনি মার্চেন্ট সেন্টার UI ব্যবহার করেও এই প্রোডাক্টটি দেখতে পারেন। আপনার প্রোডাক্ট ডেটা দেখার বিষয়ে আরও তথ্যের জন্য, মার্চেন্ট সেন্টারে প্রোডাক্টস ওভারভিউ দেখুন।