v0.2.0-beta

OpenAPI 3.1.0

Google Ads Arama SERP Görevlerini Ayarlama

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

DataForSEO

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

DataForSEO İşlemler

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

Google Ads Arama SERP Görevlerini Ayarlama

Google'da bir anahtar kelimeye karşı yayınlanan reklamları kuyruğa alır ve tasks[0].id içinde bir görev id değeri döndürür. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür. Canlı eşi hemen yanıtlar ve tek bir sorgu için daha basittir; toplu iş bir araç çağrısını aşacaksa kuyruğa alın.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek tahmini: USD 0.02.
Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde

application/json

Tür: array (object | null)[]
- advertiser_ids
  Tür: array string[]
  
  reklamveren tanımlayıcıları
  
  target belirtilmezse zorunlu alan
  
  bu dizide en fazla 25 değer belirtebilirsiniz;
  
  bu parametre için advertiser_ids değerleri Google Ads Advertisers uç noktasında bulunabilir;
- date_from
  Tür: string
  
  zaman aralığının başlangıç tarihi
  
  isteğe bağlı alan
  
  date_to belirtilirse zorunlu alan;
  
  tarih biçimi: "yyyy-mm-dd"
  
  minimum değer: 2018-05-31
  
  maksimum değer: bugünün tarihi
  
  örnek:
  
  "2020-01-01"
- date_to
  Tür: string
  
  zaman aralığının bitiş tarihi
  
  isteğe bağlı alan
  
  date_from belirtilirse zorunlu alan;
  
  tarih biçimi: "yyyy-mm-dd"
  
  minimum değer: 2018-05-31
  
  maksimum değer: bugünün tarihi
  
  örnek:
  
  "2020-01-01"
- depth
  Tür: integer | null
  
  ayrıştırma derinliği
  
  isteğe bağlı alan
  
  SERP'teki sonuç sayısı
  
  varsayılan değer: 40
  
  maksimum değer: 700
  
  Hesabınız 40 sonuca kadar içeren her SERP için faturalandırılır;
  40'ın üzerinde derinlik ayarlamak arama motoru 40'tan fazla sonuç döndürürse ek ücretlere yol açabilir;
  
  Maliyet Fiyatlandırma sayfasında hesaplanabilir.
- format
  Tür: string | null
  
  reklam biçimi
  
  isteğe bağlı alan
  
  olası değerler: all, text, image, video
- location_code
  Tür: integer | null
  
  arama motoru konum kodu
  
  isteğe bağlı alan
  
  bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez
  
  arama motorlarının mevcut konumlarının listesini location_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/ads_search/locations
  
  örnek:
  
  2840
  
  Not: location_name, location_code veya location_coordinate belirtmezseniz reklamlar tüm mevcut konumlarda aranır
- location_coordinate
  Tür: string | null
  
  bir konumun GPS koordinatları
  
  isteğe bağlı alan
  
  bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez
  
  örnek:
  
  52.6178549,-155.352142
  
  Not: location_name, location_code veya location_coordinate belirtmezseniz reklamlar tüm mevcut konumlarda aranır
- location_name
  Tür: string | null
  
  arama motoru konumunun tam adı
  
  isteğe bağlı alan
  
  bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
  
  arama motorunun mevcut konumlarının listesini location_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/ads_search/locations
  
  örnek:
  
  London,England,United Kingdom
  
  Not: location_name, location_code veya location_coordinate belirtmezseniz reklamlar tüm mevcut konumlarda aranır
- pingback_url
  Tür: string | null
  
  tamamlanan görevin bildirim URL'si
  
  isteğe bağlı alan
  
  görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
  
  ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
  
  örnek:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Not: pingback_url içindeki özel karakterler URL kodlanacaktır;
  
  ör. # karakteri %23 olarak kodlanır
  
  daha fazla bilgi için Yardım Merkezimize bakın
- platform
  Tür: string | null
  
  reklam platformu
  
  isteğe bağlı alan
  
  olası değerler: all, google_play, google_maps, google_search, google_shopping, youtube
  
  varsayılan değer: all
- postback_data
  Tür: string
  
  postback_url veri türü
  
  postback_url belirtirseniz zorunlu alan
  
  görevi ayarlamak için kullandığınız işleve karşılık gelir
  
  olası değerler:
  
  advanced
- postback_url
  Tür: string | null
  
  görev sonuçlarını göndermek için URL
  
  isteğe bağlı alan
  
  görev tamamlandığında sonuçlarını gzip biçiminde sıkıştırarak belirttiğiniz postback_url adresine POST isteğiyle göndereceğiz
  
  ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
  
  örnek:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Not: postback_url içindeki özel karakterler URL kodlanır;
  
  yani, # karakteri %23 olarak kodlanır
  
  daha fazla bilgi için Yardım Merkezimize bakın
- priority
  Tür: integer | null
  
  görev önceliği
  
  isteğe bağlı alan
  
  şu değerleri alabilir:
  
  1 – normal yürütme önceliği (varsayılan olarak ayarlanır)
  
  2 – yüksek yürütme önceliği
  
  Yüksek yürütme önceliğine sahip görevler için ek ücret alınır.
  Maliyet Fiyatlandırma sayfasında hesaplanabilir.
- tag
  Tür: string | null
  
  kullanıcı tanımlı görev tanımlayıcısı
  
  isteğe bağlı alan
  
  karakter sınırı 255
  
  bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
  
  belirttiğiniz tag değerini yanıtın data nesnesinde bulacaksınız
- target
  Tür: string
  
  alan adı
  
  advertiser_ids belirtilmezse zorunlu alan
  
  reklamveren hesabıyla ilişkili alan adı

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostResponseInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

status_code
Tür: integer | null

genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

tasks
Tür: array (object | null)[] | null

görev dizisi

Tür: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostTaskInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

data
Tür: object | null

POST isteğinde belirttiğiniz parametrelerin aynısını içerir

propertyName
Tür: object | null
id
Tür: string | null

görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

path
Tür: array (string | null)[] | null

URL yolu

result
Tür: object | null

sonuç dizisi
bu durumda değer null olur

result_count
Tür: integer | null Biçim: int64

result dizisindeki öğe sayısı

status_code
Tür: integer | null

görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

time
Tür: string | null

yürütme süresi, saniye

tasks_count
Tür: integer | null Biçim: int64

tasks dizisindeki görev sayısı

tasks_error
Tür: integer | null Biçim: int64

tasks dizisinde hata ile dönen görev sayısı

time
Tür: string | null

toplam yürütme süresi, saniye

version
Tür: string | null

API'nin geçerli sürümü
application/json
400

İstek işlenemedi. İstek parametrelerini kontrol edin.
401

Geçerli bir Felo API anahtarı gerekir.
402

Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
403

Hesabın bu işlemi gerçekleştirme izni yok.
429

İstek veya harcama sınırına ulaşıldı.
502

Hizmet isteği tamamlayamadı.
503

API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
504

İstek işlenirken hizmet zaman aşımına uğradı.
default

Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

application/json

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

Şemayı göster

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

Başarılı işlem

Google Ads Arama SERP Görevlerini Ayarlama

Kimlik doğrulamaRequired

DataForSEO

Google Ads Arama SERP Görevlerini Ayarlama

Fiyatlandırma referansı