আপনি গুগলে প্রোমোশন তৈরি ও পরিচালনা করতে মার্চেন্ট প্রোমোশনস এপিআই (Merchant Promotions API) ব্যবহার করতে পারেন। accounts.promotions রিসোর্সটি আপনাকে গুগলে আপনার বিক্রি করা পণ্যগুলির জন্য বিশেষ অফার প্রদর্শন করতে দেয়। আরও তথ্যের জন্য, মার্চেন্ট প্রোমোশনস এপিআই-এর ওভারভিউ (Overview of Merchant Promotions API ) দেখুন।
শপিং-এর জন্য কন্টেন্ট এপিআই থেকে মার্চেন্ট এপিআই-তে পরিবর্তনের সংক্ষিপ্ত বিবরণ
একটি উল্লেখযোগ্য পার্থক্য হলো, Content API for Shopping প্রথমবার প্রোমোশন যোগ করার সাথে সাথেই স্বয়ংক্রিয়ভাবে ডেটা সোর্স তৈরি করে, যা Merchant API-এর ক্ষেত্রে ঘটে না। Merchant API ব্যবহার করে একটি প্রোমোশন যোগ করতে, আপনাকে প্রথমে একটি প্রোমোশন ডেটা সোর্স তৈরি করতে হবে। accounts.dataSources রিসোর্সের promotionDataSource অবজেক্টের ফিল্ডগুলো সম্পর্কে তথ্যের জন্য, PromotionDataSource দেখুন।
অনুরোধ
অনুরোধ করার জন্য নিম্নলিখিত URL-টি ব্যবহার করুন।
POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions
শপিং এর জন্য কন্টেন্ট এপিআই থেকে মাইগ্রেট করুন
নিম্নলিখিত অংশে শপিং-এর জন্য কন্টেন্ট এপিআই এবং প্রমোশন-সম্পর্কিত অনুরোধের জন্য মার্চেন্ট প্রমোশন এপিআই-এর মধ্যে তুলনা করা হয়েছে।
ইউআরএল
শপিং-এর জন্য কন্টেন্ট এপিআই-তে:
https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions
মার্চেন্ট এপিআই-তে যা হয়:
https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
শনাক্তকারী
শপিং-এর জন্য কন্টেন্ট এপিআই-তে:
{MERCHANT_ID}/promotions/{PROMOTION_ID}
মার্চেন্ট এপিআই-তে যা হয়:
{NAME}
পদ্ধতি
মার্চেন্ট এপিআই প্রচারের জন্য নিম্নলিখিত পদ্ধতিগুলো সমর্থন করে:
- প্রচারগুলি সন্নিবেশ করুন
- পদোন্নতি পান
- তালিকা পদোন্নতি
শপিং-এর কন্টেন্ট এপিআই এবং মার্চেন্ট এপিআই-তে প্রচার পদ্ধতির প্রাপ্যতার একটি তুলনা নিচে দেওয়া হলো:
| বৈশিষ্ট্য | কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই |
|---|---|---|
| ইউআরএল | https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /promotions | https://merchantapi.googleapis.com/promotions/v1/ {parent=accounts/*} /promotions |
| শনাক্তকারী | {MERCHANT_ID} /promotions/ {PROMOTION_ID} | {NAME} |
| পদ্ধতি |
|
|
ক্ষেত্র পরিবর্তন
টেবিলটি দেখায় যে মার্চেন্ট প্রোমোশনস এপিআই-তে প্রোমোশনগুলির জন্য কী কী পরিবর্তন আসে।
তথ্যসূত্র হিসেবে একটি উদাহরণ দেখতে, স্থানীয় ইনভেন্টরি দেখুন।
| কেনাকাটার জন্য কন্টেন্ট এপিআই | মার্চেন্ট এপিআই | বর্ণনা |
|---|---|---|
| (সমর্থিত নয়) | কাস্টম_অ্যাট্রিবিউটস | কাস্টম (ব্যবহারকারীর দেওয়া) অ্যাট্রিবিউটের একটি তালিকা। আপনি পারেন ফিডের যেকোনো বৈশিষ্ট্য জমা দিতেও এটি ব্যবহার করুন। এর সাধারণ রূপে স্পেসিফিকেশন। উদাহরণস্বরূপ:
{
"name": "size type", "value": "regular"
}
এপিআই দ্বারা উন্মুক্ত। |
| সমর্থিত নয় | ডেটা_উৎস | একটি প্রমোশন তৈরি করার জন্য একটি বিদ্যমান ডেটা সোর্স প্রয়োজন। |
| সমর্থিত নয় | বৈশিষ্ট্য | পদোন্নতি-নির্দিষ্ট বৈশিষ্ট্য, উদাহরণস্বরূপ, দীর্ঘ_টাইল , পদোন্নতির_কার্যকর_সময়কাল , এবং অন্যান্যগুলো, অ্যাট্রিবিউট মেসেজের অংশ। |
| আইটেম_আইডি | আইটেম_আইডি_অন্তর্ভুক্তি | যেসব আইটেম আইডিতে একটি প্রমোশন প্রযোজ্য, তার তালিকা এর নাম পরিবর্তন করা হয়েছে। |
| স্টোর_আইডি | store_id_inclusion | যেসব স্টোর আইডিতে একটি প্রোমোশন প্রযোজ্য, তার তালিকা এর নাম পরিবর্তন করা হয়েছে। |
| পণ্যের_ধরন | পণ্যের_প্রকার_অন্তর্ভুক্তি | যেসব পণ্যের ক্ষেত্রে একটি প্রোমোশন প্রযোজ্য, তার তালিকা এর নাম পরিবর্তন করা হয়েছে। |
| আইটেম_গ্রুপ_আইডি | আইটেম_গ্রুপ_আইডি_অন্তর্ভুক্তি | যেসব আইটেম গ্রুপ আইডিতে একটি প্রোমোশন প্রযোজ্য, তার তালিকা এর নাম পরিবর্তন করা হয়েছে। |
| ব্র্যান্ড | ব্র্যান্ড অন্তর্ভুক্তি | যেসব ব্র্যান্ডের জন্য প্রচারটি প্রযোজ্য তার তালিকা এর নাম পরিবর্তন করা হয়েছে। |
| স্টোর_কোড | স্টোর_কোড_অন্তর্ভুক্তি | যে স্টোর কোডগুলিতে একটি প্রচার প্রযোজ্য তার তালিকা এর নাম পরিবর্তন করা হয়েছে। |
price:
{
object (Price)
}
|
price:
{
object (Price)
}
| মূল্যের সংজ্ঞা পরিবর্তিত হয়েছে। শপিং-এর জন্য কন্টেন্ট এপিআই-তে, মূল্য মূল্যের পরিমাণ এখন মাইক্রোতে রেকর্ড করা হয়, অ্যামাউন্ট ফিল্ডের নাম 'ভ্যালু' থেকে 'অ্যামাউন্ট'-এ পরিবর্তিত হয়েছে কারেন্সি ফিল্ডের নাম পরিবর্তন করা হয়েছে |
| অর্ডার_সীমা | (সমর্থিত নয়) | order_limit অ্যাট্রিবিউটটি সমর্থিত নয়। |
| শিপিংসার্ভিসনাম[] | (সমর্থিত নয়) | shippingServiceNames[] সমর্থিত নয়। |
| অর্থ_বাজেট | (সমর্থিত নয়) | money_budget সমর্থিত নয়। |
| পদোন্নতির গন্তব্য আইডি | পদোন্নতির গন্তব্যস্থল | promotionDestinationIds-এর নাম পরিবর্তন করা হয়েছে। |
পদোন্নতির অবস্থা
{
"destinationStatuses": [
{
"destination": string,
"status": enum (State)
}
],
"promotionIssue": [
{
"code": string,
"detail": string
}
],
"creationDate": string,
"lastUpdateDate": string
}
| পদোন্নতির স্থিতি পরিবর্তিত হয়েছে। ইস্যুগুলোতে আরও বিস্তারিত তথ্য পাওয়া যাবে।
promotionStatus = {
destinationStatuses = [
{
reportingContext = Enum
status = Enum
},
],
itemLevelIssues = [
{
code = String
severity = Enum
resolution = String
reportingContext = Enum
description = String
detail = String
documentation = String applicableCountries = [
String,
]
}
]
}
| |