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

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

Menetapkan Tugas Penjual Google Shopping

​

Memasukkan senarai penjual yang menawarkan satu produk Google Shopping ke baris gilir, sambil memulangkan id tugas. 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_sellers_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
application/json
  • Jenis: array (object | null)[]
    • additional_specifications
      Jenis: object | null

      objek yang mengandungi parameter URL tambahan
      anda boleh mendapatkan maklumat tambahan tentang produk dengan menggunakan objek "additional_specifications, yang boleh anda dapatkan dengan membuat permintaan berasingan ke endpoint Google Shopping Products
      contoh:
      "additional_specifications": {
      "eto": "16157121050167572763_0"
      }

      • propertyName
        Jenis: string | null
    • data_docid
      Jenis: string

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

      kedalaman penghuraian
      medan pilihan
      bilangan hasil yang akan diambil daripada SERP Google Shopping
      nilai lalai: 10
      nilai maksimum: 200
      akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 10 hasil;
      menetapkan kedalaman melebihi 10 mungkin menyebabkan caj tambahan jika enjin carian memulangkan lebih daripada 10 hasil;
      kos boleh dikira di halaman Harga

    • get_shops_on_google
      Jenis: boolean | null

      sertakan kedai "buy on Google"
      medan pilihan
      jika ditetapkan kepada true, respons akan mengandungi senarai penjual yang membenarkan pembelian produk tertentu terus di Google
      Nota: jika ditetapkan kepada true, kos sesuatu tugas akan berganda

    • gid
      Jenis: string

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

    • language_code
      Jenis: string

      kod bahasa
      medan wajib jika anda tidak menentukan language_name
      jika anda menggunakan medan ini, anda tidak perlu menentukan language_name
      anda boleh menerima senarai bahasa Google Shopping yang tersedia dengan language_codenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/merchant/google/languages
      contoh:
      en

    • language_name
      Jenis: string

      nama penuh bahasa
      medan wajib jika anda tidak menentukan language_code
      jika anda menggunakan medan ini, anda tidak perlu menentukan language_code
      anda boleh menerima senarai bahasa Google Shopping yang tersedia dengan language_namenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/merchant/google/languages
      contoh:
      English

    • location_code
      Jenis: integer

      kod lokasi
      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 Google Shopping yang tersedia dengan location_codenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/merchant/google/locations
      contoh:
      2840

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

    • pingback_url
      Jenis: string | null

      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 rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. 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 di-urlencode;
      iaitu, aksara # akan dikodkan menjadi %23

      ketahui lebih lanjut di Pusat Bantuan kami

    • postback_data
      Jenis: string | null
    • postback_url
      Jenis: string | null

      URL untuk menghantar hasil tugas
      medan pilihan
      selepas tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan
      anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. 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 di-urlencode;
      iaitu, aksara # akan dikodkan menjadi %23

      ketahui lebih lanjut di Pusat Bantuan kami

    • priority
      Jenis: integer | null

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

    • pvf
      Jenis: string | null

      penapis varian produk di Google Shopping
      medan pilihan
      parameter dalam URL Google Shopping, menetapkan penapisan varian produk pilihan;
      contoh:
      Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpemUqAnhs

    • se_domain
      Jenis: string | null

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

      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

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

      jumlah kos tugas, USD

    • status_code
      Jenis: integer | null

      kod status umum; anda boleh menemui senarai penuh kod respons di sini

    • status_message
      Jenis: string | null

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

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

      tatasusunan tugas

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

          jumlah kos tugas, USD

        • data
          Jenis: object | null

          mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

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

          pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

          Laluan URL

        • result
          Jenis: object | null

          tatasusunan hasil
          dalam kes ini, nilainya akan menjadi null

        • result_count
          Jenis: integer | null Format: int64

          bilangan elemen dalam array hasil

        • status_code
          Jenis: integer | null

          kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

        • status_message
          Jenis: string | null

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

        • time
          Jenis: string | null

          masa pelaksanaan, saat

    • tasks_count
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks

    • tasks_error
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks yang dipulangkan dengan ralat

    • time
      Jenis: string | null

      jumlah masa pelaksanaan, saat

    • version
      Jenis: string | null

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

Setting Google Shopping Sellers Tasks