v0.2.0-beta

OpenAPI 3.1.0

Membuat Tugas SERP Pengiklan Google Ads

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operasi

post/v1/beta/dataforseo/serp/google/ads_advertisers/task_post

Membuat Tugas SERP Pengiklan Google Ads

Mengantrekan pengiklan yang cocok dengan kueri dalam data transparansi iklan Google di Google, mengembalikan id tugas di tasks[0].id. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Pasangan live-nya menjawab segera dan lebih sederhana untuk satu kueri; antrekan bila batch akan melebihi satu panggilan alat.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.02.
Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi

application/json

Tipe: array (object | null)[]
- keyword
  Tipe: string
  
  kata kunci
  
  field wajib
  
  Anda dapat menentukan hingga 700 karakter di field keyword
  
  semua %## akan didekode (karakter ‘+’ akan didekode menjadi karakter spasi)
  
  jika Anda perlu menggunakan karakter “%” untuk keyword, tentukan sebagai “%25”;
  
  jika Anda perlu menggunakan karakter “+” untuk keyword, tentukan sebagai “%2B”
  
  pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan
- location_code
  Tipe: integer | null
  
  kode lokasi mesin pencari
  
  field opsional
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate
  
  Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations
  
  contoh:
  
  2840
  
  Catatan: jika Anda tidak menentukan location_name, location_code, atau location_coordinate, pengiklan akan dicari di semua lokasi yang tersedia
- location_coordinate
  Tipe: string | null
  
  koordinat GPS suatu lokasi
  
  field opsional
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code
  
  contoh:
  
  52.6178549,-155.352142
  
  Catatan: jika Anda tidak menentukan location_name, location_code, atau location_coordinate, pengiklan akan dicari di semua lokasi yang tersedia
- location_name
  Tipe: string | null
  
  nama lengkap lokasi mesin pencari
  
  field opsional
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate
  
  Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations
  
  contoh:
  
  London,England,United Kingdom
  
  Catatan: jika Anda tidak menentukan location_name, location_code, atau location_coordinate, pengiklan akan dicari di semua lokasi yang tersedia
- pingback_url
  Tipe: string | null
  
  URL notifikasi tugas yang selesai
  
  field opsional
  
  setelah tugas selesai, kami akan memberi tahu Anda dengan permintaan GET yang dikirim ke URL yang Anda tentukan
  
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang dienkode URL. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.
  
  contoh:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Catatan: karakter khusus di pingback_url akan dienkode URL;
  
  khususnya, karakter # akan dienkode menjadi %23
  
  pelajari lebih lanjut di Pusat Bantuan kami
- postback_data
  Tipe: string
  
  tipe data postback_url
  
  field wajib jika Anda menentukan postback_url
  
  sesuai dengan fungsi yang Anda gunakan untuk menyetel tugas
  
  nilai yang mungkin:
  
  advanced
- postback_url
  Tipe: string | null
  
  URL untuk mengirim hasil tugas
  
  field opsional
  
  setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan
  
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.
  
  contoh:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Catatan: karakter khusus dalam postback_url akan di-urlencode;
  
  yaitu, karakter # akan dienkode menjadi %23
  
  pelajari selengkapnya di Pusat Bantuan kami
- priority
  Tipe: integer | null
  
  prioritas tugas
  
  field opsional
  
  dapat mengambil nilai berikut:
  
  1 – prioritas eksekusi normal (ditetapkan secara default)
  
  2 – prioritas eksekusi tinggi
  
  Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi.
  Biaya dapat dihitung di halaman Harga
- tag
  Tipe: string | null
  
  pengenal tugas yang ditentukan pengguna
  
  field opsional
  
  batas karakter adalah 255
  
  Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
  
  Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

Respons

200
Tipe: object | null · Response36Afe1097B20_SerpGoogleAdsAdvertisersTaskPostResponseInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

tasks
Tipe: array (object | null)[] | null

array tugas

Tipe: object | null · Response36Afe1097B20_SerpGoogleAdsAdvertisersTaskPostTaskInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

data
Tipe: object | null

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

propertyName
Tipe: object | null
id
Tipe: string | null

pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

path
Tipe: array (string | null)[] | null

Jalur URL

result
Tipe: object | null

array hasil
dalam kasus ini, nilainya akan menjadi null

result_count
Tipe: integer | null Format: int64

jumlah elemen dalam array hasil

status_code
Tipe: integer | null

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

time
Tipe: string | null

waktu eksekusi, detik

tasks_count
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks

tasks_error
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks yang dikembalikan dengan error

time
Tipe: string | null

total waktu eksekusi, detik

version
Tipe: string | null

versi API saat ini
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat menggunakan format penyedia

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"
  }
]'

Tampilkan Skema

{
  "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
    }
  ]
}

Operasi berhasil

Membuat Tugas SERP Pengiklan Google Ads

AutentikasiRequired

DataForSEO

Membuat Tugas SERP Pengiklan Google Ads

Referensi harga