পণ্য সংগ্রহ

পণ্য সংগ্রহ আপনাকে সমৃদ্ধ বিন্যাসগুলির সাথে ব্যবহারের জন্য পণ্যগুলির গ্রুপ সংজ্ঞায়িত করতে দেয়, যেমন শপযোগ্য চিত্র । প্রতিটি সংগ্রহে 100টি পর্যন্ত পণ্য অন্তর্ভুক্ত থাকতে পারে। আপনি Google Merchant Center বা Content API-এর মাধ্যমে একটি সংগ্রহ তৈরি করতে পারেন।

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

দ্রষ্টব্য: কেনাকাটাযোগ্য চিত্রগুলি বর্তমানে একমাত্র বিজ্ঞাপন বিন্যাস যা সংগ্রহকে সমর্থন করে। যাইহোক, অতিরিক্ত ফর্ম্যাট যোগ করা হতে পারে যাতে আপনি বিভিন্ন বিজ্ঞাপন ফর্ম্যাটে আপনার সংগ্রহগুলি পুনরায় ব্যবহার করতে পারেন৷

পণ্য সংগ্রহ ব্যবহার করুন

সামগ্রী এপিআই পণ্য সংগ্রহ পরিচালনা করতে দুটি পরিষেবা অন্তর্ভুক্ত করে:

• collections : আপনাকে পণ্য সংগ্রহ পেতে, তালিকাভুক্ত করতে, সন্নিবেশ করাতে এবং মুছতে দেয়।

• collectionstatuses : কোনো সংগ্রহে এমন কোনো সমস্যা আছে কিনা তা আবিষ্কার করতে আপনাকে সংগ্রহের স্থিতি পেতে এবং তালিকা করতে দেয় যা একটি গন্তব্যের জন্য সংগ্রহটি অবৈধ হতে পারে, যেমন শপিং বিজ্ঞাপন ।

উদাহরণ: কেনাকাটাযোগ্য চিত্রগুলির জন্য একটি সংগ্রহ তৈরি করুন

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

কেনাকাটাযোগ্য চিত্রগুলি ব্যবহার করার জন্য, আপনাকে অবশ্যই পণ্যগুলির একটি সংগ্রহ তৈরি করতে হবে এবং দশটি পর্যন্ত পণ্য রয়েছে এমন একটি চিত্র নির্দিষ্ট করতে imageLink ক্ষেত্রটি ব্যবহার করতে হবে৷ আমরা বর্গাকার ছবি ব্যবহার করার পরামর্শ দিই (1:1 আকৃতির অনুপাত সহ)।

মূল পয়েন্ট: সংগ্রহের জন্য imageLink ক্ষেত্রটি চিত্র লিঙ্ক মানগুলির একটি অ্যারে গ্রহণ করে। যাইহোক, শপএবল ইমেজ ফরম্যাটের জন্য শুধুমাত্র অ্যারের প্রথম মানটি ব্যবহার করা হয়।

x এবং y ক্ষেত্রগুলি ব্যবহার করে চিত্রের পণ্যগুলির স্থানাঙ্ক সহ featuredProduct ক্ষেত্র ব্যবহার করে ছবিতে প্রদর্শিত পণ্যগুলিও আপনাকে অবশ্যই নির্দিষ্ট করতে হবে। এই ক্ষেত্রগুলি শুধুমাত্র কেনাকাটাযোগ্য চিত্রগুলির সাথে ব্যবহৃত সংগ্রহগুলির জন্য প্রয়োজনীয়৷ x এবং y মান অবশ্যই 0 এবং 1 এর মধ্যে হতে হবে, অন্তর্ভুক্ত।

প্রতিটি সংগ্রহে সর্বাধিক 100টি পণ্য অন্তর্ভুক্ত থাকতে পারে। যাইহোক, কেনাকাটাযোগ্য চিত্রগুলির জন্য, আমরা সুপারিশ করি যে আপনি প্রতি চিত্রে 10টির বেশি পণ্যের জন্য স্থানাঙ্ক নির্দিষ্ট করুন যাতে পণ্যের কলআউটগুলি দেখানোর জন্য ছবিতে পর্যাপ্ত জায়গা রয়েছে তা নিশ্চিত করুন৷ যে offerId ফিল্ডটি featuredProduct অবজেক্টের অংশ সেটি অবশ্যই products রিসোর্সের offerId মানের সাথে মিলতে হবে, যা products রিসোর্সের id মানের থেকে আলাদা।

imageLink এবং featuredProduct ক্ষেত্রগুলি ছাড়াও, যা কেনাকাটাযোগ্য চিত্রগুলির জন্য প্রয়োজনীয়, আপনি ঐচ্ছিক headline ক্ষেত্রটি ব্যবহার করে একটি সংগ্রহ শিরোনামও নির্দিষ্ট করতে পারেন। আমরা একটি শিরোনাম অন্তর্ভুক্ত করার পরামর্শ দিই যাতে গ্রাহকদের সংগ্রহ সম্পর্কে অতিরিক্ত বিশদ প্রদান করা যায়।

মূল পয়েন্ট: সংগ্রহের জন্য headline ক্ষেত্র শিরোনাম মানগুলির একটি অ্যারে গ্রহণ করে। যাইহোক, শপএবল ইমেজ ফরম্যাটের জন্য শুধুমাত্র অ্যারের প্রথম মানটি ব্যবহার করা হয়।

কেনাকাটা যোগ্য চিত্রগুলির জন্য একটি নতুন সংগ্রহ তৈরি করতে, নিম্নলিখিত URL এবং অনুরোধের বডি ব্যবহার করে collections.insert endpoint-এ একটি POST অনুরোধ করুন:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections

{
  "id": "exampleCollection"
  "language": "en",
  "productCountry": "UK",
  "imageLink": ["www.imageLink.example"],
  "featuredProduct": [
{
  "offerId": '432',
  "x": 0.11,
  "y": 0.99
},
{ "offerId": '433',
  "x": 0.53,
  "y": 0.89
}
],
  "link": "www.link.example",
  "mobileLink": "www.mobileLink.example",
  "headline": "www.link.example",
  "customLabel0": "Organize",
  "customLabel1": "Your",
  "customLabel2": "Bidding/Reporting",
  "customLabel3": "With",
  "customLabel4": "Me"
}

সতর্কতা: যদি একই id সাথে একটি সংগ্রহ বিদ্যমান থাকে, তাহলে collections.insert এ একটি অনুরোধ করা সম্পদটিকে সম্পূর্ণরূপে প্রতিস্থাপন করে।

উদাহরণ: একটি সংগ্রহের স্থিতি পরীক্ষা করুন

আপনি উপরে যে সংগ্রহটি তৈরি করেছেন তাতে এমন সমস্যা আছে যা বিজ্ঞাপন পরিবেশন থেকে সংগ্রহকে বাতিল করে কিনা তা আবিষ্কার করতে, নিম্নলিখিত URL ব্যবহার করে collectionsstatuses.get এন্ডপয়েন্টে একটি GET অনুরোধ করুন এবং আপনি যে সংগ্রহের স্থিতি পুনরুদ্ধার করতে চান তার id অন্তর্ভুক্ত করুন। আপনি একটি অনুরোধ শরীরের প্রদান করতে হবে না.

https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID

উদাহরণ সংগ্রহ অবস্থা প্রতিক্রিয়া

{
  "id": "exampleCollection",
  "creationDate": "2020-09-22T00:26:51Z",
  "lastUpdateDate": "2020-09-22T00:26:51Z",
  "collectionLevelIssues": [
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "link",
      "description": "Invalid URL [link]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    },
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "imageLink",
      "description": "Invalid URL [imageLink]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    }
  ]
}