Google Shopping Product Info टास्क सेट करें
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Shopping Product Info टास्क सेट करें
एक विशिष्ट Google Shopping उत्पाद की लुकअप कतार में डालता है और टास्क id लौटाता है। उत्पाद को product_id तथा get_dataforseo_merchant_google_products_fetch परिणाम से लिए गए gid या data_docid से पहचानें। यह पूरी फ़ैमिली असिंक्रोनस है: सबमिट टास्क id को tasks[0].id में लौटाता है और फ़ेच टूल तैयार होने पर परिणाम लौटाता है। get_dataforseo_merchant_google_product_info_fetch से प्राप्त करें।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.012
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- dataटाइप: string
_docid SERP डेटा एलिमेंट का विशिष्ट आइडेंटिफ़ायर
product_idयाgidनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
इष्टतम परिणामों के लिए हमdata_docidकोproduct_idऔरgidके साथ निर्दिष्ट करने की सलाह देते हैं;
आप किसी विशेष एलिमेंट के लिए यह मान Google Shopping Products endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
उदाहरण:13071766526042404278 - gidटाइप: string
Google Shopping पर वैश्विक उत्पाद आइडेंटिफ़ायर
product_idयाdata_docidनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
इष्टतम परिणामों के लिए हमgidकोproduct_idऔरdata_docidके साथ निर्दिष्ट करने की सलाह देते हैं;
आप किसी विशेष उत्पाद के लिए यह मान Google Shopping Products endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
उदाहरण:4702526954592161872
पैरामीटर के बारे में अधिक जानें इस Help Center गाइड में - languageटाइप: string
_code भाषा कोड
language_nameनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlanguage_nameनिर्दिष्ट करने की आवश्यकता नहीं है
आपlanguage_codeके साथ उपलब्ध Google Shopping भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/merchant/google/languages
उदाहरण:en - languageटाइप: string
_name भाषा का पूरा नाम
language_codeनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlanguage_codeनिर्दिष्ट करने की आवश्यकता नहीं है
आपlanguage_nameके साथ उपलब्ध Google Shopping भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/merchant/google/languages
उदाहरण:English - locationटाइप: integer
_code स्थान कोड
location_nameयाlocation_coordinateनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_nameयाlocation_coordinateनिर्दिष्ट करने की आवश्यकता नहीं है
आपlocation_codeके साथ उपलब्ध Google Shopping स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें:https://api.dataforseo.com/v3/merchant/google/locations
उदाहरण:2840 - locationटाइप: string
_coordinate स्थान के 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टाइप: string
_name स्थान का पूरा नाम
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टाइप: string | null
_url पूर्ण टास्क का नोटिफ़िकेशन URL
वैकल्पिक फ़ील्ड
टास्क पूरा होने पर हम आपके निर्दिष्ट URL पर GET request भेजकर सूचित करेंगे
आप ‘$id’ स्ट्रिंग को$idवैरिएबल और ‘$tag’ को URL-एन्कोडेड$tagवैरिएबल के रूप में उपयोग कर सकते हैं। रिक्वेस्ट भेजने से पहले हम आवश्यक मान सेट करेंगे।
उदाहरण:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
नोट:pingback_urlमें विशेष वर्ण URL-एन्कोड किए जाएँगे;
यानी,#वर्ण%23में एन्कोड होगा - postbackटाइप: string | null
_data postback_url डेटाटाइप
वैकल्पिक फ़ील्ड
उस डेटाटाइप से मेल खाता है जो आपके सर्वर पर भेजा जाएगा
संभावित मान:advanced - postbackटाइप: string | null
_url टास्क परिणाम भेजने का URL
वैकल्पिक फ़ील्ड
टास्क पूरा होने पर हम उसके परिणामों कोgzipप्रारूप में संपीड़ित करके आपके निर्दिष्टpostback_urlपर POST request भेजेंगे
आप ‘$id’ स्ट्रिंग को$idवैरिएबल और ‘$tag’ को URL-एन्कोडेड$tagवैरिएबल के रूप में उपयोग कर सकते हैं। रिक्वेस्ट भेजने से पहले हम आवश्यक मान सेट करेंगे।
उदाहरण:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
नोट:postback_urlमें विशेष वर्ण URL-एन्कोड किए जाएँगे;
यानी,#वर्ण%23में एन्कोड होगा - priorityटाइप: integer | null
- productटाइप: string
_id Google Shopping पर विशिष्ट उत्पाद आइडेंटिफ़ायर
data_docidयाgidनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
इष्टतम परिणामों के लिए हमproduct_idकोdata_docidऔरgidके साथ निर्दिष्ट करने की सलाह देते हैं;
आप किसी विशेष उत्पाद के लिए यह मान Google Shopping Products endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं
उदाहरण:4485466949985702538
पैरामीटर के बारे में अधिक जानें इस Help Center गाइड में - seटाइप: string | null
_domain सर्च इंजन डोमेन
वैकल्पिक फ़ील्ड
हम आपके द्वारा निर्दिष्ट स्थान और भाषा के अनुसार प्रासंगिक सर्च इंजन डोमेन स्वचालित रूप से चुनते हैं
हालाँकि, आप इस फ़ील्ड में कस्टम सर्च इंजन डोमेन सेट कर सकते हैं
उदाहरण:google.co.uk,google.com.au,google.de, आदि - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा
- टाइप: object | null · Response36Afe1097B20_MerchantGoogleProductInfoTaskPostResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_MerchantGoogleProductInfoTaskPostTaskInfo
- costटाइप: number | null फ़ॉर्मेट: double
टास्क की कुल लागत, USD
- dataटाइप: object | null
इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- propertyटाइप: object | null
Name
- idटाइप: string | null
टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में
- pathटाइप: array (string | null)[] | null
URL पथ
- resultटाइप: object | null
परिणामों का ऐरे
इस मामले में, मानnullहोगा - resultटाइप: integer | null फ़ॉर्मेट: int64
_count result ऐरे में एलिमेंट की संख्या
- statusटाइप: integer | null
_code टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है
- statusटाइप: string | null
_message टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- timeटाइप: string | null
निष्पादन समय, सेकंड
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_count tasks ऐरे में टास्क की संख्या
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_error त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या
- टाइप: string | nulltime
कुल निष्पादन समय, सेकंड
- टाइप: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/product_info/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
}
]
}