মার্চেন্ট API দিয়ে শুরু করুন

এই পৃষ্ঠাটি ব্যাখ্যা করে যে আপনি কীভাবে একটি বণিক কেন্দ্র অ্যাকাউন্ট তৈরি করতে পারেন এবং মার্চেন্ট API ব্যবহার করে একটি নমুনা পণ্য আপলোড করতে পারেন৷

আপনি শুরু করার আগে

আপনার Google ক্লাউড প্রকল্পে মার্চেন্ট API সক্ষম করুন৷

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

গুগল ক্লাউডে যান

একটি অ্যাকাউন্ট তৈরি করুন

মার্চেন্ট এপিআই ব্যবহার করতে, আপনার অবশ্যই একটি বণিক কেন্দ্র অ্যাকাউন্ট থাকতে হবে। একটি তৈরি করতে, Merchant Center দিয়ে শুরু করুন দেখুন।

বণিক কেন্দ্রে যান

বিকাশকারী হিসাবে নিবন্ধন করুন

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

বিকাশকারী হিসাবে নিবন্ধন করা দুটি জিনিস সম্পাদন করে:

  • এটি আপনার Google ক্লাউড প্রকল্পকে আপনার প্রাথমিক বণিক কেন্দ্র অ্যাকাউন্টের সাথে লিঙ্ক করে, একটি আনুষ্ঠানিক সংযোগ স্থাপন করে।
  • এটি আপনার Merchant Center অ্যাকাউন্টের একজন ব্যবহারকারীকে API_DEVELOPER ভূমিকা অর্পণ করে একটি প্রযুক্তিগত যোগাযোগ তৈরি করে। এটি Google আপনাকে API সম্পর্কে গুরুত্বপূর্ণ আপডেট পাঠাতে দেয়, যেমন পরিষেবার ঘোষণা এবং নতুন বৈশিষ্ট্য সম্পর্কে তথ্য৷

আপনার Google ক্লাউড প্রকল্প নিবন্ধন করুন

নিবন্ধন করতে, developerRegistration.registerGcp পদ্ধতিতে কল করুন। এই কলটি Google ক্লাউড প্রজেক্টটিকে লিঙ্ক করে যা আপনি অনুরোধে উল্লেখ করেছেন বণিক কেন্দ্র অ্যাকাউন্টের সাথে কল করতে ব্যবহার করেন।

অনুরোধের অংশে, আপনাকে একটি প্রযুক্তিগত যোগাযোগ হিসাবে ব্যবহার করার জন্য একটি বিকাশকারীর ইমেল ঠিকানা প্রদান করতে হবে৷ এই ঠিকানাটি অবশ্যই একটি Google অ্যাকাউন্টের (Google Workspace অ্যাকাউন্ট বা Gmail অ্যাকাউন্ট) সাথে যুক্ত হতে হবে, উদাহরণস্বরূপ sampleuser@gmail.com ।

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

এখানে একটি উদাহরণ অনুরোধ:

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 ভূমিকার প্রয়োজন, তবে এটির 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 HTTP/1.1

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

আপনার তৈরি মার্চেন্ট সেন্টার অ্যাকাউন্টের ID দিয়ে {ACCOUNT_ID} প্রতিস্থাপন করুন।

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

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

name ক্ষেত্রের মান কপি করুন। আপনি একটি পণ্য সন্নিবেশ এটি প্রয়োজন হবে.

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

একটি পণ্য সন্নিবেশ

আপনার অ্যাকাউন্টে একটি নমুনা পণ্য সন্নিবেশ করতে, নিম্নলিখিত অনুরোধটি চালান:

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "channel": "ONLINE",
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

আপনি আগে কপি করা মান দিয়ে {DATASOURCE_NAME} প্রতিস্থাপন করুন।

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

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

নতুন তৈরি পণ্যের পণ্যের আইডি online~en~US~tshirt-123 । আপনি এই পণ্যের বিবরণ পুনরুদ্ধার করতে accounts.products.get পদ্ধতি ব্যবহার করতে পারেন। আপনি এই পণ্যটি দেখতে বণিক কেন্দ্র UI ব্যবহার করতে পারেন। আপনার পণ্য ডেটা দেখুন দেখুন।

পূর্ববর্তী
Design
পরবর্তী
Overview