v0.2.0-beta

OpenAPI 3.1.0

Mencipta Tugas SERP Pengiklan Google Ads

Felo API Support

MIT

Pelayan

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

Mencipta Tugas SERP Pengiklan Google Ads

Menghantar pengiklan yang sepadan dengan pertanyaan dalam data ketelusan iklan Google di Google ke baris gilir dan memulangkan id tugas dalam tasks[0].id. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Pasangan langsungnya menjawab serta-merta dan lebih mudah untuk satu pertanyaan; hantar ke baris gilir apabila kelompok akan melebihi satu panggilan alat.

Rujukan harga

Pemeteran: Kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0.02.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan

application/json

Jenis: array (object | null)[]
- keyword
  Jenis: string
  
  kata kunci
  
  medan wajib
  
  anda boleh menentukan sehingga 700 aksara dalam medan keyword
  
  semua %## akan dinyahkod (aksara ‘+’ akan dinyahkod menjadi aksara ruang)
  
  jika anda perlu menggunakan aksara “%” untuk keyword, tentukan sebagai “%25”;
  
  jika anda perlu menggunakan aksara “+” untuk keyword, tentukan sebagai “%2B”
  
  ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan
- location_code
  Jenis: integer | null
  
  kod lokasi enjin carian
  
  medan pilihan
  
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate
  
  anda boleh menerima senarai lokasi enjin carian yang tersedia berserta location_code-nya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations
  
  contoh:
  
  2840
  
  Nota: jika anda tidak menentukan location_name, location_code atau location_coordinate, pengiklan akan dicari merentas semua lokasi yang tersedia
- location_coordinate
  Jenis: string | null
  
  koordinat GPS sesuatu lokasi
  
  medan pilihan
  
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code
  
  contoh:
  
  52.6178549,-155.352142
  
  Nota: jika anda tidak menentukan location_name, location_code atau location_coordinate, pengiklan akan dicari merentas semua lokasi yang tersedia
- location_name
  Jenis: string | null
  
  nama penuh lokasi enjin carian
  
  medan pilihan
  
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate
  
  anda boleh menerima senarai lokasi enjin carian yang tersedia berserta location_name-nya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations
  
  contoh:
  
  London,England,United Kingdom
  
  Nota: jika anda tidak menentukan location_name, location_code atau location_coordinate, pengiklan akan dicari merentas semua lokasi yang tersedia
- pingback_url
  Jenis: string | null
  
  URL pemberitahuan tugas yang selesai
  
  medan pilihan
  
  selepas tugas selesai, kami akan memberitahu anda dengan permintaan GET yang dihantar ke URL yang anda tentukan
  
  anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang dikodkan URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
  
  contoh:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Nota: aksara khas dalam pingback_url akan dikodkan URL;
  
  khususnya, aksara # akan dikodkan sebagai %23
  
  ketahui lebih lanjut di Pusat Bantuan kami
- postback_data
  Jenis: string
  
  jenis data postback_url
  
  medan wajib jika anda menentukan postback_url
  
  sepadan dengan fungsi yang anda gunakan untuk menetapkan tugas
  
  nilai sah:
  
  advanced
- postback_url
  Jenis: string | null
  
  URL untuk menghantar hasil tugas
  
  medan pilihan
  
  selepas tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan
  
  anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
  
  contoh:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Nota: aksara khas dalam postback_url akan di-urlencode;
  
  iaitu, aksara # akan dikodkan menjadi %23
  
  ketahui lebih lanjut di Pusat Bantuan kami
- priority
  Jenis: integer | null
  
  keutamaan tugas
  
  medan pilihan
  
  boleh mengambil nilai berikut:
  
  1 – keutamaan pelaksanaan biasa (ditetapkan secara lalai)
  
  2 – keutamaan pelaksanaan tinggi
  
  Anda akan dicaj tambahan untuk tugas dengan keutamaan pelaksanaan tinggi.
  Kos boleh dikira di halaman Harga
- tag
  Jenis: string | null
  
  pengecam tugas yang ditentukan pengguna
  
  medan pilihan
  
  had aksara ialah 255
  
  anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
  
  anda akan menemui nilai tag yang ditentukan dalam objek data respons

Respons

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

jumlah kos tugas, USD

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

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

tatasusunan tugas

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

jumlah kos tugas, USD

data
Jenis: object | null

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

propertyName
Jenis: object | null
id
Jenis: string | null

pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

Laluan URL

result
Jenis: object | null

tatasusunan hasil
dalam kes ini, nilainya akan menjadi null

result_count
Jenis: integer | null Format: int64

bilangan elemen dalam array hasil

status_code
Jenis: integer | null

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

time
Jenis: string | null

masa pelaksanaan, saat

tasks_count
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks

tasks_error
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

time
Jenis: string | null

jumlah masa pelaksanaan, saat

version
Jenis: string | null

versi semasa API
application/json
400

Permintaan tidak dapat diproses. Semak parameter permintaan.
401

Kunci API Felo yang sah diperlukan.
402

Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
403

Akaun tidak dibenarkan melakukan operasi ini.
429

Had permintaan atau had perbelanjaan telah dicapai.
502

Perkhidmatan tidak dapat menyelesaikan permintaan.
503

API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
504

Perkhidmatan tamat masa semasa memproses permintaan.
default

Respons ralat; respons passthrough huluan mungkin 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"
  }
]'

Tunjukkan 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 berjaya

Mencipta Tugas SERP Pengiklan Google Ads

PengesahanRequired

DataForSEO

Mencipta Tugas SERP Pengiklan Google Ads

Rujukan harga