Google Shopping Sellers टास्क सेट करें

Felo API Support

MIT

सर्वर

https://openapi.felo.ai

क्लाइंट लाइब्रेरी

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO ऑपरेशन

post/v1/beta/dataforseo/merchant/google/sellers/task_post

Google Shopping Sellers टास्क सेट करें

एक Google Shopping उत्पाद पेश करने वाले विक्रेताओं की सूची कतार में डालता है और टास्क id लौटाता है। यह पूरी फ़ैमिली असिंक्रोनस है: सबमिट टास्क id को tasks[0].id में लौटाता है और फ़ेच टूल तैयार होने पर परिणाम लौटाता है। get_dataforseo_merchant_google_sellers_fetch से प्राप्त करें।

मूल्य संदर्भ

मीटरिंग: रिपोर्ट किया गया response लागत
संदर्भ request अनुमान: USD 0.012
संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें

यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।

बॉडी

application/json

टाइप: array (object | null)[]
- additional_specifications
  टाइप: object | null
  
  अतिरिक्त URL पैरामीटर वाला ऑब्जेक्ट
  आप "additional_specifications ऑब्जेक्ट का उपयोग करके उत्पाद के बारे में अतिरिक्त जानकारी प्राप्त कर सकते हैं, जिसे Google Shopping Products endpoint पर अलग request भेजकर प्राप्त किया जा सकता है
  उदाहरण:
  "additional_specifications": { "eto": "16157121050167572763_0" }
  
  propertyName
  टाइप: string | null
- data_docid
  टाइप: string
  
  SERP डेटा एलिमेंट का विशिष्ट आइडेंटिफ़ायर
  product_id या gid निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  इष्टतम परिणामों के लिए हम data_docid को product_id और gid के साथ निर्दिष्ट करने की सलाह देते हैं;
  आप किसी विशेष एलिमेंट के लिए यह मान Google Shopping Products endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  13071766526042404278
- depth
  टाइप: integer | null
  
  पार्सिंग गहराई
  वैकल्पिक फ़ील्ड
  Google Shopping SERP से प्राप्त किए जाने वाले परिणामों की संख्या
  डिफ़ॉल्ट मान: 10
  अधिकतम मान: 200
  आपके खाते से प्रत्येक ऐसे SERP के लिए शुल्क लिया जाएगा जिसमें 10 तक परिणाम हों;
  10 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 10 से अधिक परिणाम लौटाता है;
  लागत की गणना Pricing पेज पर की जा सकती है
- get_shops_on_google
  टाइप: boolean | null
  
  "buy on Google" दुकानों को शामिल करें
  वैकल्पिक फ़ील्ड
  यदि true पर सेट किया जाए, तो response में उन विक्रेताओं की सूची होगी जो किसी दिए गए उत्पाद को सीधे Google पर खरीदने की अनुमति देते हैं
  नोट: यदि true पर सेट किया जाए, तो टास्क की लागत दोगुनी हो जाएगी
- gid
  टाइप: string
  
  Google Shopping पर वैश्विक उत्पाद आइडेंटिफ़ायर
  product_id या data_docid निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  इष्टतम परिणामों के लिए हम gid को product_id और data_docid के साथ निर्दिष्ट करने की सलाह देते हैं;
  आप किसी विशेष उत्पाद के लिए यह मान Google Shopping Products endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  4702526954592161872
  पैरामीटर के बारे में अधिक जानें इस Help Center गाइड में
- language_code
  टाइप: string
  
  भाषा कोड
  language_name निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_name निर्दिष्ट करने की आवश्यकता नहीं है
  आप language_code के साथ उपलब्ध Google Shopping भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/merchant/google/languages
  उदाहरण:
  en
- language_name
  टाइप: string
  
  भाषा का पूरा नाम
  language_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है
  आप language_name के साथ उपलब्ध Google Shopping भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/merchant/google/languages
  उदाहरण:
  English
- location_code
  टाइप: integer
  
  स्थान कोड
  location_name या location_coordinate निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  आप location_code के साथ उपलब्ध Google Shopping स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/merchant/google/locations
  उदाहरण:
  2840
- location_coordinate
  टाइप: string
  
  स्थान के GPS निर्देशांक
  location_name या location_code निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_code निर्दिष्ट करने की आवश्यकता नहीं है
  location_coordinate पैरामीटर "latitude,longitude,radius" प्रारूप में निर्दिष्ट करना चाहिए
  "latitude" और "longitude" के लिए दशमलव अंकों की अधिकतम संख्या: 7
  "radius" के लिए न्यूनतम मान: 199.9
  उदाहरण:
  53.476225,-2.243572,200
- location_name
  टाइप: string
  
  स्थान का पूरा नाम
  location_code या location_coordinate निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  आप location_name के साथ उपलब्ध Google Shopping स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें: https://api.dataforseo.com/v3/merchant/google/locations
  उदाहरण:
  London,England,United Kingdom
- pingback_url
  टाइप: string | null
  
  पूर्ण टास्क का नोटिफ़िकेशन URL
  वैकल्पिक फ़ील्ड
  टास्क पूरा होने पर हम आपके निर्दिष्ट URL पर GET request भेजकर सूचित करेंगे
  आप ‘$id’ स्ट्रिंग को $id वैरिएबल और ‘$tag’ को URL-एन्कोडेड $tag वैरिएबल के रूप में उपयोग कर सकते हैं। रिक्वेस्ट भेजने से पहले हम आवश्यक मान सेट करेंगे।
  उदाहरण:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  नोट: pingback_url में विशेष वर्ण URL-एन्कोड किए जाएँगे;
  यानी, # वर्ण %23 में एन्कोड होगा
  
  हमारे Help Center पर अधिक जानें
- postback_data
  टाइप: string | null
- postback_url
  टाइप: string | null
  
  टास्क परिणाम भेजने का URL
  वैकल्पिक फ़ील्ड
  टास्क पूरा होने पर हम उसके परिणामों को gzip प्रारूप में संपीड़ित करके आपके निर्दिष्ट postback_url पर POST request भेजेंगे
  आप ‘$id’ स्ट्रिंग को $id वैरिएबल और ‘$tag’ को URL-एन्कोडेड $tag वैरिएबल के रूप में उपयोग कर सकते हैं। रिक्वेस्ट भेजने से पहले हम आवश्यक मान सेट करेंगे।
  उदाहरण:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  नोट: postback_url में विशेष वर्ण URL-एन्कोड किए जाएँगे;
  यानी, # वर्ण %23 में एन्कोड होगा
  
  हमारे Help Center पर अधिक जानें
- priority
  टाइप: integer | null
  
  टास्क प्राथमिकता
  वैकल्पिक फ़ील्ड
  यह निम्न मान ले सकता है:
  1 – सामान्य निष्पादन प्राथमिकता (डिफ़ॉल्ट रूप से सेट)
  2 – उच्च निष्पादन प्राथमिकता। उच्च निष्पादन प्राथमिकता वाले टास्क के लिए आपसे अतिरिक्त शुल्क लिया जाएगा।
  लागत की गणना Pricing पेज पर की जा सकती है।
- product_id
  टाइप: string
  
  Google Shopping पर विशिष्ट उत्पाद आइडेंटिफ़ायर
  data_docid या gid निर्दिष्ट न करने पर आवश्यक फ़ील्ड
  इष्टतम परिणामों के लिए हम product_id को data_docid और gid के साथ निर्दिष्ट करने की सलाह देते हैं;
  आप किसी विशेष उत्पाद के लिए यह मान Google Shopping Products endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
  उदाहरण:
  4485466949985702538
  पैरामीटर के बारे में अधिक जानें इस Help Center गाइड में
- pvf
  टाइप: string | null
  
  Google Shopping पर उत्पाद वेरिएंट फ़िल्टर
  वैकल्पिक फ़ील्ड
  Google Shopping URL में पैरामीटर, वैकल्पिक उत्पाद वेरिएंट फ़िल्टरिंग सेट करता है;
  उदाहरण:
  Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpemUqAnhs
- se_domain
  टाइप: string | null
  
  सर्च इंजन डोमेन
  वैकल्पिक फ़ील्ड
  हम आपके निर्दिष्ट स्थान और भाषा के अनुसार उपयुक्त सर्च इंजन डोमेन स्वतः चुनते हैं
  हालाँकि, आप इस फ़ील्ड में कस्टम सर्च इंजन डोमेन सेट कर सकते हैं
  उदाहरण:
  google.co.uk, google.com.au, google.de, आदि।
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  वैकल्पिक फ़ील्ड
  अक्षर सीमा 255 है
  आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
  निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा

responses

200
टाइप: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostResponseInfo
cost
टाइप: number | null फ़ॉर्मेट: double

टास्क की कुल लागत, USD

status_code
टाइप: integer | null

सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है

status_message
टाइप: string | null

सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है

tasks
टाइप: array (object | null)[] | null

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostTaskInfo
cost
टाइप: number | null फ़ॉर्मेट: double

टास्क की कुल लागत, USD

data
टाइप: object | null

इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे

propertyName
टाइप: object | null
id
टाइप: string | null

टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में

path
टाइप: array (string | null)[] | null

URL पथ

result
टाइप: object | null

परिणामों का ऐरे
इस मामले में, मान null होगा

result_count
टाइप: integer | null फ़ॉर्मेट: int64

result ऐरे में एलिमेंट की संख्या

status_code
टाइप: integer | null

टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है

status_message
टाइप: string | null

टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है

time
टाइप: string | null

निष्पादन समय, सेकंड

tasks_count
टाइप: integer | null फ़ॉर्मेट: int64

tasks ऐरे में टास्क की संख्या

tasks_error
टाइप: integer | null फ़ॉर्मेट: int64

त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या

time
टाइप: string | null

कुल निष्पादन समय, सेकंड

version
टाइप: string | null

API का वर्तमान संस्करण
application/json
400

request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
401

एक वैध Felo API key आवश्यक है।
402

request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
403

खाते को यह ऑपरेशन करने की अनुमति नहीं है।
429

request या खर्च की सीमा तक पहुँच गए हैं।
502

सेवा request पूरा नहीं कर सकी।
503

API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
504

request संसाधित करते समय सेवा का समय समाप्त हो गया।
default

त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।

application/json

post/v1/beta/dataforseo/merchant/google/sellers/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/sellers/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "product_id": "1113158713975221117"
  }
]'

स्कीमा दिखाएँ

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

सफल ऑपरेशन

Google Shopping Sellers टास्क सेट करें

प्रमाणीकरणRequired

DataForSEO

Google Shopping Sellers टास्क सेट करें

मूल्य संदर्भ