v0.2.0-beta

OpenAPI 3.1.0

Menyetel Tugas Ulasan Google Shopping

Felo API Support

MIT

Server

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

Menyetel Tugas Ulasan Google Shopping

Mengantrekan ulasan satu produk Google Shopping, sambil mengembalikan id tugas. Kenal pasti produk dengan product_id serta gid atau data_docid daripada hasil produk. Keluarga ini tak segerak sepenuhnya: submit mengembalikan id tugas dalam tasks[0].id, dan alat fetch mengembalikan hasil apabila sedia. Ambil dengan get_dataforseo_merchant_google_reviews_fetch.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.012.
Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi

wajib

application/json

Tipe: array object[]
- Tipe: object
  gid
  Tipe: string
  wajib
  
  pengenal produk global di Google Shopping field wajib kami menyarankan menentukan gid bersama data_docid dan product_id untuk hasil optimal; Anda dapat memperoleh nilai ini untuk produk tertentu dengan membuat permintaan terpisah ke endpoint Google Shopping Products contoh: 4702526954592161872 pelajari lebih lanjut tentang parameter di panduan pusat bantuan ini
  
  data_docid
  Tipe: string
  
  pengenal unik elemen data SERP field opsional kami menyarankan menentukan data_docid bersama product_id dan gid untuk hasil optimal; Anda dapat memperoleh nilai ini untuk elemen tertentu dengan membuat permintaan terpisah ke endpoint Google Shopping Products contoh: 13071766526042404278
  
  depth
  Tipe: integer
  
  kedalaman parsing field opsional jumlah ulasan dalam SERP; kami sangat menyarankan menetapkan kedalaman parsing dalam kelipatan sepuluh, karena sistem kami memproses sepuluh ulasan berturut-turut; nilai maksimum: 8000 nilai default: 10 Akun Anda akan ditagih untuk setiap SERP yang berisi hingga 10 hasil; Menetapkan kedalaman di atas 10 dapat menyebabkan biaya tambahan jika mesin pencari mengembalikan lebih dari 10 hasil; Biaya dapat dihitung di halaman Harga.
  
  language_code
  Tipe: string
  
  kode bahasa mesin pencari field wajib jika Anda tidak menentukan language_name jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name Anda dapat memperoleh daftar bahasa yang tersedia beserta parameter language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/merchant/google/languages contoh: en_GB
  
  language_name
  Tipe: string
  
  nama lengkap bahasa mesin pencari field wajib jika Anda tidak menentukan language_code jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code Anda dapat memperoleh daftar bahasa yang tersedia beserta parameter language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/merchant/google/languages contoh: English (United Kingdom)
  
  location_code
  Tipe: integer
  
  kode lokasi mesin pencari field wajib jika Anda tidak menentukan location_name atau location_coordinate jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate Anda dapat memperoleh daftar lokasi yang tersedia beserta parameter location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/merchant/google/locations contoh: 9045969
  
  location_coordinate
  Tipe: string
  
  koordinat GPS suatu lokasi field wajib jika Anda tidak menentukan location_name atau location_code jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code parameter location_coordinate harus ditentukan dalam format “latitude,longitude,radius” jumlah maksimum digit desimal untuk “latitude” dan “longitude”: 7 nilai minimum untuk “radius”: 199.9 contoh: 53.476225,-2.243572,200
  
  location_name
  Tipe: string
  
  nama lengkap lokasi mesin pencari field wajib jika Anda tidak menentukan location_code atau location_coordinate jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate Anda dapat memperoleh daftar lokasi yang tersedia beserta parameter location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/merchant/google/locations contoh: HA1,England,United Kingdom
  
  pingback_url
  Tipe: string
  
  URL notifikasi tugas yang selesai field opsional saat tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan. contoh: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Catatan: karakter khusus dalam pingback_url akan dienkode URL; yaitu, karakter # akan dienkode menjadi %23 pelajari lebih lanjut di Pusat Bantuan kami
  
  postback_data
  Tipe: string
  
  datatype postback_url field opsional sesuai dengan tipe data yang akan dikirim ke server Anda nilai yang mungkin: advanced
  
  postback_url
  Tipe: string
  
  URL untuk mengirim hasil tugas field opsional setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan. contoh: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Catatan: karakter khusus dalam postback_url akan dienkode URL; yaitu, karakter # akan dienkode menjadi %23 pelajari lebih lanjut di Pusat Bantuan kami
  
  priority
  Tipe: integer
  
  prioritas tugas field opsional dapat mengambil nilai berikut: 1 – prioritas eksekusi normal (ditetapkan secara default) 2 – prioritas eksekusi tinggi Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi. biaya dapat dihitung di halaman Harga.
  
  product_id
  Tipe: string
  
  pengenal produk unik di Google Shopping field opsional kami menyarankan menentukan product_id bersama data_docid dan gid untuk hasil optimal; Anda dapat memperoleh nilai ini untuk produk tertentu dengan membuat permintaan terpisah ke endpoint Google Shopping Products contoh: 4485466949985702538 pelajari lebih lanjut tentang parameter di panduan Pusat Bantuan ini
  
  se_domain
  Tipe: string
  
  domain mesin pencari field opsional kami memilih domain mesin pencari yang relevan secara otomatis sesuai lokasi dan bahasa yang Anda tentukan namun, Anda dapat menetapkan domain mesin pencari khusus di field ini contoh: google.co.uk, google.com.au, google.de, dll.
  
  tag
  Tipe: string
  
  pengenal tugas yang ditentukan pengguna; field opsional; batas karakter adalah 255; Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil; Anda akan menemukan nilai tag yang ditentukan di objek data pada respons
  
  Objek kosong
  Objek kosong

Respons

200
Tipe: object

Respons berhasil
cost
Tipe: number

total biaya tugas, USD

status_code
Tipe: integer

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini; Catatan: kami sangat menyarankan merancang sistem yang diperlukan untuk menangani kondisi terkait pengecualian atau error

status_message
Tipe: string

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

tasks
Tipe: array string[]

array tugas

tasks_count
Tipe: integer

jumlah tugas dalam tasksarray

tasks_error
Tipe: integer

jumlah tugas dalam array tasks yang dikembalikan dengan error

tasks.cost
Tipe: number

biaya tugas, USD

tasks.data
Tipe: object

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

tasks.id
Tipe: string

pengenal tugas unik dalam sistem kami dalam format Universally unique identifier (UUID)

tasks.path
Tipe: array string[]

Jalur URL

tasks.result
Tipe: array string[]

array hasil dalam hal ini, nilainya akan menjadi null

tasks.result_count
Tipe: integer

jumlah elemen dalam array hasil

tasks.status_code
Tipe: integer

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000

tasks.status_message
Tipe: string

pesan informasi tugas

tasks.time
Tipe: string

waktu eksekusi, detik

time
Tipe: string

waktu eksekusi, detik

version
Tipe: string

versi API saat ini
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat menggunakan format penyedia

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 '[
  {},
  {}
]'

Tampilkan Skema

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

Respons berhasil

Menyetel Tugas Ulasan Google Shopping

AutentikasiRequired

DataForSEO

Menyetel Tugas Ulasan Google Shopping

Referensi harga