v0.2.0-beta

OpenAPI 3.1.0

Google Shopping Yorum 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/merchant/google/reviews/task_post

Google Shopping Yorum Görevlerini Oluşturma

Bir Google Shopping ürününün yorumlarını kuyruğa alır ve bir görev id değeri döndürür. Ürünü product_id ile ve ürünler sonucundan alınan gid veya data_docid ile tanımlayın. Bu ailenin tamamı eşzamansızdır: gönderim tasks[0].id içinde bir görev id değeri döndürür ve getirme aracı hazır olduğunda sonucu döndürür. get_dataforseo_merchant_google_reviews_fetch ile getirin.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek tahmini: USD 0.012.
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

gerekli

application/json

Tür: array object[]
- Tür: object
  gid
  Tür: string
  gerekli
  
  Google Shopping'deki genel ürün tanımlayıcısı. Zorunlu alan. En iyi sonuçlar için gid değerini data_docid ve product_id ile birlikte belirtmenizi öneririz; belirli bir ürün için bu değeri Google Shopping Products uç noktasına ayrı bir istek göndererek alabilirsiniz. Örnek: 4702526954592161872. Parametre hakkında daha fazla bilgi için bu yardım merkezi kılavuzuna bakın.
  
  data_docid
  Tür: string
  
  SERP veri öğesinin benzersiz tanımlayıcısı. İsteğe bağlı alan. En iyi sonuçlar için data_docid değerini product_id ve gid ile birlikte belirtmenizi öneririz; belirli bir öğe için bu değeri Google Shopping Products uç noktasına ayrı bir istek göndererek alabilirsiniz. Örnek: 13071766526042404278.
  
  depth
  Tür: integer
  
  ayrıştırma derinliği. İsteğe bağlı alan. SERP'teki inceleme sayısı; ayrıştırma derinliğini onun katları olarak ayarlamanızı kesinlikle öneririz, çünkü sistemimiz art arda on inceleme işler. Maksimum değer: 8000. Varsayılan değer: 10. Hesabınız 10 sonuca kadar içeren her SERP için faturalandırılır; derinliği 10'un üzerine ayarlamak, arama motoru 10'dan fazla sonuç döndürürse ek ücretlere yol açabilir. Maliyet Fiyatlandırma sayfasında hesaplanabilir.
  
  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 parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/languages. Örnek: en_GB.
  
  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 parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/languages. Örnek: English (United Kingdom).
  
  location_code
  Tür: integer
  
  arama motoru konum kodu. Belirtmezseniz zorunlu alan location_name veya location_coordinate. Bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez. Mevcut konumların listesini location_code parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/locations. Örnek: 9045969.
  
  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. Ö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 parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/google/locations. Örnek: HA1,England,United Kingdom.
  
  pingback_url
  Tür: string
  
  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 bilgilendireceğiz ‘$id’ dizesini $id değişkeni olarak, ‘$tag’ dizesini URL kodlamalı $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 kodlamasına tabi tutulur; örneğin # karakteri %23 olarak kodlanır daha fazla bilgi için Yardım Merkezimizi ziyaret edin
  
  postback_data
  Tür: string
  
  postback_url veri türü isteğe bağlı alan sunucunuza gönderilecek veri türüne karşılık gelir olası değerler: advanced
  
  postback_url
  Tür: string
  
  görev sonuçlarını gönderme URL'si isteğe bağlı alan görev tamamlandığında, sonuçları gzip biçiminde sıkıştırılmış olarak belirttiğiniz postback_url adresine bir POST isteğiyle göndereceğiz ‘$id’ dizesini $id değişkeni olarak, ‘$tag’ dizesini URL kodlamalı $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 kodlamasına tabi tutulur; örneğin # karakteri %23 olarak kodlanır daha fazla bilgi için Yardım Merkezimizi ziyaret edin
  
  priority
  Tür: integer
  
  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.
  
  product_id
  Tür: string
  
  Google Shopping'de benzersiz ürün tanımlayıcısı isteğe bağlı alan optimum sonuçlar için product_id değerini data_docid ve gid ile birlikte belirtmenizi öneririz; bu değeri belirli bir ürün için Google Shopping Products uç noktasına ayrı bir istek göndererek alabilirsiniz örnek: 4485466949985702538 parametre hakkında daha fazla bilgi için bu yardım merkezi kılavuzuna bakın
  
  se_domain
  Tür: string
  
  arama motoru alan adı isteğe bağlı alan ilgili arama motoru alan adını belirttiğiniz konum ve dile göre otomatik olarak seçiyoruz ancak bu alanda özel bir arama motoru alan adı ayarlayabilirsiniz örnek: google.co.uk, google.com.au, google.de, vb.
  
  tag
  Tür: string
  
  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
  
  Boş nesne
  Boş nesne

Yanıtlar

200
Tür: object

Başarılı yanıt
cost
Tür: number

toplam görev maliyeti, USD

status_code
Tür: integer

genel durum kodu. Yanıt kodlarının tam listesini burada bulabilirsiniz. Not: ilgili istisnai veya hata koşullarını işlemek için gerekli bir sistem tasarlamanızı kesinlikle öneririz

status_message
Tür: string

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

tasks
Tür: array string[]

görev dizisi

tasks_count
Tür: integer

tasks dizisindeki görev sayısı

tasks_error
Tür: integer

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

tasks.cost
Tür: number

görevin maliyeti, USD

tasks.data
Tür: object

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

tasks.id
Tür: string

sistemimizdeki benzersiz görev tanımlayıcısı evrensel olarak benzersiz tanımlayıcı (UUID) biçiminde

tasks.path
Tür: array string[]

URL yolu

tasks.result
Tür: array string[]

sonuç dizisi; bu durumda değer null olur

tasks.result_count
Tür: integer

result dizisindeki öğe sayısı

tasks.status_code
Tür: integer

DataForSEO tarafından oluşturulan görev durum kodu; şu aralıkta olabilir: 10000-60000

tasks.status_message
Tür: string

görevin bilgilendirici mesajı

tasks.time
Tür: string

yürütme süresi, saniye

time
Tür: string

yürütme süresi, saniye

version
Tür: string

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/merchant/google/reviews/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'

Şemayı göster

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ]
}

Başarılı yanıt

Google Shopping Yorum Görevlerini Oluşturma

Kimlik doğrulamaRequired

DataForSEO

Google Shopping Yorum Görevlerini Oluşturma

Fiyatlandırma referansı