मुख्य सामग्री पर जाएं

​
अवलोकन

Catalog API एक कॉमर्स समाधान है, जो विज्ञापनदाताओं को product feed सेट अप करने, products को sets में समूहित करने और कैटलॉग products को समग्र रूप से प्रबंधित करने की सुविधा देता है। Catalog API एक प्रमुख टूल है, जो प्रोग्रामेटिक कैटलॉग management को सक्षम बनाता है और विज्ञापनदाताओं को इस बात पर अधिक नियंत्रण देता है कि उनके कैटलॉगs को कैसे ingest और update किया जाए। एक कैटलॉग में उपयोगकर्ता के product और product set से संबंधित सभी जानकारी होती है और यह उपयोगकर्ता के handle से संबद्ध होता है। वर्तमान में, एक उपयोगकर्ता केवल एक कैटलॉग बना सकता है।  Catalog API products को ingest करने के 2 तरीकों का समर्थन करता है:
  1. Scheduled Feed: उपयोगकर्ता एक feed URL (CSV, TSV, और XML) जोड़ सकता है, जिसे समय-समय पर fetch किया जाएगा (X वर्तमान में 8GB तक की file का समर्थन करता है)
  2. Batch Products API: उपयोगकर्ता batch (JSON) requests के ज़रिए product attributes को देख, बना, update और delete कर सकता है
X merchants filter rules के आधार पर product sets बना सकते हैं। ऐसा करने पर, वे अपने products में अतिरिक्त metadata जोड़ सकते हैं और organic commerce features या dynamic product ads के ज़रिए इन products को प्रदर्शित करने के लिए विशेष product sets बना सकते हैं। Catalog API और X shopping manager product sets के दो प्रकारों का समर्थन करते हैं। 
  1. Manual: उपयोगकर्ता अधिकतम 50 products चुन सकता है, और एक name तथा description सेट कर सकता है
  2. Filter: उपयोगकर्ता अधिकतम 30 filters जोड़ सकता है, ताकि उन products के साथ sets अपने-आप generate हों जो इन filters को पूरा करते हैं। Filters के प्रकारों में price, Google product category, product type, inventory, sale price, और custom फ़ील्ड्स शामिल हैं।
Catalog API में कैटलॉग को प्रबंधित करने के लिए 4 endpoints हैं:
  • Product Catalogs - product information के लिए एक container बनाना
  • Products -  कैटलॉगs में products को synchronous तरीके से जोड़ना, update करना, देखना, और हटाना
  • प्रोडक्ट सेट्स -  product information के आधार पर products को समूहों में व्यवस्थित करना
  • Schedule Feeds - कैटलॉगs में file-आधारित product data के asynchronous ingestion को सेट अप करना

​
Catalog API के लिए पूर्वापेक्षाएँ

Catalog API endpoints फिलहाल केवल early-access के माध्यम से उपलब्ध हैं। एक्सेस के लिए आवेदन करने हेतु, कृपया अपने X प्रतिनिधि से संपर्क करें।  आपके लिए X Shopping Manager के माध्यम से सेवा की शर्तें स्वीकार करना आवश्यक है। Shopping Manager और उत्पाद विनिर्देशों के बारे में अधिक जानकारी के लिए, कृपया उत्पाद विनिर्देश मार्गदर्शिका देखें।

​
रेट लिमिट्स

निम्न तालिका प्रत्येक एंडपॉइंट के लिए रेट लिमिट्स दिखाती है।

​
उत्पाद कैटलॉग

HTTP मेथडरेट लिमिट
GET /product_catalogsप्रति 15 मिनट 1,000
POST /product_catalogsप्रति 15 मिनट 20
PUT /product_catalogs/:product_catalog_idप्रति 15 मिनट 20
DELETE /product_catalogs/:product_catalog_idप्रति 15 मिनट 20

​
बैच प्रोडक्ट्स API

HTTP मेथडरेट लिमिट
GET /product_catalogs/:product_catalog_id/productsप्रति 15 मिनट 1,000
PUT /product_catalogs/:product_catalog_id/productsप्रति 15 मिनट 600
DELETE /product_catalogs/:product_catalog_id/productsप्रति 15 मिनट 150

​
प्रोडक्ट सेट्स

HTTP मेथडरेट लिमिट
GET /product_catalogs/:product_catalog_id/product_sets15 मिनट में 2,000
POST /product_catalogs/:product_catalog_id/product_sets15 मिनट में 100
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id15 मिनट में 500
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id15 मिनट में 100

​
उत्पाद फ़ीड्स

HTTP मेथडरेट लिमिट
GET /product_catalogs/:product_catalog_id/product_feedsहर 15 मिनट में 1,000
POST /product_catalogs/:product_catalog_id/product_feedsहर 15 मिनट में 20
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_idहर 15 मिनट में 20
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_idहर 15 मिनट में 20