v0.2.0-beta

OpenAPI 3.1.0

Google My Business soru ve cevap görevlerini oluşturma

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/business_data/google/questions_and_answers/task_post

Google My Business soru ve cevap görevlerini oluşturma

Bir Google Business Profile üzerindeki soruları ve cevapları kuyruğa alır ve bir görev id değeri döndürür. Yanıt DataForSEO zarfı içinde gelir: veriler tasks[0].result, sonuç tasks[0].status_code içindedir; reddedilen bir istek yine de HTTP 200 döndürür.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek maliyeti tahmini: USD 0.2428.
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)[]
- depth
  Tür: integer | null
  
  ayrıştırma derinliği
  isteğe bağlı alan
  sonuçtaki soru satırı sayısı
  varsayılan değer: 20
  maksimum değer: 700
  Hesabınızdan 20 sonuca kadar içeren her SERP için ücret alınır;
  20 üzerinde derinlik ayarlamak, arama motoru 20'den fazla sonuç döndürürse ek ücretlere yol açabilir;
  belirtilen derinlik yanıttaki soru sayısından yüksekse fark otomatik olarak hesap bakiyenize iade edilir;
  maliyet Fiyatlandırma sayfasında hesaplanabilir.
- keyword
  Tür: string
  
  anahtar kelime
  zorunlu alan
  belirttiğiniz anahtar kelime yerel işletmenin adını göstermelidir
  keyword alanında en fazla 700 karakter belirtebilirsiniz
  tüm %## dizileri çözümlenir (“+” karakteri boşluk karakterine çözümlenir)
  keyword için “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin;
  
  bu alan ayrıca şu parametreleri geçirmek için kullanılabilir:
  cid - işletmenin Google tarafından tanımlanan benzersiz kimliği;
  place_id - işletmenin Google Maps kimliği;
  
  örnek:
  cid:194604053573767737
  place_id:GhIJQWDl0CIeQUARxks3icF8U8A
  
  cid ve place_id kimlikleri hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz
  
  DataForSEO API'lerindeki keyword ve keywords alanlarının kuralları ve sınırlamaları hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz
- language_code
  Tür: string
  
  arama motoru dil kodu
  belirtmezseniz zorunlu alan language_name
  bu alanı kullanırsanız language_name belirtmeniz gerekmez
  mevcut dillerin listesini language_code değerleriyle birlikte https://api.dataforseo.com/v3/business_data/google/languages adresine ayrı bir istek yaparak alabilirsiniz
  örnek:
  en
- language_name
  Tür: string
  
  arama motoru dilinin tam adı
  belirtmezseniz zorunlu alan language_code
  bu alanı kullanırsanız language_code belirtmeniz gerekmez
  mevcut dillerin listesini language_name değerleriyle birlikte https://api.dataforseo.com/v3/business_data/google/languages adresine ayrı bir istek yaparak alabilirsiniz
  örnek:
  English
- location_code
  Tür: integer
  
  arama motoru konum kodu
  location_name veya location_coordinate belirtmezseniz zorunlu alan
  bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez
  kullanılabilir konumların listesini location_code değerleriyle birlikte https://api.dataforseo.com/v3/business_data/google/locations adresine ayrı bir istek yaparak alabilirsiniz
  örnek:
  2840
- location_coordinate
  Tür: string
  
  bir konumun GPS koordinatları
  belirtmezseniz zorunlu alan location_name veya location_code
  bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez
  location_coordinate parametresi "latitude,longitude,radius" biçiminde belirtilmelidir
  "latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7
  "radius" için minimum değer: 199.9 (mm)
  "radius" için maksimum değer: 199999 (mm)
  örnek:
  53.476225,-2.243572,200
- location_name
  Tür: string
  
  arama motoru konumunun tam adı
  belirtmezseniz zorunlu alan location_code veya location_coordinate
  bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
  mevcut konumların listesini location_name değerleriyle birlikte https://api.dataforseo.com/v3/business_data/google/locations adresine ayrı bir istek yaparak alabilirsiniz
  örnek:
  London,England,United Kingdom
- 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 bir GET isteğiyle sizi bilgilendiririz
  “$id” dizesini $id değişkeni, “$tag” dizesini URL kodlamalı $tag değişkeni olarak kullanabilirsiniz. İstek gönderilmeden önce gerekli değerleri ayarları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 kodlamalı olur;
  yani # karakteri %23 olarak kodlanır
  daha fazla bilgi için yardım merkezimize göz atın
- 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
  belirtilen tag değerini yanıtın data nesnesinde bulacaksınız

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersTaskPostResponseInfo
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_BusinessDataGoogleQuestionsAndAnswersTaskPostTaskInfo
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/business_data/google/questions_and_answers/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "Los Angeles,California,United States",
    "keyword": "The Last Bookstore"
  }
]'

Ş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 My Business soru ve cevap görevlerini oluşturma

Kimlik doğrulamaRequired

DataForSEO

Google My Business soru ve cevap görevlerini oluşturma

Fiyatlandırma referansı