Felo API PlatformFelo API Platform
সব DataForSEO endpoint
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-এ একটি task 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


      সর্বোচ্চ 40টি ফলাফলযুক্ত প্রতিটি SERP-এর জন্য আপনার অ্যাকাউন্ট থেকে চার্জ নেওয়া হবে;

      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-এ আলাদা রিকোয়েস্ট পাঠিয়ে 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-এ আলাদা রিকোয়েস্ট পাঠিয়ে location_name-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকা পেতে পারেন

      উদাহরণ:

      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-এর বিশেষ অক্ষর 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 রিকোয়েস্ট আপনার নির্দিষ্ট করা postback_url-এ পাঠাব

      আপনি ‘$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 মান response-এর data অবজেক্টে পাবেন

    • target
      টাইপ: string

      ডোমেইন নাম

      আবশ্যক ফিল্ড যদি advertiser_ids উল্লেখ না থাকে

      বিজ্ঞাপনদাতা অ্যাকাউন্টের সাথে যুক্ত ডোমেইন নাম

রেসপন্স
  • 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 রিকোয়েস্টে আপনি যে প্যারামিটারগুলো নির্দিষ্ট করেছিলেন সেগুলোই থাকে

          • 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

    রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।

  • 401

    একটি বৈধ Felo API key আবশ্যক।

  • 402

    বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।

  • 403

    অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।

  • 429

    রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।

  • 502

    পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।

  • 503

    API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।

  • 504

    রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।

  • default

    ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।

    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