Google Ads Search 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_search/task_post

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

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)[]
- advertiser_ids
  टाइप: array string[]
  
  विज्ञापनदाता आइडेंटिफ़ायर
  
  आवश्यक फ़ील्ड यदि target निर्दिष्ट नहीं है
  
  इस सरणी में अधिकतम 25 मान निर्दिष्ट कर सकते हैं;
  
  इस पैरामीटर के advertiser_ids मान Google Ads Advertisers endpoint में मिल सकते हैं;
- date_from
  टाइप: string
  
  समय सीमा की प्रारंभ तिथि
  
  वैकल्पिक फ़ील्ड
  
  आवश्यक फ़ील्ड यदि date_to निर्दिष्ट है;
  
  तिथि प्रारूप: "yyyy-mm-dd"
  
  न्यूनतम मान: 2018-05-31
  
  अधिकतम मान: आज की तिथि
  
  उदाहरण:
  
  "2020-01-01"
- date_to
  टाइप: string
  
  समय सीमा की समाप्ति तिथि
  
  वैकल्पिक फ़ील्ड
  
  आवश्यक फ़ील्ड यदि date_from निर्दिष्ट है;
  
  तिथि प्रारूप: "yyyy-mm-dd"
  
  न्यूनतम मान: 2018-05-31
  
  अधिकतम मान: आज की तिथि
  
  उदाहरण:
  
  "2020-01-01"
- depth
  टाइप: integer | null
  
  पार्सिंग गहराई
  
  वैकल्पिक फ़ील्ड
  
  SERP में परिणामों की संख्या
  
  डिफ़ॉल्ट मान: 40
  
  अधिकतम मान: 700
  
  आपके खाते से प्रत्येक SERP के लिए शुल्क लिया जाएगा जिसमें अधिकतम 40 परिणाम हों;
  40 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि सर्च इंजन 40 से अधिक परिणाम लौटाता है;
  
  लागत की गणना Pricing पेज पर की जा सकती है
- format
  टाइप: string | null
  
  विज्ञापन प्रारूप
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान: all, text, image, video
- location_code
  टाइप: integer | null
  
  सर्च इंजन स्थान कोड
  
  वैकल्पिक फ़ील्ड
  
  यदि आप यह फ़ील्ड उपयोग करते हैं, तो location_name या location_coordinate निर्दिष्ट करने की आवश्यकता नहीं है
  
  आप https://api.dataforseo.com/v3/serp/google/ads_search/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_search/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 पर अधिक जानें
- platform
  टाइप: string | null
  
  विज्ञापन प्लेटफ़ॉर्म
  
  वैकल्पिक फ़ील्ड
  
  संभावित मान: all, google_play, google_maps, google_search, google_shopping, youtube
  
  डिफ़ॉल्ट मान: all
- 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 ऑब्जेक्ट में पाएँगे
- target
  टाइप: string
  
  डोमेन नाम
  
  आवश्यक फ़ील्ड यदि advertiser_ids निर्दिष्ट नहीं है
  
  विज्ञापनदाता खाते से जुड़ा डोमेन नाम

responses

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

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

status_code
टाइप: integer | null

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

status_message
टाइप: string | null

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

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

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostTaskInfo
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_search/task_post

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

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

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

प्रमाणीकरणRequired

DataForSEO

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

मूल्य संदर्भ