इस पेज का अनुवाद Cloud Translation API से किया गया है.

Method: accounts.productInputs.insert

एचटीटीपी अनुरोध
पाथ पैरामीटर
क्वेरी पैरामीटर
अनुरोध का मुख्य हिस्सा
जवाब का मुख्य हिस्सा
- JSON फ़ॉर्मैट में दिखाना
अनुमति के दायरे

आपके Merchant Center खाते में प्रॉडक्ट का इनपुट अपलोड करता है. अगर एक जैसे contentLanguage, OfferId, और dataSource वाला कोई इनपुट पहले से मौजूद है, तो यह तरीका उस एंट्री की जगह ले लेता है.

प्रॉडक्ट इनपुट डालने, अपडेट करने या मिटाने के बाद, प्रोसेस किए गए प्रॉडक्ट को वापस लाने में कुछ मिनट लग सकते हैं.

एचटीटीपी अनुरोध

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर

पैरामीटर
`parent`	`string` ज़रूरी है. वह खाता जिसमें यह प्रॉडक्ट डाला जाएगा. फ़ॉर्मैट: accounts/{account}

parent

string

ज़रूरी है. वह खाता जिसमें यह प्रॉडक्ट डाला जाएगा. फ़ॉर्मैट: accounts/{account}

क्वेरी पैरामीटर

पैरामीटर

पैरामीटर
`dataSource`	`string` ज़रूरी है. प्रॉडक्ट डेटा के प्राइमरी या पूरक सोर्स का नाम. अगर प्रॉडक्ट पहले से मौजूद है और दिया गया डेटा सोर्स अलग है, तो प्रॉडक्ट को नए डेटा सोर्स में ले जाया जाएगा. फ़ॉर्मैट: `accounts/{account}/dataSources/{datasource}`.

dataSource

string

ज़रूरी है. प्रॉडक्ट डेटा के प्राइमरी या पूरक सोर्स का नाम. अगर प्रॉडक्ट पहले से मौजूद है और दिया गया डेटा सोर्स अलग है, तो प्रॉडक्ट को नए डेटा सोर्स में ले जाया जाएगा. फ़ॉर्मैट: accounts/{account}/dataSources/{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].

प्रॉडक्ट के इनपुट और इसके सब-मैसेज के सभी फ़ील्ड, वर्टिकल स्पेसिफ़िकेशन में उनसे जुड़े एट्रिब्यूट के अंग्रेज़ी नाम से मेल खाते हैं. इसमें कुछ अपवाद भी हैं.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना

जेएसओएन के काेड में दिखाना
{ "name": string, "product": string, "channel": enum (`ChannelEnum`), "offerId": string, "contentLanguage": string, "feedLabel": string, "attributes": { object (`Attributes`) }, "customAttributes": [ { object (`CustomAttribute`) } ], "versionNumber": string }

{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}

फ़ील्ड
`name`	`string` आइडेंटिफ़ायर. प्रॉडक्ट के इनपुट का नाम. फ़ॉर्मैट: `"{productinput.name=accounts/{account}/productInputs/{productinput}}"`
`product`	`string` सिर्फ़ आउटपुट के लिए. प्रोसेस किए गए प्रॉडक्ट का नाम. फ़ॉर्मैट: `"{product.name=accounts/{account}/products/{product}}"`
`channel`	`enum (ChannelEnum)` ज़रूरी है. इम्यूटेबल. प्रॉडक्ट का चैनल.
`offerId`	`string` ज़रूरी है. इम्यूटेबल. प्रॉडक्ट के लिए आपका यूनीक आइडेंटिफ़ायर. यह प्रॉडक्ट इनपुट और प्रोसेस किए गए प्रॉडक्ट के लिए एक जैसा होता है. सबमिट करने पर, आगे और पीछे की खाली सफ़ेद जगहों को हटा दिया जाता है. साथ ही, कई खाली सफ़ेद जगहों को एक ही खाली सफ़ेद जगह से बदल दिया जाता है. ज़्यादा जानकारी के लिए प्रॉडक्ट डेटा स्पेसिफ़िकेशन देखें.
`contentLanguage`	`string` ज़रूरी है. इम्यूटेबल. प्रॉडक्ट के लिए, दो अक्षर का ISO 639-1 भाषा कोड.
`feedLabel`	`string` ज़रूरी है. इम्यूटेबल. प्रॉडक्ट के लिए फ़ीड का लेबल.
`attributes`	`object (Attributes)` ज़रूरी नहीं. प्रॉडक्ट एट्रिब्यूट की सूची.
`customAttributes[]`	`object (CustomAttribute)` ज़रूरी नहीं. कस्टम (व्यापारी/कंपनी/कारोबारी की ओर से दिए गए) एट्रिब्यूट की सूची. इसका इस्तेमाल, डेटा स्पेसिफ़िकेशन के किसी भी एट्रिब्यूट को सामान्य फ़ॉर्म में सबमिट करने के लिए भी किया जा सकता है. जैसे, `{ "name": "size type", "value": "regular" }`. यह उन एट्रिब्यूट को सबमिट करने के लिए काम आता है जिन्हें एपीआई ने साफ़ तौर पर नहीं दिखाया है. जैसे, 'Google पर खरीदें' के लिए इस्तेमाल किए जाने वाले अन्य एट्रिब्यूट. हर कस्टम एट्रिब्यूट के लिए 10,240 वर्ण ही इस्तेमाल किए जा सकते हैं. यह नाम और वैल्यू के कुल वर्णों को दिखाता है. हर प्रॉडक्ट के लिए, ज़्यादा से ज़्यादा 2,500 कस्टम एट्रिब्यूट सेट किए जा सकते हैं. इनका कुल साइज़ 102.4 केबी होना चाहिए. शामिल करने पर, कस्टम एट्रिब्यूट के नाम में मौजूद अंडरस्कोर को स्पेस से बदल दिया जाता है.
`versionNumber`	`string (int64 format)` ज़रूरी नहीं. प्रॉडक्ट का मौजूदा वर्शन (नयापन) दिखाता है. एक ही समय में कई अपडेट करने पर, इसका इस्तेमाल प्रॉडक्ट को सही क्रम में रखने के लिए किया जा सकता है. अगर यह नीति सेट की जाती है, तो मौजूदा प्रॉडक्ट के मौजूदा वर्शन के नंबर से कम होने पर, प्रॉडक्ट को शामिल नहीं किया जाएगा. मौजूदा `versionNumber` का इस्तेमाल करके, फिर से शामिल किया जा सकता है. उदाहरण के लिए, प्रॉडक्ट को 30 दिनों के बाद रीफ़्रेश करना. यह सिर्फ़ प्राइमरी डेटा सोर्स में इंसर्शन के लिए काम करता है. अगर कार्रवाई को रोका जाता है, तो रद्द किया गया अपवाद लागू कर दिया जाएगा.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

https://www.googleapis.com/auth/content

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.