Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Menyetel Tugas Penjual 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

Menyetel Tugas Penjual Google Shopping

​

Mengantrekan senarai penjual yang menawarkan satu produk Google Shopping, sambil mengembalikan id tugas. 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_sellers_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
application/json
  • Tipe: array (object | null)[]
    • additional_specifications
      Tipe: object | null

      objek yang berisi parameter URL tambahan
      Anda dapat memperoleh informasi tambahan tentang produk dengan menggunakan objek "additional_specifications, yang dapat Anda peroleh dengan membuat permintaan terpisah ke endpoint Google Shopping Products
      contoh:
      "additional_specifications": {
      "eto": "16157121050167572763_0"
      }

      • propertyName
        Tipe: string | null
    • data_docid
      Tipe: string

      pengenal unik elemen data SERP
      field wajib jika product_id atau gid tidak ditentukan
      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 | null

      kedalaman parsing
      field opsional
      jumlah hasil yang akan diambil dari SERP Google Shopping
      nilai default: 10
      nilai maksimum: 200
      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

    • get_shops_on_google
      Tipe: boolean | null

      sertakan toko "buy on Google"
      field opsional
      jika disetel ke true, respons akan berisi daftar penjual yang memungkinkan pembelian produk tertentu langsung di Google
      Catatan: jika disetel ke true, biaya tugas akan menjadi dua kali lipat

    • gid
      Tipe: string

      pengenal produk global di Google Shopping
      field wajib jika product_id atau data_docid tidak ditentukan
      kami menyarankan menentukan gid bersama product_id dan data_docid 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

    • language_code
      Tipe: string

      kode bahasa
      field wajib jika Anda tidak menentukan language_name
      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name
      Anda dapat memperoleh daftar bahasa Google Shopping yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/merchant/google/languages
      contoh:
      en

    • language_name
      Tipe: string

      nama lengkap bahasa
      field wajib jika Anda tidak menentukan language_code
      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code
      Anda dapat memperoleh daftar bahasa Google Shopping yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/merchant/google/languages
      contoh:
      English

    • location_code
      Tipe: integer

      kode lokasi
      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 Google Shopping yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/merchant/google/locations
      contoh:
      2840

    • 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
      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 Google Shopping yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/merchant/google/locations
      contoh:
      London,England,United Kingdom

    • pingback_url
      Tipe: string | null

      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 yang di-urlencode. Kami akan menetapkan 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 di-urlencode;
      yaitu, karakter # akan dienkode menjadi %23

      pelajari selengkapnya di Pusat Bantuan kami

    • postback_data
      Tipe: string | null
    • postback_url
      Tipe: string | null

      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 yang di-urlencode. Kami akan menetapkan 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 di-urlencode;
      yaitu, karakter # akan dienkode menjadi %23

      pelajari selengkapnya di Pusat Bantuan kami

    • priority
      Tipe: integer | null

      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 wajib jika data_docid atau gid tidak ditentukan
      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

    • pvf
      Tipe: string | null

      filter varian produk di Google Shopping
      field opsional
      parameter di URL Google Shopping, menetapkan penyaringan varian produk opsional;
      contoh:
      Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpemUqAnhs

    • se_domain
      Tipe: string | null

      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 | null

      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

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

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

    • tasks
      Tipe: array (object | null)[] | null

      array tugas

      • Tipe: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

          • propertyName
            Tipe: object | null
        • id
          Tipe: string | null

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

        • path
          Tipe: array (string | null)[] | null

          Jalur URL

        • result
          Tipe: object | null

          array hasil
          dalam kasus ini, nilainya akan menjadi null

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

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

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      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
Request Example for post/v1/beta/dataforseo/merchant/google/sellers/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/sellers/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "product_id": "1113158713975221117"
  }
]'

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

Operasi berhasil

Setting Google Shopping Sellers Tasks