Canlı Google My Business soru ve cevap görevlerini oluşturma
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı Google My Business soru ve cevap görevlerini oluşturma
Bir Google Business Profile üzerindeki sorular ve cevaplar, keyword ve location_code ile bulunur. keyword, se_domain, location_code, language_code, check_url, datetime, cid, feature_id ve item_types 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.
- Tür: array (object | null)[]
- depthTür: integer | null
ayrıştırma derinliği
isteğe bağlı alan
SERP'teki sonuç sayısı
varsayılan değer:20
maksimum değer:100
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. - keywordTür: string
anahtar kelime
zorunlu alan
belirttiğiniz anahtar kelime yerel işletmenin adını göstermelidirkeywordalanında en fazla 700 karakter belirtebilirsiniz
tüm %## dizileri çözümlenir (“+” karakteri boşluk karakterine çözümlenir)keywordiç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:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Acidveplace_idkimlikleri hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsinizDataForSEO API'lerindeki
keywordvekeywordsalanlarının kuralları ve sınırlamaları hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz - languageTür: string
_code arama motoru dil kodu
belirtmezseniz zorunlu alanlanguage_name
bu alanı kullanırsanızlanguage_namebelirtmeniz gerekmez
mevcut dillerin listesinilanguage_codedeğerleriyle birliktehttps://api.dataforseo.com/v3/business_data/google/languagesadresine ayrı bir istek yaparak alabilirsiniz
örnek:en - languageTür: string
_name arama motoru dilinin tam adı
belirtmezseniz zorunlu alanlanguage_code
bu alanı kullanırsanızlanguage_codebelirtmeniz gerekmez
mevcut dillerin listesinilanguage_namedeğerleriyle birliktehttps://api.dataforseo.com/v3/business_data/google/languagesadresine ayrı bir istek yaparak alabilirsiniz
örnek:English - locationTür: integer
_code arama motoru konum kodu
location_nameveyalocation_coordinatebelirtmezseniz zorunlu alan
bu alanı kullanırsanızlocation_nameveyalocation_coordinatebelirtmeniz gerekmez
kullanılabilir konumların listesinilocation_codedeğerleriyle birliktehttps://api.dataforseo.com/v3/business_data/google/locationsadresine ayrı bir istek yaparak alabilirsiniz
örnek:2840 - locationTür: string
_coordinate bir konumun GPS koordinatları
belirtmezseniz zorunlu alanlocation_nameveyalocation_code
bu alanı kullanırsanızlocation_nameveyalocation_codebelirtmeniz gerekmezlocation_coordinateparametresi "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 - locationTür: string
_name arama motoru konumunun tam adı
belirtmezseniz zorunlu alanlocation_codeveyalocation_coordinate
bu alanı kullanırsanızlocation_codeveyalocation_coordinatebelirtmeniz gerekmez
mevcut konumların listesinilocation_namedeğerleriyle birliktehttps://api.dataforseo.com/v3/business_data/google/locationsadresine ayrı bir istek yaparak alabilirsiniz
örnek:London,England,United Kingdom - tagTü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
belirtilentagdeğerini yanıtındatanesnesinde bulacaksınız
- Tür: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo200
- Tür: number | null Biçim: doublecost
toplam görev maliyeti, USD
- Tür: integer | nullstatus
_code genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz
- Tür: string | nullstatus
_message genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- Tür: array (object | null)[] | nulltasks
görev dizisi
- Tür: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
- costTür: number | null Biçim: double
toplam görev maliyeti, USD
- dataTür: object | null
POST isteğinde belirttiğiniz parametrelerin aynısını içerir
- propertyTür: object | null
Name
- idTür: string | null
görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
- pathTür: array (string | null)[] | null
URL yolu
- resultTür: array (object | null)[] | null
sonuç dizisi
- checkTür: string | null
_url arama motoru sonuçlarına doğrudan URL
doğru sonuçlar sunduğumuzdan emin olmak için kullanabilirsiniz - cidTür: string | null
- datetimeTür: string | null
sonucun alındığı tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - featureTür: string | null
_id SERP özelliğinin benzersiz tanımlayıcısı
- itemTür: array (string | null)[] | null
_types öğe türleri
itemsdizisinde karşılaşılan arama motoru sonuç türleri;
olası öğe türleri:google_business_question_item - itemsTür: array (object | null)[] | null
öğe dizisi
google_business_question_itemiçindeki öğeler- itemsTür: array (object | null)[] | null
öğe dizisi
google_business_question_itemiçindeki öğeler- answerTür: string | null
_id yanıt kimliği
- answerTür: string | null
_text yanıtın mevcut metni
- originalTür: string | null
_answer _text yanıtın orijinal metni
- profileTür: string | null
_image _url kullanıcının profil görselinin URL'si
- profileTür: string | null
_name kullanıcının görünen adı
- profileTür: string | null
_url kullanıcının profilinin URL'si
- timeTür: string | null
_ago yanıtın tahmini yayımlanma zamanı
- timestampTür: string | null
yanıtın kesin yayımlanma zamanı
- typeTür: string | null
öğe türü
- originalTür: string | null
_question _text sorunun orijinal metni
- profileTür: string | null
_image _url kullanıcının profil görselinin URL'si
- profileTür: string | null
_name kullanıcının görünen adı
- profileTür: string | null
_url kullanıcının profilinin URL'si
- questionTür: string | null
_id sorunun ID'si
- questionTür: string | null
_text sorunun geçerli metni
- rankTür: integer | null
_absolute tüm öğeler arasındaki mutlak sıra
- rankTür: integer | null
_group aynı
typedeğerlerine sahip öğe grubu içindeki konum
farklıtypedeğerlerine sahip öğelerin konumlarırank_groupiçinde atlanır - timeTür: string | null
_ago sorunun sorulduğu tahmini saat
- timestampTür: string | null
sorunun sorulduğu kesin saat
- typeTür: string | null
öğe türü
- urlTür: string | null
sorunun URL'si
- itemsTür: integer | null Biçim: int64
_count itemsdizisindeki öğe sayısı - itemsTür: array (object | null)[] | null
_without _answers yanıtsız Google Business soru öğeleri dizisi
- itemsTür: array (object | null)[] | null
öğe dizisi
google_business_question_itemiçindeki öğeler- answerTür: string | null
_id yanıt kimliği
- answerTür: string | null
_text yanıtın mevcut metni
- originalTür: string | null
_answer _text yanıtın orijinal metni
- profileTür: string | null
_image _url kullanıcının profil görselinin URL'si
- profileTür: string | null
_name kullanıcının görünen adı
- profileTür: string | null
_url kullanıcının profilinin URL'si
- timeTür: string | null
_ago yanıtın tahmini yayımlanma zamanı
- timestampTür: string | null
yanıtın kesin yayımlanma zamanı
- typeTür: string | null
öğe türü
- originalTür: string | null
_question _text sorunun orijinal metni
- profileTür: string | null
_image _url kullanıcının profil görselinin URL'si
- profileTür: string | null
_name kullanıcının görünen adı
- profileTür: string | null
_url kullanıcının profilinin URL'si
- questionTür: string | null
_id sorunun ID'si
- questionTür: string | null
_text sorunun geçerli metni
- rankTür: integer | null
_absolute tüm öğeler arasındaki mutlak sıra
- rankTür: integer | null
_group aynı
typedeğerlerine sahip öğe grubu içindeki konum
farklıtypedeğerlerine sahip öğelerin konumlarırank_groupiçinde atlanır - timeTür: string | null
_ago sorunun sorulduğu tahmini saat
- timestampTür: string | null
sorunun sorulduğu kesin saat
- typeTür: string | null
öğe türü
- urlTür: string | null
sorunun URL'si
- keywordTür: string | null
POST dizisinde alınan anahtar sözcük
anahtar sözcük, kod çözülmüş %## ile döndürülür ('+' karakterinin kodu boşluk olarak çözülür)
görev ayarlanırkenkeywordalanında belirtirseniz bu alancidparametresini içerir;
örnek:cid:2946633002421908862
parametre hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın - languageTür: string | null
_code POST dizisindeki dil kodu
- locationTür: integer | null
_code POST dizisindeki konum kodu
- seTür: string | null
_domain POST dizisinde belirtilen arama motoru alan adı
- resultTür: integer | null Biçim: int64
_count result dizisindeki öğe sayısı
- statusTür: integer | null
_code görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz
- statusTür: string | null
_message görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- timeTür: string | null
yürütme süresi, saniye
- Tür: integer | null Biçim: int64tasks
_count tasks dizisindeki görev sayısı
- Tür: integer | null Biçim: int64tasks
_error tasks dizisinde hata ile dönen görev sayısı
- Tür: string | nulltime
toplam yürütme süresi, saniye
- Tür: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/live \
--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"
}
]'
{
"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": [
{
"keyword": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"cid": null,
"feature_id": null,
"item_types": [
null
],
"items_without_answers": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"question_id": null,
"url": null,
"profile_image_url": null,
"profile_url": null,
"profile_name": null,
"question_text": null,
"original_question_text": null,
"time_ago": null,
"timestamp": null,
"items": [
"[Max Depth Exceeded]"
]
}
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"question_id": null,
"url": null,
"profile_image_url": null,
"profile_url": null,
"profile_name": null,
"question_text": null,
"original_question_text": null,
"time_ago": null,
"timestamp": null,
"items": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}