Felo API PlatformFelo API Platform
सभी DataForSEO endpoint
v0.2.0-beta
OpenAPI 3.1.0

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

Felo API Support
MIT
सर्वर:https://openapi.felo.ai
क्लाइंट लाइब्रेरी
Shell Curl

DataForSEO

​

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

DataForSEO ऑपरेशन

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

​

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

मूल्य संदर्भ

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

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

बॉडी
आवश्यक
application/json
  • टाइप: array object[]
    • टाइप: object
      • gid
        टाइप: string
        आवश्यक

        Google Shopping पर वैश्विक उत्पाद आइडेंटिफ़ायर आवश्यक फ़ील्ड इष्टतम परिणामों के लिए हम gid को data_docid और product_id के साथ निर्दिष्ट करने की सलाह देते हैं; आप किसी विशेष उत्पाद के लिए यह मान Google Shopping Products endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं उदाहरण: 4702526954592161872 पैरामीटर के बारे में अधिक जानें इस Help Center गाइड में

      • data_docid
        टाइप: string

        SERP डेटा एलिमेंट का विशिष्ट आइडेंटिफ़ायर वैकल्पिक फ़ील्ड इष्टतम परिणामों के लिए हम data_docid को product_id और gid के साथ निर्दिष्ट करने की सलाह देते हैं; आप किसी विशेष एलिमेंट के लिए यह मान Google Shopping Products endpoint पर अलग रिक्वेस्ट भेजकर प्राप्त कर सकते हैं उदाहरण: 13071766526042404278

      • depth
        टाइप: integer

        पार्सिंग गहराई वैकल्पिक फ़ील्ड SERP में समीक्षाओं की संख्या; हम दृढ़ता से पार्सिंग गहराई को दस के गुणकों में सेट करने की सलाह देते हैं, क्योंकि हमारा सिस्टम एक बार में दस समीक्षाओं को प्रोसेस करता है; अधिकतम मान: 8000 डिफ़ॉल्ट मान: 10 आपके खाते से प्रत्येक SERP के लिए शुल्क लिया जाएगा जिसमें अधिकतम 10 परिणाम हों; 10 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 10 से अधिक परिणाम लौटाता है; लागत की गणना Pricing पेज पर की जा सकती है।

      • language_code
        टाइप: string

        सर्च इंजन भाषा कोड यदि आप language_name निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_name निर्दिष्ट करने की आवश्यकता नहीं है आप language_code पैरामीटर के साथ उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें https://api.dataforseo.com/v3/merchant/google/languages उदाहरण: en_GB

      • language_name
        टाइप: string

        सर्च इंजन भाषा का पूरा नाम यदि आप language_code निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड यदि आप यह फ़ील्ड उपयोग करते हैं, तो language_code निर्दिष्ट करने की आवश्यकता नहीं है आप language_name पैरामीटर के साथ उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें https://api.dataforseo.com/v3/merchant/google/languages उदाहरण: English (United Kingdom)

      • location_code
        टाइप: integer

        सर्च इंजन स्थान कोड यदि आप location_name या location_coordinate निर्दिष्ट नहीं करते हैं तो आवश्यक फ़ील्ड यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है आप location_code पैरामीटर के साथ उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें https://api.dataforseo.com/v3/merchant/google/locations उदाहरण: 9045969

      • 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 पैरामीटर के साथ उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं, इसके लिए अलग रिक्वेस्ट भेजें https://api.dataforseo.com/v3/merchant/google/locations उदाहरण: HA1,England,United Kingdom

      • pingback_url
        टाइप: string

        पूर्ण हुए टास्क का नोटिफ़िकेशन URL वैकल्पिक फ़ील्ड जब कोई टास्क पूरा होता है, तो हम आपके निर्दिष्ट URL पर GET request भेजकर आपको सूचित करेंगे आप ‘$id’ स्ट्रिंग को $id वेरिएबल के रूप में और ‘$tag’ को urlencoded $tag वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट करेंगे। उदाहरण: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag नोट: pingback_url में विशेष अक्षर urlencode किए जाएँगे; जैसे, # अक्षर %23 में एन्कोड होगा अधिक जानकारी हमारे Help Center पर देखें

      • postback_data
        टाइप: string

        postback_url datatype वैकल्पिक फ़ील्ड आपके सर्वर पर भेजे जाने वाले डेटाटाइप को निर्दिष्ट करता है संभावित मान: advanced

      • postback_url
        टाइप: string

        टास्क के परिणाम भेजने का URL वैकल्पिक फ़ील्ड टास्क पूरा होने पर, हम gzip फ़ॉर्मेट में संपीड़ित परिणामों के साथ POST request आपके निर्दिष्ट postback_url पर भेजेंगे आप ‘$id’ स्ट्रिंग को $id वेरिएबल के रूप में और ‘$tag’ को urlencoded $tag वेरिएबल के रूप में उपयोग कर सकते हैं। request भेजने से पहले हम आवश्यक मान सेट करेंगे। उदाहरण: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag नोट: postback_url में विशेष अक्षर urlencode किए जाएँगे; जैसे, # अक्षर %23 में एन्कोड होगा अधिक जानकारी हमारे Help Center पर देखें

      • priority
        टाइप: integer

        टास्क प्राथमिकता वैकल्पिक फ़ील्ड निम्नलिखित मान ले सकता है: 1 – सामान्य निष्पादन प्राथमिकता (डिफ़ॉल्ट रूप से सेट) 2 – उच्च निष्पादन प्राथमिकता उच्च निष्पादन प्राथमिकता वाले टास्क के लिए अतिरिक्त शुल्क लिया जाएगा। लागत मूल्य पेज पर गणना की जा सकती है।

      • product_id
        टाइप: string

        Google Shopping पर विशिष्ट उत्पाद पहचानकर्ता वैकल्पिक फ़ील्ड सर्वोत्तम परिणामों के लिए product_id को data_docid और gid के साथ निर्दिष्ट करने की सलाह देते हैं; किसी विशिष्ट उत्पाद के लिए यह मान Google Shopping Products endpoint पर अलग request भेजकर प्राप्त कर सकते हैं उदाहरण: 4485466949985702538 इस पैरामीटर के बारे में अधिक जानकारी इस Help Center गाइड में देखें

      • se_domain
        टाइप: string

        सर्च इंजन डोमेन वैकल्पिक फ़ील्ड हम आपके निर्दिष्ट स्थान और भाषा के अनुसार उपयुक्त सर्च इंजन डोमेन स्वतः चुनते हैं हालाँकि, आप इस फ़ील्ड में कस्टम सर्च इंजन डोमेन सेट कर सकते हैं उदाहरण: google.co.uk, google.com.au, google.de, आदि

      • tag
        टाइप: string

        उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर वैकल्पिक फ़ील्ड अक्षर सीमा 255 है आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं निर्दिष्ट tag मान response के data ऑब्जेक्ट में मिलेगा

      खाली ऑब्जेक्ट
      खाली ऑब्जेक्ट
responses
  • 200
    टाइप: object

    सफल response

    • cost
      टाइप: number

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

    • status_code
      टाइप: integer

      सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है नोट: हम दृढ़ता से अनुशंसा करते हैं कि संबंधित असामान्य या त्रुटि स्थितियों को संभालने के लिए आवश्यक सिस्टम डिज़ाइन करें

    • status_message
      टाइप: string

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

    • tasks
      टाइप: array string[]

      टास्क का ऐरे

    • tasks_count
      टाइप: integer

      tasksarray में टास्क की संख्या

    • tasks_error
      टाइप: integer

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

    • tasks.cost
      टाइप: number

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

    • tasks.data
      टाइप: object

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

    • tasks.id
      टाइप: string

      हमारे सिस्टम में Universally unique identifier (UUID) फ़ॉर्मेट में विशिष्ट टास्क पहचानकर्ता

    • tasks.path
      टाइप: array string[]

      URL पथ

    • tasks.result
      टाइप: array string[]

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

    • tasks.result_count
      टाइप: integer

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

    • tasks.status_code
      टाइप: integer

      DataForSEO द्वारा जनरेट किया गया टास्क का स्टेटस कोड; निम्नलिखित श्रेणी में हो सकता है: 10000-60000

    • tasks.status_message
      टाइप: string

      टास्क का सूचनात्मक संदेश

    • tasks.time
      टाइप: string

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

    • time
      टाइप: string

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

    • version
      टाइप: string

      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
Request Example for post/v1/beta/dataforseo/merchant/google/reviews/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'

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

सफल response

Setting Google Shopping Reviews Tasks