Google Ads Advertisers SERP टास्क सेट करना

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/serp/google/ads_advertisers/task_post

Google Ads Advertisers SERP टास्क सेट करना

Google पर Google के विज्ञापन पारदर्शिता डेटा में किसी क्वेरी से मेल खाने वाले विज्ञापनदाताओं को कतार में डालता है, और tasks[0].id में task id लौटाता है। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है। लाइव जुड़वाँ तुरंत उत्तर देता है और एक ही क्वेरी के लिए सरल है; जब पूरा बैच एक टूल कॉल से अधिक समय ले, तब कतार में डालें।

मूल्य संदर्भ

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

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

बॉडी

application/json

टाइप: array (object | null)[]
- keyword
  टाइप: string
  
  कीवर्ड
  
  आवश्यक फ़ील्ड
  
  आप keyword फ़ील्ड में अधिकतम 700 अक्षर निर्दिष्ट कर सकते हैं
  
  सभी %## डिकोड किए जाएँगे (‘+’ अक्षर एक स्पेस अक्षर में डिकोड होगा)
  
  यदि आपको keyword में “%” उपयोग करना है, तो उसे “%25” के रूप में निर्दिष्ट करें;
  
  यदि आपको keyword में “+” उपयोग करना है, तो उसे “%2B” के रूप में निर्दिष्ट करें
  
  DataForSEO API में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में Help Center लेख में जानें
- location_code
  टाइप: integer | null
  
  सर्च इंजन स्थान कोड
  
  वैकल्पिक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations पर अलग request भेजकर location_code के साथ सर्च इंजन के उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं
  
  उदाहरण:
  
  2840
  
  नोट: यदि location_name, location_code या location_coordinate में से कोई भी निर्दिष्ट नहीं है, तो हम सभी उपलब्ध स्थानों में विज्ञापनदाताओं को खोजेंगे
- location_coordinate
  टाइप: string | null
  
  स्थान के GPS निर्देशांक
  
  वैकल्पिक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_code निर्दिष्ट करने की आवश्यकता नहीं है
  
  उदाहरण:
  
  52.6178549,-155.352142
  
  नोट: यदि location_name, location_code या location_coordinate में से कोई भी निर्दिष्ट नहीं है, तो हम सभी उपलब्ध स्थानों में विज्ञापनदाताओं को खोजेंगे
- location_name
  टाइप: string | null
  
  सर्च इंजन स्थान का पूरा नाम
  
  वैकल्पिक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_code या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations पर अलग request भेजकर location_name के साथ सर्च इंजन के उपलब्ध स्थानों की सूची प्राप्त कर सकते हैं
  
  उदाहरण:
  
  London,England,United Kingdom
  
  नोट: यदि location_name, location_code या location_coordinate में से कोई भी निर्दिष्ट नहीं है, तो हम सभी उपलब्ध स्थानों में विज्ञापनदाताओं को खोजेंगे
- pingback_url
  टाइप: string | null
  
  पूर्ण टास्क का नोटिफिकेशन 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 में विशेष अक्षर urlencoded किए जाएँगे;
  
  अर्थात, # अक्षर %23 में एन्कोड किया जाएगा
  
  हमारे Help Center पर अधिक जानें
- postback_data
  टाइप: string
  
  postback_url डेटाटाइप
  
  postback_url निर्दिष्ट करने पर आवश्यक फ़ील्ड
  
  टास्क सेट करने के लिए उपयोग किए गए फ़ंक्शन से मेल खाता है
  
  संभावित मान:
  
  advanced
- postback_url
  टाइप: string | null
  
  टास्क परिणाम भेजने के लिए 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 | null
  
  टास्क प्राथमिकता
  
  वैकल्पिक फ़ील्ड
  
  यह निम्न मान ले सकता है:
  
  1 – सामान्य निष्पादन प्राथमिकता (डिफ़ॉल्ट रूप से सेट)
  
  2 – उच्च निष्पादन प्राथमिकता
  
  उच्च निष्पादन प्राथमिकता वाले टास्क के लिए आपसे अतिरिक्त शुल्क लिया जाएगा
  लागत की गणना Pricing पेज पर की जा सकती है
- tag
  टाइप: string | null
  
  उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
  
  वैकल्पिक फ़ील्ड
  
  अक्षर सीमा 255 है
  
  आप इस पैरामीटर का उपयोग टास्क की पहचान करने और उसे परिणाम से मिलाने के लिए कर सकते हैं
  
  आप निर्दिष्ट tag मान response के data ऑब्जेक्ट में पाएँगे

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_SerpGoogleAdsAdvertisersTaskPostTaskInfo
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/serp/google/ads_advertisers/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_advertisers/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keyword": "apple"
  }
]'

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

{
  "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 Ads Advertisers SERP टास्क सेट करना

प्रमाणीकरणRequired

DataForSEO

Google Ads Advertisers SERP टास्क सेट करना

मूल्य संदर्भ