- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
आपके Merchant Center खाते में प्रॉडक्ट का इनपुट अपलोड करता है. अगर एक जैसे contentLanguage, OfferId, और dataSource वाला कोई इनपुट पहले से मौजूद है, तो यह तरीका उस एंट्री की जगह ले लेता है.
प्रॉडक्ट इनपुट डालने, अपडेट करने या मिटाने के बाद, प्रोसेस किए गए प्रॉडक्ट को वापस लाने में कुछ मिनट लग सकते हैं.
एचटीटीपी अनुरोध
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. वह खाता जिसमें यह प्रॉडक्ट डाला जाएगा. फ़ॉर्मैट: accounts/{account} |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
dataSource |
ज़रूरी है. प्रॉडक्ट डेटा के प्राइमरी या पूरक सोर्स का नाम. अगर प्रॉडक्ट पहले से मौजूद है और दिया गया डेटा सोर्स अलग है, तो प्रॉडक्ट को नए डेटा सोर्स में ले जाया जाएगा. फ़ॉर्मैट: |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में ProductInput
का उदाहरण है.
जवाब का मुख्य भाग
यह संसाधन, किसी प्रॉडक्ट के लिए सबमिट किए गए इनपुट डेटा को दिखाता है. इसमें उस प्रॉडक्ट डेटा को नहीं दिखाया जाता जिसे प्रोसेस किया गया है और जो Merchant Center, शॉपिंग विज्ञापनों या Google के सभी प्लैटफ़ॉर्म पर दिखता है. प्रोसेस किया गया [product][google.shopping.content.bundles.Products.Product] तैयार करने के लिए, प्रॉडक्ट के इनपुट, नियमों, और पूरक डेटा सोर्स के डेटा को एक साथ जोड़ा जाता है.
डेटा की पुष्टि करने से जुड़ी जांच पास करने के लिए, प्रॉडक्ट इनपुट के ज़रूरी एट्रिब्यूट को मुख्य रूप से प्रॉडक्ट डेटा स्पेसिफ़िकेशन में बताया गया है.
ये एट्रिब्यूट ज़रूरी हैं: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] और [offerId][google.shopping.content.bundles.Products.offer_id].
प्रॉडक्ट इनपुट डालने, अपडेट करने या मिटाने के बाद, प्रोसेस किए गए प्रॉडक्ट को वापस लाने में कुछ मिनट लग सकते हैं.
प्रॉडक्ट के इनपुट और इसके सब-मैसेज के सभी फ़ील्ड, कुछ अपवादों के साथ वर्टिकल स्पेसिफ़िकेशन में, उनसे जुड़े एट्रिब्यूट के अंग्रेज़ी नाम से मैच होते हैं.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{ "name": string, "product": string, "channel": enum ( |
फ़ील्ड | |
---|---|
name |
आइडेंटिफ़ायर. प्रॉडक्ट के इनपुट का नाम. फ़ॉर्मैट: |
product |
सिर्फ़ आउटपुट के लिए. प्रोसेस किए गए प्रॉडक्ट का नाम. फ़ॉर्मैट: |
channel |
ज़रूरी है. इम्यूटेबल. प्रॉडक्ट का चैनल. |
offerId |
ज़रूरी है. इम्यूटेबल. प्रॉडक्ट के लिए आपका यूनीक आइडेंटिफ़ायर. यह प्रॉडक्ट इनपुट और प्रोसेस किए गए प्रॉडक्ट के लिए एक जैसा होता है. सबमिट करने पर, आगे और पीछे की खाली सफ़ेद जगहों को हटा दिया जाता है. साथ ही, कई खाली सफ़ेद जगहों को एक ही खाली सफ़ेद जगह से बदल दिया जाता है. ज़्यादा जानकारी के लिए प्रॉडक्ट डेटा स्पेसिफ़िकेशन देखें. |
contentLanguage |
ज़रूरी है. इम्यूटेबल. प्रॉडक्ट के लिए, दो अक्षर का ISO 639-1 भाषा कोड. |
feedLabel |
ज़रूरी है. इम्यूटेबल. प्रॉडक्ट के लिए फ़ीड का लेबल. |
attributes |
ज़रूरी नहीं. प्रॉडक्ट एट्रिब्यूट की सूची. |
customAttributes[] |
ज़रूरी नहीं. कस्टम (व्यापारी/कंपनी/कारोबारी की ओर से दिए गए) एट्रिब्यूट की सूची. इसका इस्तेमाल, डेटा स्पेसिफ़िकेशन के किसी भी एट्रिब्यूट को उसके सामान्य रूप में सबमिट करने के लिए भी किया जा सकता है. जैसे, |
versionNumber |
ज़रूरी नहीं. प्रॉडक्ट का मौजूदा वर्शन (नयापन) दिखाता है. एक ही समय में कई अपडेट करने पर, इसका इस्तेमाल प्रॉडक्ट को सही क्रम में रखने के लिए किया जा सकता है. अगर यह नीति सेट की जाती है, तो मौजूदा प्रॉडक्ट के मौजूदा वर्शन के नंबर से कम होने पर, प्रॉडक्ट को शामिल नहीं किया जाएगा. मौजूदा यह सिर्फ़ प्राइमरी डेटा सोर्स में इंसर्शन के लिए काम करता है. अगर कार्रवाई को रोका जाता है, तो रद्द किया गया अपवाद लागू कर दिया जाएगा. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/content
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.