প্রোগ্রাম সাব-API-এর ওভারভিউ

প্রোগ্রাম আপনাকে প্রোডাক্টের প্রচার নিয়ন্ত্রণ করতে এবং বিভিন্ন Google সারফেস জুড়ে আপনার অ্যাকাউন্টের ফিচার উন্নত করতে দেয়।

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

প্রোগ্রাম সাব-API আপনাকে উপলভ্য সব শপিং প্রোগ্রামে আপনার অংশগ্রহণ সংক্রান্ত তথ্য উদ্ধার ও আপডেট করতে দেয়।

প্রোগ্রাম ফিরিয়ে আনতে, চালু ও বন্ধ করতে, আপনি নিম্নলিখিত পদ্ধতি ব্যবহার করতে পারবেন:

সব প্রোগ্রামের তালিকা করুন

অ্যাকাউন্টের জন্য সব প্রোগ্রাম ফিরিয়ে আনতে, accounts.programs.list পদ্ধতি ব্যবহার করুন।

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs

cURL

  curl \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --compressed

সফল অনুরোধের একটি নমুনা উত্তর এখানে দেওয়া হল:

{
  "programs": [
    {
      "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
      "documentationUri": "{URI}",
      "state": "{ACCOUNT_STATE}",
      "unmetRequirements": [
        {
          "title": "{TITLE}",
          "documentationUri": "{URI}",
          "affectedRegionCodes": [
            "{REGION_CODE}"
          ]
        }
      ]
    }
  ]
}

একটি প্রোগ্রাম ফিরিয়ে আনুন

নির্দিষ্ট প্রোগ্রাম ফিরিয়ে আনতে, accounts.programs.get পদ্ধতি ব্যবহার করুন।

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listings

cURL

  curl \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listing?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --compressed

সফল অনুরোধের একটি নমুনা উত্তর এখানে দেওয়া হল:

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}",
  "unmetRequirements": [
    {
      "title": "{TITLE}",
      "documentationUri": "{URI}",
      "affectedRegionCodes": [
        "{REGION_CODE}"
      ]
    }
  ]
}

প্রোগ্রাম চালু করুন

অ্যাকাউন্টের জন্য নির্দিষ্ট প্রোগ্রামে অংশগ্রহণ চালু করতে, accounts.programs.enable পদ্ধতি ব্যবহার করুন। এই অনুমতি রান করতে আপনার কাছে অবশ্যই অ্যাডমিনিস্ট্রেটর অ্যাক্সেস থাকতে হবে।

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listings:enable

cURL

  curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listing:enable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

সফল অনুরোধের একটি নমুনা উত্তর এখানে দেওয়া হল:

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}",
  "unmetRequirements": [
    {
      "title": "{TITLE}",
      "documentationUri": "{URI}",
      "affectedRegionCodes": [
        "{REGION_CODE}"
      ]
    }
  ]
}

প্রোগ্রাম বন্ধ করা

অ্যাকাউন্টের জন্য নির্দিষ্ট প্রোগ্রামে অংশগ্রহণ বন্ধ করতে, accounts.programs.disable পদ্ধতি ব্যবহার করুন। এই অনুমতি রান করতে আপনার কাছে অবশ্যই অ্যাডমিনিস্ট্রেটর অ্যাক্সেস থাকতে হবে।

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listings:disable

cURL

  curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/free-listing:disable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

সফল অনুরোধের একটি নমুনা উত্তর এখানে দেওয়া হল:

{
  "name": "accounts/{ACCOUNT_ID}/programs/free-listings",
  "documentationUri": "{URI}",
  "state": "{ACCOUNT_STATE}"
}