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-এর বিজ্ঞাপন স্বচ্ছতা ডেটায় একটি কোয়েরির সঙ্গে মেলা বিজ্ঞাপনদাতাদের কিউ করে এবং 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)[]
- 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-এ আলাদা রিকোয়েস্ট পাঠিয়ে 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-এ আলাদা রিকোয়েস্ট পাঠিয়ে 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-এ আরও জানুন
- 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 অবজেক্টে পাবেন

রেসপন্স

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

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

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 টাস্ক সেট করা

মূল্য রেফারেন্স