Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
v0.2.0-beta
OpenAPI 3.1.0

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 آپریشنز

Google Ads Search SERP ٹاسکس سیٹ کرنا

​

Google پر کسی کی ورڈ کے خلاف چلنے والے اشتہارات کو قطار میں ڈالتا ہے اور tasks[0].id میں ٹاسک id واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ لائیو ہم منصب فوراً جواب دیتا ہے اور ایک ہی کوئری کے لیے آسان ہے؛ جب بیچ ٹول کال سے زیادہ طویل ہو تو قطار میں ڈالیں۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: 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 متعین کرنے کی ضرورت نہیں

      آپ سرچ انجنوں کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ https://api.dataforseo.com/v3/serp/google/ads_search/locations پر الگ درخواست بھیج کر حاصل کر سکتے ہیں

      مثال:

      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 متعین کرنے کی ضرورت نہیں

      آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے location_name کے ساتھ https://api.dataforseo.com/v3/serp/google/ads_search/locations پر الگ درخواست بھیج کر حاصل کر سکتے ہیں

      مثال:

      London,England,United Kingdom


      نوٹ: اگر آپ location_name، location_code یا location_coordinate متعین نہ کریں تو اشتہارات تمام دستیاب مقامات میں تلاش کیے جائیں گے

    • pingback_url
      قسم: string | null

      مکمل شدہ ٹاسک کا اطلاعاتی URL

      اختیاری فیلڈ

      ٹاسک مکمل ہونے پر ہم آپ کے متعین کردہ URL پر GET درخواست بھیج کر آپ کو مطلع کریں گے

      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ درخواست بھیجنے سے پہلے ہم ضروری اقدار سیٹ کریں گے۔

      مثال:

      http://your-server.com/pingscript?id=$id

      http://your-server.com/pingscript?id=$id&tag=$tag

      نوٹ: pingback_url میں خصوصی حروف urlencode ہوں گے؛

      یعنی # حرف %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 فارمیٹ میں کمپریس کر کے آپ کے متعین کردہ postback_url پر POST درخواست کے ذریعے بھیجیں گے

      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ درخواست بھیجنے سے پہلے ہم ضروری اقدار سیٹ کریں گے۔

      مثال:

      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 قدر جواب کے data آبجیکٹ میں ملے گی

    • target
      قسم: string

      ڈومین نام

      اگر advertiser_ids متعین نہ ہو تو درکار فیلڈ

      اشتہار دہندہ اکاؤنٹ سے منسلک ڈومین نام

جوابات
  • 200
    قسم: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

      ٹاسکس کی کل لاگت، USD

    • status_code
      قسم: integer | null

      عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

    • status_message
      قسم: string | null

      عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

    • tasks
      قسم: array (object | null)[] | null

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostTaskInfo
        • cost
          قسم: number | null فارمیٹ: double

          ٹاسکس کی کل لاگت، USD

        • data
          قسم: object | null

          وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

          • 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 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

        • 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

    درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔

  • 401

    درست Felo API کلید درکار ہے۔

  • 402

    درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔

  • 403

    اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔

  • 429

    درخواست یا اخراجات کی حد پوری ہو گئی ہے۔

  • 502

    سروس درخواست مکمل نہیں کر سکی۔

  • 503

    API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔

  • 504

    درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔

  • default

    خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

    application/json
Request Example for 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
    }
  ]
}

کامیاب آپریشن

Setting Google Ads Search SERP Tasks