v0.2.0-beta

OpenAPI 3.1.0

Menetapkan Tugas Ulasan Google Shopping

Felo API Support

MIT

Pelayan

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

Menetapkan Tugas Ulasan Google Shopping

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

Rujukan harga

Pemeteran: Kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0.012.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan

wajib

application/json

Jenis: array object[]
- Jenis: object
  gid
  Jenis: string
  wajib
  
  pengecam produk global di Google Shopping medan wajib kami mengesyorkan menentukan gid bersama data_docid dan product_id untuk hasil optimum; anda boleh mendapatkan nilai ini untuk produk tertentu dengan membuat permintaan berasingan ke endpoint Google Shopping Products contoh: 4702526954592161872 ketahui lebih lanjut tentang parameter dalam panduan pusat bantuan ini
  
  data_docid
  Jenis: string
  
  pengecam unik elemen data SERP medan pilihan kami mengesyorkan menentukan data_docid bersama product_id dan gid untuk hasil optimum; anda boleh mendapatkan nilai ini untuk elemen tertentu dengan membuat permintaan berasingan ke endpoint Google Shopping Products contoh: 13071766526042404278
  
  depth
  Jenis: integer
  
  kedalaman penghuraian medan pilihan bilangan ulasan dalam SERP; kami amat mengesyorkan menetapkan kedalaman penghuraian dalam gandaan sepuluh, kerana sistem kami memproses sepuluh ulasan berturut-turut; nilai maksimum: 8000 nilai lalai: 10 Akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 10 hasil; Menetapkan kedalaman melebihi 10 boleh menyebabkan caj tambahan jika enjin carian memulangkan lebih daripada 10 hasil; Kos boleh dikira di halaman Harga.
  
  language_code
  Jenis: string
  
  kod bahasa enjin carian medan wajib jika anda tidak menentukan language_name jika anda menggunakan medan ini, anda tidak perlu menentukan language_name anda boleh menerima senarai bahasa yang tersedia dengan parameter language_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/merchant/google/languages contoh: en_GB
  
  language_name
  Jenis: string
  
  nama penuh bahasa enjin carian medan wajib jika anda tidak menentukan language_code jika anda menggunakan medan ini, anda tidak perlu menentukan language_code anda boleh menerima senarai bahasa yang tersedia dengan parameter language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/merchant/google/languages contoh: English (United Kingdom)
  
  location_code
  Jenis: integer
  
  kod lokasi enjin carian medan wajib jika anda tidak menentukan location_name atau location_coordinate jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate anda boleh menerima senarai lokasi yang tersedia dengan parameter location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/merchant/google/locations contoh: 9045969
  
  location_coordinate
  Jenis: string
  
  koordinat GPS sesuatu lokasi medan wajib jika anda tidak menentukan location_name atau location_code jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code parameter location_coordinate hendaklah ditentukan dalam format “latitude,longitude,radius” bilangan maksimum digit perpuluhan untuk “latitude” dan “longitude”: 7 nilai minimum untuk “radius”: 199.9 contoh: 53.476225,-2.243572,200
  
  location_name
  Jenis: string
  
  nama penuh lokasi enjin carian medan wajib jika anda tidak menentukan location_code atau location_coordinate jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate anda boleh menerima senarai lokasi yang tersedia dengan parameter location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/merchant/google/locations contoh: HA1,England,United Kingdom
  
  pingback_url
  Jenis: string
  
  URL pemberitahuan tugas yang selesai medan pilihan apabila tugas selesai, kami akan memberitahu anda melalui permintaan GET yang dihantar ke URL yang anda tentukan anda boleh menggunakan string ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag berkod URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan. contoh: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Nota: aksara khas dalam pingback_url akan dikodkan URL; iaitu, aksara # akan dikodkan menjadi %23 ketahui lebih lanjut di Pusat Bantuan kami
  
  postback_data
  Jenis: string
  
  datatype postback_url medan pilihan sepadan dengan jenis data yang akan dihantar ke pelayan anda nilai yang tersedia: advanced
  
  postback_url
  Jenis: string
  
  URL untuk menghantar hasil tugas medan pilihan sebaik sahaja tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan anda boleh menggunakan string ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag berkod URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan. contoh: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Nota: aksara khas dalam postback_url akan dikodkan URL; iaitu, aksara # akan dikodkan menjadi %23 ketahui lebih lanjut di Pusat Bantuan kami
  
  priority
  Jenis: integer
  
  keutamaan tugas medan pilihan boleh mengambil nilai berikut: 1 – keutamaan pelaksanaan biasa (ditetapkan secara lalai) 2 – keutamaan pelaksanaan tinggi anda akan dicaj tambahan untuk tugas dengan keutamaan pelaksanaan tinggi. kos boleh dikira di halaman Harga.
  
  product_id
  Jenis: string
  
  pengecam produk unik di Google Shopping medan pilihan kami mengesyorkan menentukan product_id bersama data_docid dan gid untuk hasil optimum; anda boleh mendapatkan nilai ini untuk produk tertentu dengan membuat permintaan berasingan ke endpoint Google Shopping Products contoh: 4485466949985702538 ketahui lebih lanjut tentang parameter dalam panduan Pusat Bantuan ini
  
  se_domain
  Jenis: string
  
  domain enjin carian medan pilihan kami memilih domain enjin carian yang berkaitan secara automatik mengikut lokasi dan bahasa yang anda tentukan namun, anda boleh menetapkan domain enjin carian tersuai dalam medan ini contoh: google.co.uk, google.com.au, google.de, dsb.
  
  tag
  Jenis: string
  
  pengecam tugas yang ditentukan pengguna; medan pilihan; had aksara ialah 255; anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil; anda akan menemui nilai tag yang ditentukan dalam objek data respons
  
  Objek kosong
  Objek kosong

Respons

200
Jenis: object

Respons berjaya
cost
Jenis: number

jumlah kos tugas, USD

status_code
Jenis: integer

kod status umum; anda boleh menemui senarai penuh kod respons di sini; Nota: kami amat mengesyorkan agar anda mereka bentuk sistem yang diperlukan untuk mengendalikan keadaan pengecualian atau ralat berkaitan

status_message
Jenis: string

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

tasks
Jenis: array string[]

array tugas

tasks_count
Jenis: integer

bilangan tugas dalam tasksarray

tasks_error
Jenis: integer

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

tasks.cost
Jenis: number

kos tugas, USD

tasks.data
Jenis: object

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

tasks.id
Jenis: string

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

tasks.path
Jenis: array string[]

Laluan URL

tasks.result
Jenis: array string[]

tatasusunan hasil dalam kes ini, nilainya akan menjadi null

tasks.result_count
Jenis: integer

bilangan elemen dalam array hasil

tasks.status_code
Jenis: integer

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000

tasks.status_message
Jenis: string

mesej maklumat tugas

tasks.time
Jenis: string

masa pelaksanaan, saat

time
Jenis: string

masa pelaksanaan, saat

version
Jenis: string

versi semasa API
application/json
400

Permintaan tidak dapat diproses. Semak parameter permintaan.
401

Kunci API Felo yang sah diperlukan.
402

Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
403

Akaun tidak dibenarkan melakukan operasi ini.
429

Had permintaan atau had perbelanjaan telah dicapai.
502

Perkhidmatan tidak dapat menyelesaikan permintaan.
503

API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
504

Perkhidmatan tamat masa semasa memproses permintaan.
default

Respons ralat; respons passthrough huluan mungkin 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 '[
  {},
  {}
]'

Tunjukkan 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 berjaya

Menetapkan Tugas Ulasan Google Shopping

PengesahanRequired

DataForSEO

Menetapkan Tugas Ulasan Google Shopping

Rujukan harga