Business Data Google विस्तारित रिव्यू टास्क सेट करें
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Business Data Google विस्तारित रिव्यू टास्क सेट करें
किसी व्यवसाय के लिए पूरा Google रिव्यू इतिहास, मानक endpoint जो पहला पेज लौटाता है उससे आगे, क्यू करता है और टास्क id लौटाता है। DataForSEO के एनवेलप में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में - अस्वीकृत request भी HTTP 200 लौटाती है। get_dataforseo_business_google_extended_reviews_fetch से प्राप्त करें; छोटा संस्करण post_dataforseo_business_google_reviews_submit है।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट की गई response लागत
- संदर्भ request अनुमान: USD 0.2428
- संदर्भ ग्राहक गुणक: 1.0। पहले से निपटाई गई ग्राहक राशि पर इसे दोबारा न लगाएँ
केवल संदर्भ मेटाडेटा, कोई खाता कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। संसाधन क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगाए जाते हैं।
- टाइप: array (object | null)[]
- cidटाइप: string
व्यवसाय इकाई की अद्वितीय, Google-निर्धारित id
keywordयाplace_idनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
उदाहरण:194604053573767737
इस पहचानकर्ता के बारे में इस Help Center लेख में जानेंनोट: यदि आप यह फ़ील्ड उपयोग करते हैं, तो Google Reviews API से जुड़े टास्क के लिए आपके खाते से मानक दर से दोगुना शुल्क लिया जाएगा
- depthटाइप: integer | null
पार्सिंग गहराई
वैकल्पिक फ़ील्ड
SERP में रिव्यू की संख्या
हम पार्सिंग गहराई को बीस के गुणकों में सेट करने की दृढ़ता से सलाह देते हैं, क्योंकि हमारे सिस्टम एक बार में बीस रिव्यू प्रोसेस करते हैं
डिफ़ॉल्ट मान:20
अधिकतम मान:1000आपके खाते से प्रत्येक SERP के लिए शुल्क लिया जाएगा जिसमें अधिकतम 20 परिणाम हों;
20 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 20 से अधिक परिणाम लौटाता है;
लागत की गणना Pricing पेज पर की जा सकती है। - keywordटाइप: string
कीवर्ड
cidयाplace_idनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
आपके द्वारा निर्दिष्ट कीवर्ड स्थानीय प्रतिष्ठान का नाम दर्शाना चाहिए;keywordफ़ील्ड में अधिकतम 700 अक्षर निर्दिष्ट कर सकते हैं;
सभी %## डिकोड किए जाएँगे (‘+’ अक्षर स्पेस अक्षर में डिकोड होगा)
यदिkeywordके लिए “%” अक्षर उपयोग करना हो, तो उसे “%25” के रूप में निर्दिष्ट करें;
यदि इस फ़ील्ड में ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’ जैसे पैरामीटर हैं, तो प्रति टास्क शुल्क 5 गुना हो जाएगा
नोट: ‘cache:’ पैरामीटर वाली क्वेरी समर्थित नहीं हैं और validation error लौटाएँगीDataForSEO API में
keywordऔरkeywordsफ़ील्ड के नियमों और सीमाओं के बारे में इस Help Center लेख में जानेंनोट: यदि आप यह फ़ील्ड उपयोग करते हैं, तो Google Reviews API से जुड़े टास्क के लिए आपके खाते से मानक दर से तीन गुना शुल्क लिया जाएगा
- languageटाइप: string
_code सर्च इंजन भाषा कोड
language_nameनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlanguage_nameनिर्दिष्ट करने की आवश्यकता नहीं है
आपhttps://api.dataforseo.com/v3/business_data/google/languagesपर अलग रिक्वेस्ट भेजकरlanguage_codeके साथ उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं
उदाहरण:enn - languageटाइप: string
_name सर्च इंजन भाषा का पूरा नाम
language_codeनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlanguage_codeनिर्दिष्ट करने की आवश्यकता नहीं है
आपhttps://api.dataforseo.com/v3/business_data/google/languagesपर अलग रिक्वेस्ट भेजकरlanguage_nameके साथ उपलब्ध भाषाओं की सूची प्राप्त कर सकते हैं
उदाहरण:English - locationटाइप: integer
_code सर्च इंजन स्थान कोड
location_nameयाlocation_coordinateनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_nameयाlocation_coordinateनिर्दिष्ट करने की आवश्यकता नहीं है
आपhttps://api.dataforseo.com/v3/business_data/google/locationsपर अलग रिक्वेस्ट भेजकरlocation_codeके साथ उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं
उदाहरण:2840n - 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,200n - locationटाइप: string
_name सर्च इंजन स्थान का पूरा नाम
location_codeयाlocation_coordinateनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
यदि आप यह फ़ील्ड उपयोग करते हैं, तोlocation_codeयाlocation_coordinateनिर्दिष्ट करने की आवश्यकता नहीं है
आपlocation_nameके साथ उपलब्ध स्थानों की सूचीhttps://api.dataforseo.com/v3/business_data/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में एन्कोड होगा - placeटाइप: string
_id Google Maps में व्यवसाय इकाई का आइडेंटिफ़ायर
keywordयाcidनिर्दिष्ट न करने पर आवश्यक फ़ील्ड
उदाहरण:GhIJQWDl0CIeQUARxks3icF8U8A
आइडेंटिफ़ायर के बारे में इस Help Center लेख में अधिक जानेंनोट: यदि आप यह फ़ील्ड उपयोग करते हैं, तो Google Reviews API से जुड़े टास्क के लिए आपके खाते से मानक दर से दोगुना शुल्क लिया जाएगा
- 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
- tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा
- टाइप: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskPostResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskPostTaskInfo
- 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/business_data/google/extended_reviews/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_name": "London,England,United Kingdom",
"language_name": "english",
"cid": "17626775537598922320"
}
]'
{
"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
}
]
}